@namzu/sdk 0.1.2 → 0.1.4-rc.1

package/dist/utils/shell-compress.js

@@ -0,0 +1,97 @@
+const STACK_FRAME_RE = /^\s+at\s+|^\s+File\s+"[^"]+",\s+line\s+\d+|^\s+at\s+[\w.$]+\(|^\s+\d+:\s+\w|^\s+from\s+\//;
+const PASS_LINE_RE = /[\s✓✔√●∙·►▸▹]+\s*(PASS|pass|ok|OK|✓|✔|√)\s|^\s*(PASS|ok)\s+[\w/.-]+|^ok\s+\d+\s|PASSED\s*$|^---\s*PASS:|^test\s+\S+\s+\.\.\.\s+ok\s*$/;
+const NOISE_RE = /^\s*[\\\/|─━░▓█▒■□◻◼⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣾⣽⣻⢿⡿⣟⣯⣷]+\s*$|^\s*\d+%\s*[|█▓░]+|^(Downloading|Fetching|Installing|Resolving|Compiling)\b.*\.\.\./;
+const DEFAULT_MIN_LINES = 20;
+const DEFAULT_MIN_REDUCTION = 0.1;
+const DEFAULT_MAX_STACK_FRAMES = 5;
+const DEFAULT_MAX_PASS_LINES = 3;
+function normalizeLine(line) {
+    return line.replace(/^\s*\d+[\s:.|)]+/, '').replace(/\d+/g, 'N');
+}
+function collapseRepeated(lines) {
+    const result = [];
+    let prevNorm = '';
+    let repeatCount = 0;
+    for (const line of lines) {
+        const norm = normalizeLine(line);
+        if (norm === prevNorm && norm.trim().length > 0) {
+            repeatCount++;
+        }
+        else {
+            if (repeatCount > 0) {
+                result.push(`... ${repeatCount} similar line${repeatCount === 1 ? '' : 's'} omitted`);
+            }
+            result.push(line);
+            prevNorm = norm;
+            repeatCount = 0;
+        }
+    }
+    if (repeatCount > 0) {
+        result.push(`... ${repeatCount} similar line${repeatCount === 1 ? '' : 's'} omitted`);
+    }
+    return result;
+}
+export function compressShellOutputFull(raw, options) {
+    const minLines = options?.minLines ?? DEFAULT_MIN_LINES;
+    const minReduction = options?.minReductionPercent ?? DEFAULT_MIN_REDUCTION;
+    const maxStackFrames = options?.maxStackFrames ?? DEFAULT_MAX_STACK_FRAMES;
+    const maxPassLines = options?.maxPassLines ?? DEFAULT_MAX_PASS_LINES;
+    const lines = raw.split('\n');
+    if (lines.length < minLines) {
+        return { text: raw, original: null };
+    }
+    // Pass 1: stack frame compression, pass test suppression, noise removal
+    const pass1 = [];
+    let stackCount = 0;
+    let passCount = 0;
+    for (const line of lines) {
+        // Noise removal
+        if (NOISE_RE.test(line)) {
+            continue;
+        }
+        // Stack frame compression
+        if (STACK_FRAME_RE.test(line)) {
+            stackCount++;
+            if (stackCount <= maxStackFrames) {
+                pass1.push(line);
+            }
+            continue;
+        }
+        if (stackCount > maxStackFrames) {
+            pass1.push(`... ${stackCount - maxStackFrames} more frames`);
+        }
+        stackCount = 0;
+        // Pass test suppression
+        if (PASS_LINE_RE.test(line)) {
+            passCount++;
+            if (passCount <= maxPassLines) {
+                pass1.push(line);
+            }
+            continue;
+        }
+        if (passCount > maxPassLines) {
+            pass1.push(`... ${passCount - maxPassLines} passing tests omitted`);
+        }
+        passCount = 0;
+        pass1.push(line);
+    }
+    // Flush trailing counters
+    if (stackCount > maxStackFrames) {
+        pass1.push(`... ${stackCount - maxStackFrames} more frames`);
+    }
+    if (passCount > maxPassLines) {
+        pass1.push(`... ${passCount - maxPassLines} passing tests omitted`);
+    }
+    // Pass 2: collapse repeated lines
+    const pass2 = collapseRepeated(pass1);
+    const compressed = pass2.join('\n');
+    const reduction = 1 - compressed.length / raw.length;
+    if (reduction < minReduction) {
+        return { text: raw, original: null };
+    }
+    return { text: compressed, original: raw };
+}
+export function compressShellOutput(raw, options) {
+    return compressShellOutputFull(raw, options).text;
+}
+//# sourceMappingURL=shell-compress.js.map

package/dist/utils/shell-compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-compress.js","sourceRoot":"","sources":["../../src/utils/shell-compress.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GACnB,2FAA2F,CAAA;AAE5F,MAAM,YAAY,GACjB,uIAAuI,CAAA;AAExI,MAAM,QAAQ,GACb,kIAAkI,CAAA;AAEnI,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAC5B,MAAM,qBAAqB,GAAG,GAAG,CAAA;AACjC,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAClC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAchC,SAAS,aAAa,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe;IACxC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,IAAI,WAAW,GAAG,CAAC,CAAA;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,WAAW,EAAE,CAAA;QACd,CAAC;aAAM,CAAC;YACP,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,gBAAgB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAA;YACtF,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,QAAQ,GAAG,IAAI,CAAA;YACf,WAAW,GAAG,CAAC,CAAA;QAChB,CAAC;IACF,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,gBAAgB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,GAAW,EACX,OAA8B;IAE9B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAA;IACvD,MAAM,YAAY,GAAG,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,CAAA;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,wBAAwB,CAAA;IAC1E,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,sBAAsB,CAAA;IAEpE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE7B,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IAED,wEAAwE;IACxE,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,gBAAgB;QAChB,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,SAAQ;QACT,CAAC;QAED,0BAA0B;QAC1B,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,UAAU,EAAE,CAAA;YACZ,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;YACD,SAAQ;QACT,CAAC;QAED,IAAI,UAAU,GAAG,cAAc,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,GAAG,cAAc,cAAc,CAAC,CAAA;QAC7D,CAAC;QACD,UAAU,GAAG,CAAC,CAAA;QAEd,wBAAwB;QACxB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS,EAAE,CAAA;YACX,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;YACD,SAAQ;QACT,CAAC;QAED,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,GAAG,YAAY,wBAAwB,CAAC,CAAA;QACpE,CAAC;QACD,SAAS,GAAG,CAAC,CAAA;QAEb,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,0BAA0B;IAC1B,IAAI,UAAU,GAAG,cAAc,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,GAAG,cAAc,cAAc,CAAC,CAAA;IAC7D,CAAC;IACD,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,GAAG,YAAY,wBAAwB,CAAC,CAAA;IACpE,CAAC;IAED,kCAAkC;IAClC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAErC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IAEpD,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,OAA8B;IAC9E,OAAO,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@namzu/sdk",
-  "version": "0.1.2",
+  "version": "0.1.4-rc.1",
+  "description": "Open-source AI agent framework — multi-model, multi-tenant, MCP + A2A native",
   "license": "FSL-1.1-MIT",
   "type": "module",
   "packageManager": "pnpm@10.33.0",
@@ -12,12 +13,12 @@
   "bugs": {
     "url": "https://github.com/cogitave/namzu/issues"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "types": "./src/index.ts"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
   "files": [
@@ -43,6 +44,9 @@
     "release:patch": "bash scripts/release.sh patch",
     "release:minor": "bash scripts/release.sh minor",
     "release:major": "bash scripts/release.sh major",
+    "release:rc": "bash scripts/release.sh rc",
+    "release:beta": "bash scripts/release.sh beta",
+    "release:stable": "bash scripts/release.sh stable",
     "release:dry": "bash scripts/release.sh patch --dry-run",
     "prepublishOnly": "pnpm lint && pnpm typecheck && pnpm build"
   },

package/src/advisory/context.ts

@@ -0,0 +1,47 @@
+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 class AdvisoryContext {
+	readonly registry: AdvisorRegistry
+	readonly executor: AdvisoryExecutor
+	readonly evaluator: TriggerEvaluator
+	readonly callHistory: AdvisoryCallRecord[] = []
+
+	private readonly budget: AdvisoryBudget | undefined
+
+	constructor(
+		registry: AdvisorRegistry,
+		executor: AdvisoryExecutor,
+		evaluator: TriggerEvaluator,
+		budget?: AdvisoryBudget,
+	) {
+		this.registry = registry
+		this.executor = executor
+		this.evaluator = evaluator
+		this.budget = budget
+	}
+
+	recordCall(record: AdvisoryCallRecord): void {
+		this.callHistory.push(record)
+	}
+
+	getBudgetStatus(): { remaining: number | undefined; total: number | undefined; used: number } {
+		const used = this.callHistory.length
+		const total = this.budget?.maxCallsPerRun
+		const remaining = total !== undefined ? total - used : undefined
+		return { remaining, total, used }
+	}
+
+	checkBudget(): { allowed: boolean; reason?: string } {
+		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 }
+	}
+}

package/src/advisory/evaluator.ts

@@ -0,0 +1,98 @@
+import type {
+	AdvisoryBudget,
+	AdvisoryTrigger,
+	TriggerCondition,
+	TriggerEvaluationState,
+} from '../types/advisory/index.js'
+
+function assertNever(value: never): never {
+	throw new Error(`Unhandled trigger condition type: ${(value as TriggerCondition).type}`)
+}
+
+export class TriggerEvaluator {
+	private readonly triggers: AdvisoryTrigger[]
+	private readonly budget: AdvisoryBudget | undefined
+	private readonly lastFiredMap: Map<string, number> = new Map()
+	private callCount = 0
+
+	constructor(triggers: AdvisoryTrigger[], budget?: AdvisoryBudget) {
+		this.triggers = triggers
+			.filter((t) => t.enabled !== false)
+			.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))
+		this.budget = budget
+	}
+
+	evaluate(state: TriggerEvaluationState): AdvisoryTrigger[] {
+		if (this.isBudgetExhausted()) {
+			return []
+		}
+
+		const fired: AdvisoryTrigger[] = []
+		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: string, iteration: number): void {
+		this.lastFiredMap.set(triggerId, iteration)
+		this.callCount++
+	}
+
+	private isBudgetExhausted(): boolean {
+		if (this.budget?.maxCallsPerRun === undefined) {
+			return false
+		}
+		return this.callCount >= this.budget.maxCallsPerRun
+	}
+
+	private isCooldownSatisfied(trigger: AdvisoryTrigger, currentIteration: number): boolean {
+		if (trigger.cooldownIterations === undefined) {
+			return true
+		}
+		const lastFired = this.lastFiredMap.get(trigger.id)
+		if (lastFired === undefined) {
+			return true
+		}
+		return currentIteration - lastFired >= trigger.cooldownIterations
+	}
+
+	private matchesCondition(condition: TriggerCondition, state: TriggerEvaluationState): boolean {
+		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)
+		}
+	}
+}

package/src/advisory/executor.ts

@@ -0,0 +1,187 @@
+import { assembleSystemPrompt } from '../persona/assembler.js'
+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 { createSystemMessage, createUserMessage } from '../types/message/index.js'
+import type { LLMToolSchema } from '../types/tool/index.js'
+import type { Logger } from '../utils/logger.js'
+import { getRootLogger } 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 class AdvisoryExecutor {
+	private readonly logger: Logger
+
+	constructor(logger?: Logger) {
+		this.logger = (logger ?? getRootLogger()).child({ component: 'AdvisoryExecutor' })
+	}
+
+	async consult(
+		advisor: AdvisorDefinition,
+		request: AdvisoryRequest,
+		callCtx: AdvisoryCallContext,
+	): Promise<AdvisoryExecutionResult> {
+		const startMs = Date.now()
+
+		const systemPrompt = this.buildSystemPrompt(advisor)
+		const contextMessages = this.buildContext(advisor, request, callCtx)
+
+		const messages: Message[] = [
+			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,
+		}
+	}
+
+	private buildSystemPrompt(advisor: AdvisorDefinition): string {
+		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')
+	}
+
+	private buildContext(
+		advisor: AdvisorDefinition,
+		request: AdvisoryRequest,
+		callCtx: AdvisoryCallContext,
+	): Message[] {
+		if (request.includeContext === false) {
+			return []
+		}
+
+		const contextParts: string[] = []
+
+		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'))]
+	}
+
+	private truncateMessages(messages: Message[], maxTokens: number | undefined): Message[] {
+		if (!maxTokens) {
+			return messages
+		}
+
+		// Rough heuristic: 1 token ~= 4 characters
+		const charBudget = maxTokens * 4
+		let totalChars = 0
+		const result: Message[] = []
+
+		// Walk from most recent to oldest, accumulate until budget exhausted
+		for (let i = messages.length - 1; i >= 0; i--) {
+			const msg = messages[i] as Message
+			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.
+	 */
+	private parseResult(rawContent: string): AdvisoryResult {
+		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().
+	 */
+	private computeCost(_usage: TokenUsage): CostInfo {
+		return {
+			inputCostPer1M: 0,
+			outputCostPer1M: 0,
+			totalCost: 0,
+			cacheDiscount: 0,
+		}
+	}
+}

package/src/advisory/index.ts

@@ -0,0 +1,5 @@
+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'

package/src/advisory/registry.ts

@@ -0,0 +1,42 @@
+import { Registry } from '../registry/Registry.js'
+import type { AdvisorDefinition } from '../types/advisory/index.js'
+
+export class AdvisorRegistry extends Registry<AdvisorDefinition> {
+	private readonly defaultId: string | undefined
+
+	constructor(advisors: AdvisorDefinition[], defaultId?: string) {
+		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?: string, domain?: string): AdvisorDefinition | undefined {
+		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(): AdvisorDefinition[] {
+		return this.getAll()
+	}
+}

package/src/agents/SupervisorAgent.ts

@@ -49,6 +49,17 @@ export class SupervisorAgent extends AbstractAgent<SupervisorAgentConfig, Superv
 		if (config.gateway) {
 			gateway = config.gateway
 		} else if (config.agentManager) {
+			const mergedFactoryOptions = config.factoryOptions
+				? {
+						...config.factoryOptions,
+						taskRouter: config.taskRouter ?? config.factoryOptions.taskRouter,
+					}
+				: config.taskRouter
+					? ({
+							taskRouter: config.taskRouter,
+						} as import('../types/agent/index.js').AgentFactoryOptions)
+					: undefined
+
 			const taskContext: AgentTaskContext = {
 				parentRunId: runId,
 				parentAgentId: this.metadata.id,
@@ -58,7 +69,7 @@ export class SupervisorAgent extends AbstractAgent<SupervisorAgentConfig, Superv
 					total: config.tokenBudget,
 					remaining: config.tokenBudget,
 				},
-				factoryOptions: config.factoryOptions,
+				factoryOptions: mergedFactoryOptions,
 				threadId: config.threadId as ThreadId,
 			}
 			gateway = new LocalTaskGateway(config.agentManager, taskContext, listener, input)