@tangle-network/agent-app 0.60.198 → 0.60.199

package/dist/chunk-BKPJFES3.js

@@ -0,0 +1,229 @@
+// src/turn-trace/recorder.ts
+var TURN_SPAN_KINDS = ["admission", "router", "model", "network", "tool", "sandbox", "persist", "other"];
+var TRACE_ID_PATTERN = /^[\w-]{8,200}$/;
+var MAX_ATTRS = 48;
+var MAX_ATTR_STRING = 200;
+function isTraceId(value) {
+  return TRACE_ID_PATTERN.test(value);
+}
+function turnTraceId(executionId) {
+  if (TRACE_ID_PATTERN.test(executionId)) return executionId;
+  const id = executionId.replace(/[^\w-]/g, "_").slice(0, 200);
+  return id.length >= 8 ? id : id.padEnd(8, "_");
+}
+function randomHex(bytes) {
+  const out = new Uint8Array(bytes);
+  if (typeof globalThis.crypto?.getRandomValues === "function") globalThis.crypto.getRandomValues(out);
+  else for (let i = 0; i < bytes; i++) out[i] = Math.floor(Math.random() * 256);
+  return Array.from(out, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function boundedAttrs(attrs) {
+  const out = {};
+  let count = 0;
+  for (const [key, value] of Object.entries(attrs)) {
+    if (count >= MAX_ATTRS) break;
+    if (typeof value === "number" && !Number.isFinite(value)) continue;
+    out[key.slice(0, 80)] = typeof value === "string" ? value.slice(0, MAX_ATTR_STRING) : value;
+    count++;
+  }
+  return out;
+}
+function errorText(error) {
+  if (error instanceof Error) return (error.name === "Error" ? error.message : `${error.name}: ${error.message}`).slice(0, MAX_ATTR_STRING);
+  return String(error).slice(0, MAX_ATTR_STRING);
+}
+var zeroKinds = () => ({
+  admission: 0,
+  router: 0,
+  model: 0,
+  network: 0,
+  tool: 0,
+  sandbox: 0,
+  persist: 0,
+  other: 0
+});
+var round1 = (value) => Math.round(value * 10) / 10;
+function summarizeTurnSpans(spans, rootSpanId, startMs, endMs, traceId, dropped = 0) {
+  const wallMs = Math.max(0, endMs - startMs);
+  const parent = new Map(spans.map((span) => [span.spanId, span.parentSpanId]));
+  const depthOf = (id) => {
+    let depth = 0;
+    for (let at = parent.get(id); at !== void 0 && at !== rootSpanId; at = parent.get(at)) {
+      depth++;
+      if (depth > 64) break;
+    }
+    return depth;
+  };
+  const clipped = spans.map((span) => ({ span, start: Math.max(startMs, span.startMs), end: Math.min(endMs, span.endMs), depth: depthOf(span.spanId) })).filter((entry) => entry.end > entry.start);
+  const points = [.../* @__PURE__ */ new Set([startMs, endMs, ...clipped.flatMap((entry) => [entry.start, entry.end])])].sort((a, b) => a - b);
+  const byKind = zeroKinds();
+  let coveredMs = 0;
+  let largestGapMs = 0;
+  let gap = 0;
+  for (let i = 0; i + 1 < points.length; i++) {
+    const from = points[i];
+    const to = points[i + 1];
+    let deepest;
+    for (const entry of clipped) {
+      if (entry.start <= from && entry.end >= to && (!deepest || entry.depth > deepest.depth || entry.depth === deepest.depth && entry.start > deepest.start)) deepest = entry;
+    }
+    if (deepest) {
+      byKind[deepest.span.kind] += to - from;
+      coveredMs += to - from;
+      gap = 0;
+    } else {
+      gap += to - from;
+      largestGapMs = Math.max(largestGapMs, gap);
+    }
+  }
+  for (const kind of TURN_SPAN_KINDS) byKind[kind] = round1(byKind[kind]);
+  return {
+    traceId,
+    wallMs: round1(wallMs),
+    coveredMs: round1(coveredMs),
+    coveragePct: wallMs > 0 ? round1(coveredMs / wallMs * 100) : 0,
+    uncoveredMs: round1(wallMs - coveredMs),
+    largestGapMs: round1(largestGapMs),
+    byKind,
+    spans: spans.length,
+    modelCalls: spans.filter((span) => span.name === "model.call").length,
+    toolCalls: spans.filter((span) => span.name === "tool.call").length,
+    dropped
+  };
+}
+function createTurnTrace(options = {}) {
+  const now = options.now ?? Date.now;
+  const startedAt = options.startedAt ?? now();
+  const maxSpans = options.maxSpans ?? 1e3;
+  const rootId = randomHex(8);
+  let executionId = options.executionId ?? `pending_${randomHex(6)}`;
+  let traceId = turnTraceId(executionId);
+  const records = /* @__PURE__ */ new Map();
+  const open = /* @__PURE__ */ new Set();
+  let dropped = 0;
+  let finished;
+  const inert = (id) => {
+    const handle = {
+      id,
+      set: () => handle,
+      end: () => {
+      },
+      child: () => inert(rootId),
+      record: () => inert(rootId)
+    };
+    return handle;
+  };
+  const handleFor = (id) => {
+    const handle = {
+      id,
+      set(attrs) {
+        const record = records.get(id);
+        if (record && !finished) record.attrs = boundedAttrs({ ...record.attrs, ...attrs });
+        return handle;
+      },
+      end(attrs, error) {
+        const record = records.get(id);
+        if (!record || !open.has(id) || finished) return;
+        open.delete(id);
+        record.endMs = Math.max(record.startMs, now());
+        if (attrs) record.attrs = boundedAttrs({ ...record.attrs, ...attrs });
+        if (error !== void 0) record.error = errorText(error);
+      },
+      child: (name, kind, attrs) => trace.start(name, kind, attrs, handle),
+      record: (name, kind, start, end, attrs) => trace.record(name, kind, start, end, attrs, handle)
+    };
+    return handle;
+  };
+  const add = (name, kind, startMs, endMs, attrs, parent) => {
+    if (finished) return inert(rootId);
+    if (records.size >= maxSpans) {
+      dropped++;
+      return inert(rootId);
+    }
+    const spanId = randomHex(8);
+    records.set(spanId, {
+      spanId,
+      parentSpanId: parent && parent.id !== spanId ? parent.id : rootId,
+      name: name.slice(0, 80),
+      kind,
+      startMs,
+      endMs: endMs ?? startMs,
+      attrs: attrs ? boundedAttrs(attrs) : {}
+    });
+    if (endMs === void 0) open.add(spanId);
+    return handleFor(spanId);
+  };
+  const rootHandle = {
+    id: rootId,
+    set: () => rootHandle,
+    end: () => {
+    },
+    child: (name, kind, attrs) => trace.start(name, kind, attrs),
+    record: (name, kind, start, end, attrs) => trace.record(name, kind, start, end, attrs)
+  };
+  const trace = {
+    get traceId() {
+      return traceId;
+    },
+    get executionId() {
+      return executionId;
+    },
+    startedAt,
+    root: rootHandle,
+    bind(id) {
+      executionId = id;
+      traceId = turnTraceId(id);
+    },
+    start: (name, kind, attrs, parent) => add(name, kind, now(), void 0, attrs, parent),
+    record: (name, kind, startMs, endMs, attrs, parent) => add(name, kind, startMs, Math.max(startMs, endMs), attrs, parent),
+    async measure(name, kind, work, attrs, parent) {
+      const span = trace.start(name, kind, attrs, parent);
+      try {
+        const result = await work(span);
+        span.end();
+        return result;
+      } catch (error) {
+        span.end(void 0, error);
+        throw error;
+      }
+    },
+    summary(at) {
+      const end = at ?? finished?.endedAt ?? now();
+      const spans = [...records.values()].map((record) => open.has(record.spanId) ? { ...record, endMs: end } : record);
+      return summarizeTurnSpans(spans, rootId, startedAt, end, traceId, dropped);
+    },
+    finish(outcome) {
+      if (finished) return finished;
+      const endedAt = Math.max(startedAt, outcome?.endedAt ?? now());
+      for (const id of open) {
+        const record = records.get(id);
+        record.endMs = Math.max(record.startMs, endedAt);
+        record.unfinished = true;
+      }
+      open.clear();
+      const spans = [...records.values()].sort((a, b) => a.startMs - b.startMs);
+      finished = {
+        traceId,
+        rootSpanId: rootId,
+        executionId,
+        startedAt,
+        endedAt,
+        spans,
+        summary: summarizeTurnSpans(spans, rootId, startedAt, endedAt, traceId, dropped),
+        status: outcome?.error === void 0 ? "ok" : "error",
+        ...outcome?.error === void 0 ? {} : { error: errorText(outcome.error) }
+      };
+      return finished;
+    }
+  };
+  return trace;
+}
+
+export {
+  TURN_SPAN_KINDS,
+  isTraceId,
+  turnTraceId,
+  summarizeTurnSpans,
+  createTurnTrace
+};
+//# sourceMappingURL=chunk-BKPJFES3.js.map

package/dist/chunk-BKPJFES3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/turn-trace/recorder.ts"],"sourcesContent":["/**\n * One trace per agent turn: a root span for the turn's wall time and named\n * child spans for where that time went (admission, each model call, each tool\n * call, the box claim and prompt, persistence).\n *\n * This module only records. It has no imports, so the Router engine, the\n * sandbox helpers and the chat route share it from any runtime, a Worker\n * included. `./otel` turns a finished trace into OTLP spans for Tangle\n * Intelligence.\n *\n * The turn's trace id is its execution id in the charset every hop accepts\n * ({@link turnTraceId}), sent as `x-tangle-trace-id` on every Router and\n * Sandbox call, so a Router dispatch row and a sandbox record join the turn's\n * spans by one id.\n */\n\n/** What a span's time is spent on. Each instant of the turn is credited to the deepest open span's kind. */\nexport type TurnSpanKind =\n  | 'admission'\n  | 'router'\n  | 'model'\n  | 'network'\n  | 'tool'\n  | 'sandbox'\n  | 'persist'\n  | 'other'\n\nexport const TURN_SPAN_KINDS: readonly TurnSpanKind[] = ['admission', 'router', 'model', 'network', 'tool', 'sandbox', 'persist', 'other']\n\n/** Bounded primitive metadata. Never prompts, answers, tool arguments or credentials. */\nexport type TurnSpanAttrs = Record<string, string | number | boolean>\n\nexport interface TurnSpanRecord {\n  spanId: string\n  /** The root span's id for a top-level child. */\n  parentSpanId: string\n  name: string\n  kind: TurnSpanKind\n  startMs: number\n  endMs: number\n  attrs: TurnSpanAttrs\n  /** Set when the span ended in failure; a short code or message, never content. */\n  error?: string\n  /** True when the turn finished while the span was still open. */\n  unfinished?: boolean\n}\n\nexport interface TurnSpan {\n  readonly id: string\n  /** Merge attributes. A later value replaces an earlier one. */\n  set(attrs: TurnSpanAttrs): TurnSpan\n  /** End now. A second call changes nothing. `error` marks the span failed. */\n  end(attrs?: TurnSpanAttrs, error?: unknown): void\n  /** A child that starts now. */\n  child(name: string, kind: TurnSpanKind, attrs?: TurnSpanAttrs): TurnSpan\n  /** A child whose times are already known. */\n  record(name: string, kind: TurnSpanKind, startMs: number, endMs: number, attrs?: TurnSpanAttrs): TurnSpan\n}\n\n/** How much of the turn's wall time is inside named spans, and what the time was spent on. */\nexport interface TurnTraceSummary {\n  traceId: string\n  wallMs: number\n  /** Wall time inside at least one child span. */\n  coveredMs: number\n  /** `coveredMs / wallMs` as a percentage, one decimal. */\n  coveragePct: number\n  uncoveredMs: number\n  /** The longest stretch with no span open: where an unnamed wait hides. */\n  largestGapMs: number\n  /** Wall time credited to the deepest open span's kind. Sums to `coveredMs`. */\n  byKind: Record<TurnSpanKind, number>\n  spans: number\n  modelCalls: number\n  toolCalls: number\n  /** Spans refused after the per-turn cap. */\n  dropped: number\n}\n\nexport interface TurnTraceSnapshot {\n  traceId: string\n  /** The id the root span is exported under. */\n  rootSpanId: string\n  executionId: string\n  startedAt: number\n  endedAt: number\n  spans: TurnSpanRecord[]\n  summary: TurnTraceSummary\n  /** `ok`, or the failure the turn ended with. */\n  status: 'ok' | 'error'\n  error?: string\n}\n\n/** Where a finished turn's trace goes. `labels` are the host's metadata for the root span (session, user, workspace). */\nexport type TurnTraceSink = (snapshot: TurnTraceSnapshot, labels: TurnSpanAttrs) => void | Promise<void>\n\nexport interface TurnTrace {\n  /** The turn's execution id in the charset the Router and Sandbox accept. Send it as `x-tangle-trace-id`. */\n  readonly traceId: string\n  readonly executionId: string\n  readonly startedAt: number\n  /** The span a top-level child hangs from. */\n  readonly root: TurnSpan\n  /** Name the turn's execution id once it is known. Spans recorded earlier keep their times. */\n  bind(executionId: string): void\n  start(name: string, kind: TurnSpanKind, attrs?: TurnSpanAttrs, parent?: TurnSpan): TurnSpan\n  record(name: string, kind: TurnSpanKind, startMs: number, endMs: number, attrs?: TurnSpanAttrs, parent?: TurnSpan): TurnSpan\n  /** Run `work` inside a span; the span ends when it settles, failed if it throws. */\n  measure<T>(name: string, kind: TurnSpanKind, work: (span: TurnSpan) => Promise<T> | T, attrs?: TurnSpanAttrs, parent?: TurnSpan): Promise<T>\n  /** Read the current numbers without ending the trace. */\n  summary(now?: number): TurnTraceSummary\n  /** End the trace: open spans close at `endedAt`, and later spans are refused. A second call returns the first result. */\n  finish(outcome?: { error?: unknown; endedAt?: number }): TurnTraceSnapshot\n}\n\nexport interface CreateTurnTraceOptions {\n  /** Epoch ms the turn began (default now). A route passes its request time so admission is inside the trace. */\n  startedAt?: number\n  executionId?: string\n  now?: () => number\n  /** Most spans one turn keeps (default 1000); the rest are counted as dropped. */\n  maxSpans?: number\n}\n\nconst TRACE_ID_PATTERN = /^[\\w-]{8,200}$/\nconst MAX_ATTRS = 48\nconst MAX_ATTR_STRING = 200\n\n/** True when the Router and the Sandbox API keep this id as a `x-tangle-trace-id`. */\nexport function isTraceId(value: string): boolean {\n  return TRACE_ID_PATTERN.test(value)\n}\n\n/**\n * The turn's execution id as a trace id. Execution ids carry `:` (`app:session:turn`),\n * which the Router drops from `x-tangle-trace-id`, so every character outside\n * `[A-Za-z0-9_-]` becomes `_`. An id already in the charset is returned as it is.\n */\nexport function turnTraceId(executionId: string): string {\n  if (TRACE_ID_PATTERN.test(executionId)) return executionId\n  const id = executionId.replace(/[^\\w-]/g, '_').slice(0, 200)\n  return id.length >= 8 ? id : id.padEnd(8, '_')\n}\n\nfunction randomHex(bytes: number): string {\n  const out = new Uint8Array(bytes)\n  if (typeof globalThis.crypto?.getRandomValues === 'function') globalThis.crypto.getRandomValues(out)\n  else for (let i = 0; i < bytes; i++) out[i] = Math.floor(Math.random() * 256)\n  return Array.from(out, (b) => b.toString(16).padStart(2, '0')).join('')\n}\n\nfunction boundedAttrs(attrs: TurnSpanAttrs): TurnSpanAttrs {\n  const out: TurnSpanAttrs = {}\n  let count = 0\n  for (const [key, value] of Object.entries(attrs)) {\n    if (count >= MAX_ATTRS) break\n    if (typeof value === 'number' && !Number.isFinite(value)) continue\n    out[key.slice(0, 80)] = typeof value === 'string' ? value.slice(0, MAX_ATTR_STRING) : value\n    count++\n  }\n  return out\n}\n\nfunction errorText(error: unknown): string {\n  if (error instanceof Error) return (error.name === 'Error' ? error.message : `${error.name}: ${error.message}`).slice(0, MAX_ATTR_STRING)\n  return String(error).slice(0, MAX_ATTR_STRING)\n}\n\nconst zeroKinds = (): Record<TurnSpanKind, number> => ({\n  admission: 0, router: 0, model: 0, network: 0, tool: 0, sandbox: 0, persist: 0, other: 0,\n})\n\nconst round1 = (value: number) => Math.round(value * 10) / 10\n\n/**\n * Coverage and the per-kind split for a set of spans over `[startMs, endMs]`.\n * Exported for a reader that holds the spans of a finished trace.\n */\nexport function summarizeTurnSpans(\n  spans: readonly Pick<TurnSpanRecord, 'spanId' | 'parentSpanId' | 'kind' | 'name' | 'startMs' | 'endMs'>[],\n  rootSpanId: string,\n  startMs: number,\n  endMs: number,\n  traceId: string,\n  dropped = 0,\n): TurnTraceSummary {\n  const wallMs = Math.max(0, endMs - startMs)\n  const parent = new Map(spans.map((span) => [span.spanId, span.parentSpanId]))\n  const depthOf = (id: string): number => {\n    let depth = 0\n    for (let at = parent.get(id); at !== undefined && at !== rootSpanId; at = parent.get(at)) {\n      depth++\n      if (depth > 64) break\n    }\n    return depth\n  }\n  const clipped = spans\n    .map((span) => ({ span, start: Math.max(startMs, span.startMs), end: Math.min(endMs, span.endMs), depth: depthOf(span.spanId) }))\n    .filter((entry) => entry.end > entry.start)\n  const points = [...new Set([startMs, endMs, ...clipped.flatMap((entry) => [entry.start, entry.end])])].sort((a, b) => a - b)\n  const byKind = zeroKinds()\n  let coveredMs = 0\n  let largestGapMs = 0\n  let gap = 0\n  for (let i = 0; i + 1 < points.length; i++) {\n    const from = points[i]!\n    const to = points[i + 1]!\n    let deepest: (typeof clipped)[number] | undefined\n    for (const entry of clipped) {\n      if (entry.start <= from && entry.end >= to && (!deepest || entry.depth > deepest.depth || (entry.depth === deepest.depth && entry.start > deepest.start))) deepest = entry\n    }\n    if (deepest) {\n      byKind[deepest.span.kind] += to - from\n      coveredMs += to - from\n      gap = 0\n    } else {\n      gap += to - from\n      largestGapMs = Math.max(largestGapMs, gap)\n    }\n  }\n  for (const kind of TURN_SPAN_KINDS) byKind[kind] = round1(byKind[kind])\n  return {\n    traceId,\n    wallMs: round1(wallMs),\n    coveredMs: round1(coveredMs),\n    coveragePct: wallMs > 0 ? round1((coveredMs / wallMs) * 100) : 0,\n    uncoveredMs: round1(wallMs - coveredMs),\n    largestGapMs: round1(largestGapMs),\n    byKind,\n    spans: spans.length,\n    modelCalls: spans.filter((span) => span.name === 'model.call').length,\n    toolCalls: spans.filter((span) => span.name === 'tool.call').length,\n    dropped,\n  }\n}\n\nexport function createTurnTrace(options: CreateTurnTraceOptions = {}): TurnTrace {\n  const now = options.now ?? Date.now\n  const startedAt = options.startedAt ?? now()\n  const maxSpans = options.maxSpans ?? 1000\n  const rootId = randomHex(8)\n  let executionId = options.executionId ?? `pending_${randomHex(6)}`\n  let traceId = turnTraceId(executionId)\n  const records = new Map<string, TurnSpanRecord>()\n  const open = new Set<string>()\n  let dropped = 0\n  let finished: TurnTraceSnapshot | undefined\n\n  // A refused or late span still returns a handle, so instrumentation never branches on the trace's state.\n  const inert = (id: string): TurnSpan => {\n    const handle: TurnSpan = {\n      id,\n      set: () => handle,\n      end: () => {},\n      child: () => inert(rootId),\n      record: () => inert(rootId),\n    }\n    return handle\n  }\n\n  const handleFor = (id: string): TurnSpan => {\n    const handle: TurnSpan = {\n      id,\n      set(attrs) {\n        const record = records.get(id)\n        if (record && !finished) record.attrs = boundedAttrs({ ...record.attrs, ...attrs })\n        return handle\n      },\n      end(attrs, error) {\n        const record = records.get(id)\n        if (!record || !open.has(id) || finished) return\n        open.delete(id)\n        record.endMs = Math.max(record.startMs, now())\n        if (attrs) record.attrs = boundedAttrs({ ...record.attrs, ...attrs })\n        if (error !== undefined) record.error = errorText(error)\n      },\n      child: (name, kind, attrs) => trace.start(name, kind, attrs, handle),\n      record: (name, kind, start, end, attrs) => trace.record(name, kind, start, end, attrs, handle),\n    }\n    return handle\n  }\n\n  const add = (name: string, kind: TurnSpanKind, startMs: number, endMs: number | undefined, attrs: TurnSpanAttrs | undefined, parent: TurnSpan | undefined): TurnSpan => {\n    if (finished) return inert(rootId)\n    if (records.size >= maxSpans) {\n      dropped++\n      return inert(rootId)\n    }\n    const spanId = randomHex(8)\n    records.set(spanId, {\n      spanId,\n      parentSpanId: parent && parent.id !== spanId ? parent.id : rootId,\n      name: name.slice(0, 80),\n      kind,\n      startMs,\n      endMs: endMs ?? startMs,\n      attrs: attrs ? boundedAttrs(attrs) : {},\n    })\n    if (endMs === undefined) open.add(spanId)\n    return handleFor(spanId)\n  }\n\n  const rootHandle: TurnSpan = {\n    id: rootId,\n    set: () => rootHandle,\n    end: () => {},\n    child: (name, kind, attrs) => trace.start(name, kind, attrs),\n    record: (name, kind, start, end, attrs) => trace.record(name, kind, start, end, attrs),\n  }\n\n  const trace: TurnTrace = {\n    get traceId() { return traceId },\n    get executionId() { return executionId },\n    startedAt,\n    root: rootHandle,\n    bind(id) {\n      executionId = id\n      traceId = turnTraceId(id)\n    },\n    start: (name, kind, attrs, parent) => add(name, kind, now(), undefined, attrs, parent),\n    record: (name, kind, startMs, endMs, attrs, parent) => add(name, kind, startMs, Math.max(startMs, endMs), attrs, parent),\n    async measure(name, kind, work, attrs, parent) {\n      const span = trace.start(name, kind, attrs, parent)\n      try {\n        const result = await work(span)\n        span.end()\n        return result\n      } catch (error) {\n        span.end(undefined, error)\n        throw error\n      }\n    },\n    summary(at) {\n      const end = at ?? finished?.endedAt ?? now()\n      const spans = [...records.values()].map((record) => open.has(record.spanId) ? { ...record, endMs: end } : record)\n      return summarizeTurnSpans(spans, rootId, startedAt, end, traceId, dropped)\n    },\n    finish(outcome) {\n      if (finished) return finished\n      const endedAt = Math.max(startedAt, outcome?.endedAt ?? now())\n      for (const id of open) {\n        const record = records.get(id)!\n        record.endMs = Math.max(record.startMs, endedAt)\n        record.unfinished = true\n      }\n      open.clear()\n      const spans = [...records.values()].sort((a, b) => a.startMs - b.startMs)\n      finished = {\n        traceId,\n        rootSpanId: rootId,\n        executionId,\n        startedAt,\n        endedAt,\n        spans,\n        summary: summarizeTurnSpans(spans, rootId, startedAt, endedAt, traceId, dropped),\n        status: outcome?.error === undefined ? 'ok' : 'error',\n        ...(outcome?.error === undefined ? {} : { error: errorText(outcome.error) }),\n      }\n      return finished\n    },\n  }\n  return trace\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-SUIH5B55.js → chunk-RJJRRR5Z.js}

@@ -21,6 +21,9 @@ import {
 import {
   buildAppToolMcpServer
 } from "./chunk-6A7MYOUI.js";
+import {
+  nextCallIndex
+} from "./chunk-7XQIY2LU.js";
 import {
   resolveTangleExecutionEnvironment,
   trimOrNull
@@ -40,6 +43,113 @@ var fail = (error) => ({
   error: error instanceof Error ? error : new Error(String(error))
 });
 
+// src/sandbox/prompt-trace.ts
+var asRec = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+var asNum = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+var PHASES = ["agent_run_start", "harness_spawn", "harness_ready", "first_model_request", "first_upstream_byte", "first_text"];
+function createPromptTrace(trace, parent, meta) {
+  const startedAt = Date.now();
+  const prompt = trace.start("sandbox.prompt", "sandbox", meta, parent);
+  let firstEventAt;
+  let firstTextAt;
+  let generation;
+  let phases;
+  let events = 0;
+  const tools = /* @__PURE__ */ new Map();
+  const startTool = (id, name) => {
+    if (tools.has(id)) return;
+    tools.set(id, trace.start("tool.call", "tool", {
+      "gen_ai.tool.name": name,
+      "tool.call_id": id,
+      "call.index": nextCallIndex(trace, "tool.call"),
+      where: "sandbox",
+      approx: true
+    }, generation ?? prompt));
+  };
+  const observe = (raw) => {
+    try {
+      const event = asRec(raw);
+      if (!event) return;
+      const now = Date.now();
+      events++;
+      firstEventAt ??= now;
+      const type = typeof event.type === "string" ? event.type : "";
+      const data = asRec(event.data);
+      if (type === "result") {
+        const report = asRec(data?.firstTextPhases);
+        const offsets = asRec(report?.phasesMs);
+        if (offsets) {
+          phases = {
+            offsets,
+            warm: typeof report?.harnessWarm === "boolean" ? report.harnessWarm : null,
+            ...typeof report?.model === "string" ? { model: report.model } : {}
+          };
+        }
+        return;
+      }
+      if (type === "tool_call" || type === "tool.call") {
+        const id = String(data?.id ?? data?.callId ?? data?.callID ?? data?.name ?? "");
+        if (id) startTool(id, String(data?.name ?? data?.tool ?? "tool"));
+        return;
+      }
+      if (type === "tool_result" || type === "tool.result") {
+        const id = String(data?.id ?? data?.callId ?? data?.callID ?? data?.name ?? "");
+        tools.get(id)?.end(void 0, data?.error ?? (data?.status === "error" ? "tool_error" : void 0));
+        return;
+      }
+      if (type !== "message.part.updated") return;
+      const part = asRec(data?.part);
+      const partType = String(part?.type ?? "");
+      if (partType === "text" && firstTextAt === void 0 && (typeof data?.delta === "string" && data.delta || typeof part?.text === "string" && part.text)) {
+        firstTextAt = now;
+        generation = prompt.child("sandbox.generation", "model");
+      } else if (partType === "tool") {
+        const id = String(part?.id ?? part?.callID ?? "");
+        if (!id) return;
+        const state = asRec(part?.state);
+        const status = String(state?.status ?? part?.status ?? "");
+        startTool(id, String(part?.tool ?? "tool"));
+        if (status === "completed" || status === "error") tools.get(id)?.end(void 0, status === "error" ? "tool_error" : void 0);
+      }
+    } catch {
+    }
+  };
+  const end = (error) => {
+    try {
+      for (const span of tools.values()) span.end({ "tool.unclosed": true });
+      generation?.end();
+      if (phases && firstTextAt !== void 0) {
+        const firstText = asNum(phases.offsets.first_text);
+        if (firstText !== void 0 && firstTextAt - firstText >= startedAt) {
+          const origin = firstTextAt - firstText;
+          prompt.record("sandbox.transit", "sandbox", startedAt, origin, { note: "sdk, api, orchestrator and host hops, both ways" });
+          let previous = 0;
+          for (const phase of PHASES) {
+            const offset = asNum(phases.offsets[phase]);
+            if (offset === void 0 || offset < previous) continue;
+            prompt.record(`sidecar.${phase}`, phase === "first_upstream_byte" || phase === "first_text" ? "model" : "sandbox", origin + previous, origin + offset);
+            previous = offset;
+          }
+        }
+      }
+      prompt.set({
+        events,
+        ...firstEventAt !== void 0 ? { first_event_ms: firstEventAt - startedAt } : {},
+        ...firstTextAt !== void 0 ? { first_text_ms: firstTextAt - startedAt } : {},
+        ...phases?.warm !== null && phases?.warm !== void 0 ? { "sidecar.harness_warm": phases.warm } : {},
+        ...phases?.model ? { "sidecar.model": phases.model } : {},
+        ...Object.fromEntries(PHASES.flatMap((phase) => {
+          const offset = asNum(phases?.offsets[phase]);
+          return offset === void 0 ? [] : [[`sidecar.${phase}_ms`, Math.round(offset)]];
+        }))
+      });
+      prompt.end(void 0, error);
+    } catch {
+    }
+  };
+  return { observe, end };
+}
+
 // src/sandbox/model.ts
 function backendModelFields(model) {
   return {
@@ -427,7 +537,14 @@ var DEFAULT_TIMEOUT_MS = 5 * 6e4;
 var TASK_LIMIT = 2e4;
 var SANDBOX_RUN_DESCRIPTION = "Run work that needs a computer in this workspace's sandbox: executing code or scripts, reading or converting PDFs, spreadsheets and archives, filling forms with the installed toolkits, or editing many files. Describe the whole task and the result you need; the sandbox agent does it and returns its answer. Takes seconds to minutes, so use it only when the answer needs the computer.";
 function sandboxPromptRunner(shell, prompt = {}) {
-  return (box, task, { signal, timeoutMs }) => runSandboxPrompt(shell, box, task, { ...prompt, signal, timeoutMs, disallowQuestions: true });
+  return (box, task, { signal, timeoutMs, trace, span }) => runSandboxPrompt(shell, box, task, {
+    ...prompt,
+    signal,
+    timeoutMs,
+    disallowQuestions: true,
+    ...trace ? { trace } : {},
+    ...span ? { traceParent: span } : {}
+  });
 }
 function createSandboxRunTool(options) {
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
@@ -466,16 +583,25 @@ function createSandboxRunTool(options) {
         signal.addEventListener("abort", () => reject(signal.reason), { once: true });
       })]);
       let box;
+      const claim = context?.span?.child("sandbox.claim", "sandbox");
       try {
         box = await capped(options.box(signal));
+        claim?.end();
       } catch (error) {
+        claim?.end(void 0, error instanceof SandboxRunError ? error.code : "sandbox_unavailable");
         if (error instanceof SandboxRunError) return fail2(error.code, error.message, error.cause);
         return fail2("sandbox_unavailable", "The sandbox for this workspace could not start, so this work was not done.", error);
       }
       emit("box_ready", { ms: Date.now() - started });
       let answer;
       try {
-        answer = await capped(runTask(box, task, { signal, timeoutMs: Math.max(1, timeoutMs - (Date.now() - started)), emit }));
+        answer = await capped(runTask(box, task, {
+          signal,
+          timeoutMs: Math.max(1, timeoutMs - (Date.now() - started)),
+          emit,
+          ...context?.trace ? { trace: context.trace } : {},
+          ...context?.span ? { span: context.span } : {}
+        }));
       } catch (error) {
         const timedOut = signal.aborted && !options.signal?.aborted;
         return fail2("sandbox_failed", timedOut ? `The sandbox did not finish within ${Math.round(timeoutMs / 1e3)} s, so this work was not done.` : "The sandbox run failed, so this work was not done.", error);
@@ -559,10 +685,13 @@ function createSandboxExecTool(options) {
       if (options.warm) await options.warm.leases.turn(options.warm.key).catch(() => {
       });
       let box;
+      const reused = ready !== null;
+      const claim = context?.span?.child("sandbox.claim", "sandbox");
       const starting = place(signal);
       try {
         box = await raceAbort(starting, signal);
       } catch (error) {
+        claim?.end(void 0, error instanceof SandboxRunError ? error.code : "sandbox_unavailable");
         if (ready === starting) ready = null;
         if (error instanceof SandboxRunError) {
           options.onFailure?.(error);
@@ -570,15 +699,22 @@ function createSandboxExecTool(options) {
         }
         return fail2("sandbox_unavailable", "The sandbox did not start in time, so the command did not run.", error);
       }
+      claim?.end({ "claim.reused": reused });
       emit("box_ready", { ms: Date.now() - started });
       let result;
+      const execSpan = context?.span?.child("sandbox.exec", "sandbox");
       try {
         result = await raceAbort(box.exec(command, {
           ...cwd ? { cwd } : {},
           ...options.env ? { env: options.env } : {},
-          timeoutMs: Math.max(1, timeoutMs - (Date.now() - started))
+          timeoutMs: Math.max(1, timeoutMs - (Date.now() - started)),
+          // The same id the Router turn sends, so this command's Sandbox API and host records join the turn.
+          // SDK 0.62.2 added `traceId` to ExecOptions; an older SDK ignores the field.
+          ...context?.trace ? { traceId: context.trace.traceId } : {}
         }), signal);
+        execSpan?.end({ "exec.exit_code": result.exitCode });
       } catch (error) {
+        execSpan?.end(void 0, "exec_failed");
         const timedOut = signal.aborted && !options.signal?.aborted;
         return fail2("sandbox_failed", timedOut ? `The command did not finish within ${Math.round(timeoutMs / 1e3)} s.` : "The command could not run in the sandbox.", error);
       }
@@ -2384,9 +2520,24 @@ async function ensureWorkspaceSandbox(shell, options) {
     workspaceId: options.workspaceId,
     ...options.userId ? { userId: options.userId } : {}
   });
-  const box = await bringUpWorkspaceSandbox(shell, options);
-  await observeProvisionedBox(shell, options, box);
-  return box;
+  const { trace } = options;
+  const claim = trace?.start("sandbox.claim", "sandbox", { "workspace.harness": options.harness }, options.traceParent);
+  const traced = trace && claim ? {
+    ...options,
+    measure: (stage, operation) => {
+      const run = () => trace.measure(stage, "sandbox", () => operation(), void 0, claim);
+      return options.measure ? options.measure(stage, run) : run();
+    }
+  } : options;
+  try {
+    const box = await bringUpWorkspaceSandbox(shell, traced);
+    claim?.end({ "sandbox.id": box.id });
+    await observeProvisionedBox(shell, options, box);
+    return box;
+  } catch (error) {
+    claim?.end(void 0, error);
+    throw error;
+  }
 }
 async function observeProvisionedBox(shell, options, box) {
   if (!options.spend?.onProvisioned) return;
@@ -2521,11 +2672,12 @@ async function provisionWorkspaceSandbox(shell, options) {
     }
   }
   if (!replacementRequested && !forceNew && shell.resumeStopped !== false) {
-    const stopped = await listStopped(client, name);
+    const stopped = await measure("list_stopped", () => listStopped(client, name));
     if (!stopped.succeeded) throw stopped.error;
     if (stopped.value) {
-      const runtimeEnv2 = await resolveWorkspaceRuntimeEnv(shell, scope);
-      const resumed = await resumeStoppedBox(stopped.value, resumeTimeout, runtimeEnv2, onProgress);
+      const stoppedBox = stopped.value;
+      const runtimeEnv2 = await measure("runtime_env", () => resolveWorkspaceRuntimeEnv(shell, scope));
+      const resumed = await measure("resume", () => resumeStoppedBox(stoppedBox, resumeTimeout, runtimeEnv2, onProgress));
       if (!resumed.succeeded) {
         const recovery = await requestSandboxReplacement(
           shell.recoverStoppedSandbox,
@@ -2635,12 +2787,12 @@ async function provisionWorkspaceSandbox(shell, options) {
     SHELL_PROMPT_BUDGET_HINT
   );
   assertProvisionPayloadWithinCap(payload ?? {});
-  let box = await client.create(payload);
-  await box.waitFor("running", {
+  let box = await measure("create", () => client.create(payload));
+  await measure("wait_running", () => box.waitFor("running", {
     timeoutMs: shell.provisionTimeoutMs ?? DEFAULT_PROVISION_TIMEOUT_MS,
     ...onProgress ? { onProgress } : {}
-  });
-  box = await refreshRuntimeConnection(client, box);
+  }));
+  box = await measure("refresh_connection", () => refreshRuntimeConnection(client, box));
   if (deferredFiles.length > 0) {
     const written = await writeProfileFilesToBox(box, deferredFiles);
     if (!written.succeeded) {
@@ -2648,7 +2800,8 @@ async function provisionWorkspaceSandbox(shell, options) {
     }
   }
   if (shell.bootstrap) {
-    const boot = await shell.bootstrap(box, scope);
+    const bootstrap = shell.bootstrap.bind(shell);
+    const boot = await measure("bootstrap", () => bootstrap(box, scope));
     if (!boot.succeeded) {
       throw new Error(`bootstrap failed on new box ${name}`, { cause: boot.error });
     }
@@ -2793,7 +2946,8 @@ async function* detachedSandboxPromptEvents(box, prompt, options, backend) {
     ...options.expectedSecretProfileReceipt ? { expectedSecretProfileReceipt: options.expectedSecretProfileReceipt } : {},
     ...options.requireVisibleAssistantOutput !== void 0 ? { requireVisibleAssistantOutput: options.requireVisibleAssistantOutput } : {},
     ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
-    ...options.ttlMs !== void 0 ? { ttlMs: options.ttlMs } : {}
+    ...options.ttlMs !== void 0 ? { ttlMs: options.ttlMs } : {},
+    ...options.trace ? { traceId: options.trace.traceId } : {}
   });
   const admittedExecutionId = admission?.executionId ?? executionId;
   if (!admittedExecutionId) {
@@ -2810,6 +2964,7 @@ async function* detachedSandboxPromptEvents(box, prompt, options, backend) {
     sessionId: admission?.sessionId ?? sessionId,
     executionId: admittedExecutionId,
     lastEventId: lastEventId || "0",
+    ...options.trace ? { traceId: options.trace.traceId } : {},
     ...options.signal ? { signal: options.signal } : {}
   });
 }
@@ -3031,13 +3186,22 @@ async function* streamSandboxPrompt(shell, box, message, options) {
     ...options?.requireVisibleAssistantOutput !== void 0 ? { requireVisibleAssistantOutput: options.requireVisibleAssistantOutput } : {},
     ...options?.expectedPublicProfileRequestDigest ? { expectedPublicProfileRequestDigest: options.expectedPublicProfileRequestDigest } : {},
     ...options?.expectedSecretProfileReceipt ? { expectedSecretProfileReceipt: options.expectedSecretProfileReceipt } : {},
+    ...options?.trace ? { traceId: options.trace.traceId } : {},
     backend
   });
   const stream = options?.lastEventId ? dispatch() : resendRefusedDispatch(dispatch, options?.signal);
   emitSandboxActivity(options?.spend, box);
   let severedFinishReason = null;
+  const promptTrace = options?.trace ? createPromptTrace(options.trace, options.traceParent, {
+    "sandbox.id": box.id,
+    ...options.model ? { "gen_ai.request.model": options.model } : {},
+    ...options.harness ? { "sandbox.harness": options.harness } : {},
+    ...options.detach ? { "sandbox.detached": true } : {}
+  }) : void 0;
+  let promptError;
   try {
     for await (const event of stream) {
+      promptTrace?.observe(event);
       const step = classifySeveredStream(event);
       if (step) severedFinishReason = step.kind === "step-finish" && step.severed ? step.reason : null;
       if (severedFinishReason && isTerminalPromptEvent(event)) {
@@ -3051,8 +3215,12 @@ async function* streamSandboxPrompt(shell, box, message, options) {
       }
       yield event;
     }
+  } catch (error) {
+    promptError = error;
+    throw error;
   } finally {
     emitSandboxActivity(options?.spend, box);
+    promptTrace?.end(promptError);
   }
   if (severedFinishReason) {
     throw new Error(`sandbox model stream severed mid-turn (reason="${severedFinishReason}")`);
@@ -3345,4 +3513,4 @@ export {
   isTerminalPromptEvent,
   detectInteractiveQuestion
 };
-//# sourceMappingURL=chunk-SUIH5B55.js.map
+//# sourceMappingURL=chunk-RJJRRR5Z.js.map