@moldea.ai/adapter-claude-agent-sdk 1.0.0 → 1.0.2

package/README.md

@@ -8,7 +8,7 @@ The package implements the official `claude-agent-sdk` runtime adapter for `@mol
 
 ## Supported target
 
-Version `1.0.0` experimentally supports:
+Version `1.0.2` supports:
 
 - Repository Format version `1`
 - `@moldea.ai/core ^2.0.0`
@@ -26,7 +26,7 @@ Version `1.0.0` experimentally supports:
 
 Named root-package imports and aliases of `query`, `tool`, and `createSdkMcpServer` are supported. Relative ESM named imports resolve exact paths plus `.js` to `.ts` or `.tsx` and `.mjs` to `.mts` substitutions. Relationship closure is independent: a dynamic relationship does not erase other relationships proved from the same query or definition.
 
-The Runtime Compatibility Matrix is authoritative for current target maturity, exact versions, evidence, binding support, patterns, and known limitations.
+The Runtime Compatibility Matrix is authoritative for exact versions, evidence, binding support, patterns, and known limitations.
 
 ## Usage
 

package/dist/index.js

@@ -186,14 +186,8 @@ var classifyPackageDeclarations = (declarations, supportedRange) => {
 	if (classifications.every((classification) => classification === "unsupported")) return "unsupported";
 	return "ambiguous";
 };
-/**
-* Discovers the nearest package declaration without repository enumeration.
-* @param options The package target, repository callbacks, path, range, and signal.
-* @returns The first observed declaration, invalid manifest, or absence result.
-* @throws If repository reading or the active inspection is aborted.
-*/
-var discoverPackage = async (options) => {
-	const { packageName, reader, signal, sourcePath, supportedRange } = options;
+var readOwningManifest = async (options) => {
+	const { reader, signal, sourcePath } = options;
 	for (const manifestPath of createPackageManifestCandidatePaths(sourcePath)) {
 		signal?.throwIfAborted();
 		const entry = await reader.getEntry(manifestPath);
@@ -221,28 +215,48 @@ var discoverPackage = async (options) => {
 			});
 		}
 		signal?.throwIfAborted();
-		if (!isRecord(parsed)) return Object.freeze({
-			kind: "invalid",
+		return isRecord(parsed) ? Object.freeze({
+			kind: "present",
+			manifest: parsed,
 			path: manifestPath
-		});
-		const declarations = extractPackageDeclarations(parsed, packageName);
-		if (declarations === null) return Object.freeze({
+		}) : Object.freeze({
 			kind: "invalid",
 			path: manifestPath
 		});
-		if (declarations.length === 0) return Object.freeze({ kind: "absent" });
-		return Object.freeze({
-			kind: "observed",
-			observation: Object.freeze({
-				compatibility: classifyPackageDeclarations(declarations, supportedRange),
-				declarations: Object.freeze(declarations),
-				path: manifestPath
-			})
-		});
 	}
 	return Object.freeze({ kind: "absent" });
 };
 /**
+* Discovers the nearest package declaration without repository enumeration.
+* @param options The package target, repository callbacks, path, range, and signal.
+* @returns The first observed declaration, invalid manifest, or absence result.
+* @throws If repository reading or the active inspection is aborted.
+*/
+var discoverPackage = async (options) => {
+	const { includeManifestPackageName, packageName, reader, signal, sourcePath, supportedRange } = options;
+	const owningManifest = await readOwningManifest({
+		reader,
+		...signal === void 0 ? {} : { signal },
+		sourcePath
+	});
+	if (owningManifest.kind !== "present") return owningManifest;
+	const declarations = extractPackageDeclarations(owningManifest.manifest, packageName);
+	if (declarations === null) return Object.freeze({
+		kind: "invalid",
+		path: owningManifest.path
+	});
+	if (declarations.length === 0) return Object.freeze({ kind: "absent" });
+	return Object.freeze({
+		kind: "observed",
+		observation: Object.freeze({
+			compatibility: classifyPackageDeclarations(declarations, supportedRange),
+			declarations: Object.freeze(declarations),
+			...includeManifestPackageName === true ? { manifestPackageName: typeof owningManifest.manifest["name"] === "string" ? owningManifest.manifest["name"] : null } : {},
+			path: owningManifest.path
+		})
+	});
+};
+/**
 * Removes the transparent expression wrappers supported by runtime adapters.
 * @param expression The expression to normalize.
 * @returns The underlying expression used by static matching.
@@ -742,9 +756,10 @@ var analyzeMutationCall = (identifier, mutatedMembers) => {
 * @param analysis The indexed source containing the binding.
 * @param declaration The module-local constant declaration.
 * @param allowedReferences Bare identifier uses proven to be supported registrations or targets.
+* @param safeMethodCalls Read-only method calls that preserve the value's runtime configuration.
 * @returns Member-specific mutations and whether an unknown use can affect every relationship.
 */
-var analyzeModuleValueMutations = (analysis, declaration, allowedReferences) => {
+var analyzeModuleValueMutations = (analysis, declaration, allowedReferences, safeMethodCalls = /* @__PURE__ */ new Set()) => {
 	if (!ts.isIdentifier(declaration.name)) return Object.freeze({
 		hasUnknownMutation: true,
 		mutatedMembers: /* @__PURE__ */ new Set()
@@ -764,7 +779,9 @@ var analyzeModuleValueMutations = (analysis, declaration, allowedReferences) =>
 				const memberExpression = skipTransparentParents(member);
 				const memberParent = memberExpression.parent;
 				if ((ts.isPropertyAccessExpression(memberParent) || ts.isElementAccessExpression(memberParent)) && memberParent.expression === memberExpression && ts.isCallExpression(skipTransparentParents(memberParent).parent)) mutatedMembers.add(memberName);
-				else if (ts.isCallExpression(memberParent) && memberParent.expression === memberExpression) mutatedMembers.add(memberName);
+				else if (ts.isCallExpression(memberParent) && memberParent.expression === memberExpression) {
+					if (!safeMethodCalls.has(memberName)) mutatedMembers.add(memberName);
+				}
 			}
 			continue;
 		}
@@ -780,6 +797,17 @@ var analyzeModuleValueMutations = (analysis, declaration, allowedReferences) =>
 		mutatedMembers: new Set(mutatedMembers)
 	});
 };
+var TYPESCRIPT_DECLARATION_EXTENSIONS = [
+	".d.ts",
+	".d.tsx",
+	".d.mts",
+	".d.cts"
+];
+var TYPESCRIPT_SOURCE_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".mts"
+];
 var getScriptKind = (path) => path.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
 var createSyntaxProgram = (sourceFile, text) => {
 	return ts.createProgram({
@@ -862,11 +890,7 @@ var analyzeTypeScriptModule = (path, bytes, importConfig, signal) => {
 * @param path The bound source path.
 * @returns Whether its extension is supported.
 */
-var isSupportedTypeScriptSourcePath = (path) => [
-	".ts",
-	".tsx",
-	".mts"
-].some((extension) => path.endsWith(extension));
+var isSupportedTypeScriptSourcePath = (path) => !TYPESCRIPT_DECLARATION_EXTENSIONS.some((extension) => path.endsWith(extension)) && TYPESCRIPT_SOURCE_EXTENSIONS.some((extension) => path.endsWith(extension));
 /**
 * Classifies a direct exported runtime-agent function and exposes its body.
 * @param analysis The indexed runtime source.
@@ -964,6 +988,7 @@ var resolveStaticStringExpression = async (options, analysis, expression, visite
 	visited.add(key);
 	const importedResult = await options.analyzeSource(importedPath);
 	if (importedResult.kind !== "valid") {
+		options.onSourceFailure?.(importedPath, importedResult);
 		visited.delete(key);
 		return Object.freeze({ kind: "unsupported" });
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/adapter-claude-agent-sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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": {