@namzu/sdk 45.1.0 → 48.0.0

package/dist/agents/QueryAgent.js

@@ -0,0 +1,214 @@
+import { drainQuery } from '../runtime/query/index.js';
+import { AbstractAgent } from './AbstractAgent.js';
+import { pickRoutedOptions } from './forward-options.js';
+/** Every config field has one destination, or a deliberately explicit transform. */
+const configRoutes = {
+    model: 'turn',
+    tokenBudget: 'turn',
+    budget: 'query',
+    timeoutMs: 'turn',
+    streamIdleTimeoutMs: 'turn',
+    maxRequestRichContentBytes: 'turn',
+    attachmentResolveTimeoutMs: 'query',
+    maxIterations: 'turn',
+    temperature: 'turn',
+    maxResponseTokens: 'turn',
+    costLimitUsd: 'turn',
+    permissionMode: 'turn',
+    pruneKeepLast: 'turn',
+    paths: 'query',
+    sessionLog: 'query',
+    checkpointStore: 'query',
+    sandbox: 'turn',
+    inboundMessages: 'query',
+    projectInstructionContext: 'query',
+    allowedTools: 'special',
+    toolResultGuardrails: 'query',
+    deniedTools: 'special',
+    persona: 'query',
+    logger: 'special',
+    env: 'turn',
+    thinking: 'turn',
+    effort: 'turn',
+    idempotencyKey: 'special',
+    projectId: 'special',
+    topicId: 'special',
+    sessionId: 'special',
+    tenantId: 'special',
+    parentSessionId: 'query',
+    parentTurnId: 'query',
+    depth: 'query',
+    contextLevel: 'query',
+    invocationState: 'query',
+    parentSpan: 'query',
+    resumeHandler: 'query',
+    reviewAllowedCalls: 'query',
+    systemPrompt: 'query',
+    webSearch: 'turn',
+    steering: 'query',
+    skills: 'query',
+    basePrompt: 'query',
+    provider: 'query',
+    toolsets: 'query',
+    advisory: 'query',
+    authorizationGate: 'query',
+    sandboxProvider: 'query',
+    sandboxTeardownTimeoutMs: 'query',
+    outsideRootAccess: 'query',
+    sandboxEscape: 'query',
+    compactionConfig: 'query',
+    workingMemoryProvider: 'query',
+    retry: 'query',
+    toolTimeoutMs: 'query',
+    toolRetryBackoff: 'query',
+    maxToolConcurrency: 'query',
+    maxToolOutputChars: 'query',
+    retainedToolPreviewChars: 'query',
+    maxToolContentBytes: 'query',
+    repairToolCall: 'query',
+    stopWhen: 'query',
+    onStepFinish: 'query',
+    prepareStep: 'query',
+    beforeStep: 'query',
+    structuredOutput: 'query',
+    inputGuardrails: 'query',
+    outputGuardrails: 'query',
+};
+const SCOPE_FIELDS = ['sessionId', 'topicId', 'projectId', 'tenantId'];
+function invocationScope(input, config) {
+    if (input.managedScope !== undefined) {
+        const scope = input.managedScope;
+        if (typeof scope !== 'object' ||
+            scope === null ||
+            Array.isArray(scope) ||
+            scope.kind !== 'managed') {
+            throw new Error('QueryAgent requires a managed invocation scope.');
+        }
+        const missing = SCOPE_FIELDS.filter((field) => typeof scope[field] !== 'string' || scope[field].trim().length === 0);
+        if (missing.length > 0) {
+            throw new Error(`QueryAgent: input.managedScope is missing: ${missing.join(', ')}.`);
+        }
+        const conflicts = SCOPE_FIELDS.filter((field) => config[field] !== undefined && config[field] !== scope[field]);
+        if (conflicts.length > 0) {
+            throw new Error(`QueryAgent: input.managedScope conflicts with legacy config fields: ${conflicts.join(', ')}.`);
+        }
+        return scope;
+    }
+    if (!config.sessionId || !config.topicId || !config.projectId || !config.tenantId) {
+        throw new Error('QueryAgent requires sessionId, topicId, projectId, and tenantId in input.managedScope or legacy config.');
+    }
+    const invalid = SCOPE_FIELDS.filter((field) => {
+        const value = config[field];
+        return typeof value !== 'string' || value.trim().length === 0;
+    });
+    if (invalid.length > 0) {
+        throw new Error(`QueryAgent: legacy config has invalid scope fields: ${invalid.join(', ')}.`);
+    }
+    return {
+        kind: 'managed',
+        sessionId: config.sessionId,
+        topicId: config.topicId,
+        projectId: config.projectId,
+        tenantId: config.tenantId,
+    };
+}
+export class QueryAgent extends AbstractAgent {
+    type;
+    constructor(metadata, log) {
+        super({
+            ...metadata,
+            type: metadata.type,
+            capabilities: {
+                supportsTools: true,
+                supportsStreaming: true,
+                supportsConcurrency: false,
+                supportsSubAgents: false,
+            },
+        }, log);
+        this.type = metadata.type;
+    }
+    /**
+     * One turn at a time per instance.
+     *
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
+     * A host that wants parallelism constructs a second instance.
+     */
+    async run(input, config, listener) {
+        // Resolve before deduplication: an invalid or conflicting scope must never
+        // receive another caller's in-flight result under the same raw key.
+        const scope = invocationScope(input, config);
+        const scopedKey = config.idempotencyKey
+            ? JSON.stringify([
+                scope.kind,
+                scope.tenantId,
+                scope.projectId,
+                scope.topicId,
+                scope.sessionId,
+                config.idempotencyKey,
+            ])
+            : undefined;
+        return await this.underIdempotencyKey(scopedKey, () => this.underInvocationLock(() => this.runExclusive(input, config, scope, listener)));
+    }
+    async runExclusive(input, config, scope, listener) {
+        const startTime = Date.now();
+        const turnId = this.createTurnId();
+        this.bindTurn(scope.sessionId, turnId, config.logger);
+        const queryFields = pickRoutedOptions(config, configRoutes, 'query');
+        const turnFields = pickRoutedOptions(config, configRoutes, 'turn');
+        const turn = await drainQuery({
+            ...queryFields,
+            ...(input.attachmentStore ? { attachmentStore: input.attachmentStore } : {}),
+            ...(config.allowedTools ? { allowedTools: [...config.allowedTools] } : {}),
+            ...(config.deniedTools ? { deniedTools: [...config.deniedTools] } : {}),
+            turnConfig: {
+                ...turnFields,
+                logger: this.log,
+            },
+            agentId: this.metadata.id,
+            agentName: this.metadata.name,
+            workingDirectory: input.workingDirectory,
+            sessionId: scope.sessionId,
+            topicId: scope.topicId,
+            projectId: scope.projectId,
+            tenantId: scope.tenantId,
+            turnId,
+            messages: input.messages,
+            signal: input.signal,
+            taskStore: input.taskStore,
+            runtimeToolOverrides: input.runtimeToolOverrides,
+            runtimeContext: input.runtimeContext,
+        }, listener);
+        let toolCallCount = 0;
+        for (const msg of turn.messages) {
+            if (msg.role === 'assistant') {
+                const assistantMsg = msg;
+                if (assistantMsg.toolCalls) {
+                    toolCallCount += assistantMsg.toolCalls.length;
+                }
+            }
+        }
+        return {
+            sessionId: turn.sessionId,
+            turnId: turn.id,
+            status: turn.status,
+            stopReason: turn.stopReason,
+            usage: turn.tokenUsage,
+            ...(turn.budget ? { budget: turn.budget } : {}),
+            cost: turn.costInfo,
+            iterations: turn.currentIteration,
+            durationMs: Date.now() - startTime,
+            messages: turn.messages,
+            result: turn.result,
+            structuredOutput: turn.structuredOutput,
+            lastError: turn.lastError,
+            toolCallCount,
+        };
+    }
+    async cancel() {
+        this.abortController.abort();
+    }
+}
+//# sourceMappingURL=QueryAgent.js.map

package/dist/agents/QueryAgent.js.map

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

package/dist/agents/ReactiveAgent.d.ts

@@ -1,21 +1,9 @@
-import type { AgentInput, AgentMetadata, ReactiveAgentConfig, ReactiveAgentResult } from '../types/agent/index.js';
-import type { SessionEventListener } from '../types/session/events.js';
+import type { AgentMetadata } from '../types/agent/index.js';
 import type { Logger } from '../utils/logger.js';
-import { AbstractAgent } from './AbstractAgent.js';
-export declare class ReactiveAgent extends AbstractAgent<ReactiveAgentConfig, ReactiveAgentResult> {
+import { QueryAgent } from './QueryAgent.js';
+/** @deprecated Use QueryAgent for a generic query turn or define an application agent. */
+export declare class ReactiveAgent extends QueryAgent {
     readonly type: "reactive";
     constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
-    /**
-     * One turn at a time per instance.
-     *
-     * `abortController` and `currentSessionId` are instance state, so two
-     * overlapping turns share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's session, so a later
-     * `cancel()` cancels the wrong children. Neither failure announces itself.
-     * A host that wants parallelism constructs a second instance.
-     */
-    run(input: AgentInput, config: ReactiveAgentConfig, listener?: SessionEventListener): Promise<ReactiveAgentResult>;
-    private runExclusive;
-    cancel(): Promise<void>;
 }
 //# sourceMappingURL=ReactiveAgent.d.ts.map

package/dist/agents/ReactiveAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactiveAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;IAwKX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}
+{"version":3,"file":"ReactiveAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,0FAA0F;AAC1F,qBAAa,aAAc,SAAQ,UAAU;IAC5C,SAAkB,IAAI,EAAG,UAAU,CAAS;gBAEhC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;CAGhF"}

package/dist/agents/ReactiveAgent.js

@@ -1,188 +1,9 @@
-import { drainQuery } from '../runtime/query/index.js';
-import { AbstractAgent } from './AbstractAgent.js';
-export class ReactiveAgent extends AbstractAgent {
+import { QueryAgent } from './QueryAgent.js';
+/** @deprecated Use QueryAgent for a generic query turn or define an application agent. */
+export class ReactiveAgent extends QueryAgent {
     type = 'reactive';
     constructor(metadata, log) {
-        super({
-            ...metadata,
-            type: 'reactive',
-            capabilities: {
-                supportsTools: true,
-                supportsStreaming: true,
-                supportsConcurrency: false,
-                supportsSubAgents: false,
-            },
-        }, log);
-    }
-    /**
-     * One turn at a time per instance.
-     *
-     * `abortController` and `currentSessionId` are instance state, so two
-     * overlapping turns share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's session, so a later
-     * `cancel()` cancels the wrong children. Neither failure announces itself.
-     * A host that wants parallelism constructs a second instance.
-     */
-    async run(input, config, listener) {
-        return await this.underIdempotencyKey(config.idempotencyKey, () => this.underInvocationLock(() => this.runExclusive(input, config, listener)));
-    }
-    async runExclusive(input, config, listener) {
-        const startTime = Date.now();
-        if (!config.sessionId || !config.topicId || !config.projectId || !config.tenantId) {
-            throw new Error('ReactiveAgent requires sessionId, topicId, projectId, and tenantId in config (session-hierarchy.md §12.1).');
-        }
-        const turnId = this.createTurnId();
-        this.bindTurn(config.sessionId, turnId, config.logger);
-        const turn = await drainQuery({
-            systemPrompt: config.systemPrompt,
-            persona: config.persona,
-            skills: config.skills,
-            basePrompt: config.basePrompt,
-            provider: config.provider,
-            ...(config.budget ? { budget: config.budget } : {}),
-            tools: config.tools,
-            ...(input.attachmentStore ? { attachmentStore: input.attachmentStore } : {}),
-            ...(config.attachmentResolveTimeoutMs !== undefined
-                ? { attachmentResolveTimeoutMs: config.attachmentResolveTimeoutMs }
-                : {}),
-            ...(config.authorizationGate ? { authorizationGate: config.authorizationGate } : {}),
-            ...(config.sandboxProvider ? { sandboxProvider: config.sandboxProvider } : {}),
-            ...(config.sandboxTeardownTimeoutMs !== undefined
-                ? { sandboxTeardownTimeoutMs: config.sandboxTeardownTimeoutMs }
-                : {}),
-            ...(config.outsideRootAccess ? { outsideRootAccess: config.outsideRootAccess } : {}),
-            ...(config.sandboxEscape ? { sandboxEscape: config.sandboxEscape } : {}),
-            // Working-memory / compaction seam (optional; absent => unchanged run path).
-            ...(config.compactionConfig ? { compactionConfig: config.compactionConfig } : {}),
-            ...(config.workingMemoryProvider
-                ? { workingMemoryProvider: config.workingMemoryProvider }
-                : {}),
-            // Loop-control and resilience seams. These lived on
-            // `QueryParams` and stopped there, so every one of them was
-            // unreachable for a consumer using the Agent classes — which is
-            // what `AgentManager` spawns and what the estate's own
-            // applications call. A feature a consumer cannot reach is a
-            // feature that does not exist for them.
-            ...(config.resumeHandler ? { resumeHandler: config.resumeHandler } : {}),
-            // The switch that sends rule-allowed and grant-covered batches to
-            // that handler (plan mode). A delegated child inherits it from the
-            // manager; dropped here, the child would run them past the handler.
-            ...(config.reviewAllowedCalls ? { reviewAllowedCalls: config.reviewAllowedCalls } : {}),
-            ...(config.retry !== undefined ? { retry: config.retry } : {}),
-            ...(config.toolTimeoutMs !== undefined ? { toolTimeoutMs: config.toolTimeoutMs } : {}),
-            ...(config.toolRetryBackoff !== undefined
-                ? { toolRetryBackoff: config.toolRetryBackoff }
-                : {}),
-            ...(config.maxToolConcurrency !== undefined
-                ? { maxToolConcurrency: config.maxToolConcurrency }
-                : {}),
-            ...(config.maxToolOutputChars !== undefined
-                ? { maxToolOutputChars: config.maxToolOutputChars }
-                : {}),
-            ...(config.toolResultGuardrails !== undefined
-                ? { toolResultGuardrails: config.toolResultGuardrails }
-                : {}),
-            ...(config.retainedToolPreviewChars !== undefined
-                ? { retainedToolPreviewChars: config.retainedToolPreviewChars }
-                : {}),
-            ...(config.maxToolContentBytes !== undefined
-                ? { maxToolContentBytes: config.maxToolContentBytes }
-                : {}),
-            ...(config.repairToolCall ? { repairToolCall: config.repairToolCall } : {}),
-            ...(config.stopWhen ? { stopWhen: config.stopWhen } : {}),
-            ...(config.onStepFinish ? { onStepFinish: config.onStepFinish } : {}),
-            ...(config.prepareStep ? { prepareStep: config.prepareStep } : {}),
-            ...(config.beforeStep ? { beforeStep: config.beforeStep } : {}),
-            ...(config.allowedTools ? { allowedTools: [...config.allowedTools] } : {}),
-            ...(config.deniedTools ? { deniedTools: [...config.deniedTools] } : {}),
-            ...(config.inboundMessages ? { inboundMessages: config.inboundMessages } : {}),
-            ...(config.projectInstructionContext
-                ? { projectInstructionContext: config.projectInstructionContext }
-                : {}),
-            ...(config.steering ? { steering: config.steering } : {}),
-            ...(config.structuredOutput ? { structuredOutput: config.structuredOutput } : {}),
-            ...(config.inputGuardrails ? { inputGuardrails: config.inputGuardrails } : {}),
-            ...(config.outputGuardrails ? { outputGuardrails: config.outputGuardrails } : {}),
-            ...(config.checkpointStore ? { checkpointStore: config.checkpointStore } : {}),
-            ...(config.paths ? { paths: config.paths } : {}),
-            // Forwarded so a session log in memory keeps the whole session
-            // there; dropped here, the turn would build a disk log instead.
-            ...(config.sessionLog ? { sessionLog: config.sessionLog } : {}),
-            ...(config.parentSpan ? { parentSpan: config.parentSpan } : {}),
-            turnConfig: {
-                model: config.model,
-                ...(config.webSearch ? { webSearch: config.webSearch } : {}),
-                tokenBudget: config.tokenBudget,
-                timeoutMs: config.timeoutMs,
-                ...(config.sandbox ? { sandbox: config.sandbox } : {}),
-                ...(config.streamIdleTimeoutMs !== undefined
-                    ? { streamIdleTimeoutMs: config.streamIdleTimeoutMs }
-                    : {}),
-                ...(config.maxRequestRichContentBytes !== undefined
-                    ? { maxRequestRichContentBytes: config.maxRequestRichContentBytes }
-                    : {}),
-                maxIterations: config.maxIterations,
-                temperature: config.temperature,
-                maxResponseTokens: config.maxResponseTokens,
-                ...(config.pruneKeepLast !== undefined ? { pruneKeepLast: config.pruneKeepLast } : {}),
-                costLimitUsd: config.costLimitUsd,
-                permissionMode: config.permissionMode,
-                env: config.env,
-                logger: this.log,
-                // Hand-listed, so anything not named here is dropped in silence.
-                // That is how both of these came to be unreachable from every
-                // entry point except the raw kernel one.
-                ...(config.thinking ? { thinking: config.thinking } : {}),
-                ...(config.effort ? { effort: config.effort } : {}),
-            },
-            agentId: this.metadata.id,
-            agentName: this.metadata.name,
-            workingDirectory: input.workingDirectory,
-            sessionId: config.sessionId,
-            topicId: config.topicId,
-            projectId: config.projectId,
-            tenantId: config.tenantId,
-            turnId,
-            ...(config.parentSessionId ? { parentSessionId: config.parentSessionId } : {}),
-            ...(config.parentTurnId ? { parentTurnId: config.parentTurnId } : {}),
-            depth: config.depth,
-            contextLevel: config.contextLevel,
-            messages: input.messages,
-            signal: input.signal,
-            taskStore: input.taskStore,
-            runtimeToolOverrides: input.runtimeToolOverrides,
-            runtimeContext: input.runtimeContext,
-            advisory: config.advisory,
-            invocationState: config.invocationState,
-        }, listener);
-        let toolCallCount = 0;
-        for (const msg of turn.messages) {
-            if (msg.role === 'assistant') {
-                const assistantMsg = msg;
-                if (assistantMsg.toolCalls) {
-                    toolCallCount += assistantMsg.toolCalls.length;
-                }
-            }
-        }
-        return {
-            sessionId: turn.sessionId,
-            turnId: turn.id,
-            status: turn.status,
-            stopReason: turn.stopReason,
-            usage: turn.tokenUsage,
-            ...(turn.budget ? { budget: turn.budget } : {}),
-            cost: turn.costInfo,
-            iterations: turn.currentIteration,
-            durationMs: Date.now() - startTime,
-            messages: turn.messages,
-            result: turn.result,
-            structuredOutput: turn.structuredOutput,
-            lastError: turn.lastError,
-            toolCallCount,
-        };
-    }
-    async cancel() {
-        this.abortController.abort();
+        super({ ...metadata, type: 'reactive' }, log);
     }
 }
 //# sourceMappingURL=ReactiveAgent.js.map

package/dist/agents/ReactiveAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactiveAgent.js","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReactiveAgent.js","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,0FAA0F;AAC1F,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC1B,IAAI,GAAG,UAAmB,CAAA;IAE5C,YAAY,QAAsD,EAAE,GAAY;QAC/E,KAAK,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,CAAC,CAAA;IAC9C,CAAC;CACD"}

package/dist/agents/RouterAgent.d.ts

@@ -1,21 +1,3 @@
-import type { AgentInput, AgentMetadata, RouterAgentConfig, RouterAgentResult } from '../types/agent/index.js';
-import type { SessionEventListener } from '../types/session/events.js';
-import type { Logger } from '../utils/logger.js';
-import { AbstractAgent } from './AbstractAgent.js';
-export declare class RouterAgent extends AbstractAgent<RouterAgentConfig, RouterAgentResult> {
-    readonly type: "router";
-    constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
-    /**
-     * One turn at a time per instance.
-     *
-     * `abortController` and `currentSessionId` are instance state, so two
-     * overlapping turns share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's session, so a later
-     * `cancel()` cancels the wrong children. Neither failure announces itself.
-     * A host that wants parallelism constructs a second instance.
-     */
-    run(input: AgentInput, config: RouterAgentConfig, listener?: SessionEventListener): Promise<RouterAgentResult>;
-    private runExclusive;
-    private route;
-}
+/** @deprecated Example agent. Define application agents with the SDK Agent contract. */
+export { RouterAgent } from './examples/RouterAgent.js';
 //# sourceMappingURL=RouterAgent.d.ts.map

package/dist/agents/RouterAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterAgent.d.ts","sourceRoot":"","sources":["../../src/agents/RouterAgent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EAEjB,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,qBAAa,WAAY,SAAQ,aAAa,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IACnF,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;gBAErB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;YAMf,YAAY;YA2HZ,KAAK;CAwJnB"}
+{"version":3,"file":"RouterAgent.d.ts","sourceRoot":"","sources":["../../src/agents/RouterAgent.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA"}