@namzu/sdk 0.1.3 → 0.1.4-rc.1

package/README.md

@@ -1,13 +1,13 @@
 # Namzu
 
+Open-source AI agent framework — multi-model, multi-tenant, MCP + A2A native.
+
 [![npm](https://img.shields.io/npm/v/@namzu/sdk?color=blue)](https://www.npmjs.com/package/@namzu/sdk)
 [![CI](https://github.com/cogitave/namzu/actions/workflows/ci.yml/badge.svg)](https://github.com/cogitave/namzu/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-FSL--1.1--MIT-green)](./LICENSE.md)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org/)
 
-TypeScript SDK for building AI agents with tool use, multi-model support, orchestration patterns, RAG, MCP integration, and A2A protocol compatibility.
-
 > **Our goal is to build an open, community-driven agent framework that reduces systemic dependencies on proprietary platforms — so that everyone can build, own, and run AI agents freely.** Namzu is designed to work with any LLM provider through a bring-your-own-key model, and every version becomes fully open source (MIT) after two years. If this vision resonates with you, we'd love your help — whether it's a bug report, a feature idea, a pull request, or just spreading the word. Every contribution matters.
 
 ## Why Namzu?
@@ -28,6 +28,14 @@ There are great agent frameworks out there — LangChain, CrewAI, AutoGen, Verce
 
 **Progressive tool disclosure.** Agents don't see all tools at once. Tools start as deferred (searchable but not active), get activated on demand, and can be suspended. This keeps the LLM's context focused and reduces hallucinated tool calls.
 
+**Advisory System.** A three-layer advisory architecture where agents can consult specialized advisors mid-execution. Unlike Anthropic's Advisor Tool (Claude-only, single advisor), Namzu's system is provider-agnostic (any model advises any model via BYOK), supports multi-advisor with domain routing, configurable triggers, and agent-autonomous consultation. Define a security advisor on Bedrock, an architecture advisor on OpenRouter, and let the agent decide when to consult whom.
+
+**Structured compaction.** When context reaches capacity, Namzu doesn't just truncate — it incrementally extracts structured data (task, plan, files, decisions, failures) into a typed WorkingState, serializes it as compact markdown, and replaces old messages. The agent continues with full context awareness at a fraction of the token cost.
+
+**Tool tiering.** Configurable tier system that teaches the LLM to prefer cheaper tools first. Unlike hardcoded approaches, Namzu's tiers are fully user-defined — bring your own tier labels, priorities, and guidance templates.
+
+**Task routing.** Route sub-tasks to different models based on task type. Compaction and summarization go to cheap models, coding stays on expensive ones. Provider-agnostic, configurable per task type, with automatic fallback chains.
+
 | | Namzu | LangChain/LangGraph | CrewAI | OpenAI Agents SDK | Vercel AI SDK |
 |---|---|---|---|---|---|
 | Language | TypeScript | Python/JS | Python | Python/JS | TypeScript |
@@ -40,6 +48,10 @@ There are great agent frameworks out there — LangChain, CrewAI, AutoGen, Verce
 | Plan review (HITL) | Structured | Graph interrupts | No | Basic | Tool approval |
 | Persona inheritance | Yes | No | Role strings | Instructions | System prompt |
 | Progressive tool loading | Yes | No | No | No | No |
+| Advisory system | Multi-advisor, provider-agnostic | No | No | No | No |
+| Context compaction | Structured WorkingState | No | No | No | No |
+| Tool tiering | Configurable, user-defined | No | No | No | No |
+| Task routing | Per-task model selection | No | No | No | No |
 | RAG built-in | Full pipeline | Via integrations | Via integrations | Via tools | No |
 | Telemetry | OpenTelemetry | LangSmith | CrewAI+ | Built-in tracing | No |
 

package/dist/advisory/context.d.ts

@@ -0,0 +1,23 @@
+import type { AdvisoryBudget, AdvisoryCallRecord } from '../types/advisory/index.js';
+import type { TriggerEvaluator } from './evaluator.js';
+import type { AdvisoryExecutor } from './executor.js';
+import type { AdvisorRegistry } from './registry.js';
+export declare class AdvisoryContext {
+    readonly registry: AdvisorRegistry;
+    readonly executor: AdvisoryExecutor;
+    readonly evaluator: TriggerEvaluator;
+    readonly callHistory: AdvisoryCallRecord[];
+    private readonly budget;
+    constructor(registry: AdvisorRegistry, executor: AdvisoryExecutor, evaluator: TriggerEvaluator, budget?: AdvisoryBudget);
+    recordCall(record: AdvisoryCallRecord): void;
+    getBudgetStatus(): {
+        remaining: number | undefined;
+        total: number | undefined;
+        used: number;
+    };
+    checkBudget(): {
+        allowed: boolean;
+        reason?: string;
+    };
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/advisory/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/advisory/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,qBAAa,eAAe;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,EAAE,CAAK;IAE/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAGlD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,CAAC,EAAE,cAAc;IAQxB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI5C,eAAe,IAAI;QAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO7F,WAAW,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAUpD"}

package/dist/advisory/context.js

@@ -0,0 +1,33 @@
+export class AdvisoryContext {
+    registry;
+    executor;
+    evaluator;
+    callHistory = [];
+    budget;
+    constructor(registry, executor, evaluator, budget) {
+        this.registry = registry;
+        this.executor = executor;
+        this.evaluator = evaluator;
+        this.budget = budget;
+    }
+    recordCall(record) {
+        this.callHistory.push(record);
+    }
+    getBudgetStatus() {
+        const used = this.callHistory.length;
+        const total = this.budget?.maxCallsPerRun;
+        const remaining = total !== undefined ? total - used : undefined;
+        return { remaining, total, used };
+    }
+    checkBudget() {
+        const { remaining, total } = this.getBudgetStatus();
+        if (remaining !== undefined && remaining <= 0) {
+            return {
+                allowed: false,
+                reason: `Advisory budget exhausted: ${total} calls used of ${total} allowed per run`,
+            };
+        }
+        return { allowed: true };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/advisory/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/advisory/context.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAiB;IACzB,QAAQ,CAAkB;IAC1B,SAAS,CAAkB;IAC3B,WAAW,GAAyB,EAAE,CAAA;IAE9B,MAAM,CAA4B;IAEnD,YACC,QAAyB,EACzB,QAA0B,EAC1B,SAA2B,EAC3B,MAAuB;QAEvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;IAED,UAAU,CAAC,MAA0B;QACpC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;IAED,eAAe;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAA;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAA;QACzC,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QAChE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAClC,CAAC;IAED,WAAW;QACV,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QACnD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,8BAA8B,KAAK,kBAAkB,KAAK,kBAAkB;aACpF,CAAA;QACF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;CACD"}

package/dist/advisory/evaluator.d.ts

@@ -0,0 +1,14 @@
+import type { AdvisoryBudget, AdvisoryTrigger, TriggerEvaluationState } from '../types/advisory/index.js';
+export declare class TriggerEvaluator {
+    private readonly triggers;
+    private readonly budget;
+    private readonly lastFiredMap;
+    private callCount;
+    constructor(triggers: AdvisoryTrigger[], budget?: AdvisoryBudget);
+    evaluate(state: TriggerEvaluationState): AdvisoryTrigger[];
+    recordFiring(triggerId: string, iteration: number): void;
+    private isBudgetExhausted;
+    private isCooldownSatisfied;
+    private matchesCondition;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/advisory/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/advisory/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,eAAe,EAEf,sBAAsB,EACtB,MAAM,4BAA4B,CAAA;AAMnC,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,SAAS,CAAI;gBAET,QAAQ,EAAE,eAAe,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAOhE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,eAAe,EAAE;IAiB1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxD,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,gBAAgB;CAiCxB"}

package/dist/advisory/evaluator.js

@@ -0,0 +1,87 @@
+function assertNever(value) {
+    throw new Error(`Unhandled trigger condition type: ${value.type}`);
+}
+export class TriggerEvaluator {
+    triggers;
+    budget;
+    lastFiredMap = new Map();
+    callCount = 0;
+    constructor(triggers, budget) {
+        this.triggers = triggers
+            .filter((t) => t.enabled !== false)
+            .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        this.budget = budget;
+    }
+    evaluate(state) {
+        if (this.isBudgetExhausted()) {
+            return [];
+        }
+        const fired = [];
+        for (const trigger of this.triggers) {
+            if (!this.isCooldownSatisfied(trigger, state.iteration)) {
+                continue;
+            }
+            if (this.matchesCondition(trigger.condition, state)) {
+                fired.push(trigger);
+            }
+        }
+        return fired;
+    }
+    recordFiring(triggerId, iteration) {
+        this.lastFiredMap.set(triggerId, iteration);
+        this.callCount++;
+    }
+    isBudgetExhausted() {
+        if (this.budget?.maxCallsPerRun === undefined) {
+            return false;
+        }
+        return this.callCount >= this.budget.maxCallsPerRun;
+    }
+    isCooldownSatisfied(trigger, currentIteration) {
+        if (trigger.cooldownIterations === undefined) {
+            return true;
+        }
+        const lastFired = this.lastFiredMap.get(trigger.id);
+        if (lastFired === undefined) {
+            return true;
+        }
+        return currentIteration - lastFired >= trigger.cooldownIterations;
+    }
+    matchesCondition(condition, state) {
+        switch (condition.type) {
+            case 'on_error': {
+                if (state.lastError === undefined)
+                    return false;
+                if (condition.categories && condition.categories.length > 0) {
+                    return condition.categories.some((cat) => state.lastError?.includes(cat));
+                }
+                return true;
+            }
+            case 'on_iteration': {
+                return state.iteration % condition.everyN === 0;
+            }
+            case 'on_context_percent': {
+                return state.contextWindowPercent >= condition.threshold;
+            }
+            case 'on_tool_category': {
+                if (state.lastToolCategory === undefined)
+                    return false;
+                return condition.categories.includes(state.lastToolCategory);
+            }
+            case 'on_cost_percent': {
+                if (state.costBudgetPercent === undefined)
+                    return false;
+                return state.costBudgetPercent >= condition.threshold;
+            }
+            case 'on_complexity': {
+                return state.totalToolCalls >= condition.toolCallThreshold;
+            }
+            case 'custom': {
+                return condition.predicate(state);
+            }
+            default:
+                return assertNever(condition);
+        }
+    }
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/advisory/evaluator.js.map

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

package/dist/advisory/executor.d.ts

@@ -0,0 +1,40 @@
+import type { AdvisorDefinition } from '../types/advisory/config.js';
+import type { AdvisoryRequest, AdvisoryResult } from '../types/advisory/result.js';
+import type { CostInfo, TokenUsage } from '../types/common/index.js';
+import type { Message } from '../types/message/index.js';
+import type { LLMToolSchema } from '../types/tool/index.js';
+import type { Logger } from '../utils/logger.js';
+export interface AdvisoryCallContext {
+    readonly messages: Message[];
+    readonly workingStateSummary?: string;
+    readonly toolCatalog?: LLMToolSchema[];
+    readonly iteration: number;
+}
+export interface AdvisoryExecutionResult {
+    readonly result: AdvisoryResult;
+    readonly usage: TokenUsage;
+    readonly cost: CostInfo;
+    readonly durationMs: number;
+}
+export declare class AdvisoryExecutor {
+    private readonly logger;
+    constructor(logger?: Logger);
+    consult(advisor: AdvisorDefinition, request: AdvisoryRequest, callCtx: AdvisoryCallContext): Promise<AdvisoryExecutionResult>;
+    private buildSystemPrompt;
+    private buildContext;
+    private truncateMessages;
+    /**
+     * Parses the raw LLM response into an AdvisoryResult.
+     *
+     * Phase 1: text-only extraction. Structured parsing comes later.
+     */
+    private parseResult;
+    /**
+     * Computes cost from token usage.
+     *
+     * Returns zero-value cost since pricing is provider-specific.
+     * Callers with pricing data can recompute via calculateCost().
+     */
+    private computeCost;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/advisory/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/advisory/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,CAAC,EAAE,MAAM;IAIrB,OAAO,CACZ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IAgDnC,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,gBAAgB;IAsBxB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAQnB"}

package/dist/advisory/executor.js

@@ -0,0 +1,132 @@
+import { assembleSystemPrompt } from '../persona/assembler.js';
+import { createSystemMessage, createUserMessage } from '../types/message/index.js';
+import { getRootLogger } from '../utils/logger.js';
+export class AdvisoryExecutor {
+    logger;
+    constructor(logger) {
+        this.logger = (logger ?? getRootLogger()).child({ component: 'AdvisoryExecutor' });
+    }
+    async consult(advisor, request, callCtx) {
+        const startMs = Date.now();
+        const systemPrompt = this.buildSystemPrompt(advisor);
+        const contextMessages = this.buildContext(advisor, request, callCtx);
+        const messages = [
+            createSystemMessage(systemPrompt),
+            ...contextMessages,
+            createUserMessage(request.question),
+        ];
+        this.logger.debug('advisory call starting', {
+            advisorId: advisor.id,
+            model: advisor.model,
+            messageCount: messages.length,
+            urgency: request.urgency,
+        });
+        const response = await advisor.provider.chat({
+            model: advisor.model,
+            messages,
+            temperature: advisor.temperature,
+            maxTokens: advisor.maxResponseTokens,
+            toolChoice: 'none',
+        });
+        const durationMs = Date.now() - startMs;
+        const result = this.parseResult(response.message.content ?? '');
+        const cost = this.computeCost(response.usage);
+        this.logger.info('advisory call completed', {
+            advisorId: advisor.id,
+            model: advisor.model,
+            durationMs,
+            totalTokens: response.usage.totalTokens,
+        });
+        return {
+            result,
+            usage: response.usage,
+            cost,
+            durationMs,
+        };
+    }
+    buildSystemPrompt(advisor) {
+        if (advisor.systemPrompt) {
+            return advisor.systemPrompt;
+        }
+        if (advisor.persona) {
+            return assembleSystemPrompt(advisor.persona);
+        }
+        return [
+            `You are ${advisor.name}, an advisory agent.`,
+            advisor.domains && advisor.domains.length > 0
+                ? `Your domains of expertise: ${advisor.domains.join(', ')}.`
+                : undefined,
+            'Provide concise, actionable advice. Focus on what the agent should do next.',
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+    }
+    buildContext(advisor, request, callCtx) {
+        if (request.includeContext === false) {
+            return [];
+        }
+        const contextParts = [];
+        if (callCtx.workingStateSummary) {
+            contextParts.push(`## Working State\n${callCtx.workingStateSummary}`);
+        }
+        if (callCtx.toolCatalog && callCtx.toolCatalog.length > 0) {
+            const toolNames = callCtx.toolCatalog.map((t) => t.function.name);
+            contextParts.push(`## Available Tools\n${toolNames.join(', ')}`);
+        }
+        const messagesToInclude = this.truncateMessages(callCtx.messages, advisor.maxContextTokens);
+        if (messagesToInclude.length > 0) {
+            const conversationSummary = messagesToInclude
+                .map((m) => `[${m.role}]: ${m.content ?? '(tool calls)'}`)
+                .join('\n');
+            contextParts.push(`## Conversation Context\n${conversationSummary}`);
+        }
+        if (contextParts.length === 0) {
+            return [];
+        }
+        return [createUserMessage(contextParts.join('\n\n'))];
+    }
+    truncateMessages(messages, maxTokens) {
+        if (!maxTokens) {
+            return messages;
+        }
+        // Rough heuristic: 1 token ~= 4 characters
+        const charBudget = maxTokens * 4;
+        let totalChars = 0;
+        const result = [];
+        // Walk from most recent to oldest, accumulate until budget exhausted
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            const msgChars = (msg.content ?? '').length;
+            if (totalChars + msgChars > charBudget)
+                break;
+            totalChars += msgChars;
+            result.unshift(msg);
+        }
+        return result;
+    }
+    /**
+     * Parses the raw LLM response into an AdvisoryResult.
+     *
+     * Phase 1: text-only extraction. Structured parsing comes later.
+     */
+    parseResult(rawContent) {
+        return {
+            advice: rawContent,
+        };
+    }
+    /**
+     * Computes cost from token usage.
+     *
+     * Returns zero-value cost since pricing is provider-specific.
+     * Callers with pricing data can recompute via calculateCost().
+     */
+    computeCost(_usage) {
+        return {
+            inputCostPer1M: 0,
+            outputCostPer1M: 0,
+            totalCost: 0,
+            cacheDiscount: 0,
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/advisory/executor.js.map

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

package/dist/advisory/index.d.ts

@@ -0,0 +1,6 @@
+export { AdvisorRegistry } from './registry.js';
+export { AdvisoryExecutor } from './executor.js';
+export type { AdvisoryCallContext, AdvisoryExecutionResult } from './executor.js';
+export { TriggerEvaluator } from './evaluator.js';
+export { AdvisoryContext } from './context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/advisory/index.js

@@ -0,0 +1,5 @@
+export { AdvisorRegistry } from './registry.js';
+export { AdvisoryExecutor } from './executor.js';
+export { TriggerEvaluator } from './evaluator.js';
+export { AdvisoryContext } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/advisory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/advisory/registry.d.ts

@@ -0,0 +1,14 @@
+import { Registry } from '../registry/Registry.js';
+import type { AdvisorDefinition } from '../types/advisory/index.js';
+export declare class AdvisorRegistry extends Registry<AdvisorDefinition> {
+    private readonly defaultId;
+    constructor(advisors: AdvisorDefinition[], defaultId?: string);
+    /**
+     * Resolves the advisor for a given request.
+     *
+     * Priority: explicit ID > domain match > default > first registered.
+     */
+    resolve(advisorId?: string, domain?: string): AdvisorDefinition | undefined;
+    listAll(): AdvisorDefinition[];
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM;IAQ7D;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAmB3E,OAAO,IAAI,iBAAiB,EAAE;CAG9B"}

package/dist/advisory/registry.js

@@ -0,0 +1,36 @@
+import { Registry } from '../registry/Registry.js';
+export class AdvisorRegistry extends Registry {
+    defaultId;
+    constructor(advisors, defaultId) {
+        super();
+        for (const advisor of advisors) {
+            this.register(advisor.id, advisor);
+        }
+        this.defaultId = defaultId;
+    }
+    /**
+     * Resolves the advisor for a given request.
+     *
+     * Priority: explicit ID > domain match > default > first registered.
+     */
+    resolve(advisorId, domain) {
+        if (advisorId) {
+            return this.get(advisorId);
+        }
+        if (domain) {
+            const all = this.getAll();
+            const match = all.find((a) => a.domains?.some((d) => d === domain));
+            if (match)
+                return match;
+        }
+        if (this.defaultId) {
+            return this.get(this.defaultId);
+        }
+        const all = this.getAll();
+        return all.length > 0 ? all[0] : undefined;
+    }
+    listAll() {
+        return this.getAll();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/advisory/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,MAAM,OAAO,eAAgB,SAAQ,QAA2B;IAC9C,SAAS,CAAoB;IAE9C,YAAY,QAA6B,EAAE,SAAkB;QAC5D,KAAK,EAAE,CAAA;QACP,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAkB,EAAE,MAAe;QAC1C,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAA;YACnE,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3C,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,MAAM,EAAE,CAAA;IACrB,CAAC;CACD"}

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

@@ -1 +1 @@
-{"version":3,"file":"SupervisorAgent.d.ts","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,yBAAyB,CAAA;AAIhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,eAAgB,SAAQ,aAAa,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IAC/F,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;gBAEzB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC;IAa5D,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC;CAqHjC"}
+{"version":3,"file":"SupervisorAgent.d.ts","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,yBAAyB,CAAA;AAIhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,eAAgB,SAAQ,aAAa,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IAC/F,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;gBAEzB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC;IAa5D,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC;CAgIjC"}

package/dist/agents/SupervisorAgent.js

@@ -30,6 +30,16 @@ export class SupervisorAgent extends AbstractAgent {
             gateway = config.gateway;
         }
         else if (config.agentManager) {
+            const mergedFactoryOptions = config.factoryOptions
+                ? {
+                    ...config.factoryOptions,
+                    taskRouter: config.taskRouter ?? config.factoryOptions.taskRouter,
+                }
+                : config.taskRouter
+                    ? {
+                        taskRouter: config.taskRouter,
+                    }
+                    : undefined;
             const taskContext = {
                 parentRunId: runId,
                 parentAgentId: this.metadata.id,
@@ -39,7 +49,7 @@ export class SupervisorAgent extends AbstractAgent {
                     total: config.tokenBudget,
                     remaining: config.tokenBudget,
                 },
-                factoryOptions: config.factoryOptions,
+                factoryOptions: mergedFactoryOptions,
                 threadId: config.threadId,
             };
             gateway = new LocalTaskGateway(config.agentManager, taskContext, listener, input);

package/dist/agents/SupervisorAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"SupervisorAgent.js","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SupervisorAgent.js","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AASrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,OAAO,eAAgB,SAAQ,aAA2D;IACtF,IAAI,GAAG,YAAqB,CAAA;IAErC,YAAY,QAAsD;QACjE,KAAK,CAAC;YACL,GAAG,QAAQ;YACX,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE;gBACb,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,IAAI;gBACvB,mBAAmB,EAAE,IAAI;gBACzB,iBAAiB,EAAE,IAAI;aACvB;SACD,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CACR,KAAiB,EACjB,MAA6B,EAC7B,QAA2B;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAEhC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAC/D,CAAC;QAED,IAAI,OAAoB,CAAA;QACxB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QACzB,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc;gBACjD,CAAC,CAAC;oBACA,GAAG,MAAM,CAAC,cAAc;oBACxB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,cAAc,CAAC,UAAU;iBACjE;gBACF,CAAC,CAAC,MAAM,CAAC,UAAU;oBAClB,CAAC,CAAE;wBACD,UAAU,EAAE,MAAM,CAAC,UAAU;qBAC6B;oBAC5D,CAAC,CAAC,SAAS,CAAA;YAEb,MAAM,WAAW,GAAqB;gBACrC,WAAW,EAAE,KAAK;gBAClB,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAC/B,qBAAqB,EAAE,IAAI,CAAC,eAAe;gBAC3C,KAAK,EAAE,CAAC;gBACR,aAAa,EAAE;oBACd,KAAK,EAAE,MAAM,CAAC,WAAW;oBACzB,SAAS,EAAE,MAAM,CAAC,WAAW;iBAC7B;gBACD,cAAc,EAAE,oBAAoB;gBACpC,QAAQ,EAAE,MAAM,CAAC,QAAoB;aACrC,CAAA;YACD,OAAO,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;QAClF,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACrF,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAA;QAEzD,IAAI,cAA8E,CAAA;QAElF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;YACjD,OAAO;YACP,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,eAAe,EAAE,MAAM,CAAC,QAAQ;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK;YACL,cAAc,EAAE,GAAG,EAAE,CAAC,cAAc;YACpC,cAAc,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE;gBACrC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YACrC,CAAC;SACD,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;QAChC,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACxC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,UAAU,CAC/B;YACC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK;YACL,aAAa,EAAE;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,GAAG,EAAE,MAAM,CAAC,GAAG;aACf;YACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACzB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAC7B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,MAAM,CAAC,QAAoB;YACrC,KAAK;YACL,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,MAAM;YACpB,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;gBACrC,cAAc,GAAG,WAAW,CAAA;YAC7B,CAAC;YACD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,WAAW,EAAE,OAAO;YACpB,aAAa;SACb,EACD,QAAQ,CACR,CAAA;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAA;QACvC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI;gBACxB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,KAA6C;gBAC5D,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE;gBAC/B,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;gBACtB,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS;gBACzC,QAAQ,EAAE,EAAE;aACZ;YACD,SAAS,EAAE,KAAK;SAChB,CAAC,CAAC,CAAA;QAEH,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAA;QAExF,OAAO;YACN,KAAK,EAAE,OAAO,CAAC,EAAE;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;YAC/D,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,UAAU;YACzB,IAAI,EAAE,OAAO,CAAC,QAAQ;YACtB,UAAU,EAAE,OAAO,CAAC,gBAAgB;YACpC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW;YACX,cAAc;YACd,UAAU,EAAE,WAAW,CAAC,MAAM;SAC9B,CAAA;IACF,CAAC;CACD"}

package/dist/compaction/extractor.d.ts

@@ -0,0 +1,7 @@
+import type { CompactionConfig } from '../config/runtime.js';
+import type { WorkingStateManager } from './manager.js';
+export declare function extractFromToolCall(manager: WorkingStateManager, toolName: string, args: string): void;
+export declare function extractFromToolResult(manager: WorkingStateManager, toolName: string, result: string, isError: boolean): void;
+export declare function extractFromUserMessage(manager: WorkingStateManager, content: string, isFirst: boolean): void;
+export declare function extractFromAssistantMessage(manager: WorkingStateManager, content: string, config: CompactionConfig): void;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/compaction/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/compaction/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAsCvD,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACV,IAAI,CA4BN;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACd,IAAI,CAuCN;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACd,IAAI,CAQN;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GACtB,IAAI,CAUN"}