@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/core/sandbox/skills/SkillMounter.mjs

@@ -0,0 +1,48 @@
+// src/core/sandbox/skills/SkillMounter.ts
+import { SKILL_DOWNLOAD_TIMEOUT_SECONDS, buildWriteAndRunScriptCommand } from "../Sandbox.mjs";
+import { sandboxScripts } from "../sandboxScripts.gen.mjs";
+import { SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from "./constants.mjs";
+var GIT_DOWNLOADER_PATH = "/opt/tfy/git_downloader.py";
+var SkillMounter = class {
+  skills;
+  constructor(skills) {
+    this.skills = skills;
+  }
+  instruction(builder) {
+    if (this.skills.length === 0) return;
+    builder.addContent(SKILLS_PREAMBLE);
+    for (const skill of this.skills) {
+      builder.addSection(
+        "skill",
+        renderSkillPromptBody({
+          path: getSkillPath(skill.name),
+          name: skill.name,
+          description: skill.description,
+          preloadContent: null
+        })
+      );
+    }
+  }
+  getSandboxInit() {
+    const specs = this.skills.map((skill) => ({
+      name: skill.name,
+      url: skill.url,
+      path: skill.path,
+      ref: skill.ref
+    }));
+    const gitSkillsB64 = Buffer.from(JSON.stringify(specs)).toString("base64");
+    return {
+      command: buildWriteAndRunScriptCommand({
+        scriptPath: GIT_DOWNLOADER_PATH,
+        // Bundled at build time (sandboxScripts.gen.ts) so the packaged library has no loose files.
+        scriptContent: sandboxScripts.gitDownloader
+      }),
+      env: { AGENT_GIT_SKILLS: gitSkillsB64 },
+      timeoutSeconds: SKILL_DOWNLOAD_TIMEOUT_SECONDS
+    };
+  }
+};
+export {
+  SkillMounter
+};
+//# sourceMappingURL=SkillMounter.mjs.map

package/dist/core/sandbox/skills/SkillMounter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/sandbox/skills/SkillMounter.ts"],"sourcesContent":["import type { InstructionBuilder } from '../../InstructionBuilder';\nimport type { SandboxInit } from '../provider/Provider';\nimport { SKILL_DOWNLOAD_TIMEOUT_SECONDS, buildWriteAndRunScriptCommand } from '../Sandbox';\nimport { sandboxScripts } from '../sandboxScripts.gen';\nimport { SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from './constants';\nimport type { ISkillMounter } from './ISkillMounter';\n\n// Absolute path the git skill downloader script is uploaded to before it is run.\nconst GIT_DOWNLOADER_PATH = '/opt/tfy/git_downloader.py';\n\n// A git-sourced skill materialized by a sparse clone in the sandbox (git_downloader.py). Git skills\n// never preload — their SKILL.md is read from disk at runtime (only name/description/path are\n// advertised in the prompt). Wire fields match the agent_spec git mount (`url`/`path`/`name`/`ref`);\n// the downloader resolves `ref` inside the sandbox before fetching.\nexport interface GitSkill {\n  readonly name: string;\n  readonly description: string;\n  // Canonical https clone URL of the github.com/gitlab.com repo (host-validated by the caller).\n  readonly url: string;\n  // Subdirectory within the repo that holds the skill (empty = repo root).\n  readonly path: string;\n  // Branch, tag, or full object id — resolved and fetched by git_downloader.py in the sandbox.\n  readonly ref: string;\n}\n\n// Serializable descriptor handed to git_downloader.py (base64 JSON); keys match its GitSkill model.\ninterface GitSkillSpec {\n  name: string;\n  url: string;\n  path: string;\n  ref: string;\n}\n\nexport class SkillMounter implements ISkillMounter {\n  private readonly skills: readonly GitSkill[];\n\n  constructor(skills: readonly GitSkill[]) {\n    this.skills = skills;\n  }\n\n  instruction(builder: InstructionBuilder): void {\n    if (this.skills.length === 0) return;\n    builder.addContent(SKILLS_PREAMBLE);\n    for (const skill of this.skills) {\n      builder.addSection(\n        'skill',\n        renderSkillPromptBody({\n          path: getSkillPath(skill.name),\n          name: skill.name,\n          description: skill.description,\n          preloadContent: null,\n        }),\n      );\n    }\n  }\n\n  getSandboxInit(): SandboxInit {\n    // An empty desired set is also the source-neutral cleanup path for a reused sandbox.\n    const specs: GitSkillSpec[] = this.skills.map(skill => ({\n      name: skill.name,\n      url: skill.url,\n      path: skill.path,\n      ref: skill.ref,\n    }));\n    const gitSkillsB64 = Buffer.from(JSON.stringify(specs)).toString('base64');\n    return {\n      command: buildWriteAndRunScriptCommand({\n        scriptPath: GIT_DOWNLOADER_PATH,\n        // Bundled at build time (sandboxScripts.gen.ts) so the packaged library has no loose files.\n        scriptContent: sandboxScripts.gitDownloader,\n      }),\n      env: { AGENT_GIT_SKILLS: gitSkillsB64 },\n      timeoutSeconds: SKILL_DOWNLOAD_TIMEOUT_SECONDS,\n    };\n  }\n}\n"],"mappings":";AAEA,SAAS,gCAAgC,qCAAqC;AAC9E,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB,cAAc,6BAA6B;AAIrE,IAAM,sBAAsB;AAyBrB,IAAM,eAAN,MAA4C;AAAA,EAChC;AAAA,EAEjB,YAAY,QAA6B;AACvC,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,YAAY,SAAmC;AAC7C,QAAI,KAAK,OAAO,WAAW,EAAG;AAC9B,YAAQ,WAAW,eAAe;AAClC,eAAW,SAAS,KAAK,QAAQ;AAC/B,cAAQ;AAAA,QACN;AAAA,QACA,sBAAsB;AAAA,UACpB,MAAM,aAAa,MAAM,IAAI;AAAA,UAC7B,MAAM,MAAM;AAAA,UACZ,aAAa,MAAM;AAAA,UACnB,gBAAgB;AAAA,QAClB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,iBAA8B;AAE5B,UAAM,QAAwB,KAAK,OAAO,IAAI,YAAU;AAAA,MACtD,MAAM,MAAM;AAAA,MACZ,KAAK,MAAM;AAAA,MACX,MAAM,MAAM;AAAA,MACZ,KAAK,MAAM;AAAA,IACb,EAAE;AACF,UAAM,eAAe,OAAO,KAAK,KAAK,UAAU,KAAK,CAAC,EAAE,SAAS,QAAQ;AACzE,WAAO;AAAA,MACL,SAAS,8BAA8B;AAAA,QACrC,YAAY;AAAA;AAAA,QAEZ,eAAe,eAAe;AAAA,MAChC,CAAC;AAAA,MACD,KAAK,EAAE,kBAAkB,aAAa;AAAA,MACtC,gBAAgB;AAAA,IAClB;AAAA,EACF;AACF;","names":[]}

package/dist/core/sandbox/skills/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const SKILLS_DIR = "/opt/tfy/skills";
+export declare function getSkillPath(skillName: string): string;
+export declare const SKILLS_PREAMBLE: string;
+export declare function renderSkillPromptBody(params: {
+    path: string;
+    name: string;
+    description: string;
+    preloadContent: string | null;
+}): string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/sandbox/skills/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/core/sandbox/skills/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAG5C,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,eAAO,MAAM,eAAe,QAQhB,CAAC;AAGb,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,MAAM,CAIT"}

package/dist/core/sandbox/skills/constants.js

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/sandbox/skills/constants.ts
+var constants_exports = {};
+__export(constants_exports, {
+  SKILLS_DIR: () => SKILLS_DIR,
+  SKILLS_PREAMBLE: () => SKILLS_PREAMBLE,
+  getSkillPath: () => getSkillPath,
+  renderSkillPromptBody: () => renderSkillPromptBody
+});
+module.exports = __toCommonJS(constants_exports);
+var SKILLS_DIR = "/opt/tfy/skills";
+function getSkillPath(skillName) {
+  return `${SKILLS_DIR}/${skillName}`;
+}
+var SKILLS_PREAMBLE = [
+  "1. The skill is present in the `path` directory.",
+  "2. SKILL.md file within the directory is the primary file, there can be other files as well.",
+  "3. Use `description` to judge whether the Agent needs to use a skill.",
+  "4. To use a skill:",
+  "4.a. If the `SKILL.md content` is inlined, the Agent must not read `path/SKILL.md`.",
+  "4.b. Otherwise the Agent must read `path/SKILL.md` first.",
+  "5. The Agent must avoid listing the `path` unless there are references in `SKILL.md` and there is reason to do so given the current conversation."
+].join("\n");
+function renderSkillPromptBody(params) {
+  return params.preloadContent ? `path: ${params.path}
+SKILL.md content:
+${params.preloadContent}` : `path: ${params.path}
+name: ${params.name}
+description: ${params.description}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SKILLS_DIR,
+  SKILLS_PREAMBLE,
+  getSkillPath,
+  renderSkillPromptBody
+});
+//# sourceMappingURL=constants.js.map

package/dist/core/sandbox/skills/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/sandbox/skills/constants.ts"],"sourcesContent":["// Skill prompt constants and helpers: how skills are described to the agent in the system prompt.\n\n// Directory inside the sandbox where every skill (whatever its origin) is materialized.\nexport const SKILLS_DIR = '/opt/tfy/skills';\n\n// On-disk directory a skill is materialized into, keyed by its (unique) name.\nexport function getSkillPath(skillName: string): string {\n  return `${SKILLS_DIR}/${skillName}`;\n}\n\nexport const SKILLS_PREAMBLE = [\n  '1. The skill is present in the `path` directory.',\n  '2. SKILL.md file within the directory is the primary file, there can be other files as well.',\n  '3. Use `description` to judge whether the Agent needs to use a skill.',\n  '4. To use a skill:',\n  '4.a. If the `SKILL.md content` is inlined, the Agent must not read `path/SKILL.md`.',\n  '4.b. Otherwise the Agent must read `path/SKILL.md` first.',\n  '5. The Agent must avoid listing the `path` unless there are references in `SKILL.md` and there is reason to do so given the current conversation.',\n].join('\\n');\n\n// The <skill> block body: inline preloaded SKILL.md when present, else advertise path/name/description.\nexport function renderSkillPromptBody(params: {\n  path: string;\n  name: string;\n  description: string;\n  preloadContent: string | null;\n}): string {\n  return params.preloadContent\n    ? `path: ${params.path}\\nSKILL.md content:\\n${params.preloadContent}`\n    : `path: ${params.path}\\nname: ${params.name}\\ndescription: ${params.description}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,IAAM,aAAa;AAGnB,SAAS,aAAa,WAA2B;AACtD,SAAO,GAAG,UAAU,IAAI,SAAS;AACnC;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAGJ,SAAS,sBAAsB,QAK3B;AACT,SAAO,OAAO,iBACV,SAAS,OAAO,IAAI;AAAA;AAAA,EAAwB,OAAO,cAAc,KACjE,SAAS,OAAO,IAAI;AAAA,QAAW,OAAO,IAAI;AAAA,eAAkB,OAAO,WAAW;AACpF;","names":[]}

package/dist/core/sandbox/skills/constants.mjs

@@ -0,0 +1,28 @@
+// src/core/sandbox/skills/constants.ts
+var SKILLS_DIR = "/opt/tfy/skills";
+function getSkillPath(skillName) {
+  return `${SKILLS_DIR}/${skillName}`;
+}
+var SKILLS_PREAMBLE = [
+  "1. The skill is present in the `path` directory.",
+  "2. SKILL.md file within the directory is the primary file, there can be other files as well.",
+  "3. Use `description` to judge whether the Agent needs to use a skill.",
+  "4. To use a skill:",
+  "4.a. If the `SKILL.md content` is inlined, the Agent must not read `path/SKILL.md`.",
+  "4.b. Otherwise the Agent must read `path/SKILL.md` first.",
+  "5. The Agent must avoid listing the `path` unless there are references in `SKILL.md` and there is reason to do so given the current conversation."
+].join("\n");
+function renderSkillPromptBody(params) {
+  return params.preloadContent ? `path: ${params.path}
+SKILL.md content:
+${params.preloadContent}` : `path: ${params.path}
+name: ${params.name}
+description: ${params.description}`;
+}
+export {
+  SKILLS_DIR,
+  SKILLS_PREAMBLE,
+  getSkillPath,
+  renderSkillPromptBody
+};
+//# sourceMappingURL=constants.mjs.map

package/dist/core/sandbox/skills/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/sandbox/skills/constants.ts"],"sourcesContent":["// Skill prompt constants and helpers: how skills are described to the agent in the system prompt.\n\n// Directory inside the sandbox where every skill (whatever its origin) is materialized.\nexport const SKILLS_DIR = '/opt/tfy/skills';\n\n// On-disk directory a skill is materialized into, keyed by its (unique) name.\nexport function getSkillPath(skillName: string): string {\n  return `${SKILLS_DIR}/${skillName}`;\n}\n\nexport const SKILLS_PREAMBLE = [\n  '1. The skill is present in the `path` directory.',\n  '2. SKILL.md file within the directory is the primary file, there can be other files as well.',\n  '3. Use `description` to judge whether the Agent needs to use a skill.',\n  '4. To use a skill:',\n  '4.a. If the `SKILL.md content` is inlined, the Agent must not read `path/SKILL.md`.',\n  '4.b. Otherwise the Agent must read `path/SKILL.md` first.',\n  '5. The Agent must avoid listing the `path` unless there are references in `SKILL.md` and there is reason to do so given the current conversation.',\n].join('\\n');\n\n// The <skill> block body: inline preloaded SKILL.md when present, else advertise path/name/description.\nexport function renderSkillPromptBody(params: {\n  path: string;\n  name: string;\n  description: string;\n  preloadContent: string | null;\n}): string {\n  return params.preloadContent\n    ? `path: ${params.path}\\nSKILL.md content:\\n${params.preloadContent}`\n    : `path: ${params.path}\\nname: ${params.name}\\ndescription: ${params.description}`;\n}\n"],"mappings":";AAGO,IAAM,aAAa;AAGnB,SAAS,aAAa,WAA2B;AACtD,SAAO,GAAG,UAAU,IAAI,SAAS;AACnC;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAGJ,SAAS,sBAAsB,QAK3B;AACT,SAAO,OAAO,iBACV,SAAS,OAAO,IAAI;AAAA;AAAA,EAAwB,OAAO,cAAc,KACjE,SAAS,OAAO,IAAI;AAAA,QAAW,OAAO,IAAI;AAAA,eAAkB,OAAO,WAAW;AACpF;","names":[]}

package/dist/core/sandbox/skills/index.d.ts

@@ -0,0 +1,5 @@
+export { SKILLS_DIR, SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from './constants';
+export type { ISkillMounter } from './ISkillMounter';
+export { SkillMounter } from './SkillMounter';
+export type { GitSkill } from './SkillMounter';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/sandbox/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/sandbox/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC/F,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/sandbox/skills/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/sandbox/skills/index.ts
+var skills_exports = {};
+__export(skills_exports, {
+  SKILLS_DIR: () => import_constants.SKILLS_DIR,
+  SKILLS_PREAMBLE: () => import_constants.SKILLS_PREAMBLE,
+  SkillMounter: () => import_SkillMounter.SkillMounter,
+  getSkillPath: () => import_constants.getSkillPath,
+  renderSkillPromptBody: () => import_constants.renderSkillPromptBody
+});
+module.exports = __toCommonJS(skills_exports);
+var import_constants = require("./constants.js");
+var import_SkillMounter = require("./SkillMounter.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SKILLS_DIR,
+  SKILLS_PREAMBLE,
+  SkillMounter,
+  getSkillPath,
+  renderSkillPromptBody
+});
+//# sourceMappingURL=index.js.map

package/dist/core/sandbox/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/sandbox/skills/index.ts"],"sourcesContent":["export { SKILLS_DIR, SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from './constants';\nexport type { ISkillMounter } from './ISkillMounter';\nexport { SkillMounter } from './SkillMounter';\nexport type { GitSkill } from './SkillMounter';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAiF;AAEjF,0BAA6B;","names":[]}

package/dist/core/sandbox/skills/index.mjs

@@ -0,0 +1,11 @@
+// src/core/sandbox/skills/index.ts
+import { SKILLS_DIR, SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from "./constants.mjs";
+import { SkillMounter } from "./SkillMounter.mjs";
+export {
+  SKILLS_DIR,
+  SKILLS_PREAMBLE,
+  SkillMounter,
+  getSkillPath,
+  renderSkillPromptBody
+};
+//# sourceMappingURL=index.mjs.map

package/dist/core/sandbox/skills/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/sandbox/skills/index.ts"],"sourcesContent":["export { SKILLS_DIR, SKILLS_PREAMBLE, getSkillPath, renderSkillPromptBody } from './constants';\nexport type { ISkillMounter } from './ISkillMounter';\nexport { SkillMounter } from './SkillMounter';\nexport type { GitSkill } from './SkillMounter';\n"],"mappings":";AAAA,SAAS,YAAY,iBAAiB,cAAc,6BAA6B;AAEjF,SAAS,oBAAoB;","names":[]}

package/dist/core/tracing/AgentTracing.d.ts

@@ -0,0 +1,38 @@
+import type { AgentThreadMetrics } from '../runtime/metrics';
+export interface AgentExecutionTrace {
+    runInContext<T>(operation: () => T): T;
+    startSubAgent(name: string, input: string): AgentExecutionTrace;
+    setOutput(output: string): void;
+    setMetrics(metrics: AgentThreadMetrics): void;
+    setError(error: unknown): void;
+    setSuccess(): void;
+    end(): void;
+}
+export interface AgentLocalToolTrace {
+    setOutput(output: string): void;
+    setSandboxId(sandboxId: string): void;
+}
+export interface AgentRemoteMcpToolTrace {
+    setOutput(output: string): void;
+    setNumberOfTools(count: number): void;
+}
+export interface AgentTracing {
+    withInitSpan<T>(operation: () => Promise<T>): Promise<T>;
+    startRootSpan(input: string): AgentExecutionTrace;
+    withLocalToolSpan<T>(input: {
+        displayName: string;
+        toolName: string;
+        input?: string | undefined;
+        enabled: boolean;
+    }, operation: (span: AgentLocalToolTrace) => Promise<T>): Promise<T>;
+    withRemoteMcpToolSpan<T>(input: {
+        method: string;
+        serverName: string;
+        serverId: string;
+        serverUrl: string;
+        toolName?: string | undefined;
+        input?: string | undefined;
+        enabled: boolean;
+    }, operation: (span: AgentRemoteMcpToolTrace) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=AgentTracing.d.ts.map

package/dist/core/tracing/AgentTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTracing.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/AgentTracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACvC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAChE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,UAAU,IAAI,IAAI,CAAC;IACnB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAElD,iBAAiB,CAAC,CAAC,EACjB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;KAClB,EACD,SAAS,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC,CAAC;IAGd,qBAAqB,CAAC,CAAC,EACrB,KAAK,EAAE;QAEL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;KAClB,EACD,SAAS,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC,CAAC,CAAC,GACvD,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}

package/dist/core/tracing/AgentTracing.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/tracing/AgentTracing.ts
+var AgentTracing_exports = {};
+module.exports = __toCommonJS(AgentTracing_exports);
+//# sourceMappingURL=AgentTracing.js.map

package/dist/core/tracing/AgentTracing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/tracing/AgentTracing.ts"],"sourcesContent":["import type { AgentThreadMetrics } from '../runtime/metrics';\n\nexport interface AgentExecutionTrace {\n  runInContext<T>(operation: () => T): T;\n  startSubAgent(name: string, input: string): AgentExecutionTrace;\n  setOutput(output: string): void;\n  setMetrics(metrics: AgentThreadMetrics): void;\n  setError(error: unknown): void;\n  setSuccess(): void;\n  end(): void;\n}\n\nexport interface AgentLocalToolTrace {\n  setOutput(output: string): void;\n  setSandboxId(sandboxId: string): void;\n}\n\nexport interface AgentRemoteMcpToolTrace {\n  setOutput(output: string): void;\n  setNumberOfTools(count: number): void;\n}\n\nexport interface AgentTracing {\n  withInitSpan<T>(operation: () => Promise<T>): Promise<T>;\n\n  startRootSpan(input: string): AgentExecutionTrace;\n\n  withLocalToolSpan<T>(\n    input: {\n      displayName: string;\n      toolName: string;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentLocalToolTrace) => Promise<T>,\n  ): Promise<T>;\n\n  // Span for a remote (url-based) MCP operation. `serverUrl` must already be redacted (no secrets).\n  withRemoteMcpToolSpan<T>(\n    input: {\n      // MCP method: 'initialize' | 'tools/list' | 'tools/call'.\n      method: string;\n      serverName: string;\n      serverId: string;\n      serverUrl: string;\n      toolName?: string | undefined;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentRemoteMcpToolTrace) => Promise<T>,\n  ): Promise<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/core/tracing/AgentTracing.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=AgentTracing.mjs.map

package/dist/core/tracing/AgentTracing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/tracing/NoopAgentTracing.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTracing } from './AgentTracing';
+export declare const NOOP_AGENT_TRACING: AgentTracing;
+//# sourceMappingURL=NoopAgentTracing.d.ts.map

package/dist/core/tracing/NoopAgentTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopAgentTracing.d.ts","sourceRoot":"","sources":["../../../src/core/tracing/NoopAgentTracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwDtH,eAAO,MAAM,kBAAkB,EAAE,YAqChC,CAAC"}

package/dist/core/tracing/NoopAgentTracing.js

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/tracing/NoopAgentTracing.ts
+var NoopAgentTracing_exports = {};
+__export(NoopAgentTracing_exports, {
+  NOOP_AGENT_TRACING: () => NOOP_AGENT_TRACING
+});
+module.exports = __toCommonJS(NoopAgentTracing_exports);
+var NoopAgentExecutionTrace = class {
+  runInContext(operation) {
+    return operation();
+  }
+  startSubAgent() {
+    return this;
+  }
+  setOutput() {
+  }
+  setMetrics() {
+  }
+  setError() {
+  }
+  setSuccess() {
+  }
+  end() {
+  }
+};
+var NoopAgentLocalToolTrace = class {
+  setOutput() {
+  }
+  setSandboxId() {
+  }
+};
+var NoopAgentRemoteMcpToolTrace = class {
+  setOutput() {
+  }
+  setNumberOfTools() {
+  }
+};
+var NOOP_EXECUTION_TRACE = new NoopAgentExecutionTrace();
+var NOOP_LOCAL_TOOL_TRACE = new NoopAgentLocalToolTrace();
+var NOOP_REMOTE_MCP_TOOL_TRACE = new NoopAgentRemoteMcpToolTrace();
+var NOOP_AGENT_TRACING = {
+  async withInitSpan(operation) {
+    return operation();
+  },
+  startRootSpan() {
+    return NOOP_EXECUTION_TRACE;
+  },
+  async withLocalToolSpan(_input, operation) {
+    void _input;
+    return operation(NOOP_LOCAL_TOOL_TRACE);
+  },
+  async withRemoteMcpToolSpan(_input, operation) {
+    void _input;
+    return operation(NOOP_REMOTE_MCP_TOOL_TRACE);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NOOP_AGENT_TRACING
+});
+//# sourceMappingURL=NoopAgentTracing.js.map

package/dist/core/tracing/NoopAgentTracing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/tracing/NoopAgentTracing.ts"],"sourcesContent":["import type { AgentExecutionTrace, AgentLocalToolTrace, AgentRemoteMcpToolTrace, AgentTracing } from './AgentTracing';\n\nclass NoopAgentExecutionTrace implements AgentExecutionTrace {\n  runInContext<T>(operation: () => T): T {\n    return operation();\n  }\n\n  startSubAgent(): AgentExecutionTrace {\n    return this;\n  }\n\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setMetrics(): void {\n    /* no-op */\n  }\n\n  setError(): void {\n    /* no-op */\n  }\n\n  setSuccess(): void {\n    /* no-op */\n  }\n\n  end(): void {\n    /* no-op */\n  }\n}\n\nclass NoopAgentLocalToolTrace implements AgentLocalToolTrace {\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setSandboxId(): void {\n    /* no-op */\n  }\n}\n\nclass NoopAgentRemoteMcpToolTrace implements AgentRemoteMcpToolTrace {\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setNumberOfTools(): void {\n    /* no-op */\n  }\n}\n\nconst NOOP_EXECUTION_TRACE = new NoopAgentExecutionTrace();\nconst NOOP_LOCAL_TOOL_TRACE = new NoopAgentLocalToolTrace();\nconst NOOP_REMOTE_MCP_TOOL_TRACE = new NoopAgentRemoteMcpToolTrace();\n\nexport const NOOP_AGENT_TRACING: AgentTracing = {\n  async withInitSpan<T>(operation: () => Promise<T>): Promise<T> {\n    return operation();\n  },\n\n  startRootSpan(): AgentExecutionTrace {\n    return NOOP_EXECUTION_TRACE;\n  },\n\n  async withLocalToolSpan<T>(\n    _input: {\n      displayName: string;\n      toolName: string;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentLocalToolTrace) => Promise<T>,\n  ): Promise<T> {\n    void _input;\n    return operation(NOOP_LOCAL_TOOL_TRACE);\n  },\n\n  async withRemoteMcpToolSpan<T>(\n    _input: {\n      method: string;\n      serverName: string;\n      serverId: string;\n      serverUrl: string;\n      toolName?: string | undefined;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentRemoteMcpToolTrace) => Promise<T>,\n  ): Promise<T> {\n    void _input;\n    return operation(NOOP_REMOTE_MCP_TOOL_TRACE);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,0BAAN,MAA6D;AAAA,EAC3D,aAAgB,WAAuB;AACrC,WAAO,UAAU;AAAA,EACnB;AAAA,EAEA,gBAAqC;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,YAAkB;AAAA,EAElB;AAAA,EAEA,aAAmB;AAAA,EAEnB;AAAA,EAEA,WAAiB;AAAA,EAEjB;AAAA,EAEA,aAAmB;AAAA,EAEnB;AAAA,EAEA,MAAY;AAAA,EAEZ;AACF;AAEA,IAAM,0BAAN,MAA6D;AAAA,EAC3D,YAAkB;AAAA,EAElB;AAAA,EAEA,eAAqB;AAAA,EAErB;AACF;AAEA,IAAM,8BAAN,MAAqE;AAAA,EACnE,YAAkB;AAAA,EAElB;AAAA,EAEA,mBAAyB;AAAA,EAEzB;AACF;AAEA,IAAM,uBAAuB,IAAI,wBAAwB;AACzD,IAAM,wBAAwB,IAAI,wBAAwB;AAC1D,IAAM,6BAA6B,IAAI,4BAA4B;AAE5D,IAAM,qBAAmC;AAAA,EAC9C,MAAM,aAAgB,WAAyC;AAC7D,WAAO,UAAU;AAAA,EACnB;AAAA,EAEA,gBAAqC;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,kBACJ,QAMA,WACY;AACZ,SAAK;AACL,WAAO,UAAU,qBAAqB;AAAA,EACxC;AAAA,EAEA,MAAM,sBACJ,QASA,WACY;AACZ,SAAK;AACL,WAAO,UAAU,0BAA0B;AAAA,EAC7C;AACF;","names":[]}

package/dist/core/tracing/NoopAgentTracing.mjs

@@ -0,0 +1,54 @@
+// src/core/tracing/NoopAgentTracing.ts
+var NoopAgentExecutionTrace = class {
+  runInContext(operation) {
+    return operation();
+  }
+  startSubAgent() {
+    return this;
+  }
+  setOutput() {
+  }
+  setMetrics() {
+  }
+  setError() {
+  }
+  setSuccess() {
+  }
+  end() {
+  }
+};
+var NoopAgentLocalToolTrace = class {
+  setOutput() {
+  }
+  setSandboxId() {
+  }
+};
+var NoopAgentRemoteMcpToolTrace = class {
+  setOutput() {
+  }
+  setNumberOfTools() {
+  }
+};
+var NOOP_EXECUTION_TRACE = new NoopAgentExecutionTrace();
+var NOOP_LOCAL_TOOL_TRACE = new NoopAgentLocalToolTrace();
+var NOOP_REMOTE_MCP_TOOL_TRACE = new NoopAgentRemoteMcpToolTrace();
+var NOOP_AGENT_TRACING = {
+  async withInitSpan(operation) {
+    return operation();
+  },
+  startRootSpan() {
+    return NOOP_EXECUTION_TRACE;
+  },
+  async withLocalToolSpan(_input, operation) {
+    void _input;
+    return operation(NOOP_LOCAL_TOOL_TRACE);
+  },
+  async withRemoteMcpToolSpan(_input, operation) {
+    void _input;
+    return operation(NOOP_REMOTE_MCP_TOOL_TRACE);
+  }
+};
+export {
+  NOOP_AGENT_TRACING
+};
+//# sourceMappingURL=NoopAgentTracing.mjs.map

package/dist/core/tracing/NoopAgentTracing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/tracing/NoopAgentTracing.ts"],"sourcesContent":["import type { AgentExecutionTrace, AgentLocalToolTrace, AgentRemoteMcpToolTrace, AgentTracing } from './AgentTracing';\n\nclass NoopAgentExecutionTrace implements AgentExecutionTrace {\n  runInContext<T>(operation: () => T): T {\n    return operation();\n  }\n\n  startSubAgent(): AgentExecutionTrace {\n    return this;\n  }\n\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setMetrics(): void {\n    /* no-op */\n  }\n\n  setError(): void {\n    /* no-op */\n  }\n\n  setSuccess(): void {\n    /* no-op */\n  }\n\n  end(): void {\n    /* no-op */\n  }\n}\n\nclass NoopAgentLocalToolTrace implements AgentLocalToolTrace {\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setSandboxId(): void {\n    /* no-op */\n  }\n}\n\nclass NoopAgentRemoteMcpToolTrace implements AgentRemoteMcpToolTrace {\n  setOutput(): void {\n    /* no-op */\n  }\n\n  setNumberOfTools(): void {\n    /* no-op */\n  }\n}\n\nconst NOOP_EXECUTION_TRACE = new NoopAgentExecutionTrace();\nconst NOOP_LOCAL_TOOL_TRACE = new NoopAgentLocalToolTrace();\nconst NOOP_REMOTE_MCP_TOOL_TRACE = new NoopAgentRemoteMcpToolTrace();\n\nexport const NOOP_AGENT_TRACING: AgentTracing = {\n  async withInitSpan<T>(operation: () => Promise<T>): Promise<T> {\n    return operation();\n  },\n\n  startRootSpan(): AgentExecutionTrace {\n    return NOOP_EXECUTION_TRACE;\n  },\n\n  async withLocalToolSpan<T>(\n    _input: {\n      displayName: string;\n      toolName: string;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentLocalToolTrace) => Promise<T>,\n  ): Promise<T> {\n    void _input;\n    return operation(NOOP_LOCAL_TOOL_TRACE);\n  },\n\n  async withRemoteMcpToolSpan<T>(\n    _input: {\n      method: string;\n      serverName: string;\n      serverId: string;\n      serverUrl: string;\n      toolName?: string | undefined;\n      input?: string | undefined;\n      enabled: boolean;\n    },\n    operation: (span: AgentRemoteMcpToolTrace) => Promise<T>,\n  ): Promise<T> {\n    void _input;\n    return operation(NOOP_REMOTE_MCP_TOOL_TRACE);\n  },\n};\n"],"mappings":";AAEA,IAAM,0BAAN,MAA6D;AAAA,EAC3D,aAAgB,WAAuB;AACrC,WAAO,UAAU;AAAA,EACnB;AAAA,EAEA,gBAAqC;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,YAAkB;AAAA,EAElB;AAAA,EAEA,aAAmB;AAAA,EAEnB;AAAA,EAEA,WAAiB;AAAA,EAEjB;AAAA,EAEA,aAAmB;AAAA,EAEnB;AAAA,EAEA,MAAY;AAAA,EAEZ;AACF;AAEA,IAAM,0BAAN,MAA6D;AAAA,EAC3D,YAAkB;AAAA,EAElB;AAAA,EAEA,eAAqB;AAAA,EAErB;AACF;AAEA,IAAM,8BAAN,MAAqE;AAAA,EACnE,YAAkB;AAAA,EAElB;AAAA,EAEA,mBAAyB;AAAA,EAEzB;AACF;AAEA,IAAM,uBAAuB,IAAI,wBAAwB;AACzD,IAAM,wBAAwB,IAAI,wBAAwB;AAC1D,IAAM,6BAA6B,IAAI,4BAA4B;AAE5D,IAAM,qBAAmC;AAAA,EAC9C,MAAM,aAAgB,WAAyC;AAC7D,WAAO,UAAU;AAAA,EACnB;AAAA,EAEA,gBAAqC;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,kBACJ,QAMA,WACY;AACZ,SAAK;AACL,WAAO,UAAU,qBAAqB;AAAA,EACxC;AAAA,EAEA,MAAM,sBACJ,QASA,WACY;AACZ,SAAK;AACL,WAAO,UAAU,0BAA0B;AAAA,EAC7C;AACF;","names":[]}

package/dist/core/util/abort.d.ts

@@ -0,0 +1,2 @@
+export declare function onSignalAbort(signal: AbortSignal | undefined, callback: () => void): void;
+//# sourceMappingURL=abort.d.ts.map

package/dist/core/util/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../src/core/util/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAOzF"}

package/dist/core/util/abort.js

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/util/abort.ts
+var abort_exports = {};
+__export(abort_exports, {
+  onSignalAbort: () => onSignalAbort
+});
+module.exports = __toCommonJS(abort_exports);
+function onSignalAbort(signal, callback) {
+  if (!signal) return;
+  if (signal.aborted) {
+    callback();
+    return;
+  }
+  signal.addEventListener("abort", callback, { once: true });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  onSignalAbort
+});
+//# sourceMappingURL=abort.js.map

package/dist/core/util/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/util/abort.ts"],"sourcesContent":["export function onSignalAbort(signal: AbortSignal | undefined, callback: () => void): void {\n  if (!signal) return;\n  if (signal.aborted) {\n    callback();\n    return;\n  }\n  signal.addEventListener('abort', callback, { once: true });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,SAAS,cAAc,QAAiC,UAA4B;AACzF,MAAI,CAAC,OAAQ;AACb,MAAI,OAAO,SAAS;AAClB,aAAS;AACT;AAAA,EACF;AACA,SAAO,iBAAiB,SAAS,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3D;","names":[]}

package/dist/core/util/abort.mjs

@@ -0,0 +1,13 @@
+// src/core/util/abort.ts
+function onSignalAbort(signal, callback) {
+  if (!signal) return;
+  if (signal.aborted) {
+    callback();
+    return;
+  }
+  signal.addEventListener("abort", callback, { once: true });
+}
+export {
+  onSignalAbort
+};
+//# sourceMappingURL=abort.mjs.map

package/dist/core/util/abort.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/util/abort.ts"],"sourcesContent":["export function onSignalAbort(signal: AbortSignal | undefined, callback: () => void): void {\n  if (!signal) return;\n  if (signal.aborted) {\n    callback();\n    return;\n  }\n  signal.addEventListener('abort', callback, { once: true });\n}\n"],"mappings":";AAAO,SAAS,cAAc,QAAiC,UAA4B;AACzF,MAAI,CAAC,OAAQ;AACb,MAAI,OAAO,SAAS;AAClB,aAAS;AACT;AAAA,EACF;AACA,SAAO,iBAAiB,SAAS,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3D;","names":[]}

package/dist/core/util/errorLogFields.d.ts

@@ -0,0 +1,11 @@
+export interface ErrorLogFields {
+    error: string;
+    stack?: string | undefined;
+}
+/**
+ * User/turn-facing message for any thrown value. Prefer Error.message / `.message`;
+ * never surface developer-only strings (e.g. unserialisable dumps) in Agent Steps.
+ */
+export declare function describeUnknownError(error: unknown): string;
+export declare function extractErrorLogFields(error: unknown): ErrorLogFields;
+//# sourceMappingURL=errorLogFields.d.ts.map

package/dist/core/util/errorLogFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorLogFields.d.ts","sourceRoot":"","sources":["../../../src/core/util/errorLogFields.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAUD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgB3D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAepE"}

package/dist/core/util/errorLogFields.js

@@ -0,0 +1,72 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/util/errorLogFields.ts
+var errorLogFields_exports = {};
+__export(errorLogFields_exports, {
+  describeUnknownError: () => describeUnknownError,
+  extractErrorLogFields: () => extractErrorLogFields
+});
+module.exports = __toCommonJS(errorLogFields_exports);
+function formatObjectErrorForLog(error) {
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return `unserialisable error (${Object.keys(error).join(", ")})`;
+  }
+}
+function describeUnknownError(error) {
+  if (error instanceof Error) {
+    return error.message.length > 0 ? error.message : "An unexpected error occurred";
+  }
+  if (typeof error !== "object" || error === null) {
+    return String(error);
+  }
+  const message = Reflect.get(error, "message");
+  if (typeof message === "string" && message.length > 0) {
+    return message;
+  }
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return "An unexpected error occurred";
+  }
+}
+function extractErrorLogFields(error) {
+  if (error instanceof Error) {
+    return {
+      error: error.message.length > 0 ? error.message : formatObjectErrorForLog(error),
+      stack: error.stack
+    };
+  }
+  if (typeof error !== "object" || error === null) {
+    return { error: String(error) };
+  }
+  const message = Reflect.get(error, "message");
+  if (typeof message === "string" && message.length > 0) {
+    return { error: message };
+  }
+  return { error: formatObjectErrorForLog(error) };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  describeUnknownError,
+  extractErrorLogFields
+});
+//# sourceMappingURL=errorLogFields.js.map