@moldea.ai/adapter-claude-agent-sdk 1.0.4 → 2.0.0

package/README.md

@@ -8,10 +8,10 @@ The package implements the official `claude-agent-sdk` runtime adapter for `@mol
 
 ## Supported target
 
-Version `1.0.4` supports:
+Version `2.0.0` supports:
 
 - Repository Format version `1`
-- `@moldea.ai/core ^2.0.0`
+- `@moldea.ai/core >=3.0.0 <4.0.0`
 - TypeScript ESM source
 - npm `@anthropic-ai/claude-agent-sdk >=0.3.234 <0.4.0`
 - directly exported functions containing direct `query({ ... })` calls

package/dist/index.js

@@ -2,6 +2,7 @@ import { posix } from "node:path";
 import { intersects, subset, validRange } from "semver";
 import ts from "typescript";
 import { parseRepositoryPath } from "@moldea.ai/repository";
+import { readRuntimeAdapterFile } from "@moldea.ai/core/adapter";
 //#region src/constants/index.ts
 var CLAUDE_AGENT_SDK_ADAPTER_ID = "claude-agent-sdk";
 var CLAUDE_AGENT_SDK_PACKAGE_NAME = "@anthropic-ai/claude-agent-sdk";
@@ -1773,9 +1774,9 @@ var resolveMapEntryName = async (session, inspected, entry) => {
 	const result = await resolveClaudeAgentSdkStaticString(session, inspected.analysis, keyExpression);
 	return result.kind === "supported" ? result.value : null;
 };
-var getMappedAgents = (context, target) => context.project.agents.filter(({ declaration }) => {
-	const runtimeAgent = declaration.bindings?.runtimeAgent;
-	return runtimeAgent?.path === target.path && runtimeAgent.symbol === target.symbol;
+var resolveMappedAgent = (context, target) => context.resolveAgent({
+	path: target.path,
+	symbol: target.symbol
 });
 var inspectRoutingDescription = async (session, sourceAgentId, target, targetAgent, runtimeName, diagnostics) => {
 	const canonicalDescription = targetAgent.handoffDescription?.value ?? targetAgent.description.value;
@@ -1796,6 +1797,7 @@ var inspectRoutingDescription = async (session, sourceAgentId, target, targetAge
 };
 /** Inspects active query-configured programmatic subagent registrations and routing metadata. */
 var inspectClaudeAgentSdkHandoffs = async (context, session, inspected, evidence, diagnostics) => {
+	const resolvedAgents = /* @__PURE__ */ new Map();
 	const collectionReferences = collectClaudeAgentSdkRelationshipIdentifiers(inspected.wrapper.contexts.flatMap((queryContext) => [
 		queryContext.tools,
 		queryContext.disallowedTools,
@@ -1819,8 +1821,8 @@ var inspectClaudeAgentSdkHandoffs = async (context, session, inspected, evidence
 				...unresolvedTarget,
 				definition: applyClaudeAgentSdkAgentMutations(unresolvedTarget.analysis, unresolvedTarget.definition, collectClaudeAgentSdkAgentDefinitionReferences(unresolvedTarget.analysis))
 			});
-			const mappedAgents = getMappedAgents(context, target);
-			const mappedAgent = mappedAgents.length === 1 ? mappedAgents[0] : void 0;
+			const resolution = resolveMappedAgent(context, target);
+			const mappedAgent = resolution.kind === "matched" ? resolution.agent : void 0;
 			const safeRuntimeName = isClaudeAgentSdkMachineString(runtimeName) ? runtimeName : null;
 			const details = {
 				delegationAvailabilitySource: queryContext.tools.kind === "absent" ? "default-built-in-tools" : "explicit-built-in-tools",
@@ -1830,8 +1832,16 @@ var inspectClaudeAgentSdkHandoffs = async (context, session, inspected, evidence
 				...mappedAgent === void 0 ? {} : { targetAgentId: mappedAgent.id },
 				...safeRuntimeName === null ? {} : { targetRuntimeName: safeRuntimeName }
 			};
-			if (mappedAgents.length > 1) addClaudeAgentSdkDiagnostic(diagnostics, "CLAUDE_AGENT_SDK_HANDOFF_TARGET_AMBIGUOUS", inspected.analysis.path, inspected.agent.id, locateClaudeAgentSdkNode(inspected.analysis, entry.value), void 0, safeRuntimeName === null ? {} : { targetRuntimeName: safeRuntimeName });
-			else if (mappedAgent !== void 0) await inspectRoutingDescription(session, inspected.agent.id, target, mappedAgent, runtimeName, diagnostics);
+			if (resolution.kind === "ambiguous") addClaudeAgentSdkDiagnostic(diagnostics, "CLAUDE_AGENT_SDK_HANDOFF_TARGET_AMBIGUOUS", inspected.analysis.path, inspected.agent.id, locateClaudeAgentSdkNode(inspected.analysis, entry.value), void 0, safeRuntimeName === null ? {} : { targetRuntimeName: safeRuntimeName });
+			else if (mappedAgent !== void 0) {
+				await inspectRoutingDescription(session, inspected.agent.id, target, mappedAgent, runtimeName, diagnostics);
+				resolvedAgents.set(mappedAgent.id, Object.freeze({
+					agent: mappedAgent,
+					analysis: target.analysis,
+					definition: target.definition,
+					kind: "programmatic-agent-definition"
+				}));
+			}
 			evidence.push(createClaudeAgentSdkEvidence({
 				agentId: inspected.agent.id,
 				capabilityId: null,
@@ -1847,6 +1857,7 @@ var inspectClaudeAgentSdkHandoffs = async (context, session, inspected, evidence
 			}));
 		}
 	}
+	return Object.freeze([...resolvedAgents.values()]);
 };
 //#endregion
 //#region src/inspection/package-inspection.ts
@@ -2021,7 +2032,7 @@ var discoverClaudeAgentSdkPackage = async (repository, sourcePath, signal) => {
 		packageName: CLAUDE_AGENT_SDK_PACKAGE_NAME,
 		reader: {
 			getEntry: (path) => repository.getEntry(parseRepositoryPath(path), repositoryOptions),
-			readFile: (path) => repository.readFile(parseRepositoryPath(path), repositoryOptions)
+			readFile: (path) => readRuntimeAdapterFile(repository, parseRepositoryPath(path), repositoryOptions)
 		},
 		...signal === void 0 ? {} : { signal },
 		sourcePath,
@@ -2047,7 +2058,7 @@ var createClaudeAgentSdkInspectionSession = (context) => createInspectionSession
 	analyzeSource: analyzeClaudeAgentSdkSource,
 	discoverPackage: (path, signal) => discoverClaudeAgentSdkPackage(context.repository, path, signal),
 	getEntry: (path, signal) => context.repository.getEntry(path, signal === void 0 ? void 0 : { signal }),
-	readFile: (path, signal) => context.repository.readFile(path, signal === void 0 ? void 0 : { signal }),
+	readFile: (path, signal) => readRuntimeAdapterFile(context.repository, path, signal === void 0 ? void 0 : { signal }),
 	...context.signal === void 0 ? {} : { signal: context.signal }
 });
 //#endregion
@@ -2430,17 +2441,13 @@ var inspectClaudeAgentSdk = async (context) => {
 	const session = createClaudeAgentSdkInspectionSession(context);
 	const evidence = [];
 	const diagnostics = [];
-	const agents = [...context.agents].sort((left, right) => compareClaudeAgentSdkStrings(left.id, right.id));
 	const inspectedAgents = [];
-	for (const agent of agents) {
-		context.signal?.throwIfAborted();
-		const inspected = await inspectAgent(session, agent, evidence, diagnostics);
-		if (inspected !== null) inspectedAgents.push(inspected);
-	}
-	for (const inspected of inspectedAgents) {
+	const inspected = await inspectAgent(session, context.agent, evidence, diagnostics);
+	if (inspected !== null) inspectedAgents.push(inspected);
+	if (inspected !== null) {
 		context.signal?.throwIfAborted();
 		await inspectClaudeAgentSdkRelationships(session, inspected, evidence, diagnostics);
-		if (inspected.kind === "query-wrapper") await inspectClaudeAgentSdkHandoffs(context, session, inspected, evidence, diagnostics);
+		if (inspected.kind === "query-wrapper") inspectedAgents.push(...await inspectClaudeAgentSdkHandoffs(context, session, inspected, evidence, diagnostics));
 	}
 	await inspectClaudeAgentSdkTools(session, inspectedAgents, evidence, diagnostics);
 	context.signal?.throwIfAborted();

package/dist/inspection/handoffs.d.ts

@@ -1,7 +1,7 @@
 import type { IRuntimeAdapterEvidence } from '@moldea.ai/core';
 import type { IAdapterDiagnostic, IRuntimeAdapterContext } from '@moldea.ai/core/adapter';
 import type { IClaudeAgentSdkInspectionSession } from '../contracts/index.js';
-import type { IClaudeAgentSdkInspectedQueryAgent } from './types.js';
+import type { IClaudeAgentSdkInspectedDefinitionAgent, IClaudeAgentSdkInspectedQueryAgent } from './types.js';
 /** Inspects active query-configured programmatic subagent registrations and routing metadata. */
-export declare const inspectClaudeAgentSdkHandoffs: (context: IRuntimeAdapterContext, session: IClaudeAgentSdkInspectionSession, inspected: IClaudeAgentSdkInspectedQueryAgent, evidence: IRuntimeAdapterEvidence[], diagnostics: IAdapterDiagnostic[]) => Promise<void>;
+export declare const inspectClaudeAgentSdkHandoffs: (context: IRuntimeAdapterContext, session: IClaudeAgentSdkInspectionSession, inspected: IClaudeAgentSdkInspectedQueryAgent, evidence: IRuntimeAdapterEvidence[], diagnostics: IAdapterDiagnostic[]) => Promise<readonly IClaudeAgentSdkInspectedDefinitionAgent[]>;
 //# sourceMappingURL=handoffs.d.ts.map

package/dist/inspection/handoffs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoffs.d.ts","sourceRoot":"","sources":["../../src/inspection/handoffs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAG1F,OAAO,KAAK,EACV,gCAAgC,EAGjC,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAiGrE,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,GACxC,SAAS,sBAAsB,EAC/B,SAAS,gCAAgC,EACzC,WAAW,kCAAkC,EAC7C,UAAU,uBAAuB,EAAE,EACnC,aAAa,kBAAkB,EAAE,KAChC,OAAO,CAAC,IAAI,CA8Hd,CAAC"}
+{"version":3,"file":"handoffs.d.ts","sourceRoot":"","sources":["../../src/inspection/handoffs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,gCAAgC,EAGjC,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,KAAK,EACV,uCAAuC,EACvC,kCAAkC,EACnC,MAAM,YAAY,CAAC;AA8FpB,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,GACxC,SAAS,sBAAsB,EAC/B,SAAS,gCAAgC,EACzC,WAAW,kCAAkC,EAC7C,UAAU,uBAAuB,EAAE,EACnC,aAAa,kBAAkB,EAAE,KAChC,OAAO,CAAC,SAAS,uCAAuC,EAAE,CA0I5D,CAAC"}

package/dist/inspection/inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/inspection/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AA8IjC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,sBAAsB,KAC9B,OAAO,CAAC,qBAAqB,CAmC/B,CAAC"}
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/inspection/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AA6IjC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,sBAAsB,KAC9B,OAAO,CAAC,qBAAqB,CAoC/B,CAAC"}

package/dist/inspection/session.d.ts

@@ -1,4 +1,4 @@
-import type { IRuntimeAdapterContext } from '@moldea.ai/core/adapter';
+import { type IRuntimeAdapterContext } from '@moldea.ai/core/adapter';
 import type { IClaudeAgentSdkInspectionSession } from '../contracts/index.js';
 /** Creates one operation-local Claude Agent SDK inspection session. */
 export declare const createClaudeAgentSdkInspectionSession: (context: IRuntimeAdapterContext) => IClaudeAgentSdkInspectionSession;

package/dist/inspection/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/inspection/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAI9E,uEAAuE;AACvE,eAAO,MAAM,qCAAqC,GAChD,SAAS,sBAAsB,KAC9B,gCAUC,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/inspection/session.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAE9F,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAI9E,uEAAuE;AACvE,eAAO,MAAM,qCAAqC,GAChD,SAAS,sBAAsB,KAC9B,gCAcC,CAAC"}

package/dist/inspection/types.d.ts

@@ -1,13 +1,14 @@
-import type { IIndexedAgent } from '@moldea.ai/core';
+import type { IIndexedAgent } from '@moldea.ai/core/adapter';
 import type { IClaudeAgentSdkAgentDefinition, IClaudeAgentSdkQueryWrapper, IClaudeAgentSdkSourceAnalysis } from '../contracts/index.js';
+export type IClaudeAgentSdkScopedAgent = Pick<IIndexedAgent, 'declaration' | 'id'>;
 export interface IClaudeAgentSdkInspectedQueryAgent {
-    readonly agent: IIndexedAgent;
+    readonly agent: IClaudeAgentSdkScopedAgent;
     readonly analysis: IClaudeAgentSdkSourceAnalysis;
     readonly kind: 'query-wrapper';
     readonly wrapper: IClaudeAgentSdkQueryWrapper;
 }
 export interface IClaudeAgentSdkInspectedDefinitionAgent {
-    readonly agent: IIndexedAgent;
+    readonly agent: IClaudeAgentSdkScopedAgent;
     readonly analysis: IClaudeAgentSdkSourceAnalysis;
     readonly definition: IClaudeAgentSdkAgentDefinition;
     readonly kind: 'programmatic-agent-definition';

package/dist/inspection/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/inspection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EACV,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;CAC/C;AAGD,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,8BAA8B,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAChD;AAED,MAAM,MAAM,6BAA6B,GACvC,uCAAuC,GAAG,kCAAkC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/inspection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC;AAEnF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;CAC/C;AAGD,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,8BAA8B,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAChD;AAED,MAAM,MAAM,6BAA6B,GACvC,uCAAuC,GAAG,kCAAkC,CAAC"}

package/dist/package-discovery/index.d.ts

@@ -1,4 +1,5 @@
-import type { IRepositoryPath, IRepositoryReader } from '@moldea.ai/repository';
+import { type IRuntimeAdapterRepository } from '@moldea.ai/core/adapter';
+import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { IClaudeAgentSdkPackageDiscoveryResult } from '../contracts/index.js';
 /**
  * Creates nearest-to-root package-manifest candidates for one source path.
@@ -23,5 +24,5 @@ export declare const createPackageManifestCandidatePaths: (sourcePath: IReposito
  * - RESOURCE_LIMIT_EXCEEDED: A repository reading resource limit was exceeded.
  * - ABORTED: The repository operation was aborted.
  */
-export declare const discoverClaudeAgentSdkPackage: (repository: IRepositoryReader, sourcePath: IRepositoryPath, signal?: AbortSignal) => Promise<IClaudeAgentSdkPackageDiscoveryResult>;
+export declare const discoverClaudeAgentSdkPackage: (repository: IRuntimeAdapterRepository, sourcePath: IRepositoryPath, signal?: AbortSignal) => Promise<IClaudeAgentSdkPackageDiscoveryResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/package-discovery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/package-discovery/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAOhF,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,uBAAuB,CAAC;AAEnF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,YAAY,eAAe,KAC1B,SAAS,eAAe,EACgD,CAAC;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B,GACxC,YAAY,iBAAiB,EAC7B,YAAY,eAAe,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,qCAAqC,CA4B/C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/package-discovery/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,uBAAuB,CAAC;AAEnF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,YAAY,eAAe,KAC1B,SAAS,eAAe,EACgD,CAAC;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B,GACxC,YAAY,yBAAyB,EACrC,YAAY,eAAe,EAC3B,SAAS,WAAW,KACnB,OAAO,CAAC,qCAAqC,CA6B/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/adapter-claude-agent-sdk",
-  "version": "1.0.4",
+  "version": "2.0.0",
   "description": "Deterministic runtime evidence and diagnostics for Claude Agent SDK query and subagent integrations.",
   "homepage": "https://github.com/moldea-ai/packages/tree/main/projects/adapter-claude-agent-sdk#readme",
   "bugs": {
@@ -33,8 +33,8 @@
     "node": ">=22.11.0"
   },
   "dependencies": {
-    "@moldea.ai/core": "^2.0.0",
-    "@moldea.ai/repository": ">=1.1.1",
+    "@moldea.ai/core": "3.0.0",
+    "@moldea.ai/repository": "2.0.0",
     "semver": "7.8.5",
     "typescript": "6.0.3"
   },