Every agent's model. One place. Codex on DeepSeek, Claude Code on Kimi, from the menu bar.
// Plugins: the market of OpenCode provider plugins — subscriptions magpie
// signs in to through someone else's code. Discover lists the plugins
// magpie suggests (the community repo's list, with what npm says of each
// now) and finds the rest on npm; Installed is what was added, to sign in
// with, update, switch off or remove. Each part is drawn as it comes
// (#488): what's installed from /api/plugins, the plugins suggested from
// /api/plugins/listings, and what npm says of them (versions, downloads)
// from /api/plugins/npm after; a sign-in happens in the Providers add
// sheet, as every other subscription's does.
(() => {
const page = $("#view-plugins");
if (!page) return;
let mine = null; // /api/plugins: what's installed
let listings = null; // /api/plugins/listings: the plugins suggested
let tagged = null; // /api/plugins/github: repositories their authors tagged magpie-plugin, as listings
let taggedErr = ""; // why the list isn't GitHub's whole answer: it couldn't be asked, or...
let taggedKind = ""; // its kind: "slow", "limited" or ""
let taggedMissing = 0; // ...this many repositories it named couldn't be read
let topic = "magpie-plugin";
const npm = {}; // /api/plugins/npm: package → what npm says of it
const heads = {}; // /api/plugins/git: a git plugin's spec → the commit its repository is at
let failed = ""; // why what's installed couldn't be loaded
let failedList = ""; // ...and the plugins suggested
let tab = "discover";
try { tab = localStorage.getItem("magpie.pluginTab") || tab; } catch {}
let query = "";
let hits = null; // npm's answer for query: { q, list } | { q, loading } | { q, error }
let searchTimer = 0;
const busy = new Map(); // package → "add" | "remove" | "upgrade" | "off"
let editing = null; // { pkg, text, error }: a middleware's options being edited in its row
let asking = null; // { pkg, op }: a remove or switch-off waiting on the user's yes
let checking = false; // Check for updates: npm being asked now
let checked = null; // ...and what it said: { at, by: spec → check }
let shown = "";
const SEARCH = "M7 3a4 4 0 1 0 0 8 4 4 0 0 0 0-8z M10 10l3 3";
const DOWN = "M8 3v7.5 M4.8 7.6 8 10.8l3.2-3.2 M3.5 13h9";
const STAR = "M8 2.2l1.8 3.7 4 .6-2.9 2.8.7 4L8 11.4l-3.6 1.9.7-4L2.2 6.5l4-.6z";
const SHIELD = "M8 2.3 13 4v3.8c0 3-2.1 5.1-5 5.9-2.9-.8-5-2.9-5-5.9V4z M5.8 8l1.6 1.6 2.9-3";
const OUTL = "M9.5 3.5h3v3 M12.5 3.5 7.5 8.5 M11 9.5v3H3.5V5h3";
const PLUG = "M6 2v3 M10 2v3 M4.5 5h7v2.5a3.5 3.5 0 0 1-7 0z M8 11v3";
const PIPE = "M1.5 8h3 M11.5 8h3 M4.5 4.5h7v7h-7z";
const TERM = "M2 3.5h12v9H2z M4.5 6.5l2 1.5-2 1.5 M8 9.5h3";
const PAGE = "M2 3.5h12v9H2z M2 6h12 M4 4.75h.01";
const TOOL = "M10.6 2.4a3 3 0 0 0-3.4 4L2.6 11a1.2 1.2 0 0 0 1.7 1.7l4.6-4.6a3 3 0 0 0 4-3.4l-1.7 1.7-1.6-.3-.3-1.6z";
const FOLDER = "M14.7 12.7a1.3 1.3 0 0 1-1.3 1.3H2.6a1.3 1.3 0 0 1-1.3-1.3V3.3A1.3 1.3 0 0 1 2.6 2h3.3l1.3 2h6.2a1.3 1.3 0 0 1 1.3 1.3z";
// a folder's path is its name whole, as plugin.Name: C:\Users\me@corp\…
// has an @ that is no version
const name = (spec) => { if (isPath(spec)) return spec; const i = spec.lastIndexOf("@"); return i > 0 && !spec.includes("/", i) ? spec.slice(0, i) : spec; };
// a plugin added from a folder is a folder's path, not a package name.
// a leading \ is one on every system, as plugin.IsPath (#2229): a UNC
// share (\\server\share\plugin) and a leading-backslash path
const isPath = (p) => /^file:\/\//.test(p) || /^\./.test(p) || /^[/\\]/.test(p) || /^[A-Za-z]:[\\/]/.test(p);
// ...and is known by the folder's name, not its whole path
const label = (spec) => { const n = name(spec); return isPath(n) ? n.replace(/[\\/]+$/, "").split(/[\\/]/).pop() || n : n; };
// one added from a git repository (github:owner/repo, git+https://…), as
// the plugin store tells them apart: known by the package it installed
const isGit = (p) => !isPath(p) && (/^(?:(?:github|gitlab|bitbucket):|git\+[a-z]+:\/\/|git:\/\/)\S+$/.test(p) || /^https?:\/\/(?:www\.)?(?:github\.com|gitlab\.com|bitbucket\.org)\/\S+$/.test(p) || /^[A-Za-z0-9][A-Za-z0-9_.-]*\/[A-Za-z0-9_.-]+(?:#\S+)?$/.test(p));
// ...and its page on the web, for the plugin's Source link
const gitWeb = (p) => {
const s = p.replace(/#.*$/, "");
const m = /^(github|gitlab|bitbucket):(.+)$/.exec(s) || (/^[^:]+\/[^:]+$/.test(s) && ["", "github", s]);
if (m) return "https://" + { github: "github.com", gitlab: "gitlab.com", bitbucket: "bitbucket.org" }[m[1]] + "/" + m[2];
const u = s.replace(/^git\+/, "").replace(/\.git$/, "");
return /^https?:\/\//.test(u) ? u : "";
};
const lang = () => (document.documentElement.lang || "en").slice(0, 2);
const summary = (l) => l.summary?.[lang()] || l.summary?.en || l.npm?.description || "";
const count = (n) => n >= 1e6 ? (n / 1e6).toFixed(n >= 1e7 ? 0 : 1) + "M" : n >= 1e3 ? (n / 1e3).toFixed(n >= 1e4 ? 0 : 1) + "k" : String(n || 0);
// a repository tagged magpie-plugin is installed by whichever spec
// names it (github:owner/repo, its page's URL), or as the package its
// package.json names
const ghRepo = (spec) => { const m = /^(?:github:|https?:\/\/(?:www\.)?github\.com\/)([^/#\s]+\/[^/#\s]+?)(?:\.git)?(?:[/#].*)?$/i.exec(spec) || (isGit(spec) && /^([^:/#]+\/[^:/#]+)(?:#.*)?$/.exec(spec)); return m ? m[1].toLowerCase() : ""; };
const entryOf = (pkg) => {
const g = (tagged || []).find((x) => x.package === pkg)?.github;
return mine?.plugins?.find((e) => name(e.spec) === pkg || (g && (ghRepo(e.spec) === g.repo.toLowerCase() || (g.package && isGit(e.spec) && e.package === g.package))));
};
// npm has the versions of a package: not a folder's, nor a git one's
const onNPM = (spec) => !isPath(spec) && !isGit(spec);
// a git one is out of date when its repository is at another commit than
// the one installed, whatever version its package.json says (ARNO on
// Discord: github:yuweihao17/codearts showed Update all the time, and
// still did right after updating); an abbreviated sha names the full one
const sameCommit = (a, b) => !!a && !!b && (a.length > b.length ? a.startsWith(b) : b.startsWith(a));
const gitBehind = (e) => isGit(e.spec) && !!e.commit && !!e.head && !sameCommit(e.commit, e.head);
// the providers a plugin signs in to, as the add sheet knows them
const subsOf = (pkg) => (providers?.plugins || []).filter((x) => name(x.spec) === pkg);
// whether version a comes after b, in semver's order, the same as
// update.Newer, which puts the dot on Plugins: a pre-release before its
// release, numbers in it as numbers ("beta.10" after "beta.9"), a number
// before a word, a shorter list first; build metadata ("+…") ignored. A
// version that isn't x.y.z is never newer.
const newer = (a, b) => {
const p = (v) => {
const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-([^+]*))?(?:\+.*)?$/.exec(String(v || "").trim());
return m && { n: [+m[1], +m[2], +m[3]], pre: m[4] || "" };
};
const [x, y] = [p(a), p(b)];
if (!x || !y) return false;
for (let i = 0; i < 3; i++) if (x.n[i] !== y.n[i]) return x.n[i] > y.n[i];
if (x.pre === y.pre) return false;
if (!x.pre || !y.pre) return !x.pre;
const [s, u] = [x.pre.split("."), y.pre.split(".")];
for (let i = 0; i < s.length && i < u.length; i++) {
const [d, e] = [/^\d+$/.test(s[i]), /^\d+$/.test(u[i])];
if (d && e) { if (+s[i] !== +u[i]) return +s[i] > +u[i]; }
else if (d !== e) return e;
else if (s[i] !== u[i]) return s[i] > u[i];
}
return s.length > u.length;
};
function glyph(d, size = 14, stroke = 1.5) { return svg(d, size, stroke); }
// kindChip says what a plugin is: a provider ("pv") signs in to a
// subscription and serves its models; middleware ("mw") runs in the
// gateway on every agent's requests and replies, whatever serves them;
// an agent ("ag") is one magpie has no wiring of its own for, which it
// then connects as it does its own; tools ("tl") are given to every
// agent through magpie's plugin tools MCP server; a page ("pg") is a
// page of its own in the window's sidebar (pluginpages.js); panels
// ("pn") are its parts in magpie's own pages
const KINDS = {
pv: [PLUG, "Provider", "Signs in to a subscription and serves its models"],
mw: [PIPE, "Middleware", "Runs in magpie's gateway on the requests your agents send and on the replies"],
ag: [TERM, "Agent", "Adds an agent magpie has no setup of its own for: pick its model on the Agents page and it goes through magpie"],
tl: [TOOL, "Tools", "Gives every agent tools of its own, through magpie's MCP server"],
pg: [PAGE, "Page", "Adds a page of its own to the sidebar. It runs shut off from the rest of magpie and can read only what its row lists"],
pn: [PAGE, "Panels", "Adds panels to magpie's own pages. They run shut off from the rest of magpie and can read only what its row lists"],
};
const kindOf = (l) => ({ middleware: "mw", agent: "ag", tools: "tl", page: "pg" })[l.kind] || "pv";
function kindChip(kind) {
const [d, word, tip] = KINDS[kind];
const c = el("span", "pm-chip kind " + kind);
c.append(glyph(d, 10, 1.5), el("span", "", t(word)));
c.title = t(tip);
return c;
}
function logo(ic, big, kind) {
const box = el("span", "pm-logo" + (big ? " big" : ""));
if (ic) box.append(icon(ic, !big));
else box.append(glyph({ mw: PIPE, ag: TERM, tl: TOOL, pg: PAGE }[kind] || PUZZLE, big ? 22 : 17, 1.4));
return box;
}
// npm's answers, put where the cards and rows read them: on the
// listing and the entry themselves, so a plugin's page opened before
// npm answered has them too
function merge() {
for (const l of listings || []) if (npm[l.package]) l.npm = npm[l.package];
for (const e of mine?.plugins || []) if (onNPM(e.spec) && npm[name(e.spec)]?.version) e.latest = npm[name(e.spec)].version;
for (const e of mine?.plugins || []) if (isGit(e.spec) && heads[e.spec]) e.head = heads[e.spec];
}
async function loadMine() {
try {
mine = await api("plugins");
failed = "";
// a plugin turned on or off brings its page's tab, or takes it
window.loadPluginPages?.();
} catch (e) {
failed = e.message;
}
merge();
}
// a repository tagged magpie-plugin as the market's cards read a
// listing: its owner as the publisher, its version, and installed by its
// spec (its npm name when its author published it there from the
// repository, else github:owner/repo)
const ghListing = (r) => ({
package: r.spec, name: r.repo.split("/")[1], kind: r.kind, github: r, icon: r.icon || undefined,
summary: r.description ? { en: r.description } : undefined,
npm: { version: r.version || "", publisher: r.owner, repository: r.url, license: r.license, weekly: 0 },
});
// A failed ask is said, with why, whether or not a list was had before:
// an empty list was read as there being no unofficial plugins (till on
// Discord: GitHub unreachable from their desktop, the section gone).
// A list had before stands through a failed ask that brings none.
// again: Try again, which has magpie ask GitHub at once.
async function loadTagged(again) {
try {
const r = await api("plugins/github" + (again ? "?again=1" : ""));
const got = (r.repos || []).map(ghListing);
if (!(r.error && !got.length && tagged?.length)) tagged = got;
taggedErr = r.error || "";
taggedKind = r.why || "";
taggedMissing = r.missing || 0;
if (r.topic) topic = r.topic;
} catch (e) {
taggedErr = e.message || String(e);
taggedKind = "";
taggedMissing = 0;
tagged = tagged || [];
}
}
async function loadListings() {
try {
const r = await api("plugins/listings");
listings = r.listings || [];
failedList = "";
} catch (e) {
failedList = e.message;
}
merge();
}
// what npm says of the plugins suggested and those installed: drawn
// when it comes, never waited on
async function askNPM(only) {
const names = [...new Set([...(listings || []).map((l) => l.package), ...(mine?.plugins || []).filter((e) => onNPM(e.spec)).map((e) => name(e.spec))])]
.filter((n) => !only || !npm[n]);
if (!names.length) return;
try {
const r = await api("plugins/npm?names=" + encodeURIComponent(names.join(",")));
Object.assign(npm, r.npm || {});
} catch {}
merge();
// one npm said nothing of, now or ever: as one it doesn't have
for (const l of listings || []) if (!l.npm) l.npm = { weekly: 0 };
drawBody();
}
// the commit each git plugin's repository is at now: drawn when it
// comes, never waited on (only: when one, just added, isn't known yet)
async function askGit(only) {
if (!(mine?.plugins || []).some((e) => isGit(e.spec) && (!only || !heads[e.spec]))) return;
try {
const r = await api("plugins/git");
Object.assign(heads, r.heads || {});
} catch { return; }
merge();
drawBody();
}
async function load() {
if (!mine && !listings) draw();
const parts = [
loadMine().then(() => { draw(); window.renderPluginDot?.(); }),
loadListings().then(draw),
loadTagged().then(drawBody),
loadBuiltins(),
providers ? null : loadProviders().then(drawBody, () => {}),
];
await Promise.all(parts);
askNPM();
askGit();
}
window.loadPlugins = load;
// the sidebar's dot, followed: Plugins opens on Installed, where the
// plugins with an update are named at the top
window.pluginTabTo = (id) => { tab = id; };
// pluginQuery: Discover, looking for q (the add sheet found nothing by it)
window.pluginQuery = (q) => {
query = q;
tab = "discover";
clearTimeout(searchTimer);
hits = q.trim().length >= 2 ? { q: q.trim(), loading: true } : null;
if (hits) searchNPM(hits.q);
draw();
};
// pluginAgentsTo: Discover, at its Agents (the Agents page's More in
// Plugins). The scroll is the reader's click's, so it is made only while
// the click is fresh: Agents drawn later, the listings slow, is left
// where the page is.
let agentsFor = null; // the click that asked for Agents, till they are drawn
window.pluginAgentsTo = (ev) => {
query = "";
tab = "discover";
clearTimeout(searchTimer);
hits = null;
agentsFor = ev;
draw();
};
async function refresh() {
// a plugin installed, switched on or off, or removed brings its
// page's tab, or takes it, now: not on the Plugins page's next load
window.loadPluginPages?.();
try {
const [m, p] = await Promise.all([api("plugins"), api("providers")]);
mine = m;
providers = p;
merge();
// the Providers page owns the dialog as it draws: only drawn when shown
if (view === "providers") renderProviders();
} catch (e) { status(e.message, "err"); }
draw();
window.renderPluginDot?.();
askNPM(true);
askGit(true);
}
async function act(pkg, op, body, done) {
if (busy.size && op !== "off") return;
busy.set(pkg, op);
draw();
try {
await api("plugins/" + op, body);
busy.delete(pkg);
await refresh();
if (done) done();
} catch (e) {
busy.delete(pkg);
draw();
status(e.message, "err");
}
}
// Check for updates: npm asked now, not what it said within the hour,
// for each installed plugin's newest version. Each row then says so (an
// update, up to date, or why it couldn't be checked), and its Update, or
// Update all, installs it as before. Nothing is installed by the check.
async function checkUpdates() {
if (checking || busy.size) return;
checking = true;
draw();
try {
const r = await api("plugins/check", {});
mine = r.state || mine;
const by = {};
for (const c of r.plugins || []) {
by[c.spec] = c;
// npm's answer now is the one the rows read, and a git one's
// repository's
if (c.latest) npm[c.package] = { ...(npm[c.package] || {}), version: c.latest };
if (c.head) heads[c.spec] = c.head;
}
checked = { at: r.at, by };
merge();
const asked = (r.plugins || []).filter((c) => c.status === "update" || c.status === "current" || c.status === "unknown");
const ups = asked.filter((c) => c.status === "update" && !c.off).length;
const unknown = asked.filter((c) => c.status === "unknown");
if (asked.length && unknown.length === asked.length) {
status(t("Couldn't check for updates: {error}", { error: whyText(unknown[0]) }), "err", 8000);
} else {
// with some not checked, "every plugin" isn't known to be up to
// date: only the ones checked are (#1942)
let msg = ups ? (ups === 1 ? t("1 plugin has an update") : t("{n} plugins have updates", { n: ups }))
: unknown.length ? t("No updates for the plugins checked") : t("Every plugin is up to date");
if (unknown.length) {
msg += " · " + t("{n} couldn't be checked: {error}", { n: unknown.length, error: whyText(unknown[0]) });
status(msg, "warn", 8000);
} else status(msg, "ok");
}
} catch (e) {
status(t("Couldn't check for updates: {error}", { error: e.message }), "err", 8000);
}
checking = false;
draw();
window.renderPluginDot?.();
}
// why npm said nothing of a plugin, in the page's words; a git one's
// repository, in its own
function whyText(c) {
if (isGit(c.spec || "")) return t("Couldn't ask {repo} for its newest commit: {error}", { repo: c.spec, error: c.limited ? limitedText(c.limited) : c.error || "" });
switch (c.why) {
case "offline": return t("npm couldn't be reached — check your connection or proxy");
case "limited": return t("npm is turning requests away for now (too many); try again in a few minutes");
case "missing": return t("npm doesn't have it");
default: return t("npm answered with an error: {error}", { error: c.error || "" });
}
}
// GitHub's rate limit used up, in the page's words as the library's
// skill check says it: when it lifts, and how a token raises it (#1942)
function limitedText(l) {
const d = l.until ? new Date(l.until) : null;
const time = d && !isNaN(d) ? d.toLocaleTimeString(intlLang(), { hour: "2-digit", minute: "2-digit" }) : "";
if (l.token) return time ? t("GitHub's rate limit for your GitHub token is used up until {time}", { time })
: t("GitHub's rate limit for your GitHub token is used up for now");
return time ? t("GitHub allows 60 requests an hour without a token, used up until {time}. Add a GitHub token in Settings → Network and sharing to raise it to 5,000.", { time })
: t("GitHub allows 60 requests an hour without a token, used up for now. Add a GitHub token in Settings → Network and sharing to raise it to 5,000.");
}
const checkedAt = () => checked ? new Date(checked.at).toLocaleTimeString(intlLang(), { hour: "2-digit", minute: "2-digit" }) : "";
// the built-ins with accounts this plugin could run in their place
const movableOf = (pkg) => (mine?.movable || []).filter((c) => c.package === pkg);
// move: a built-in's accounts onto its plugin, installing it if need be,
// as its editor's Runs on does
async function move(c) {
if (busy.size) return;
busy.set(c.package, "move");
asking = null;
draw();
try {
providers = await api("provider/move", { id: c.id });
busy.delete(c.package);
await refresh();
const now = providers.providers.find((x) => x.id === c.id);
const accts = now?.account?.logins?.length || c.accounts, models = (now?.models || []).filter((x) => x.on).length;
status(t("{name} now runs on its plugin — {accounts}, {models}. Its editor in Providers moves it back.", {
name: c.name,
accounts: t(accts === 1 ? "{n} account" : "{n} accounts", { n: accts }),
models: t(models === 1 ? "{n} model" : "{n} models", { n: models }),
}), "ok", 9000);
} catch (e) {
busy.delete(c.package);
draw();
// no editor here to sign in above: say where
const why = e.why?.code === "lapsed"
? t("every {name} account needs signing in again. Sign one in under Providers, then move.", { name: c.name })
: moveWhy({ why: e.why, error: e.message }, { name: c.name });
status(t("It stays built-in: {error}", { error: why }), "err", 12000);
}
}
const moveButton = (b, c, here) => {
// one word beside the name, as Install is: the card already says whose
// accounts, the title says how many and what it does (a whole sentence
// was a solid bar under the card that broke onto two lines)
b.classList.add("get", "move");
b.textContent = t("Move");
b.title = (here ? t("Move {name} here", { name: c.name }) : t(c.accounts === 1 ? "Move my {n} {name} account" : "Move my {n} {name} accounts", { name: c.name, n: c.accounts }))
+ " — " + t("Runs {name} on this plugin in place of the built-in, with the same accounts; nothing changes if one doesn't work through it", { name: c.name });
b.disabled = busy.size > 0;
b.onclick = (ev) => { ev.stopPropagation(); move(c); };
return b;
};
const install = (pkg, nm) => act(pkg, "add", { spec: pkg }, () => {
const subs = subsOf(pkg);
status(subs.length ? t("{name} is installed — sign in to use it", { name: nm }) : t("{name} is installed", { name: nm }), "ok");
});
// A plugin's Update, wherever it is offered: npm has a newer version, or
// a git one's repository a newer commit. Makes b that button and says
// whether there is one.
function updateButton(b, e) {
if (!e || e.off) return false;
const npm = e.latest && e.version && newer(e.latest, e.version);
if (!npm && !gitBehind(e)) return false;
const pkg = name(e.spec);
const l = (listings || []).find((x) => x.package === pkg);
b.classList.add("pm-act", "pm-up");
b.type = "button";
b.textContent = busy.get(pkg) === "upgrade" || busy.get(e.spec) === "upgrade" ? t("Updating…") : t("Update");
b.disabled = busy.size > 0 || checking;
if (npm) {
b.title = t("Update to {v}", { v: "v" + e.latest });
// the community's would come by itself: Update brings it now
if (pkg.startsWith("@magpie-community/") && !/@(?!latest$)[^@/]+$/.test(e.spec.slice(pkg.length))) b.title += "\n" + t("magpie updates it by itself within the hour; Update does it now");
} else b.title = t("Fetches it from {repo} again", { repo: e.spec }) + "\n" + t("{have} installed, {repo} is at {head}", { have: e.commit, repo: e.spec, head: e.head });
b.onclick = (ev) => {
ev.stopPropagation();
act(pkg, "upgrade", { spec: e.spec }, () => status(npm ? t("{name} updated to v{v}", { name: l?.name || pkg, v: e.latest }) : t("{name} is up to date", { name: e.package || e.spec }), "ok"));
};
b.onkeydown = (ev) => ev.stopPropagation();
return true;
}
// the one button a plugin shows: what to do with it next
function actionFor(pkg, nm, listed) {
const b = el("button", "pm-act");
const e = entryOf(pkg);
const op = busy.get(pkg);
if (op === "add" || op === "upgrade" || op === "move") {
b.classList.add("busy");
if (op === "move") b.classList.add("move");
b.append(el("span", "spin"), el("span", "", op === "move" ? t("Moving…") : op === "upgrade" ? t("Updating…") : mine?.bun ? t("Installing…") : t("Getting Bun…")));
b.disabled = true;
if (!mine?.bun) b.title = t("Plugins run on Bun {v}, downloaded once", { v: mine?.bunVersion || "" });
return b;
}
// not known yet whether it's installed, or whether npm has it: a
// button that waits, rather than one that says the wrong thing
if (!mine || (!e && listed && !listed.npm)) {
b.classList.add("busy");
b.append(el("span", "spin"));
b.disabled = true;
return b;
}
if (!e) {
if (listed && !listed.github && !listed.npm?.version) {
b.textContent = t("Coming soon");
b.disabled = true;
b.title = t("Not on npm yet");
return b;
}
const c = movableOf(pkg)[0];
if (c) return moveButton(b, c);
b.classList.add("get");
b.textContent = t("Install");
b.disabled = busy.size > 0;
b.onclick = (ev) => { ev.stopPropagation(); install(pkg, nm); };
return b;
}
if (e.off) {
b.textContent = t("Switch on");
b.onclick = (ev) => { ev.stopPropagation(); act(pkg, "off", { spec: e.spec, off: false }); };
return b;
}
const subs = subsOf(pkg);
const out = subs.find((x) => !x.signedIn);
// signed in to nothing yet, with a built-in's accounts to bring
const c = !subs.some((x) => x.signedIn) && movableOf(pkg)[0];
if (c) return moveButton(b, c, true);
// one of its subscriptions signed in (Qoder, beside Qoder CN; #556): the
// card says it is, rather than a Sign in that reads as signed out; the
// Installed row offers the others by name
const on = subs.find((x) => x.signedIn);
if (out && !on) {
b.classList.add("go");
b.textContent = t("Sign in");
b.title = subs.length > 1 ? t("Sign in to {name}", { name: out.name }) : "";
b.onclick = (ev) => { ev.stopPropagation(); pluginSignIn(out.id, ev); };
return b;
}
// an update out: the one button says so in place of Signed in or
// Installed, the size of Install in a colour of its own, as an app
// store's Update takes Open's place (#1587). Sign in, not done yet,
// comes first; the Installed row offers its Update then
if (updateButton(b, e)) return b;
if (on) {
b.classList.add("done");
b.append(glyph(CHECK, 11, 2), el("span", "", t("Signed in")));
b.title = t("Open {name} in Providers", { name: on.name });
b.onclick = (ev) => { ev.stopPropagation(); openProvider(on.id); };
return b;
}
b.classList.add("done");
b.append(glyph(CHECK, 11, 2), el("span", "", t("Installed")));
b.disabled = true;
return b;
}
function card(l) {
const c = el("div", "pm-card");
c.tabIndex = 0;
c.setAttribute("role", "button");
c.dataset.pkg = l.package;
const e = entryOf(l.package);
if (e) c.classList.add("have");
const top = el("div", "pm-top");
const who = el("div", "pm-who");
const nm = el("div", "pm-name");
nm.append(el("b", "", l.name));
who.append(nm);
const by = el("div", "pm-by");
if (l.community) {
const v = el("span", "pm-verified");
v.append(glyph(SHIELD, 11, 1.5), el("span", "", t("magpie community")));
v.title = t("Written for magpie by its community, in github.com/magpie-community/plugins");
by.append(v);
} else by.append(el("span", "", l.npm?.publisher || l.package));
who.append(by);
if (l.github) c.classList.add("gh");
const go = actionFor(l.package, l.name, l);
top.append(logo(l.icon || l.npm?.icon, false, kindOf(l)), who, go);
const sum = el("p", "pm-sum", summary(l));
const meta = el("div", "pm-meta");
meta.append(kindChip(kindOf(l)));
if (l.github) meta.append(stars(l.github.stars));
if (l.npm?.weekly) {
const d = el("span", "pm-dl");
d.append(glyph(DOWN, 11, 1.5), el("span", "", t("{n}/week", { n: count(l.npm.weekly) })));
d.title = t("{n} downloads on npm last week", { n: l.npm.weekly.toLocaleString(intlLang()) });
meta.append(d);
}
if (l.npm?.version) {
// an update out, and the card's button is its Update: the version it
// goes to beside the one installed (#1587)
const up = go.classList.contains("pm-up") && e.latest && e.version && newer(e.latest, e.version);
meta.append(el("span", "pm-ver", "v" + (e?.version || l.npm.version) + (up ? " → v" + e.latest : "")));
}
if (e?.error && !e.off) meta.append(el("span", "pm-chip bad", t("Didn't load")));
else if (e?.off) meta.append(el("span", "pm-chip", t("Off")));
if (l.replaces) {
const b = el("span", "pm-chip soft", t("Replaces built-in"));
b.title = t("magpie's own sign-in to this subscription is deprecated: this plugin takes its place, and accounts signed in there move to it");
meta.append(b);
}
c.append(top, sum, meta);
c.onclick = () => detail(l);
c.onkeydown = (ev) => { if (ev.key === "Enter" || ev.key === " ") { ev.preventDefault(); detail(l); } };
return c;
}
function stars(n) {
const d = el("span", "pm-dl");
d.append(glyph(STAR, 11, 1.4), el("span", "", count(n)));
d.title = t("{n} stars on GitHub", { n: (n || 0).toLocaleString(intlLang()) });
return d;
}
// cards still to come, drawn as a card is laid out (its picture, name
// and author, two lines of summary, its facts) for a light to pass over,
// one card after the other
function skeleton(n) {
const g = el("div", "pm-grid");
g.setAttribute("aria-hidden", "true");
const bar = (c) => el("div", "sk " + c);
for (let i = 0; i < n; i++) {
const c = el("div", "pm-card ghost");
c.style.setProperty("--i", i);
const top = el("div", "gtop"), who = el("div", "gwho");
who.append(bar("gname"), bar("gby"));
top.append(bar("glogo"), who, bar("gact"));
const meta = el("div", "gmeta");
meta.append(bar("gchip"), bar("gchip short"));
c.append(top, bar("gline"), bar("gline short"), meta);
g.append(c);
}
return g;
}
function section(title, hint, list) {
const box = el("section", "pm-sec");
const h = el("div", "pm-sechead");
h.append(el("h3", "", title));
if (hint) h.append(el("span", "", hint));
const g = el("div", "pm-grid");
for (const l of list) g.append(card(l));
box.append(h, g);
return box;
}
// The repositories on GitHub are many and of every kind (the owner: 这里
// 应该有分类以及搜索框方便用户筛选), so their section has its own kinds
// to pick from, each with how many there are, and a field that narrows
// them by name, author or description as it is typed, once there are
// more than a few to look through (counted before the page's search, so
// they don't go away under someone typing). Both narrow what the page's
// search has already found; only the section is drawn again.
// What's installed is the other question the section is read with (the
// owner: 加一个未安装), and it cuts across the kinds: a reader after a
// middleware they haven't got picks Middleware and Not installed. So it
// is a second strip beside the kinds, each counting what the other, the
// field and the page's search leave — the counts follow the picks as
// they are made — and the two narrow the grid together.
// The section, its head and its field are made once and kept in the
// page, as the page's search field is (#1055).
let ghKind = ""; // "" (all) | "pv" | "mw" | "ag"
let ghHave = ""; // "" (all) | "have" | "none"
let ghQuery = "";
let ghList = []; // what the page's search left of the repositories
const ghSec = el("section", "pm-sec pm-ghsec");
const ghHead = el("div", "pm-sechead");
const ghBar = el("div", "pm-ghbar");
const ghGrid = el("div", "pm-grid");
const ghFind = el("label", "pm-find pm-ghfind");
const ghQ = el("input");
ghQ.type = "search";
ghQ.spellcheck = false;
ghQ.autocomplete = "off";
ghQ.oninput = () => { ghQuery = ghQ.value; drawGh(); };
ghQ.onkeydown = (ev) => { ev.stopPropagation(); if (ev.key === "Escape" && ghQ.value) { ghQ.value = ""; ghQ.oninput(); } };
ghFind.append(glyph(SEARCH, 13, 1.6), ghQ);
const ghMatch = (l) => {
const f = ghQuery.trim().toLowerCase();
return !f || [l.name, l.github.repo, l.github.owner, l.package, summary(l)].join(" ").toLowerCase().includes(f);
};
const ghTitle = () => [el("h3", "", t("Unofficial, on GitHub")), el("span", "", t("repositories their authors tagged {topic} — nobody has reviewed them; read the code before you install one", { topic }))];
// GitHub answers after the rest, seconds after on a slow line, and a
// section that wasn't there read as there being no such plugins (the
// owner: 网慢的用户以为没有非官方插件). Until it answers the section
// stands in its place with its head, a word that it is looking and
// cards still to come; its cards then come in where those were.
let ghArrive = false;
function ghWaiting() {
const look = el("span", "pm-ghlook");
look.setAttribute("role", "status");
const dots = el("span", "dots");
dots.setAttribute("aria-hidden", "true");
dots.append(el("i"), el("i"), el("i"));
look.append(dots, el("span", "", t("Looking on GitHub")));
ghHead.replaceChildren(...ghTitle(), look);
ghSec.setAttribute("aria-busy", "true");
ghArrive = true;
replaceKeeping(ghSec, [ghHead, skeleton(3)]);
return ghSec;
}
// why the list isn't GitHub's whole answer; kept: cards are shown. A
// known kind in the reader's words, the raw error as its hover
const ghWhy = (kept) => {
const error = { slow: t("GitHub didn't answer in time"), limited: t("GitHub is turning requests away for now") }[taggedKind] || taggedErr;
const s = el("span", "", taggedMissing
? t(kept ? "{n} more on GitHub couldn't be read: {error}" : "GitHub found {n} repositories, but none of them could be read: {error}", { n: taggedMissing, error })
: t(kept ? "Couldn't ask GitHub, so these are from before: {error}" : "Couldn't ask GitHub: {error}", { error }));
if (error !== taggedErr) s.title = taggedErr;
return s;
};
// and one GitHub couldn't be asked of says so, with another go
function ghFailed() {
ghHead.replaceChildren(...ghTitle());
ghSec.removeAttribute("aria-busy");
const box = el("div", "pm-ghnone");
const again = el("button", "text", t("Try again"));
again.type = "button";
again.onclick = () => {
tagged = null;
taggedErr = "";
taggedMissing = 0;
drawBody();
loadTagged(true).then(drawBody);
};
box.append(ghWhy(false), again);
replaceKeeping(ghSec, [ghHead, box]);
return ghSec;
}
// the cards GitHub could give, and a line saying what it couldn't, with
// another go that keeps them until it answers
function ghNote() {
const note = el("div", "pm-ghwarn");
note.setAttribute("role", "status");
const again = el("button", "text", t("Try again"));
again.type = "button";
again.onclick = () => {
again.disabled = true;
loadTagged(true).then(drawBody);
};
note.append(ghWhy(true), again);
return note;
}
function ghSection(list) {
ghList = list;
ghHead.replaceChildren(...ghTitle());
ghSec.removeAttribute("aria-busy");
drawGh();
// the first cards after the wait come in, one after the other; the
// grid drawn again for a pick doesn't
if (ghArrive) {
ghArrive = false;
ghSec.classList.add("pm-arrive");
[...ghGrid.children].forEach((c, i) => c.style.setProperty("--i", Math.min(i, 9)));
setTimeout(() => ghSec.classList.remove("pm-arrive"), 900);
}
return ghSec;
}
function drawGh() {
const head = taggedErr ? [ghHead, ghNote()] : [ghHead];
if ((tagged || []).length <= 6) {
ghGrid.replaceChildren(...ghList.map(card));
replaceKeeping(ghSec, [...head, ghGrid]);
return;
}
// the kinds there are, in the market's order, each with how many the
// field leaves of it; one kind alone needs no picking
const found = ghList.filter(ghMatch);
const kinds = ["pv", "mw", "ag", "tl", "pg"].filter((k) => ghList.some((l) => kindOf(l) === k));
if (!kinds.includes(ghKind)) ghKind = "";
// which of them are here, asked once each: the counts below would ask
// it again for every pick in both strips. Like a kind alone, a list
// that is all installed or all not has nothing to pick out, and a pick
// that can no longer be seen doesn't go on narrowing the grid.
const here = new Map(ghList.map((l) => [l, !!entryOf(l.package)]));
const have = (l) => here.get(l);
const both = ghList.some(have) && ghList.some((l) => !have(l));
if (!both) ghHave = "";
// the field and the other strip narrow it, so each count is what a
// pick in this strip would leave; the kind's own pick is the one left
// out, or every count but All would be the picked kind's alone
const n = (k, h) => found.filter((l) => (!k || kindOf(l) === k) && (!h || have(l) === (h === "have"))).length;
const bar = [];
if (kinds.length > 1) {
const pick = segs([["", t("All") + " · " + n("", ghHave)], ...kinds.map((k) => [k, t(KINDS[k][1]) + " · " + n(k, ghHave)])], ghKind, (k) => { ghKind = k; drawGh(); });
pick.classList.add("pm-ghkinds");
pick.setAttribute("role", "group");
pick.setAttribute("aria-label", t("Kind of plugin"));
bar.push(pick);
}
// what's installed, on both sides of it: a reader looks for what to
// add as much as for what they have
if (both) {
const pick = segs([["", t("All")], ["have", t("Installed") + " · " + n(ghKind, "have")], ["none", t("Not installed") + " · " + n(ghKind, "none")]], ghHave, (h) => { ghHave = h; drawGh(); });
pick.classList.add("pm-ghhave");
pick.setAttribute("role", "group");
pick.setAttribute("aria-label", t("Installed or not"));
bar.push(pick);
}
bar.push(el("span", "grow"), ghFind);
ghQ.placeholder = t("Filter by name, author or description");
ghQ.setAttribute("aria-label", t("Filter the plugins on GitHub"));
if (ghQ.value !== ghQuery) ghQ.value = ghQuery;
replaceKeeping(ghBar, bar);
const shown = found.filter((l) => (!ghKind || kindOf(l) === ghKind) && (!ghHave || have(l) === (ghHave === "have")));
if (shown.length) {
ghGrid.replaceChildren(...shown.map(card));
replaceKeeping(ghSec, [...head, ghBar, ghGrid]);
return;
}
const none = el("div", "pm-ghnone");
const all = el("button", "text", t("Show all"));
all.type = "button";
all.onclick = () => { ghKind = ""; ghHave = ""; ghQuery = ""; drawGh(); ghQ.focus(); };
none.append(el("span", "", t("No plugin on GitHub matches")), all);
replaceKeeping(ghSec, [...head, ghBar, none]);
}
// the head and its search field are made once and drawn again in
// place: the field is never taken out of the page, or a key an IME
// commits while it is out lands twice (#1055)
const headBox = el("div", "lib-head pm-head");
const find = el("label", "pm-find");
const q = el("input");
q.type = "search";
q.spellcheck = false;
q.autocomplete = "off";
q.oninput = () => {
query = q.value;
if (tab !== "discover") { tab = "discover"; draw(); }
clearTimeout(searchTimer);
const s = query.trim();
if (s.length < 2) hits = null;
else {
hits = { q: s, loading: true };
searchTimer = setTimeout(() => searchNPM(s), 350);
}
drawBody();
};
q.onkeydown = (ev) => { ev.stopPropagation(); if (ev.key === "Escape" && q.value) { q.value = ""; q.oninput(); } };
find.append(glyph(SEARCH, 13, 1.6), q);
function head() {
const n = mine?.plugins?.length || 0;
const tabs = segs([["builtin", t("Built-in")], ["discover", t("Discover")], ["installed", t("Installed") + (n ? " · " + n : "")]], tab, (id) => {
tab = id;
try { localStorage.setItem("magpie.pluginTab", id); } catch {}
searchShown();
drawBody();
});
tabs.classList.add("lib-tabs");
tabs.querySelectorAll(".opt")[2].dataset.sub = "installed";
q.placeholder = t("Search plugins and npm…");
if (q.value !== query) q.value = query;
q.setAttribute("aria-label", t("Search plugins"));
mirror = mirrorSwitch();
replaceKeeping(headBox, [tabs, el("span", "grow"), mirror, find]);
searchShown();
headBox.classList.toggle("stuck", page.scrollTop > 0);
return headBox;
}
// 「国内镜像」: the list, npm's packages and answers, and Bun asked of
// mirrors in China first (npmmirror, jsDelivr); none before what's
// installed has come, which says how it is set
let mirrorSaving = false;
// the built-in plugins are a short list of switches: nothing to search
// or fetch through a mirror
let mirror = null;
function searchShown() {
find.hidden = tab === "builtin";
if (mirror) mirror.hidden = !mine || tab === "builtin";
}
function mirrorSwitch() {
const on = !!mine?.mirror;
const b = el("button", "pm-mirror" + (on ? " on" : ""));
b.type = "button";
b.hidden = !mine;
b.disabled = mirrorSaving;
b.setAttribute("role", "switch");
b.setAttribute("aria-checked", on ? "true" : "false");
b.setAttribute("aria-label", t("Mirrors in China"));
b.title = t("Download the plugin list, plugins and Bun from mirrors in China first (npmmirror, jsDelivr), their official addresses after. Each is a copy of the very file, checked as the original is");
const sw = el("span", "lib-switch" + (on ? " on" : ""));
sw.append(el("i"));
b.append(el("span", "", t("Mirrors in China")), sw);
b.onclick = async () => {
if (mirrorSaving || !mine) return;
mirrorSaving = true;
mine.mirror = !on;
draw();
try {
const r = await api("plugins/mirror", { on: !on });
mine.mirror = r.mirror;
// the list again, now from the mirror, and npm's answers with it
if (r.mirror) loadListings().then(() => { draw(); askNPM(); });
} catch (e) {
mine.mirror = on;
status(t(e.message), "err");
}
mirrorSaving = false;
draw();
};
return b;
}
async function searchNPM(s) {
try {
const r = await api("plugins/search?q=" + encodeURIComponent(s));
if (hits?.q === s) hits = { q: s, list: r.hits };
} catch (e) {
if (hits?.q === s) hits = { q: s, error: e.message };
}
if (hits?.q === s) drawBody();
}
page.addEventListener("scroll", () => page.querySelector(".pm-head")?.classList.toggle("stuck", page.scrollTop > 0), { passive: true });
let body = null;
function draw() {
const scroll = page.scrollTop;
// the body is made once, so the GitHub section's field stays in the page
body = body || el("div", "lib-body pm-body");
replaceKeeping(page, [head(), body]);
drawBody();
page.scrollTop = scroll;
}
function drawBody() {
if (!body) return;
const key = tab + (query ? ":q" : "");
body.classList.toggle("enter", shown !== key);
shown = key;
// the search field keeps its focus: only the body is redrawn while
// typing, and the GitHub section's field is kept in it
if (tab === "installed" || tab === "builtin" || !listings) body.replaceChildren();
if (tab === "installed") return drawInstalled();
if (tab === "builtin") return drawBuiltin();
if (failedList && !listings) {
body.append(el("p", "pm-empty", t("Couldn't load the plugins: {error}", { error: failedList })));
return;
}
if (!listings) {
body.append(intro(), skeleton(6));
return;
}
const f = query.trim().toLowerCase();
const match = (l) => !f || [l.name, l.package, summary(l), (l.providers || []).join(" "), l.npm?.publisher || ""].join(" ").toLowerCase().includes(f);
const ls = listings.filter(match);
// a tagged repository the market already lists is the market's card
const listed = new Set(listings.map((l) => l.package));
const gh = (tagged || []).filter((l) => !(l.github.package && listed.has(l.github.package)) && match(l));
// put in place around the GitHub section, which stays in the page
const out = [];
if (!f) {
out.push(intro());
// magpie's community's alone: others' plugins are found by a search
const ours = ls.filter((l) => l.community && kindOf(l) === "pv");
const mws = ls.filter((l) => l.community && kindOf(l) === "mw");
const ags = ls.filter((l) => l.community && kindOf(l) === "ag");
const tls = ls.filter((l) => l.community && kindOf(l) === "tl");
const pgs = ls.filter((l) => l.community && kindOf(l) === "pg");
if (ours.length) out.push(section(t("Subscriptions"), t("written for magpie, checked against its own sign-ins"), ours));
if (mws.length) out.push(section(t("Gateway middleware"), t("runs in magpie's gateway on what every agent sends and gets back, whichever provider serves it"), mws));
const agSec = ags.length ? section(t("Agents"), t("agents magpie has no setup of its own for, connected to it as its own are"), ags) : null;
if (agSec) { agSec.classList.add("pm-agents"); out.push(agSec); }
if (tls.length) out.push(section(t("Tools for agents"), t("tools every agent can call, through magpie's MCP server"), tls));
if (pgs.length) out.push(section(t("Pages"), t("pages of their own in magpie's window, each shut off from the rest and reading only what it lists"), pgs));
if (gh.length) out.push(ghSection(gh));
else if (!tagged) out.push(ghWaiting());
else if (taggedErr && !tagged.length) out.push(ghFailed());
out.push(manual());
replaceKeeping(body, out);
if (agentsFor && agSec) {
// after the view is put back where the reader was, as showing it
// does; the section then is the one drawn last (npm's answers draw
// it again)
if (window.scrollOnPurpose?.(agentsFor)) requestAnimationFrame(() => { body.querySelector(".pm-agents")?.scrollIntoView({ block: "start" }); window.arrived?.(page); });
agentsFor = null;
}
return;
}
if (ls.length) out.push(section(t("Suggested"), "", ls));
if (gh.length) out.push(ghSection(gh));
else if (!tagged) out.push(ghWaiting());
else if (taggedErr && !tagged.length) out.push(ghFailed());
const known = new Set([...listings.map((l) => l.package), ...(tagged || []).map((l) => l.github.package).filter(Boolean)]);
const box = el("section", "pm-sec");
const h = el("div", "pm-sechead");
h.append(el("h3", "", t("On npm")), el("span", "", t("OpenCode plugins and pi packages anyone published — read what one does before you install it")));
box.append(h);
if (!hits) box.append(el("p", "pm-note", t("Type two letters or more to search npm")));
else if (hits.loading) box.append(skeleton(2));
else if (hits.error) box.append(el("p", "pm-note bad", hits.error));
else {
const list = hits.list.filter((x) => !known.has(x.package));
if (!list.length) box.append(el("p", "pm-note", ls.length ? t("Nothing else on npm") : t("No plugin called “{q}”", { q: query.trim() })));
const g = el("div", "pm-grid");
for (const x of list) g.append(card({ package: x.package, name: x.package, npm: x }));
box.append(g);
}
out.push(box);
replaceKeeping(body, out);
}
function intro() {
const box = el("div", "pm-intro");
const text = el("div", "pm-introtext");
text.append(el("h2", "", t("Plugins extend magpie")));
text.append(el("p", "", t("Plugins sign in to coding plans and make their requests; the models then work in every agent, like any provider's. They're OpenCode's provider plugins or pi's packages, run on Bun.")));
const mw = el("p", "");
mw.append(document.createTextNode(t("A plugin can also run in magpie's gateway on what agents send and get back, pick which account a routing asks, give every agent tools, connect an agent, or add a page of its own.") + " "));
// the docs in the reader's language: the site has en, zh and ja, and
// Chinese is nearer a zh-TW reader than English is
const how = el("a", "pm-link pm-write", "");
how.href = "https://usemagpie.ai/docs/" + ({ zh: "zh/", "zh-TW": "zh/", ja: "ja/" }[lang()] || "") + "plugins";
how.append(el("span", "", t("Write a plugin")), glyph(OUTL, 11, 1.5));
how.onclick = (ev) => { ev.preventDefault(); api("open", { url: how.href }).catch(() => {}); };
mw.append(how);
text.append(mw);
const trust = el("p", "pm-trust");
trust.append(glyph(SHIELD, 12, 1.5), el("span", "", t("A plugin is someone else's code with your sign-in or your requests: install the ones you trust.")));
text.append(trust);
const art = el("div", "pm-art");
for (const ic of ["zcode", "githubcopilot", "gemini-color", "zed", "kiro-color"]) art.append(logo(ic));
box.append(text, art);
return box;
}
// a package or a folder the market doesn't list
function manual() {
const box = el("form", "pm-manual");
box.append(el("span", "pm-mlabel", t("Have one in mind?")));
const spec = el("input", "pm-minput");
spec.placeholder = t("npm package, GitHub repo (github:owner/repo) or a folder");
spec.spellcheck = false;
spec.autocomplete = "off";
spec.setAttribute("aria-label", t("Plugin"));
spec.onkeydown = (ev) => ev.stopPropagation();
const go = el("button", "text primary", t("Install"));
go.type = "submit";
go.disabled = busy.size > 0;
if (busy.has("+")) { go.textContent = t("Installing…"); spec.disabled = true; }
box.onsubmit = (ev) => {
ev.preventDefault();
const s = spec.value.trim();
if (!s || busy.size) return;
act("+", "add", { spec: s }, () => status(t("{name} is installed", { name: s }), "ok"));
};
box.append(spec);
// a folder is picked, not typed, where magpie can show the system's
// picker (`magpie web` can't, and the market says so)
if (mine?.picker) box.append(browse(spec, go));
box.append(go);
return box;
}
// the system's folder picker: what it answers goes in the field, for the
// Install beside it
function browse(spec, go) {
const b = el("button", "pm-browse");
b.type = "button";
b.append(glyph(FOLDER, 14, 1.5));
b.title = t("Choose a folder on this computer");
b.setAttribute("aria-label", t("Choose a folder"));
b.disabled = busy.size > 0 || spec.disabled;
b.onclick = async () => {
b.disabled = true;
try {
const r = await api("plugins/choose", {});
if (r.dir) {
spec.value = r.dir;
spec.focus();
}
} catch (e) {
status(e.message, "err");
} finally {
b.disabled = busy.size > 0 || spec.disabled;
}
};
return b;
}
// Built-in: magpie's own plugins (Sessions, Library, routing groups…),
// each with a switch (renderBuiltins in app.js), read afresh each time
// the tab is drawn
let builtins = null, builtinsFailed = "";
async function loadBuiltins() {
try {
builtins = await api("plugins/builtin");
builtinsFailed = "";
} catch (e) {
builtinsFailed = e.message;
}
if (tab === "builtin") drawBody();
}
function drawBuiltin() {
const say = el("p", "feat-say", t("Parts of magpie not everyone needs. Switched off, a part leaves the sidebar, its pages and Settings; magpie works the same either way."));
const list = el("div", "list prefs");
list.id = "builtinList";
body.append(say, list);
if (builtinsFailed && !builtins) list.append(el("p", "pm-empty", t(builtinsFailed)));
else if (builtins) window.renderBuiltins(list, builtins, (next) => { builtins = next; drawBody(); });
}
function drawInstalled() {
if (failed && !mine) {
body.append(el("p", "pm-empty", t("Couldn't load the plugins: {error}", { error: failed })));
return;
}
if (!mine) { body.append(skeleton(2)); return; }
const es = mine.plugins || [];
if (!es.length) {
const none = el("div", "pm-none");
none.append(logo("", true), el("b", "", t("No plugins yet")), el("p", "", t("Install a subscription or a middleware from Discover; a subscription signs in from here.")));
const b = el("button", "pm-act get", t("Discover plugins"));
b.onclick = () => { tab = "discover"; draw(); };
none.append(b);
body.append(none);
return;
}
// what the sidebar's dot is about, said where it's acted on: which
// plugins have a newer version, and one press to update them all
const outdated = es.filter((e) => (e.latest && e.version && newer(e.latest, e.version)) || (gitBehind(e) && !e.off));
if (outdated.length) {
const bar = el("div", "pm-updates");
const names = outdated.map(shownName).join(t(", "));
bar.append(el("span", "pm-dot"), el("span", "grow", outdated.length === 1
? t("A newer version of {name} is out", { name: names })
: t("Newer versions of {n} plugins are out: {names}", { n: outdated.length, names })));
const up = el("button", "pm-act pm-up", busy.has("*") ? t("Updating…") : t("Update all ({n})", { n: outdated.length }));
up.type = "button";
up.disabled = busy.size > 0 || checking;
up.onclick = () => act("*", "update", {}, () => status(t("Plugins updated"), "ok"));
bar.append(up);
body.append(bar);
}
// by name, in the order the reader picked (#481), not the order they
// were installed in
const list = el("div", "list pm-list");
const fill = () => list.replaceChildren(...[...es].sort(byName(sortOf("plugins"), shownName)).map(installedRow));
if (es.length > 1) {
const h = el("div", "row-head pm-listhead");
h.append(el("span", "grow"), sortBy("plugins", NAME_SORTS, fill));
body.append(h);
}
fill();
body.append(list);
const foot = el("div", "pm-foot");
foot.append(el("span", "", mine.bun ? t("Plugins run on Bun {v}", { v: mine.bunVersion }) : ""), el("span", "grow"));
// npm has versions to ask for, and a git one's repository commits; a
// folder has none
if (es.some((e) => onNPM(e.spec) || isGit(e.spec))) {
const c = el("button", "text pm-check" + (checking ? " busy" : ""));
if (checking) c.append(el("span", "spin"));
c.append(el("span", "", checking ? t("Checking…") : t("Check for updates")));
c.title = t("Ask npm now for each plugin's newest version") + (checked ? "\n" + t("Last checked {time}", { time: checkedAt() }) : "");
c.disabled = checking || busy.size > 0;
c.onclick = () => checkUpdates();
foot.append(c);
}
body.append(foot);
}
// an installed plugin's name as its row shows it: the market's, else the
// package's or the folder's
function shownName(e) {
const pkg = name(e.spec);
return (listings || []).find((x) => x.package === pkg)?.name || (isGit(e.spec) && e.package) || label(e.spec);
}
function installedRow(e) {
const pkg = name(e.spec);
const l = (listings || []).find((x) => x.package === pkg);
const r = el("div", "row pm-row" + (e.off ? " off" : ""));
const who = el("div", "who");
const nm = el("div", "name");
nm.append(el("span", "", shownName(e)));
if (e.version) nm.append(el("span", "pm-ver", "v" + e.version));
// a git one's commit says which of its repository's it is
if (isGit(e.spec) && e.commit) {
const c = el("span", "pm-ver", e.commit);
c.title = t("The commit of {repo} installed", { repo: e.spec });
nm.append(c);
}
const ck = checked?.by[e.spec];
if (gitBehind(e)) {
const c = el("span", "pm-chip up", t("New commits"));
c.title = t("{have} installed, {repo} is at {head}", { have: e.commit, repo: e.spec, head: e.head });
nm.append(c);
} else if (e.latest && e.version && newer(e.latest, e.version)) {
const c = el("span", "pm-chip up", t("v{v} out", { v: e.latest }));
c.title = t("v{have} installed, v{v} on npm", { have: e.version, v: e.latest });
nm.append(c);
} else if (ck?.status === "unknown") {
// asked just now, and npm didn't say: the row says why
const c = el("span", "pm-chip warn");
c.append(el("span", "dot"), el("span", "", t("Couldn't check")));
c.title = whyText(ck);
nm.append(c);
} else if (e.autoUpdated && e.autoUpdated.to === e.version) {
// magpie updated it by itself lately: the row says so, quietly
const c = el("span", "pm-chip soft", t("Auto-updated"));
c.title = t("magpie updated it from v{from} to v{to} on {date}", { from: e.autoUpdated.from, to: e.autoUpdated.to, date: new Date(e.autoUpdated.at).toLocaleDateString(intlLang(), { month: "short", day: "numeric" }) });
nm.append(c);
} else if ((ck?.status === "current" || ck?.status === "update") && e.version) {
const c = el("span", "pm-chip soft", t("Up to date"));
c.title = (isGit(e.spec) ? t("{head} is the newest commit of {repo}", { head: ck.head || e.head || "", repo: e.spec }) : t("v{v} is the newest on npm", { v: e.version })) + "\n" + t("Last checked {time}", { time: checkedAt() });
nm.append(c);
}
// built-ins moved onto it, then its other providers if 2+ (#3902)
const moved = (e.moved || []).map((id) => SUBS.find((x) => x.agent === id)?.name || id);
const names = moved.join(t(", "));
const all = [...moved, ...e.serves || []];
if (all[0] && !e.off) {
const c = el("span", "pm-chip moved");
c.append(el("span", "dot"), el("span", "", t("Serves {names}", { names: all.join(t(", ")) })));
if (names) c.title = t("{names} runs on this plugin in place of the built-in", { names });
nm.append(c);
}
// gateway middleware runs in magpie's gateway, not as a subscription:
// the row says so, and how it is doing, on a line of its own
const mw = e.middleware;
const gw = e.gateway;
const ag = e.agent;
if (mw || e.isMiddleware) nm.append(kindChip("mw"));
if (gw || e.isGateway) {
const chip = kindChip("mw");
chip.querySelector("span").textContent = t("Request hook");
nm.append(chip);
}
if (ag || e.isAgent) nm.append(kindChip("ag"));
// a plugin of tools alone signs in to nothing: no Provider chip
const toolsOnly = !!e.tools?.length && !e.providers?.length;
if (e.tools?.length) nm.append(kindChip("tl"));
if (e.page) nm.append(kindChip("pg"));
if (e.panels?.length) nm.append(kindChip("pn"));
if (e.providers?.length || !(e.gatewayOnly || e.middlewareOnly || e.inMagpieOnly || toolsOnly || (mw && !e.isMiddleware) || (ag && !e.isAgent))) nm.append(kindChip("pv"));
who.append(nm);
const subs = subsOf(pkg);
const sub = el("div", "sub");
const cands = e.off ? [] : movableOf(pkg);
// a provider another installed plugin signs in to as well (neiko on
// Discord: a third-party plugin and their own one both name it). One
// of them serves it; the row says which, and the other gets a way to
// take it over, rather than the provider just going missing
const clashes = e.off || e.error ? [] : e.clashes || [];
const nameOfSpec = (spec) => { const o = (mine?.plugins || []).find((x) => x.spec === spec); return o ? shownName(o) : label(spec); };
const ask = asking?.pkg === pkg && !busy.size && (asking.op === "move" ? cands.length : moved.length) ? asking.op : "";
if (ask === "move") {
sub.textContent = t("{names} can run on it again, with the same accounts.", { names: cands.map((c) => c.name).join(t(", ")) });
sub.classList.add("ask");
} else if (ask) {
sub.textContent = t(ask === "remove" ? "{names} stops working until the plugin is installed again. Its accounts are kept." : "{names} stops working while the plugin is off. Its accounts are kept.", { names });
sub.classList.add("ask");
} else if (e.off) sub.textContent = t("Off");
else if (e.error) { sub.textContent = t("Didn't load: {error}", { error: e.error }); sub.classList.add("bad"); sub.title = e.error; }
else if (subs.length) {
for (const [i, x] of subs.entries()) {
if (i) sub.append(el("span", "sep", " · "));
const s = el("span", "pm-sub" + (x.signedIn ? " in" : ""));
// its built-in runs it, with its accounts: nothing to fix here
const builtin = !x.signedIn && cands.some((c) => c.id === x.pid);
s.append(el("span", "dot"), el("span", "", x.signedIn ? t("{name}: signed in", { name: x.name }) : builtin ? t("{name}: on magpie's built-in", { name: x.name }) : t("{name}: not signed in", { name: x.name })));
if (builtin) s.title = t("{name} runs on magpie's built-in, with your accounts; Move {name} here runs it on this plugin", { name: x.name });
else if (!x.signedIn && subs.some((y) => y.signedIn)) s.title = t("{name} is a subscription of its own; {other} works without it", { name: x.name, other: subs.find((y) => y.signedIn).name });
sub.append(s);
}
} else if ((mw || ag || gw || e.isGateway || toolsOnly || (e.page || e.panels?.length) && e.inMagpieOnly) && !e.providers.length) {
// only middleware, a request hook, an agent, tools, a page or panels: its own line says what it does
} else if (clashes.length && !e.providers.length) {
// its own line below says whose it is
} else if (e.providers.length) sub.textContent = t("Signs in to {names}", { names: e.providers.join(t(", ")) });
// an empty list only means "nothing" once the plugins have answered: a
// plugin installed a moment ago has no names yet, and the page says
// nothing rather than claiming here that it signs in to nothing magpie
// can use, which isn't known until the answer comes (#1112)
else if (e.named) sub.textContent = t("Signs in to nothing magpie can use");
if (sub.textContent) who.append(sub);
if (!ask) for (const c of clashes) who.append(clashLine(e, c, nameOfSpec));
if (mw && !e.off && !ask) who.append(mwLine(mw));
if (gw && !e.off && !ask) who.append(gatewayLine(gw));
if (ag && !e.off && !ask) who.append(agentLine(ag));
if (e.tools?.length && !e.off && !ask) who.append(toolsLine(e.tools));
// off too: what its page may read is said before it is turned on
if (e.page && !ask) who.append(pageLine(e.page));
if (e.panels?.length && !ask) who.append(panelsLine(e.panels, e.panelReads));
if (e.actions?.length && !ask) who.append(actionsLine(e.actions));
if ((mw || e.isGateway) && !e.off && !ask && editing?.pkg === pkg) who.append(optionsEditor(e));
// the plugin's own picture (package.json's magpie.icon) before its
// first provider's, which a plugin of several gives each its own (#1775)
r.append(logo(l?.icon || l?.npm?.icon || e.icon || subs[0]?.icon || ag?.icon, false, e.middlewareOnly ? "mw" : e.inMagpieOnly && e.isAgent && !e.isMiddleware ? "ag" : e.inMagpieOnly && (e.page || e.panels?.length) && !e.isAgent && !e.isMiddleware ? "pg" : toolsOnly && !e.page && !mw && !ag ? "tl" : ""), who);
const val = el("div", "val");
const b = busy.get(pkg) || busy.get(e.spec);
// npm's newer version, or a git one's repository at a newer commit
// than the one installed (Update shown all the time before, and still
// there right after an update): the same Update as a card's (#1587)
const up = el("button");
if (updateButton(up, e)) val.append(up);
const here = !e.off && !e.error && !subs.some((x) => x.signedIn) && cands[0];
if (here && !ask) {
const mv = el("button", "text primary", b === "move" ? t("Moving…") : t("Move {name} here", { name: here.name }));
mv.title = t("Runs {name} on this plugin in place of the built-in, with the same accounts; nothing changes if one doesn't work through it", { name: here.name });
mv.disabled = busy.size > 0;
mv.onclick = () => move(here);
val.append(mv);
}
for (const c of ask ? [] : clashes.filter((c) => c.by !== e.spec)) {
const u = el("button", "text", b === "prefer" ? t("Switching…") : t("Use for {name}", { name: c.name }));
u.title = t("{name} runs on this plugin instead of {other}; both stay installed", { name: c.name, other: nameOfSpec(c.by) });
u.disabled = busy.size > 0;
u.onclick = () => act(pkg, "prefer", { spec: e.spec, provider: c.id }, () => status(t("{name} now runs on {plugin}", { name: c.name, plugin: shownName(e) }), "ok"));
val.append(u);
}
if (!e.off && !e.error && subs.some((x) => !x.signedIn)) {
// signed in to one of its subscriptions already (Qoder, beside Qoder
// CN; #556): a blue Sign in read as the plugin signed out, so the
// button names the one it signs in to and stays quiet
const out = subs.find((x) => !x.signedIn), some = subs.some((x) => x.signedIn);
const s = el("button", "text" + (here || some ? "" : " primary"), some ? t("Sign in to {name}", { name: out.name }) : t("Sign in"));
s.onclick = (ev) => pluginSignIn(out.id, ev);
val.append(s);
}
// switched on again: a built-in it can carry is offered its way, in
// the row
const again = () => { if (movableOf(pkg).length) { asking = { pkg, op: "move" }; draw(); } };
const off = () => act(pkg, "off", { spec: e.spec, off: !e.off }, e.off ? again : null);
const remove = () => act(pkg, "remove", { spec: e.spec }, () => status(t("{name} removed", { name: l?.name || pkg }), "ok"));
if (ask) {
// asked in the row, not a dialog: the user sees which go back
const yes = el("button", "text primary", t(ask === "move" ? "Move" : ask === "remove" ? "Remove" : "Switch off"));
yes.onclick = () => { asking = null; ask === "move" ? move(cands[0]) : ask === "remove" ? remove() : off(); };
const no = el("button", "text", t(ask === "move" ? "Not now" : "Cancel"));
no.onclick = () => { asking = null; draw(); };
val.append(no, yes);
r.append(val);
return r;
}
if ((e.isGateway || (mw && !mw.error)) && !e.off && editing?.pkg !== pkg) {
const o = el("button", "text", t("Options"));
o.title = e.options ? t("The options it runs with") : t("It runs with no options; its package suggests some");
o.disabled = !!b;
o.onclick = () => {
editing = { pkg, text: JSON.stringify(e.options || e.optionsExample || {}, null, 2), error: "" };
draw();
// the field the click opened takes the keys, where it is
page.querySelector(".pm-opts textarea")?.focus({ preventScroll: true });
};
val.append(o);
}
const onoff = el("button", "text", t(e.off ? "Switch on" : "Switch off"));
onoff.disabled = !!b;
onoff.onclick = () => { if (!e.off && moved.length) { asking = { pkg, op: "off" }; draw(); } else off(); };
const rm = el("button", "text quiet", b === "remove" ? t("Removing…") : t("Remove"));
rm.title = moved.length ? t("{names} runs on this plugin: removed, it stops working until the plugin is installed again", { names }) : t("Removes the plugin and what it installed; its sign-ins are kept until you sign out");
rm.disabled = busy.size > 0;
rm.onclick = async () => {
if (moved.length) {
asking = { pkg, op: "remove" };
draw();
return;
}
if (await confirmRemoval(l?.name || pkg, rm.title)) remove();
};
val.append(onoff, rm);
r.append(val);
r.onclick = (ev) => { if (!ev.target.closest("button, .pm-opts")) detail(l || (isGit(e.spec) ? { package: e.spec, name: e.package || e.spec, icon: e.icon, npm: { version: e.version, repository: gitWeb(e.spec) } } : { package: pkg, name: label(e.spec), icon: e.icon, npm: { version: e.latest } })); };
return r;
}
// optionsEditor is a middleware's options as JSON, in its row: what it
// runs with, or what its package suggests when it has none. The draft is
// kept in editing, so a redraw while typing doesn't lose it.
function optionsEditor(e) {
const box = el("div", "pm-opts");
const ta = document.createElement("textarea");
ta.setAttribute("aria-label", t("Options"));
ta.setAttribute("aria-describedby", "pluginOptionsNote pluginOptionsError");
ta.setAttribute("aria-invalid", String(!!editing.error));
ta.spellcheck = false;
ta.value = editing.text;
ta.rows = Math.min(14, Math.max(4, editing.text.split("\n").length + 1));
ta.oninput = () => { editing.text = ta.value; };
ta.onkeydown = (ev) => {
if (ev.key === "Escape") { editing = null; draw(); }
if (ev.key === "Enter" && (ev.metaKey || ev.ctrlKey)) { ev.preventDefault(); save(); }
};
const err = el("div", "pm-opts-err", editing.error);
err.id = "pluginOptionsError";
err.setAttribute("role", "alert");
const bar = el("div", "pm-opts-bar");
const note = el("span", "", e.options ? t("Applied to the next request") : t("Not set: these are its package's example"));
note.id = "pluginOptionsNote";
const save = () => {
let v;
try { v = JSON.parse(editing.text || "{}"); } catch (x) { editing.error = t("Not JSON: {error}", { error: x.message }); return draw(); }
if (!v || typeof v !== "object" || Array.isArray(v)) { editing.error = t("Options are a JSON object"); return draw(); }
editing = null;
act(name(e.spec), "options", { spec: e.spec, options: v }, () => status(t("{name}'s options saved", { name: shownName(e) }), "ok"));
};
const ok = el("button", "text primary", t("Save"));
ok.onclick = save;
const no = el("button", "text", t("Cancel"));
no.onclick = () => { editing = null; draw(); };
bar.append(note);
if (e.options) {
const clr = el("button", "text quiet", t("Clear"));
clr.title = t("Runs it with no options");
clr.onclick = async () => {
if (!await confirmAction(t("Clear"), t("Saved middleware options will be removed. The plugin will run with no options."), t("Clear"))) return;
editing = null;
act(name(e.spec), "options", { spec: e.spec, options: null }, () => status(t("{name}'s options cleared", { name: shownName(e) }), "ok"));
};
bar.append(clr);
}
bar.append(no, ok);
box.append(ta, err, bar);
return box;
}
// mwLine is a middleware's line in its plugin's row: its hooks, how many
// calls and how long each took, and the calls that failed (which went on
// as if it weren't there), or why it didn't load
// clashLine is one provider two installed plugins both sign in to, as
// the row of either says it: served here, or served by the other one
function clashLine(e, c, nameOfSpec) {
const d = el("div", "sub pm-clash" + (c.by === e.spec ? "" : " warn"));
const others = (c.by === e.spec ? c.with : [c.by]).map(nameOfSpec).join(t(", "));
d.append(el("span", "dot"), el("span", "", c.by === e.spec
? t("{other} signs in to {name} too; this one serves it", { name: c.name, other: others })
: t("{name} is served by {other}, which signs in to it too", { name: c.name, other: others })));
d.title = c.by === e.spec
? t("Two plugins sign in to {name}; magpie runs it on one. Use for {name} on the other one's row switches it", { name: c.name })
: t("Two plugins sign in to {name}; magpie runs it on one. Use for {name} switches it to this one, or remove the one you don't want", { name: c.name });
return d;
}
// agentLine is the agent a plugin adds, as the Agents page lists it, or
// why it isn't there
function agentLine(a) {
const d = el("div", "sub pm-mw");
if (a.error) {
d.textContent = t("Agent didn't load: {error}", { error: a.error });
d.classList.add("bad");
d.title = a.error;
return d;
}
d.textContent = d.title = t("Adds {name} to Agents", { name: a.name });
return d;
}
// toolsLine is the tools a plugin gives, which magpie's plugin tools MCP
// server offers every agent: each by the name an agent sees, its
// description on hover, and the server's address to copy into an agent
function toolsLine(tools) {
const d = el("div", "sub pm-mw pm-tools");
d.append(el("span", "", t("Tools for every agent: {names}", { names: tools.map((x) => x.mcp || x.name).join(t(", ")) })));
d.title = tools.map((x) => (x.mcp || x.name) + (x.description ? " — " + x.description : "")).join("\n");
const url = mcpAddress(state.settings || {}, "/mcp/magpie/tools");
const b = copyBtn(url, t("MCP server address"));
b.title = t("Copy the MCP server's address ({url}): add it to an agent as an MCP server (Streamable HTTP)", { url });
d.append(b);
return d;
}
// what a plugin's page may read of magpie's: what its package.json's
// magpie.permissions declares, each a read with no secret in it
const READS = { "usage:summary": "your usage totals, by model", "providers:list": "your providers' names" };
const PAGES = { sessions: "Sessions", library: "Library", routing: "Routing", usage: "Usage" };
function pageLine(p) {
const d = el("div", "sub pm-mw pm-page");
const reads = (p.reads || []).map((r) => t(READS[r] || r));
const page = p.replaces && t(PAGES[p.replaces] || p.replaces);
d.textContent = d.title = page
? reads.length
? t("Takes the place of the {page} page, and can read {reads}", { page, reads: reads.join(t(", ")) })
: t("Takes the place of the {page} page, and reads nothing of magpie's", { page })
: reads.length
? t("Adds a page to the sidebar, which can read {reads}", { reads: reads.join(t(", ")) })
: t("Adds a page to the sidebar, which reads nothing of magpie's");
return d;
}
// where a plugin's panels go in magpie's own pages (magpie.panels), and
// the row menus its page adds items to (magpie.actions), titled with
// their titles; picking an item tells the page the row's name only
const SLOTS = { agents: "the Agents page", usage: "the Usage page", settings: "Settings", provider: "each provider's editor" };
const MENUS = { provider: "providers' menus", agent: "agents' menus" };
function whereLine(xs, key, names, text) {
const d = el("div", "sub pm-mw pm-page");
d.textContent = text([...new Set(xs.map((x) => x[key]))].map((s) => t(names[s] || s)).join(t(", ")));
d.title = xs.map((x) => x.title).filter(Boolean).join("\n") || d.textContent;
return d;
}
function panelsLine(panels, panelReads) {
const reads = (panelReads || []).map((r) => t(READS[r] || r)).join(t(", "));
return whereLine(panels, "slot", SLOTS, (where) => reads
? t("Adds panels to {where}, which can read {reads}", { where, reads })
: t("Adds panels to {where}, which read nothing of magpie's", { where }));
}
function actionsLine(actions) {
return whereLine(actions, "menu", MENUS, (where) => t("Adds items to {where}, which open its page", { where }));
}
function mwLine(m) {
const d = el("div", "sub pm-mw");
if (m.error) {
d.textContent = t("Middleware didn't load: {error}", { error: m.error });
d.classList.add("bad");
d.title = m.error;
return d;
}
const lang = intlLang();
// a gateway module's hooks, the routings it serves (strategies) and
// its usage observer (onUsage), each said when it has it
const parts = [];
if (m.hooks.length) {
let s = t("Gateway middleware: {hooks}", { hooks: m.hooks.join(t(", ")) });
if (m.calls) s += " · " + t("{n} calls, {us} µs each", { n: m.calls.toLocaleString(lang), us: m.avgMicros < 10 ? m.avgMicros.toFixed(1) : Math.round(m.avgMicros).toLocaleString(lang) });
parts.push(s);
}
if (m.strategies?.length) parts.push(t("Routings: {routings}", { routings: m.strategies.join(t(", ")) }) + (m.orders ? " · " + t("asked {n} times", { n: m.orders.toLocaleString(lang) }) : ""));
if (m.usage) parts.push(t("Usage observer: {n} rows", { n: (m.rows || 0).toLocaleString(lang) }));
d.append(el("span", "", parts.join(" · ")));
if (m.events?.length) d.title = t("onEvent sees only {events} events", { events: m.events.join(t(", ")) });
if (m.failures) {
const f = el("span", "pm-mw-fail", t("{n} failed", { n: m.failures.toLocaleString(lang) }));
f.title = t("A failed call leaves the request or reply as it was") + (m.lastError ? "\n" + t("Last: {error}", { error: m.lastError }) : "");
d.append(el("span", "sep", " · "), f);
}
if (m.dropped) {
const f = el("span", "pm-mw-fail", t("{n} rows dropped", { n: m.dropped.toLocaleString(lang) }));
f.title = t("Rows that came while onUsage was still busy are dropped: a request never waits for it");
d.append(el("span", "sep", " · "), f);
}
return d;
}
function gatewayLine(g) {
const d = el("div", "sub pm-mw pm-gateway");
const labels = {
idle: "Waiting for a request", ready: "Context injected", empty: "No matching context",
unbound: "Scope not bound", unauthorized: "Authorization failed",
unavailable: "Context service unavailable", invalid: "Invalid context response",
skipped: "Request skipped", cancelled: "Request cancelled", timeout: "Recall timed out", error: "Request hook failed",
};
let text = t("Gateway request hook") + ": " + t(labels[g.lastOutcome] || labels.idle);
if (g.calls) text += " · " + t("{n} calls, {ms} ms each", { n: g.calls.toLocaleString(intlLang()), ms: g.avgMillis.toFixed(1) });
if (g.lastBytes) text += " · " + t("{n} bytes injected", { n: g.lastBytes.toLocaleString(intlLang()) });
d.append(el("span", "", text));
if (g.failures) d.append(el("span", "sep", " · "), el("span", "pm-mw-fail", t("{n} failed", { n: g.failures.toLocaleString(intlLang()) })));
d.title = t("Diagnostics reset when the plugin host restarts; prompts and recalled text are not stored");
return d;
}
// a README on its way: its lines are strings, and magpie's bird drops in
// and bounces down them, each bending under its feet and wobbling after
// it; leave() sends it off when the README comes. Its marks are data-*,
// not classes, so the dialog's observer doesn't place it again each hop
function bounceLoader() {
const box = el("div", "pm-bounce"), s = document.createElementNS("http://www.w3.org/2000/svg", "svg"), b = el("div", "sk-bird");
s.innerHTML = "<path/><path/><path/><path/>";
b.innerHTML = BIRD;
// with Settings' Loading bird off, the strings stand still, birdless
const off = birdOff();
box.append(s);
if (!off) box.append(b);
const ps = [...s.children], ws = [1, .94, .6, .82], at = [.16, .44, .3, .58];
const L = ws.map((w, i) => ({ y: 31 + i * 22, d: 0, v: 0, bx: 0, hold: false }));
// the bird is placed by its feet: f faces it, r leans it, sx/sy squash it
let W = 0, x = 0, y = 0, f = 1, r = 0, sx = 1, sy = 1, gone = false;
const put = (o) => { ({ x = x, y = y, f = f, r = r, sx = sx, sy = sy } = o); b.style.transform = `translate(${x}px,${y}px) rotate(${r * f}deg) scale(${f * sx},${sy})`; };
const draw = () => L.forEach((l, i) => {
const h = l.y, d = l.d, x1 = W * ws[i] - 5, c = Math.min(x1 - 12, Math.max(17, l.bx));
ps[i].setAttribute("d", `M5 ${h}C${(5 + c) / 2} ${h} ${c - (c - 5) * .35} ${h + d} ${c} ${h + d}C${c + (x1 - c) * .35} ${h + d} ${(c + x1) / 2} ${h} ${x1} ${h}`);
});
// a step over frames; it stops when the box is gone, or the README came
const tween = (ms, fn, ease = (t) => t, exit) => new Promise((ok, no) => {
const t0 = performance.now();
const step = (now) => {
if (!box.isConnected || (gone && !exit)) return no();
const t = Math.min(1, (now - t0) / ms);
fn(ease(t), t);
t < 1 ? requestAnimationFrame(step) : ok();
};
requestAnimationFrame(step);
});
const easeIn = (t) => t * t * t, easeOut = (t) => 1 - (1 - t) ** 3;
// a README waits for three landings (the owner, 10-30), 3s at most
let ready;
box.ready = new Promise((ok) => { ready = ok; });
setTimeout(ready, 3000);
(async () => {
await new Promise(requestAnimationFrame);
if (!box.isConnected || gone) return;
W = box.clientWidth;
if (off) return draw();
if (calm()) return draw(), put({ x: at[0] * W, y: L[0].y - 5 });
// each string a damped spring, let go of when the bird leaves it
(async () => {
let last = performance.now();
for (;;) {
const now = await new Promise(requestAnimationFrame), dt = Math.min(.032, (now - last) / 1000);
if (!box.isConnected || gone) return;
last = now;
for (const l of L) if (!l.hold) { l.v += (-625 * l.d - 6 * l.v) * dt; l.d += l.v * dt; }
draw();
}
})();
for (;;) {
W = box.clientWidth;
ps.forEach((p) => delete p.dataset.lit);
const x0 = at[0] * W;
await tween(300, (e, t) => put({ x: x0 - 24 + 24 * t, y: -30 + (L[0].y + 25) * e, f: 1, r: 0, sx: 1 - .05 * t, sy: 1 + .08 * t }), easeIn);
for (let i = 0; i < L.length; i++) {
const l = L[i], top = l.y - 5, deep = i === L.length - 1 ? 16 : 10;
l.hold = true;
l.bx = x;
ps[i].dataset.lit = "";
await tween(140, (e) => { put({ y: top + deep * e, sx: 1 + .16 * e, sy: 1 - .2 * e }); l.d = y - top; }, easeOut);
await tween(90, (e) => { put({ y: top + deep * (1 - e), sx: 1.16 - .16 * e, sy: .8 + .3 * e }); l.d = y - top; }, easeIn);
l.hold = false;
l.v = -deep * 14;
if (i === 2) ready();
const xa = x, ya = y;
if (i + 1 < L.length) {
const xb = at[i + 1] * W, yb = L[i + 1].y - 5;
put({ f: xb > xa ? 1 : -1 });
await tween(340, (e, t) => put({ x: xa + (xb - xa) * t, y: ya + (yb - ya) * t - 72 * t * (1 - t), sx: 1 - .06 * Math.sin(Math.PI * t), sy: 1 + .12 * Math.sin(Math.PI * t), r: (t - .5) * 20 }));
} else {
// the last one throws it high, out of sight, and it drops in again
b.dataset.flap = "";
await tween(520, (e) => put({ x: xa + 70 * e, y: ya - (ya + 60) * e, f: 1, r: -12, sx: 1, sy: 1 }), easeOut);
delete b.dataset.flap;
await tween(260, () => {});
}
}
}
})().catch(() => {}).finally(ready);
box.leave = () => {
if (off) return box.remove();
gone = true;
box.dataset.gone = b.dataset.flap = "";
const xa = x, ya = y;
tween(420, (e) => put({ x: xa + (W + 60 - xa) * e, y: ya - (ya + 80) * e, f: 1, r: -14, sx: 1, sy: 1 }), easeIn, true)
// gone once the dialog has grown to the README, not while it does
.then(() => tween(200, () => {}, undefined, true)).then(() => box.remove(), () => {});
};
return box;
}
// a README read once shows at once when its page opens again, birdless,
// and is read again quietly (the owner, 10-30). The last 20 opened only,
// a Map in the order they were: the oldest goes first
const pages = new Map();
const keep = (k, p) => { pages.delete(k); pages.set(k, p); if (pages.size > 20) pages.delete(pages.keys().next().value); };
// the plugin's page: what it is, what npm says of it, and its README
async function detail(l) {
// a folder plugin: what it is comes from the folder, not from npm; a
// git one's from the folder it was installed to
const local = isPath(l.package) || isGit(l.package);
const ed = el("div", "editor pm-detail");
const hd = el("div", "ehead pm-dhead");
hd.append(logo(l.icon || l.npm?.icon, true, kindOf(l)));
const who = el("div", "pm-who");
const nm = el("div", "pm-name");
nm.append(el("b", "", l.name));
const by = el("div", "pm-by"); // the words in a span of their own, or a flex row cuts them without the ellipsis
by.append(el("span", "", l.community ? t("magpie community") + " · " + l.package : [l.npm?.publisher, l.package].filter(Boolean).join(" · ")));
who.append(nm, by);
const actBox = el("div", "pm-dact");
// redrawn only when what it would say changes: a button made afresh
// loses the pointer's hover
let said = "";
const redrawAct = () => {
const b = actionFor(l.package, l.name, l.npm ? l : null);
const now = b.className + b.textContent + b.disabled;
if (now !== said) { said = now; actBox.replaceChildren(b); }
};
redrawAct();
hd.append(who, el("span", "grow"), actBox);
ed.append(hd);
const main = el("div", "pm-dbody");
const sum = summary(l);
if (sum) main.append(el("p", "pm-dsum", sum));
const facts = el("div", "pm-facts");
const fact = (k, v) => { if (!v) return; const f = el("div", "pm-fact"); f.append(el("span", "k", k), typeof v === "string" ? el("span", "v", v) : v); facts.append(f); };
fact(t("Version"), l.npm?.version && "v" + l.npm.version);
fact(t("Downloads"), l.npm?.weekly ? t("{n}/week", { n: count(l.npm.weekly) }) : "");
if (l.github) fact(t("Stars"), count(l.github.stars));
fact(t("License"), l.npm?.license);
const upd = el("span", "v", "…");
fact(t("Updated"), upd);
if (l.providers?.length) fact(t("Signs in to"), l.providers.join(t(", ")));
main.append(facts);
const links = el("div", "pm-links");
const link = (label, href) => {
if (!href) return;
const a = el("a", "pm-link");
a.href = href;
a.append(el("span", "", label), glyph(OUTL, 11, 1.5));
a.onclick = (ev) => { ev.preventDefault(); api("open", { url: href }).catch(() => {}); };
links.append(a);
};
// npm is where a package's page is; a folder on this computer has none
if (!local) link("npm", "https://www.npmjs.com/package/" + l.package);
link(l.github ? "GitHub" : t("Source"), l.npm?.repository);
if (l.npm?.homepage && l.npm.homepage !== l.npm.repository && !l.npm.homepage.startsWith(l.npm.repository + "#")) link(t("Homepage"), l.npm.homepage);
main.append(links);
if (l.github) {
const w = el("p", "pm-note warn");
// from npm when its author published it there from the repository
const from = isGit(l.package)
? "Unofficial: {owner} tagged it {topic} on GitHub, and nobody at magpie has reviewed it. It is installed from the repository as it stands, and runs with your sign-in or your requests."
: "Unofficial: {owner} tagged it {topic} on GitHub, and nobody at magpie has reviewed it. It is installed from npm, as its author published it from the repository, and runs with your sign-in or your requests.";
w.append(glyph(SHIELD, 12, 1.5), el("span", "", t(from, { owner: l.github.owner, topic })));
main.append(w);
}
if (l.replaces) main.append(el("p", "pm-note", t("magpie's own sign-in to this subscription is deprecated: this plugin takes its place, and accounts signed in there move to it.")));
const readme = el("div", "pm-readme");
const had = pages.get(l.package);
const day = (p) => {
const at = l.github && !entryOf(l.package) ? l.github.pushed : p.updated;
upd.textContent = at && !at.startsWith("0001") ? new Date(at).toLocaleDateString(intlLang(), { year: "numeric", month: "short", day: "numeric" }) : "—";
};
if (had) day(had);
readme.append(had ? markdown(had.readme || t("No README")) : bounceLoader());
main.append(readme);
ed.append(main);
const bar = el("div", "bar");
bar.append(el("span", "note", t("Plugins are other people's code: they sign in and make the requests, or see them as middleware.")), el("span", "grow"));
const close = el("button", "text", t("Close"));
close.onclick = () => { stop(); closeModal(); };
bar.append(close);
ed.append(bar);
openModal(ed);
// the button follows an install or a sign-in made while it's open
const tick = setInterval(() => { if (!ed.isConnected) return stop(); redrawAct(); }, 600);
function stop() { clearInterval(tick); }
// the README takes the skeleton's place, and the dialog grows to it on
// the spring it opened on, centred as it goes, not in one jump; the
// bird flies off over it
const fill = async (n) => {
await readme.querySelector(".pm-bounce")?.ready;
if (!ed.isConnected) return;
const d = ed.parentElement, h = d.offsetHeight, y = d.style.top, wait = readme.querySelector(".pm-bounce");
const m = d.parentElement, at = wait?.getBoundingClientRect(), o = m.getBoundingClientRect();
readme.replaceChildren(n);
if (!ed.isConnected || calm()) return;
// it leaves from over the dialog, where it was: anywhere in it, WebKit
// lays the fields out 8px short while it is there
if (wait) {
Object.assign(wait.style, { top: at.top - o.top + m.scrollTop + "px", left: at.left - o.left + m.scrollLeft + "px", width: at.width + "px" });
m.append(wait);
wait.leave();
}
holdModal();
d.animate([{ height: h + "px", top: y, overflow: "hidden" }, { height: d.offsetHeight + "px", top: d.style.top, overflow: "hidden" }], { duration: 570, easing: SPRING });
n.animate([{ opacity: 0 }, { opacity: 1 }], { duration: 300, easing: "ease-out" });
};
try {
const p = await api("plugins/page?name=" + encodeURIComponent(l.package));
keep(l.package, p);
day(p);
if (!had) fill(markdown(p.readme || t("No README")));
else if (p.readme !== had.readme) readme.replaceChildren(markdown(p.readme || t("No README")));
} catch (e) {
if (had) return;
upd.textContent = "—";
fill(el("p", "pm-note", t(l.github && isGit(l.package) && !entryOf(l.package) ? "GitHub didn't answer: {error}" : local ? "Couldn't read the folder's README: {error}" : "npm didn't answer: {error}", { error: e.message })));
}
}
// markdown: a README as text, links and code — no HTML of its own, no
// pictures (a README's badges and screenshots come from anywhere)
function markdown(src) {
const root = el("div", "pm-md");
const lines = src.replace(/\r\n?/g, "\n").replace(/<!--[\s\S]*?-->|<(script|style)\b[\s\S]*?<\/\1\s*>/gi, "")
.replace(/\[\s*!\[[^\]]*\]\([^)]*\)\s*\]\([^)]*\)/g, "") // a badge: a picture in a link
.split("\n");
// a link: to the web, opened outside; to a heading of the README
// ("#-quick-start"), there, as the reader asked
const link = (href, text, into) => {
const a = el("a", "", "");
a.href = href;
inline(text.replace(/!\[[^\]]*\]\([^)]*\)/g, "").trim() || href, a);
a.onclick = (ev) => {
ev.preventDefault();
if (href[0] !== "#") return api("open", { url: href }).catch(() => {});
const to = root.querySelector(`[data-slug="${CSS.escape(decodeURIComponent(href.slice(1)).toLowerCase())}"]`);
if (to && window.scrollOnPurpose?.(ev)) to.scrollIntoView({ block: "start", behavior: "smooth" });
};
into.append(a);
};
const inline = (text, into) => {
const re = /(`[^`]+`)|\*\*(.+?)\*\*|__(.+?)__|\*([^*\s][^*]*)\*|!\[[^\]]*\]\([^)]*\)|\[([^\]]+)\]\(([^)\s]+)[^)]*\)|<(https?:\/\/[^>\s]+)>|<a\s[^>]*?href\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/a\s*>|<\/?[a-zA-Z][^>]*>/g;
let at = 0, m;
while ((m = re.exec(text))) {
if (m.index > at) into.append(text.slice(at, m.index));
if (m[1]) into.append(el("code", "", m[1].slice(1, -1)));
else if (m[2] || m[3]) { const b = el("strong"); inline(m[2] || m[3], b); into.append(b); }
else if (m[4]) { const e = el("em"); inline(m[4], e); into.append(e); }
else if (m[5] || m[8]) {
const href = m[6] || m[8], text = m[5] || m[9].replace(/<[^>]*>/g, "");
if (/^https?:\/\//.test(href) || /^#./.test(href)) link(href, text, into);
else inline(text, into);
} else if (m[7]) link(m[7], m[7], into);
at = re.lastIndex;
}
if (at < text.length) into.append(text.slice(at));
};
// GitHub's anchor for a heading: lower case, its punctuation and
// emoji gone, spaces as dashes ("💡 Philosophy" is "-philosophy")
const slug = (s) => s.trim().toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s/g, "-");
let i = 0, list = null, para = null;
const flush = () => { list = null; para = null; };
while (i < lines.length) {
const line = lines[i];
const fence = line.match(/^\s*(```|~~~)\s*([\w+-]*)/);
if (fence) {
flush();
const code = [];
i++;
while (i < lines.length && !lines[i].trimStart().startsWith(fence[1])) code.push(lines[i++]);
i++;
const pre = el("pre", "", "");
pre.append(el("code", "", code.join("\n")));
root.append(pre);
continue;
}
const h = line.match(/^(#{1,6})\s+(.*?)\s*#*\s*$/);
if (h) {
flush();
const e = el("h" + Math.min(6, h[1].length + 2));
inline(h[2], e);
e.dataset.slug = slug(e.textContent);
if (e.textContent.trim()) root.append(e);
i++;
continue;
}
if (/^\s*\|.*\|\s*$/.test(line) && /^\s*\|?\s*:?-{2,}/.test(lines[i + 1] || "")) {
flush();
const cells = (s) => s.trim().replace(/^\||\|$/g, "").split("|").map((c) => c.trim());
const wrap = el("div", "pm-table");
const table = el("table");
const tr = el("tr");
for (const c of cells(line)) { const th = el("th"); inline(c, th); tr.append(th); }
table.append(tr);
i += 2;
while (i < lines.length && /^\s*\|.*\|\s*$/.test(lines[i])) {
const r = el("tr");
for (const c of cells(lines[i])) { const td = el("td"); inline(c, td); r.append(td); }
table.append(r);
i++;
}
wrap.append(table);
root.append(wrap);
continue;
}
const li = line.match(/^\s*([-*+]|\d+[.)])\s+(.*)$/);
if (li) {
para = null;
const ordered = /\d/.test(li[1]);
if (!list || list.tagName !== (ordered ? "OL" : "UL")) { list = el(ordered ? "ol" : "ul"); root.append(list); }
const item = el("li");
inline(li[2].replace(/^\[( |x)\]\s*/i, (s, x) => x.trim() ? "✓ " : "☐ "), item);
list.append(item);
i++;
continue;
}
const q = line.match(/^\s*>\s?(.*)$/);
if (q) {
flush();
const bq = el("blockquote");
const parts = [];
while (i < lines.length && /^\s*>/.test(lines[i])) parts.push(lines[i++].replace(/^\s*>\s?/, ""));
inline(parts.join(" ").replace(/^\[!(\w+)\]\s*/, (s, k) => k.toUpperCase() + ": "), bq);
root.append(bq);
continue;
}
if (/^\s*([-*_])\s*\1\s*\1[\s\1]*$/.test(line)) { flush(); root.append(el("hr")); i++; continue; }
if (!line.trim()) { flush(); i++; continue; }
if (list && /^\s{2,}\S/.test(line)) { const last = list.lastElementChild; last.append(" "); inline(line.trim(), last); i++; continue; }
if (!para) { para = el("p"); root.append(para); list = null; } else para.append(" ");
inline(line.trim(), para);
if (!para.textContent.trim() && !para.children.length) { para.remove(); para = null; }
i++;
}
for (const p of root.querySelectorAll("p")) if (!p.textContent.trim()) p.remove();
return root;
}
// opened on the Plugins tab (?view=plugins): app.js showed it before
// this file was here to load it
if (view === "plugins") load();
})();