@zmzai/agent-framework 0.1.0

package/dist/cli.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/** zmzai-agent CLI (M5 §5): run the framework standalone with zero product
+ *  coupling — JSONL store, FS workspace, subprocess sandbox, OpenAI provider.
+ *
+ *   zmzai-agent serve [--port 3011] [--data-dir ./.fw-data] [--workspace ./ws]
+ *   zmzai-agent run "<prompt>" [--workspace ./ws] [--agent default] [--model gpt-4o]
+ */
+import { createServer, createJsonlSessionStore, createMemoryEventLog, subscribeEventLog } from "./index.js";
+import { createFsWorkspaceFiles } from "./adapters/fs-workspace.js";
+import { createOpenAiModelProvider } from "./adapters/openai-provider.js";
+import { createSubprocessSandbox } from "./adapters/subprocess-sandbox.js";
+function parseArgs(argv) {
+    const out = {};
+    for (let index = 0; index < argv.length; index++) {
+        const arg = argv[index];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[index + 1];
+            out[key] = next && !next.startsWith("--") ? next : "true";
+            if (next && !next.startsWith("--"))
+                index++;
+        }
+    }
+    return out;
+}
+function buildServer(args) {
+    const dataDir = args["data-dir"] ?? "./.fw-data";
+    const workspaceRoot = args["workspace"] ?? "./.fw-workspace";
+    const store = createJsonlSessionStore({ dataDir });
+    const eventLog = createMemoryEventLog();
+    const modelProvider = createOpenAiModelProvider();
+    const workspaceFor = () => createFsWorkspaceFiles({ root: workspaceRoot });
+    return createServer({
+        store,
+        eventLog,
+        modelProvider,
+        workspaceFor,
+        sandbox: createSubprocessSandbox(),
+        subagentDepth: 1,
+    });
+}
+async function runOnce(args) {
+    const prompt = args._prompt ?? args.prompt;
+    if (!prompt) {
+        console.error("用法: zmzai-agent run \"<prompt>\" [--workspace ./ws] [--agent default]");
+        process.exit(1);
+    }
+    const fw = buildServer(args);
+    const session = await fw.createSession({
+        userId: "cli",
+        workspaceId: "cli",
+        agent: args.agent ?? "default",
+        model: { providerId: "openai", modelId: args.model ?? process.env.OPENAI_MODEL ?? "gpt-4o" },
+    });
+    console.log(`[session] ${session.id}`);
+    const events = [];
+    const collectPromise = (async () => {
+        for await (const event of subscribeEventLog(fw.eventLog, session.id)) {
+            if (event.type === "message.part.delta") {
+                const delta = event.data.delta ?? "";
+                if (delta)
+                    process.stdout.write(delta);
+            }
+            if (event.type === "session.status") {
+                const status = event.data.status;
+                if (status === "idle")
+                    events.push("idle");
+            }
+            if (event.type === "session.error")
+                events.push("error");
+        }
+    })();
+    await fw.runner.prompt(session.id, { text: prompt, agent: args.agent });
+    // Wait for the run to settle: subscribeEventLog streams forever, so watch
+    // for the idle/error status events, then let the collector finish flushing.
+    while (!events.includes("idle") && !events.includes("error")) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    void collectPromise;
+    console.log(events.includes("error") ? "\n[run] 失败" : "\n[run] 完成");
+    process.exit(events.includes("error") ? 1 : 0);
+}
+async function serve(args) {
+    const port = Number.parseInt(args.port ?? "3011", 10);
+    const fw = buildServer(args);
+    const { createServer: createHttp } = await import("node:http");
+    const server = createHttp(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://localhost:${port}`);
+        const sessionIdMatch = /^\/sessions\/([^/]+)$/.exec(url.pathname);
+        const promptMatch = /^\/sessions\/([^/]+)\/prompt$/.exec(url.pathname);
+        const eventsMatch = /^\/sessions\/([^/]+)\/events$/.exec(url.pathname);
+        const cors = {
+            "access-control-allow-origin": "*",
+            "access-control-allow-methods": "GET, POST, OPTIONS",
+            "access-control-allow-headers": "content-type",
+        };
+        if (req.method === "OPTIONS") {
+            res.writeHead(204, cors);
+            res.end();
+            return;
+        }
+        const json = (status, body) => {
+            res.writeHead(status, { ...cors, "content-type": "application/json" });
+            res.end(JSON.stringify(body));
+        };
+        // POST /sessions { workspaceId, model, prompt? }
+        if (req.method === "POST" && url.pathname === "/sessions") {
+            const body = JSON.parse(await readBody(req));
+            const session = await fw.createSession({
+                userId: "cli",
+                workspaceId: body.workspaceId ?? "cli",
+                agent: body.agent,
+                model: { providerId: "openai", modelId: body.model ?? process.env.OPENAI_MODEL ?? "gpt-4o" },
+            });
+            if (body.prompt) {
+                await fw.runner.prompt(session.id, { text: body.prompt, agent: body.agent });
+            }
+            json(201, { session });
+            return;
+        }
+        // GET /sessions/:id
+        if (req.method === "GET" && sessionIdMatch) {
+            const session = await fw.store.getSession(sessionIdMatch[1]);
+            const messages = await fw.store.getMessages(sessionIdMatch[1]);
+            json(200, { session, messages });
+            return;
+        }
+        // POST /sessions/:id/prompt
+        if (req.method === "POST" && promptMatch) {
+            const body = JSON.parse(await readBody(req));
+            const result = await fw.runner.prompt(promptMatch[1], { text: body.text, agent: body.agent });
+            json(202, result);
+            return;
+        }
+        // GET /sessions/:id/events (SSE)
+        if (req.method === "GET" && eventsMatch) {
+            res.writeHead(200, {
+                ...cors,
+                "content-type": "text/event-stream",
+                "cache-control": "no-store",
+                connection: "keep-alive",
+            });
+            const sessionId = eventsMatch[1];
+            const controller = new AbortController();
+            const signal = controller.signal;
+            req.on("close", () => controller.abort());
+            (async () => {
+                for await (const event of subscribeEventLog(fw.eventLog, sessionId, { signal })) {
+                    res.write(`event: ${event.type}\ndata: ${JSON.stringify(event.data)}\n\n`);
+                }
+                res.end();
+            })();
+            return;
+        }
+        json(404, { error: "not found" });
+    });
+    server.listen(port, () => {
+        console.log(`zmzai-agent serve: http://localhost:${port}`);
+        console.log(`  数据目录: ${args["data-dir"] ?? "./.fw-data"}  workspace: ${args["workspace"] ?? "./.fw-workspace"}`);
+    });
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        req.on("data", (chunk) => {
+            data += chunk;
+        });
+        req.on("end", () => resolve(data));
+        req.on("error", reject);
+    });
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    const args = parseArgs(rest);
+    const positional = rest.find((arg) => !arg.startsWith("--"));
+    if (positional)
+        args["_prompt"] = positional;
+    if (command === "serve") {
+        await serve(args);
+    }
+    else if (command === "run") {
+        await runOnce(args);
+    }
+    else {
+        console.error("用法: zmzai-agent <serve|run> [options]");
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/loader.d.ts

@@ -0,0 +1,17 @@
+import type { WorkspaceFiles } from "../tools/context.js";
+import type { AgentInfo } from "../agent/registry.js";
+/** Custom agent loader (spec §6.3): workspace agents live at `.zmzai/agents/*.md`
+ *  with YAML-ish frontmatter and the body as the system prompt. Frontmatter is
+ *  parsed with a small zero-dependency reader (no js-yaml in the dep tree) —
+ *  it supports the flat keys we need plus a nested `permission:` map. */
+export type LoadedAgent = {
+    fileName: string;
+    agent: AgentInfo;
+};
+/** Loads `.zmzai/agents/*.md` from the workspace. Unreadable files are skipped
+ *  silently; malformed files raise a descriptive error (surfaced to the user). */
+export declare function loadCustomAgents(workspace: WorkspaceFiles): Promise<{
+    agents: AgentInfo[];
+    errors: string[];
+}>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/agent/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/agent/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;yEAGyE;AAEzE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAuIjE;kFACkF;AAClF,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmBpH"}

package/dist/core/agent/loader.js

@@ -0,0 +1,148 @@
+import { rulesetFromConfig } from "../permission/ruleset.js";
+const FRONTMATTER_RE = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/;
+/** Minimal frontmatter parser: `key: value` scalars + one level of
+ *  `permission:\n  key: value` nesting. Values are strings, numbers, or
+ *  booleans. Quoted strings are unwrapped. Not a general YAML parser. */
+function parseFrontmatter(text) {
+    const match = FRONTMATTER_RE.exec(text);
+    if (!match)
+        return null;
+    const raw = match[1];
+    const body = text.slice(match[0].length);
+    const data = {};
+    const lines = raw.split(/\r?\n/);
+    let inPermission = false;
+    for (const line of lines) {
+        if (!line.trim() || line.trimStart().startsWith("#"))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0) {
+            inPermission = false;
+            const idx = line.indexOf(":");
+            if (idx === -1)
+                continue;
+            const key = line.slice(0, idx).trim();
+            const value = line.slice(idx + 1).trim();
+            if (key === "permission") {
+                if (value === "") {
+                    inPermission = true;
+                    data.permission = {};
+                }
+                else {
+                    // inline single action: `permission: ask`
+                    data.permission = { "*": unquote(value) };
+                }
+                continue;
+            }
+            assign(data, key, value);
+        }
+        else if (inPermission) {
+            const idx = line.indexOf(":");
+            if (idx === -1)
+                continue;
+            const key = line.slice(0, idx).trim();
+            const value = line.slice(idx + 1).trim();
+            (data.permission ??= {})[key] = unquote(value);
+        }
+    }
+    return { data, body };
+}
+function unquote(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function assign(data, key, value) {
+    const v = unquote(value);
+    switch (key) {
+        case "name":
+            data.name = v;
+            break;
+        case "description":
+            data.description = v;
+            break;
+        case "mode":
+            data.mode = v;
+            break;
+        case "model":
+            data.model = v;
+            break;
+        case "temperature":
+            data.temperature = Number(v);
+            break;
+        case "top_p":
+            data.top_p = Number(v);
+            break;
+        case "steps":
+            data.steps = Number.parseInt(v, 10);
+            break;
+        case "hidden":
+            data.hidden = v === "true" || v === "yes";
+            break;
+    }
+}
+const VALID_MODES = new Set(["primary", "subagent", "all"]);
+function toAgentInfo(fileName, parsed) {
+    const { data, body } = parsed;
+    const name = data.name ?? fileName.replace(/\.md$/i, "");
+    if (!data.description)
+        return { error: `agent ${fileName} 缺少必填的 description` };
+    const mode = data.mode && VALID_MODES.has(data.mode) ? data.mode : "primary";
+    if (data.mode && !VALID_MODES.has(data.mode))
+        return { error: `agent ${fileName} 的 mode 必须是 primary|subagent|all` };
+    let permission = [];
+    if (data.permission) {
+        const config = {};
+        for (const [key, value] of Object.entries(data.permission)) {
+            config[key] = value;
+        }
+        permission = rulesetFromConfig(config);
+    }
+    const model = data.model ? parseModel(data.model) : undefined;
+    const agent = {
+        name,
+        description: data.description,
+        mode,
+        ...(data.hidden ? { hidden: true } : {}),
+        ...(model ? { model } : {}),
+        ...(typeof data.temperature === "number" && !Number.isNaN(data.temperature) ? { temperature: data.temperature } : {}),
+        ...(typeof data.top_p === "number" && !Number.isNaN(data.top_p) ? { topP: data.top_p } : {}),
+        ...(typeof data.steps === "number" && !Number.isNaN(data.steps) ? { steps: data.steps } : {}),
+        prompt: body.trim(),
+        permission,
+    };
+    return { fileName, agent };
+}
+function parseModel(value) {
+    const idx = value.indexOf("/");
+    if (idx === -1)
+        return { providerId: "relay", modelId: value };
+    return { providerId: value.slice(0, idx), modelId: value.slice(idx + 1) };
+}
+/** Loads `.zmzai/agents/*.md` from the workspace. Unreadable files are skipped
+ *  silently; malformed files raise a descriptive error (surfaced to the user). */
+export async function loadCustomAgents(workspace) {
+    const all = await workspace.list().catch(() => []);
+    const agentFiles = all.filter((file) => /^\.zmzai\/agents\/[^/]+\.md$/i.test(file.path));
+    const agents = [];
+    const errors = [];
+    for (const file of agentFiles) {
+        const fileName = file.path.split("/").pop();
+        const content = await workspace.read(file.path).catch(() => null);
+        if (!content)
+            continue;
+        const parsed = parseFrontmatter(content.content);
+        if (!parsed) {
+            errors.push(`${fileName} 缺少 frontmatter（--- 包裹的头部）`);
+            continue;
+        }
+        const result = toAgentInfo(fileName, parsed);
+        if ("error" in result)
+            errors.push(result.error);
+        else
+            agents.push(result.agent);
+    }
+    return { agents, errors };
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/agent/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/agent/loader.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/plugin.d.ts

@@ -0,0 +1,59 @@
+/** Agent Plugins 1.0 package reader. It intentionally implements only the
+ *  portable package format: installation, trust, secrets, approval UX, and
+ *  process execution remain the responsibility of the hosting product. */
+export type PluginManifest = {
+    $schema?: string;
+    name: string;
+    version?: string;
+    description?: string;
+    author?: string;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+    extensions?: Record<string, unknown>;
+};
+export type PluginSkill = {
+    id: string;
+    path: string;
+    markdown: string;
+};
+export type PluginMcpServer = {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+} | {
+    type: "streamable-http";
+    url: string;
+    headers?: Record<string, string>;
+} | {
+    type: "sse";
+    url: string;
+    headers?: Record<string, string>;
+};
+export type ParsedAgentPlugin = {
+    root: string;
+    manifest: PluginManifest;
+    skills: PluginSkill[];
+    mcpServers: Record<string, PluginMcpServer>;
+    errors: string[];
+};
+export type PluginFileSystem = {
+    read(path: string): Promise<string | null>;
+    list(path: string): Promise<{
+        path: string;
+        isDirectory: boolean;
+    }[]>;
+};
+export declare function parsePluginManifest(value: unknown): PluginManifest | null;
+export declare function parsePluginMcp(root: string, value: unknown): {
+    servers: Record<string, PluginMcpServer>;
+    errors: string[];
+};
+export declare function parseAgentPlugin(input: {
+    root: string;
+    files: PluginFileSystem;
+}): Promise<ParsedAgentPlugin>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/agent/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/core/agent/plugin.ts"],"names":[],"mappings":"AAEA;;0EAE0E;AAE1E,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAC;CACvE,CAAC;AA0CF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAWzE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC3H;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkBnH"}

package/dist/core/agent/plugin.js

@@ -0,0 +1,125 @@
+import { basename, dirname, isAbsolute, normalize, relative, resolve } from "node:path";
+const NAME_RE = /^(?!.*--)(?!.*\.\.)[a-z0-9](?:[a-z0-9.-]{0,62}[a-z0-9])?$/;
+function json(value) {
+    if (!value)
+        return null;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function object(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringMap(value) {
+    const candidate = object(value);
+    if (!candidate || Object.values(candidate).some((item) => typeof item !== "string"))
+        return undefined;
+    return candidate;
+}
+function pathInside(root, candidate) {
+    const target = resolve(root, candidate);
+    return relative(resolve(root), target) === "" || !relative(resolve(root), target).startsWith("..");
+}
+function validateRelativePath(root, value) {
+    if (!value || !value.startsWith("./") || isAbsolute(value) || !pathInside(root, value))
+        return undefined;
+    return value;
+}
+/** Agent Plugins 1.0 reserves these values for the hosting client. Parsing
+ * validates their placement but deliberately does not expand them: expansion
+ * happens only when a trusted host launches an authorized stdio connector. */
+function validatePluginPath(root, value) {
+    if (!value)
+        return undefined;
+    if (value === "${PLUGIN_ROOT}" || value.startsWith("${PLUGIN_ROOT}/") || value === "${PLUGIN_DATA}" || value.startsWith("${PLUGIN_DATA}/"))
+        return value;
+    return validateRelativePath(root, value);
+}
+export function parsePluginManifest(value) {
+    const raw = object(value);
+    if (!raw || typeof raw.name !== "string" || !NAME_RE.test(raw.name))
+        return null;
+    const allowed = new Set(["$schema", "name", "version", "description", "author", "homepage", "repository", "license", "keywords", "extensions"]);
+    if (Object.keys(raw).some((key) => !allowed.has(key)))
+        return null;
+    if (raw.keywords !== undefined && (!Array.isArray(raw.keywords) || raw.keywords.some((word) => typeof word !== "string")))
+        return null;
+    if (raw.extensions !== undefined && !object(raw.extensions))
+        return null;
+    for (const key of ["$schema", "version", "description", "author", "homepage", "repository", "license"]) {
+        if (raw[key] !== undefined && typeof raw[key] !== "string")
+            return null;
+    }
+    return raw;
+}
+export function parsePluginMcp(root, value) {
+    const raw = object(value);
+    const entries = object(raw?.mcpServers);
+    const servers = {};
+    const errors = [];
+    if (!entries)
+        return { servers, errors };
+    for (const [name, candidate] of Object.entries(entries)) {
+        const server = object(candidate);
+        if (!server || typeof server.type !== "string") {
+            errors.push(`MCP ${name} 缺少 type`);
+            continue;
+        }
+        if (server.type === "stdio") {
+            const command = typeof server.command === "string" ? server.command : "";
+            const commandValid = /^[^\s]+$/.test(command) && (!command.startsWith(".") || Boolean(validateRelativePath(root, command)));
+            const args = Array.isArray(server.args) && server.args.every((arg) => typeof arg === "string") ? server.args : undefined;
+            const cwd = server.cwd === undefined ? undefined : validatePluginPath(root, typeof server.cwd === "string" ? server.cwd : undefined);
+            const env = stringMap(server.env);
+            if (!commandValid || (server.args !== undefined && !args) || (server.cwd !== undefined && !cwd) || (server.env !== undefined && !env) || env?.PLUGIN_ROOT !== undefined || env?.PLUGIN_DATA !== undefined) {
+                errors.push(`MCP ${name} 的 stdio 配置无效`);
+                continue;
+            }
+            servers[name] = { type: "stdio", command, ...(args ? { args } : {}), ...(env ? { env } : {}), ...(cwd ? { cwd } : {}) };
+            continue;
+        }
+        if (server.type === "streamable-http" || server.type === "sse") {
+            const url = typeof server.url === "string" ? server.url : "";
+            let parsed = null;
+            try {
+                parsed = new URL(url);
+            }
+            catch { /* validation below */ }
+            const remoteValid = parsed && (parsed.protocol === "https:" || ["localhost", "127.0.0.1", "::1"].includes(parsed.hostname));
+            const headers = stringMap(server.headers);
+            if (!remoteValid || (server.headers !== undefined && !headers)) {
+                errors.push(`MCP ${name} 的 ${server.type} 配置无效`);
+                continue;
+            }
+            servers[name] = { type: server.type, url, ...(headers ? { headers } : {}) };
+            continue;
+        }
+        errors.push(`MCP ${name} 使用了不支持的 transport: ${server.type}`);
+    }
+    return { servers, errors };
+}
+export async function parseAgentPlugin(input) {
+    const root = normalize(input.root);
+    const manifest = parsePluginManifest(json(await input.files.read(`${root}/plugin.json`)));
+    if (!manifest)
+        throw new Error("plugin.json 不合法或不符合 Agent Plugins 1.0 manifest 约束");
+    const errors = [];
+    const skills = [];
+    for (const entry of await input.files.list(`${root}/skills`).catch(() => [])) {
+        if (!entry.isDirectory || dirname(entry.path) !== `${root}/skills`)
+            continue;
+        const skillPath = `${entry.path}/SKILL.md`;
+        const markdown = await input.files.read(skillPath).catch(() => null);
+        if (!markdown) {
+            errors.push(`Skill ${basename(entry.path)} 缺少 SKILL.md`);
+            continue;
+        }
+        skills.push({ id: `${manifest.name}/${basename(entry.path)}`, path: skillPath, markdown });
+    }
+    const mcp = parsePluginMcp(root, json(await input.files.read(`${root}/mcp.json`)));
+    return { root, manifest, skills, mcpServers: mcp.servers, errors: [...errors, ...mcp.errors] };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/core/agent/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/core/agent/plugin.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/registry.d.ts

@@ -0,0 +1,45 @@
+import { type PermissionConfig, type Ruleset } from "../permission/ruleset.js";
+import type { ModelRef } from "../session/types.js";
+/** Agent registry (spec §6). Agents are named bundles of (prompt, permission
+ *  ruleset, model override, step budget). Primary agents answer user prompts;
+ *  subagents are spawned by the task tool. There is no mode toggle — the
+ *  presets below replace plan/build (spec §6.2). */
+export type AgentInfo = {
+    name: string;
+    description?: string;
+    mode: "primary" | "subagent" | "all";
+    hidden?: boolean;
+    model?: ModelRef;
+    temperature?: number;
+    topP?: number;
+    prompt?: string;
+    steps?: number;
+    permission: Ruleset;
+};
+export type AgentDefinition = Omit<AgentInfo, "permission"> & {
+    permission: PermissionConfig;
+};
+export declare const builtinAgents: AgentInfo[];
+/** Built-in baseline applied beneath every agent's own ruleset (spec §5.5). */
+export declare const builtinDefaults: Ruleset;
+export declare class AgentRegistry {
+    private readonly agents;
+    constructor(customAgents?: AgentInfo[]);
+    get(name: string): AgentInfo | null;
+    list(filter?: {
+        mode?: "primary" | "subagent";
+        includeHidden?: boolean;
+    }): AgentInfo[];
+    /** Effective ruleset stack for a session running this agent, in ascending
+     *  precedence: builtin defaults → agent preset. Session rules are appended
+     *  later by the permission engine. */
+    rulesetsFor(name: string): Ruleset[];
+    /** Returns a NEW registry with additional agents layered on top (workspace
+     *  custom agents). The base registry is shared/process-wide, so per-run
+     *  customization must not mutate it — this derive keeps the singleton
+     *  immutable while letting a session see its workspace's .zmzai/agents. */
+    derive(extraAgents: AgentInfo[]): AgentRegistry;
+    /** Custom agents registered beyond the builtins (for derive()). */
+    get customAgents(): AgentInfo[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/agent/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/agent/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;oDAGoD;AAEpD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAmB/F,eAAO,MAAM,aAAa,EAAE,SAAS,EAiCpC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,YAAY,GAAE,SAAS,EAAO;IAK1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAInC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,EAAE;IAQtF;;0CAEsC;IACtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAKpC;;;+EAG2E;IAC3E,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,aAAa;IAM/C,mEAAmE;IACnE,IAAI,YAAY,IAAI,SAAS,EAAE,CAE9B;CACF"}