@namzu/sdk 0.1.1

package/dist/runtime/query/iteration/phases/tool-review.js

@@ -0,0 +1,139 @@
+import { createUserMessage } from "../../../../types/message/index.js";
+export async function* runToolReview(ctx, response, iterationNum) {
+    const toolCalls = response.message.toolCalls;
+    const toolCallSummaries = toolCalls.map((tc) => {
+        let input;
+        try {
+            input = JSON.parse(tc.function.arguments);
+        }
+        catch {
+            input = tc.function.arguments;
+        }
+        const tool = ctx.tools.get(tc.function.name);
+        const isDestructive = tool?.isDestructive
+            ? tool.isDestructive(input)
+            : false;
+        return {
+            id: tc.id,
+            name: tc.function.name,
+            input,
+            isDestructive,
+        };
+    });
+    const reviewCheckpoint = await ctx.checkpointMgr.create(ctx.sessionMgr, iterationNum);
+    await ctx.emitEvent({
+        type: "tool_review_requested",
+        runId: ctx.sessionMgr.id,
+        toolCalls: toolCallSummaries,
+        iteration: iterationNum,
+    });
+    yield* ctx.drainPending();
+    const reviewDecision = await ctx.resumeHandler({
+        type: "tool_review",
+        runId: ctx.sessionMgr.id,
+        checkpointId: reviewCheckpoint.id,
+        toolCalls: toolCallSummaries,
+    });
+    switch (reviewDecision.action) {
+        case "reject_tools": {
+            await ctx.emitEvent({
+                type: "tool_review_completed",
+                runId: ctx.sessionMgr.id,
+                decision: "rejected",
+            });
+            yield* ctx.drainPending();
+            const feedback = reviewDecision.feedback || "User rejected the tool calls";
+            ctx.sessionMgr.pushMessage(createUserMessage(`[SYSTEM] Tool calls rejected: ${feedback}`));
+            return "rejected";
+        }
+        case "modify_tools": {
+            await ctx.emitEvent({
+                type: "tool_review_completed",
+                runId: ctx.sessionMgr.id,
+                decision: "modified",
+            });
+            yield* ctx.drainPending();
+            for (const mod of reviewDecision.modifications) {
+                if (mod.action === "modify" && mod.modifiedInput !== undefined) {
+                    const tc = toolCalls.find((t) => t.id === mod.toolCallId);
+                    if (tc) {
+                        tc.function.arguments = JSON.stringify(mod.modifiedInput);
+                    }
+                }
+            }
+            const deniedIds = new Set(reviewDecision.modifications
+                .filter((m) => m.action === "deny")
+                .map((m) => m.toolCallId));
+            const filteredToolCalls = toolCalls.filter((tc) => !deniedIds.has(tc.id));
+            if (filteredToolCalls.length === 0) {
+                ctx.sessionMgr.pushMessage(createUserMessage("[SYSTEM] All tool calls were denied by user"));
+                return "rejected";
+            }
+            const batch = await ctx.toolExecutor.executeBatch({
+                ...response,
+                message: { ...response.message, toolCalls: filteredToolCalls },
+            });
+            for (const msg of batch.messages) {
+                ctx.sessionMgr.pushMessage(msg);
+            }
+            return "executed";
+        }
+        case "pause": {
+            await ctx.emitEvent({
+                type: "tool_review_completed",
+                runId: ctx.sessionMgr.id,
+                decision: "rejected",
+            });
+            await ctx.emitEvent({
+                type: "run_paused",
+                runId: ctx.sessionMgr.id,
+                checkpointId: reviewCheckpoint.id,
+                reason: reviewDecision.reason,
+            });
+            yield* ctx.drainPending();
+            ctx.sessionMgr.setStopReason("paused");
+            return "stop";
+        }
+        case "abort": {
+            await ctx.emitEvent({
+                type: "tool_review_completed",
+                runId: ctx.sessionMgr.id,
+                decision: "rejected",
+            });
+            yield* ctx.drainPending();
+            ctx.sessionMgr.setStopReason("cancelled");
+            ctx.sessionMgr.markCancelled();
+            return "stop";
+        }
+        case "approve_tools":
+        case "continue": {
+            await ctx.emitEvent({
+                type: "tool_review_completed",
+                runId: ctx.sessionMgr.id,
+                decision: "approved",
+            });
+            yield* ctx.drainPending();
+            const batch = await ctx.toolExecutor.executeBatch(response);
+            for (const msg of batch.messages) {
+                ctx.sessionMgr.pushMessage(msg);
+            }
+            return "executed";
+        }
+        case "approve_plan":
+        case "reject_plan": {
+            ctx.log.warn("Unexpected plan decision during tool review", {
+                action: reviewDecision.action,
+            });
+            const batch = await ctx.toolExecutor.executeBatch(response);
+            for (const msg of batch.messages) {
+                ctx.sessionMgr.pushMessage(msg);
+            }
+            return "executed";
+        }
+        default: {
+            const _exhaustive = reviewDecision;
+            throw new Error(`Unhandled tool review decision: ${_exhaustive.action}`);
+        }
+    }
+}
+//# sourceMappingURL=tool-review.js.map

package/dist/runtime/query/iteration/phases/tool-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-review.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/tool-review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAOvE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CACnC,GAAqB,EACrB,QAAgC,EAChC,YAAoB;IAEpB,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAU,CAAC;IAE9C,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9C,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACR,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa;YACxC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,KAAK,CAAC;QAET,OAAO;YACN,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;YACtB,KAAK;YACL,aAAa;SACb,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CACtD,GAAG,CAAC,UAAU,EACd,YAAY,CACZ,CAAC;IAEF,MAAM,GAAG,CAAC,SAAS,CAAC;QACnB,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,YAAY;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAE1B,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;QAC9C,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,YAAY,EAAE,gBAAgB,CAAC,EAAE;QACjC,SAAS,EAAE,iBAAiB;KAC5B,CAAC,CAAC;IAEH,QAAQ,cAAc,CAAC,MAAM,EAAE,CAAC;QAC/B,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,QAAQ,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAE1B,MAAM,QAAQ,GACb,cAAc,CAAC,QAAQ,IAAI,8BAA8B,CAAC;YAC3D,GAAG,CAAC,UAAU,CAAC,WAAW,CACzB,iBAAiB,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAC9D,CAAC;YACF,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,QAAQ,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAE1B,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;gBAChD,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBAChE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;oBAC1D,IAAI,EAAE,EAAE,CAAC;wBACR,EAAE,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;oBAC3D,CAAC;gBACF,CAAC;YACF,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,GAAG,CACxB,cAAc,CAAC,aAAa;iBAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAC1B,CAAC;YACF,MAAM,iBAAiB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAE1E,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,GAAG,CAAC,UAAU,CAAC,WAAW,CACzB,iBAAiB,CAAC,6CAA6C,CAAC,CAChE,CAAC;gBACF,OAAO,UAAU,CAAC;YACnB,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC;gBACjD,GAAG,QAAQ;gBACX,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE;aAC9D,CAAC,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,QAAQ,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,YAAY,EAAE,gBAAgB,CAAC,EAAE;gBACjC,MAAM,EAAE,cAAc,CAAC,MAAM;aAC7B,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC;QACf,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,QAAQ,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAC1C,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QACf,CAAC;QAED,KAAK,eAAe,CAAC;QACrB,KAAK,UAAU,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACxB,QAAQ,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAE1B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,KAAK,cAAc,CAAC;QACpB,KAAK,aAAa,CAAC,CAAC,CAAC;YACpB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,6CAA6C,EAAE;gBAC3D,MAAM,EAAE,cAAc,CAAC,MAAM;aAC7B,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,cAAc,CAAC;YAC1C,MAAM,IAAI,KAAK,CACd,mCAAoC,WAAkC,CAAC,MAAM,EAAE,CAC/E,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/runtime/query/prompt.d.ts

@@ -0,0 +1,18 @@
+import type { AgentPersona } from '../../types/persona/index.js';
+import type { Skill } from '../../types/skills/index.js';
+import type { ToolRegistry } from '../../registry/tool/execute.js';
+import type { AgentContextLevel } from '../../types/agent/factory.js';
+export interface PromptBuilderConfig {
+    systemPrompt?: string;
+    persona?: AgentPersona;
+    skills?: Skill[];
+    basePrompt?: string;
+    tools: ToolRegistry;
+    allowedTools?: string[];
+}
+export declare class PromptBuilder {
+    private config;
+    constructor(config: PromptBuilderConfig);
+    build(contextLevel?: AgentContextLevel, workingDirectory?: string): string;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/runtime/query/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAKrE,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,EAAE,YAAY,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAgBD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,mBAAmB;IAIvC,KAAK,CAAC,YAAY,GAAE,iBAA0B,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;CA8BnF"}

package/dist/runtime/query/prompt.js

@@ -0,0 +1,45 @@
+import { assembleSystemPrompt } from '../../persona/assembler.js';
+const FILESYSTEM_TOOLS = new Set(['glob', 'read_file', 'write_file', 'bash']);
+function buildEnvContext(workingDirectory) {
+    return `<env>
+Working directory: ${workingDirectory}
+Platform: ${process.platform}
+</env>
+
+IMPORTANT: Always use absolute paths based on the working directory above. Before reading a file, use the glob tool to discover actual file paths — never guess or hallucinate paths.`;
+}
+function hasFilesystemTools(tools, allowedTools) {
+    const activeTools = allowedTools ?? tools.listNames();
+    return activeTools.some(name => FILESYSTEM_TOOLS.has(name));
+}
+export class PromptBuilder {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    build(contextLevel = 'full', workingDirectory) {
+        const parts = [];
+        if (contextLevel === 'full' && this.config.basePrompt) {
+            parts.push(this.config.basePrompt);
+        }
+        if (this.config.systemPrompt) {
+            parts.push(this.config.systemPrompt);
+        }
+        else if (this.config.persona) {
+            parts.push(assembleSystemPrompt(this.config.persona, this.config.skills));
+        }
+        if (contextLevel !== 'minimal') {
+            const toolSection = this.config.tools.toPromptSection(this.config.allowedTools);
+            if (toolSection) {
+                parts.push(toolSection);
+            }
+        }
+        if (contextLevel !== 'minimal' &&
+            workingDirectory &&
+            hasFilesystemTools(this.config.tools, this.config.allowedTools)) {
+            parts.push(buildEnvContext(workingDirectory));
+        }
+        return parts.join('\n\n---\n\n');
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/runtime/query/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/runtime/query/prompt.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;AAe7E,SAAS,eAAe,CAAC,gBAAwB;IAC/C,OAAO;qBACY,gBAAgB;YACzB,OAAO,CAAC,QAAQ;;;sLAG0J,CAAA;AACtL,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAmB,EAAE,YAAuB;IACtE,MAAM,WAAW,GAAG,YAAY,IAAI,KAAK,CAAC,SAAS,EAAE,CAAA;IACrD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,OAAO,aAAa;IAChB,MAAM,CAAqB;IAEnC,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,eAAkC,MAAM,EAAE,gBAAyB;QACvE,MAAM,KAAK,GAAa,EAAE,CAAA;QAE1B,IAAI,YAAY,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACpC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QACtC,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QAC3E,CAAC;QAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;YAC/E,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAED,IACE,YAAY,KAAK,SAAS;YAC1B,gBAAgB;YAChB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAC/D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAClC,CAAC;CACF"}

package/dist/runtime/query/result.d.ts

@@ -0,0 +1,24 @@
+import type { AgentRun, RunEvent } from '../../types/run/index.js';
+import type { RunPersistence } from '../../manager/run/persistence.js';
+import type { PlanManager } from '../../manager/plan/lifecycle.js';
+import type { ActivityStore } from '../../store/activity/memory.js';
+import type { Logger } from '../../utils/logger.js';
+import type { EmitEvent } from './events.js';
+import type { Span } from '@opentelemetry/api';
+export interface ResultAssemblerConfig {
+    sessionMgr: RunPersistence;
+    planManager: PlanManager;
+    activityStore: ActivityStore;
+    log: Logger;
+    emitEvent: EmitEvent;
+    drainPending: () => Generator<RunEvent>;
+}
+export declare class ResultAssembler {
+    private config;
+    constructor(config: ResultAssemblerConfig);
+    completeRun(rootSpan: Span): AsyncGenerator<RunEvent>;
+    completeSession(rootSpan: Span): AsyncGenerator<RunEvent>;
+    handleError(err: unknown, rootSpan: Span): AsyncGenerator<RunEvent>;
+    finalize(): Promise<AgentRun>;
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/runtime/query/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE9C,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,cAAc,CAAA;IAC1B,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;CACxC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,qBAAqB;IAIlC,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IA8BrD,eAAe,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IAIzD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC;IA6BpE,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;CAIpC"}

package/dist/runtime/query/result.js

@@ -0,0 +1,66 @@
+import { SpanStatusCode } from '@opentelemetry/api';
+import { toErrorMessage } from '../../utils/error.js';
+import { GENAI, NAMZU } from '../../telemetry/attributes.js';
+export class ResultAssembler {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async *completeRun(rootSpan) {
+        const { sessionMgr, activityStore, log, emitEvent, drainPending } = this.config;
+        if (sessionMgr.status === 'running') {
+            sessionMgr.markCompleted(sessionMgr.stopReason);
+        }
+        await emitEvent({
+            type: 'run_completed',
+            runId: sessionMgr.id,
+            result: sessionMgr.getRun().result ?? '',
+        });
+        yield* drainPending();
+        rootSpan.setAttributes({
+            [NAMZU.SESSION_STATUS]: sessionMgr.stopReason ?? 'completed',
+            [NAMZU.ITERATION]: sessionMgr.currentIteration,
+            [GENAI.USAGE_INPUT_TOKENS]: sessionMgr.tokenUsage.promptTokens,
+            [GENAI.USAGE_OUTPUT_TOKENS]: sessionMgr.tokenUsage.completionTokens,
+        });
+        rootSpan.setStatus({ code: SpanStatusCode.OK });
+        log.info('Query completed', {
+            runId: sessionMgr.id,
+            iterations: sessionMgr.currentIteration,
+            stopReason: sessionMgr.stopReason,
+            activityStats: activityStore.enabled ? activityStore.stats() : undefined,
+        });
+    }
+    async *completeSession(rootSpan) {
+        yield* this.completeRun(rootSpan);
+    }
+    async *handleError(err, rootSpan) {
+        const { sessionMgr, planManager, log, emitEvent, drainPending } = this.config;
+        const errorMessage = toErrorMessage(err);
+        sessionMgr.markFailed(errorMessage);
+        if (planManager.isActive) {
+            planManager.failPlan(errorMessage);
+        }
+        await emitEvent({
+            type: 'run_failed',
+            runId: sessionMgr.id,
+            error: errorMessage,
+        });
+        yield* drainPending();
+        rootSpan.setAttributes({
+            [NAMZU.SESSION_STATUS]: 'error',
+            [NAMZU.ITERATION]: sessionMgr.currentIteration,
+        });
+        rootSpan.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+        rootSpan.recordException(err instanceof Error ? err : new Error(errorMessage));
+        log.error('Query failed', {
+            runId: sessionMgr.id,
+            error: errorMessage,
+        });
+    }
+    async finalize() {
+        await this.config.sessionMgr.persist();
+        return this.config.sessionMgr.getRun();
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/runtime/query/result.js.map

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

package/dist/runtime/query/tooling.d.ts

@@ -0,0 +1,20 @@
+import type { PermissionMode } from '../../types/permission/index.js';
+import type { RunEvent } from '../../types/run/index.js';
+import type { RunId } from '../../types/ids/index.js';
+import type { ToolRegistry } from '../../registry/tool/execute.js';
+import type { ActivityStore } from '../../store/activity/memory.js';
+import type { Logger } from '../../utils/logger.js';
+import { ToolExecutor } from './executor.js';
+export type EmitEvent = (event: RunEvent) => Promise<void>;
+export interface ToolingBootstrapConfig {
+    tools: ToolRegistry;
+    runId: RunId;
+    workingDirectory: string;
+    permissionMode: PermissionMode;
+    env: Record<string, string>;
+    abortSignal: AbortSignal;
+}
+export declare class ToolingBootstrap {
+    static init(config: ToolingBootstrapConfig, activityStore: ActivityStore, emitEvent: EmitEvent, log: Logger): ToolExecutor;
+}
+//# sourceMappingURL=tooling.d.ts.map

package/dist/runtime/query/tooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tooling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,cAAc,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,IAAI,CACT,MAAM,EAAE,sBAAsB,EAC9B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,GACV,YAAY;CAehB"}

package/dist/runtime/query/tooling.js

@@ -0,0 +1,14 @@
+import { ToolExecutor } from './executor.js';
+export class ToolingBootstrap {
+    static init(config, activityStore, emitEvent, log) {
+        return new ToolExecutor({
+            tools: config.tools,
+            runId: config.runId,
+            workingDirectory: config.workingDirectory,
+            permissionMode: config.permissionMode,
+            env: config.env,
+            abortSignal: config.abortSignal,
+        }, activityStore, emitEvent, log);
+    }
+}
+//# sourceMappingURL=tooling.js.map

package/dist/runtime/query/tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../src/runtime/query/tooling.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAa5C,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,IAAI,CACT,MAA8B,EAC9B,aAA4B,EAC5B,SAAoB,EACpB,GAAW;QAEX,OAAO,IAAI,YAAY,CACrB;YACE,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,EACD,aAAa,EACb,SAAS,EACT,GAAG,CACJ,CAAA;IACH,CAAC;CACF"}

package/dist/session/LimitChecker.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/LimitChecker.js' instead */
+export * from '../run/LimitChecker.js';
+//# sourceMappingURL=LimitChecker.d.ts.map

package/dist/session/LimitChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitChecker.d.ts","sourceRoot":"","sources":["../../src/session/LimitChecker.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,wBAAwB,CAAA"}

package/dist/session/LimitChecker.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/LimitChecker.js' instead */
+export * from '../run/LimitChecker.js';
+//# sourceMappingURL=LimitChecker.js.map

package/dist/session/LimitChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitChecker.js","sourceRoot":"","sources":["../../src/session/LimitChecker.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,wBAAwB,CAAA"}

package/dist/session/index.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/index.js' instead */
+export * from '../run/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,iBAAiB,CAAA"}

package/dist/session/index.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/index.js' instead */
+export * from '../run/index.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,iBAAiB,CAAA"}

package/dist/session/reporter.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/reporter.js' instead */
+export * from '../run/reporter.js';
+//# sourceMappingURL=reporter.d.ts.map

package/dist/session/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/session/reporter.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,oBAAoB,CAAA"}

package/dist/session/reporter.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from '../run/reporter.js' instead */
+export * from '../run/reporter.js';
+//# sourceMappingURL=reporter.js.map

package/dist/session/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/session/reporter.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,oBAAoB,CAAA"}

package/dist/skills/index.d.ts

@@ -0,0 +1,3 @@
+export { loadSkill, discoverSkills } from './loader.js';
+export { SkillRegistry, resolveSkillChain } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/index.js

@@ -0,0 +1,3 @@
+export { loadSkill, discoverSkills } from './loader.js';
+export { SkillRegistry, resolveSkillChain } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,4 @@
+import type { SkillDisclosureLevel, SkillLoadResult } from '../types/skills/index.js';
+export declare function loadSkill(dirPath: string, level?: SkillDisclosureLevel): Promise<SkillLoadResult>;
+export declare function discoverSkills(parentDir: string): Promise<string[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAwB,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AA0G3G,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,GACvC,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBzE"}

package/dist/skills/loader.js

@@ -0,0 +1,126 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { getRootLogger } from '../utils/logger.js';
+const logger = getRootLogger().child({ component: 'SkillLoader' });
+const SKILL_FILENAME = 'SKILL.md';
+const FRONTMATTER_DELIMITER = '---';
+function parseSkillMd(raw, dirPath) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith(FRONTMATTER_DELIMITER)) {
+        throw new Error(`SKILL.md at "${dirPath}" has no YAML frontmatter`);
+    }
+    const endIdx = trimmed.indexOf(FRONTMATTER_DELIMITER, FRONTMATTER_DELIMITER.length);
+    if (endIdx === -1) {
+        throw new Error(`SKILL.md at "${dirPath}" has unclosed frontmatter`);
+    }
+    const frontmatterRaw = trimmed.slice(FRONTMATTER_DELIMITER.length, endIdx).trim();
+    const body = trimmed.slice(endIdx + FRONTMATTER_DELIMITER.length).trim();
+    const metadata = parseFlatYaml(frontmatterRaw, dirPath);
+    return { metadata, body };
+}
+function parseFlatYaml(raw, dirPath) {
+    const lines = raw.split('\n');
+    const kv = {};
+    for (const line of lines) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        kv[key] = value.replace(/^["']|["']$/g, '');
+    }
+    if (!kv['name']) {
+        throw new Error(`SKILL.md at "${dirPath}" missing required field: name`);
+    }
+    if (!kv['description']) {
+        throw new Error(`SKILL.md at "${dirPath}" missing required field: description`);
+    }
+    validateSkillName(kv['name'], dirPath);
+    validateDescription(kv['description'], dirPath);
+    const metadata = {
+        name: kv['name'],
+        description: kv['description'],
+    };
+    if (kv['compatibility']) {
+        if (kv['compatibility'].length > 500) {
+            throw new Error(`SKILL.md at "${dirPath}": compatibility exceeds 500 characters`);
+        }
+        metadata.compatibility = kv['compatibility'];
+    }
+    return metadata;
+}
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function validateSkillName(name, dirPath) {
+    if (name.length > 64) {
+        throw new Error(`SKILL.md at "${dirPath}": name exceeds 64 characters`);
+    }
+    if (!SKILL_NAME_PATTERN.test(name)) {
+        throw new Error(`SKILL.md at "${dirPath}": name "${name}" must be lowercase alphanumeric with hyphens, ` +
+            `no leading/trailing hyphens, no consecutive hyphens`);
+    }
+    const expectedName = basename(dirPath);
+    if (name !== expectedName) {
+        throw new Error(`SKILL.md at "${dirPath}": name "${name}" must match directory name "${expectedName}"`);
+    }
+}
+function validateDescription(description, dirPath) {
+    if (description.length === 0) {
+        throw new Error(`SKILL.md at "${dirPath}": description must not be empty`);
+    }
+    if (description.length > 1024) {
+        throw new Error(`SKILL.md at "${dirPath}": description exceeds 1024 characters`);
+    }
+}
+const CHARS_PER_TOKEN = 4;
+function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+export async function loadSkill(dirPath, level = 'metadata') {
+    const skillMdPath = join(dirPath, SKILL_FILENAME);
+    const raw = await readFile(skillMdPath, 'utf-8');
+    const parsed = parseSkillMd(raw, dirPath);
+    const skill = {
+        metadata: parsed.metadata,
+        dirPath,
+    };
+    if (level === 'full' || level === 'assets') {
+        skill.body = parsed.body;
+    }
+    const metadataTokens = estimateTokens(`${parsed.metadata.name}: ${parsed.metadata.description}`);
+    const bodyTokens = skill.body ? estimateTokens(skill.body) : 0;
+    logger.debug('Loaded skill', {
+        name: parsed.metadata.name,
+        level,
+        tokens: metadataTokens + bodyTokens,
+    });
+    return {
+        skill,
+        disclosureLevel: level,
+        tokenEstimate: metadataTokens + bodyTokens,
+    };
+}
+export async function discoverSkills(parentDir) {
+    const dirs = [];
+    try {
+        const entries = await readdir(parentDir);
+        for (const entry of entries) {
+            if (entry.startsWith('.') || entry.startsWith('_'))
+                continue;
+            const fullPath = join(parentDir, entry);
+            const s = await stat(fullPath);
+            if (!s.isDirectory())
+                continue;
+            const skillMdPath = join(fullPath, SKILL_FILENAME);
+            try {
+                await stat(skillMdPath);
+                dirs.push(fullPath);
+            }
+            catch { }
+        }
+    }
+    catch {
+        logger.debug('Skills directory not found', { parentDir });
+    }
+    return dirs;
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/registry.d.ts

@@ -0,0 +1,13 @@
+import type { Skill, SkillChain, SkillDisclosureLevel, SkillLoadResult } from '../types/skills/index.js';
+export declare class SkillRegistry {
+    private skills;
+    register(dirPath: string, level?: SkillDisclosureLevel): Promise<Skill>;
+    registerAll(parentDir: string, level?: SkillDisclosureLevel): Promise<Skill[]>;
+    get(name: string): Skill | undefined;
+    load(name: string, level?: SkillDisclosureLevel): Promise<SkillLoadResult | undefined>;
+    list(): Skill[];
+    get size(): number;
+    has(name: string): boolean;
+}
+export declare function resolveSkillChain(categorySkillsDir: string | undefined, agentSkillsDir: string | undefined, level?: SkillDisclosureLevel): Promise<SkillChain>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/skills/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAMxG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA2B;IAEnC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,oBAAiC,GAAG,OAAO,CAAC,KAAK,CAAC;IAMnF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,oBAAiC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAkBhG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,oBAA6B,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAiBpG,IAAI,IAAI,KAAK,EAAE;IAIf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B;AAED,wBAAsB,iBAAiB,CACrC,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,GAAE,oBAAiC,GACvC,OAAO,CAAC,UAAU,CAAC,CA8BrB"}