@namzu/sdk 0.1.1

package/dist/registry/tool/execute.js

@@ -0,0 +1,240 @@
+import { SpanStatusCode } from "@opentelemetry/api";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { getTracer } from "../../provider/telemetry/setup.js";
+import { GENAI, NAMZU, toolSpanName } from "../../telemetry/attributes.js";
+import { toErrorMessage } from "../../utils/error.js";
+import { getRootLogger } from "../../utils/logger.js";
+import { Registry } from "../Registry.js";
+export class ToolRegistry extends Registry {
+    log;
+    availability = new Map();
+    constructor(config) {
+        super();
+        this.log = (config?.logger ?? getRootLogger()).child({
+            component: "ToolRegistry",
+        });
+    }
+    register(idOrToolOrTools, maybeTool) {
+        if (Array.isArray(idOrToolOrTools)) {
+            const state = (typeof maybeTool === "string" ? maybeTool : "active");
+            for (const tool of idOrToolOrTools) {
+                this.registerOne(tool.name, tool, state);
+            }
+            return;
+        }
+        const tool = typeof idOrToolOrTools === "string"
+            ? maybeTool
+            : idOrToolOrTools;
+        const id = typeof idOrToolOrTools === "string" ? idOrToolOrTools : tool.name;
+        const state = typeof maybeTool === "string" ? maybeTool : "active";
+        this.registerOne(id, tool, state);
+    }
+    registerOne(id, tool, state) {
+        if (this.has(id)) {
+            this.log.warn(`Tool "${id}" is already registered, overwriting.`);
+        }
+        super.register(id, tool);
+        this.availability.set(id, state);
+        this.log.info(`Tool registered: ${id} (${state})`);
+    }
+    unregister(id) {
+        this.availability.delete(id);
+        return super.unregister(id);
+    }
+    clear() {
+        this.availability.clear();
+        super.clear();
+    }
+    activate(names) {
+        for (const name of names) {
+            this.getOrThrow(name);
+            this.availability.set(name, "active");
+            this.log.debug(`Tool activated: ${name}`);
+        }
+    }
+    defer(names) {
+        for (const name of names) {
+            this.getOrThrow(name);
+            this.availability.set(name, "deferred");
+            this.log.debug(`Tool deferred: ${name}`);
+        }
+    }
+    suspendAll() {
+        for (const name of this.listIds()) {
+            if (this.getAvailability(name) === "active") {
+                this.availability.set(name, "suspended");
+            }
+        }
+        this.log.info("All active tools suspended");
+    }
+    hasSuspended() {
+        for (const state of this.availability.values()) {
+            if (state === "suspended")
+                return true;
+        }
+        return false;
+    }
+    getAvailability(name) {
+        return this.availability.get(name) ?? "active";
+    }
+    searchDeferred(query) {
+        const q = query.toLowerCase();
+        return this.getByAvailability(["deferred"]).filter((t) => t.name.toLowerCase().includes(q) ||
+            t.description.toLowerCase().includes(q));
+    }
+    getOrThrow(name) {
+        const tool = this.get(name);
+        if (!tool) {
+            throw new Error(`Tool not found: "${name}". Available tools: ${this.listIds().join(", ")}`);
+        }
+        return tool;
+    }
+    listNames() {
+        return this.listIds();
+    }
+    toPromptSection(toolNames) {
+        const active = this.getByAvailability(["active"], toolNames);
+        const deferred = this.getByAvailability(["deferred"], toolNames);
+        const parts = [];
+        if (active.length > 0) {
+            const entries = active
+                .map((t) => `- ${t.name}: ${t.description}`)
+                .join("\n");
+            parts.push(`<available_tools>\n${entries}\n</available_tools>`);
+        }
+        if (deferred.length > 0) {
+            const entries = deferred.map((t) => `- ${t.name}`).join("\n");
+            parts.push(`<deferred_tools>\nUse search_tools to load these before use:\n${entries}\n</deferred_tools>`);
+        }
+        if (parts.length === 0)
+            return "";
+        return parts.join("\n\n");
+    }
+    toLLMTools(toolNames) {
+        const toolsToConvert = this.getByAvailability(["active", "suspended"], toolNames);
+        return toolsToConvert.map((tool) => ({
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: zodToJsonSchema(tool.inputSchema, {
+                    target: "jsonSchema7",
+                    $refStrategy: "none",
+                }),
+            },
+        }));
+    }
+    getCallableTools(toolNames) {
+        return this.getByAvailability(["active"], toolNames);
+    }
+    async execute(toolName, rawInput, context) {
+        const tracer = getTracer();
+        return tracer.startActiveSpan(toolSpanName(toolName), async (span) => {
+            span.setAttributes({
+                [GENAI.TOOL_NAME]: toolName,
+                [GENAI.TOOL_TYPE]: "function",
+            });
+            const tool = this.getOrThrow(toolName);
+            const availability = this.getAvailability(toolName);
+            if (availability !== "active") {
+                const msg = `Tool "${toolName}" is ${availability} and cannot be executed`;
+                this.log.warn(msg);
+                span.setAttributes({
+                    [NAMZU.TOOL_SUCCESS]: false,
+                    [NAMZU.TOOL_ERROR]: msg,
+                });
+                span.setStatus({ code: SpanStatusCode.ERROR, message: msg });
+                span.end();
+                return {
+                    success: false,
+                    output: "",
+                    error: msg,
+                };
+            }
+            const mode = context.permissionContext?.mode ?? "auto";
+            if (mode === "plan") {
+                const isReadOnly = tool.isReadOnly ? tool.isReadOnly(rawInput) : false;
+                if (!isReadOnly) {
+                    const msg = `plan mode: non-read-only tool "${toolName}" blocked`;
+                    span.setAttributes({
+                        [NAMZU.TOOL_SUCCESS]: false,
+                        [NAMZU.TOOL_ERROR]: msg,
+                    });
+                    span.setStatus({ code: SpanStatusCode.ERROR, message: msg });
+                    span.end();
+                    return {
+                        success: false,
+                        output: "",
+                        error: msg,
+                        permissionDenied: true,
+                        permissionMessage: msg,
+                    };
+                }
+            }
+            const parseResult = tool.inputSchema.safeParse(rawInput);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.issues
+                    .map((i) => `${i.path.join(".")}: ${i.message}`)
+                    .join("; ");
+                this.log.error(`Tool input validation failed: ${toolName}`, {
+                    errors: errorMessage,
+                });
+                span.setAttributes({
+                    [NAMZU.TOOL_SUCCESS]: false,
+                    [NAMZU.TOOL_ERROR]: `Validation: ${errorMessage}`,
+                });
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+                span.end();
+                return {
+                    success: false,
+                    output: "",
+                    error: `Invalid input for tool "${toolName}": ${errorMessage}`,
+                };
+            }
+            const finalInput = parseResult.data;
+            try {
+                this.log.debug(`Executing tool: ${toolName}`);
+                const result = await tool.execute(finalInput, context);
+                this.log.debug(`Tool completed: ${toolName}`, {
+                    success: result.success,
+                });
+                span.setAttribute(NAMZU.TOOL_SUCCESS, result.success);
+                if (!result.success && result.error) {
+                    span.setAttribute(NAMZU.TOOL_ERROR, result.error);
+                    span.setStatus({ code: SpanStatusCode.ERROR, message: result.error });
+                }
+                else {
+                    span.setStatus({ code: SpanStatusCode.OK });
+                }
+                return result;
+            }
+            catch (err) {
+                const errorMessage = toErrorMessage(err);
+                this.log.error(`Tool execution error: ${toolName}`, {
+                    error: errorMessage,
+                });
+                span.setAttributes({
+                    [NAMZU.TOOL_SUCCESS]: false,
+                    [NAMZU.TOOL_ERROR]: errorMessage,
+                });
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+                span.recordException(err instanceof Error ? err : new Error(errorMessage));
+                return {
+                    success: false,
+                    output: "",
+                    error: `Tool "${toolName}" execution failed: ${errorMessage}`,
+                };
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    getByAvailability(states, filter) {
+        const candidates = filter
+            ? filter.map((n) => this.getOrThrow(n))
+            : this.getAll();
+        return candidates.filter((t) => states.includes(this.getAvailability(t.name)));
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/registry/tool/execute.js.map

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

package/dist/run/LimitChecker.d.ts

@@ -0,0 +1,21 @@
+import type { StopReason, LimitCheckerConfig } from '../types/run/index.js';
+export interface LimitCheckerState {
+    aborted: boolean;
+    totalTokens: number;
+    totalCost: number;
+    currentIteration: number;
+    startTime: number;
+}
+export type LimitCheckResult = {
+    type: 'ok';
+} | {
+    type: 'warning';
+    reason: StopReason;
+} | {
+    type: 'hard_stop';
+    reason: StopReason;
+};
+export declare function checkLimits(config: LimitCheckerConfig, state: LimitCheckerState): StopReason | null;
+export declare function checkLimitsDetailed(config: LimitCheckerConfig, state: LimitCheckerState): LimitCheckResult;
+export declare function buildLimitConfig(tokenBudget: number, timeoutMs: number, costLimitUsd?: number, maxIterations?: number, budgetWarningThreshold?: number): LimitCheckerConfig;
+//# sourceMappingURL=LimitChecker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitChecker.d.ts","sourceRoot":"","sources":["../../src/run/LimitChecker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAA;AAE7C,wBAAgB,WAAW,CACzB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,iBAAiB,GACvB,UAAU,GAAG,IAAI,CAInB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,iBAAiB,GACvB,gBAAgB,CA0ClB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,sBAAsB,CAAC,EAAE,MAAM,GAC9B,kBAAkB,CAQpB"}

package/dist/run/LimitChecker.js

@@ -0,0 +1,51 @@
+export function checkLimits(config, state) {
+    const result = checkLimitsDetailed(config, state);
+    if (result.type === 'ok')
+        return null;
+    return result.reason;
+}
+export function checkLimitsDetailed(config, state) {
+    if (state.aborted) {
+        return { type: 'hard_stop', reason: 'cancelled' };
+    }
+    if (Date.now() - state.startTime > config.timeoutMs) {
+        return { type: 'hard_stop', reason: 'timeout' };
+    }
+    if (config.tokenBudget > 0 && state.totalTokens >= config.tokenBudget) {
+        return { type: 'hard_stop', reason: 'token_budget' };
+    }
+    if (config.costLimitUsd && config.costLimitUsd > 0 && state.totalCost >= config.costLimitUsd) {
+        return { type: 'hard_stop', reason: 'cost_limit' };
+    }
+    if (state.currentIteration >= config.maxIterations) {
+        return { type: 'hard_stop', reason: 'max_iterations' };
+    }
+    if (config.tokenBudget > 0) {
+        const usageRatio = state.totalTokens / config.tokenBudget;
+        if (usageRatio >= config.budgetWarningThreshold) {
+            return { type: 'warning', reason: 'token_budget' };
+        }
+    }
+    if (config.costLimitUsd && config.costLimitUsd > 0) {
+        const costRatio = state.totalCost / config.costLimitUsd;
+        if (costRatio >= config.budgetWarningThreshold) {
+            return { type: 'warning', reason: 'cost_limit' };
+        }
+    }
+    const timeElapsed = Date.now() - state.startTime;
+    const timeRatio = timeElapsed / config.timeoutMs;
+    if (timeRatio >= config.budgetWarningThreshold) {
+        return { type: 'warning', reason: 'timeout' };
+    }
+    return { type: 'ok' };
+}
+export function buildLimitConfig(tokenBudget, timeoutMs, costLimitUsd, maxIterations, budgetWarningThreshold) {
+    return {
+        tokenBudget,
+        timeoutMs,
+        costLimitUsd,
+        maxIterations: maxIterations ?? 200,
+        budgetWarningThreshold: budgetWarningThreshold ?? 0.9,
+    };
+}
+//# sourceMappingURL=LimitChecker.js.map

package/dist/run/LimitChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitChecker.js","sourceRoot":"","sources":["../../src/run/LimitChecker.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,WAAW,CACzB,MAA0B,EAC1B,KAAwB;IAExB,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACjD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA0B,EAC1B,KAAwB;IAExB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IACnD,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACtE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7F,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;QACzD,IAAI,UAAU,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACpD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,CAAA;QACvD,IAAI,SAAS,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;QAClD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAA;IAChD,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC,SAAS,CAAA;IAChD,IAAI,SAAS,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAC/C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,SAAiB,EACjB,YAAqB,EACrB,aAAsB,EACtB,sBAA+B;IAE/B,OAAO;QACL,WAAW;QACX,SAAS;QACT,YAAY;QACZ,aAAa,EAAE,aAAa,IAAI,GAAG;QACnC,sBAAsB,EAAE,sBAAsB,IAAI,GAAG;KACtD,CAAA;AACH,CAAC"}

package/dist/run/index.d.ts

@@ -0,0 +1,7 @@
+export { RunPersistence, SessionManager } from '../manager/run/persistence.js';
+export { RunDiskStore, SessionStore } from '../store/run/disk.js';
+export { createRunReporter, createSessionReporter } from './reporter.js';
+export type { RunReporter, SessionReporter } from './reporter.js';
+export { checkLimitsDetailed, buildLimitConfig } from './LimitChecker.js';
+export type { LimitCheckerState, LimitCheckResult } from './LimitChecker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACxE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEjE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/run/index.js

@@ -0,0 +1,5 @@
+export { RunPersistence, SessionManager } from '../manager/run/persistence.js';
+export { RunDiskStore, SessionStore } from '../store/run/disk.js';
+export { createRunReporter, createSessionReporter } from './reporter.js';
+export { checkLimitsDetailed, buildLimitConfig } from './LimitChecker.js';
+//# sourceMappingURL=index.js.map

package/dist/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAGxE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/run/reporter.d.ts

@@ -0,0 +1,10 @@
+import type { AgentRun, RunEventListener } from "../types/run/index.js";
+import { type Logger } from "../utils/logger.js";
+export interface RunReporter {
+    listener: RunEventListener;
+    summary(run: AgentRun): void;
+}
+export type SessionReporter = RunReporter;
+export declare function createRunReporter(parentLogger?: Logger): RunReporter;
+export declare const createSessionReporter: typeof createRunReporter;
+//# sourceMappingURL=reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/run/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,QAAQ,EAER,gBAAgB,EAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAWhE,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAoKpE;AAED,eAAO,MAAM,qBAAqB,0BAAoB,CAAC"}

package/dist/run/reporter.js

@@ -0,0 +1,157 @@
+import { formatCost } from "../utils/cost.js";
+import { getRootLogger } from "../utils/logger.js";
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${minutes}m ${remainingSeconds}s`;
+}
+export function createRunReporter(parentLogger) {
+    const log = (parentLogger ?? getRootLogger()).child({
+        component: "RunReporter",
+    });
+    const listener = (event) => {
+        switch (event.type) {
+            case "run_started":
+                log.info("Run started", {
+                    runId: event.runId,
+                    hasSystemPrompt: !!event.systemPrompt,
+                    systemPromptLength: event.systemPrompt?.length ?? 0,
+                });
+                break;
+            case "iteration_started":
+                log.info(`Iteration ${event.iteration} started`, {
+                    runId: event.runId,
+                    iteration: event.iteration,
+                });
+                break;
+            case "iteration_completed":
+                log.info(`Iteration ${event.iteration} completed`, {
+                    runId: event.runId,
+                    iteration: event.iteration,
+                    hasToolCalls: event.hasToolCalls,
+                });
+                break;
+            case "tool_executing":
+                log.info(`Tool executing: ${event.toolName}`, {
+                    runId: event.runId,
+                    tool: event.toolName,
+                });
+                break;
+            case "tool_completed":
+                log.info(`Tool completed: ${event.toolName}`, {
+                    runId: event.runId,
+                    tool: event.toolName,
+                });
+                break;
+            case "llm_response":
+                log.info("LLM response received", {
+                    runId: event.runId,
+                    hasToolCalls: event.hasToolCalls,
+                });
+                break;
+            case "token_usage_updated":
+                log.info("Token usage updated", {
+                    runId: event.runId,
+                    promptTokens: event.usage.promptTokens,
+                    completionTokens: event.usage.completionTokens,
+                    totalTokens: event.usage.totalTokens,
+                    totalCost: event.cost.totalCost,
+                });
+                break;
+            case "run_completed":
+                log.info("Run completed", { runId: event.runId });
+                break;
+            case "run_failed":
+                log.error("Run failed", {
+                    runId: event.runId,
+                    error: event.error,
+                });
+                break;
+            case "activity_created":
+            case "activity_updated":
+            case "plan_ready":
+            case "plan_approved":
+            case "plan_rejected":
+            case "plan_step_updated":
+            case "tool_review_requested":
+            case "tool_review_completed":
+            case "checkpoint_created":
+            case "run_paused":
+            case "run_resuming":
+                break;
+            case "agent_pending":
+                log.info(`Agent task pending: ${event.childAgentId}`, {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                    parentAgentId: event.parentAgentId,
+                    childAgentId: event.childAgentId,
+                    depth: event.depth,
+                });
+                break;
+            case "agent_completed":
+                log.info("Agent task completed", {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                    status: event.result.status,
+                    iterations: event.result.iterations,
+                });
+                break;
+            case "agent_failed":
+                log.error("Agent task failed", {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                    error: event.error,
+                });
+                break;
+            case "agent_canceled":
+                log.info("Agent task canceled", {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                });
+                break;
+            case "task_created":
+                log.info(`Task created: ${event.subject}`, {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                    status: event.status,
+                });
+                break;
+            case "task_updated":
+                log.info(`Task updated: ${event.subject}`, {
+                    runId: event.runId,
+                    taskId: event.taskId,
+                    status: event.status,
+                    owner: event.owner,
+                });
+                break;
+            default: {
+                const _exhaustive = event;
+                throw new Error(`Unhandled run event type: ${_exhaustive.type}`);
+            }
+        }
+    };
+    function summary(run) {
+        const elapsed = (run.endedAt ?? Date.now()) - run.startedAt;
+        const { tokenUsage, costInfo, currentIteration, stopReason } = run;
+        log.info("Run summary", {
+            runId: run.id,
+            agent: run.metadata.agentName,
+            status: run.status,
+            stopReason: stopReason ?? "unknown",
+            iterations: currentIteration,
+            promptTokens: tokenUsage.promptTokens,
+            completionTokens: tokenUsage.completionTokens,
+            totalTokens: tokenUsage.totalTokens,
+            cost: formatCost(costInfo.totalCost),
+            duration: formatDuration(elapsed),
+        });
+    }
+    return { listener, summary };
+}
+export const createSessionReporter = createRunReporter;
+//# sourceMappingURL=reporter.js.map

package/dist/run/reporter.js.map

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

package/dist/runtime/decision/fallback.d.ts

@@ -0,0 +1,11 @@
+import type { FallbackStrategy } from '../../types/decision/index.js';
+import type { RoutingDecision } from '../../types/agent/router.js';
+import type { Logger } from '../../utils/logger.js';
+export declare class FallbackResolver {
+    private strategies;
+    private log;
+    constructor(strategies: FallbackStrategy[], log: Logger);
+    resolve(userContent: string, validAgentIds: string[]): RoutingDecision;
+    private matchPatterns;
+}
+//# sourceMappingURL=fallback.d.ts.map

package/dist/runtime/decision/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/runtime/decision/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,GAAG,CAAQ;gBAEP,UAAU,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,MAAM;IAKvD,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,eAAe;IAyDtE,OAAO,CAAC,aAAa;CAsBtB"}

package/dist/runtime/decision/fallback.js

@@ -0,0 +1,80 @@
+export class FallbackResolver {
+    strategies;
+    log;
+    constructor(strategies, log) {
+        this.strategies = strategies;
+        this.log = log;
+    }
+    resolve(userContent, validAgentIds) {
+        for (const strategy of this.strategies) {
+            switch (strategy.type) {
+                case 'pattern_match': {
+                    const match = this.matchPatterns(userContent, strategy.patterns);
+                    if (match && validAgentIds.includes(match)) {
+                        this.log.info('Fallback resolved via pattern match', { agentId: match });
+                        return {
+                            agentId: match,
+                            confidence: 0.5,
+                            reasoning: `Pattern match fallback: matched "${match}"`,
+                            routingSource: 'fallback',
+                        };
+                    }
+                    break;
+                }
+                case 'fixed': {
+                    if (validAgentIds.includes(strategy.agentId)) {
+                        this.log.info('Fallback resolved via fixed strategy', { agentId: strategy.agentId });
+                        return {
+                            agentId: strategy.agentId,
+                            confidence: 0,
+                            reasoning: 'Fixed fallback strategy',
+                            routingSource: 'fallback',
+                        };
+                    }
+                    break;
+                }
+                case 'first_route': {
+                    if (validAgentIds.length > 0) {
+                        const first = validAgentIds[0];
+                        this.log.info('Fallback resolved via first_route strategy', { agentId: first });
+                        return {
+                            agentId: first,
+                            confidence: 0,
+                            reasoning: 'First route fallback strategy',
+                            routingSource: 'fallback',
+                        };
+                    }
+                    break;
+                }
+                default: {
+                    const _exhaustive = strategy;
+                    throw new Error(`Unhandled fallback strategy: ${_exhaustive.type}`);
+                }
+            }
+        }
+        this.log.error('All fallback strategies exhausted');
+        return {
+            agentId: validAgentIds[0] ?? '',
+            confidence: 0,
+            reasoning: 'All fallback strategies exhausted',
+            routingSource: 'hard_fail',
+        };
+    }
+    matchPatterns(userContent, patterns) {
+        const lower = userContent.toLowerCase();
+        let bestMatch = null;
+        for (const [agentId, keywords] of patterns) {
+            let score = 0;
+            for (const keyword of keywords) {
+                if (lower.includes(keyword.toLowerCase())) {
+                    score++;
+                }
+            }
+            if (score > 0 && (!bestMatch || score > bestMatch.score)) {
+                bestMatch = { agentId, score };
+            }
+        }
+        return bestMatch?.agentId ?? null;
+    }
+}
+//# sourceMappingURL=fallback.js.map

package/dist/runtime/decision/fallback.js.map

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