@aaac/runtime 0.1.3 → 0.1.5
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.
- package/dist/adapters/adk-sdk.d.ts +2 -1
- package/dist/adapters/adk-sdk.js +18 -5
- package/dist/adapters/adk-sdk.js.map +1 -1
- package/dist/adapters/claude-agent-sdk.d.ts +2 -1
- package/dist/adapters/claude-agent-sdk.js +17 -0
- package/dist/adapters/claude-agent-sdk.js.map +1 -1
- package/dist/adapters/mock.d.ts +1 -1
- package/dist/adapters/openai-agents-sdk.d.ts +2 -1
- package/dist/adapters/openai-agents-sdk.js +22 -4
- package/dist/adapters/openai-agents-sdk.js.map +1 -1
- package/dist/chunk-ET6TGQRT.js +77 -0
- package/dist/chunk-ET6TGQRT.js.map +1 -0
- package/dist/chunk-LONLL3K2.js +94 -0
- package/dist/chunk-LONLL3K2.js.map +1 -0
- package/dist/index.d.ts +29 -17
- package/dist/index.js +30 -78
- package/dist/index.js.map +1 -1
- package/dist/schema-converter-LACA7P4O.js +7 -0
- package/dist/schema-converter-LACA7P4O.js.map +1 -0
- package/dist/{task-runner-CNj3Ujy0.d.ts → task-runner-szDOYtJV.d.ts} +24 -1
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-szDOYtJV.js';
|
|
2
2
|
import { G as GuardrailHooks } from '../guardrail-hooks-C8G5NGsj.js';
|
|
3
3
|
import 'zod';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -113,6 +113,7 @@ declare class AdkSdkAdapter implements SdkAdapter {
|
|
|
113
113
|
private resolveModel;
|
|
114
114
|
/** Build the root LlmAgent with candidate sub-agents registered for transfer. */
|
|
115
115
|
private buildRootAgent;
|
|
116
|
+
private resolveLibraryTools;
|
|
116
117
|
private runAgent;
|
|
117
118
|
private nextMemoryRef;
|
|
118
119
|
send(prompt: string, options: AdapterSendOptions): Promise<string>;
|
package/dist/adapters/adk-sdk.js
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import {
|
|
2
2
|
getBlockingViolations
|
|
3
3
|
} from "../chunk-MGRZBGQL.js";
|
|
4
|
+
import {
|
|
5
|
+
buildAdkFunctionTools
|
|
6
|
+
} from "../chunk-LONLL3K2.js";
|
|
4
7
|
|
|
5
8
|
// src/adapters/adk-sdk.ts
|
|
6
9
|
function sanitizeAgentName(name) {
|
|
@@ -54,7 +57,7 @@ var AdkSdkAdapter = class _AdkSdkAdapter {
|
|
|
54
57
|
return this.model;
|
|
55
58
|
}
|
|
56
59
|
/** Build the root LlmAgent with candidate sub-agents registered for transfer. */
|
|
57
|
-
buildRootAgent(sdk, instruction, agents) {
|
|
60
|
+
buildRootAgent(sdk, instruction, agents, extraTools) {
|
|
58
61
|
const subAgents = (agents ?? []).map((a) => {
|
|
59
62
|
const config = {
|
|
60
63
|
name: sanitizeAgentName(a.name),
|
|
@@ -71,9 +74,18 @@ var AdkSdkAdapter = class _AdkSdkAdapter {
|
|
|
71
74
|
model: this.resolveModel(sdk)
|
|
72
75
|
};
|
|
73
76
|
if (subAgents.length > 0) rootConfig.subAgents = subAgents;
|
|
77
|
+
if (extraTools && extraTools.length > 0) rootConfig.tools = extraTools;
|
|
74
78
|
return new sdk.LlmAgent(rootConfig);
|
|
75
79
|
}
|
|
76
|
-
async
|
|
80
|
+
async resolveLibraryTools(libraryTools) {
|
|
81
|
+
if (!libraryTools || libraryTools.getAll().length === 0) return [];
|
|
82
|
+
try {
|
|
83
|
+
return await buildAdkFunctionTools(libraryTools);
|
|
84
|
+
} catch {
|
|
85
|
+
return [];
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
async runAgent(instruction, userMessage, agents, onProgress, libraryTools) {
|
|
77
89
|
if (this.guardrailHooks) {
|
|
78
90
|
const results = this.guardrailHooks.runChecks({ command: userMessage });
|
|
79
91
|
const blocking = getBlockingViolations(results);
|
|
@@ -83,7 +95,8 @@ var AdkSdkAdapter = class _AdkSdkAdapter {
|
|
|
83
95
|
}
|
|
84
96
|
}
|
|
85
97
|
const sdk = await this.resolveSdk();
|
|
86
|
-
const
|
|
98
|
+
const extraTools = await this.resolveLibraryTools(libraryTools);
|
|
99
|
+
const root = this.buildRootAgent(sdk, instruction, agents, extraTools);
|
|
87
100
|
const runner = new sdk.InMemoryRunner({ agent: root });
|
|
88
101
|
let finalText = "";
|
|
89
102
|
const stream = runner.runEphemeral({
|
|
@@ -127,7 +140,7 @@ var AdkSdkAdapter = class _AdkSdkAdapter {
|
|
|
127
140
|
} else {
|
|
128
141
|
userMessage = prompt;
|
|
129
142
|
}
|
|
130
|
-
const text = await this.runAgent(instruction, userMessage, options.agents, options.onProgress);
|
|
143
|
+
const text = await this.runAgent(instruction, userMessage, options.agents, options.onProgress, options.libraryTools);
|
|
131
144
|
this.lastMemoryRef = this.nextMemoryRef();
|
|
132
145
|
return text;
|
|
133
146
|
}
|
|
@@ -143,7 +156,7 @@ var AdkSdkAdapter = class _AdkSdkAdapter {
|
|
|
143
156
|
userMessage = request.prompt;
|
|
144
157
|
}
|
|
145
158
|
const agents = request.options.agents ?? request.agents;
|
|
146
|
-
const text = await this.runAgent(instruction, userMessage, agents, request.options.onProgress);
|
|
159
|
+
const text = await this.runAgent(instruction, userMessage, agents, request.options.onProgress, request.options.libraryTools);
|
|
147
160
|
this.lastMemoryRef = this.nextMemoryRef();
|
|
148
161
|
return text;
|
|
149
162
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/adapters/adk-sdk.ts"],"sourcesContent":["/**\n * Google ADK Adapter — implements SdkAdapter for @google/adk (ADK-TS / adk-js)\n *\n * Replaces the raw @google/genai adapter. ADK provides a native subagent\n * mechanism (`LlmAgent.subAgents` + description-based agent transfer), which is\n * required for model B (LLM-internal routing): the entry agent's LLM delegates\n * to candidate sub-agents registered in the agent tree.\n *\n * Supports:\n * - send() — build a root LlmAgent (+ candidate subAgents), run once,\n * return the final response text\n * - sendExecution() — rich path using full contract context\n *\n * No followUp(): ADK's InMemoryRunner uses ephemeral sessions, so the runtime's\n * recovery loop falls back to a fresh send() with reconstructed context.\n *\n * API used (verified against the installed package's type definitions under\n * node_modules/@google/adk/dist/types):\n * - class LlmAgent (agents/llm_agent.d.ts): constructor(config) where config\n * extends BaseAgentConfig { name; description?; subAgents?: BaseAgent[] }\n * and adds { model?: string | BaseLlm; instruction?: string; tools? }.\n * - class InMemoryRunner (runner/in_memory_runner.d.ts): constructor({ agent,\n * appName? }); inherits runEphemeral({ userId, newMessage: Content })\n * returning AsyncGenerator<Event> (runner/runner.d.ts).\n * - isFinalResponse(event) / stringifyContent(event) (events/event.d.ts).\n * - class Gemini (models/google_llm.d.ts): constructor({ model, apiKey })\n * — used to inject an explicit API key; otherwise ADK reads\n * GOOGLE_GENAI_API_KEY / GEMINI_API_KEY from the environment.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.js\";\nimport { getBlockingViolations, type GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK surface (avoid a hard compile-time dependency on @google/adk)\n// ---------------------------------------------------------------------------\n\ntype AdkContentPart = {\n text?: string;\n functionCall?: { name?: string; args?: Record<string, unknown> };\n functionResponse?: { name?: string; response?: unknown };\n};\n\ntype AdkContent = {\n role?: string;\n parts?: AdkContentPart[];\n};\n\ntype AdkEvent = {\n author?: string;\n content?: AdkContent;\n [key: string]: unknown;\n};\n\ntype LlmAgentConfig = {\n name: string;\n description?: string;\n model?: string | object;\n instruction?: string;\n tools?: unknown[];\n subAgents?: unknown[];\n};\n\ntype LlmAgentInstance = object;\ntype LlmAgentConstructor = new (config: LlmAgentConfig) => LlmAgentInstance;\n\ntype RunnerInstance = {\n runEphemeral(params: {\n userId: string;\n newMessage: AdkContent;\n stateDelta?: Record<string, unknown>;\n }): AsyncGenerator<AdkEvent, void, unknown>;\n};\n\ntype InMemoryRunnerConstructor = new (params: {\n agent: LlmAgentInstance;\n appName?: string;\n}) => RunnerInstance;\n\ntype GeminiConstructor = new (params: { model?: string; apiKey?: string }) => object;\n\ninterface AdkSdk {\n LlmAgent: LlmAgentConstructor;\n InMemoryRunner: InMemoryRunnerConstructor;\n isFinalResponse: (event: AdkEvent) => boolean;\n stringifyContent: (event: AdkEvent) => string;\n Gemini: GeminiConstructor;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * ADK requires agent names to be valid JS identifiers, unique within the tree,\n * and not \"user\". DSL agent ids may contain hyphens, so sanitize to identifiers.\n */\nfunction sanitizeAgentName(name: string): string {\n let id = name.replace(/[^a-zA-Z0-9_]/g, \"_\");\n if (id.length === 0 || /^[0-9]/.test(id)) id = `agent_${id}`;\n if (id === \"user\") id = \"user_agent\";\n return id;\n}\n\n/** Concatenate text parts from an event's content. */\nfunction extractEventText(event: AdkEvent): string {\n const parts = event.content?.parts;\n if (!parts) return \"\";\n return parts.map((p) => p.text ?? \"\").join(\"\");\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface AdkSdkAdapterConfig {\n /** API key for the Gemini API. Falls back to GOOGLE_GENAI_API_KEY / GEMINI_API_KEY env. */\n apiKey?: string;\n /** Gemini model identifier (e.g. \"gemini-2.5-flash\", \"gemini-2.5-pro\"). */\n model?: string;\n /** Root agent name (must be a JS identifier). Defaults to \"root_agent\". */\n rootAgentName?: string;\n /** Runtime guardrail hooks. Applied as input-level checks before agent execution. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class AdkSdkAdapter implements SdkAdapter {\n private apiKey: string | undefined;\n private model: string;\n private rootAgentName: string;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastMemoryRef: MemoryRef | null = null;\n private runCounter = 0;\n\n private sdk: AdkSdk | null = null;\n\n constructor(config: AdkSdkAdapterConfig = {}) {\n this.apiKey = config.apiKey;\n this.model = config.model ?? \"gemini-2.5-flash\";\n this.rootAgentName = config.rootAgentName ?? \"root_agent\";\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<AdkSdk> {\n if (this.sdk) return this.sdk;\n\n const mod = (await import(\"@google/adk\")) as unknown as AdkSdk;\n this.sdk = {\n LlmAgent: mod.LlmAgent,\n InMemoryRunner: mod.InMemoryRunner,\n isFinalResponse: mod.isFinalResponse,\n stringifyContent: mod.stringifyContent,\n Gemini: mod.Gemini,\n };\n return this.sdk;\n }\n\n /** Resolve the `model` field for LlmAgent — a Gemini instance when an explicit\n * API key is supplied, otherwise the bare model id (ADK reads env keys). */\n private resolveModel(sdk: AdkSdk): string | object {\n if (this.apiKey) {\n return new sdk.Gemini({ model: this.model, apiKey: this.apiKey });\n }\n return this.model;\n }\n\n /** Build the root LlmAgent with candidate sub-agents registered for transfer. */\n private buildRootAgent(\n sdk: AdkSdk,\n instruction: string,\n agents?: CandidateAgent[],\n ): LlmAgentInstance {\n const subAgents = (agents ?? []).map((a) => {\n const config: LlmAgentConfig = {\n name: sanitizeAgentName(a.name),\n description: a.description,\n instruction: a.prompt,\n model: a.model ?? this.resolveModel(sdk),\n };\n if (a.tools) config.tools = a.tools;\n return new sdk.LlmAgent(config);\n });\n\n const rootConfig: LlmAgentConfig = {\n name: sanitizeAgentName(this.rootAgentName),\n instruction,\n model: this.resolveModel(sdk),\n };\n if (subAgents.length > 0) rootConfig.subAgents = subAgents;\n\n return new sdk.LlmAgent(rootConfig);\n }\n\n private async runAgent(\n instruction: string,\n userMessage: string,\n agents: CandidateAgent[] | undefined,\n onProgress?: (event: AgentProgressEvent) => void,\n ): Promise<string> {\n if (this.guardrailHooks) {\n const results = this.guardrailHooks.runChecks({ command: userMessage });\n const blocking = getBlockingViolations(results);\n if (blocking.length > 0) {\n const msg = blocking.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n throw new Error(msg);\n }\n }\n\n const sdk = await this.resolveSdk();\n const root = this.buildRootAgent(sdk, instruction, agents);\n const runner = new sdk.InMemoryRunner({ agent: root });\n\n let finalText = \"\";\n const stream = runner.runEphemeral({\n userId: \"agent-runtime\",\n newMessage: { role: \"user\", parts: [{ text: userMessage }] },\n });\n\n for await (const event of stream) {\n if (onProgress) emitProgressFromAdkEvent(event, onProgress);\n\n const ev = event as Record<string, unknown>;\n if (ev.errorCode || ev.errorMessage) {\n throw new Error(\n `Gemini API error (${ev.errorCode ?? \"unknown\"}): ${ev.errorMessage ?? \"no details\"}`,\n );\n }\n\n if (sdk.isFinalResponse(event) && event.content) {\n const text = sdk.stringifyContent(event) || extractEventText(event);\n if (text) finalText = text;\n }\n }\n\n return finalText;\n }\n\n private nextMemoryRef(): MemoryRef {\n return {\n id: `adk-run-${++this.runCounter}-${Date.now()}`,\n provider: \"google-adk\",\n compat: `google-adk@${this.model}`,\n created_at: new Date().toISOString(),\n };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(prompt: string, options: AdapterSendOptions): Promise<string> {\n this.lastMemoryRef = null;\n\n const split = options.splitPrompt;\n let instruction = \"\";\n let userMessage: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instruction = split.system.join(\"\\n\\n---\\n\\n\");\n userMessage = split.user;\n } else {\n userMessage = prompt;\n }\n\n const text = await this.runAgent(instruction, userMessage, options.agents, options.onProgress);\n this.lastMemoryRef = this.nextMemoryRef();\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastMemoryRef = null;\n\n const split = request.splitPrompt;\n let instruction = \"\";\n let userMessage: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instruction = split.system.join(\"\\n\\n---\\n\\n\");\n userMessage = split.user;\n } else {\n userMessage = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const text = await this.runAgent(instruction, userMessage, agents, request.options.onProgress);\n this.lastMemoryRef = this.nextMemoryRef();\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"google-adk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject the resolved ADK SDK surface for testing.\n * Bypasses the dynamic import of @google/adk and the API key requirement.\n */\n static withSdk(sdk: AdkSdk, config?: AdkSdkAdapterConfig): AdkSdkAdapter {\n const adapter = new AdkSdkAdapter(config);\n adapter.sdk = sdk;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromAdkEvent(\n event: AdkEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n const parts = event.content?.parts;\n if (!parts) return;\n for (const part of parts) {\n if (part.functionCall?.name) {\n onProgress({ type: \"tool_use\", tool_name: part.functionCall.name, input: part.functionCall.args });\n } else if (part.functionResponse?.name) {\n onProgress({ type: \"tool_result\", tool_name: part.functionResponse.name });\n } else if (part.text) {\n onProgress({ type: \"text\", message: part.text });\n }\n }\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/adapters/adk-sdk.ts"],"sourcesContent":["/**\n * Google ADK Adapter — implements SdkAdapter for @google/adk (ADK-TS / adk-js)\n *\n * Replaces the raw @google/genai adapter. ADK provides a native subagent\n * mechanism (`LlmAgent.subAgents` + description-based agent transfer), which is\n * required for model B (LLM-internal routing): the entry agent's LLM delegates\n * to candidate sub-agents registered in the agent tree.\n *\n * Supports:\n * - send() — build a root LlmAgent (+ candidate subAgents), run once,\n * return the final response text\n * - sendExecution() — rich path using full contract context\n *\n * No followUp(): ADK's InMemoryRunner uses ephemeral sessions, so the runtime's\n * recovery loop falls back to a fresh send() with reconstructed context.\n *\n * API used (verified against the installed package's type definitions under\n * node_modules/@google/adk/dist/types):\n * - class LlmAgent (agents/llm_agent.d.ts): constructor(config) where config\n * extends BaseAgentConfig { name; description?; subAgents?: BaseAgent[] }\n * and adds { model?: string | BaseLlm; instruction?: string; tools? }.\n * - class InMemoryRunner (runner/in_memory_runner.d.ts): constructor({ agent,\n * appName? }); inherits runEphemeral({ userId, newMessage: Content })\n * returning AsyncGenerator<Event> (runner/runner.d.ts).\n * - isFinalResponse(event) / stringifyContent(event) (events/event.d.ts).\n * - class Gemini (models/google_llm.d.ts): constructor({ model, apiKey })\n * — used to inject an explicit API key; otherwise ADK reads\n * GOOGLE_GENAI_API_KEY / GEMINI_API_KEY from the environment.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.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 { buildAdkFunctionTools } from \"../lib/library-tool-sdk.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK surface (avoid a hard compile-time dependency on @google/adk)\n// ---------------------------------------------------------------------------\n\ntype AdkContentPart = {\n text?: string;\n functionCall?: { name?: string; args?: Record<string, unknown> };\n functionResponse?: { name?: string; response?: unknown };\n};\n\ntype AdkContent = {\n role?: string;\n parts?: AdkContentPart[];\n};\n\ntype AdkEvent = {\n author?: string;\n content?: AdkContent;\n [key: string]: unknown;\n};\n\ntype LlmAgentConfig = {\n name: string;\n description?: string;\n model?: string | object;\n instruction?: string;\n tools?: unknown[];\n subAgents?: unknown[];\n};\n\ntype LlmAgentInstance = object;\ntype LlmAgentConstructor = new (config: LlmAgentConfig) => LlmAgentInstance;\n\ntype RunnerInstance = {\n runEphemeral(params: {\n userId: string;\n newMessage: AdkContent;\n stateDelta?: Record<string, unknown>;\n }): AsyncGenerator<AdkEvent, void, unknown>;\n};\n\ntype InMemoryRunnerConstructor = new (params: {\n agent: LlmAgentInstance;\n appName?: string;\n}) => RunnerInstance;\n\ntype GeminiConstructor = new (params: { model?: string; apiKey?: string }) => object;\n\ninterface AdkSdk {\n LlmAgent: LlmAgentConstructor;\n InMemoryRunner: InMemoryRunnerConstructor;\n isFinalResponse: (event: AdkEvent) => boolean;\n stringifyContent: (event: AdkEvent) => string;\n Gemini: GeminiConstructor;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * ADK requires agent names to be valid JS identifiers, unique within the tree,\n * and not \"user\". DSL agent ids may contain hyphens, so sanitize to identifiers.\n */\nfunction sanitizeAgentName(name: string): string {\n let id = name.replace(/[^a-zA-Z0-9_]/g, \"_\");\n if (id.length === 0 || /^[0-9]/.test(id)) id = `agent_${id}`;\n if (id === \"user\") id = \"user_agent\";\n return id;\n}\n\n/** Concatenate text parts from an event's content. */\nfunction extractEventText(event: AdkEvent): string {\n const parts = event.content?.parts;\n if (!parts) return \"\";\n return parts.map((p) => p.text ?? \"\").join(\"\");\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface AdkSdkAdapterConfig {\n /** API key for the Gemini API. Falls back to GOOGLE_GENAI_API_KEY / GEMINI_API_KEY env. */\n apiKey?: string;\n /** Gemini model identifier (e.g. \"gemini-2.5-flash\", \"gemini-2.5-pro\"). */\n model?: string;\n /** Root agent name (must be a JS identifier). Defaults to \"root_agent\". */\n rootAgentName?: string;\n /** Runtime guardrail hooks. Applied as input-level checks before agent execution. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class AdkSdkAdapter implements SdkAdapter {\n private apiKey: string | undefined;\n private model: string;\n private rootAgentName: string;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastMemoryRef: MemoryRef | null = null;\n private runCounter = 0;\n\n private sdk: AdkSdk | null = null;\n\n constructor(config: AdkSdkAdapterConfig = {}) {\n this.apiKey = config.apiKey;\n this.model = config.model ?? \"gemini-2.5-flash\";\n this.rootAgentName = config.rootAgentName ?? \"root_agent\";\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<AdkSdk> {\n if (this.sdk) return this.sdk;\n\n const mod = (await import(\"@google/adk\")) as unknown as AdkSdk;\n this.sdk = {\n LlmAgent: mod.LlmAgent,\n InMemoryRunner: mod.InMemoryRunner,\n isFinalResponse: mod.isFinalResponse,\n stringifyContent: mod.stringifyContent,\n Gemini: mod.Gemini,\n };\n return this.sdk;\n }\n\n /** Resolve the `model` field for LlmAgent — a Gemini instance when an explicit\n * API key is supplied, otherwise the bare model id (ADK reads env keys). */\n private resolveModel(sdk: AdkSdk): string | object {\n if (this.apiKey) {\n return new sdk.Gemini({ model: this.model, apiKey: this.apiKey });\n }\n return this.model;\n }\n\n /** Build the root LlmAgent with candidate sub-agents registered for transfer. */\n private buildRootAgent(\n sdk: AdkSdk,\n instruction: string,\n agents?: CandidateAgent[],\n extraTools?: unknown[],\n ): LlmAgentInstance {\n const subAgents = (agents ?? []).map((a) => {\n const config: LlmAgentConfig = {\n name: sanitizeAgentName(a.name),\n description: a.description,\n instruction: a.prompt,\n model: a.model ?? this.resolveModel(sdk),\n };\n if (a.tools) config.tools = a.tools;\n return new sdk.LlmAgent(config);\n });\n\n const rootConfig: LlmAgentConfig = {\n name: sanitizeAgentName(this.rootAgentName),\n instruction,\n model: this.resolveModel(sdk),\n };\n if (subAgents.length > 0) rootConfig.subAgents = subAgents;\n if (extraTools && extraTools.length > 0) rootConfig.tools = extraTools;\n\n return new sdk.LlmAgent(rootConfig);\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 buildAdkFunctionTools(libraryTools);\n } catch {\n return [];\n }\n }\n\n private async runAgent(\n instruction: string,\n userMessage: string,\n agents: CandidateAgent[] | undefined,\n onProgress?: (event: AgentProgressEvent) => void,\n libraryTools?: LibraryToolRegistry,\n ): Promise<string> {\n if (this.guardrailHooks) {\n const results = this.guardrailHooks.runChecks({ command: userMessage });\n const blocking = getBlockingViolations(results);\n if (blocking.length > 0) {\n const msg = blocking.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n throw new Error(msg);\n }\n }\n\n const sdk = await this.resolveSdk();\n const extraTools = await this.resolveLibraryTools(libraryTools);\n const root = this.buildRootAgent(sdk, instruction, agents, extraTools);\n const runner = new sdk.InMemoryRunner({ agent: root });\n\n let finalText = \"\";\n const stream = runner.runEphemeral({\n userId: \"agent-runtime\",\n newMessage: { role: \"user\", parts: [{ text: userMessage }] },\n });\n\n for await (const event of stream) {\n if (onProgress) emitProgressFromAdkEvent(event, onProgress);\n\n const ev = event as Record<string, unknown>;\n if (ev.errorCode || ev.errorMessage) {\n throw new Error(\n `Gemini API error (${ev.errorCode ?? \"unknown\"}): ${ev.errorMessage ?? \"no details\"}`,\n );\n }\n\n if (sdk.isFinalResponse(event) && event.content) {\n const text = sdk.stringifyContent(event) || extractEventText(event);\n if (text) finalText = text;\n }\n }\n\n return finalText;\n }\n\n private nextMemoryRef(): MemoryRef {\n return {\n id: `adk-run-${++this.runCounter}-${Date.now()}`,\n provider: \"google-adk\",\n compat: `google-adk@${this.model}`,\n created_at: new Date().toISOString(),\n };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(prompt: string, options: AdapterSendOptions): Promise<string> {\n this.lastMemoryRef = null;\n\n const split = options.splitPrompt;\n let instruction = \"\";\n let userMessage: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instruction = split.system.join(\"\\n\\n---\\n\\n\");\n userMessage = split.user;\n } else {\n userMessage = prompt;\n }\n\n const text = await this.runAgent(instruction, userMessage, options.agents, options.onProgress, options.libraryTools);\n this.lastMemoryRef = this.nextMemoryRef();\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastMemoryRef = null;\n\n const split = request.splitPrompt;\n let instruction = \"\";\n let userMessage: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instruction = split.system.join(\"\\n\\n---\\n\\n\");\n userMessage = split.user;\n } else {\n userMessage = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const text = await this.runAgent(instruction, userMessage, agents, request.options.onProgress, request.options.libraryTools);\n this.lastMemoryRef = this.nextMemoryRef();\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"google-adk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject the resolved ADK SDK surface for testing.\n * Bypasses the dynamic import of @google/adk and the API key requirement.\n */\n static withSdk(sdk: AdkSdk, config?: AdkSdkAdapterConfig): AdkSdkAdapter {\n const adapter = new AdkSdkAdapter(config);\n adapter.sdk = sdk;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromAdkEvent(\n event: AdkEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n const parts = event.content?.parts;\n if (!parts) return;\n for (const part of parts) {\n if (part.functionCall?.name) {\n onProgress({ type: \"tool_use\", tool_name: part.functionCall.name, input: part.functionCall.args });\n } else if (part.functionResponse?.name) {\n onProgress({ type: \"tool_result\", tool_name: part.functionResponse.name });\n } else if (part.text) {\n onProgress({ type: \"text\", message: part.text });\n }\n }\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-szDOYtJV.js';
|
|
2
2
|
import { G as GuardrailHooks } from '../guardrail-hooks-C8G5NGsj.js';
|
|
3
3
|
import 'zod';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -81,6 +81,7 @@ declare class ClaudeAgentSdkAdapter implements SdkAdapter {
|
|
|
81
81
|
constructor(config?: ClaudeAgentSdkAdapterConfig);
|
|
82
82
|
private resolveQueryFn;
|
|
83
83
|
private buildOptions;
|
|
84
|
+
private attachLibraryTools;
|
|
84
85
|
private runQuery;
|
|
85
86
|
send(prompt: string, options: AdapterSendOptions): Promise<string>;
|
|
86
87
|
followUp(message: string): Promise<string>;
|
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
import {
|
|
2
|
+
buildClaudeMcpServer
|
|
3
|
+
} from "../chunk-LONLL3K2.js";
|
|
4
|
+
|
|
1
5
|
// src/adapters/claude-agent-sdk.ts
|
|
2
6
|
function buildClaudeHooks(guardrails) {
|
|
3
7
|
const preToolUseHook = {
|
|
@@ -121,6 +125,17 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
121
125
|
}
|
|
122
126
|
return opts;
|
|
123
127
|
}
|
|
128
|
+
async attachLibraryTools(opts, libraryTools) {
|
|
129
|
+
if (!libraryTools || libraryTools.getAll().length === 0) return;
|
|
130
|
+
try {
|
|
131
|
+
const server = await buildClaudeMcpServer(libraryTools);
|
|
132
|
+
if (server) {
|
|
133
|
+
const existing = opts.mcpServers ?? [];
|
|
134
|
+
opts.mcpServers = [...existing, server];
|
|
135
|
+
}
|
|
136
|
+
} catch {
|
|
137
|
+
}
|
|
138
|
+
}
|
|
124
139
|
async runQuery(prompt, options, onProgress) {
|
|
125
140
|
const queryFn = await this.resolveQueryFn();
|
|
126
141
|
const stream = queryFn({ prompt, options });
|
|
@@ -150,6 +165,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
150
165
|
const systemPrompt = split?.system;
|
|
151
166
|
const userPrompt = split ? split.user : prompt;
|
|
152
167
|
const opts = this.buildOptions(options.readonly, void 0, systemPrompt, options.agents, options.allowDynamicWorkflow);
|
|
168
|
+
await this.attachLibraryTools(opts, options.libraryTools);
|
|
153
169
|
const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress);
|
|
154
170
|
this.lastSessionId = sessionId;
|
|
155
171
|
this.lastMemoryRef = {
|
|
@@ -178,6 +194,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
178
194
|
const userPrompt = split ? split.user : request.prompt;
|
|
179
195
|
const agents = request.options.agents ?? request.agents;
|
|
180
196
|
const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);
|
|
197
|
+
await this.attachLibraryTools(opts, request.options.libraryTools);
|
|
181
198
|
const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress);
|
|
182
199
|
this.lastSessionId = sessionId;
|
|
183
200
|
this.lastMemoryRef = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/adapters/claude-agent-sdk.ts"],"sourcesContent":["/**\n * Claude Agent SDK Adapter — implements SdkAdapter for @anthropic-ai/claude-agent-sdk\n *\n * Uses the `query()` function from the Claude Agent SDK to run Claude as a\n * stateful coding agent with tool execution (Read, Edit, Bash, etc.).\n *\n * Supports:\n * - send() — start a new query session and return the result text\n * - followUp() — resume the same session for output-format corrections\n * - sendExecution() — rich path using full contract context\n *\n * The SDK returns an AsyncGenerator of SDKMessage events. The adapter iterates\n * the stream, extracts the final result text from the SDKResultSuccess message,\n * and captures the session_id for followUp via `resume`.\n *\n * GuardrailHooks are mapped to the SDK's PreToolUse hook 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 { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\n\n/**\n * Subset of the Claude Agent SDK `AgentDefinition` shape we populate.\n * Verified against node_modules/@anthropic-ai/claude-agent-sdk/sdk.d.ts:38\n * (`description`, `prompt`, optional `tools`, `model`).\n */\ntype ClaudeAgentDefinition = {\n description: string;\n prompt: string;\n tools?: string[];\n model?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on zod v4)\n// ---------------------------------------------------------------------------\n\ntype SDKResultSuccess = {\n type: \"result\";\n subtype: \"success\";\n result: string;\n session_id: string;\n};\n\ntype SDKResultError = {\n type: \"result\";\n subtype: \"error\";\n error: string;\n session_id: string;\n};\n\ntype SDKContentBlock = {\n type: string;\n name?: string;\n text?: string;\n input?: unknown;\n};\n\ntype SDKBetaMessage = {\n content?: SDKContentBlock[];\n};\n\ntype SDKMessage = {\n type: string;\n subtype?: string;\n result?: string;\n error?: string;\n session_id?: string;\n tool_name?: string;\n summary?: string;\n message?: SDKBetaMessage;\n};\n\ntype HookCallbackInput = {\n hook_event_name: string;\n tool_name: string;\n tool_input: unknown;\n [key: string]: unknown;\n};\n\ntype HookCallbackOutput = {\n hookEventName: string;\n permissionDecision?: \"allow\" | \"deny\" | \"ask\";\n permissionDecisionReason?: string;\n additionalContext?: string;\n};\n\ntype HookCallbackMatcher = {\n tool_name?: string;\n hooks: Array<(input: HookCallbackInput) => HookCallbackOutput | Promise<HookCallbackOutput>>;\n};\n\ntype QueryOptions = Record<string, unknown>;\n\ntype QueryFn = (params: {\n prompt: string;\n options?: QueryOptions;\n}) => AsyncGenerator<SDKMessage, void>;\n\n// ---------------------------------------------------------------------------\n// Guardrail hook bridge\n// ---------------------------------------------------------------------------\n\nfunction buildClaudeHooks(\n guardrails: GuardrailHooks,\n): Partial<Record<string, HookCallbackMatcher[]>> {\n const preToolUseHook: HookCallbackMatcher = {\n hooks: [\n (input: HookCallbackInput): HookCallbackOutput => {\n const toolInput = input.tool_input as Record<string, unknown> | undefined;\n const toolName = input.tool_name;\n\n if (toolName === \"Bash\" || toolName === \"Shell\") {\n const command = (toolInput?.command ?? toolInput?.input) as string | undefined;\n if (command) {\n const result = guardrails.beforeShellExecution({ command });\n if (result.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: result.user_message ?? result.agent_message,\n };\n }\n if (result.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: result.additionalContext };\n }\n }\n }\n\n const filePath = (toolInput?.file_path ?? toolInput?.path) as string | undefined;\n if (filePath) {\n const pathResult = guardrails.preToolUse({\n tool_name: toolName,\n tool_input: { file_path: filePath },\n });\n if (pathResult.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: pathResult.user_message ?? pathResult.agent_message,\n };\n }\n if (pathResult.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: pathResult.additionalContext };\n }\n }\n\n return { hookEventName: \"PreToolUse\" };\n },\n ],\n };\n\n return { PreToolUse: [preToolUseHook] };\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface ClaudeAgentSdkAdapterConfig {\n /** Working directory for the agent. Defaults to process.cwd(). */\n cwd?: string;\n /** Model identifier (e.g. \"claude-sonnet-4-20250514\"). Uses SDK default if omitted. */\n model?: string;\n /**\n * Available tools. Defaults to read-only or read-write set based on AdapterSendOptions.\n * Set to `{ type: 'preset', preset: 'claude_code' }` for all Claude Code tools.\n */\n tools?: string[] | { type: \"preset\"; preset: \"claude_code\" };\n /** Permission mode. Defaults to \"bypassPermissions\" for automated workflows. */\n permissionMode?: \"default\" | \"acceptEdits\" | \"bypassPermissions\" | \"plan\";\n /** Max turns before stopping. */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via PreToolUse SDK hooks. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class ClaudeAgentSdkAdapter implements SdkAdapter {\n private cwd: string;\n private model: string | undefined;\n private tools: string[] | { type: \"preset\"; preset: \"claude_code\" } | undefined;\n private permissionMode: string;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastSessionId: string | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private queryFn: QueryFn | null = null;\n\n constructor(config: ClaudeAgentSdkAdapterConfig = {}) {\n this.cwd = config.cwd ?? process.cwd();\n this.model = config.model;\n this.tools = config.tools;\n this.permissionMode = config.permissionMode ?? \"bypassPermissions\";\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveQueryFn(): Promise<QueryFn> {\n if (this.queryFn) return this.queryFn;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as {\n query: QueryFn;\n };\n this.queryFn = sdk.query;\n return this.queryFn;\n }\n\n private buildOptions(\n readonly: boolean,\n resume?: string,\n systemPrompt?: string[],\n agents?: CandidateAgent[],\n allowDynamicWorkflow?: boolean,\n ): QueryOptions {\n const opts: QueryOptions = {\n cwd: this.cwd,\n permissionMode: this.permissionMode,\n allowDangerouslySkipPermissions: this.permissionMode === \"bypassPermissions\",\n // SDK isolation: do not load ambient .claude/ settings, skills, or agents\n // from disk. The runtime injects everything in-code, so disk discovery\n // would break component isolation and reproducibility.\n settingSources: [],\n };\n\n if (this.model) opts.model = this.model;\n if (this.maxTurns) opts.maxTurns = this.maxTurns;\n\n let toolList: string[] | { type: \"preset\"; preset: \"claude_code\" };\n if (this.tools) {\n toolList = Array.isArray(this.tools) ? [...this.tools] : this.tools;\n } else {\n toolList = readonly\n ? [\"Read\", \"Glob\", \"Grep\"]\n : [\"Read\", \"Glob\", \"Grep\", \"Edit\", \"Write\", \"Bash\"];\n }\n\n // When candidate sub-agents are registered (model B), the entry agent needs\n // the sub-agent delegation tool to invoke them. The restricted tool list\n // above omits it, so add it explicitly — otherwise the LLM has no way to\n // delegate. The SDK names this tool \"Task\"/\"Agent\" (docs use both; tool_use\n // events surface it as \"Agent\"), so allow both for robustness across\n // SDK versions. (A \"preset\" tools config already includes it.)\n if (agents && agents.length > 0 && Array.isArray(toolList)) {\n for (const t of [\"Task\", \"Agent\"]) {\n if (!toolList.includes(t)) toolList.push(t);\n }\n }\n\n if (allowDynamicWorkflow && Array.isArray(toolList)) {\n if (!toolList.includes(\"Workflow\")) toolList.push(\"Workflow\");\n }\n opts.tools = toolList;\n\n if (resume) opts.resume = resume;\n\n if (systemPrompt && this.cacheConfig.enabled !== false) {\n opts.systemPrompt = systemPrompt;\n }\n\n // Register candidate sub-agents so the LLM can delegate via the Agent/Task\n // tool (model B, LLM-internal routing). Keyed by candidate name.\n if (agents && agents.length > 0) {\n const record: Record<string, ClaudeAgentDefinition> = {};\n for (const a of agents) {\n record[a.name] = {\n description: a.description,\n prompt: a.prompt,\n ...(a.tools ? { tools: a.tools } : {}),\n ...(a.model ? { model: a.model } : {}),\n };\n }\n opts.agents = record;\n }\n\n if (this.guardrailHooks) {\n opts.hooks = buildClaudeHooks(this.guardrailHooks);\n }\n\n return opts;\n }\n\n private async runQuery(\n prompt: string,\n options: QueryOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n ): Promise<{ text: string; sessionId: string }> {\n const queryFn = await this.resolveQueryFn();\n const stream = queryFn({ prompt, options });\n\n let resultText = \"\";\n let sessionId = \"\";\n\n for await (const message of stream) {\n if (message.session_id) sessionId = message.session_id;\n if (message.type === \"result\") {\n if (message.subtype === \"success\") {\n resultText = (message as SDKResultSuccess).result;\n } else if (message.subtype === \"error\") {\n throw new Error(`Claude Agent SDK error: ${(message as SDKResultError).error}`);\n }\n } else if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n }\n\n return { text: resultText, sessionId };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const split = options.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : prompt;\n const opts = this.buildOptions(options.readonly, undefined, systemPrompt, options.agents, options.allowDynamicWorkflow);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n };\n return text;\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastSessionId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n const opts = this.buildOptions(false, this.lastSessionId);\n const { text, sessionId } = await this.runQuery(message, opts);\n this.lastSessionId = sessionId;\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const resume = request.memoryRef?.id;\n const split = request.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : request.prompt;\n const agents = request.options.agents ?? request.agents;\n const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n };\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"claude-agent-sdk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject a custom query function for testing.\n * Bypasses the dynamic import of @anthropic-ai/claude-agent-sdk.\n */\n static withQueryFn(\n queryFn: QueryFn,\n config?: ClaudeAgentSdkAdapterConfig,\n ): ClaudeAgentSdkAdapter {\n const adapter = new ClaudeAgentSdkAdapter(config);\n adapter.queryFn = queryFn;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromSdkMessage(\n message: SDKMessage,\n onProgress: (event: AgentProgressEvent) => void,\n sessionId?: string,\n): void {\n const sid = message.session_id ?? sessionId;\n switch (message.type) {\n case \"assistant\": {\n const content = message.message?.content;\n if (!content) break;\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n const input = block.input && typeof block.input === \"object\"\n ? block.input as Record<string, unknown>\n : undefined;\n onProgress({ type: \"tool_use\", tool_name: block.name, input, session_id: sid });\n } else if (block.type === \"text\" && block.text) {\n onProgress({ type: \"text\", message: block.text, session_id: sid });\n }\n }\n break;\n }\n case \"tool_progress\":\n if (message.tool_name) {\n onProgress({ type: \"tool_use\", tool_name: message.tool_name, session_id: sid });\n }\n break;\n case \"tool_use_summary\":\n if (message.summary) {\n onProgress({ type: \"status\", message: message.summary, session_id: sid });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/adapters/claude-agent-sdk.ts"],"sourcesContent":["/**\n * Claude Agent SDK Adapter — implements SdkAdapter for @anthropic-ai/claude-agent-sdk\n *\n * Uses the `query()` function from the Claude Agent SDK to run Claude as a\n * stateful coding agent with tool execution (Read, Edit, Bash, etc.).\n *\n * Supports:\n * - send() — start a new query session and return the result text\n * - followUp() — resume the same session for output-format corrections\n * - sendExecution() — rich path using full contract context\n *\n * The SDK returns an AsyncGenerator of SDKMessage events. The adapter iterates\n * the stream, extracts the final result text from the SDKResultSuccess message,\n * and captures the session_id for followUp via `resume`.\n *\n * GuardrailHooks are mapped to the SDK's PreToolUse hook 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 { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\nimport type { LibraryToolRegistry } from \"../lib/library-tool-binding.js\";\nimport { buildClaudeMcpServer } from \"../lib/library-tool-sdk.js\";\n\n/**\n * Subset of the Claude Agent SDK `AgentDefinition` shape we populate.\n * Verified against node_modules/@anthropic-ai/claude-agent-sdk/sdk.d.ts:38\n * (`description`, `prompt`, optional `tools`, `model`).\n */\ntype ClaudeAgentDefinition = {\n description: string;\n prompt: string;\n tools?: string[];\n model?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on zod v4)\n// ---------------------------------------------------------------------------\n\ntype SDKResultSuccess = {\n type: \"result\";\n subtype: \"success\";\n result: string;\n session_id: string;\n};\n\ntype SDKResultError = {\n type: \"result\";\n subtype: \"error\";\n error: string;\n session_id: string;\n};\n\ntype SDKContentBlock = {\n type: string;\n name?: string;\n text?: string;\n input?: unknown;\n};\n\ntype SDKBetaMessage = {\n content?: SDKContentBlock[];\n};\n\ntype SDKMessage = {\n type: string;\n subtype?: string;\n result?: string;\n error?: string;\n session_id?: string;\n tool_name?: string;\n summary?: string;\n message?: SDKBetaMessage;\n};\n\ntype HookCallbackInput = {\n hook_event_name: string;\n tool_name: string;\n tool_input: unknown;\n [key: string]: unknown;\n};\n\ntype HookCallbackOutput = {\n hookEventName: string;\n permissionDecision?: \"allow\" | \"deny\" | \"ask\";\n permissionDecisionReason?: string;\n additionalContext?: string;\n};\n\ntype HookCallbackMatcher = {\n tool_name?: string;\n hooks: Array<(input: HookCallbackInput) => HookCallbackOutput | Promise<HookCallbackOutput>>;\n};\n\ntype QueryOptions = Record<string, unknown>;\n\ntype QueryFn = (params: {\n prompt: string;\n options?: QueryOptions;\n}) => AsyncGenerator<SDKMessage, void>;\n\n// ---------------------------------------------------------------------------\n// Guardrail hook bridge\n// ---------------------------------------------------------------------------\n\nfunction buildClaudeHooks(\n guardrails: GuardrailHooks,\n): Partial<Record<string, HookCallbackMatcher[]>> {\n const preToolUseHook: HookCallbackMatcher = {\n hooks: [\n (input: HookCallbackInput): HookCallbackOutput => {\n const toolInput = input.tool_input as Record<string, unknown> | undefined;\n const toolName = input.tool_name;\n\n if (toolName === \"Bash\" || toolName === \"Shell\") {\n const command = (toolInput?.command ?? toolInput?.input) as string | undefined;\n if (command) {\n const result = guardrails.beforeShellExecution({ command });\n if (result.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: result.user_message ?? result.agent_message,\n };\n }\n if (result.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: result.additionalContext };\n }\n }\n }\n\n const filePath = (toolInput?.file_path ?? toolInput?.path) as string | undefined;\n if (filePath) {\n const pathResult = guardrails.preToolUse({\n tool_name: toolName,\n tool_input: { file_path: filePath },\n });\n if (pathResult.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: pathResult.user_message ?? pathResult.agent_message,\n };\n }\n if (pathResult.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: pathResult.additionalContext };\n }\n }\n\n return { hookEventName: \"PreToolUse\" };\n },\n ],\n };\n\n return { PreToolUse: [preToolUseHook] };\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface ClaudeAgentSdkAdapterConfig {\n /** Working directory for the agent. Defaults to process.cwd(). */\n cwd?: string;\n /** Model identifier (e.g. \"claude-sonnet-4-20250514\"). Uses SDK default if omitted. */\n model?: string;\n /**\n * Available tools. Defaults to read-only or read-write set based on AdapterSendOptions.\n * Set to `{ type: 'preset', preset: 'claude_code' }` for all Claude Code tools.\n */\n tools?: string[] | { type: \"preset\"; preset: \"claude_code\" };\n /** Permission mode. Defaults to \"bypassPermissions\" for automated workflows. */\n permissionMode?: \"default\" | \"acceptEdits\" | \"bypassPermissions\" | \"plan\";\n /** Max turns before stopping. */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via PreToolUse SDK hooks. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class ClaudeAgentSdkAdapter implements SdkAdapter {\n private cwd: string;\n private model: string | undefined;\n private tools: string[] | { type: \"preset\"; preset: \"claude_code\" } | undefined;\n private permissionMode: string;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastSessionId: string | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private queryFn: QueryFn | null = null;\n\n constructor(config: ClaudeAgentSdkAdapterConfig = {}) {\n this.cwd = config.cwd ?? process.cwd();\n this.model = config.model;\n this.tools = config.tools;\n this.permissionMode = config.permissionMode ?? \"bypassPermissions\";\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveQueryFn(): Promise<QueryFn> {\n if (this.queryFn) return this.queryFn;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as {\n query: QueryFn;\n };\n this.queryFn = sdk.query;\n return this.queryFn;\n }\n\n private buildOptions(\n readonly: boolean,\n resume?: string,\n systemPrompt?: string[],\n agents?: CandidateAgent[],\n allowDynamicWorkflow?: boolean,\n ): QueryOptions {\n const opts: QueryOptions = {\n cwd: this.cwd,\n permissionMode: this.permissionMode,\n allowDangerouslySkipPermissions: this.permissionMode === \"bypassPermissions\",\n // SDK isolation: do not load ambient .claude/ settings, skills, or agents\n // from disk. The runtime injects everything in-code, so disk discovery\n // would break component isolation and reproducibility.\n settingSources: [],\n };\n\n if (this.model) opts.model = this.model;\n if (this.maxTurns) opts.maxTurns = this.maxTurns;\n\n let toolList: string[] | { type: \"preset\"; preset: \"claude_code\" };\n if (this.tools) {\n toolList = Array.isArray(this.tools) ? [...this.tools] : this.tools;\n } else {\n toolList = readonly\n ? [\"Read\", \"Glob\", \"Grep\"]\n : [\"Read\", \"Glob\", \"Grep\", \"Edit\", \"Write\", \"Bash\"];\n }\n\n // When candidate sub-agents are registered (model B), the entry agent needs\n // the sub-agent delegation tool to invoke them. The restricted tool list\n // above omits it, so add it explicitly — otherwise the LLM has no way to\n // delegate. The SDK names this tool \"Task\"/\"Agent\" (docs use both; tool_use\n // events surface it as \"Agent\"), so allow both for robustness across\n // SDK versions. (A \"preset\" tools config already includes it.)\n if (agents && agents.length > 0 && Array.isArray(toolList)) {\n for (const t of [\"Task\", \"Agent\"]) {\n if (!toolList.includes(t)) toolList.push(t);\n }\n }\n\n if (allowDynamicWorkflow && Array.isArray(toolList)) {\n if (!toolList.includes(\"Workflow\")) toolList.push(\"Workflow\");\n }\n opts.tools = toolList;\n\n if (resume) opts.resume = resume;\n\n if (systemPrompt && this.cacheConfig.enabled !== false) {\n opts.systemPrompt = systemPrompt;\n }\n\n // Register candidate sub-agents so the LLM can delegate via the Agent/Task\n // tool (model B, LLM-internal routing). Keyed by candidate name.\n if (agents && agents.length > 0) {\n const record: Record<string, ClaudeAgentDefinition> = {};\n for (const a of agents) {\n record[a.name] = {\n description: a.description,\n prompt: a.prompt,\n ...(a.tools ? { tools: a.tools } : {}),\n ...(a.model ? { model: a.model } : {}),\n };\n }\n opts.agents = record;\n }\n\n if (this.guardrailHooks) {\n opts.hooks = buildClaudeHooks(this.guardrailHooks);\n }\n\n return opts;\n }\n\n private async attachLibraryTools(\n opts: QueryOptions,\n libraryTools?: LibraryToolRegistry,\n ): Promise<void> {\n if (!libraryTools || libraryTools.getAll().length === 0) return;\n\n try {\n const server = await buildClaudeMcpServer(libraryTools);\n if (server) {\n const existing = (opts.mcpServers ?? []) as unknown[];\n opts.mcpServers = [...existing, server];\n }\n } catch {\n // SDK functions unavailable; library tools silently skipped for Claude\n }\n }\n\n private async runQuery(\n prompt: string,\n options: QueryOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n ): Promise<{ text: string; sessionId: string }> {\n const queryFn = await this.resolveQueryFn();\n const stream = queryFn({ prompt, options });\n\n let resultText = \"\";\n let sessionId = \"\";\n\n for await (const message of stream) {\n if (message.session_id) sessionId = message.session_id;\n if (message.type === \"result\") {\n if (message.subtype === \"success\") {\n resultText = (message as SDKResultSuccess).result;\n } else if (message.subtype === \"error\") {\n throw new Error(`Claude Agent SDK error: ${(message as SDKResultError).error}`);\n }\n } else if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n }\n\n return { text: resultText, sessionId };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const split = options.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : prompt;\n const opts = this.buildOptions(options.readonly, undefined, systemPrompt, options.agents, options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, options.libraryTools);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n };\n return text;\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastSessionId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n const opts = this.buildOptions(false, this.lastSessionId);\n const { text, sessionId } = await this.runQuery(message, opts);\n this.lastSessionId = sessionId;\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const resume = request.memoryRef?.id;\n const split = request.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : request.prompt;\n const agents = request.options.agents ?? request.agents;\n const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, request.options.libraryTools);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n };\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"claude-agent-sdk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject a custom query function for testing.\n * Bypasses the dynamic import of @anthropic-ai/claude-agent-sdk.\n */\n static withQueryFn(\n queryFn: QueryFn,\n config?: ClaudeAgentSdkAdapterConfig,\n ): ClaudeAgentSdkAdapter {\n const adapter = new ClaudeAgentSdkAdapter(config);\n adapter.queryFn = queryFn;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromSdkMessage(\n message: SDKMessage,\n onProgress: (event: AgentProgressEvent) => void,\n sessionId?: string,\n): void {\n const sid = message.session_id ?? sessionId;\n switch (message.type) {\n case \"assistant\": {\n const content = message.message?.content;\n if (!content) break;\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n const input = block.input && typeof block.input === \"object\"\n ? block.input as Record<string, unknown>\n : undefined;\n onProgress({ type: \"tool_use\", tool_name: block.name, input, session_id: sid });\n } else if (block.type === \"text\" && block.text) {\n onProgress({ type: \"text\", message: block.text, session_id: sid });\n }\n }\n break;\n }\n case \"tool_progress\":\n if (message.tool_name) {\n onProgress({ type: \"tool_use\", tool_name: message.tool_name, session_id: sid });\n }\n break;\n case \"tool_use_summary\":\n if (message.summary) {\n onProgress({ type: \"status\", message: message.summary, session_id: sid });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":[]}
|
package/dist/adapters/mock.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-szDOYtJV.js';
|
|
2
2
|
import { G as GuardrailHooks } from '../guardrail-hooks-C8G5NGsj.js';
|
|
3
3
|
import 'zod';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -108,6 +108,7 @@ declare class OpenAIAgentsSdkAdapter implements SdkAdapter {
|
|
|
108
108
|
private buildRunOptions;
|
|
109
109
|
private extractOutput;
|
|
110
110
|
private runWithProgress;
|
|
111
|
+
private resolveLibraryTools;
|
|
111
112
|
send(prompt: string, options: AdapterSendOptions): Promise<string>;
|
|
112
113
|
followUp(message: string): Promise<string>;
|
|
113
114
|
sendExecution(request: AgentExecutionRequest): Promise<string>;
|
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
import {
|
|
2
|
+
buildOpenAIFunctionTools
|
|
3
|
+
} from "../chunk-LONLL3K2.js";
|
|
4
|
+
|
|
1
5
|
// src/adapters/openai-agents-sdk.ts
|
|
2
6
|
function buildInputGuardrails(guardrails) {
|
|
3
7
|
return [
|
|
@@ -50,13 +54,17 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
50
54
|
this.runFn = sdk.run;
|
|
51
55
|
return { Agent: this.AgentClass, run: this.runFn };
|
|
52
56
|
}
|
|
53
|
-
createAgent(Agent, instructions, _readonly, agents) {
|
|
57
|
+
createAgent(Agent, instructions, _readonly, agents, extraTools) {
|
|
54
58
|
const opts = {
|
|
55
59
|
name: this.agentName,
|
|
56
60
|
instructions
|
|
57
61
|
};
|
|
58
62
|
if (this.model) opts.model = this.model;
|
|
59
|
-
|
|
63
|
+
const mergedTools = [
|
|
64
|
+
...this.tools ?? [],
|
|
65
|
+
...extraTools ?? []
|
|
66
|
+
];
|
|
67
|
+
if (mergedTools.length > 0) opts.tools = mergedTools;
|
|
60
68
|
if (this.guardrailHooks) {
|
|
61
69
|
opts.inputGuardrails = buildInputGuardrails(this.guardrailHooks);
|
|
62
70
|
}
|
|
@@ -121,6 +129,14 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
121
129
|
// -------------------------------------------------------------------------
|
|
122
130
|
// SdkAdapter interface
|
|
123
131
|
// -------------------------------------------------------------------------
|
|
132
|
+
async resolveLibraryTools(libraryTools) {
|
|
133
|
+
if (!libraryTools || libraryTools.getAll().length === 0) return [];
|
|
134
|
+
try {
|
|
135
|
+
return await buildOpenAIFunctionTools(libraryTools);
|
|
136
|
+
} catch {
|
|
137
|
+
return [];
|
|
138
|
+
}
|
|
139
|
+
}
|
|
124
140
|
async send(prompt, options) {
|
|
125
141
|
this.lastResponseId = null;
|
|
126
142
|
this.lastAgent = null;
|
|
@@ -136,7 +152,8 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
136
152
|
instructions = prompt;
|
|
137
153
|
runInput = prompt;
|
|
138
154
|
}
|
|
139
|
-
const
|
|
155
|
+
const libTools = await this.resolveLibraryTools(options.libraryTools);
|
|
156
|
+
const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);
|
|
140
157
|
const runOpts = this.buildRunOptions();
|
|
141
158
|
const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress);
|
|
142
159
|
this.lastResponseId = result.lastResponseId ?? null;
|
|
@@ -176,7 +193,8 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
176
193
|
runInput = request.prompt;
|
|
177
194
|
}
|
|
178
195
|
const agents = request.options.agents ?? request.agents;
|
|
179
|
-
const
|
|
196
|
+
const libTools = await this.resolveLibraryTools(request.options.libraryTools);
|
|
197
|
+
const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);
|
|
180
198
|
const runOpts = this.buildRunOptions(request.memoryRef?.id);
|
|
181
199
|
const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress);
|
|
182
200
|
this.lastResponseId = result.lastResponseId ?? null;
|
|
@@ -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 { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.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};\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 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// 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\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 ): AgentInstance {\n const opts: AgentOptions = {\n name: this.agentName,\n instructions,\n };\n\n if (this.model) opts.model = this.model;\n if (this.tools) opts.tools = this.tools;\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 ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress || !streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const event of streamResult.streamEvents()) {\n emitProgressFromOpenAIEvent(event, onProgress);\n }\n return streamResult;\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\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\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 agent = this.createAgent(Agent, instructions, options.readonly, options.agents);\n const runOpts = this.buildRunOptions();\n const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\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\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 agent = this.createAgent(Agent, instructions, request.options.readonly, agents);\n const runOpts = this.buildRunOptions(request.memoryRef?.id);\n const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\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 isCompatible(compat: string): boolean {\n return compat.startsWith(\"openai-agents-sdk@\");\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":[]}
|
|
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 { 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};\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 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// 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\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 ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress || !streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const event of streamResult.streamEvents()) {\n emitProgressFromOpenAIEvent(event, onProgress);\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\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);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\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\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);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\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 isCompatible(compat: string): boolean {\n return compat.startsWith(\"openai-agents-sdk@\");\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":";;;;;AAoGA,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,QAAQ,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,WAAW,OAAO;AAExE,eAAO;AAAA,UACL,YAAY,EAAE,QAAQ;AAAA,UACtB,mBAAmB,SAAS,SAAS;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;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,EAElC,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,YACoB;AACpB,UAAM,EAAE,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW;AAEjD,QAAI,CAAC,cAAc,CAAC,WAAW;AAC7B,aAAO,IAAI,OAAO,OAAO,OAAO;AAAA,IAClC;AAEA,UAAM,eAAe,MAAM,UAAU,OAAO,OAAO,OAAO;AAC1D,qBAAiB,SAAS,aAAa,aAAa,GAAG;AACrD,kCAA4B,OAAO,UAAU;AAAA,IAC/C;AACA,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;AAErB,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,UAAU;AAEtF,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,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;AAErB,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,UAAU;AAE9F,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,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,aAAa,QAAyB;AACpC,WAAO,OAAO,WAAW,oBAAoB;AAAA,EAC/C;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":[]}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
// src/lib/schema-converter.ts
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
function applyStringValidations(schema, def) {
|
|
4
|
+
let s = schema;
|
|
5
|
+
if (typeof def.minLength === "number") s = s.min(def.minLength);
|
|
6
|
+
if (typeof def.maxLength === "number") s = s.max(def.maxLength);
|
|
7
|
+
if (typeof def.pattern === "string") s = s.regex(new RegExp(def.pattern));
|
|
8
|
+
return s;
|
|
9
|
+
}
|
|
10
|
+
function applyNumberValidations(schema, def, isInteger) {
|
|
11
|
+
let n = schema;
|
|
12
|
+
if (isInteger) n = n.int();
|
|
13
|
+
if (typeof def.minimum === "number") n = n.min(def.minimum);
|
|
14
|
+
if (typeof def.maximum === "number") n = n.max(def.maximum);
|
|
15
|
+
return n;
|
|
16
|
+
}
|
|
17
|
+
function applyArrayValidations(schema, def) {
|
|
18
|
+
let a = schema;
|
|
19
|
+
if (typeof def.minItems === "number") a = a.min(def.minItems);
|
|
20
|
+
if (typeof def.maxItems === "number") a = a.max(def.maxItems);
|
|
21
|
+
return a;
|
|
22
|
+
}
|
|
23
|
+
function jsonSchemaToZod(schema) {
|
|
24
|
+
if (!schema || typeof schema !== "object") return z.unknown();
|
|
25
|
+
if (schema.enum) {
|
|
26
|
+
const vals = schema.enum;
|
|
27
|
+
if (vals.length === 0) return z.unknown();
|
|
28
|
+
return z.enum(vals);
|
|
29
|
+
}
|
|
30
|
+
if (schema.const !== void 0) {
|
|
31
|
+
const val = schema.const;
|
|
32
|
+
if (typeof val === "string" || typeof val === "number" || typeof val === "boolean") {
|
|
33
|
+
return z.literal(val);
|
|
34
|
+
}
|
|
35
|
+
return z.unknown();
|
|
36
|
+
}
|
|
37
|
+
const type = schema.type;
|
|
38
|
+
if (type === "string") return applyStringValidations(z.string(), schema);
|
|
39
|
+
if (type === "integer") return applyNumberValidations(z.number(), schema, true);
|
|
40
|
+
if (type === "number") return applyNumberValidations(z.number(), schema, false);
|
|
41
|
+
if (type === "boolean") return z.boolean();
|
|
42
|
+
if (type === "array") {
|
|
43
|
+
const items = schema.items;
|
|
44
|
+
const inner = items ? jsonSchemaToZod(items) : z.unknown();
|
|
45
|
+
return applyArrayValidations(z.array(inner), schema);
|
|
46
|
+
}
|
|
47
|
+
if (type === "object") {
|
|
48
|
+
const props = schema.properties;
|
|
49
|
+
if (!props) return z.record(z.string(), z.unknown());
|
|
50
|
+
const required = new Set(schema.required ?? []);
|
|
51
|
+
const shape = {};
|
|
52
|
+
for (const [key, val] of Object.entries(props)) {
|
|
53
|
+
const fieldSchema = jsonSchemaToZod(val);
|
|
54
|
+
shape[key] = required.has(key) ? fieldSchema : fieldSchema.optional();
|
|
55
|
+
}
|
|
56
|
+
return z.object(shape).passthrough();
|
|
57
|
+
}
|
|
58
|
+
if (schema.allOf) {
|
|
59
|
+
const parts = schema.allOf.map(jsonSchemaToZod);
|
|
60
|
+
if (parts.length === 0) return z.unknown();
|
|
61
|
+
if (parts.length === 1) return parts[0];
|
|
62
|
+
let merged = parts[0];
|
|
63
|
+
for (let i = 1; i < parts.length; i++) {
|
|
64
|
+
const part = parts[i];
|
|
65
|
+
if (merged instanceof z.ZodObject && part instanceof z.ZodObject) {
|
|
66
|
+
merged = merged.merge(part);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return merged;
|
|
70
|
+
}
|
|
71
|
+
return z.unknown();
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export {
|
|
75
|
+
jsonSchemaToZod
|
|
76
|
+
};
|
|
77
|
+
//# sourceMappingURL=chunk-ET6TGQRT.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/schema-converter.ts"],"sourcesContent":["/**\n * Runtime JSON Schema → Zod converter.\n *\n * Mirrors the compile-time zodType Handlebars helper in\n * generator/template-engine.ts but produces live z.ZodType\n * objects instead of code strings.\n */\n\nimport { z } from \"zod\";\n\nfunction applyStringValidations(schema: z.ZodString, def: Record<string, unknown>): z.ZodType {\n let s: z.ZodString = schema;\n if (typeof def.minLength === \"number\") s = s.min(def.minLength);\n if (typeof def.maxLength === \"number\") s = s.max(def.maxLength);\n if (typeof def.pattern === \"string\") s = s.regex(new RegExp(def.pattern));\n return s;\n}\n\nfunction applyNumberValidations(schema: z.ZodNumber, def: Record<string, unknown>, isInteger: boolean): z.ZodType {\n let n: z.ZodNumber = schema;\n if (isInteger) n = n.int();\n if (typeof def.minimum === \"number\") n = n.min(def.minimum);\n if (typeof def.maximum === \"number\") n = n.max(def.maximum);\n return n;\n}\n\nfunction applyArrayValidations(schema: z.ZodArray<z.ZodType>, def: Record<string, unknown>): z.ZodType {\n let a: z.ZodArray<z.ZodType> = schema;\n if (typeof def.minItems === \"number\") a = a.min(def.minItems);\n if (typeof def.maxItems === \"number\") a = a.max(def.maxItems);\n return a;\n}\n\n/**\n * Convert a JSON Schema definition to a Zod schema object at runtime.\n *\n * Supports the same subset as the compile-time zodType helper:\n * object, array, string, number, integer, boolean, enum, const, allOf.\n */\nexport function jsonSchemaToZod(schema: Record<string, unknown>): z.ZodType {\n if (!schema || typeof schema !== \"object\") return z.unknown();\n\n if (schema.enum) {\n const vals = schema.enum as [string, ...string[]];\n if (vals.length === 0) return z.unknown();\n return z.enum(vals);\n }\n\n if (schema.const !== undefined) {\n const val = schema.const;\n if (typeof val === \"string\" || typeof val === \"number\" || typeof val === \"boolean\") {\n return z.literal(val);\n }\n return z.unknown();\n }\n\n const type = schema.type as string | undefined;\n\n if (type === \"string\") return applyStringValidations(z.string(), schema);\n if (type === \"integer\") return applyNumberValidations(z.number(), schema, true);\n if (type === \"number\") return applyNumberValidations(z.number(), schema, false);\n if (type === \"boolean\") return z.boolean();\n\n if (type === \"array\") {\n const items = schema.items as Record<string, unknown> | undefined;\n const inner = items ? jsonSchemaToZod(items) : z.unknown();\n return applyArrayValidations(z.array(inner), schema);\n }\n\n if (type === \"object\") {\n const props = schema.properties as Record<string, Record<string, unknown>> | undefined;\n if (!props) return z.record(z.string(), z.unknown());\n\n const required = new Set((schema.required as string[]) ?? []);\n const shape: Record<string, z.ZodType> = {};\n for (const [key, val] of Object.entries(props)) {\n const fieldSchema = jsonSchemaToZod(val);\n shape[key] = required.has(key) ? fieldSchema : fieldSchema.optional();\n }\n return z.object(shape).passthrough();\n }\n\n if (schema.allOf) {\n const parts = (schema.allOf as Record<string, unknown>[]).map(jsonSchemaToZod);\n if (parts.length === 0) return z.unknown();\n if (parts.length === 1) return parts[0];\n let merged = parts[0];\n for (let i = 1; i < parts.length; i++) {\n const part = parts[i];\n if (merged instanceof z.ZodObject && part instanceof z.ZodObject) {\n merged = merged.merge(part);\n }\n }\n return merged;\n }\n\n return z.unknown();\n}\n"],"mappings":"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","names":[]}
|