@tangle-network/agent-runtime 0.71.1 → 0.72.0

package/dist/chunk-XRYEZPR6.js

@@ -1,88 +0,0 @@
-// src/mcp/delegation-profile.ts
-var DELEGATION_MCP_SERVER_KEY = "agent-runtime-delegation";
-var OTEL_FORWARD_KEYS = [
-  "OTEL_EXPORTER_OTLP_ENDPOINT",
-  "OTEL_EXPORTER_OTLP_HEADERS",
-  "TRACE_ID",
-  "PARENT_SPAN_ID"
-];
-var DEFAULT_SANDBOX_BASE_URL = "https://sandbox.tangle.tools";
-function buildDelegationMcpServer(options = {}) {
-  const env = options.env ?? process.env;
-  const sandboxApiKey = options.sandboxApiKey ?? env.TANGLE_API_KEY;
-  if (!sandboxApiKey) return void 0;
-  const baseUrl = options.sandboxBaseUrl ?? env.SANDBOX_BASE_URL ?? env.SANDBOX_API_URL ?? DEFAULT_SANDBOX_BASE_URL;
-  const otelEnv = {};
-  for (const key of OTEL_FORWARD_KEYS) {
-    const value = env[key];
-    if (value) otelEnv[key] = value;
-  }
-  return {
-    [DELEGATION_MCP_SERVER_KEY]: {
-      transport: "stdio",
-      command: "npx",
-      args: ["-y", "@tangle-network/agent-runtime", "mcp"],
-      env: {
-        TANGLE_API_KEY: sandboxApiKey,
-        SANDBOX_BASE_URL: baseUrl,
-        ...otelEnv
-      },
-      enabled: true,
-      metadata: {
-        surface: "delegation:dispatch",
-        tools: [
-          "delegate_code",
-          "delegate_research",
-          "delegate_feedback",
-          "delegation_status",
-          "delegation_history"
-        ]
-      }
-    }
-  };
-}
-function composeProductionAgentProfile(baseProfile, options = {}) {
-  const delegationMcp = buildDelegationMcpServer({
-    sandboxApiKey: options.sandboxApiKey,
-    sandboxBaseUrl: options.sandboxBaseUrl,
-    env: options.env
-  });
-  const baseMcp = baseProfile.mcp ?? {};
-  const withInjected = options.mcpConnections ? { ...baseMcp, ...options.mcpConnections } : { ...baseMcp };
-  const mergedMcp = delegationMcp ? { ...withInjected, ...delegationMcp } : withInjected;
-  const baseFiles = baseProfile.resources?.files ?? [];
-  const mergedFiles = options.extraFiles?.length ? [...baseFiles, ...options.extraFiles] : [...baseFiles];
-  const prompt = options.systemPrompt ? { ...baseProfile.prompt, systemPrompt: options.systemPrompt } : baseProfile.prompt;
-  const mergedTools = options.tools ? { ...baseProfile.tools ?? {}, ...options.tools } : baseProfile.tools;
-  const mergedHooks = mergeHooks(baseProfile.hooks, options.hooks);
-  const mergedSubagents = options.subagents ? { ...baseProfile.subagents ?? {}, ...options.subagents } : baseProfile.subagents;
-  return {
-    ...baseProfile,
-    name: options.name ?? baseProfile.name,
-    prompt,
-    ...mergedTools ? { tools: mergedTools } : {},
-    ...mergedHooks ? { hooks: mergedHooks } : {},
-    ...mergedSubagents ? { subagents: mergedSubagents } : {},
-    mcp: mergedMcp,
-    resources: {
-      ...baseProfile.resources,
-      files: mergedFiles
-    }
-  };
-}
-function mergeHooks(base, overlay) {
-  if (!overlay) return base;
-  const merged = { ...base ?? {} };
-  for (const [event, commands] of Object.entries(overlay)) {
-    merged[event] = [...merged[event] ?? [], ...commands];
-  }
-  return merged;
-}
-
-export {
-  DELEGATION_MCP_SERVER_KEY,
-  DEFAULT_SANDBOX_BASE_URL,
-  buildDelegationMcpServer,
-  composeProductionAgentProfile
-};
-//# sourceMappingURL=chunk-XRYEZPR6.js.map

package/dist/chunk-XRYEZPR6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/mcp/delegation-profile.ts"],"sourcesContent":["/**\n * Production-profile composition for the agent-runtime delegation MCP.\n *\n * A product agent's sandbox loads the delegation tools (`delegate_code`,\n * `delegate_research`, `delegate_feedback`, `delegation_status`,\n * `delegation_history`) by mounting the `agent-runtime-mcp` stdio server as\n * an MCP entry in its `AgentProfile`. This module is the single composer for\n * that wiring, so every consumer — the fleet agents and agent-builder's\n * generated agents — shares one implementation instead of copying it.\n *\n * The load-bearing invariant: the delegation MCP entry is only ever emitted\n * when a sandbox API key is present. Without the key the kernel's\n * coder/researcher delegate cannot construct an authenticated sandbox client,\n * so we omit the entry rather than ship an MCP child that fails to\n * authenticate on startup. No static profile entry, ever.\n */\n\nimport type {\n  AgentProfile,\n  AgentProfileFileMount,\n  AgentProfileMcpServer,\n  AgentSubagentProfile,\n} from '@tangle-network/sandbox'\n\n/** One hook command entry. The SDK declares `AgentProfile.hooks` as\n *  `Record<string, AgentProfileHookCommand[]>` but does not re-export the element\n *  type from the package entry, so derive it from `AgentProfile` by indexed\n *  access — the single source of truth, no drift from the SDK shape. */\ntype AgentProfileHookCommand = NonNullable<AgentProfile['hooks']>[string][number]\n\n/** MCP server key under which the agent-runtime delegation tools mount. */\nexport const DELEGATION_MCP_SERVER_KEY = 'agent-runtime-delegation'\n\n/**\n * Env vars forwarded into the delegation MCP child so its delegated\n * build/research loops export topology spans to the configured OTLP /\n * Tangle Intelligence sink. Each is forwarded only when present, so the\n * child is a no-op exporter until `OTEL_EXPORTER_OTLP_ENDPOINT` is set in the\n * parent env — never a hardcoded endpoint.\n */\nconst OTEL_FORWARD_KEYS = [\n  'OTEL_EXPORTER_OTLP_ENDPOINT',\n  'OTEL_EXPORTER_OTLP_HEADERS',\n  'TRACE_ID',\n  'PARENT_SPAN_ID',\n] as const\n\nexport const DEFAULT_SANDBOX_BASE_URL = 'https://sandbox.tangle.tools'\n\nexport interface BuildDelegationMcpServerOptions {\n  /** Sandbox API key forwarded as `TANGLE_API_KEY` to the MCP child. The\n   *  agent-runtime MCP bin reads `TANGLE_API_KEY` and passes it straight to\n   *  `new Sandbox({ apiKey })`. Defaults to `env.TANGLE_API_KEY`. */\n  sandboxApiKey?: string\n  /** Sandbox base URL forwarded as `SANDBOX_BASE_URL`. Defaults to\n   *  `env.SANDBOX_BASE_URL`, then `env.SANDBOX_API_URL`, then the public\n   *  sandbox endpoint. */\n  sandboxBaseUrl?: string\n  /** Environment source for key + OTEL resolution. Defaults to `process.env`;\n   *  injectable for tests and non-process callers. */\n  env?: Record<string, string | undefined>\n}\n\n/**\n * Build the delegation MCP entry the sandbox-side agent loads on startup.\n * Returns `undefined` when no sandbox API key is resolvable — callers merge\n * the result into a profile's `mcp` map only when defined.\n */\nexport function buildDelegationMcpServer(\n  options: BuildDelegationMcpServerOptions = {},\n): Record<string, AgentProfileMcpServer> | undefined {\n  const env = options.env ?? process.env\n  const sandboxApiKey = options.sandboxApiKey ?? env.TANGLE_API_KEY\n  if (!sandboxApiKey) return undefined\n  const baseUrl =\n    options.sandboxBaseUrl ??\n    env.SANDBOX_BASE_URL ??\n    env.SANDBOX_API_URL ??\n    DEFAULT_SANDBOX_BASE_URL\n\n  const otelEnv: Record<string, string> = {}\n  for (const key of OTEL_FORWARD_KEYS) {\n    const value = env[key]\n    if (value) otelEnv[key] = value\n  }\n\n  return {\n    [DELEGATION_MCP_SERVER_KEY]: {\n      transport: 'stdio',\n      command: 'npx',\n      args: ['-y', '@tangle-network/agent-runtime', 'mcp'],\n      env: {\n        TANGLE_API_KEY: sandboxApiKey,\n        SANDBOX_BASE_URL: baseUrl,\n        ...otelEnv,\n      },\n      enabled: true,\n      metadata: {\n        surface: 'delegation:dispatch',\n        tools: [\n          'delegate_code',\n          'delegate_research',\n          'delegate_feedback',\n          'delegation_status',\n          'delegation_history',\n        ],\n      },\n    },\n  }\n}\n\nexport interface ComposeProductionAgentProfileOptions {\n  /** Sandbox API key forwarded to the delegation MCP child. Defaults to\n   *  `env.TANGLE_API_KEY`. When unset, the delegation MCP entry is omitted. */\n  sandboxApiKey?: string\n  /** Sandbox base URL forwarded as `SANDBOX_BASE_URL` to the MCP child. */\n  sandboxBaseUrl?: string\n  /** Replace the base profile's system prompt. Used by per-turn calls that\n   *  swap in workspace-augmented prompts (board summary, learned style). */\n  systemPrompt?: string\n  /** Extra file mounts layered after the base profile's `resources.files`. */\n  extraFiles?: AgentProfileFileMount[]\n  /** Override the profile `name`. Defaults to the base profile's name. */\n  name?: string\n  /** Environment source for key + OTEL resolution. Defaults to `process.env`. */\n  env?: Record<string, string | undefined>\n  /** Box built-in tool ON/OFF flags merged over the base profile's `tools`\n   *  (overlay wins per key). The sandbox-seam mapping of a certified surface's\n   *  tool grants — `AgentProfile.tools` is `Record<string, boolean>` box flags,\n   *  so it carries grants, not arbitrary tool defs. */\n  tools?: Record<string, boolean>\n  /** Per-event hook commands merged over the base profile's `hooks`. An event\n   *  present in both has the extra commands appended after the base ones. */\n  hooks?: Record<string, AgentProfileHookCommand[]>\n  /** Subagent definitions merged over the base profile's `subagents` (overlay\n   *  wins per key). */\n  subagents?: Record<string, AgentSubagentProfile>\n  /** Resolved certified MCP connections injected into `AgentProfile.mcp` — the\n   *  sandbox-seam delivery of a `ResolvedSurface.mcpConnections`. Merged after\n   *  the base map and before the delegation entry, so a base/delegation key is\n   *  never silently shadowed by an injected one. */\n  mcpConnections?: Record<string, AgentProfileMcpServer>\n}\n\n/**\n * Compose the production `AgentProfile`: the canonical base profile with the\n * delegation MCP merged into `mcp`. Used by every call site that boots a\n * sandbox or runs a chat turn through the sandbox path, and by eval wiring so\n * the scorecard profile hash reflects the actual production profile.\n *\n * Merge rules:\n *   - `mcp`: base map preserved; `options.mcpConnections` (resolved certified\n *     servers) merged over it; the delegation entry is appended last under\n *     {@link DELEGATION_MCP_SERVER_KEY}, and omitted entirely when no sandbox\n *     API key resolves.\n *   - `tools`: base box-flags map preserved; `options.tools` overlaid per key.\n *   - `hooks`: per event, base commands preserved; `options.hooks[event]`\n *     appended after the base ones.\n *   - `subagents`: base map preserved; `options.subagents` overlaid per key.\n *   - `prompt.systemPrompt`: replaced when `options.systemPrompt` is set.\n *   - `resources.files`: `options.extraFiles` concatenated after base files.\n *   - `name`: replaced when `options.name` is set.\n */\nexport function composeProductionAgentProfile(\n  baseProfile: AgentProfile,\n  options: ComposeProductionAgentProfileOptions = {},\n): AgentProfile {\n  const delegationMcp = buildDelegationMcpServer({\n    sandboxApiKey: options.sandboxApiKey,\n    sandboxBaseUrl: options.sandboxBaseUrl,\n    env: options.env,\n  })\n\n  const baseMcp = baseProfile.mcp ?? {}\n  const withInjected: Record<string, AgentProfileMcpServer> = options.mcpConnections\n    ? { ...baseMcp, ...options.mcpConnections }\n    : { ...baseMcp }\n  const mergedMcp: Record<string, AgentProfileMcpServer> = delegationMcp\n    ? { ...withInjected, ...delegationMcp }\n    : withInjected\n\n  const baseFiles = baseProfile.resources?.files ?? []\n  const mergedFiles: AgentProfileFileMount[] = options.extraFiles?.length\n    ? [...baseFiles, ...options.extraFiles]\n    : [...baseFiles]\n\n  const prompt = options.systemPrompt\n    ? { ...baseProfile.prompt, systemPrompt: options.systemPrompt }\n    : baseProfile.prompt\n\n  const mergedTools = options.tools\n    ? { ...(baseProfile.tools ?? {}), ...options.tools }\n    : baseProfile.tools\n\n  const mergedHooks = mergeHooks(baseProfile.hooks, options.hooks)\n\n  const mergedSubagents = options.subagents\n    ? { ...(baseProfile.subagents ?? {}), ...options.subagents }\n    : baseProfile.subagents\n\n  return {\n    ...baseProfile,\n    name: options.name ?? baseProfile.name,\n    prompt,\n    ...(mergedTools ? { tools: mergedTools } : {}),\n    ...(mergedHooks ? { hooks: mergedHooks } : {}),\n    ...(mergedSubagents ? { subagents: mergedSubagents } : {}),\n    mcp: mergedMcp,\n    resources: {\n      ...baseProfile.resources,\n      files: mergedFiles,\n    },\n  }\n}\n\n/** Merge per-event hook command lists: base commands first, overlay commands\n *  appended after. Returns the base map unchanged when no overlay is given. */\nfunction mergeHooks(\n  base: Record<string, AgentProfileHookCommand[]> | undefined,\n  overlay: Record<string, AgentProfileHookCommand[]> | undefined,\n): Record<string, AgentProfileHookCommand[]> | undefined {\n  if (!overlay) return base\n  const merged: Record<string, AgentProfileHookCommand[]> = { ...(base ?? {}) }\n  for (const [event, commands] of Object.entries(overlay)) {\n    merged[event] = [...(merged[event] ?? []), ...commands]\n  }\n  return merged\n}\n"],"mappings":";AA+BO,IAAM,4BAA4B;AASzC,IAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,2BAA2B;AAqBjC,SAAS,yBACd,UAA2C,CAAC,GACO;AACnD,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,QAAM,gBAAgB,QAAQ,iBAAiB,IAAI;AACnD,MAAI,CAAC,cAAe,QAAO;AAC3B,QAAM,UACJ,QAAQ,kBACR,IAAI,oBACJ,IAAI,mBACJ;AAEF,QAAM,UAAkC,CAAC;AACzC,aAAW,OAAO,mBAAmB;AACnC,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,MAAO,SAAQ,GAAG,IAAI;AAAA,EAC5B;AAEA,SAAO;AAAA,IACL,CAAC,yBAAyB,GAAG;AAAA,MAC3B,WAAW;AAAA,MACX,SAAS;AAAA,MACT,MAAM,CAAC,MAAM,iCAAiC,KAAK;AAAA,MACnD,KAAK;AAAA,QACH,gBAAgB;AAAA,QAChB,kBAAkB;AAAA,QAClB,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,MACT,UAAU;AAAA,QACR,SAAS;AAAA,QACT,OAAO;AAAA,UACL;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAsDO,SAAS,8BACd,aACA,UAAgD,CAAC,GACnC;AACd,QAAM,gBAAgB,yBAAyB;AAAA,IAC7C,eAAe,QAAQ;AAAA,IACvB,gBAAgB,QAAQ;AAAA,IACxB,KAAK,QAAQ;AAAA,EACf,CAAC;AAED,QAAM,UAAU,YAAY,OAAO,CAAC;AACpC,QAAM,eAAsD,QAAQ,iBAChE,EAAE,GAAG,SAAS,GAAG,QAAQ,eAAe,IACxC,EAAE,GAAG,QAAQ;AACjB,QAAM,YAAmD,gBACrD,EAAE,GAAG,cAAc,GAAG,cAAc,IACpC;AAEJ,QAAM,YAAY,YAAY,WAAW,SAAS,CAAC;AACnD,QAAM,cAAuC,QAAQ,YAAY,SAC7D,CAAC,GAAG,WAAW,GAAG,QAAQ,UAAU,IACpC,CAAC,GAAG,SAAS;AAEjB,QAAM,SAAS,QAAQ,eACnB,EAAE,GAAG,YAAY,QAAQ,cAAc,QAAQ,aAAa,IAC5D,YAAY;AAEhB,QAAM,cAAc,QAAQ,QACxB,EAAE,GAAI,YAAY,SAAS,CAAC,GAAI,GAAG,QAAQ,MAAM,IACjD,YAAY;AAEhB,QAAM,cAAc,WAAW,YAAY,OAAO,QAAQ,KAAK;AAE/D,QAAM,kBAAkB,QAAQ,YAC5B,EAAE,GAAI,YAAY,aAAa,CAAC,GAAI,GAAG,QAAQ,UAAU,IACzD,YAAY;AAEhB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,QAAQ,QAAQ,YAAY;AAAA,IAClC;AAAA,IACA,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;AAAA,IAC5C,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;AAAA,IAC5C,GAAI,kBAAkB,EAAE,WAAW,gBAAgB,IAAI,CAAC;AAAA,IACxD,KAAK;AAAA,IACL,WAAW;AAAA,MACT,GAAG,YAAY;AAAA,MACf,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAIA,SAAS,WACP,MACA,SACuD;AACvD,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAoD,EAAE,GAAI,QAAQ,CAAC,EAAG;AAC5E,aAAW,CAAC,OAAO,QAAQ,KAAK,OAAO,QAAQ,OAAO,GAAG;AACvD,WAAO,KAAK,IAAI,CAAC,GAAI,OAAO,KAAK,KAAK,CAAC,GAAI,GAAG,QAAQ;AAAA,EACxD;AACA,SAAO;AACT;","names":[]}