@aigne/agent-runtime 1.12.0-beta.5

package/dist/program/result-contract.mjs

@@ -0,0 +1,51 @@
+//#region src/program/result-contract.ts
+/**
+* S8 — Result contract utilities.
+*
+* stripSubAgentMeta: separates _meta from a sub-agent result so the parent
+* LLM only sees the result value, while _meta flows through onToolProgress.
+*
+* sanitizeScratchPath: removes absolute filesystem prefixes, keeping only the
+* AFS-relative portion.
+*
+* sanitizeMetaEnv: redacts env var values, keeping only names.
+*/
+function stripSubAgentMeta(data) {
+	if (!data || typeof data !== "object" || !("_meta" in data)) return {
+		result: data,
+		meta: null
+	};
+	const d = data;
+	return {
+		result: d.result !== void 0 ? d.result : null,
+		meta: d._meta ?? null
+	};
+}
+function isSubAgentResult(data) {
+	return !!data && typeof data === "object" && "_meta" in data;
+}
+function sanitizeScratchPath(raw) {
+	if (raw.startsWith("/instance/") || raw.startsWith("/modules/")) return raw;
+	for (const marker of ["/instance/", "/modules/"]) {
+		const idx = raw.indexOf(marker);
+		if (idx >= 0) return raw.slice(idx);
+	}
+	return "[redacted]";
+}
+function sanitizeMetaEnv(env) {
+	const safe = {};
+	for (const key of Object.keys(env)) safe[key] = "[redacted]";
+	return safe;
+}
+function isJsonSafe(value) {
+	try {
+		JSON.stringify(value);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { isJsonSafe, isSubAgentResult, sanitizeMetaEnv, sanitizeScratchPath, stripSubAgentMeta };
+//# sourceMappingURL=result-contract.mjs.map

package/dist/program/result-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-contract.mjs","names":[],"sources":["../../src/program/result-contract.ts"],"sourcesContent":["/**\n * S8 — Result contract utilities.\n *\n * stripSubAgentMeta: separates _meta from a sub-agent result so the parent\n * LLM only sees the result value, while _meta flows through onToolProgress.\n *\n * sanitizeScratchPath: removes absolute filesystem prefixes, keeping only the\n * AFS-relative portion.\n *\n * sanitizeMetaEnv: redacts env var values, keeping only names.\n */\n\nexport function stripSubAgentMeta(data: unknown): {\n  result: unknown;\n  meta: Record<string, unknown> | null;\n} {\n  if (!data || typeof data !== \"object\" || !(\"_meta\" in (data as Record<string, unknown>))) {\n    return { result: data, meta: null };\n  }\n  const d = data as Record<string, unknown>;\n  return {\n    result: d.result !== undefined ? d.result : null,\n    meta: (d._meta as Record<string, unknown>) ?? null,\n  };\n}\n\nexport function isSubAgentResult(data: unknown): boolean {\n  return !!data && typeof data === \"object\" && \"_meta\" in (data as Record<string, unknown>);\n}\n\nexport function sanitizeScratchPath(raw: string): string {\n  if (raw.startsWith(\"/instance/\") || raw.startsWith(\"/modules/\")) return raw;\n  for (const marker of [\"/instance/\", \"/modules/\"]) {\n    const idx = raw.indexOf(marker);\n    if (idx >= 0) return raw.slice(idx);\n  }\n  return \"[redacted]\";\n}\n\nexport function sanitizeMetaEnv(env: Record<string, unknown>): Record<string, string> {\n  const safe: Record<string, string> = {};\n  for (const key of Object.keys(env)) {\n    safe[key] = \"[redacted]\";\n  }\n  return safe;\n}\n\nexport function isJsonSafe(value: unknown): boolean {\n  try {\n    JSON.stringify(value);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,kBAAkB,MAGhC;AACA,KAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,EAAE,WAAY,MACrD,QAAO;EAAE,QAAQ;EAAM,MAAM;EAAM;CAErC,MAAM,IAAI;AACV,QAAO;EACL,QAAQ,EAAE,WAAW,SAAY,EAAE,SAAS;EAC5C,MAAO,EAAE,SAAqC;EAC/C;;AAGH,SAAgB,iBAAiB,MAAwB;AACvD,QAAO,CAAC,CAAC,QAAQ,OAAO,SAAS,YAAY,WAAY;;AAG3D,SAAgB,oBAAoB,KAAqB;AACvD,KAAI,IAAI,WAAW,aAAa,IAAI,IAAI,WAAW,YAAY,CAAE,QAAO;AACxE,MAAK,MAAM,UAAU,CAAC,cAAc,YAAY,EAAE;EAChD,MAAM,MAAM,IAAI,QAAQ,OAAO;AAC/B,MAAI,OAAO,EAAG,QAAO,IAAI,MAAM,IAAI;;AAErC,QAAO;;AAGT,SAAgB,gBAAgB,KAAsD;CACpF,MAAM,OAA+B,EAAE;AACvC,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAChC,MAAK,OAAO;AAEd,QAAO;;AAGT,SAAgB,WAAW,OAAyB;AAClD,KAAI;AACF,OAAK,UAAU,MAAM;AACrB,SAAO;SACD;AACN,SAAO"}

package/dist/program/runner-error.cjs

@@ -0,0 +1,71 @@
+const require_result_contract = require('./result-contract.cjs');
+
+//#region src/program/runner-error.ts
+/**
+* B2 — Normalize runner error shapes into `{ code, message, ...details }`.
+*
+* Runners surface failures two ways:
+*   1. Return `{ success: false, error }` — structured shape varies per runner
+*   2. Throw an Error — message often carries a `CODE: description` prefix
+*
+* Downstream consumers (MCP, LLM tool shim, E2E harness) expect:
+*   - `code`: SCREAMING_SNAKE string
+*   - `message`: human-readable string
+*   - extra JSON-safe detail fields preserved (member, path, depth, max, …)
+*/
+const MAX_MESSAGE_LENGTH = 2048;
+const STRUCTURED_CODE_RE = /^([A-Z][A-Z0-9_]{2,63}):\s*/;
+function truncate(s) {
+	return s.length > MAX_MESSAGE_LENGTH ? `${s.slice(0, MAX_MESSAGE_LENGTH - 1)}…` : s;
+}
+function extractCodeFromMessage(message) {
+	const m = STRUCTURED_CODE_RE.exec(message);
+	return m ? m[1] : "RUNNER_ERROR";
+}
+function normalizeFromString(raw) {
+	return {
+		code: extractCodeFromMessage(raw),
+		message: truncate(raw)
+	};
+}
+function attachDepthAndMax(err, message) {
+	if (err.code !== "MAX_SPAWN_DEPTH_EXCEEDED") return err;
+	const depthMatch = message.match(/depth (\d+)/);
+	const maxMatch = message.match(/max (\d+)/);
+	if (depthMatch) err.depth = Number(depthMatch[1]);
+	if (maxMatch) err.max = Number(maxMatch[1]);
+	return err;
+}
+function normalizeFromErrorInstance(err) {
+	return attachDepthAndMax(normalizeFromString(err.message), err.message);
+}
+function normalizeFromObject(obj) {
+	const rawCode = obj.code;
+	const rawMsg = obj.message;
+	const out = {
+		code: typeof rawCode === "string" && STRUCTURED_CODE_RE.test(`${rawCode}:`) ? rawCode : "RUNNER_ERROR",
+		message: typeof rawMsg === "string" && rawMsg.length > 0 ? truncate(rawMsg) : "(no message)"
+	};
+	for (const [k, v] of Object.entries(obj)) {
+		if (k === "code" || k === "message") continue;
+		if (typeof v === "function" || typeof v === "symbol") continue;
+		if (!require_result_contract.isJsonSafe(v)) continue;
+		out[k] = v;
+	}
+	return out;
+}
+/**
+* Coerce any error-ish value into the normalized shape.
+*/
+function normalizeRunnerError(err) {
+	if (err instanceof Error) return normalizeFromErrorInstance(err);
+	if (typeof err === "string") return normalizeFromString(err);
+	if (err && typeof err === "object") return normalizeFromObject(err);
+	return {
+		code: "RUNNER_ERROR",
+		message: "Unknown error"
+	};
+}
+
+//#endregion
+exports.normalizeRunnerError = normalizeRunnerError;

package/dist/program/runner-error.d.cts

@@ -0,0 +1,25 @@
+//#region src/program/runner-error.d.ts
+/**
+ * B2 — Normalize runner error shapes into `{ code, message, ...details }`.
+ *
+ * Runners surface failures two ways:
+ *   1. Return `{ success: false, error }` — structured shape varies per runner
+ *   2. Throw an Error — message often carries a `CODE: description` prefix
+ *
+ * Downstream consumers (MCP, LLM tool shim, E2E harness) expect:
+ *   - `code`: SCREAMING_SNAKE string
+ *   - `message`: human-readable string
+ *   - extra JSON-safe detail fields preserved (member, path, depth, max, …)
+ */
+interface NormalizedRunnerError {
+  code: string;
+  message: string;
+  [key: string]: unknown;
+}
+/**
+ * Coerce any error-ish value into the normalized shape.
+ */
+declare function normalizeRunnerError(err: unknown): NormalizedRunnerError;
+//#endregion
+export { NormalizedRunnerError, normalizeRunnerError };
+//# sourceMappingURL=runner-error.d.cts.map

package/dist/program/runner-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-error.d.cts","names":[],"sources":["../../src/program/runner-error.ts"],"mappings":";;AAmBA;;;;;;;;;AAyDA;;UAzDiB,qBAAA;EACf,IAAA;EACA,OAAA;EAAA,CACC,GAAA;AAAA;;;;iBAsDa,oBAAA,CAAqB,GAAA,YAAe,qBAAA"}

package/dist/program/runner-error.d.mts

@@ -0,0 +1,25 @@
+//#region src/program/runner-error.d.ts
+/**
+ * B2 — Normalize runner error shapes into `{ code, message, ...details }`.
+ *
+ * Runners surface failures two ways:
+ *   1. Return `{ success: false, error }` — structured shape varies per runner
+ *   2. Throw an Error — message often carries a `CODE: description` prefix
+ *
+ * Downstream consumers (MCP, LLM tool shim, E2E harness) expect:
+ *   - `code`: SCREAMING_SNAKE string
+ *   - `message`: human-readable string
+ *   - extra JSON-safe detail fields preserved (member, path, depth, max, …)
+ */
+interface NormalizedRunnerError {
+  code: string;
+  message: string;
+  [key: string]: unknown;
+}
+/**
+ * Coerce any error-ish value into the normalized shape.
+ */
+declare function normalizeRunnerError(err: unknown): NormalizedRunnerError;
+//#endregion
+export { NormalizedRunnerError, normalizeRunnerError };
+//# sourceMappingURL=runner-error.d.mts.map

package/dist/program/runner-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-error.d.mts","names":[],"sources":["../../src/program/runner-error.ts"],"mappings":";;AAmBA;;;;;;;;;AAyDA;;UAzDiB,qBAAA;EACf,IAAA;EACA,OAAA;EAAA,CACC,GAAA;AAAA;;;;iBAsDa,oBAAA,CAAqB,GAAA,YAAe,qBAAA"}

package/dist/program/runner-error.mjs

@@ -0,0 +1,72 @@
+import { isJsonSafe } from "./result-contract.mjs";
+
+//#region src/program/runner-error.ts
+/**
+* B2 — Normalize runner error shapes into `{ code, message, ...details }`.
+*
+* Runners surface failures two ways:
+*   1. Return `{ success: false, error }` — structured shape varies per runner
+*   2. Throw an Error — message often carries a `CODE: description` prefix
+*
+* Downstream consumers (MCP, LLM tool shim, E2E harness) expect:
+*   - `code`: SCREAMING_SNAKE string
+*   - `message`: human-readable string
+*   - extra JSON-safe detail fields preserved (member, path, depth, max, …)
+*/
+const MAX_MESSAGE_LENGTH = 2048;
+const STRUCTURED_CODE_RE = /^([A-Z][A-Z0-9_]{2,63}):\s*/;
+function truncate(s) {
+	return s.length > MAX_MESSAGE_LENGTH ? `${s.slice(0, MAX_MESSAGE_LENGTH - 1)}…` : s;
+}
+function extractCodeFromMessage(message) {
+	const m = STRUCTURED_CODE_RE.exec(message);
+	return m ? m[1] : "RUNNER_ERROR";
+}
+function normalizeFromString(raw) {
+	return {
+		code: extractCodeFromMessage(raw),
+		message: truncate(raw)
+	};
+}
+function attachDepthAndMax(err, message) {
+	if (err.code !== "MAX_SPAWN_DEPTH_EXCEEDED") return err;
+	const depthMatch = message.match(/depth (\d+)/);
+	const maxMatch = message.match(/max (\d+)/);
+	if (depthMatch) err.depth = Number(depthMatch[1]);
+	if (maxMatch) err.max = Number(maxMatch[1]);
+	return err;
+}
+function normalizeFromErrorInstance(err) {
+	return attachDepthAndMax(normalizeFromString(err.message), err.message);
+}
+function normalizeFromObject(obj) {
+	const rawCode = obj.code;
+	const rawMsg = obj.message;
+	const out = {
+		code: typeof rawCode === "string" && STRUCTURED_CODE_RE.test(`${rawCode}:`) ? rawCode : "RUNNER_ERROR",
+		message: typeof rawMsg === "string" && rawMsg.length > 0 ? truncate(rawMsg) : "(no message)"
+	};
+	for (const [k, v] of Object.entries(obj)) {
+		if (k === "code" || k === "message") continue;
+		if (typeof v === "function" || typeof v === "symbol") continue;
+		if (!isJsonSafe(v)) continue;
+		out[k] = v;
+	}
+	return out;
+}
+/**
+* Coerce any error-ish value into the normalized shape.
+*/
+function normalizeRunnerError(err) {
+	if (err instanceof Error) return normalizeFromErrorInstance(err);
+	if (typeof err === "string") return normalizeFromString(err);
+	if (err && typeof err === "object") return normalizeFromObject(err);
+	return {
+		code: "RUNNER_ERROR",
+		message: "Unknown error"
+	};
+}
+
+//#endregion
+export { normalizeRunnerError };
+//# sourceMappingURL=runner-error.mjs.map

package/dist/program/runner-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-error.mjs","names":[],"sources":["../../src/program/runner-error.ts"],"sourcesContent":["/**\n * B2 — Normalize runner error shapes into `{ code, message, ...details }`.\n *\n * Runners surface failures two ways:\n *   1. Return `{ success: false, error }` — structured shape varies per runner\n *   2. Throw an Error — message often carries a `CODE: description` prefix\n *\n * Downstream consumers (MCP, LLM tool shim, E2E harness) expect:\n *   - `code`: SCREAMING_SNAKE string\n *   - `message`: human-readable string\n *   - extra JSON-safe detail fields preserved (member, path, depth, max, …)\n */\n\nimport { isJsonSafe } from \"./result-contract.js\";\n\nconst MAX_MESSAGE_LENGTH = 2048;\n// A code looks like SCREAMING_SNAKE at start of string, terminated by \":\".\nconst STRUCTURED_CODE_RE = /^([A-Z][A-Z0-9_]{2,63}):\\s*/;\n\nexport interface NormalizedRunnerError {\n  code: string;\n  message: string;\n  [key: string]: unknown;\n}\n\nfunction truncate(s: string): string {\n  return s.length > MAX_MESSAGE_LENGTH ? `${s.slice(0, MAX_MESSAGE_LENGTH - 1)}…` : s;\n}\n\nfunction extractCodeFromMessage(message: string): string {\n  const m = STRUCTURED_CODE_RE.exec(message);\n  return m ? m[1]! : \"RUNNER_ERROR\";\n}\n\nfunction normalizeFromString(raw: string): NormalizedRunnerError {\n  return { code: extractCodeFromMessage(raw), message: truncate(raw) };\n}\n\nfunction attachDepthAndMax(err: NormalizedRunnerError, message: string): NormalizedRunnerError {\n  if (err.code !== \"MAX_SPAWN_DEPTH_EXCEEDED\") return err;\n  const depthMatch = message.match(/depth (\\d+)/);\n  const maxMatch = message.match(/max (\\d+)/);\n  if (depthMatch) err.depth = Number(depthMatch[1]);\n  if (maxMatch) err.max = Number(maxMatch[1]);\n  return err;\n}\n\nfunction normalizeFromErrorInstance(err: Error): NormalizedRunnerError {\n  const shaped = normalizeFromString(err.message);\n  return attachDepthAndMax(shaped, err.message);\n}\n\nfunction normalizeFromObject(obj: Record<string, unknown>): NormalizedRunnerError {\n  const rawCode = obj.code;\n  const rawMsg = obj.message;\n\n  const code =\n    typeof rawCode === \"string\" && STRUCTURED_CODE_RE.test(`${rawCode}:`)\n      ? rawCode\n      : \"RUNNER_ERROR\";\n  const message =\n    typeof rawMsg === \"string\" && rawMsg.length > 0 ? truncate(rawMsg) : \"(no message)\";\n\n  const out: NormalizedRunnerError = { code, message };\n  for (const [k, v] of Object.entries(obj)) {\n    if (k === \"code\" || k === \"message\") continue;\n    if (typeof v === \"function\" || typeof v === \"symbol\") continue;\n    if (!isJsonSafe(v)) continue;\n    out[k] = v;\n  }\n  return out;\n}\n\n/**\n * Coerce any error-ish value into the normalized shape.\n */\nexport function normalizeRunnerError(err: unknown): NormalizedRunnerError {\n  if (err instanceof Error) return normalizeFromErrorInstance(err);\n  if (typeof err === \"string\") return normalizeFromString(err);\n  if (err && typeof err === \"object\") return normalizeFromObject(err as Record<string, unknown>);\n  return { code: \"RUNNER_ERROR\", message: \"Unknown error\" };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,qBAAqB;AAE3B,MAAM,qBAAqB;AAQ3B,SAAS,SAAS,GAAmB;AACnC,QAAO,EAAE,SAAS,qBAAqB,GAAG,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC,KAAK;;AAGpF,SAAS,uBAAuB,SAAyB;CACvD,MAAM,IAAI,mBAAmB,KAAK,QAAQ;AAC1C,QAAO,IAAI,EAAE,KAAM;;AAGrB,SAAS,oBAAoB,KAAoC;AAC/D,QAAO;EAAE,MAAM,uBAAuB,IAAI;EAAE,SAAS,SAAS,IAAI;EAAE;;AAGtE,SAAS,kBAAkB,KAA4B,SAAwC;AAC7F,KAAI,IAAI,SAAS,2BAA4B,QAAO;CACpD,MAAM,aAAa,QAAQ,MAAM,cAAc;CAC/C,MAAM,WAAW,QAAQ,MAAM,YAAY;AAC3C,KAAI,WAAY,KAAI,QAAQ,OAAO,WAAW,GAAG;AACjD,KAAI,SAAU,KAAI,MAAM,OAAO,SAAS,GAAG;AAC3C,QAAO;;AAGT,SAAS,2BAA2B,KAAmC;AAErE,QAAO,kBADQ,oBAAoB,IAAI,QAAQ,EACd,IAAI,QAAQ;;AAG/C,SAAS,oBAAoB,KAAqD;CAChF,MAAM,UAAU,IAAI;CACpB,MAAM,SAAS,IAAI;CASnB,MAAM,MAA6B;EAAE,MANnC,OAAO,YAAY,YAAY,mBAAmB,KAAK,GAAG,QAAQ,GAAG,GACjE,UACA;EAIqC,SAFzC,OAAO,WAAW,YAAY,OAAO,SAAS,IAAI,SAAS,OAAO,GAAG;EAEnB;AACpD,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,EAAE;AACxC,MAAI,MAAM,UAAU,MAAM,UAAW;AACrC,MAAI,OAAO,MAAM,cAAc,OAAO,MAAM,SAAU;AACtD,MAAI,CAAC,WAAW,EAAE,CAAE;AACpB,MAAI,KAAK;;AAEX,QAAO;;;;;AAMT,SAAgB,qBAAqB,KAAqC;AACxE,KAAI,eAAe,MAAO,QAAO,2BAA2B,IAAI;AAChE,KAAI,OAAO,QAAQ,SAAU,QAAO,oBAAoB,IAAI;AAC5D,KAAI,OAAO,OAAO,QAAQ,SAAU,QAAO,oBAAoB,IAA+B;AAC9F,QAAO;EAAE,MAAM;EAAgB,SAAS;EAAiB"}