@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/core/tools/websearch.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+const SEARCH_TIMEOUT_MS = 15_000;
+const UA = "zmzai-agent/0.1 (websearch)";
+/** 解析 DuckDuckGo Lite 结果页。href 常为 /l/?uddg=<encoded> 重定向，需还原真实 URL。 */
+export function parseDuckDuckGoHtml(html) {
+    const results = [];
+    const blockRe = /<a[^>]+class="[^"]*result__a[^"]*"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>([\s\S]*?)(?=<div class="results_links|<a[^>]+class="[^"]*result__a|$)/gi;
+    let match;
+    while ((match = blockRe.exec(html)) !== null) {
+        const rawHref = match[1];
+        const title = stripTags(match[2]);
+        const snippetSection = match[3] ?? "";
+        const snippetMatch = /class="[^"]*result__snippet[^"]*"[^>]*>([\s\S]*?)<\/(?:a|td|div)>/i.exec(snippetSection);
+        const snippet = snippetMatch ? stripTags(snippetMatch[1]) : "";
+        const url = resolveDdgHref(rawHref);
+        if (!url || !title)
+            continue;
+        results.push({ title, url, snippet });
+    }
+    return results;
+}
+function resolveDdgHref(href) {
+    // DuckDuckGo 的结果链接多为 /l/?uddg=<encodeURIComponent(target)> 重定向
+    const uddgMatch = /[?&]uddg=([^&]+)/.exec(href);
+    if (uddgMatch) {
+        try {
+            return decodeURIComponent(uddgMatch[1]);
+        }
+        catch {
+            return null;
+        }
+    }
+    const value = href.startsWith("//") ? `https:${href}` : href;
+    return /^https?:\/\//i.test(value) ? value : null;
+}
+function stripTags(fragment) {
+    return fragment
+        .replace(/<[^>]+>/g, "")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#x27;|&#39;/gi, "'")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+async function searchViaTavily(query, apiKey, maxResults, doFetch) {
+    const response = await doFetch("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${apiKey}`, "user-agent": UA },
+        body: JSON.stringify({ query, max_results: maxResults, search_depth: "basic" }),
+        signal: AbortSignal.timeout(SEARCH_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`Tavily 搜索失败：HTTP ${response.status}`);
+    const data = (await response.json());
+    return (data.results ?? [])
+        .filter((item) => item.url)
+        .map((item) => ({ title: item.title ?? item.url, url: item.url, snippet: stripTags(item.content ?? "") }));
+}
+async function searchViaSerper(query, apiKey, maxResults, doFetch) {
+    const response = await doFetch("https://google.serper.dev/search", {
+        method: "POST",
+        headers: { "content-type": "application/json", "X-API-KEY": apiKey, "user-agent": UA },
+        body: JSON.stringify({ q: query, num: maxResults }),
+        signal: AbortSignal.timeout(SEARCH_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`Serper 搜索失败：HTTP ${response.status}`);
+    const data = (await response.json());
+    return (data.organic ?? [])
+        .filter((item) => item.link)
+        .map((item) => ({ title: item.title ?? item.link, url: item.link, snippet: stripTags(item.snippet ?? "") }));
+}
+async function searchViaDuckDuckGo(query, maxResults, doFetch) {
+    const endpoint = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}&kl=wt-wt`;
+    const response = await doFetch(endpoint, {
+        headers: { "user-agent": UA, accept: "text/html" },
+        signal: AbortSignal.timeout(SEARCH_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`DuckDuckGo 搜索失败：HTTP ${response.status}`);
+    const html = await response.text();
+    const all = parseDuckDuckGoHtml(html);
+    return all.slice(0, maxResults);
+}
+export function createWebSearchTool(opts = {}) {
+    const doFetch = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    const envLoader = opts.envLoader ?? (() => ({ TAVILY_API_KEY: process.env.TAVILY_API_KEY, SERPER_API_KEY: process.env.SERPER_API_KEY }));
+    return {
+        id: "websearch",
+        label: "联网搜索",
+        description: "搜索互联网并返回标题+链接+摘要列表（多数结果无需再抓取即可判断相关性；需要全文时对结果 URL 用 webfetch）。查询用与目标资料相同的语言效果最好。",
+        parameters: z.object({
+            query: z.string().trim().min(1).max(400),
+            maxResults: z.number().int().min(1).max(10).optional(),
+        }),
+        permission: (args) => ({ permission: "webfetch", patterns: [`search:${args.query}`] }),
+        async execute(args) {
+            const maxResults = args.maxResults ?? 6;
+            const env = envLoader();
+            const startedAt = Date.now();
+            let provider = "duckduckgo";
+            let results;
+            try {
+                if (env.TAVILY_API_KEY) {
+                    provider = "tavily";
+                    results = await searchViaTavily(args.query, env.TAVILY_API_KEY, maxResults, doFetch);
+                }
+                else if (env.SERPER_API_KEY) {
+                    provider = "serper";
+                    results = await searchViaSerper(args.query, env.SERPER_API_KEY, maxResults, doFetch);
+                }
+                else {
+                    results = await searchViaDuckDuckGo(args.query, maxResults, doFetch);
+                }
+            }
+            catch (error) {
+                throw new Error(`搜索失败（provider=${provider}）：${error instanceof Error ? error.message : String(error)}`);
+            }
+            const output = results.length
+                ? results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}${r.snippet ? `\n   ${r.snippet.slice(0, 300)}` : ""}`).join("\n")
+                : "（没有搜索结果）";
+            return {
+                title: `搜索「${args.query.slice(0, 30)}」：${results.length} 条`,
+                output,
+                metadata: { provider, count: results.length, durationMs: Date.now() - startedAt },
+            };
+        },
+    };
+}
+//# sourceMappingURL=websearch.js.map

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

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

package/dist/index.d.ts

@@ -1,16 +1,18 @@
 /** @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 { MessageInfo, MessageWithParts, Part, QueuedPrompt, SessionInfo, SessionStatus, ModelRef, ToolState, ThinkingEffort } 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 { createSqliteSessionStore } from "./core/session/sqlite-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 { pathInWritePaths, writePathGuardRules, confineWorkspaceFiles } from "./core/permission/write-path.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";
@@ -19,20 +21,43 @@ 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 { McpStdioClient } from "./core/mcp/client.js";
+export type { McpToolInfo, McpCallResult, StdioServerSpec, McpClientOptions } from "./core/mcp/client.js";
+export { startMcpServers } from "./core/mcp/servers.js";
+export type { McpServerEntry, McpServerStatus, McpPoolResult, McpPoolOptions } from "./core/mcp/servers.js";
+export { McpStreamableHttpClient, McpSseClient, createMcpHttpClient, createSseParser } from "./core/mcp/http-client.js";
+export type { McpClientLike } from "./core/mcp/http-client.js";
+export type { ToolDef, ExternalToolDef, AnyToolDef } from "./core/tools/def.js";
+export { isExternalToolDef } 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 { adaptTool, adaptExternalTool, adaptAnyTool, permissionForCall } from "./core/tools/adapter.js";
+export { pruneFailureLog, trimFailureOutput, type FailureTrimResult } from "./core/tools/trim.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 { createGitTools } from "./core/tools/git.js";
+export type { GitToolsOptions } from "./core/tools/git.js";
+export { TerminalManager, createTerminalTools } from "./core/tools/terminal.js";
+export type { TerminalBackend, TerminalHandle, TerminalSessionInfo, TerminalSessionStatus } from "./core/tools/terminal.js";
+export { createHostTerminalBackend } from "./adapters/terminal-backend.js";
+export { createRepoMapTool } from "./core/tools/repomap.js";
+export { renderRepoMap, resolveFrameworkVendorDirs, setWasmDirs, type RepoMapOptions, type RepoMapResult } from "./core/repomap/repomap.js";
+export { SessionRunner, createFrameworkSession, isSessionActive, type RunnerDeps, type PromptInput } from "./core/runtime/runner.js";
+export type { LifecycleHook } from "./core/runtime/lifecycle.js";
+export { extractRunTranscript, RETRY_PLACEHOLDER_TEXT, type RunTranscriptMessage } from "./core/runtime/run-transcript.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 { webfetchTool } from "./core/tools/webfetch.js";
+export { createWebSearchTool, parseDuckDuckGoHtml } from "./core/tools/websearch.js";
+export type { WebSearchOptions, WebSearchResult } from "./core/tools/websearch.js";
+export { applyPatchTool, parseUnifiedPatch, applyFilePatch } from "./core/tools/patch.js";
+export type { FilePatch, PatchParseResult, ApplyPatchReportEntry } from "./core/tools/patch.js";
 export { createFsWorkspaceFiles } from "./adapters/fs-workspace.js";
-export { createOpenAiModelProvider } from "./adapters/openai-provider.js";
+export { createOpenAiModelProvider, type ProviderHeaders, type FailoverEndpoint, type FailoverEvent } from "./adapters/openai-provider.js";
 export { createSubprocessSandbox } from "./adapters/subprocess-sandbox.js";
 export { createServer, type FrameworkDeps, type AgentFramework } from "./server/create-server.js";
+export { createAgentRuntime, type AgentRuntimePreset, type AgentRuntime, type AgentRuntimeWorkspace, type AgentRuntimeSandbox, type AgentRuntimeCapabilities } from "./server/create-agent-runtime.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -3,26 +3,44 @@
  *  Assemble with createServer() (or wire SessionRunner directly). */
 export { newSessionId, newMessageId, newPartId, newPermissionRequestId, newEventId } from "./core/session/ids.js";
 export { createJsonlSessionStore } from "./core/session/jsonl-store.js";
+export { createSqliteSessionStore } from "./core/session/sqlite-store.js";
 export { frameworkEventSchemas, parseFrameworkEvent } from "./core/events/manifest.js";
 export { createMemoryEventLog, subscribeEventLog, notifyEventLogListeners } from "./core/events/bus.js";
 export { rulesetFromConfig, evaluateRules, wildcardMatch, PERMISSIONS } from "./core/permission/ruleset.js";
+export { pathInWritePaths, writePathGuardRules, confineWorkspaceFiles } from "./core/permission/write-path.js";
 export { PermissionEngine, RejectedError } from "./core/permission/engine.js";
 export { AgentRegistry, builtinAgents, builtinDefaults } from "./core/agent/registry.js";
 export { loadCustomAgents } from "./core/agent/loader.js";
 export { parseAgentPlugin, parsePluginManifest, parsePluginMcp } from "./core/agent/plugin.js";
-export { adaptTool, permissionForCall } from "./core/tools/adapter.js";
+// core: mcp
+export { McpStdioClient } from "./core/mcp/client.js";
+export { startMcpServers } from "./core/mcp/servers.js";
+export { McpStreamableHttpClient, McpSseClient, createMcpHttpClient, createSseParser } from "./core/mcp/http-client.js";
+export { isExternalToolDef } from "./core/tools/def.js";
+export { adaptTool, adaptExternalTool, adaptAnyTool, permissionForCall } from "./core/tools/adapter.js";
+export { pruneFailureLog, trimFailureOutput } from "./core/tools/trim.js";
 export { builtinTools, readTool, globTool, grepTool, writeTool, editTool, todoTool, bashTool } from "./core/tools/builtins.js";
 export { taskTool } from "./core/tools/task.js";
+export { createGitTools } from "./core/tools/git.js";
+export { TerminalManager, createTerminalTools } from "./core/tools/terminal.js";
+export { createHostTerminalBackend } from "./adapters/terminal-backend.js";
+export { createRepoMapTool } from "./core/tools/repomap.js";
+export { renderRepoMap, resolveFrameworkVendorDirs, setWasmDirs } from "./core/repomap/repomap.js";
 // core: runtime
 export { SessionRunner, createFrameworkSession, isSessionActive } from "./core/runtime/runner.js";
+export { extractRunTranscript, RETRY_PLACEHOLDER_TEXT } from "./core/runtime/run-transcript.js";
 export { PartProjector, serializeEmit } from "./core/runtime/pi-bridge.js";
 export { buildCompactionTransform, createCompactionTransform, streamOneText } from "./core/runtime/compaction.js";
 export { startLeaseRecovery, reclaimExpiredLeases, finalizeInterruptedRun } from "./core/runtime/lease-recovery.js";
 export { noopSandboxExecutor, leaseDurationMs } from "./adapters/index.js";
 export { qaCheckResultSchema, qaCheckTool } from "./core/tools/qa-check.js";
+export { webfetchTool } from "./core/tools/webfetch.js";
+export { createWebSearchTool, parseDuckDuckGoHtml } from "./core/tools/websearch.js";
+export { applyPatchTool, parseUnifiedPatch, applyFilePatch } from "./core/tools/patch.js";
 export { createFsWorkspaceFiles } from "./adapters/fs-workspace.js";
 export { createOpenAiModelProvider } from "./adapters/openai-provider.js";
 export { createSubprocessSandbox } from "./adapters/subprocess-sandbox.js";
 // server
 export { createServer } from "./server/create-server.js";
+export { createAgentRuntime } from "./server/create-agent-runtime.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;qEAEqE;AAKrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIxG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM/F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC/H,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAA2B,MAAM,kCAAkC,CAAC;AAI7I,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,SAAS;AACT,OAAO,EAAE,YAAY,EAA2C,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;qEAEqE;AAKrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAI1E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIxG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG/F,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAA0B,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC/H,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,WAAW,EAA2C,MAAM,2BAA2B,CAAC;AAE5I,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAqC,MAAM,0BAA0B,CAAC;AAErI,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAA6B,MAAM,kCAAkC,CAAC;AAC3H,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAA2B,MAAM,kCAAkC,CAAC;AAI7I,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAmE,MAAM,+BAA+B,CAAC;AAC3I,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,SAAS;AACT,OAAO,EAAE,YAAY,EAA2C,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAmI,MAAM,kCAAkC,CAAC"}

package/dist/server/create-agent-runtime.d.ts

@@ -0,0 +1,68 @@
+import { type ModelProvider, type SandboxExecutor } from "../adapters/index.js";
+import type { EventLog } from "../core/events/bus.js";
+import type { WorkspaceFiles } from "../core/tools/context.js";
+import type { AnyToolDef } from "../core/tools/def.js";
+import type { RunnerDeps } from "../core/runtime/runner.js";
+import type { SessionInfo } from "../core/session/types.js";
+import type { SessionStore } from "../core/session/store.js";
+import { type AgentFramework } from "./create-server.js";
+/**
+ * createAgentRuntime (spec D2 装配收敛)：createServer 之上的高层工厂。
+ *
+ * createServer 要求消费方自行装配全部后端与工具；两端（zmzai-agent /
+ * zmzai-harness）因此各自维护一份手工接线，每加一个框架能力都要两处重复。
+ * preset 把「声明差异」与「能力接线」分离：
+ *
+ *  - 消费方只声明后端差异：workspace（fs 目录 vs 自定义）、sandbox（子进程
+ *    vs 注入执行器）、modelProvider / store；
+ *  - 能力（repo_map、subagent 等）以 capabilities 声明开关，工厂统一接线——
+ *    两端升级 framework 依赖即获得新能力，不再手工复制工具注册。
+ *
+ * 未收敛的 RunnerDeps 字段（agentResolver / memoryContextFor / leaseStore /
+ * compaction …）经 runnerOptions 透传，渐进迁移：新能力走 preset，旧装配
+ * 逐步替换，不做一次性大迁移。
+ */
+export type AgentRuntimeWorkspace = {
+    kind: "fs";
+    root: string | (() => string);
+} | {
+    kind: "custom";
+    workspaceFor: (session: SessionInfo) => WorkspaceFiles;
+};
+export type AgentRuntimeSandbox = {
+    kind: "subprocess";
+    workspaceRoot?: string | (() => string);
+} | SandboxExecutor;
+export type AgentRuntimeCapabilities = {
+    /** Repo Map（R1，Aider 式项目地图）：fs 工作区默认开启；false 关闭；
+     *  对象形式显式开启（custom 工作区如 Mongo 虚拟 fs 也可指定索引根）。 */
+    repoMap?: {
+        workspaceRoot?: string | (() => string);
+    } | false;
+    /** 子代理嵌套深度（R3，spec §6.4）：默认 1；false 关闭。 */
+    subagents?: number | false;
+};
+export type AgentRuntimePreset = {
+    store: SessionStore;
+    /** 模型 provider 装配（getModel + streamFor）。与 runnerOptions 的
+     *  streamFnFor/modelFor 双函数二选一：两者都省略则装配失败。 */
+    modelProvider?: ModelProvider;
+    eventLog?: EventLog;
+    workspace: AgentRuntimeWorkspace;
+    sandbox?: AgentRuntimeSandbox;
+    /** host 工具（terminal/git/MCP server 工具…）。能力工具（repo_map 等）
+     *  prepended 到它前面；数组按引用合并——消费方对传入数组就地重置
+     *  （如 harness 的 MCP 注入）仍然生效。 */
+    localTools?: AnyToolDef[];
+    /** 能力开关：默认 repoMap（fs 工作区）+ subagents depth 1。 */
+    capabilities?: AgentRuntimeCapabilities;
+    /** 透传 RunnerDeps 其余字段（streamFnFor / modelFor / agentResolver /
+     *  memoryContextFor / hooks / leaseStore / compaction /
+     *  loadWorkspaceAgents / sessionRuleTtlMs…），是渐进迁移的兜底出口。
+     *  streamFnFor/modelFor 传入时覆盖 modelProvider 派生（适配旧式双函数装配）。 */
+    runnerOptions?: Partial<Omit<RunnerDeps, "store" | "registry" | "eventLog" | "workspaceFor" | "sandbox" | "localTools" | "subagentDepth" | "tools">>;
+};
+/** createAgentRuntime 的返回：与 createServer 相同的框架门面。 */
+export type AgentRuntime = AgentFramework;
+export declare function createAgentRuntime(preset: AgentRuntimePreset): AgentFramework;
+//# sourceMappingURL=create-agent-runtime.d.ts.map

package/dist/server/create-agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-runtime.d.ts","sourceRoot":"","sources":["../../src/server/create-agent-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,cAAc,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;CAAE,GAC/D,eAAe,CAAC;AAEpB,MAAM,MAAM,wBAAwB,GAAG;IACrC;qDACiD;IACjD,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC;IAC9D,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB;kDAC8C;IAC9C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;oCAEgC;IAChC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,kDAAkD;IAClD,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;;kEAG8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;CACtJ,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAM1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CA4D7E"}

package/dist/server/create-agent-runtime.js

@@ -0,0 +1,67 @@
+import { createFsWorkspaceFiles } from "../adapters/fs-workspace.js";
+import { noopSandboxExecutor } from "../adapters/index.js";
+import { createSubprocessSandbox } from "../adapters/subprocess-sandbox.js";
+import { createMemoryEventLog } from "../core/events/bus.js";
+import { createRepoMapTool } from "../core/tools/repomap.js";
+import { createServer } from "./create-server.js";
+function asFactory(value) {
+    return typeof value === "function" ? value : () => value;
+}
+export function createAgentRuntime(preset) {
+    const caps = preset.capabilities ?? {};
+    // workspace：fs 目录一键接入（builtin read/write/glob/grep 与 repomap 共享根）
+    const workspaceSpec = preset.workspace;
+    const workspaceFor = workspaceSpec.kind === "fs"
+        ? () => createFsWorkspaceFiles({ root: asFactory(workspaceSpec.root)() })
+        : workspaceSpec.workspaceFor;
+    // sandbox：子进程参考实现（本机模式）或注入执行器（云端模式）
+    let sandbox = noopSandboxExecutor();
+    const sandboxSpec = preset.sandbox;
+    if (sandboxSpec) {
+        if ("kind" in sandboxSpec && sandboxSpec.kind === "subprocess") {
+            const { workspaceRoot } = sandboxSpec;
+            sandbox = createSubprocessSandbox(workspaceRoot !== undefined ? { workspaceRoot: asFactory(workspaceRoot) } : {});
+        }
+        else {
+            sandbox = sandboxSpec;
+        }
+    }
+    // 能力工具（repo_map）：默认随 fs 工作区开启；false 关闭；对象形式显式指定索引根
+    const capabilityTools = [];
+    const repoMap = caps.repoMap;
+    let repoMapRoot;
+    if (repoMap === false) {
+        repoMapRoot = undefined;
+    }
+    else if (repoMap != null) {
+        repoMapRoot = repoMap.workspaceRoot ?? (preset.workspace.kind === "fs" ? preset.workspace.root : undefined);
+    }
+    else if (preset.workspace.kind === "fs") {
+        repoMapRoot = preset.workspace.root;
+    }
+    if (repoMapRoot !== undefined) {
+        capabilityTools.push(createRepoMapTool({ workspaceRoot: asFactory(repoMapRoot) }));
+    }
+    const subagentDepth = caps.subagents === false ? 0 : (caps.subagents ?? 1);
+    // 模型装配：runnerOptions 双函数优先（旧式 relay 装配），否则 modelProvider
+    const modelFor = preset.runnerOptions?.modelFor;
+    const streamFnFor = preset.runnerOptions?.streamFnFor;
+    if (!preset.modelProvider && (!modelFor || !streamFnFor)) {
+        throw new Error("createAgentRuntime: modelProvider 与 runnerOptions.streamFnFor/modelFor 至少提供其一");
+    }
+    const modelProvider = preset.modelProvider ?? {
+        getModel: (ref) => modelFor(ref),
+        streamFor: (session) => streamFnFor(session),
+    };
+    return createServer({
+        store: preset.store,
+        eventLog: preset.eventLog ?? createMemoryEventLog(),
+        modelProvider,
+        workspaceFor,
+        sandbox,
+        localTools: [...capabilityTools, ...(preset.localTools ?? [])],
+        subagentDepth,
+        ...preset.runnerOptions,
+    });
+}
+//# sourceMappingURL=create-agent-runtime.js.map

package/dist/server/create-agent-runtime.js.map

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

package/dist/server/create-server.d.ts

@@ -19,6 +19,11 @@ export type FrameworkDeps = {
     sandbox?: SandboxExecutor;
     registry?: AgentRegistry;
     loadWorkspaceAgents?: (session: SessionInfo) => Promise<import("../core/agent/registry.js").AgentInfo[]>;
+    /** Host-injected tools (desktop fs/shell, MCP server tools…). Read at every
+     *  run, so mutating the array between prompts takes effect on the next run. */
+    localTools?: import("../core/tools/def.js").AnyToolDef[];
+    /** 生命周期钩子（P0）：observe/block，见 core/runtime/lifecycle.ts。 */
+    hooks?: import("../core/runtime/lifecycle.js").LifecycleHook[];
     subagentDepth?: number;
     compaction?: {
         enabled: boolean;

package/dist/server/create-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA0B,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;qDAIqD;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,cAAc,CAAC;IACvD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,2BAA2B,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,uBAAuB,EAAE,KAAK,CAAC,OAAO,uBAAuB,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1J,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACnI,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB;kDAC8C;IAC9C,aAAa,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1K,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAyBhE"}
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA0B,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;qDAIqD;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,cAAc,CAAC;IACvD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,2BAA2B,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG;mFAC+E;IAC/E,UAAU,CAAC,EAAE,OAAO,sBAAsB,EAAE,UAAU,EAAE,CAAC;IACzD,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,8BAA8B,EAAE,aAAa,EAAE,CAAC;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,uBAAuB,EAAE,KAAK,CAAC,OAAO,uBAAuB,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1J,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACnI,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB;kDAC8C;IAC9C,aAAa,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1K,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CA2BhE"}

package/dist/server/create-server.js

@@ -12,6 +12,8 @@ export function createServer(deps) {
         workspaceFor: deps.workspaceFor,
         sandbox: deps.sandbox ?? noopSandboxExecutor(),
         ...(deps.loadWorkspaceAgents ? { loadWorkspaceAgents: deps.loadWorkspaceAgents } : {}),
+        ...(deps.localTools ? { localTools: deps.localTools } : {}),
+        ...(deps.hooks ? { hooks: deps.hooks } : {}),
         subagentDepth: deps.subagentDepth ?? 1,
         ...(deps.compaction ? { compaction: deps.compaction } : {}),
         ...(deps.leaseStore ? { leaseStore: deps.leaseStore } : {}),

package/dist/server/create-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAiC3D,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ;QACR,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC;QAC/D,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE;QAC9C,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ;QACR,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO,sBAAsB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAsC3D,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ;QACR,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC;QAC/D,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE;QAC9C,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ;QACR,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO,sBAAsB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zmzai/agent-framework",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "PI-based agent framework — sessions, permissions, tools, runner, events (OpenCode-style).",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,19 +14,33 @@
   "bin": {
     "zmzai-agent": "./dist/cli.js"
   },
-  "files": ["dist", "openapi.yaml"],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  },
+  "files": [
+    "dist",
+    "openapi.yaml"
+  ],
   "dependencies": {
     "@earendil-works/pi-agent-core": "0.84.1",
     "@earendil-works/pi-ai": "0.84.1",
-    "zod": "^4.4.3"
+    "tree-sitter-wasms": "^0.1.13",
+    "web-tree-sitter": "0.25.8",
+    "zod": "4.4.3"
   },
   "devDependencies": {
+    "@changesets/cli": "^3.0.1",
+    "@types/node": "^26.4.0",
     "typescript": "5.9.3",
     "vitest": "^4.1.10"
+  },
+  "optionalDependencies": {
+    "node-pty": "1.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "release": "pnpm build && changeset publish"
   }
-}
+}