@aaac/runtime 0.1.55 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +6 -11
  2. package/dist/adapters/adk-sdk.d.ts +3 -3
  3. package/dist/adapters/adk-sdk.js +6 -8
  4. package/dist/adapters/adk-sdk.js.map +1 -1
  5. package/dist/adapters/claude-agent-sdk.d.ts +3 -3
  6. package/dist/adapters/claude-agent-sdk.js +22 -23
  7. package/dist/adapters/claude-agent-sdk.js.map +1 -1
  8. package/dist/adapters/mock.d.ts +2 -3
  9. package/dist/adapters/openai-agents-sdk.d.ts +3 -3
  10. package/dist/adapters/openai-agents-sdk.js +6 -5
  11. package/dist/adapters/openai-agents-sdk.js.map +1 -1
  12. package/dist/chunk-2INQL5TG.js +298 -0
  13. package/dist/chunk-2INQL5TG.js.map +1 -0
  14. package/dist/chunk-3CLWG72V.js +47 -0
  15. package/dist/chunk-3CLWG72V.js.map +1 -0
  16. package/dist/chunk-3DDB34BU.js +237 -0
  17. package/dist/chunk-3DDB34BU.js.map +1 -0
  18. package/dist/chunk-ABXDSTUV.js +685 -0
  19. package/dist/chunk-ABXDSTUV.js.map +1 -0
  20. package/dist/{chunk-3H3PVPPF.js → chunk-F5R46S7I.js} +151 -204
  21. package/dist/chunk-F5R46S7I.js.map +1 -0
  22. package/dist/chunk-FKAI54OM.js +234 -0
  23. package/dist/chunk-FKAI54OM.js.map +1 -0
  24. package/dist/chunk-KTVMMG33.js +1111 -0
  25. package/dist/chunk-KTVMMG33.js.map +1 -0
  26. package/dist/chunk-MSVIEEGR.js +269 -0
  27. package/dist/chunk-MSVIEEGR.js.map +1 -0
  28. package/dist/chunk-VJXGCWSZ.js +36 -0
  29. package/dist/chunk-VJXGCWSZ.js.map +1 -0
  30. package/dist/claude-bundles/full.js +311 -309
  31. package/dist/claude-bundles/lean.js +6 -6
  32. package/dist/claude-bundles/prompt.js +17 -0
  33. package/dist/generator/index.d.ts +2 -2
  34. package/dist/generator/index.js +8 -7
  35. package/dist/guardrail-hooks-CB23nhZV.d.ts +202 -0
  36. package/dist/hook-protocol-CFnNudiV.d.ts +96 -0
  37. package/dist/hooks-lite-CoWWnCRH.d.ts +428 -0
  38. package/dist/index-BlSepCSZ.d.ts +296 -0
  39. package/dist/index.d.ts +785 -105
  40. package/dist/index.js +2189 -634
  41. package/dist/index.js.map +1 -1
  42. package/dist/lib/claude-native/hooks-lite.d.ts +3 -26
  43. package/dist/lib/claude-native/hooks-lite.js +18 -36
  44. package/dist/lib/claude-native/hooks-prompt.d.ts +5 -0
  45. package/dist/lib/claude-native/hooks-prompt.js +33 -0
  46. package/dist/lib/claude-native/hooks-prompt.js.map +1 -0
  47. package/dist/lib/claude-native/index.d.ts +56 -214
  48. package/dist/lib/claude-native/index.js +79 -280
  49. package/dist/lib/claude-native/index.js.map +1 -1
  50. package/dist/{navigation-context-D_E1NIUf.d.ts → navigation-context-B-RpUg3_.d.ts} +1 -1
  51. package/dist/navigation-index-prompt-CbrS5laO.d.ts +43 -0
  52. package/dist/{task-runner-DfIEorkU.d.ts → task-runner-GWoI7_71.d.ts} +100 -493
  53. package/dist/workspace-user-prompt-submit-D11Iu0zO.d.ts +269 -0
  54. package/package.json +15 -6
  55. package/dist/chunk-3H3PVPPF.js.map +0 -1
  56. package/dist/chunk-DBM5XN67.js +0 -354
  57. package/dist/chunk-DBM5XN67.js.map +0 -1
  58. package/dist/chunk-KXGUWBGK.js +0 -370
  59. package/dist/chunk-KXGUWBGK.js.map +0 -1
  60. package/dist/chunk-LDCQZPDG.js +0 -11
  61. package/dist/chunk-LDCQZPDG.js.map +0 -1
  62. package/dist/chunk-N4KNGDYY.js +0 -1963
  63. package/dist/chunk-N4KNGDYY.js.map +0 -1
  64. package/dist/chunk-NMX4C6LC.js +0 -332
  65. package/dist/chunk-NMX4C6LC.js.map +0 -1
  66. package/dist/chunk-QVH5KKBR.js +0 -374
  67. package/dist/chunk-QVH5KKBR.js.map +0 -1
  68. package/dist/context-DKkamYX_.d.ts +0 -31
  69. package/dist/guardrail-hooks-slK-z0Dz.d.ts +0 -83
  70. package/dist/index-LqEvaRk-.d.ts +0 -299
  71. package/dist/workspace-pre-tool-use-C6nidc0q.d.ts +0 -333
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/adapters/openai-agents-sdk.ts"],"sourcesContent":["/**\n * OpenAI Agents SDK Adapter — implements SdkAdapter for @openai/agents\n *\n * Uses the `run()` function (or `Runner`) from the OpenAI Agents SDK to execute\n * an Agent with instructions derived from the contract prompt.\n *\n * Supports:\n * - send() — create a fresh Agent + run() and return finalOutput\n * - followUp() — resume the same conversation via previousResponseId\n * - sendExecution() — rich path using full contract context\n *\n * The SDK's `run()` returns a RunResult with `finalOutput` (the model's final\n * text output) and `lastResponseId` for continuation.\n *\n * GuardrailHooks are mapped to the SDK's InputGuardrail system.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.js\";\nimport type { ObserverEmitFn, TokenUsage } from \"../lib/observability-bridge.js\";\nimport {\n emitLlmTurnOpen,\n emitLlmTurnClose,\n emitToolExecOpen,\n emitToolExecClose,\n} from \"../lib/observability-bridge.js\";\nimport type { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\nimport type { LibraryToolRegistry } from \"../lib/library-tool-binding.js\";\nimport { buildOpenAIFunctionTools } from \"../lib/library-tool-sdk.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on @openai/agents)\n// ---------------------------------------------------------------------------\n\ntype RunResult = {\n finalOutput?: string | unknown;\n lastResponseId?: string;\n newItems?: Array<{\n type: string;\n rawItem?: { type?: string; content?: unknown };\n [key: string]: unknown;\n }>;\n state?: unknown;\n usage?: {\n input_tokens?: number;\n output_tokens?: number;\n total_tokens?: number;\n };\n};\n\ntype AgentOptions = {\n name: string;\n model?: string;\n instructions: string | ((ctx: unknown) => string);\n tools?: unknown[];\n inputGuardrails?: unknown[];\n outputType?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentInstance = AgentOptions & { [key: string]: unknown };\n\ntype RunOptions = {\n maxTurns?: number | null;\n signal?: AbortSignal;\n previousResponseId?: string;\n stream?: boolean;\n context?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentConstructor = new (options: AgentOptions) => AgentInstance;\n\ntype RunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<RunResult>;\n\ntype StreamedRunResult = RunResult & {\n streamEvents(): AsyncIterable<RunStreamEvent>;\n};\n\ntype RunStreamEvent = {\n type: string;\n name?: string;\n item?: {\n type: string;\n toolName?: string;\n toolInput?: unknown;\n agent?: { name?: string };\n [key: string]: unknown;\n };\n [key: string]: unknown;\n};\n\ntype StreamRunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<StreamedRunResult>;\n\n// ---------------------------------------------------------------------------\n// Guardrail bridge\n// ---------------------------------------------------------------------------\n\nfunction buildInputGuardrails(\n guardrails: GuardrailHooks,\n): unknown[] {\n return [\n {\n name: \"contract-runtime-guardrail\",\n execute: async ({ input }: { input: unknown }) => {\n const inputStr = typeof input === \"string\"\n ? input\n : JSON.stringify(input);\n\n const results = guardrails.runChecks({ command: inputStr });\n const blocking = results.filter((r) => !r.passed && r.action === \"block\");\n\n return {\n outputInfo: { results },\n tripwireTriggered: blocking.length > 0,\n };\n },\n },\n ];\n}\n\n// ---------------------------------------------------------------------------\n// Input summary truncation\n// ---------------------------------------------------------------------------\n\nfunction truncateInputSummary(input: unknown, maxLen = 80): string {\n if (input == null) return \"\";\n let str: string;\n if (typeof input === \"string\") {\n str = input;\n } else {\n try { str = JSON.stringify(input); } catch { str = String(input); }\n }\n return str.length > maxLen ? str.slice(0, maxLen - 3) + \"...\" : str;\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIAgentsSdkAdapterConfig {\n /** Model identifier (e.g. \"gpt-4.1\", \"gpt-5.5\"). Uses SDK default if omitted. */\n model?: string;\n /** Maximum conversation turns per run. Defaults to 10 (SDK default). */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via InputGuardrail. */\n guardrailHooks?: GuardrailHooks;\n /** Additional tools to pass to the Agent. */\n tools?: unknown[];\n /** Agent name prefix. Defaults to \"contract-agent\". */\n agentName?: string;\n /** AbortSignal for cancellation. */\n signal?: AbortSignal;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class OpenAIAgentsSdkAdapter implements SdkAdapter {\n private model: string | undefined;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private tools: unknown[] | undefined;\n private agentName: string;\n private signal: AbortSignal | undefined;\n private cacheConfig: CacheConfig;\n private lastResponseId: string | null = null;\n private lastAgent: AgentInstance | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private lastTokenUsage: TokenUsage | null = null;\n\n private AgentClass: AgentConstructor | null = null;\n private runFn: RunFn | null = null;\n private streamRunFn: StreamRunFn | null = null;\n\n constructor(config: OpenAIAgentsSdkAdapterConfig = {}) {\n this.model = config.model;\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.tools = config.tools;\n this.agentName = config.agentName ?? \"contract-agent\";\n this.signal = config.signal;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<{ Agent: AgentConstructor; run: RunFn; streamRun?: StreamRunFn }> {\n if (this.AgentClass && this.runFn) {\n return { Agent: this.AgentClass, run: this.runFn, streamRun: this.streamRunFn ?? undefined };\n }\n\n const sdk = (await import(\"@openai/agents\")) as unknown as {\n Agent: AgentConstructor;\n run: RunFn;\n };\n this.AgentClass = sdk.Agent;\n this.runFn = sdk.run;\n return { Agent: this.AgentClass, run: this.runFn };\n }\n\n private createAgent(\n Agent: AgentConstructor,\n instructions: string,\n _readonly: boolean,\n agents?: CandidateAgent[],\n extraTools?: unknown[],\n ): AgentInstance {\n const opts: AgentOptions = {\n name: this.agentName,\n instructions,\n };\n\n if (this.model) opts.model = this.model;\n const mergedTools = [\n ...(this.tools ?? []),\n ...(extraTools ?? []),\n ];\n if (mergedTools.length > 0) opts.tools = mergedTools;\n\n if (this.guardrailHooks) {\n opts.inputGuardrails = buildInputGuardrails(this.guardrailHooks);\n }\n\n // Register candidate sub-agents as handoffs so the main agent can delegate\n // to them (model B, LLM-internal routing). Each becomes its own Agent.\n if (agents && agents.length > 0) {\n opts.handoffs = agents.map((a) => {\n const subOpts: AgentOptions = { name: a.name, instructions: a.prompt };\n if (a.model) subOpts.model = a.model;\n if (a.tools) subOpts.tools = a.tools;\n return new Agent(subOpts);\n });\n }\n\n return new Agent(opts);\n }\n\n private buildRunOptions(previousResponseId?: string): RunOptions {\n const opts: RunOptions = {};\n\n if (this.maxTurns !== undefined) opts.maxTurns = this.maxTurns;\n if (this.signal) opts.signal = this.signal;\n if (previousResponseId) opts.previousResponseId = previousResponseId;\n\n return opts;\n }\n\n private extractOutput(result: RunResult): string {\n if (typeof result.finalOutput === \"string\") {\n return result.finalOutput;\n }\n\n if (result.finalOutput !== undefined && result.finalOutput !== null) {\n return JSON.stringify(result.finalOutput, null, 2);\n }\n\n if (result.newItems) {\n const textParts: string[] = [];\n for (const item of result.newItems) {\n if (item.type === \"message_output_item\" || item.type === \"text\") {\n const rawItem = item.rawItem as Record<string, unknown> | undefined;\n if (rawItem?.content) {\n const content = rawItem.content;\n if (Array.isArray(content)) {\n for (const part of content) {\n if (typeof part === \"object\" && part !== null && \"text\" in part) {\n textParts.push((part as { text: string }).text);\n }\n }\n } else if (typeof content === \"string\") {\n textParts.push(content);\n }\n }\n }\n }\n if (textParts.length > 0) return textParts.join(\"\\n\");\n }\n\n return \"\";\n }\n\n private async runWithProgress(\n agent: AgentInstance,\n input: string,\n runOpts: RunOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n observer?: ObserverEmitFn,\n parentSpanId?: string,\n agentSessionId?: string,\n ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress && !observer) {\n if (!streamRun) return run(agent, input, runOpts);\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const _event of streamResult.streamEvents()) {\n // drain stream without processing\n }\n return streamResult;\n }\n\n if (!streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n\n let turnNumber = 0;\n let currentTurnSpanId: string | undefined;\n let currentTurnStart = 0;\n let toolCallsInTurn = 0;\n let turnInputTokens = 0;\n let turnOutputTokens = 0;\n const openToolSpans: Array<{ spanId: string; toolName: string; startMs: number }> = [];\n\n const closePendingToolSpans = (): void => {\n for (const ts of openToolSpans) {\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs, agentSessionId);\n }\n openToolSpans.length = 0;\n };\n\n const closeCurrentTurn = (): void => {\n if (currentTurnSpanId) {\n emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {\n inputTokens: turnInputTokens || undefined,\n outputTokens: turnOutputTokens || undefined,\n toolCallsCount: toolCallsInTurn || undefined,\n }, agentSessionId);\n currentTurnSpanId = undefined;\n }\n };\n\n for await (const event of streamResult.streamEvents()) {\n if (onProgress) emitProgressFromOpenAIEvent(event, onProgress);\n\n switch (event.type) {\n case \"reasoning_item_created\": {\n closePendingToolSpans();\n closeCurrentTurn();\n turnNumber++;\n toolCallsInTurn = 0;\n turnInputTokens = 0;\n turnOutputTokens = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model, undefined, agentSessionId);\n break;\n }\n case \"tool_called\": {\n if (!currentTurnSpanId) {\n turnNumber++;\n toolCallsInTurn = 0;\n turnInputTokens = 0;\n turnOutputTokens = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model, undefined, agentSessionId);\n }\n toolCallsInTurn++;\n const toolName = event.item?.toolName ?? \"unknown\";\n const summary = truncateInputSummary(event.item?.toolInput);\n const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, toolName, summary, turnNumber, agentSessionId);\n if (toolSpanId) {\n openToolSpans.push({ spanId: toolSpanId, toolName, startMs: Date.now() });\n }\n break;\n }\n case \"tool_output\": {\n if (openToolSpans.length > 0) {\n const ts = openToolSpans.shift()!;\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs, agentSessionId);\n }\n break;\n }\n case \"handoff_occurred\": {\n closePendingToolSpans();\n closeCurrentTurn();\n break;\n }\n default:\n break;\n }\n }\n\n closePendingToolSpans();\n const sessionUsage = this.extractTokenUsage(streamResult);\n if (sessionUsage && currentTurnSpanId) {\n turnInputTokens = sessionUsage.inputTokens;\n turnOutputTokens = sessionUsage.outputTokens;\n }\n closeCurrentTurn();\n\n return streamResult;\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n private async resolveLibraryTools(\n libraryTools?: LibraryToolRegistry,\n ): Promise<unknown[]> {\n if (!libraryTools || libraryTools.getAll().length === 0) return [];\n try {\n return await buildOpenAIFunctionTools(libraryTools);\n } catch {\n return [];\n }\n }\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = options.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = prompt;\n runInput = prompt;\n }\n\n const libTools = await this.resolveLibraryTools(options.libraryTools);\n const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);\n const runOpts = this.buildRunOptions();\n const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress, options.observer, options.parentSpanId, options.sessionId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n } : null;\n\n return this.extractOutput(result);\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastResponseId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n\n const { run } = await this.resolveSdk();\n const agent = this.lastAgent!;\n const runOpts = this.buildRunOptions(this.lastResponseId);\n\n const result = await run(agent, message, runOpts);\n\n this.lastResponseId = result.lastResponseId ?? this.lastResponseId;\n\n return this.extractOutput(result);\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = request.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = request.prompt;\n runInput = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const libTools = await this.resolveLibraryTools(request.options.libraryTools);\n const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);\n const runOpts = this.buildRunOptions(request.memoryRef?.id);\n const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress, request.options.observer, request.options.parentSpanId, request.options.sessionId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n } : null;\n\n return this.extractOutput(result);\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n getLastTokenUsage(): TokenUsage | null {\n return this.lastTokenUsage;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"openai-agents-sdk@\");\n }\n\n private extractTokenUsage(result: RunResult): TokenUsage | null {\n const usage = result.usage;\n if (!usage) return null;\n if (typeof usage.input_tokens !== \"number\" && typeof usage.output_tokens !== \"number\") return null;\n const inputTokens = usage.input_tokens ?? 0;\n const outputTokens = usage.output_tokens ?? 0;\n return {\n inputTokens,\n outputTokens,\n totalTokens: usage.total_tokens ?? (inputTokens + outputTokens),\n };\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject custom Agent constructor and run function for testing.\n * Bypasses the dynamic import of @openai/agents.\n */\n static withRunFn(\n AgentClass: AgentConstructor,\n runFn: RunFn,\n config?: OpenAIAgentsSdkAdapterConfig,\n streamRunFn?: StreamRunFn,\n ): OpenAIAgentsSdkAdapter {\n const adapter = new OpenAIAgentsSdkAdapter(config);\n adapter.AgentClass = AgentClass;\n adapter.runFn = runFn;\n adapter.streamRunFn = streamRunFn ?? null;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromOpenAIEvent(\n event: RunStreamEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n switch (event.type) {\n case \"tool_called\":\n if (event.item?.toolName) {\n onProgress({ type: \"tool_use\", tool_name: event.item.toolName });\n }\n break;\n case \"tool_output\":\n onProgress({ type: \"tool_result\" });\n break;\n case \"reasoning_item_created\":\n onProgress({ type: \"text\", message: \"Reasoning...\" });\n break;\n case \"handoff_occurred\":\n if (event.item?.agent?.name) {\n onProgress({ type: \"status\", message: `Handoff to ${event.item.agent.name}` });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":["streamResult"]}
1
+ {"version":3,"sources":["../../src/adapters/openai-agents-sdk.ts"],"sourcesContent":["/**\n * OpenAI Agents SDK Adapter — implements SdkAdapter for @openai/agents\n *\n * Uses the `run()` function (or `Runner`) from the OpenAI Agents SDK to execute\n * an Agent with instructions derived from the contract prompt.\n *\n * Supports:\n * - send() — create a fresh Agent + run() and return finalOutput\n * - followUp() — resume the same conversation via previousResponseId\n * - sendExecution() — rich path using full contract context\n *\n * The SDK's `run()` returns a RunResult with `finalOutput` (the model's final\n * text output) and `lastResponseId` for continuation.\n *\n * GuardrailHooks are mapped to the SDK's InputGuardrail system.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.js\";\nimport type { ObserverEmitFn, TokenUsage } from \"../lib/observability-bridge.js\";\nimport {\n emitLlmTurnOpen,\n emitLlmTurnClose,\n emitToolExecOpen,\n emitToolExecClose,\n} from \"../lib/observability-bridge.js\";\nimport { getBlockingViolations, type GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\nimport type { LibraryToolRegistry } from \"../lib/library-tool-binding.js\";\nimport { buildOpenAIFunctionTools } from \"../lib/library-tool-sdk.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on @openai/agents)\n// ---------------------------------------------------------------------------\n\ntype RunResult = {\n finalOutput?: string | unknown;\n lastResponseId?: string;\n newItems?: Array<{\n type: string;\n rawItem?: { type?: string; content?: unknown };\n [key: string]: unknown;\n }>;\n state?: unknown;\n usage?: {\n input_tokens?: number;\n output_tokens?: number;\n total_tokens?: number;\n };\n};\n\ntype AgentOptions = {\n name: string;\n model?: string;\n instructions: string | ((ctx: unknown) => string);\n tools?: unknown[];\n inputGuardrails?: unknown[];\n outputType?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentInstance = AgentOptions & { [key: string]: unknown };\n\ntype RunOptions = {\n maxTurns?: number | null;\n signal?: AbortSignal;\n previousResponseId?: string;\n stream?: boolean;\n context?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentConstructor = new (options: AgentOptions) => AgentInstance;\n\ntype RunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<RunResult>;\n\ntype StreamedRunResult = RunResult & {\n streamEvents(): AsyncIterable<RunStreamEvent>;\n};\n\ntype RunStreamEvent = {\n type: string;\n name?: string;\n item?: {\n type: string;\n toolName?: string;\n toolInput?: unknown;\n agent?: { name?: string };\n [key: string]: unknown;\n };\n [key: string]: unknown;\n};\n\ntype StreamRunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<StreamedRunResult>;\n\n// ---------------------------------------------------------------------------\n// Guardrail bridge\n// ---------------------------------------------------------------------------\n\nfunction buildInputGuardrails(\n guardrails: GuardrailHooks,\n): unknown[] {\n return [\n {\n name: \"contract-runtime-guardrail\",\n execute: async ({ input }: { input: unknown }) => {\n const inputStr = typeof input === \"string\"\n ? input\n : JSON.stringify(input);\n\n const results = guardrails.runChecks({ command: inputStr });\n const blocking = getBlockingViolations(results);\n\n return {\n outputInfo: { results },\n tripwireTriggered: blocking.length > 0,\n };\n },\n },\n ];\n}\n\n// ---------------------------------------------------------------------------\n// Input summary truncation\n// ---------------------------------------------------------------------------\n\nfunction truncateInputSummary(input: unknown, maxLen = 80): string {\n if (input == null) return \"\";\n let str: string;\n if (typeof input === \"string\") {\n str = input;\n } else {\n try { str = JSON.stringify(input); } catch { str = String(input); }\n }\n return str.length > maxLen ? str.slice(0, maxLen - 3) + \"...\" : str;\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIAgentsSdkAdapterConfig {\n /** Model identifier (e.g. \"gpt-4.1\", \"gpt-5.5\"). Uses SDK default if omitted. */\n model?: string;\n /** Maximum conversation turns per run. Defaults to 10 (SDK default). */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via InputGuardrail. */\n guardrailHooks?: GuardrailHooks;\n /** Additional tools to pass to the Agent. */\n tools?: unknown[];\n /** Agent name prefix. Defaults to \"contract-agent\". */\n agentName?: string;\n /** AbortSignal for cancellation. */\n signal?: AbortSignal;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class OpenAIAgentsSdkAdapter implements SdkAdapter {\n private model: string | undefined;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private tools: unknown[] | undefined;\n private agentName: string;\n private signal: AbortSignal | undefined;\n private cacheConfig: CacheConfig;\n private lastResponseId: string | null = null;\n private lastAgent: AgentInstance | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private lastTokenUsage: TokenUsage | null = null;\n\n private AgentClass: AgentConstructor | null = null;\n private runFn: RunFn | null = null;\n private streamRunFn: StreamRunFn | null = null;\n\n constructor(config: OpenAIAgentsSdkAdapterConfig = {}) {\n this.model = config.model;\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.tools = config.tools;\n this.agentName = config.agentName ?? \"contract-agent\";\n this.signal = config.signal;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<{ Agent: AgentConstructor; run: RunFn; streamRun?: StreamRunFn }> {\n if (this.AgentClass && this.runFn) {\n return { Agent: this.AgentClass, run: this.runFn, streamRun: this.streamRunFn ?? undefined };\n }\n\n const sdk = (await import(\"@openai/agents\")) as unknown as {\n Agent: AgentConstructor;\n run: RunFn;\n };\n this.AgentClass = sdk.Agent;\n this.runFn = sdk.run;\n return { Agent: this.AgentClass, run: this.runFn };\n }\n\n private createAgent(\n Agent: AgentConstructor,\n instructions: string,\n _readonly: boolean,\n agents?: CandidateAgent[],\n extraTools?: unknown[],\n ): AgentInstance {\n const opts: AgentOptions = {\n name: this.agentName,\n instructions,\n };\n\n if (this.model) opts.model = this.model;\n const mergedTools = [\n ...(this.tools ?? []),\n ...(extraTools ?? []),\n ];\n if (mergedTools.length > 0) opts.tools = mergedTools;\n\n if (this.guardrailHooks) {\n opts.inputGuardrails = buildInputGuardrails(this.guardrailHooks);\n }\n\n // Register candidate sub-agents as handoffs so the main agent can delegate\n // to them (model B, LLM-internal routing). Each becomes its own Agent.\n if (agents && agents.length > 0) {\n opts.handoffs = agents.map((a) => {\n const subOpts: AgentOptions = { name: a.name, instructions: a.prompt };\n if (a.model) subOpts.model = a.model;\n if (a.tools) subOpts.tools = a.tools;\n return new Agent(subOpts);\n });\n }\n\n return new Agent(opts);\n }\n\n private buildRunOptions(previousResponseId?: string): RunOptions {\n const opts: RunOptions = {};\n\n if (this.maxTurns !== undefined) opts.maxTurns = this.maxTurns;\n if (this.signal) opts.signal = this.signal;\n if (previousResponseId) opts.previousResponseId = previousResponseId;\n\n return opts;\n }\n\n private extractOutput(result: RunResult): string {\n if (typeof result.finalOutput === \"string\") {\n return result.finalOutput;\n }\n\n if (result.finalOutput !== undefined && result.finalOutput !== null) {\n return JSON.stringify(result.finalOutput, null, 2);\n }\n\n if (result.newItems) {\n const textParts: string[] = [];\n for (const item of result.newItems) {\n if (item.type === \"message_output_item\" || item.type === \"text\") {\n const rawItem = item.rawItem as Record<string, unknown> | undefined;\n if (rawItem?.content) {\n const content = rawItem.content;\n if (Array.isArray(content)) {\n for (const part of content) {\n if (typeof part === \"object\" && part !== null && \"text\" in part) {\n textParts.push((part as { text: string }).text);\n }\n }\n } else if (typeof content === \"string\") {\n textParts.push(content);\n }\n }\n }\n }\n if (textParts.length > 0) return textParts.join(\"\\n\");\n }\n\n return \"\";\n }\n\n private async runWithProgress(\n agent: AgentInstance,\n input: string,\n runOpts: RunOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n observer?: ObserverEmitFn,\n parentSpanId?: string,\n agentSessionId?: string,\n ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress && !observer) {\n if (!streamRun) return run(agent, input, runOpts);\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const _event of streamResult.streamEvents()) {\n // drain stream without processing\n }\n return streamResult;\n }\n\n if (!streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n\n let turnNumber = 0;\n let currentTurnSpanId: string | undefined;\n let currentTurnStart = 0;\n let toolCallsInTurn = 0;\n let turnInputTokens = 0;\n let turnOutputTokens = 0;\n const openToolSpans: Array<{ spanId: string; toolName: string; startMs: number }> = [];\n\n const closePendingToolSpans = (): void => {\n for (const ts of openToolSpans) {\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs, agentSessionId);\n }\n openToolSpans.length = 0;\n };\n\n const closeCurrentTurn = (): void => {\n if (currentTurnSpanId) {\n emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {\n inputTokens: turnInputTokens || undefined,\n outputTokens: turnOutputTokens || undefined,\n toolCallsCount: toolCallsInTurn || undefined,\n }, agentSessionId);\n currentTurnSpanId = undefined;\n }\n };\n\n for await (const event of streamResult.streamEvents()) {\n if (onProgress) emitProgressFromOpenAIEvent(event, onProgress);\n\n switch (event.type) {\n case \"reasoning_item_created\": {\n closePendingToolSpans();\n closeCurrentTurn();\n turnNumber++;\n toolCallsInTurn = 0;\n turnInputTokens = 0;\n turnOutputTokens = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model, undefined, agentSessionId);\n break;\n }\n case \"tool_called\": {\n if (!currentTurnSpanId) {\n turnNumber++;\n toolCallsInTurn = 0;\n turnInputTokens = 0;\n turnOutputTokens = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model, undefined, agentSessionId);\n }\n toolCallsInTurn++;\n const toolName = event.item?.toolName ?? \"unknown\";\n const summary = truncateInputSummary(event.item?.toolInput);\n const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, toolName, summary, turnNumber, agentSessionId);\n if (toolSpanId) {\n openToolSpans.push({ spanId: toolSpanId, toolName, startMs: Date.now() });\n }\n break;\n }\n case \"tool_output\": {\n if (openToolSpans.length > 0) {\n const ts = openToolSpans.shift()!;\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs, agentSessionId);\n }\n break;\n }\n case \"handoff_occurred\": {\n closePendingToolSpans();\n closeCurrentTurn();\n break;\n }\n default:\n break;\n }\n }\n\n closePendingToolSpans();\n const sessionUsage = this.extractTokenUsage(streamResult);\n if (sessionUsage && currentTurnSpanId) {\n turnInputTokens = sessionUsage.inputTokens;\n turnOutputTokens = sessionUsage.outputTokens;\n }\n closeCurrentTurn();\n\n return streamResult;\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n private async resolveLibraryTools(\n libraryTools?: LibraryToolRegistry,\n ): Promise<unknown[]> {\n if (!libraryTools || libraryTools.getAll().length === 0) return [];\n try {\n return await buildOpenAIFunctionTools(libraryTools);\n } catch {\n return [];\n }\n }\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = options.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = prompt;\n runInput = prompt;\n }\n\n const libTools = await this.resolveLibraryTools(options.libraryTools);\n const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);\n const runOpts = this.buildRunOptions();\n const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress, options.observer, options.parentSpanId, options.sessionId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n } : null;\n\n return this.extractOutput(result);\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastResponseId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n\n const { run } = await this.resolveSdk();\n const agent = this.lastAgent!;\n const runOpts = this.buildRunOptions(this.lastResponseId);\n\n const result = await run(agent, message, runOpts);\n\n this.lastResponseId = result.lastResponseId ?? this.lastResponseId;\n\n return this.extractOutput(result);\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = request.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = request.prompt;\n runInput = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const libTools = await this.resolveLibraryTools(request.options.libraryTools);\n const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);\n const runOpts = this.buildRunOptions(request.memoryRef?.id);\n const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress, request.options.observer, request.options.parentSpanId, request.options.sessionId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n } : null;\n\n return this.extractOutput(result);\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n getLastTokenUsage(): TokenUsage | null {\n return this.lastTokenUsage;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"openai-agents-sdk@\");\n }\n\n private extractTokenUsage(result: RunResult): TokenUsage | null {\n const usage = result.usage;\n if (!usage) return null;\n if (typeof usage.input_tokens !== \"number\" && typeof usage.output_tokens !== \"number\") return null;\n const inputTokens = usage.input_tokens ?? 0;\n const outputTokens = usage.output_tokens ?? 0;\n return {\n inputTokens,\n outputTokens,\n totalTokens: usage.total_tokens ?? (inputTokens + outputTokens),\n };\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject custom Agent constructor and run function for testing.\n * Bypasses the dynamic import of @openai/agents.\n */\n static withRunFn(\n AgentClass: AgentConstructor,\n runFn: RunFn,\n config?: OpenAIAgentsSdkAdapterConfig,\n streamRunFn?: StreamRunFn,\n ): OpenAIAgentsSdkAdapter {\n const adapter = new OpenAIAgentsSdkAdapter(config);\n adapter.AgentClass = AgentClass;\n adapter.runFn = runFn;\n adapter.streamRunFn = streamRunFn ?? null;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromOpenAIEvent(\n event: RunStreamEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n switch (event.type) {\n case \"tool_called\":\n if (event.item?.toolName) {\n onProgress({ type: \"tool_use\", tool_name: event.item.toolName });\n }\n break;\n case \"tool_output\":\n onProgress({ type: \"tool_result\" });\n break;\n case \"reasoning_item_created\":\n onProgress({ type: \"text\", message: \"Reasoning...\" });\n break;\n case \"handoff_occurred\":\n if (event.item?.agent?.name) {\n onProgress({ type: \"status\", message: `Handoff to ${event.item.agent.name}` });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":";;;;;;;;;;;;;AAiHA,SAAS,qBACP,YACW;AACX,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SAAS,OAAO,EAAE,MAAM,MAA0B;AAChD,cAAM,WAAW,OAAO,UAAU,WAC9B,QACA,KAAK,UAAU,KAAK;AAExB,cAAM,UAAU,WAAW,UAAU,EAAE,SAAS,SAAS,CAAC;AAC1D,cAAM,WAAW,sBAAsB,OAAO;AAE9C,eAAO;AAAA,UACL,YAAY,EAAE,QAAQ;AAAA,UACtB,mBAAmB,SAAS,SAAS;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMA,SAAS,qBAAqB,OAAgB,SAAS,IAAY;AACjE,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI;AACJ,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM;AAAA,EACR,OAAO;AACL,QAAI;AAAE,YAAM,KAAK,UAAU,KAAK;AAAA,IAAG,QAAQ;AAAE,YAAM,OAAO,KAAK;AAAA,IAAG;AAAA,EACpE;AACA,SAAO,IAAI,SAAS,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC,IAAI,QAAQ;AAClE;AA2BO,IAAM,yBAAN,MAAM,wBAA6C;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAgC;AAAA,EAChC,YAAkC;AAAA,EAClC,gBAAkC;AAAA,EAClC,iBAAoC;AAAA,EAEpC,aAAsC;AAAA,EACtC,QAAsB;AAAA,EACtB,cAAkC;AAAA,EAE1C,YAAY,SAAuC,CAAC,GAAG;AACrD,SAAK,QAAQ,OAAO;AACpB,SAAK,WAAW,OAAO;AACvB,SAAK,iBAAiB,OAAO;AAC7B,SAAK,QAAQ,OAAO;AACpB,SAAK,YAAY,OAAO,aAAa;AACrC,SAAK,SAAS,OAAO;AACrB,SAAK,cAAc,OAAO,eAAe,EAAE,SAAS,KAAK;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,aAAwF;AACpG,QAAI,KAAK,cAAc,KAAK,OAAO;AACjC,aAAO,EAAE,OAAO,KAAK,YAAY,KAAK,KAAK,OAAO,WAAW,KAAK,eAAe,OAAU;AAAA,IAC7F;AAEA,UAAM,MAAO,MAAM,OAAO,gBAAgB;AAI1C,SAAK,aAAa,IAAI;AACtB,SAAK,QAAQ,IAAI;AACjB,WAAO,EAAE,OAAO,KAAK,YAAY,KAAK,KAAK,MAAM;AAAA,EACnD;AAAA,EAEQ,YACN,OACA,cACA,WACA,QACA,YACe;AACf,UAAM,OAAqB;AAAA,MACzB,MAAM,KAAK;AAAA,MACX;AAAA,IACF;AAEA,QAAI,KAAK,MAAO,MAAK,QAAQ,KAAK;AAClC,UAAM,cAAc;AAAA,MAClB,GAAI,KAAK,SAAS,CAAC;AAAA,MACnB,GAAI,cAAc,CAAC;AAAA,IACrB;AACA,QAAI,YAAY,SAAS,EAAG,MAAK,QAAQ;AAEzC,QAAI,KAAK,gBAAgB;AACvB,WAAK,kBAAkB,qBAAqB,KAAK,cAAc;AAAA,IACjE;AAIA,QAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,WAAK,WAAW,OAAO,IAAI,CAAC,MAAM;AAChC,cAAM,UAAwB,EAAE,MAAM,EAAE,MAAM,cAAc,EAAE,OAAO;AACrE,YAAI,EAAE,MAAO,SAAQ,QAAQ,EAAE;AAC/B,YAAI,EAAE,MAAO,SAAQ,QAAQ,EAAE;AAC/B,eAAO,IAAI,MAAM,OAAO;AAAA,MAC1B,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,MAAM,IAAI;AAAA,EACvB;AAAA,EAEQ,gBAAgB,oBAAyC;AAC/D,UAAM,OAAmB,CAAC;AAE1B,QAAI,KAAK,aAAa,OAAW,MAAK,WAAW,KAAK;AACtD,QAAI,KAAK,OAAQ,MAAK,SAAS,KAAK;AACpC,QAAI,mBAAoB,MAAK,qBAAqB;AAElD,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,QAA2B;AAC/C,QAAI,OAAO,OAAO,gBAAgB,UAAU;AAC1C,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO,gBAAgB,UAAa,OAAO,gBAAgB,MAAM;AACnE,aAAO,KAAK,UAAU,OAAO,aAAa,MAAM,CAAC;AAAA,IACnD;AAEA,QAAI,OAAO,UAAU;AACnB,YAAM,YAAsB,CAAC;AAC7B,iBAAW,QAAQ,OAAO,UAAU;AAClC,YAAI,KAAK,SAAS,yBAAyB,KAAK,SAAS,QAAQ;AAC/D,gBAAM,UAAU,KAAK;AACrB,cAAI,SAAS,SAAS;AACpB,kBAAM,UAAU,QAAQ;AACxB,gBAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,yBAAW,QAAQ,SAAS;AAC1B,oBAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,MAAM;AAC/D,4BAAU,KAAM,KAA0B,IAAI;AAAA,gBAChD;AAAA,cACF;AAAA,YACF,WAAW,OAAO,YAAY,UAAU;AACtC,wBAAU,KAAK,OAAO;AAAA,YACxB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,UAAI,UAAU,SAAS,EAAG,QAAO,UAAU,KAAK,IAAI;AAAA,IACtD;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,gBACZ,OACA,OACA,SACA,YACA,UACA,cACA,gBACoB;AACpB,UAAM,EAAE,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW;AAEjD,QAAI,CAAC,cAAc,CAAC,UAAU;AAC5B,UAAI,CAAC,UAAW,QAAO,IAAI,OAAO,OAAO,OAAO;AAChD,YAAMA,gBAAe,MAAM,UAAU,OAAO,OAAO,OAAO;AAC1D,uBAAiB,UAAUA,cAAa,aAAa,GAAG;AAAA,MAExD;AACA,aAAOA;AAAA,IACT;AAEA,QAAI,CAAC,WAAW;AACd,aAAO,IAAI,OAAO,OAAO,OAAO;AAAA,IAClC;AAEA,UAAM,eAAe,MAAM,UAAU,OAAO,OAAO,OAAO;AAE1D,QAAI,aAAa;AACjB,QAAI;AACJ,QAAI,mBAAmB;AACvB,QAAI,kBAAkB;AACtB,QAAI,kBAAkB;AACtB,QAAI,mBAAmB;AACvB,UAAM,gBAA8E,CAAC;AAErF,UAAM,wBAAwB,MAAY;AACxC,iBAAW,MAAM,eAAe;AAC9B,0BAAkB,UAAU,GAAG,QAAQ,GAAG,UAAU,KAAK,IAAI,IAAI,GAAG,SAAS,cAAc;AAAA,MAC7F;AACA,oBAAc,SAAS;AAAA,IACzB;AAEA,UAAM,mBAAmB,MAAY;AACnC,UAAI,mBAAmB;AACrB,yBAAiB,UAAU,mBAAmB,YAAY,KAAK,IAAI,IAAI,kBAAkB;AAAA,UACvF,aAAa,mBAAmB;AAAA,UAChC,cAAc,oBAAoB;AAAA,UAClC,gBAAgB,mBAAmB;AAAA,QACrC,GAAG,cAAc;AACjB,4BAAoB;AAAA,MACtB;AAAA,IACF;AAEA,qBAAiB,SAAS,aAAa,aAAa,GAAG;AACrD,UAAI,WAAY,6BAA4B,OAAO,UAAU;AAE7D,cAAQ,MAAM,MAAM;AAAA,QAClB,KAAK,0BAA0B;AAC7B,gCAAsB;AACtB,2BAAiB;AACjB;AACA,4BAAkB;AAClB,4BAAkB;AAClB,6BAAmB;AACnB,6BAAmB,KAAK,IAAI;AAC5B,8BAAoB,gBAAgB,UAAU,cAAc,YAAY,KAAK,OAAO,QAAW,cAAc;AAC7G;AAAA,QACF;AAAA,QACA,KAAK,eAAe;AAClB,cAAI,CAAC,mBAAmB;AACtB;AACA,8BAAkB;AAClB,8BAAkB;AAClB,+BAAmB;AACnB,+BAAmB,KAAK,IAAI;AAC5B,gCAAoB,gBAAgB,UAAU,cAAc,YAAY,KAAK,OAAO,QAAW,cAAc;AAAA,UAC/G;AACA;AACA,gBAAM,WAAW,MAAM,MAAM,YAAY;AACzC,gBAAM,UAAU,qBAAqB,MAAM,MAAM,SAAS;AAC1D,gBAAM,aAAa,iBAAiB,UAAU,mBAAmB,UAAU,SAAS,YAAY,cAAc;AAC9G,cAAI,YAAY;AACd,0BAAc,KAAK,EAAE,QAAQ,YAAY,UAAU,SAAS,KAAK,IAAI,EAAE,CAAC;AAAA,UAC1E;AACA;AAAA,QACF;AAAA,QACA,KAAK,eAAe;AAClB,cAAI,cAAc,SAAS,GAAG;AAC5B,kBAAM,KAAK,cAAc,MAAM;AAC/B,8BAAkB,UAAU,GAAG,QAAQ,GAAG,UAAU,KAAK,IAAI,IAAI,GAAG,SAAS,cAAc;AAAA,UAC7F;AACA;AAAA,QACF;AAAA,QACA,KAAK,oBAAoB;AACvB,gCAAsB;AACtB,2BAAiB;AACjB;AAAA,QACF;AAAA,QACA;AACE;AAAA,MACJ;AAAA,IACF;AAEA,0BAAsB;AACtB,UAAM,eAAe,KAAK,kBAAkB,YAAY;AACxD,QAAI,gBAAgB,mBAAmB;AACrC,wBAAkB,aAAa;AAC/B,yBAAmB,aAAa;AAAA,IAClC;AACA,qBAAiB;AAEjB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,oBACZ,cACoB;AACpB,QAAI,CAAC,gBAAgB,aAAa,OAAO,EAAE,WAAW,EAAG,QAAO,CAAC;AACjE,QAAI;AACF,aAAO,MAAM,yBAAyB,YAAY;AAAA,IACpD,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAM,KACJ,QACA,SACiB;AACjB,SAAK,iBAAiB;AACtB,SAAK,YAAY;AACjB,SAAK,gBAAgB;AACrB,SAAK,iBAAiB;AAEtB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,WAAW;AACxC,UAAM,QAAQ,QAAQ;AACtB,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS,KAAK,YAAY,YAAY,OAAO;AAC/C,qBAAe,MAAM,OAAO,KAAK,aAAa;AAC9C,iBAAW,MAAM;AAAA,IACnB,OAAO;AACL,qBAAe;AACf,iBAAW;AAAA,IACb;AAEA,UAAM,WAAW,MAAM,KAAK,oBAAoB,QAAQ,YAAY;AACpE,UAAM,QAAQ,KAAK,YAAY,OAAO,cAAc,QAAQ,UAAU,QAAQ,QAAQ,QAAQ;AAC9F,UAAM,UAAU,KAAK,gBAAgB;AACrC,UAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,UAAU,SAAS,QAAQ,YAAY,QAAQ,UAAU,QAAQ,cAAc,QAAQ,SAAS;AAEjJ,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,SAAK,iBAAiB,KAAK,kBAAkB,MAAM;AACnD,SAAK,gBAAgB,KAAK,iBAAiB;AAAA,MACzC,IAAI,KAAK;AAAA,MACT,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,IACrC,IAAI;AAEJ,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,MAAM,SAAS,SAAkC;AAC/C,QAAI,CAAC,KAAK,gBAAgB;AACxB,YAAM,IAAI,MAAM,0DAAqD;AAAA,IACvE;AAEA,UAAM,EAAE,IAAI,IAAI,MAAM,KAAK,WAAW;AACtC,UAAM,QAAQ,KAAK;AACnB,UAAM,UAAU,KAAK,gBAAgB,KAAK,cAAc;AAExD,UAAM,SAAS,MAAM,IAAI,OAAO,SAAS,OAAO;AAEhD,SAAK,iBAAiB,OAAO,kBAAkB,KAAK;AAEpD,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,MAAM,cAAc,SAAiD;AACnE,SAAK,iBAAiB;AACtB,SAAK,YAAY;AACjB,SAAK,gBAAgB;AACrB,SAAK,iBAAiB;AAEtB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,WAAW;AACxC,UAAM,QAAQ,QAAQ;AACtB,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS,KAAK,YAAY,YAAY,OAAO;AAC/C,qBAAe,MAAM,OAAO,KAAK,aAAa;AAC9C,iBAAW,MAAM;AAAA,IACnB,OAAO;AACL,qBAAe,QAAQ;AACvB,iBAAW,QAAQ;AAAA,IACrB;AAEA,UAAM,SAAS,QAAQ,QAAQ,UAAU,QAAQ;AACjD,UAAM,WAAW,MAAM,KAAK,oBAAoB,QAAQ,QAAQ,YAAY;AAC5E,UAAM,QAAQ,KAAK,YAAY,OAAO,cAAc,QAAQ,QAAQ,UAAU,QAAQ,QAAQ;AAC9F,UAAM,UAAU,KAAK,gBAAgB,QAAQ,WAAW,EAAE;AAC1D,UAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,UAAU,SAAS,QAAQ,QAAQ,YAAY,QAAQ,QAAQ,UAAU,QAAQ,QAAQ,cAAc,QAAQ,QAAQ,SAAS;AAEjL,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,SAAK,iBAAiB,KAAK,kBAAkB,MAAM;AACnD,SAAK,gBAAgB,KAAK,iBAAiB;AAAA,MACzC,IAAI,KAAK;AAAA,MACT,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,MACnC,eAAe,QAAQ,WAAW;AAAA,IACpC,IAAI;AAEJ,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,mBAAqC;AACnC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,oBAAuC;AACrC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAa,QAAyB;AACpC,WAAO,OAAO,WAAW,oBAAoB;AAAA,EAC/C;AAAA,EAEQ,kBAAkB,QAAsC;AAC9D,UAAM,QAAQ,OAAO;AACrB,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,OAAO,MAAM,iBAAiB,YAAY,OAAO,MAAM,kBAAkB,SAAU,QAAO;AAC9F,UAAM,cAAc,MAAM,gBAAgB;AAC1C,UAAM,eAAe,MAAM,iBAAiB;AAC5C,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,aAAa,MAAM,gBAAiB,cAAc;AAAA,IACpD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,UACL,YACA,OACA,QACA,aACwB;AACxB,UAAM,UAAU,IAAI,wBAAuB,MAAM;AACjD,YAAQ,aAAa;AACrB,YAAQ,QAAQ;AAChB,YAAQ,cAAc,eAAe;AACrC,WAAO;AAAA,EACT;AACF;AAMA,SAAS,4BACP,OACA,YACM;AACN,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,UAAI,MAAM,MAAM,UAAU;AACxB,mBAAW,EAAE,MAAM,YAAY,WAAW,MAAM,KAAK,SAAS,CAAC;AAAA,MACjE;AACA;AAAA,IACF,KAAK;AACH,iBAAW,EAAE,MAAM,cAAc,CAAC;AAClC;AAAA,IACF,KAAK;AACH,iBAAW,EAAE,MAAM,QAAQ,SAAS,eAAe,CAAC;AACpD;AAAA,IACF,KAAK;AACH,UAAI,MAAM,MAAM,OAAO,MAAM;AAC3B,mBAAW,EAAE,MAAM,UAAU,SAAS,cAAc,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC;AAAA,MAC/E;AACA;AAAA,IACF;AACE;AAAA,EACJ;AACF;","names":["streamResult"]}
@@ -0,0 +1,298 @@
1
+ import {
2
+ buildAllowResponse,
3
+ buildDenyResponse,
4
+ createCacheStore,
5
+ isCachedRecord,
6
+ isProtectedArtifact,
7
+ listArtifacts,
8
+ readFreshNavigationBuild,
9
+ resolvePathToArtifacts
10
+ } from "./chunk-3DDB34BU.js";
11
+ import {
12
+ createGuardrailHooksFromRules,
13
+ toolPendingContent,
14
+ toolWriteTarget
15
+ } from "./chunk-MSVIEEGR.js";
16
+
17
+ // src/lib/claude-native/pre-tool-use.ts
18
+ function commandGuardCovers(input) {
19
+ return input.tool_input?.command !== void 0;
20
+ }
21
+ function artifactGuardTarget(input) {
22
+ return toolWriteTarget(input.tool_name, input.tool_input);
23
+ }
24
+ var GUARD_INPUT_DESCRIPTION = {
25
+ "navigation-index": "the artifact edit guard",
26
+ // Every rule kind the DSL declares — command, file and content — comes out of
27
+ // this one entry, so naming only the command half here would tell a refused
28
+ // edit that the guard it tripped is about something else (#316).
29
+ "guardrail-rules": "the DSL guardrails"
30
+ };
31
+ function unmaterializedGuardReason(input, scope) {
32
+ const where = scope ? ` for ${scope}` : "";
33
+ return `[guard-unavailable] ${GUARD_INPUT_DESCRIPTION[input]} cannot run: the \`${input}\` cache entry${where} is absent or was built from sources that have since changed, so this operation gets no verdict and is refused rather than judged by superseded rules or silently allowed. Run \`.claude/bin/ensure-navigation-index\` (SessionStart and every prompt submission do this automatically \u2014 if it keeps failing, that failure is the bug).`;
34
+ }
35
+ function createPreToolUseHandler(config) {
36
+ const guardrailHooks = config.guardrailRules ? createGuardrailHooksFromRules(config.guardrailRules) : null;
37
+ return async function handlePreToolUse(input) {
38
+ const target = artifactGuardTarget(input);
39
+ if (!guardrailHooks && (commandGuardCovers(input) || target)) {
40
+ return buildDenyResponse(unmaterializedGuardReason("guardrail-rules"));
41
+ }
42
+ if (guardrailHooks) {
43
+ if (commandGuardCovers(input)) {
44
+ const verdict2 = guardrailHooks.beforeShellExecution({
45
+ command: input.tool_input?.command
46
+ });
47
+ if (verdict2.permission === "deny") {
48
+ return buildDenyResponse(verdict2.user_message);
49
+ }
50
+ }
51
+ const verdict = guardrailHooks.preToolUse({
52
+ tool_name: input.tool_name,
53
+ tool_input: input.tool_input
54
+ });
55
+ if (verdict.permission === "deny") {
56
+ return buildDenyResponse(verdict.user_message);
57
+ }
58
+ }
59
+ if (target) {
60
+ if (!config.navigationIndex) {
61
+ return buildDenyResponse(unmaterializedGuardReason("navigation-index"));
62
+ }
63
+ for (const match of resolvePathToArtifacts(target, config.navigationIndex)) {
64
+ const check = isProtectedArtifact(match);
65
+ if (check.protected) {
66
+ return buildDenyResponse(check.reason);
67
+ }
68
+ }
69
+ }
70
+ return buildAllowResponse();
71
+ };
72
+ }
73
+
74
+ // src/lib/claude-native/file-suggestion.ts
75
+ var DEFAULT_MAX_CANDIDATES = 100;
76
+ function generateCandidates(prefix, options) {
77
+ const { navigationIndex, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;
78
+ const artifacts = listArtifacts(navigationIndex);
79
+ const candidates = [];
80
+ const lowerPrefix = prefix.toLowerCase();
81
+ const rootPath = (path) => joinPathPrefix(options.pathPrefix, path);
82
+ for (const { id, artifact } of artifacts) {
83
+ const props = artifact.properties ?? {};
84
+ const patterns = artifact.files?.path_patterns ?? [];
85
+ if (!prefix || id.toLowerCase().includes(lowerPrefix)) {
86
+ candidates.push({
87
+ label: id,
88
+ path: rootPath(patterns.length > 0 ? String(patterns[0]) : id),
89
+ kind: "artifact",
90
+ authority: props.authority,
91
+ manual_edit: props.manual_edit,
92
+ score: computeArtifactScore(id, artifact, prefix)
93
+ });
94
+ }
95
+ for (const pattern of patterns) {
96
+ if (typeof pattern !== "string") continue;
97
+ if (pattern.includes("*") || pattern.includes("?")) continue;
98
+ if (!prefix || pattern.toLowerCase().includes(lowerPrefix)) {
99
+ candidates.push({
100
+ label: pattern,
101
+ path: rootPath(pattern),
102
+ kind: "file",
103
+ artifact: id,
104
+ authority: props.authority,
105
+ manual_edit: props.manual_edit,
106
+ score: computeFileScore(pattern, prefix)
107
+ });
108
+ }
109
+ }
110
+ }
111
+ candidates.sort((a, b) => {
112
+ if (b.score !== a.score) return b.score - a.score;
113
+ return a.label.localeCompare(b.label);
114
+ });
115
+ return candidates.slice(0, maxCandidates);
116
+ }
117
+ function joinPathPrefix(prefix, path) {
118
+ if (!prefix) return path;
119
+ const normalized = prefix.replace(/^\.\//, "").replace(/\/+$/, "");
120
+ return normalized ? `${normalized}/${path}` : path;
121
+ }
122
+ function formatNdjson(candidates) {
123
+ return candidates.map((c) => JSON.stringify(c)).join("\n");
124
+ }
125
+ function computeArtifactScore(id, artifact, prefix) {
126
+ let score = 50;
127
+ const props = artifact.properties ?? {};
128
+ if (props.authority === "canonical") score += 20;
129
+ if (props.manual_edit === "allowed") score += 10;
130
+ if (props.type === "source") score += 15;
131
+ if (props.authority === "generated") score -= 20;
132
+ if (props.manual_edit === "forbidden") score -= 10;
133
+ if (prefix && id.toLowerCase().startsWith(prefix.toLowerCase())) {
134
+ score += 20;
135
+ }
136
+ return score;
137
+ }
138
+ function computeFileScore(path, prefix) {
139
+ let score = 40;
140
+ if (prefix && path.toLowerCase().startsWith(prefix.toLowerCase())) {
141
+ score += 30;
142
+ }
143
+ score += Math.max(0, 20 - path.split("/").length * 2);
144
+ return score;
145
+ }
146
+ async function handleFileSuggestion(navigationIndex, stdinData) {
147
+ const prefix = stdinData.trim();
148
+ const candidates = generateCandidates(prefix, { navigationIndex });
149
+ return formatNdjson(candidates);
150
+ }
151
+ async function handleWorkspaceFileSuggestion(cacheDir, members, stdinData, maxCandidates = DEFAULT_MAX_CANDIDATES) {
152
+ const prefix = stdinData.trim();
153
+ const store = createCacheStore({ cacheDir });
154
+ const merged = [];
155
+ for (const member of members) {
156
+ const entry = await store.read(member.cacheKey, isCachedRecord);
157
+ if (!entry) continue;
158
+ merged.push(
159
+ ...generateCandidates(prefix, {
160
+ navigationIndex: entry.data,
161
+ pathPrefix: member.memberPath,
162
+ maxCandidates: Number.POSITIVE_INFINITY
163
+ })
164
+ );
165
+ }
166
+ merged.sort((a, b) => b.score !== a.score ? b.score - a.score : a.label.localeCompare(b.label));
167
+ return formatNdjson(merged.slice(0, maxCandidates));
168
+ }
169
+
170
+ // src/lib/claude-native/workspace-router.ts
171
+ import { resolve } from "path";
172
+ function routePathToMember(filePath, members, workspaceRoot) {
173
+ if (!filePath) return null;
174
+ const absPath = filePath.startsWith("/") ? filePath : resolve(workspaceRoot, filePath);
175
+ let best = null;
176
+ let bestPrefixLen = 0;
177
+ for (const member of members) {
178
+ const memberRoot = member.root;
179
+ const prefix = memberRoot.endsWith("/") ? memberRoot : memberRoot + "/";
180
+ if (absPath.startsWith(prefix) && prefix.length > bestPrefixLen) {
181
+ best = member;
182
+ bestPrefixLen = prefix.length;
183
+ }
184
+ }
185
+ return best;
186
+ }
187
+ function stripMemberPrefix(filePath, memberRoot, workspaceRoot) {
188
+ const absPath = filePath.startsWith("/") ? filePath : resolve(workspaceRoot, filePath);
189
+ const prefix = memberRoot.endsWith("/") ? memberRoot : memberRoot + "/";
190
+ if (absPath.startsWith(prefix)) {
191
+ return absPath.slice(prefix.length);
192
+ }
193
+ return filePath;
194
+ }
195
+
196
+ // src/lib/claude-native/workspace-pre-tool-use.ts
197
+ function extractCommandPathTokens(command) {
198
+ const tokens = [];
199
+ for (const raw of command.split(/\s+/)) {
200
+ const t = raw.replace(/^['"]+|['"]+$/g, "");
201
+ if (t && (t.includes("/") || t.includes("\\"))) {
202
+ tokens.push(t);
203
+ }
204
+ }
205
+ return tokens;
206
+ }
207
+ function createWorkspacePreToolUseHandler(config) {
208
+ const buildByMember = /* @__PURE__ */ new Map();
209
+ async function loadMemberBuild(member) {
210
+ if (buildByMember.has(member.name)) {
211
+ return buildByMember.get(member.name);
212
+ }
213
+ const build = await readFreshNavigationBuild({
214
+ cacheDir: config.cacheDir,
215
+ cacheKey: member.cacheKey
216
+ });
217
+ const loaded = build ? { ...build, hooks: createGuardrailHooksFromRules(build.guardrailRules) } : void 0;
218
+ buildByMember.set(member.name, loaded);
219
+ return loaded;
220
+ }
221
+ function membersForCommand(command) {
222
+ for (const token of extractCommandPathTokens(command)) {
223
+ const owner = routePathToMember(
224
+ token,
225
+ config.members,
226
+ config.workspaceRoot
227
+ );
228
+ if (owner) return [owner];
229
+ }
230
+ return config.members;
231
+ }
232
+ return async function handleWorkspacePreToolUse(input) {
233
+ if (commandGuardCovers(input)) {
234
+ const command = input.tool_input?.command ?? "";
235
+ for (const member2 of membersForCommand(command)) {
236
+ const build2 = await loadMemberBuild(member2);
237
+ if (!build2) {
238
+ return buildDenyResponse(
239
+ unmaterializedGuardReason("guardrail-rules", `member "${member2.name}"`)
240
+ );
241
+ }
242
+ const verdict = build2.hooks.beforeShellExecution({ command });
243
+ if (verdict.permission === "deny") {
244
+ return buildDenyResponse(verdict.user_message);
245
+ }
246
+ }
247
+ }
248
+ const filePath = artifactGuardTarget(input);
249
+ if (!filePath) {
250
+ return buildAllowResponse();
251
+ }
252
+ const member = routePathToMember(
253
+ filePath,
254
+ config.members,
255
+ config.workspaceRoot
256
+ );
257
+ if (!member) {
258
+ return buildAllowResponse();
259
+ }
260
+ const build = await loadMemberBuild(member);
261
+ if (!build) {
262
+ return buildDenyResponse(
263
+ unmaterializedGuardReason("navigation-index", `member "${member.name}"`)
264
+ );
265
+ }
266
+ const repoRelPath = stripMemberPrefix(
267
+ filePath,
268
+ member.root,
269
+ config.workspaceRoot
270
+ );
271
+ const fileVerdict = build.hooks.afterFileEdit({
272
+ file_path: repoRelPath,
273
+ content: toolPendingContent(input.tool_input)
274
+ });
275
+ if (fileVerdict.permission === "deny") {
276
+ return buildDenyResponse(fileVerdict.user_message);
277
+ }
278
+ for (const match of resolvePathToArtifacts(repoRelPath, build.navigationIndex)) {
279
+ const check = isProtectedArtifact(match);
280
+ if (check.protected) {
281
+ return buildDenyResponse(check.reason);
282
+ }
283
+ }
284
+ return buildAllowResponse();
285
+ };
286
+ }
287
+
288
+ export {
289
+ createPreToolUseHandler,
290
+ generateCandidates,
291
+ formatNdjson,
292
+ handleFileSuggestion,
293
+ handleWorkspaceFileSuggestion,
294
+ routePathToMember,
295
+ stripMemberPrefix,
296
+ createWorkspacePreToolUseHandler
297
+ };
298
+ //# sourceMappingURL=chunk-2INQL5TG.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/claude-native/pre-tool-use.ts","../src/lib/claude-native/file-suggestion.ts","../src/lib/claude-native/workspace-router.ts","../src/lib/claude-native/workspace-pre-tool-use.ts"],"sourcesContent":["/**\n * PreToolUse Hook Handler — artifact guardrail + DSL guardrail enforcement.\n *\n * Executed before EVERY tool use — `.claude/settings.json` registers this hook\n * with no matcher, so which guard covers a call is decided here. Two guards:\n * 1. the ARTIFACT guard: file path → artifact reverse lookup → deny if protected\n * 2. the DSL GUARDRAIL guard: every rule the project declares — `command_regex`\n * over the command, `file_glob` over the file the call names, `content_regex`\n * over the text it is about to write — through `GuardrailHooks`. This hook is\n * Claude Code's ONLY refusal point, so a rule kind that is not consulted here\n * is a rule kind the session does not enforce (#316).\n *\n * Both read an input the SessionStart / UserPromptSubmit hooks materialize into\n * `.claude/cache/`. An input that is not there is not the same as an input that\n * says nothing — see `unmaterializedGuardReason`.\n *\n * The two guards are independent — `commandGuardCovers` and\n * `artifactGuardTarget` are asked separately, so one payload can answer to\n * both — and the artifact side defaults to COVERED: an enumeration of the tools\n * to guard is an enumeration that goes stale every time Claude Code grows one\n * (#309).\n */\n\nimport {\n createGuardrailHooksFromRules,\n toolWriteTarget,\n type GuardrailRuleData,\n} from \"../guardrail-hooks.js\";\nimport {\n resolvePathToArtifacts,\n isProtectedArtifact,\n} from \"./artifact-resolver.js\";\nimport {\n buildDenyResponse,\n buildAllowResponse,\n type HookOutput,\n type PreToolUseInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface PreToolUseHandlerConfig {\n /**\n * Navigation index read from the cache, or `undefined` when that cache entry\n * was not there to read. Pass what the read returned — do NOT substitute an\n * empty index, which reads as \"this project protects no artifact\".\n */\n navigationIndex?: Record<string, unknown>;\n /**\n * DSL guardrail rules read from the companion cache entry, or `undefined`\n * when that entry was not there to read. A project with no guardrails still\n * HAS the entry (the builder writes it empty), so `undefined` means the guard\n * has no rules to consult, never that there are none.\n */\n guardrailRules?: GuardrailRuleData;\n}\n\n/**\n * Does the command guard cover this call?\n *\n * A call that carries a `command` is a command about to be executed, whatever\n * the tool is called; `Bash` and `PowerShell` are both built-ins today and a\n * third spelling costs nothing. Reading the payload rather than the tool name\n * is also what `guard evaluate` already does (`guard-commands.ts`), so the CLI\n * evaluator and the hook classify a payload the same way.\n */\nexport function commandGuardCovers(input: PreToolUseInput): boolean {\n return input.tool_input?.command !== undefined;\n}\n\n/**\n * The file the artifact guard must judge for this call, or `\"\"` when there is\n * none — a PreToolUse-payload adapter over `toolWriteTarget`, which is where the\n * answer lives.\n *\n * It lives THERE and not here because the DSL file guardrails ask the identical\n * question, and the moment the two asked it separately they answered\n * differently: the workspace route excused a read-only tool and the\n * single-component route refused the same `Read` (#316). The artifact guard and\n * the `file_glob` guard now cover exactly the same operations because there is\n * one function to change.\n *\n * The two guard CLASSES are still independent, not alternatives. Classifying a\n * call into one of them let a payload carrying both a `command` and a path skip\n * the artifact check entirely; no built-in carries both today, which is exactly\n * the kind of \"no tool does that yet\" that #309 exists to stop relying on.\n */\nexport function artifactGuardTarget(input: PreToolUseInput): string {\n return toolWriteTarget(input.tool_name, input.tool_input);\n}\n\n/** A `.claude/cache/` input the PreToolUse guard cannot reach a verdict without. */\nexport type PreToolUseGuardInput = \"navigation-index\" | \"guardrail-rules\";\n\n/** Which cache entry backs which guard, and what refusing it protects. */\nconst GUARD_INPUT_DESCRIPTION: Record<PreToolUseGuardInput, string> = {\n \"navigation-index\": \"the artifact edit guard\",\n // Every rule kind the DSL declares — command, file and content — comes out of\n // this one entry, so naming only the command half here would tell a refused\n // edit that the guard it tripped is about something else (#316).\n \"guardrail-rules\": \"the DSL guardrails\",\n};\n\n/**\n * Refusal message for a guard with no build it may judge from.\n *\n * This is the #293 rule applied one level further out. There, a guardrail whose\n * policy declares no action denies, because an unknowable verdict must not come\n * out permissive. Here the rules (or the artifact index) cannot be consulted at\n * all, so the verdict is unknowable for the same reason — and the previous\n * behaviour, allowing, is exactly how `git commit --no-verify` ran through\n * Claude Code with the guard saying nothing (#304). Only the operations the\n * missing guard covers are refused; a Read or a Grep is not one of them.\n *\n * ONE state, not two. \"Never materialized\" and \"materialized from sources that\n * have since changed\" differ only in how the cache got that way; both leave the\n * guard unable to answer for the project as it stands NOW, and both are repaired\n * by the same rebuild. Telling them apart here would mean two messages for one\n * decision — and the second one was the silent case: a warm cache whose DSL no\n * longer parses kept the guard judging by rules the project had already stopped\n * declaring, so a newly added rule was simply never enforced (#316).\n *\n * The message names the repair, because the repair is automatic: SessionStart\n * and every UserPromptSubmit run `ensure-navigation-index`, which writes the\n * whole build. Seeing this means that has not happened yet — or cannot, in which\n * case the per-prompt hook is already reporting why on stderr (#310).\n */\nexport function unmaterializedGuardReason(\n input: PreToolUseGuardInput,\n scope?: string,\n): string {\n const where = scope ? ` for ${scope}` : \"\";\n return (\n `[guard-unavailable] ${GUARD_INPUT_DESCRIPTION[input]} cannot run: the ` +\n `\\`${input}\\` cache entry${where} is absent or was built from sources that ` +\n `have since changed, so this operation gets no verdict and is refused rather ` +\n `than judged by superseded rules or silently allowed. ` +\n `Run \\`.claude/bin/ensure-navigation-index\\` (SessionStart and every prompt ` +\n `submission do this automatically — if it keeps failing, that failure is the bug).`\n );\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a PreToolUse hook handler.\n *\n * The caller passes the cache reads verbatim; deciding what an absent read\n * means is this handler's job, not the calling bin's.\n */\nexport function createPreToolUseHandler(config: PreToolUseHandlerConfig) {\n // Pre-compiled once; `null` means the rules were never materialized, which is\n // a refusal below — not a quiet skip of the command guard.\n const guardrailHooks = config.guardrailRules\n ? createGuardrailHooksFromRules(config.guardrailRules)\n : null;\n\n return async function handlePreToolUse(\n input: PreToolUseInput,\n ): Promise<HookOutput> {\n const target = artifactGuardTarget(input);\n\n // The DSL guardrails cover both classes of operation, so a rule set that was\n // never materialized refuses both — not just the command half, which is how\n // `file_glob` rules stayed unenforced with nothing said (#316).\n if (!guardrailHooks && (commandGuardCovers(input) || target)) {\n return buildDenyResponse(unmaterializedGuardReason(\"guardrail-rules\"));\n }\n\n if (guardrailHooks) {\n // --- Shell command: DSL command guardrails ---\n if (commandGuardCovers(input)) {\n const verdict = guardrailHooks.beforeShellExecution({\n command: input.tool_input?.command,\n });\n if (verdict.permission === \"deny\") {\n return buildDenyResponse(verdict.user_message);\n }\n }\n\n // --- DSL file + content guardrails ---\n //\n // The payload goes to the evaluator VERBATIM. It reads the target and the\n // pending content out of the tool input itself and answers `{}` for a call\n // that names no file, so which calls are covered is decided once, there —\n // exactly as `guard evaluate` and the SDK adapter already ask it, which is\n // what keeps the three routes on one verdict.\n const verdict = guardrailHooks.preToolUse({\n tool_name: input.tool_name,\n tool_input: input.tool_input,\n });\n if (verdict.permission === \"deny\") {\n return buildDenyResponse(verdict.user_message);\n }\n }\n\n // --- Candidate file write: artifact protection ---\n if (target) {\n if (!config.navigationIndex) {\n return buildDenyResponse(unmaterializedGuardReason(\"navigation-index\"));\n }\n for (const match of resolvePathToArtifacts(target, config.navigationIndex)) {\n const check = isProtectedArtifact(match);\n if (check.protected) {\n return buildDenyResponse(check.reason);\n }\n }\n }\n\n // --- Default: allow ---\n return buildAllowResponse();\n };\n}\n","/**\n * File Suggestion Handler — artifact-aware @ completion for Claude Code.\n *\n * Reads stdin prefix, filters navigation-index artifacts, and emits NDJSON\n * candidates sorted by relevance score.\n */\n\nimport { listArtifacts, type NavigationArtifact } from \"./artifact-resolver.js\";\nimport { createCacheStore, isCachedRecord } from \"./cache-store.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface FileSuggestionCandidate {\n label: string;\n path: string;\n kind: \"artifact\" | \"file\";\n /** Artifact ID this file/pattern belongs to. */\n artifact?: string;\n /** Authority of the artifact (canonical, generated, etc.). */\n authority?: string;\n /** Manual edit policy for the artifact. */\n manual_edit?: string;\n /** Relevance score (higher = more relevant). */\n score: number;\n}\n\nexport interface FileSuggestionOptions {\n /** The navigation index to search. */\n navigationIndex: Record<string, unknown>;\n /** Maximum number of candidates to return. */\n maxCandidates?: number;\n /**\n * Prefix prepended to every emitted path (#266). Artifact `path_patterns` are\n * project-root relative, so in a workspace — where Claude Code's cwd is the\n * workspace root — a member's candidates must be re-rooted under the member\n * directory. The mirror image of `stripMemberPrefix` on the PreToolUse side.\n */\n pathPrefix?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_MAX_CANDIDATES = 100;\n\n/**\n * Generate file suggestion candidates from the navigation index.\n * Filters by prefix if provided, then returns NDJSON-formatted candidates.\n */\nexport function generateCandidates(\n prefix: string,\n options: FileSuggestionOptions,\n): FileSuggestionCandidate[] {\n const { navigationIndex, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;\n const artifacts = listArtifacts(navigationIndex);\n const candidates: FileSuggestionCandidate[] = [];\n const lowerPrefix = prefix.toLowerCase();\n const rootPath = (path: string) => joinPathPrefix(options.pathPrefix, path);\n\n for (const { id, artifact } of artifacts) {\n const props = artifact.properties ?? {};\n const patterns = artifact.files?.path_patterns ?? [];\n\n // Artifact-level candidate\n if (!prefix || id.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: id,\n path: rootPath(patterns.length > 0 ? String(patterns[0]) : id),\n kind: \"artifact\",\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeArtifactScore(id, artifact, prefix),\n });\n }\n\n // File-level candidates from path patterns\n for (const pattern of patterns) {\n if (typeof pattern !== \"string\") continue;\n // Skip pure glob patterns for file-level suggestions (they're covered by artifact-level)\n if (pattern.includes(\"*\") || pattern.includes(\"?\")) continue;\n\n if (!prefix || pattern.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: pattern,\n path: rootPath(pattern),\n kind: \"file\",\n artifact: id,\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeFileScore(pattern, prefix),\n });\n }\n }\n }\n\n // Sort by score descending, then by label\n candidates.sort((a, b) => {\n if (b.score !== a.score) return b.score - a.score;\n return a.label.localeCompare(b.label);\n });\n\n return candidates.slice(0, maxCandidates);\n}\n\n/** Join a member path prefix with a project-relative path. */\nfunction joinPathPrefix(prefix: string | undefined, path: string): string {\n if (!prefix) return path;\n const normalized = prefix.replace(/^\\.\\//, \"\").replace(/\\/+$/, \"\");\n return normalized ? `${normalized}/${path}` : path;\n}\n\n/**\n * Format candidates as NDJSON (one JSON object per line).\n */\nexport function formatNdjson(candidates: FileSuggestionCandidate[]): string {\n return candidates.map((c) => JSON.stringify(c)).join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Scoring helpers\n// ---------------------------------------------------------------------------\n\nfunction computeArtifactScore(\n id: string,\n artifact: NavigationArtifact,\n prefix: string,\n): number {\n let score = 50;\n const props = artifact.properties ?? {};\n\n // Boost canonical, editable artifacts\n if (props.authority === \"canonical\") score += 20;\n if (props.manual_edit === \"allowed\") score += 10;\n\n // Boost source artifacts\n if (props.type === \"source\") score += 15;\n\n // Penalize generated artifacts\n if (props.authority === \"generated\") score -= 20;\n if (props.manual_edit === \"forbidden\") score -= 10;\n\n // Boost exact prefix match\n if (prefix && id.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 20;\n }\n\n return score;\n}\n\nfunction computeFileScore(path: string, prefix: string): number {\n let score = 40;\n\n // Boost exact prefix match\n if (prefix && path.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 30;\n }\n\n // Boost shorter paths (more specific)\n score += Math.max(0, 20 - path.split(\"/\").length * 2);\n\n return score;\n}\n\n/**\n * Main handler for file-suggestion bin script.\n * Reads prefix from stdin, returns NDJSON candidates to stdout.\n */\nexport async function handleFileSuggestion(\n navigationIndex: Record<string, unknown>,\n stdinData: string,\n): Promise<string> {\n const prefix = stdinData.trim();\n const candidates = generateCandidates(prefix, { navigationIndex });\n return formatNdjson(candidates);\n}\n\n/** One workspace member's cached index, as the file-suggestion bin knows it. */\nexport interface WorkspaceFileSuggestionMember {\n /** Member name (for diagnostics only). */\n name: string;\n /** Workspace-relative member path — prepended to every candidate path. */\n memberPath: string;\n /** Cache key of this member's navigation-index. */\n cacheKey: string;\n}\n\n/**\n * Workspace variant (#266): merge candidates from every member's own index.\n *\n * The single-component handler reads the lone `navigation-index` cache entry,\n * which workspace mode never writes (each member has its own key) — so `@`\n * completion returned nothing at all. Members whose index has not been built yet\n * are skipped rather than failing the hook: SessionStart warms them.\n */\nexport async function handleWorkspaceFileSuggestion(\n cacheDir: string,\n members: WorkspaceFileSuggestionMember[],\n stdinData: string,\n maxCandidates = DEFAULT_MAX_CANDIDATES,\n): Promise<string> {\n const prefix = stdinData.trim();\n const store = createCacheStore({ cacheDir });\n const merged: FileSuggestionCandidate[] = [];\n\n for (const member of members) {\n const entry = await store.read(member.cacheKey, isCachedRecord);\n if (!entry) continue;\n merged.push(\n ...generateCandidates(prefix, {\n navigationIndex: entry.data,\n pathPrefix: member.memberPath,\n maxCandidates: Number.POSITIVE_INFINITY,\n }),\n );\n }\n\n merged.sort((a, b) => (b.score !== a.score ? b.score - a.score : a.label.localeCompare(b.label)));\n return formatNdjson(merged.slice(0, maxCandidates));\n}\n","/**\n * Workspace Router — route a file path to the owning workspace member.\n *\n * Pure path-manipulation module. No imports from navigation-context,\n * agent-contracts, or any heavy dependency — safe for the lean hooks-lite\n * entry point.\n *\n * Algorithm: longest-prefix match among member absolute root paths.\n *\n * C4 resolution: stripMemberPrefix converts a workspace-relative path\n * (`aaac/packages/runtime/x.ts`) into a repo-relative path\n * (`packages/runtime/x.ts`) so existing member DSL path_patterns work\n * without modification.\n */\n\nimport { resolve } from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface WorkspaceMember {\n /** Human-readable member name (e.g. `\"aaac\"`). */\n name: string;\n /** Absolute path to the member root directory. */\n root: string;\n}\n\n// ---------------------------------------------------------------------------\n// Router\n// ---------------------------------------------------------------------------\n\n/**\n * Route a file path to the workspace member whose root is the longest\n * matching prefix of that path.\n *\n * Generic over `T extends WorkspaceMember` so callers that pass a richer\n * member type (e.g. `WorkspaceMemberPreToolUseConfig`) get back that type\n * without a cast.\n *\n * @param filePath - Absolute or workspace-root-relative file path (as\n * received from Claude Code's `tool_input.file_path`).\n * @param members - Workspace members with **absolute** root paths.\n * @param workspaceRoot - Absolute path to the workspace root directory.\n * Used to resolve relative `filePath` values.\n * @returns The owning member, or `null` when no member claims this path.\n */\nexport function routePathToMember<T extends WorkspaceMember>(\n filePath: string,\n members: T[],\n workspaceRoot: string,\n): T | null {\n if (!filePath) return null;\n\n // Normalise to absolute path\n const absPath = filePath.startsWith(\"/\")\n ? filePath\n : resolve(workspaceRoot, filePath);\n\n let best: T | null = null;\n let bestPrefixLen = 0;\n\n for (const member of members) {\n const memberRoot = member.root;\n // Ensure the prefix ends with \"/\" so \"aaac-extra\" doesn't match \"aaac\"\n const prefix = memberRoot.endsWith(\"/\") ? memberRoot : memberRoot + \"/\";\n\n if (absPath.startsWith(prefix) && prefix.length > bestPrefixLen) {\n best = member;\n bestPrefixLen = prefix.length;\n }\n }\n\n return best;\n}\n\n/**\n * Strip the member root prefix from `filePath` to obtain a repo-relative\n * path that member DSL `path_patterns` can match against unchanged (C4).\n *\n * Example:\n * filePath = \"aaac/packages/runtime/x.ts\" (workspace-relative)\n * memberRoot = \"/abs/workspace/aaac\"\n * workspaceRoot = \"/abs/workspace\"\n * → returns \"packages/runtime/x.ts\"\n *\n * @param filePath - Absolute or workspace-root-relative path.\n * @param memberRoot - Absolute path to the member root.\n * @param workspaceRoot - Absolute path to the workspace root.\n * @returns Repo-relative path (no leading slash/dot).\n * Falls back to the original `filePath` when stripping is not possible.\n */\nexport function stripMemberPrefix(\n filePath: string,\n memberRoot: string,\n workspaceRoot: string,\n): string {\n const absPath = filePath.startsWith(\"/\")\n ? filePath\n : resolve(workspaceRoot, filePath);\n\n const prefix = memberRoot.endsWith(\"/\") ? memberRoot : memberRoot + \"/\";\n if (absPath.startsWith(prefix)) {\n return absPath.slice(prefix.length);\n }\n\n return filePath;\n}\n","/**\n * Workspace PreToolUse Hook Handler — routes edits to the owning member\n * and enforces that member's artifact guardrails.\n *\n * Hot-path module. Does NOT import navigation-context or agent-contracts —\n * it only reads an already-built navigation index from the cache. Suitable\n * for inclusion in the lean hooks-lite entry point.\n *\n * Flow (per PreToolUse invocation, once `artifactGuardTarget` names a file the\n * file guards have to judge):\n * 1. Extract file path from tool input.\n * 2. Route to owning member via longest-prefix match (workspace-router).\n * 3. Read the member's fresh build — navigation-index + guardrail rules.\n * 4. Strip member-root prefix → repo-relative path (C4 resolution).\n * 5. Apply the member's file + content guardrails to that path.\n * 6. Resolve path to artifacts; deny if protected.\n */\n\nimport {\n createGuardrailHooksFromRules,\n toolPendingContent,\n type GuardrailHooks,\n} from \"../guardrail-hooks.js\";\nimport {\n resolvePathToArtifacts,\n isProtectedArtifact,\n} from \"./artifact-resolver.js\";\nimport {\n readFreshNavigationBuild,\n type FreshNavigationBuild,\n} from \"./navigation-freshness.js\";\nimport {\n buildDenyResponse,\n buildAllowResponse,\n type HookOutput,\n type PreToolUseInput,\n} from \"./hook-protocol.js\";\n// The guard classification and the unavailable-guard refusal come from the\n// single-component handler, which is where both are defined (#304). Two copies\n// would let the workspace route admit what the single-component route refuses;\n// the same direction already carries `renderCandidateArtifacts` from\n// user-prompt-submit.\nimport {\n artifactGuardTarget,\n commandGuardCovers,\n unmaterializedGuardReason,\n} from \"./pre-tool-use.js\";\nimport {\n routePathToMember,\n stripMemberPrefix,\n type WorkspaceMember,\n} from \"./workspace-router.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface WorkspaceMemberPreToolUseConfig extends WorkspaceMember {\n /**\n * Cache key for this member's navigation-index JSON.\n * Format: `navigation-index.<name>` (e.g. `navigation-index.aaac`).\n *\n * The member's DSL guardrail rules live in the companion entry this key\n * implies. There is no override for that: `ensureNavigationIndex` — the only\n * writer — derives the companion key from this one, so a reader free to name\n * a different entry could only ever name one nothing writes (#316).\n */\n cacheKey: string;\n}\n\nexport interface WorkspacePreToolUseConfig {\n /** Absolute path to the workspace root directory. */\n workspaceRoot: string;\n /** Absolute path to the shared `.claude/cache/` directory. */\n cacheDir: string;\n /** Workspace members to route edits to. */\n members: WorkspaceMemberPreToolUseConfig[];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Extract path-like tokens from a shell command so a Bash invocation can be\n * routed to the owning workspace member (#238 / C5).\n *\n * Whitespace-split, strips common shell quoting; keeps only tokens that look\n * like paths (contain a `/` or `\\`). This is a best-effort heuristic — command\n * guardrails that fail to route to a specific member fall back to evaluating\n * against every member's rules (safety-preserving union).\n */\nfunction extractCommandPathTokens(command: string): string[] {\n const tokens: string[] = [];\n for (const raw of command.split(/\\s+/)) {\n const t = raw.replace(/^['\"]+|['\"]+$/g, \"\");\n if (t && (t.includes(\"/\") || t.includes(\"\\\\\"))) {\n tokens.push(t);\n }\n }\n return tokens;\n}\n\n/**\n * Create a workspace-aware PreToolUse hook handler.\n *\n * On each invocation both guards are asked — independently, so one payload can\n * answer to both — and the handler:\n * - file guards, over the file `artifactGuardTarget` names:\n * - Routes the target path to the owning member by longest-prefix match.\n * - Reads the member's fresh build (refuses if it has none).\n * - Strips the member-root prefix so the member's `path_patterns` and\n * `file_glob` patterns both receive the repo-relative path they are written\n * against (C4).\n * - Denies a blocking `file_glob` / `content_regex` violation, then denies if\n * any matched artifact is protected (Phase 1).\n * - command guard, when the call carries one (#238 / C5, Phase 3):\n * - Routes the command to the owning member via a path token in the command\n * (longest-prefix match); when no member path is present, evaluates the\n * command against every member's rules so safety guardrails are never\n * silently skipped.\n * - Denies blocking command violations from that member's rules.\n *\n * Artifact protection (Phase 1) and DSL guardrails (Phase 3) are independent and\n * coexist: a member with only artifact rules keeps working unchanged, and a\n * member with only guardrail rules still enforces command and file safety.\n *\n * A member with no usable build refuses the operations its guards cover, rather\n * than admitting them — see `unmaterializedGuardReason`.\n */\nexport function createWorkspacePreToolUseHandler(\n config: WorkspacePreToolUseConfig,\n) {\n /**\n * One member's fresh build plus its compiled hooks, memoised for the life of\n * this hook invocation. `undefined` means the member has no build this guard\n * may judge from — absent, or superseded by an edit to the member's sources.\n *\n * Both entries come from ONE freshness answer. Read separately, a member's\n * artifact registry and its rule set could be paired across two builds.\n */\n const buildByMember = new Map<\n string,\n (FreshNavigationBuild & { hooks: GuardrailHooks }) | undefined\n >();\n\n async function loadMemberBuild(member: WorkspaceMemberPreToolUseConfig) {\n if (buildByMember.has(member.name)) {\n return buildByMember.get(member.name);\n }\n const build = await readFreshNavigationBuild({\n cacheDir: config.cacheDir,\n cacheKey: member.cacheKey,\n });\n // A member that declares no guardrail still HAS a rule set — the builder\n // writes it empty — so an empty one is an answer (\"nothing matches\") and is\n // compiled like any other. Treating empty as \"no hooks\" made the two\n // indistinguishable (#304).\n const loaded = build\n ? { ...build, hooks: createGuardrailHooksFromRules(build.guardrailRules) }\n : undefined;\n buildByMember.set(member.name, loaded);\n return loaded;\n }\n\n /**\n * Route a Bash command to the member(s) whose guardrail rules apply. Returns\n * a single owning member when a member-prefixed path is present in the\n * command; otherwise returns every member (safety-preserving union).\n */\n function membersForCommand(\n command: string,\n ): WorkspaceMemberPreToolUseConfig[] {\n for (const token of extractCommandPathTokens(command)) {\n const owner = routePathToMember(\n token,\n config.members,\n config.workspaceRoot,\n );\n if (owner) return [owner];\n }\n return config.members;\n }\n\n return async function handleWorkspacePreToolUse(\n input: PreToolUseInput,\n ): Promise<HookOutput> {\n // --- Shell command: member-scoped DSL guardrail enforcement (Phase 3 / C5) ---\n if (commandGuardCovers(input)) {\n const command = input.tool_input?.command ?? \"\";\n for (const member of membersForCommand(command)) {\n const build = await loadMemberBuild(member);\n if (!build) {\n return buildDenyResponse(\n unmaterializedGuardReason(\"guardrail-rules\", `member \"${member.name}\"`),\n );\n }\n const verdict = build.hooks.beforeShellExecution({ command });\n if (verdict.permission === \"deny\") {\n return buildDenyResponse(verdict.user_message);\n }\n }\n }\n\n // The file guards run on the same call, not instead of it: a payload\n // carrying both a command and a path is judged by both.\n const filePath = artifactGuardTarget(input);\n if (!filePath) {\n return buildAllowResponse();\n }\n\n // Step 1: Route to owning member\n const member = routePathToMember(\n filePath,\n config.members,\n config.workspaceRoot,\n );\n if (!member) {\n // Path does not belong to any declared member — allow\n return buildAllowResponse();\n }\n\n // Step 2: Load the member's build — index and rules, one freshness answer\n const build = await loadMemberBuild(member);\n if (!build) {\n return buildDenyResponse(\n unmaterializedGuardReason(\"navigation-index\", `member \"${member.name}\"`),\n );\n }\n\n // Step 3: Strip member-root prefix → repo-relative path (C4)\n const repoRelPath = stripMemberPrefix(\n filePath,\n member.root,\n config.workspaceRoot,\n );\n\n // Step 4: The member's DSL file + content guardrails.\n //\n // Asked through the ALREADY-EXTRACTED gate, not the tool-input one the\n // single-component route uses, because the path this member's `file_glob`\n // patterns are written against is the repo-relative one Step 3 produced —\n // not the workspace-scoped path the tool named. Handing the tool input over\n // instead would make the evaluator re-read that path and judge the wrong\n // string; rewriting the payload would put the \"which key names the file\"\n // decision back in a caller, which is what #309 removed. The verdict is the\n // same one `preToolUse` reaches — one evaluator, two payload shapes.\n const fileVerdict = build.hooks.afterFileEdit({\n file_path: repoRelPath,\n content: toolPendingContent(input.tool_input),\n });\n if (fileVerdict.permission === \"deny\") {\n return buildDenyResponse(fileVerdict.user_message);\n }\n\n // Step 5: Resolve path to artifacts and check protection\n for (const match of resolvePathToArtifacts(repoRelPath, build.navigationIndex)) {\n const check = isProtectedArtifact(match);\n if (check.protected) {\n return buildDenyResponse(check.reason);\n }\n }\n\n return buildAllowResponse();\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoEO,SAAS,mBAAmB,OAAiC;AAClE,SAAO,MAAM,YAAY,YAAY;AACvC;AAmBO,SAAS,oBAAoB,OAAgC;AAClE,SAAO,gBAAgB,MAAM,WAAW,MAAM,UAAU;AAC1D;AAMA,IAAM,0BAAgE;AAAA,EACpE,oBAAoB;AAAA;AAAA;AAAA;AAAA,EAIpB,mBAAmB;AACrB;AA0BO,SAAS,0BACd,OACA,OACQ;AACR,QAAM,QAAQ,QAAQ,QAAQ,KAAK,KAAK;AACxC,SACE,uBAAuB,wBAAwB,KAAK,CAAC,sBAChD,KAAK,iBAAiB,KAAK;AAMpC;AAYO,SAAS,wBAAwB,QAAiC;AAGvE,QAAM,iBAAiB,OAAO,iBAC1B,8BAA8B,OAAO,cAAc,IACnD;AAEJ,SAAO,eAAe,iBACpB,OACqB;AACrB,UAAM,SAAS,oBAAoB,KAAK;AAKxC,QAAI,CAAC,mBAAmB,mBAAmB,KAAK,KAAK,SAAS;AAC5D,aAAO,kBAAkB,0BAA0B,iBAAiB,CAAC;AAAA,IACvE;AAEA,QAAI,gBAAgB;AAElB,UAAI,mBAAmB,KAAK,GAAG;AAC7B,cAAMA,WAAU,eAAe,qBAAqB;AAAA,UAClD,SAAS,MAAM,YAAY;AAAA,QAC7B,CAAC;AACD,YAAIA,SAAQ,eAAe,QAAQ;AACjC,iBAAO,kBAAkBA,SAAQ,YAAY;AAAA,QAC/C;AAAA,MACF;AASA,YAAM,UAAU,eAAe,WAAW;AAAA,QACxC,WAAW,MAAM;AAAA,QACjB,YAAY,MAAM;AAAA,MACpB,CAAC;AACD,UAAI,QAAQ,eAAe,QAAQ;AACjC,eAAO,kBAAkB,QAAQ,YAAY;AAAA,MAC/C;AAAA,IACF;AAGA,QAAI,QAAQ;AACV,UAAI,CAAC,OAAO,iBAAiB;AAC3B,eAAO,kBAAkB,0BAA0B,kBAAkB,CAAC;AAAA,MACxE;AACA,iBAAW,SAAS,uBAAuB,QAAQ,OAAO,eAAe,GAAG;AAC1E,cAAM,QAAQ,oBAAoB,KAAK;AACvC,YAAI,MAAM,WAAW;AACnB,iBAAO,kBAAkB,MAAM,MAAM;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAGA,WAAO,mBAAmB;AAAA,EAC5B;AACF;;;AC1KA,IAAM,yBAAyB;AAMxB,SAAS,mBACd,QACA,SAC2B;AAC3B,QAAM,EAAE,iBAAiB,gBAAgB,uBAAuB,IAAI;AACpE,QAAM,YAAY,cAAc,eAAe;AAC/C,QAAM,aAAwC,CAAC;AAC/C,QAAM,cAAc,OAAO,YAAY;AACvC,QAAM,WAAW,CAAC,SAAiB,eAAe,QAAQ,YAAY,IAAI;AAE1E,aAAW,EAAE,IAAI,SAAS,KAAK,WAAW;AACxC,UAAM,QAAQ,SAAS,cAAc,CAAC;AACtC,UAAM,WAAW,SAAS,OAAO,iBAAiB,CAAC;AAGnD,QAAI,CAAC,UAAU,GAAG,YAAY,EAAE,SAAS,WAAW,GAAG;AACrD,iBAAW,KAAK;AAAA,QACd,OAAO;AAAA,QACP,MAAM,SAAS,SAAS,SAAS,IAAI,OAAO,SAAS,CAAC,CAAC,IAAI,EAAE;AAAA,QAC7D,MAAM;AAAA,QACN,WAAW,MAAM;AAAA,QACjB,aAAa,MAAM;AAAA,QACnB,OAAO,qBAAqB,IAAI,UAAU,MAAM;AAAA,MAClD,CAAC;AAAA,IACH;AAGA,eAAW,WAAW,UAAU;AAC9B,UAAI,OAAO,YAAY,SAAU;AAEjC,UAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,EAAG;AAEpD,UAAI,CAAC,UAAU,QAAQ,YAAY,EAAE,SAAS,WAAW,GAAG;AAC1D,mBAAW,KAAK;AAAA,UACd,OAAO;AAAA,UACP,MAAM,SAAS,OAAO;AAAA,UACtB,MAAM;AAAA,UACN,UAAU;AAAA,UACV,WAAW,MAAM;AAAA,UACjB,aAAa,MAAM;AAAA,UACnB,OAAO,iBAAiB,SAAS,MAAM;AAAA,QACzC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,KAAK,CAAC,GAAG,MAAM;AACxB,QAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,WAAO,EAAE,MAAM,cAAc,EAAE,KAAK;AAAA,EACtC,CAAC;AAED,SAAO,WAAW,MAAM,GAAG,aAAa;AAC1C;AAGA,SAAS,eAAe,QAA4B,MAAsB;AACxE,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,aAAa,OAAO,QAAQ,SAAS,EAAE,EAAE,QAAQ,QAAQ,EAAE;AACjE,SAAO,aAAa,GAAG,UAAU,IAAI,IAAI,KAAK;AAChD;AAKO,SAAS,aAAa,YAA+C;AAC1E,SAAO,WAAW,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI;AAC3D;AAMA,SAAS,qBACP,IACA,UACA,QACQ;AACR,MAAI,QAAQ;AACZ,QAAM,QAAQ,SAAS,cAAc,CAAC;AAGtC,MAAI,MAAM,cAAc,YAAa,UAAS;AAC9C,MAAI,MAAM,gBAAgB,UAAW,UAAS;AAG9C,MAAI,MAAM,SAAS,SAAU,UAAS;AAGtC,MAAI,MAAM,cAAc,YAAa,UAAS;AAC9C,MAAI,MAAM,gBAAgB,YAAa,UAAS;AAGhD,MAAI,UAAU,GAAG,YAAY,EAAE,WAAW,OAAO,YAAY,CAAC,GAAG;AAC/D,aAAS;AAAA,EACX;AAEA,SAAO;AACT;AAEA,SAAS,iBAAiB,MAAc,QAAwB;AAC9D,MAAI,QAAQ;AAGZ,MAAI,UAAU,KAAK,YAAY,EAAE,WAAW,OAAO,YAAY,CAAC,GAAG;AACjE,aAAS;AAAA,EACX;AAGA,WAAS,KAAK,IAAI,GAAG,KAAK,KAAK,MAAM,GAAG,EAAE,SAAS,CAAC;AAEpD,SAAO;AACT;AAMA,eAAsB,qBACpB,iBACA,WACiB;AACjB,QAAM,SAAS,UAAU,KAAK;AAC9B,QAAM,aAAa,mBAAmB,QAAQ,EAAE,gBAAgB,CAAC;AACjE,SAAO,aAAa,UAAU;AAChC;AAoBA,eAAsB,8BACpB,UACA,SACA,WACA,gBAAgB,wBACC;AACjB,QAAM,SAAS,UAAU,KAAK;AAC9B,QAAM,QAAQ,iBAAiB,EAAE,SAAS,CAAC;AAC3C,QAAM,SAAoC,CAAC;AAE3C,aAAW,UAAU,SAAS;AAC5B,UAAM,QAAQ,MAAM,MAAM,KAAK,OAAO,UAAU,cAAc;AAC9D,QAAI,CAAC,MAAO;AACZ,WAAO;AAAA,MACL,GAAG,mBAAmB,QAAQ;AAAA,QAC5B,iBAAiB,MAAM;AAAA,QACvB,YAAY,OAAO;AAAA,QACnB,eAAe,OAAO;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO,KAAK,CAAC,GAAG,MAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,EAAE,KAAK,CAAE;AAChG,SAAO,aAAa,OAAO,MAAM,GAAG,aAAa,CAAC;AACpD;;;AC9MA,SAAS,eAAe;AAgCjB,SAAS,kBACd,UACA,SACA,eACU;AACV,MAAI,CAAC,SAAU,QAAO;AAGtB,QAAM,UAAU,SAAS,WAAW,GAAG,IACnC,WACA,QAAQ,eAAe,QAAQ;AAEnC,MAAI,OAAiB;AACrB,MAAI,gBAAgB;AAEpB,aAAW,UAAU,SAAS;AAC5B,UAAM,aAAa,OAAO;AAE1B,UAAM,SAAS,WAAW,SAAS,GAAG,IAAI,aAAa,aAAa;AAEpE,QAAI,QAAQ,WAAW,MAAM,KAAK,OAAO,SAAS,eAAe;AAC/D,aAAO;AACP,sBAAgB,OAAO;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AACT;AAkBO,SAAS,kBACd,UACA,YACA,eACQ;AACR,QAAM,UAAU,SAAS,WAAW,GAAG,IACnC,WACA,QAAQ,eAAe,QAAQ;AAEnC,QAAM,SAAS,WAAW,SAAS,GAAG,IAAI,aAAa,aAAa;AACpE,MAAI,QAAQ,WAAW,MAAM,GAAG;AAC9B,WAAO,QAAQ,MAAM,OAAO,MAAM;AAAA,EACpC;AAEA,SAAO;AACT;;;ACfA,SAAS,yBAAyB,SAA2B;AAC3D,QAAM,SAAmB,CAAC;AAC1B,aAAW,OAAO,QAAQ,MAAM,KAAK,GAAG;AACtC,UAAM,IAAI,IAAI,QAAQ,kBAAkB,EAAE;AAC1C,QAAI,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,SAAS,IAAI,IAAI;AAC9C,aAAO,KAAK,CAAC;AAAA,IACf;AAAA,EACF;AACA,SAAO;AACT;AA6BO,SAAS,iCACd,QACA;AASA,QAAM,gBAAgB,oBAAI,IAGxB;AAEF,iBAAe,gBAAgB,QAAyC;AACtE,QAAI,cAAc,IAAI,OAAO,IAAI,GAAG;AAClC,aAAO,cAAc,IAAI,OAAO,IAAI;AAAA,IACtC;AACA,UAAM,QAAQ,MAAM,yBAAyB;AAAA,MAC3C,UAAU,OAAO;AAAA,MACjB,UAAU,OAAO;AAAA,IACnB,CAAC;AAKD,UAAM,SAAS,QACX,EAAE,GAAG,OAAO,OAAO,8BAA8B,MAAM,cAAc,EAAE,IACvE;AACJ,kBAAc,IAAI,OAAO,MAAM,MAAM;AACrC,WAAO;AAAA,EACT;AAOA,WAAS,kBACP,SACmC;AACnC,eAAW,SAAS,yBAAyB,OAAO,GAAG;AACrD,YAAM,QAAQ;AAAA,QACZ;AAAA,QACA,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AACA,UAAI,MAAO,QAAO,CAAC,KAAK;AAAA,IAC1B;AACA,WAAO,OAAO;AAAA,EAChB;AAEA,SAAO,eAAe,0BACpB,OACqB;AAErB,QAAI,mBAAmB,KAAK,GAAG;AAC7B,YAAM,UAAU,MAAM,YAAY,WAAW;AAC7C,iBAAWC,WAAU,kBAAkB,OAAO,GAAG;AAC/C,cAAMC,SAAQ,MAAM,gBAAgBD,OAAM;AAC1C,YAAI,CAACC,QAAO;AACV,iBAAO;AAAA,YACL,0BAA0B,mBAAmB,WAAWD,QAAO,IAAI,GAAG;AAAA,UACxE;AAAA,QACF;AACA,cAAM,UAAUC,OAAM,MAAM,qBAAqB,EAAE,QAAQ,CAAC;AAC5D,YAAI,QAAQ,eAAe,QAAQ;AACjC,iBAAO,kBAAkB,QAAQ,YAAY;AAAA,QAC/C;AAAA,MACF;AAAA,IACF;AAIA,UAAM,WAAW,oBAAoB,KAAK;AAC1C,QAAI,CAAC,UAAU;AACb,aAAO,mBAAmB;AAAA,IAC5B;AAGA,UAAM,SAAS;AAAA,MACb;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AACA,QAAI,CAAC,QAAQ;AAEX,aAAO,mBAAmB;AAAA,IAC5B;AAGA,UAAM,QAAQ,MAAM,gBAAgB,MAAM;AAC1C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,QACL,0BAA0B,oBAAoB,WAAW,OAAO,IAAI,GAAG;AAAA,MACzE;AAAA,IACF;AAGA,UAAM,cAAc;AAAA,MAClB;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AAYA,UAAM,cAAc,MAAM,MAAM,cAAc;AAAA,MAC5C,WAAW;AAAA,MACX,SAAS,mBAAmB,MAAM,UAAU;AAAA,IAC9C,CAAC;AACD,QAAI,YAAY,eAAe,QAAQ;AACrC,aAAO,kBAAkB,YAAY,YAAY;AAAA,IACnD;AAGA,eAAW,SAAS,uBAAuB,aAAa,MAAM,eAAe,GAAG;AAC9E,YAAM,QAAQ,oBAAoB,KAAK;AACvC,UAAI,MAAM,WAAW;AACnB,eAAO,kBAAkB,MAAM,MAAM;AAAA,MACvC;AAAA,IACF;AAEA,WAAO,mBAAmB;AAAA,EAC5B;AACF;","names":["verdict","member","build"]}
@@ -0,0 +1,47 @@
1
+ // src/lib/navigation-index-prompt.ts
2
+ function isNavigationIndex(value) {
3
+ if (typeof value !== "object" || value === null) return false;
4
+ const obj = value;
5
+ return typeof obj.system === "object" && obj.system !== null && typeof obj.artifacts === "object" && obj.artifacts !== null;
6
+ }
7
+ function renderNavigationIndexPrompt(navigationIndex) {
8
+ const system = navigationIndex.system;
9
+ const artifacts = navigationIndex.artifacts ?? {};
10
+ const ids = Object.keys(artifacts);
11
+ const sections = ["## Project Navigation Index"];
12
+ const systemLabel = system?.name ? `${system.name}${system.id ? ` (${system.id})` : ""}` : system?.id ?? "unknown";
13
+ sections.push(
14
+ `System: ${systemLabel}
15
+ Artifacts: ${ids.length}`
16
+ );
17
+ if (ids.length > 0) {
18
+ const lines = [];
19
+ for (const id of ids) {
20
+ const node = artifacts[id] ?? {};
21
+ const props = node.properties ?? {};
22
+ const tags = [props.type, props.authority].filter((v) => typeof v === "string" && v.length > 0).join(", ");
23
+ const editPolicy = typeof props.manual_edit === "string" ? `, edit:${props.manual_edit}` : "";
24
+ lines.push(`- ${id}${tags || editPolicy ? ` [${tags}${editPolicy}]` : ""}`);
25
+ const patterns = node.files?.path_patterns;
26
+ if (Array.isArray(patterns) && patterns.length > 0) {
27
+ lines.push(` files: ${patterns.join(", ")}`);
28
+ }
29
+ const derived = node.relations?.derived_artifacts;
30
+ if (Array.isArray(derived) && derived.length > 0) {
31
+ lines.push(` derived \u2192 ${derived.join(", ")}`);
32
+ }
33
+ const owners = node.agents?.owners;
34
+ if (Array.isArray(owners) && owners.length > 0) {
35
+ lines.push(` owners: ${owners.join(", ")}`);
36
+ }
37
+ }
38
+ sections.push(lines.join("\n"));
39
+ }
40
+ return sections.join("\n\n");
41
+ }
42
+
43
+ export {
44
+ isNavigationIndex,
45
+ renderNavigationIndexPrompt
46
+ };
47
+ //# sourceMappingURL=chunk-3CLWG72V.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/navigation-index-prompt.ts"],"sourcesContent":["/**\n * Navigation-index (Level 1) presentation.\n *\n * Pure formatting over an already-built navigation index: no DSL loader, no\n * schema validation, no SDK. It lives in its own module because the interactive\n * hook path needs it while it must NOT pull `task-runner`'s graph (zod, yaml,\n * the plugin registry, the analyzer and observability bridges); the lean\n * `claude-native/hooks-lite` barrel re-exports it from here.\n */\n\n/** Minimal duck-typed shape of an artifact node in the navigation index. */\nexport interface NavigationArtifactNode {\n files?: { path_patterns?: string[] };\n properties?: { type?: string; authority?: string; manual_edit?: string };\n relations?: { source_artifacts?: string[]; derived_artifacts?: string[] };\n agents?: { owners?: string[]; editors?: string[]; readers?: string[] };\n}\n\n/**\n * Duck-type check: does `value` look like a ProjectNavigationIndex?\n * Requires a `system` object and an `artifacts` record.\n */\nexport function isNavigationIndex(\n value: unknown,\n): value is Record<string, unknown> {\n if (typeof value !== \"object\" || value === null) return false;\n const obj = value as Record<string, unknown>;\n return (\n typeof obj.system === \"object\" &&\n obj.system !== null &&\n typeof obj.artifacts === \"object\" &&\n obj.artifacts !== null\n );\n}\n\n/**\n * Render the Level 1 navigation index as a compact prompt section — a\n * human-readable SUMMARY of artifacts (type, authority, edit policy, key\n * relations and owning agents), NOT a raw JSON dump. Gives the agent a map of\n * the project's artifacts so it can navigate before acting.\n */\nexport function renderNavigationIndexPrompt(\n navigationIndex: Record<string, unknown>,\n): string {\n const system = navigationIndex.system as\n | { id?: string; name?: string }\n | undefined;\n const artifacts =\n (navigationIndex.artifacts as Record<string, NavigationArtifactNode>) ?? {};\n const ids = Object.keys(artifacts);\n\n const sections: string[] = [\"## Project Navigation Index\"];\n\n const systemLabel = system?.name\n ? `${system.name}${system.id ? ` (${system.id})` : \"\"}`\n : (system?.id ?? \"unknown\");\n sections.push(\n `System: ${systemLabel}\\nArtifacts: ${ids.length}`,\n );\n\n if (ids.length > 0) {\n const lines: string[] = [];\n for (const id of ids) {\n const node = artifacts[id] ?? {};\n const props = node.properties ?? {};\n const tags = [props.type, props.authority]\n .filter((v): v is string => typeof v === \"string\" && v.length > 0)\n .join(\", \");\n const editPolicy =\n typeof props.manual_edit === \"string\" ? `, edit:${props.manual_edit}` : \"\";\n lines.push(`- ${id}${tags || editPolicy ? ` [${tags}${editPolicy}]` : \"\"}`);\n\n const patterns = node.files?.path_patterns;\n if (Array.isArray(patterns) && patterns.length > 0) {\n lines.push(` files: ${patterns.join(\", \")}`);\n }\n\n const derived = node.relations?.derived_artifacts;\n if (Array.isArray(derived) && derived.length > 0) {\n lines.push(` derived → ${derived.join(\", \")}`);\n }\n\n const owners = node.agents?.owners;\n if (Array.isArray(owners) && owners.length > 0) {\n lines.push(` owners: ${owners.join(\", \")}`);\n }\n }\n sections.push(lines.join(\"\\n\"));\n }\n\n return sections.join(\"\\n\\n\");\n}\n"],"mappings":";AAsBO,SAAS,kBACd,OACkC;AAClC,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,MAAM;AACZ,SACE,OAAO,IAAI,WAAW,YACtB,IAAI,WAAW,QACf,OAAO,IAAI,cAAc,YACzB,IAAI,cAAc;AAEtB;AAQO,SAAS,4BACd,iBACQ;AACR,QAAM,SAAS,gBAAgB;AAG/B,QAAM,YACH,gBAAgB,aAAwD,CAAC;AAC5E,QAAM,MAAM,OAAO,KAAK,SAAS;AAEjC,QAAM,WAAqB,CAAC,6BAA6B;AAEzD,QAAM,cAAc,QAAQ,OACxB,GAAG,OAAO,IAAI,GAAG,OAAO,KAAK,KAAK,OAAO,EAAE,MAAM,EAAE,KAClD,QAAQ,MAAM;AACnB,WAAS;AAAA,IACP,WAAW,WAAW;AAAA,aAAgB,IAAI,MAAM;AAAA,EAClD;AAEA,MAAI,IAAI,SAAS,GAAG;AAClB,UAAM,QAAkB,CAAC;AACzB,eAAW,MAAM,KAAK;AACpB,YAAM,OAAO,UAAU,EAAE,KAAK,CAAC;AAC/B,YAAM,QAAQ,KAAK,cAAc,CAAC;AAClC,YAAM,OAAO,CAAC,MAAM,MAAM,MAAM,SAAS,EACtC,OAAO,CAAC,MAAmB,OAAO,MAAM,YAAY,EAAE,SAAS,CAAC,EAChE,KAAK,IAAI;AACZ,YAAM,aACJ,OAAO,MAAM,gBAAgB,WAAW,UAAU,MAAM,WAAW,KAAK;AAC1E,YAAM,KAAK,KAAK,EAAE,GAAG,QAAQ,aAAa,KAAK,IAAI,GAAG,UAAU,MAAM,EAAE,EAAE;AAE1E,YAAM,WAAW,KAAK,OAAO;AAC7B,UAAI,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS,GAAG;AAClD,cAAM,KAAK,YAAY,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,MAC9C;AAEA,YAAM,UAAU,KAAK,WAAW;AAChC,UAAI,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,GAAG;AAChD,cAAM,KAAK,oBAAe,QAAQ,KAAK,IAAI,CAAC,EAAE;AAAA,MAChD;AAEA,YAAM,SAAS,KAAK,QAAQ;AAC5B,UAAI,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,GAAG;AAC9C,cAAM,KAAK,aAAa,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,MAC7C;AAAA,IACF;AACA,aAAS,KAAK,MAAM,KAAK,IAAI,CAAC;AAAA,EAChC;AAEA,SAAO,SAAS,KAAK,MAAM;AAC7B;","names":[]}