@zmzai/agent-framework 0.1.0

package/dist/core/tools/builtins.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+import { qaCheckTool } from "./qa-check.js";
+import { wildcardMatch } from "../permission/ruleset.js";
+/** Built-in tools (spec §7.2). These operate on the WorkspaceFiles facade, so
+ *  the same definitions serve the Mongo cloud backend and a future local FS
+ *  backend. */
+export const readTool = {
+    id: "read",
+    label: "读取文件",
+    description: "读取当前 Workspace 中一个文本文件的内容。路径必须来自 glob 结果或已知 Workspace 路径。",
+    parameters: z.object({ path: z.string().min(1).max(512) }),
+    permission: (args) => ({ permission: "read", patterns: [args.path] }),
+    async execute(args, ctx) {
+        const file = await ctx.workspace.read(args.path);
+        if (!file)
+            throw new Error(`文件不存在或不可读取：${args.path}`);
+        return { title: `读取 ${args.path}`, output: file.content || "（空文件）", metadata: { path: args.path, bytes: Buffer.byteLength(file.content, "utf8") } };
+    },
+};
+export const globTool = {
+    id: "glob",
+    label: "按模式列文件",
+    description: "按 glob 模式列出 Workspace 文件路径（* 匹配任意字符序列，? 匹配单字符）。不传 pattern 则列出全部。",
+    parameters: z.object({ pattern: z.string().max(256).optional() }),
+    permission: () => ({ permission: "glob", patterns: ["*"] }),
+    async execute(args, ctx) {
+        const files = await ctx.workspace.list();
+        const matched = args.pattern ? files.filter((file) => wildcardMatch(args.pattern, file.path)) : files;
+        const limited = matched.slice(0, 200);
+        return {
+            title: `列出 ${limited.length} 个文件`,
+            output: limited.length ? limited.map((file) => `${file.path}（${file.bytes} B）`).join("\n") : "没有匹配的文件。",
+            metadata: { count: limited.length, total: matched.length },
+        };
+    },
+};
+export const grepTool = {
+    id: "grep",
+    label: "搜索文件内容",
+    description: "在 Workspace 文本文件内容中搜索关键词，最多返回 50 条匹配（path:line: 内容）。",
+    parameters: z.object({
+        query: z.string().min(1).max(256),
+        pathPattern: z.string().max(256).optional(),
+    }),
+    permission: (args) => ({ permission: "grep", patterns: [args.query] }),
+    async execute(args, ctx) {
+        const files = await ctx.workspace.list();
+        const candidates = args.pathPattern ? files.filter((file) => wildcardMatch(args.pathPattern, file.path)) : files;
+        const matches = [];
+        for (const candidate of candidates) {
+            if (matches.length >= 50)
+                break;
+            const file = await ctx.workspace.read(candidate.path);
+            if (!file)
+                continue;
+            const lines = file.content.split("\n");
+            for (let index = 0; index < lines.length && matches.length < 50; index++) {
+                if (lines[index].includes(args.query)) {
+                    matches.push({ path: candidate.path, line: index + 1, text: lines[index].slice(0, 200) });
+                }
+            }
+        }
+        return {
+            title: `搜索 "${args.query}"：${matches.length} 条命中`,
+            output: matches.length ? matches.map((match) => `${match.path}:${match.line}: ${match.text}`).join("\n") : "没有命中。",
+            metadata: { count: matches.length, truncated: matches.length >= 50 },
+        };
+    },
+};
+export const writeTool = {
+    id: "write",
+    label: "写入文件",
+    description: "创建或完整覆盖 Workspace 中的一个文本文件。写入立即生效并生成不可变版本（可通过 file.edited 事件审查差异）。",
+    parameters: z.object({
+        path: z.string().min(1).max(512),
+        content: z.string().max(512 * 1024),
+        summary: z.string().max(200).optional(),
+    }),
+    permission: (args) => ({ permission: "edit", patterns: [args.path], metadata: { path: args.path, bytes: Buffer.byteLength(args.content, "utf8") } }),
+    executionMode: "sequential",
+    async execute(args, ctx) {
+        const result = await ctx.workspace.write({ path: args.path, content: args.content, author: "agent", summary: args.summary ?? `Agent 写入 ${args.path}` });
+        if (!result)
+            throw new Error(`路径不合法或写入被拒绝：${args.path}`);
+        await ctx.emitFileEdited({ path: args.path, revisionId: result.revisionId, diff: result.diff });
+        return { title: `写入 ${args.path}`, output: `已写入 ${args.path}（版本 ${result.revisionId}）。`, metadata: { path: args.path, revisionId: result.revisionId } };
+    },
+};
+export const editTool = {
+    id: "edit",
+    label: "编辑文件",
+    description: "对 Workspace 文件做精确文本替换：oldText 必须在文件中唯一出现。编辑立即生效并生成不可变版本。",
+    parameters: z.object({
+        path: z.string().min(1).max(512),
+        oldText: z.string().min(1).max(64 * 1024),
+        newText: z.string().max(64 * 1024),
+        summary: z.string().max(200).optional(),
+    }),
+    permission: (args) => ({ permission: "edit", patterns: [args.path], metadata: { path: args.path } }),
+    executionMode: "sequential",
+    async execute(args, ctx) {
+        const result = await ctx.workspace.edit({ path: args.path, oldText: args.oldText, newText: args.newText, author: "agent", summary: args.summary ?? `Agent 编辑 ${args.path}` });
+        if ("error" in result)
+            throw new Error(`编辑失败：${result.error}`);
+        await ctx.emitFileEdited({ path: args.path, revisionId: result.revisionId, diff: result.diff });
+        return { title: `编辑 ${args.path}`, output: `已编辑 ${args.path}（版本 ${result.revisionId}）。`, metadata: { path: args.path, revisionId: result.revisionId } };
+    },
+};
+export const todoTool = {
+    id: "todo",
+    label: "更新任务清单",
+    description: "维护当前任务的工作清单：开始前拆解步骤（in_progress 标记进行中），每完成一步立即更新状态。让用户随时看到进度。",
+    parameters: z.object({
+        todos: z.array(z.object({
+            content: z.string().min(1).max(200),
+            status: z.enum(["pending", "in_progress", "completed", "cancelled"]),
+            priority: z.enum(["high", "medium", "low"]).optional(),
+        })).max(50),
+    }),
+    permission: () => null, // always safe: pure projection, no side effects beyond the todo event
+    async execute(args, ctx) {
+        await ctx.setTodos(args.todos);
+        const done = args.todos.filter((todo) => todo.status === "completed").length;
+        return { title: `更新清单（${done}/${args.todos.length} 完成）`, output: `清单已更新：${done}/${args.todos.length} 项完成。`, metadata: { total: args.todos.length, completed: done } };
+    },
+};
+// python/py：模型常调用 python 而非 python3（多数镜像里是同一解释器符号链接）。
+const defaultAllowedPrograms = ["node", "npm", "npx", "python3", "python", "py", "bash", "sh", "git", "ls", "cat", "grep", "find", "mkdir", "cp", "mv", "rm", "echo", "printf", "unzip", "tar", "curl", "wget", "env"];
+function allowedPrograms() {
+    const configured = process.env.EXEC_ALLOWED_PROGRAMS?.trim();
+    if (!configured)
+        return new Set(defaultAllowedPrograms);
+    return new Set(configured.split(",").map((item) => item.trim()).filter(Boolean));
+}
+/** 模型有时把完整命令直接塞进 program 参数（deepseek 行为，实测出现
+ *  "python3 --version"、"pip list 2>/dev/null | grep -i pptx" 等）：
+ *  - 普通命令：拆出程序名与内联参数（引号感知，保留引号内空格）；
+ *  - 管道/重定向/复合命令：交给 sh -c 整串执行，保留 shell 语义。
+ *  避免白名单整串匹配误拒、以及把带空格字符串当程序名执行导致 exit 127。
+ *  permission 与 execute 共用同一归一化。 */
+function splitProgram(program) {
+    const trimmed = program.trim();
+    if (/[|><;&]/.test(trimmed))
+        return { program: "sh", args: ["-c", trimmed] };
+    const tokens = [];
+    const pattern = /"([^"]*)"|'([^']*)'|(\S+)/g;
+    let match;
+    while ((match = pattern.exec(trimmed)) !== null) {
+        tokens.push(match[1] ?? match[2] ?? match[3]);
+    }
+    return { program: tokens[0] ?? "", args: tokens.slice(1) };
+}
+export const bashTool = {
+    id: "bash",
+    label: "在沙箱中执行命令",
+    description: "在当前 Workspace 的快照中执行一条命令（隔离沙箱）。程序必须在允许列表内；stdout/stderr 会返回。新生成的产物文件会自动出现在用户的产物面板（可预览/下载）——回复中不要自己编造下载链接（如 sandbox: 伪协议或沙箱路径），引用产物时使用工具结果里给出的真实 URL。",
+    parameters: z.object({
+        program: z.string().min(1).max(64),
+        args: z.array(z.string().max(512)).max(32).optional(),
+        cwd: z.string().min(1).max(512).optional(),
+        env: z.record(z.string(), z.string().max(2048)).optional(),
+    }),
+    permission: (args) => {
+        const { program, args: inlineArgs } = splitProgram(args.program);
+        const allArgs = [...inlineArgs, ...(args.args ?? [])];
+        const command = [program, ...allArgs].join(" ");
+        return { permission: "bash", patterns: [command], always: [command, `${program} *`], metadata: { command } };
+    },
+    executionMode: "sequential",
+    async execute(args, ctx) {
+        const { program, args: inlineArgs } = splitProgram(args.program);
+        const allArgs = [...inlineArgs, ...(args.args ?? [])];
+        if (!allowedPrograms().has(program))
+            throw new Error(`程序 "${program}" 不在允许列表`);
+        const snapshot = await ctx.buildSnapshot();
+        const result = await ctx.runSandbox({
+            toolCallId: ctx.toolCallId ?? `fwcall_${Date.now()}`,
+            command: { program, args: allArgs, ...(args.cwd ? { cwd: args.cwd } : {}), ...(args.env ? { env: args.env } : {}) },
+            snapshot,
+        });
+        for (const artifact of result.artifacts) {
+            if (artifact.workspaceContent !== undefined) {
+                const written = await ctx.workspace.write({
+                    path: artifact.path,
+                    content: artifact.workspaceContent,
+                    author: "agent",
+                    summary: `同步沙箱产物 ${artifact.path}`,
+                });
+                if (written)
+                    await ctx.emitFileEdited({ path: artifact.path, revisionId: written.revisionId, diff: written.diff });
+            }
+            await ctx.emitArtifact({
+                artifactId: `art_${Date.now()}_${artifact.path.replace(/[^a-zA-Z0-9]/g, "_")}`,
+                path: artifact.path,
+                bytes: artifact.bytes,
+                contentType: artifact.contentType,
+                downloadUrl: artifact.downloadUrl,
+                ...(artifact.previewUrl ? { previewUrl: artifact.previewUrl } : {}),
+            });
+        }
+        const artifactLine = result.artifacts.length
+            ? `\n已交付产物（已自动出现在用户的产物面板，用户可直接预览/下载；回复中不要编造下载链接，如需引用请使用下列真实 URL，不要使用 sandbox:/ 等伪协议）：${result.artifacts
+                .map((item) => `${item.path}（${item.bytes} B，下载 ${item.downloadUrl}${item.previewUrl ? `，预览 ${item.previewUrl}` : ""}）`)
+                .join("、")}`
+            : "";
+        // 沙箱请求失败（连接/认证/配置）时透出真实原因，而不是只有"退出码 1 无输出"。
+        const errorLine = result.errorMessage ? `\n沙箱错误：${result.errorMessage}` : "";
+        const output = [`$ ${[program, ...allArgs].join(" ")}`, `退出码 ${result.exitCode ?? "未知"} · ${result.durationMs}ms`, result.outputText || "（无输出）"].join("\n") + artifactLine + errorLine;
+        const outcome = result.outcome ?? (result.ok ? "succeeded" : "failed");
+        return {
+            title: `${program} ${outcome === "unknown" ? "待确认" : result.ok ? "完成" : "失败"}`,
+            output,
+            metadata: { outcome, exitCode: result.exitCode, durationMs: result.durationMs, artifacts: result.artifacts.map((item) => ({ path: item.path, bytes: item.bytes, downloadUrl: item.downloadUrl, ...(item.previewUrl ? { previewUrl: item.previewUrl } : {}) })) },
+        };
+    },
+};
+import { taskTool } from "../tools/task.js";
+export const builtinTools = [readTool, globTool, grepTool, writeTool, editTool, todoTool, bashTool, qaCheckTool, taskTool];
+//# sourceMappingURL=builtins.js.map

package/dist/core/tools/builtins.js.map

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

package/dist/core/tools/context.d.ts

@@ -0,0 +1,136 @@
+import type { PermissionEngine } from "../permission/engine.js";
+/** Snapshot of a workspace handed to the sandbox: committed files + revision.
+ *  Kept framework-local (was lib/sandbox-types) so the package owns its types. */
+export type SandboxSnapshot = {
+    revisionId: string | null;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+};
+/** Workspace facade: the single seam between framework tools and the file
+ *  backend. Products implement this (Mongo) or use the package's FS/JSONL
+ *  reference implementation. */
+export interface WorkspaceFiles {
+    list(): Promise<{
+        path: string;
+        bytes: number;
+    }[]>;
+    read(path: string): Promise<{
+        path: string;
+        content: string;
+    } | null>;
+    /** Direct write with revision + diff. Returns null when the path is
+     *  rejected by workspace path validation. */
+    write(input: {
+        path: string;
+        content: string;
+        author: "agent";
+        summary: string;
+    }): Promise<{
+        revisionId: string;
+        diff: string;
+    } | null>;
+    /** Direct edit (exact oldText → newText, unique occurrence). */
+    edit(input: {
+        path: string;
+        oldText: string;
+        newText: string;
+        author: "agent";
+        summary: string;
+    }): Promise<{
+        revisionId: string;
+        diff: string;
+    } | {
+        error: string;
+    }>;
+}
+export type SandboxExecResult = {
+    ok: boolean;
+    /** Unknown means the sandbox may have applied a side effect, but its
+     * terminal outcome could not be established. Callers must not retry it. */
+    outcome?: "succeeded" | "failed" | "unknown";
+    exitCode: number | null;
+    outputText: string;
+    durationMs: number;
+    artifacts: {
+        path: string;
+        bytes: number;
+        contentType: string;
+        downloadUrl: string;
+        previewUrl?: string;
+        /** Text deliverables are copied into the task workspace after the
+         * sandbox succeeds, so later tools such as qa-check see the same files. */
+        workspaceContent?: string;
+    }[];
+    /** 沙箱请求失败（连接/认证/配置）时的真实原因；命令失败时为 null。 */
+    errorMessage?: string | null;
+};
+export type SandboxExecInput = {
+    toolCallId: string;
+    command: {
+        program: string;
+        args: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+    };
+    snapshot: SandboxSnapshot;
+    /** Streams raw sandbox output back (runner forwards it as tool metadata). */
+    onOutput?: (chunk: string) => void;
+};
+export interface ToolContext {
+    sessionId: string;
+    userId: string;
+    workspaceId: string;
+    agent: string;
+    /** Stable PI tool-call id for the current invocation. */
+    toolCallId?: string;
+    abort: AbortSignal;
+    /** Permission escalation from inside a tool (rare; prefer the declarative
+     *  `permission` field on ToolDef, which the runner evaluates first). */
+    ask: PermissionEngine["ask"];
+    workspace: WorkspaceFiles;
+    buildSnapshot(): Promise<SandboxSnapshot>;
+    runSandbox(input: SandboxExecInput): Promise<SandboxExecResult>;
+    /** Updates the live todo projection; emits todo.updated. */
+    setTodos(todos: {
+        content: string;
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+        priority?: "high" | "medium" | "low";
+    }[]): Promise<void>;
+    /** Emits file.edited after a direct write/edit lands. */
+    emitFileEdited(input: {
+        path: string;
+        revisionId: string;
+        diff: string;
+    }): Promise<void>;
+    /** Emits artifact.created for every sandbox deliverable. */
+    emitArtifact(input: {
+        artifactId: string;
+        path: string;
+        bytes: number;
+        contentType: string;
+        downloadUrl: string;
+        previewUrl?: string;
+    }): Promise<void>;
+    /** Spawns a subagent as a child session (spec §6.4), wired by the runner.
+     *  Absent in contexts that can't nest (e.g. the JSONL demo without a
+     *  subagent-capable runner). */
+    spawnSubagent?: (input: {
+        description: string;
+        prompt: string;
+        subagentType: string;
+    }) => Promise<{
+        childSessionId: string;
+        summary: string;
+        state: "completed" | "error";
+    }>;
+    /** Records a subtask part on the parent transcript (childSessionId link). */
+    emitSubtask?: (input: {
+        prompt: string;
+        description: string;
+        agent: string;
+        childSessionId: string;
+    }) => Promise<void>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/core/tools/context.d.ts.map

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

package/dist/core/tools/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/core/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/core/tools/context.ts"],"names":[],"mappings":""}

package/dist/core/tools/def.d.ts

@@ -0,0 +1,27 @@
+import type { z } from "zod";
+import type { ToolContext } from "../tools/context.js";
+/** Framework tool definition (spec §7.1). The permission mapping is
+ *  declarative: the runner evaluates it in beforeToolCall (the single choke
+ *  point, spec §5.4) before execute() ever runs. */
+export type ToolDef<TSchema extends z.ZodType = z.ZodType<any>> = {
+    id: string;
+    label: string;
+    description: string;
+    parameters: TSchema;
+    /** Maps validated args to the permission request. Return null to skip the
+     *  permission check entirely (e.g. todo, which is always safe). */
+    permission: (args: z.output<TSchema>) => {
+        permission: string;
+        patterns: string[];
+        always?: string[];
+        metadata?: unknown;
+    } | null;
+    execute(args: z.output<TSchema>, ctx: ToolContext): Promise<{
+        title: string;
+        output: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Sequential tools never run concurrently with other calls (PI executionMode). */
+    executionMode?: "sequential" | "parallel";
+};
+//# sourceMappingURL=def.d.ts.map

package/dist/core/tools/def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"def.d.ts","sourceRoot":"","sources":["../../../src/core/tools/def.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;oDAEoD;AAEpD,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB;uEACmE;IACnE,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAClI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACnI,mFAAmF;IACnF,aAAa,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CAC3C,CAAC"}

package/dist/core/tools/def.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=def.js.map

package/dist/core/tools/def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"def.js","sourceRoot":"","sources":["../../../src/core/tools/def.ts"],"names":[],"mappings":""}

package/dist/core/tools/qa-check.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { ToolDef } from "./def.js";
+export declare const qaCheckResultSchema: z.ZodObject<{
+    version: z.ZodLiteral<"v1">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        passed: "passed";
+    }>;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            html_loads: "html_loads";
+            metrics_present: "metrics_present";
+            desktop_viewport: "desktop_viewport";
+            mobile_viewport: "mobile_viewport";
+        }>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            passed: "passed";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    viewports: z.ZodArray<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        overflow: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QaCheckResult = z.infer<typeof qaCheckResultSchema>;
+export declare const qaCheckTool: ToolDef;
+//# sourceMappingURL=qa-check.d.ts.map

package/dist/core/tools/qa-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-check.d.ts","sourceRoot":"","sources":["../../../src/core/tools/qa-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAmBhE,eAAO,MAAM,WAAW,EAAE,OA4BzB,CAAC"}

package/dist/core/tools/qa-check.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export const qaCheckResultSchema = z.object({
+    version: z.literal("v1"),
+    status: z.enum(["passed", "failed"]),
+    checks: z.array(z.object({ id: z.enum(["html_loads", "metrics_present", "desktop_viewport", "mobile_viewport"]), status: z.enum(["passed", "failed"]), message: z.string() })),
+    viewports: z.array(z.object({ width: z.number().int().positive(), height: z.number().int().positive(), overflow: z.boolean() })),
+});
+const qaCheckInputSchema = z.object({
+    entryPath: z.string().trim().min(1).max(512).default("index.html"),
+    requiredText: z.array(z.string().trim().min(1).max(120)).max(20).default([]),
+});
+function hasViewportMeta(html) {
+    return /<meta\s+[^>]*name=["']viewport["'][^>]*>/i.test(html) || /<meta\s+[^>]*content=["'][^"']*width=device-width/i.test(html);
+}
+function hasResponsiveStyles(styles) {
+    return /@media\s*\(/i.test(styles) || /\b(?:display\s*:\s*(?:grid|flex)|max-width\s*:|clamp\s*\()/i.test(styles);
+}
+function hasFixedOverflowRisk(styles) {
+    return /(?:width|min-width)\s*:\s*(?:[5-9]\d{2}|\d{4,})px/i.test(styles) && !/max-width\s*:\s*100%/i.test(styles);
+}
+export const qaCheckTool = {
+    id: "qa-check",
+    label: "质量检查",
+    description: "检查当前 Workspace 中的 web_app：HTML 是否可加载、核心内容是否存在、桌面和移动视口是否有明显布局风险。返回稳定的 v1 JSON；失败时请先修复再继续交付。",
+    parameters: qaCheckInputSchema,
+    permission: () => null,
+    async execute(args, ctx) {
+        const entry = await ctx.workspace.read(args.entryPath);
+        const styles = (await Promise.all((await ctx.workspace.list()).filter((file) => file.path.endsWith(".css")).slice(0, 20).map((file) => ctx.workspace.read(file.path)))).filter((file) => Boolean(file)).map((file) => file.content).join("\n");
+        const html = entry?.content ?? "";
+        const htmlLoads = Boolean(entry && /<html\b/i.test(html) && /<body\b/i.test(html));
+        const missingText = args.requiredText.filter((text) => !html.includes(text));
+        const responsive = hasViewportMeta(html) && hasResponsiveStyles(styles);
+        const overflowRisk = hasFixedOverflowRisk(styles);
+        const checks = [
+            { id: "html_loads", status: htmlLoads ? "passed" : "failed", message: htmlLoads ? `${args.entryPath} 可加载` : `${args.entryPath} 缺少有效 html/body` },
+            { id: "metrics_present", status: missingText.length === 0 ? "passed" : "failed", message: missingText.length ? `缺少核心内容：${missingText.join(", ")}` : "核心内容已存在" },
+            { id: "desktop_viewport", status: overflowRisk ? "failed" : "passed", message: overflowRisk ? "样式存在固定宽度溢出风险" : "桌面视口无明显固定宽度风险" },
+            { id: "mobile_viewport", status: responsive && !overflowRisk ? "passed" : "failed", message: !hasViewportMeta(html) ? "缺少移动端 viewport meta" : !hasResponsiveStyles(styles) ? "缺少响应式样式" : overflowRisk ? "移动视口存在固定宽度溢出风险" : "移动视口具备基础响应式约束" },
+        ];
+        const result = {
+            version: "v1",
+            status: checks.every((check) => check.status === "passed") ? "passed" : "failed",
+            checks,
+            viewports: [{ width: 1280, height: 800, overflow: overflowRisk }, { width: 390, height: 844, overflow: !responsive || overflowRisk }],
+        };
+        return { title: `质量检查：${result.status === "passed" ? "通过" : "需要修复"}`, output: JSON.stringify(result, null, 2), metadata: { qaCheck: result } };
+    },
+};
+//# sourceMappingURL=qa-check.js.map

package/dist/core/tools/qa-check.js.map

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

package/dist/core/tools/task.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDef } from "../tools/def.js";
+/** task tool (spec §6.4): spawns a subagent as a child session. Depth is
+ *  capped, the child inherits the parent workspace + a permission ruleset
+ *  merging parent session rules and the subagent preset, and the child runs
+ *  to completion within this tool call. The rendered <task> result goes back
+ *  to the parent model; a subtask part is recorded in the parent transcript. */
+export declare const taskTool: ToolDef;
+//# sourceMappingURL=task.d.ts.map

package/dist/core/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/core/tools/task.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;gFAIgF;AAChF,eAAO,MAAM,QAAQ,EAAE,OAyBtB,CAAC"}

package/dist/core/tools/task.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/** task tool (spec §6.4): spawns a subagent as a child session. Depth is
+ *  capped, the child inherits the parent workspace + a permission ruleset
+ *  merging parent session rules and the subagent preset, and the child runs
+ *  to completion within this tool call. The rendered <task> result goes back
+ *  to the parent model; a subtask part is recorded in the parent transcript. */
+export const taskTool = {
+    id: "task",
+    label: "派生子代理",
+    description: "把一个独立的子任务交给子代理在新会话中完成。用于并行探索（explore）或隔离的通用子任务（general）。子代理有自己的上下文；你只收到它的最终结论。available subagents 见系统提示或 registry。",
+    parameters: z.object({
+        description: z.string().min(3).max(60),
+        prompt: z.string().min(1).max(8 * 1024),
+        subagent_type: z.string().min(1).max(64),
+    }),
+    permission: (args) => ({ permission: "task", patterns: [args.subagent_type], always: ["*"], metadata: { subagent: args.subagent_type, description: args.description } }),
+    executionMode: "sequential",
+    async execute(args, ctx) {
+        if (!ctx.spawnSubagent)
+            throw new Error("当前环境不支持子代理");
+        const result = await ctx.spawnSubagent({
+            description: args.description,
+            prompt: args.prompt,
+            subagentType: args.subagent_type,
+        });
+        return {
+            title: `子代理 ${args.subagent_type}：${args.description}`,
+            output: result.summary,
+            metadata: { childSessionId: result.childSessionId, subagent: args.subagent_type, state: result.state },
+        };
+    },
+};
+//# sourceMappingURL=task.js.map

package/dist/core/tools/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/core/tools/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;gFAIgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,OAAO;IACd,WAAW,EACT,oHAAoH;IACtH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACzC,CAAC;IACF,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IACxK,aAAa,EAAE,YAAY;IAC3B,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,aAAa;SACjC,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,OAAO,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,EAAE;YACtD,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,QAAQ,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;SACvG,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/** @zmzai/agent-framework — PI-based agent framework (OpenCode-style).
+ *  Storage/backend-agnostic: sessions, permissions, tools, runner, events.
+ *  Assemble with createServer() (or wire SessionRunner directly). */
+export type { MessageInfo, MessageWithParts, Part, QueuedPrompt, SessionInfo, SessionStatus, ModelRef, ToolState } from "./core/session/types.js";
+export type { SessionStore } from "./core/session/store.js";
+export { newSessionId, newMessageId, newPartId, newPermissionRequestId, newEventId } from "./core/session/ids.js";
+export { createJsonlSessionStore } from "./core/session/jsonl-store.js";
+export type { FrameworkEvent, FrameworkEventType, PersistedFrameworkEvent, TodoItem } from "./core/events/manifest.js";
+export { frameworkEventSchemas, parseFrameworkEvent } from "./core/events/manifest.js";
+export type { EventLog, SubscribeOptions } from "./core/events/bus.js";
+export { createMemoryEventLog, subscribeEventLog, notifyEventLogListeners } from "./core/events/bus.js";
+export type { Action, Rule, Ruleset, PermissionConfig } from "./core/permission/ruleset.js";
+export { rulesetFromConfig, evaluateRules, wildcardMatch, PERMISSIONS } from "./core/permission/ruleset.js";
+export type { Reply, PermissionRequest } from "./core/permission/engine.js";
+export { PermissionEngine, RejectedError } from "./core/permission/engine.js";
+export type { AgentInfo, AgentDefinition } from "./core/agent/registry.js";
+export { AgentRegistry, builtinAgents, builtinDefaults } from "./core/agent/registry.js";
+export { loadCustomAgents } from "./core/agent/loader.js";
+export type { AgentResolver, ResolvedAgent } from "./core/agent/resolver.js";
+export { parseAgentPlugin, parsePluginManifest, parsePluginMcp } from "./core/agent/plugin.js";
+export type { ParsedAgentPlugin, PluginFileSystem, PluginManifest, PluginMcpServer, PluginSkill } from "./core/agent/plugin.js";
+export type { ToolDef } from "./core/tools/def.js";
+export type { ToolContext, WorkspaceFiles, SandboxSnapshot, SandboxExecResult, SandboxExecInput } from "./core/tools/context.js";
+export { adaptTool, permissionForCall } from "./core/tools/adapter.js";
+export { builtinTools, readTool, globTool, grepTool, writeTool, editTool, todoTool, bashTool } from "./core/tools/builtins.js";
+export { taskTool } from "./core/tools/task.js";
+export { SessionRunner, createFrameworkSession, isSessionActive, type RunnerDeps } from "./core/runtime/runner.js";
+export { PartProjector, serializeEmit } from "./core/runtime/pi-bridge.js";
+export { buildCompactionTransform, createCompactionTransform, streamOneText } from "./core/runtime/compaction.js";
+export { startLeaseRecovery, reclaimExpiredLeases, finalizeInterruptedRun, type LeaseRecoveryStore } from "./core/runtime/lease-recovery.js";
+export type { ModelProvider, SandboxExecutor, LeaseStore } from "./adapters/index.js";
+export { noopSandboxExecutor, leaseDurationMs } from "./adapters/index.js";
+export { qaCheckResultSchema, qaCheckTool, type QaCheckResult } from "./core/tools/qa-check.js";
+export { createFsWorkspaceFiles } from "./adapters/fs-workspace.js";
+export { createOpenAiModelProvider } from "./adapters/openai-provider.js";
+export { createSubprocessSandbox } from "./adapters/subprocess-sandbox.js";
+export { createServer, type FrameworkDeps, type AgentFramework } from "./server/create-server.js";
+//# sourceMappingURL=index.d.ts.map