octoflow-core 1.0.0

package/dist/observability/index.cjs

@@ -0,0 +1,502 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/observability/index.ts
+var observability_exports = {};
+__export(observability_exports, {
+  BridgeObservabilityAdapter: () => BridgeObservabilityAdapter,
+  attachVerboseListeners: () => attachVerboseListeners,
+  openTelemetrySink: () => openTelemetrySink
+});
+module.exports = __toCommonJS(observability_exports);
+
+// src/observability/bridge-adapter.ts
+var import_node_crypto = __toESM(require("node:crypto"), 1);
+var BridgeObservabilityAdapter = class {
+  openSpans = /* @__PURE__ */ new Map();
+  unsubs = [];
+  sinks;
+  includeMessageContent;
+  includeActionArgs;
+  constructor(emitter, opts) {
+    this.sinks = opts.sinks;
+    this.includeMessageContent = opts.includeMessageContent ?? false;
+    this.includeActionArgs = opts.includeActionArgs ?? false;
+    this.attach(emitter);
+  }
+  attach(emitter) {
+    this.unsubs.push(
+      emitter.on("task:created", (e) => this.onTaskCreated(e)),
+      emitter.on("task:completed", (e) => this.onTaskCompleted(e)),
+      emitter.on("task:failed", (e) => this.onTaskFailed(e)),
+      emitter.on("task:canceled", (e) => this.onTaskCanceled(e)),
+      emitter.on("action:invoked", (e) => this.onActionInvoked(e)),
+      emitter.on("action:result", (e) => this.onActionResult(e)),
+      emitter.on("action:error", (e) => this.onActionError(e))
+    );
+    const allEvents = [
+      "task:created",
+      "task:working",
+      "task:completed",
+      "task:failed",
+      "task:canceled",
+      "backend:selected",
+      "backend:switched",
+      "backend:retry",
+      "backend:fallback",
+      "backend:error",
+      "tool:delivered",
+      "tool:degraded",
+      "auth:login:start",
+      "auth:login:success",
+      "auth:login:failed",
+      "auth:refresh:start",
+      "auth:refresh:success",
+      "auth:refresh:failed",
+      "auth:logout",
+      "auth:state:changed",
+      "action:invoked",
+      "action:result",
+      "action:error",
+      "memory:get",
+      "memory:set",
+      "memory:delete",
+      "memory:list",
+      "brain:remember",
+      "brain:recall",
+      "brain:digest",
+      "brain:consolidate",
+      "brain:feedback",
+      "brain:contradiction",
+      "brain:audit",
+      "brain:replay",
+      "brain:prune",
+      "bridge:warn"
+    ];
+    for (const event of allEvents) {
+      this.unsubs.push(
+        emitter.on(event, (data) => {
+          const traceId = data.taskId;
+          const rootSpan = traceId ? this.openSpans.get(traceId) : void 0;
+          this.fanOut(
+            (sink) => sink.onEvent?.({
+              name: event,
+              data,
+              timestamp: Date.now(),
+              traceId,
+              spanId: rootSpan?.spanId
+            })
+          );
+        })
+      );
+    }
+  }
+  onTaskCreated(e) {
+    const attrs = {
+      "gen_ai.system": "octoflow-core",
+      "gen_ai.operation.name": "task",
+      "octoflow.backend": e.backend,
+      "octoflow.context_id": e.contextId
+    };
+    if (this.includeMessageContent) {
+      attrs["gen_ai.prompt"] = e.message;
+    }
+    const span = {
+      traceId: e.taskId,
+      spanId: e.taskId,
+      name: "task",
+      startTime: Date.now(),
+      status: "unset",
+      attributes: attrs
+    };
+    this.openSpans.set(e.taskId, span);
+    this.fanOut((sink) => sink.onSpanStart?.(span));
+  }
+  onTaskCompleted(e) {
+    this.closeRootSpan(e.taskId, "ok");
+  }
+  onTaskFailed(e) {
+    this.closeRootSpan(e.taskId, "error", new Error(e.error.error.message));
+  }
+  onTaskCanceled(e) {
+    this.closeRootSpan(e.taskId, "error", new Error("task canceled"));
+  }
+  onActionInvoked(e) {
+    const root = this.openSpans.get(e.taskId);
+    const attrs = {
+      "gen_ai.system": "octoflow-core",
+      "octoflow.action": e.actionName,
+      "octoflow.backend": e.backend
+    };
+    if (this.includeActionArgs) {
+      attrs["octoflow.action_args"] = JSON.stringify(e.args);
+    }
+    const childId = `${e.taskId}:action:${e.actionName}:${import_node_crypto.default.randomUUID()}`;
+    const span = {
+      traceId: e.taskId,
+      spanId: childId,
+      parentSpanId: root?.spanId,
+      name: `action:${e.actionName}`,
+      startTime: Date.now(),
+      status: "unset",
+      attributes: attrs
+    };
+    this.openSpans.set(childId, span);
+    this.fanOut((sink) => sink.onSpanStart?.(span));
+  }
+  onActionResult(e) {
+    this.closeActionSpan(e.taskId, e.actionName, "ok", e.durationMs);
+  }
+  onActionError(e) {
+    const root = this.openSpans.get(e.taskId);
+    const existsKey = [...this.openSpans.keys()].find((id) => {
+      const s = this.openSpans.get(id);
+      return s.name === `action:${e.actionName}` && s.traceId === e.taskId;
+    });
+    if (!existsKey) {
+      const now = Date.now();
+      const childId = `${e.taskId}:action:${e.actionName}:error`;
+      const span = {
+        traceId: e.taskId,
+        spanId: childId,
+        parentSpanId: root?.spanId,
+        name: `action:${e.actionName}`,
+        startTime: now - e.durationMs,
+        endTime: now,
+        durationMs: e.durationMs,
+        status: "error",
+        error: new Error(e.error.message),
+        attributes: {
+          "gen_ai.system": "octoflow-core",
+          "octoflow.action": e.actionName,
+          "octoflow.backend": e.backend
+        }
+      };
+      this.fanOut((sink) => sink.onSpanEnd?.(span));
+      return;
+    }
+    this.closeActionSpan(
+      e.taskId,
+      e.actionName,
+      "error",
+      e.durationMs,
+      new Error(e.error.message)
+    );
+  }
+  closeRootSpan(taskId, status, error) {
+    const span = this.openSpans.get(taskId);
+    if (!span) return;
+    const endTime = Date.now();
+    const closed = {
+      ...span,
+      endTime,
+      durationMs: endTime - span.startTime,
+      status,
+      error
+    };
+    this.openSpans.delete(taskId);
+    this.fanOut((sink) => sink.onSpanEnd?.(closed));
+  }
+  closeActionSpan(taskId, actionName, status, durationMs, error) {
+    for (const [id, span] of this.openSpans) {
+      if (span.name === `action:${actionName}` && span.traceId === taskId) {
+        const endTime = Date.now();
+        const closed = {
+          ...span,
+          endTime,
+          durationMs,
+          status,
+          error
+        };
+        this.openSpans.delete(id);
+        this.fanOut((sink) => sink.onSpanEnd?.(closed));
+        return;
+      }
+    }
+  }
+  fanOut(fn) {
+    for (const sink of this.sinks) {
+      try {
+        fn(sink);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[octoflow] observability sink error: ${msg}
+`);
+      }
+    }
+  }
+  close() {
+    for (const [taskId, span] of this.openSpans) {
+      const endTime = Date.now();
+      const closed = {
+        ...span,
+        endTime,
+        durationMs: endTime - span.startTime,
+        status: "error",
+        error: new Error("bridge closed with open span")
+      };
+      this.fanOut((sink) => sink.onSpanEnd?.(closed));
+      this.openSpans.delete(taskId);
+    }
+    for (const unsub of this.unsubs) unsub();
+    this.unsubs.length = 0;
+  }
+};
+
+// src/observability/otel-sink.ts
+var OTEL_STATUS_OK = 1;
+var OTEL_STATUS_ERROR = 2;
+function openTelemetrySink(opts) {
+  const { tracer } = opts;
+  const activeSpans = /* @__PURE__ */ new Map();
+  return {
+    onSpanStart(span) {
+      const otelSpan = tracer.startSpan(span.name, {
+        startTime: span.startTime,
+        attributes: span.attributes
+      });
+      activeSpans.set(span.spanId, otelSpan);
+    },
+    onSpanEnd(span) {
+      const otelSpan = activeSpans.get(span.spanId);
+      if (!otelSpan) {
+        process.stderr.write(
+          `[octoflow] openTelemetrySink: onSpanEnd called for unknown spanId "${span.spanId}"
+`
+        );
+        return;
+      }
+      activeSpans.delete(span.spanId);
+      if (span.status === "ok") {
+        otelSpan.setStatus({ code: OTEL_STATUS_OK });
+      } else if (span.status === "error") {
+        otelSpan.setStatus({
+          code: OTEL_STATUS_ERROR,
+          message: span.error?.message
+        });
+        if (span.error) {
+          otelSpan.recordException(span.error);
+        }
+      }
+      otelSpan.end(span.endTime);
+    }
+  };
+}
+
+// src/observability/verbose-listeners.ts
+function verboseLog(msg) {
+  process.stderr.write(`${msg}
+`);
+}
+function isAgentHandleWithBridge(value) {
+  return "agentType" in value && "bridge" in value;
+}
+function isBridgeInstance(value) {
+  return "on" in value && typeof value.on === "function";
+}
+function attachVerboseListeners(bridgeOrHandle) {
+  const bridge = isAgentHandleWithBridge(bridgeOrHandle) ? bridgeOrHandle.bridge : isBridgeInstance(bridgeOrHandle) ? bridgeOrHandle : bridgeOrHandle.bridge;
+  const offRetry = bridge.on(
+    "backend:retry",
+    (info) => verboseLog(
+      `[retry] ${info.backend ?? "unknown"} attempt ${info.attempt}/${info.maxRetries} in ${info.delayMs}ms: ${info.error.message}`
+    )
+  );
+  const offError = bridge.on(
+    "backend:error",
+    (info) => verboseLog(
+      `[error] ${info.phase} via ${info.backend ?? "unknown"}: ${info.error.message}`
+    )
+  );
+  const offFallback = bridge.on(
+    "backend:fallback",
+    (info) => verboseLog(
+      `[fallback] ${info.fromBackend ?? "unknown"} -> ${info.toBackend} after ${info.error.message}`
+    )
+  );
+  const offSwitched = bridge.on(
+    "backend:switched",
+    (info) => verboseLog(
+      `[switched] ${info.fromBackend} -> ${info.toBackend} (reason: ${info.reason}, context: ${info.contextId})`
+    )
+  );
+  const offTaskCreated = bridge.on(
+    "task:created",
+    (info) => verboseLog(
+      `[task:created] ${info.taskId} (${info.backend}, ctx: ${info.contextId})`
+    )
+  );
+  const offTaskWorking = bridge.on(
+    "task:working",
+    (info) => verboseLog(`[task:working] ${info.taskId} (${info.backend})`)
+  );
+  const offTaskCompleted = bridge.on(
+    "task:completed",
+    (info) => verboseLog(`[task:completed] ${info.taskId} (${info.backend})`)
+  );
+  const offTaskFailed = bridge.on(
+    "task:failed",
+    (info) => verboseLog(
+      `[task:failed] ${info.taskId} via ${info.backend}: ${info.error.error.message}`
+    )
+  );
+  const offTaskCanceled = bridge.on(
+    "task:canceled",
+    (info) => verboseLog(`[task:canceled] ${info.taskId}`)
+  );
+  const offSubagentStart = bridge.on(
+    "subagent:start",
+    (info) => verboseLog(
+      `[subagent:start] ${info.agentName} (${info.backend}, ctx: ${info.contextId}${info.subagentRole ? `, role: ${info.subagentRole}` : ""}${info.depth !== void 0 ? `, depth: ${info.depth}` : ""})`
+    )
+  );
+  const offSubagentStop = bridge.on(
+    "subagent:stop",
+    (info) => verboseLog(
+      `[subagent:stop] ${info.agentName} (${info.backend}) status=${info.status}${info.durationMs !== void 0 ? ` in ${info.durationMs}ms` : ""}`
+    )
+  );
+  const offToolCall = bridge.on(
+    "agent:tool-call",
+    (info) => verboseLog(
+      `[tool-call] ${info.actionName} status=${info.status}${info.durationMs !== void 0 ? ` in ${info.durationMs}ms` : ""}${info.error ? `: ${info.error.message}` : ""}`
+    )
+  );
+  const offMcpTool = bridge.on(
+    "mcp:tool:invoke",
+    (info) => verboseLog(
+      `[mcp:tool] ${info.server}/${info.tool} ${info.timedOut ? "timed out" : `in ${info.durationMs}ms`}${info.cacheHit ? " (cache hit)" : ""}`
+    )
+  );
+  const offMcpPoolReady = bridge.on(
+    "mcp:pool:ready",
+    (info) => verboseLog(
+      `[mcp:pool:ready] ${info.serverCount} servers, ${info.toolCount} tools`
+    )
+  );
+  const offMcpConnReady = bridge.on(
+    "mcp:connection:ready",
+    (info) => verboseLog(
+      `[mcp:ready] ${info.server} (${info.toolCount} tools${info.protocolVersion ? `, proto ${info.protocolVersion}` : ""})`
+    )
+  );
+  const offMcpConnError = bridge.on(
+    "mcp:connection:error",
+    (info) => verboseLog(`[mcp:error] ${info.server}: ${info.error}`)
+  );
+  const offToolDelivered = bridge.on(
+    "tool:delivered",
+    (info) => verboseLog(
+      `[tool:delivered] ${info.toolCount} tools via ${info.strategy} (ctx: ${info.contextId})`
+    )
+  );
+  const offToolDegraded = bridge.on(
+    "tool:degraded",
+    (info) => verboseLog(`[tool:degraded] ${info.reason}: ${info.tools.join(", ")}`)
+  );
+  const offBrainRemember = bridge.on(
+    "brain:remember",
+    (info) => verboseLog(
+      `[brain:remember] ${info.kind} scope=${info.scope} accepted=${info.accepted}${info.recordId ? ` id=${info.recordId}` : ""}`
+    )
+  );
+  const offBrainRecall = bridge.on(
+    "brain:recall",
+    (info) => verboseLog(
+      `[brain:recall] "${info.query}" -> ${info.resultCount} results${info.scope ? ` (scope: ${info.scope})` : ""}`
+    )
+  );
+  const offBrainAdvisory = bridge.on(
+    "brain:advisory",
+    (info) => verboseLog(`[brain:advisory] ${info.code}: ${info.message}`)
+  );
+  const offBridgeWarn = bridge.on(
+    "bridge:warn",
+    (info) => verboseLog(`[bridge:warn] ${info.code}: ${info.message}`)
+  );
+  const offMiddlewareError = bridge.on(
+    "middleware:error",
+    (info) => verboseLog(
+      `[middleware:error] ${info.phase}/${info.plugin} recovered=${info.recovered}: ${info.error.message}`
+    )
+  );
+  const offApprovalCreated = bridge.on(
+    "approval:created",
+    (info) => verboseLog(
+      `[approval:created] ${info.approval.id} (ctx: ${info.approval.contextId}, type: ${info.approval.type})`
+    )
+  );
+  const offApprovalUpdated = bridge.on(
+    "approval:updated",
+    (info) => verboseLog(
+      `[approval:updated] ${info.approval.id} status=${info.approval.status}`
+    )
+  );
+  const offBridgeMessage = bridge.on("bridge:message", (info) => {
+    process.stdout.write(info.text);
+  });
+  let disposed = false;
+  return () => {
+    if (disposed) return;
+    disposed = true;
+    offRetry();
+    offError();
+    offFallback();
+    offSwitched();
+    offTaskCreated();
+    offTaskWorking();
+    offTaskCompleted();
+    offTaskFailed();
+    offTaskCanceled();
+    offSubagentStart();
+    offSubagentStop();
+    offToolCall();
+    offMcpTool();
+    offMcpPoolReady();
+    offMcpConnReady();
+    offMcpConnError();
+    offToolDelivered();
+    offToolDegraded();
+    offBrainRemember();
+    offBrainRecall();
+    offBrainAdvisory();
+    offBridgeWarn();
+    offMiddlewareError();
+    offApprovalCreated();
+    offApprovalUpdated();
+    offBridgeMessage();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BridgeObservabilityAdapter,
+  attachVerboseListeners,
+  openTelemetrySink
+});
+//# sourceMappingURL=index.cjs.map

package/dist/observability/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/observability/index.ts", "../../src/observability/bridge-adapter.ts", "../../src/observability/otel-sink.ts", "../../src/observability/verbose-listeners.ts"],
+  "sourcesContent": ["export { BridgeObservabilityAdapter } from './bridge-adapter.js';\nexport type { OtelSinkOptions } from './otel-sink.js';\nexport { openTelemetrySink } from './otel-sink.js';\nexport type {\n  ObservabilityEvent,\n  ObservabilityOptions,\n  ObservabilitySink,\n  ObservabilitySpan,\n} from './types.js';\nexport type { VerboseListenersDispose } from './verbose-listeners.js';\nexport { attachVerboseListeners } from './verbose-listeners.js';\n", "import crypto from 'node:crypto';\n\nimport type { BridgeEventMap } from '../runtime/bridge/events.js';\nimport type { BridgeEventEmitter } from '../runtime/bridge/events.js';\nimport type {\n  ObservabilityOptions,\n  ObservabilitySink,\n  ObservabilitySpan,\n} from './types.js';\n\nexport class BridgeObservabilityAdapter {\n  private readonly openSpans = new Map<string, ObservabilitySpan>();\n  private readonly unsubs: Array<() => void> = [];\n  private readonly sinks: ObservabilitySink[];\n  private readonly includeMessageContent: boolean;\n  private readonly includeActionArgs: boolean;\n\n  constructor(emitter: BridgeEventEmitter, opts: ObservabilityOptions) {\n    this.sinks = opts.sinks;\n    this.includeMessageContent = opts.includeMessageContent ?? false;\n    this.includeActionArgs = opts.includeActionArgs ?? false;\n    this.attach(emitter);\n  }\n\n  private attach(emitter: BridgeEventEmitter): void {\n    this.unsubs.push(\n      emitter.on('task:created', (e) => this.onTaskCreated(e)),\n      emitter.on('task:completed', (e) => this.onTaskCompleted(e)),\n      emitter.on('task:failed', (e) => this.onTaskFailed(e)),\n      emitter.on('task:canceled', (e) => this.onTaskCanceled(e)),\n      emitter.on('action:invoked', (e) => this.onActionInvoked(e)),\n      emitter.on('action:result', (e) => this.onActionResult(e)),\n      emitter.on('action:error', (e) => this.onActionError(e))\n    );\n\n    const allEvents = [\n      'task:created',\n      'task:working',\n      'task:completed',\n      'task:failed',\n      'task:canceled',\n      'backend:selected',\n      'backend:switched',\n      'backend:retry',\n      'backend:fallback',\n      'backend:error',\n      'tool:delivered',\n      'tool:degraded',\n      'auth:login:start',\n      'auth:login:success',\n      'auth:login:failed',\n      'auth:refresh:start',\n      'auth:refresh:success',\n      'auth:refresh:failed',\n      'auth:logout',\n      'auth:state:changed',\n      'action:invoked',\n      'action:result',\n      'action:error',\n      'memory:get',\n      'memory:set',\n      'memory:delete',\n      'memory:list',\n      'brain:remember',\n      'brain:recall',\n      'brain:digest',\n      'brain:consolidate',\n      'brain:feedback',\n      'brain:contradiction',\n      'brain:audit',\n      'brain:replay',\n      'brain:prune',\n      'bridge:warn',\n    ] as const;\n\n    for (const event of allEvents) {\n      this.unsubs.push(\n        emitter.on(event, (data) => {\n          const traceId = (data as { taskId?: string }).taskId;\n          const rootSpan = traceId ? this.openSpans.get(traceId) : undefined;\n          this.fanOut((sink) =>\n            sink.onEvent?.({\n              name: event,\n              data: data,\n              timestamp: Date.now(),\n              traceId,\n              spanId: rootSpan?.spanId,\n            })\n          );\n        })\n      );\n    }\n  }\n\n  private onTaskCreated(e: BridgeEventMap['task:created']): void {\n    const attrs: Record<string, string | number | boolean> = {\n      'gen_ai.system': 'octoflow-core',\n      'gen_ai.operation.name': 'task',\n      'octoflow.backend': e.backend,\n      'octoflow.context_id': e.contextId,\n    };\n    if (this.includeMessageContent) {\n      attrs['gen_ai.prompt'] = e.message;\n    }\n\n    const span: ObservabilitySpan = {\n      traceId: e.taskId,\n      spanId: e.taskId,\n      name: 'task',\n      startTime: Date.now(),\n      status: 'unset',\n      attributes: attrs,\n    };\n    this.openSpans.set(e.taskId, span);\n    this.fanOut((sink) => sink.onSpanStart?.(span));\n  }\n\n  private onTaskCompleted(e: BridgeEventMap['task:completed']): void {\n    this.closeRootSpan(e.taskId, 'ok');\n  }\n\n  private onTaskFailed(e: BridgeEventMap['task:failed']): void {\n    this.closeRootSpan(e.taskId, 'error', new Error(e.error.error.message));\n  }\n\n  private onTaskCanceled(e: BridgeEventMap['task:canceled']): void {\n    this.closeRootSpan(e.taskId, 'error', new Error('task canceled'));\n  }\n\n  private onActionInvoked(e: BridgeEventMap['action:invoked']): void {\n    const root = this.openSpans.get(e.taskId);\n    const attrs: Record<string, string | number | boolean> = {\n      'gen_ai.system': 'octoflow-core',\n      'octoflow.action': e.actionName,\n      'octoflow.backend': e.backend,\n    };\n    if (this.includeActionArgs) {\n      attrs['octoflow.action_args'] = JSON.stringify(e.args);\n    }\n\n    const childId = `${e.taskId}:action:${e.actionName}:${crypto.randomUUID()}`;\n    const span: ObservabilitySpan = {\n      traceId: e.taskId,\n      spanId: childId,\n      parentSpanId: root?.spanId,\n      name: `action:${e.actionName}`,\n      startTime: Date.now(),\n      status: 'unset',\n      attributes: attrs,\n    };\n    this.openSpans.set(childId, span);\n    this.fanOut((sink) => sink.onSpanStart?.(span));\n  }\n\n  private onActionResult(e: BridgeEventMap['action:result']): void {\n    this.closeActionSpan(e.taskId, e.actionName, 'ok', e.durationMs);\n  }\n\n  private onActionError(e: BridgeEventMap['action:error']): void {\n    const root = this.openSpans.get(e.taskId);\n    // action:error may fire without a prior action:invoked \u2014 create an instant span\n    const existsKey = [...this.openSpans.keys()].find((id) => {\n      const s = this.openSpans.get(id)!;\n      return s.name === `action:${e.actionName}` && s.traceId === e.taskId;\n    });\n    if (!existsKey) {\n      const now = Date.now();\n      const childId = `${e.taskId}:action:${e.actionName}:error`;\n      const span: ObservabilitySpan = {\n        traceId: e.taskId,\n        spanId: childId,\n        parentSpanId: root?.spanId,\n        name: `action:${e.actionName}`,\n        startTime: now - e.durationMs,\n        endTime: now,\n        durationMs: e.durationMs,\n        status: 'error',\n        error: new Error(e.error.message),\n        attributes: {\n          'gen_ai.system': 'octoflow-core',\n          'octoflow.action': e.actionName,\n          'octoflow.backend': e.backend,\n        },\n      };\n      this.fanOut((sink) => sink.onSpanEnd?.(span));\n      return;\n    }\n    this.closeActionSpan(\n      e.taskId,\n      e.actionName,\n      'error',\n      e.durationMs,\n      new Error(e.error.message)\n    );\n  }\n\n  private closeRootSpan(\n    taskId: string,\n    status: 'ok' | 'error',\n    error?: Error\n  ): void {\n    const span = this.openSpans.get(taskId);\n    if (!span) return;\n    const endTime = Date.now();\n    const closed: ObservabilitySpan = {\n      ...span,\n      endTime,\n      durationMs: endTime - span.startTime,\n      status,\n      error,\n    };\n    this.openSpans.delete(taskId);\n    this.fanOut((sink) => sink.onSpanEnd?.(closed));\n  }\n\n  private closeActionSpan(\n    taskId: string,\n    actionName: string,\n    status: 'ok' | 'error',\n    durationMs: number,\n    error?: Error\n  ): void {\n    for (const [id, span] of this.openSpans) {\n      if (span.name === `action:${actionName}` && span.traceId === taskId) {\n        const endTime = Date.now();\n        const closed: ObservabilitySpan = {\n          ...span,\n          endTime,\n          durationMs,\n          status,\n          error,\n        };\n        this.openSpans.delete(id);\n        this.fanOut((sink) => sink.onSpanEnd?.(closed));\n        return;\n      }\n    }\n  }\n\n  private fanOut(fn: (sink: ObservabilitySink) => void): void {\n    for (const sink of this.sinks) {\n      try {\n        fn(sink);\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        process.stderr.write(`[octoflow] observability sink error: ${msg}\\n`);\n      }\n    }\n  }\n\n  close(): void {\n    for (const [taskId, span] of this.openSpans) {\n      const endTime = Date.now();\n      const closed: ObservabilitySpan = {\n        ...span,\n        endTime,\n        durationMs: endTime - span.startTime,\n        status: 'error',\n        error: new Error('bridge closed with open span'),\n      };\n      this.fanOut((sink) => sink.onSpanEnd?.(closed));\n      this.openSpans.delete(taskId);\n    }\n    for (const unsub of this.unsubs) unsub();\n    this.unsubs.length = 0;\n  }\n}\n", "import type { ObservabilitySink, ObservabilitySpan } from './types.js';\n\n// Minimal OTEL types we need \u2014 avoids importing @opentelemetry/api at runtime\n// (it's a peer dep; consumers install it themselves)\ninterface OtelSpan {\n  setAttribute(key: string, value: string | number | boolean): void;\n  setStatus(status: { code: number; message?: string }): void;\n  recordException(error: Error): void;\n  end(endTime?: number): void;\n}\n\ninterface OtelTracer {\n  startSpan(name: string, options?: Record<string, unknown>): OtelSpan;\n}\n\nexport interface OtelSinkOptions {\n  tracer: OtelTracer;\n}\n\nconst OTEL_STATUS_OK = 1;\nconst OTEL_STATUS_ERROR = 2;\n\n/**\n * Creates an {@link ObservabilitySink} that forwards spans to an OpenTelemetry tracer.\n *\n * @example\n * import { trace } from '@opentelemetry/api';\n * const sink = openTelemetrySink({ tracer: trace.getTracer('my-service') });\n * const bridge = await createBridge({ observability: { sinks: [sink] } });\n */\nexport function openTelemetrySink(opts: OtelSinkOptions): ObservabilitySink {\n  const { tracer } = opts;\n  const activeSpans = new Map<string, OtelSpan>();\n\n  return {\n    onSpanStart(span: ObservabilitySpan): void {\n      const otelSpan = tracer.startSpan(span.name, {\n        startTime: span.startTime,\n        attributes: span.attributes,\n      });\n      activeSpans.set(span.spanId, otelSpan);\n    },\n\n    onSpanEnd(span: ObservabilitySpan): void {\n      const otelSpan = activeSpans.get(span.spanId);\n      if (!otelSpan) {\n        process.stderr.write(\n          `[octoflow] openTelemetrySink: onSpanEnd called for unknown spanId \"${span.spanId}\"\\n`\n        );\n        return;\n      }\n      activeSpans.delete(span.spanId);\n\n      if (span.status === 'ok') {\n        otelSpan.setStatus({ code: OTEL_STATUS_OK });\n      } else if (span.status === 'error') {\n        otelSpan.setStatus({\n          code: OTEL_STATUS_ERROR,\n          message: span.error?.message,\n        });\n        if (span.error) {\n          otelSpan.recordException(span.error);\n        }\n      }\n\n      otelSpan.end(span.endTime);\n    },\n  };\n}\n", "import type { AgentHandle } from '../runtime/bridge/agent-handle.js';\nimport type { Bridge } from '../runtime/bridge/bridge.js';\n\n/**\n * Writes a verbose diagnostic line to `process.stderr`. Using the stream\n * directly (rather than `console.error`) makes the intent explicit: this is\n * diagnostic output routed to stderr so it doesn't pollute stdout, NOT an\n * error condition.\n */\nfunction verboseLog(msg: string): void {\n  process.stderr.write(`${msg}\\n`);\n}\n\n/**\n * Dispose handle returned by {@link attachVerboseListeners}. Call to detach\n * the listeners; subsequent calls are no-ops.\n */\nexport type VerboseListenersDispose = () => void;\n\nfunction isAgentHandleWithBridge(\n  value: Bridge | AgentHandle\n): value is AgentHandle & { bridge: Bridge } {\n  return 'agentType' in value && 'bridge' in value;\n}\n\nfunction isBridgeInstance(value: Bridge | AgentHandle): value is Bridge {\n  return 'on' in value && typeof value.on === 'function';\n}\n\n/**\n * Attaches event loggers to the bridge for every observable lifecycle\n * category:\n *\n * - Backend resilience: `backend:retry`, `backend:error`, `backend:fallback`,\n *   `backend:switched`\n * - Task lifecycle: `task:created`, `task:working`, `task:completed`,\n *   `task:failed`, `task:canceled`\n * - Subagent lifecycle: `subagent:start`, `subagent:stop`\n * - Tool calls: `agent:tool-call`, `mcp:tool:invoke`\n * - MCP connectivity: `mcp:pool:ready`, `mcp:connection:ready`,\n *   `mcp:connection:error`\n * - Tool delivery: `tool:delivered`, `tool:degraded`\n * - Brain / memory: `brain:remember`, `brain:recall`, `brain:advisory`\n * - Runtime: `bridge:warn`, `middleware:error`\n * - Approvals: `approval:created`, `approval:updated`\n *\n * Matches the exact format copy-pasted across templates so existing captured\n * logs stay grep-able. `Bridge.quickStart({ verbose: true })` calls this\n * instead of inlining its own listeners.\n */\nexport function attachVerboseListeners(\n  bridgeOrHandle: Bridge | AgentHandle\n): VerboseListenersDispose {\n  const bridge: Bridge = isAgentHandleWithBridge(bridgeOrHandle)\n    ? bridgeOrHandle.bridge\n    : isBridgeInstance(bridgeOrHandle)\n      ? bridgeOrHandle\n      : bridgeOrHandle.bridge;\n  const offRetry = bridge.on('backend:retry', (info) =>\n    verboseLog(\n      `[retry] ${info.backend ?? 'unknown'} attempt ${info.attempt}/${info.maxRetries} in ${info.delayMs}ms: ${info.error.message}`\n    )\n  );\n  const offError = bridge.on('backend:error', (info) =>\n    verboseLog(\n      `[error] ${info.phase} via ${info.backend ?? 'unknown'}: ${info.error.message}`\n    )\n  );\n  const offFallback = bridge.on('backend:fallback', (info) =>\n    verboseLog(\n      `[fallback] ${info.fromBackend ?? 'unknown'} -> ${info.toBackend} after ${info.error.message}`\n    )\n  );\n  const offSwitched = bridge.on('backend:switched', (info) =>\n    verboseLog(\n      `[switched] ${info.fromBackend} -> ${info.toBackend} (reason: ${info.reason}, context: ${info.contextId})`\n    )\n  );\n\n  const offTaskCreated = bridge.on('task:created', (info) =>\n    verboseLog(\n      `[task:created] ${info.taskId} (${info.backend}, ctx: ${info.contextId})`\n    )\n  );\n  const offTaskWorking = bridge.on('task:working', (info) =>\n    verboseLog(`[task:working] ${info.taskId} (${info.backend})`)\n  );\n  const offTaskCompleted = bridge.on('task:completed', (info) =>\n    verboseLog(`[task:completed] ${info.taskId} (${info.backend})`)\n  );\n  const offTaskFailed = bridge.on('task:failed', (info) =>\n    verboseLog(\n      `[task:failed] ${info.taskId} via ${info.backend}: ${info.error.error.message}`\n    )\n  );\n  const offTaskCanceled = bridge.on('task:canceled', (info) =>\n    verboseLog(`[task:canceled] ${info.taskId}`)\n  );\n\n  const offSubagentStart = bridge.on('subagent:start', (info) =>\n    verboseLog(\n      `[subagent:start] ${info.agentName} (${info.backend}, ctx: ${info.contextId}${info.subagentRole ? `, role: ${info.subagentRole}` : ''}${info.depth !== undefined ? `, depth: ${info.depth}` : ''})`\n    )\n  );\n  const offSubagentStop = bridge.on('subagent:stop', (info) =>\n    verboseLog(\n      `[subagent:stop] ${info.agentName} (${info.backend}) status=${info.status}${info.durationMs !== undefined ? ` in ${info.durationMs}ms` : ''}`\n    )\n  );\n\n  const offToolCall = bridge.on('agent:tool-call', (info) =>\n    verboseLog(\n      `[tool-call] ${info.actionName} status=${info.status}${info.durationMs !== undefined ? ` in ${info.durationMs}ms` : ''}${info.error ? `: ${info.error.message}` : ''}`\n    )\n  );\n  const offMcpTool = bridge.on('mcp:tool:invoke', (info) =>\n    verboseLog(\n      `[mcp:tool] ${info.server}/${info.tool} ${info.timedOut ? 'timed out' : `in ${info.durationMs}ms`}${info.cacheHit ? ' (cache hit)' : ''}`\n    )\n  );\n\n  const offMcpPoolReady = bridge.on('mcp:pool:ready', (info) =>\n    verboseLog(\n      `[mcp:pool:ready] ${info.serverCount} servers, ${info.toolCount} tools`\n    )\n  );\n  const offMcpConnReady = bridge.on('mcp:connection:ready', (info) =>\n    verboseLog(\n      `[mcp:ready] ${info.server} (${info.toolCount} tools${info.protocolVersion ? `, proto ${info.protocolVersion}` : ''})`\n    )\n  );\n  const offMcpConnError = bridge.on('mcp:connection:error', (info) =>\n    verboseLog(`[mcp:error] ${info.server}: ${info.error}`)\n  );\n\n  const offToolDelivered = bridge.on('tool:delivered', (info) =>\n    verboseLog(\n      `[tool:delivered] ${info.toolCount} tools via ${info.strategy} (ctx: ${info.contextId})`\n    )\n  );\n  const offToolDegraded = bridge.on('tool:degraded', (info) =>\n    verboseLog(`[tool:degraded] ${info.reason}: ${info.tools.join(', ')}`)\n  );\n\n  const offBrainRemember = bridge.on('brain:remember', (info) =>\n    verboseLog(\n      `[brain:remember] ${info.kind} scope=${info.scope} accepted=${info.accepted}${info.recordId ? ` id=${info.recordId}` : ''}`\n    )\n  );\n  const offBrainRecall = bridge.on('brain:recall', (info) =>\n    verboseLog(\n      `[brain:recall] \"${info.query}\" -> ${info.resultCount} results${info.scope ? ` (scope: ${info.scope})` : ''}`\n    )\n  );\n  const offBrainAdvisory = bridge.on('brain:advisory', (info) =>\n    verboseLog(`[brain:advisory] ${info.code}: ${info.message}`)\n  );\n\n  const offBridgeWarn = bridge.on('bridge:warn', (info) =>\n    verboseLog(`[bridge:warn] ${info.code}: ${info.message}`)\n  );\n  const offMiddlewareError = bridge.on('middleware:error', (info) =>\n    verboseLog(\n      `[middleware:error] ${info.phase}/${info.plugin} recovered=${info.recovered}: ${info.error.message}`\n    )\n  );\n\n  const offApprovalCreated = bridge.on('approval:created', (info) =>\n    verboseLog(\n      `[approval:created] ${info.approval.id} (ctx: ${info.approval.contextId}, type: ${info.approval.type})`\n    )\n  );\n  const offApprovalUpdated = bridge.on('approval:updated', (info) =>\n    verboseLog(\n      `[approval:updated] ${info.approval.id} status=${info.approval.status}`\n    )\n  );\n\n  const offBridgeMessage = bridge.on('bridge:message', (info) => {\n    process.stdout.write(info.text);\n  });\n\n  let disposed = false;\n  return () => {\n    if (disposed) return;\n    disposed = true;\n    offRetry();\n    offError();\n    offFallback();\n    offSwitched();\n    offTaskCreated();\n    offTaskWorking();\n    offTaskCompleted();\n    offTaskFailed();\n    offTaskCanceled();\n    offSubagentStart();\n    offSubagentStop();\n    offToolCall();\n    offMcpTool();\n    offMcpPoolReady();\n    offMcpConnReady();\n    offMcpConnError();\n    offToolDelivered();\n    offToolDegraded();\n    offBrainRemember();\n    offBrainRecall();\n    offBrainAdvisory();\n    offBridgeWarn();\n    offMiddlewareError();\n    offApprovalCreated();\n    offApprovalUpdated();\n    offBridgeMessage();\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["crypto"]
+}

package/dist/observability/index.d.ts

@@ -0,0 +1,7 @@
+export { BridgeObservabilityAdapter } from './bridge-adapter.js';
+export type { OtelSinkOptions } from './otel-sink.js';
+export { openTelemetrySink } from './otel-sink.js';
+export type { ObservabilityEvent, ObservabilityOptions, ObservabilitySink, ObservabilitySpan, } from './types.js';
+export type { VerboseListenersDispose } from './verbose-listeners.js';
+export { attachVerboseListeners } from './verbose-listeners.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,9 @@
+import { BridgeObservabilityAdapter } from "./bridge-adapter.js";
+import { openTelemetrySink } from "./otel-sink.js";
+import { attachVerboseListeners } from "./verbose-listeners.js";
+export {
+  BridgeObservabilityAdapter,
+  attachVerboseListeners,
+  openTelemetrySink
+};
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/observability/index.ts"],
+  "sourcesContent": ["export { BridgeObservabilityAdapter } from './bridge-adapter.js';\nexport type { OtelSinkOptions } from './otel-sink.js';\nexport { openTelemetrySink } from './otel-sink.js';\nexport type {\n  ObservabilityEvent,\n  ObservabilityOptions,\n  ObservabilitySink,\n  ObservabilitySpan,\n} from './types.js';\nexport type { VerboseListenersDispose } from './verbose-listeners.js';\nexport { attachVerboseListeners } from './verbose-listeners.js';\n"],
+  "mappings": "AAAA,SAAS,kCAAkC;AAE3C,SAAS,yBAAyB;AAQlC,SAAS,8BAA8B;",
+  "names": []
+}

package/dist/observability/otel-sink.d.ts

@@ -0,0 +1,27 @@
+import type { ObservabilitySink } from './types.js';
+interface OtelSpan {
+    setAttribute(key: string, value: string | number | boolean): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    recordException(error: Error): void;
+    end(endTime?: number): void;
+}
+interface OtelTracer {
+    startSpan(name: string, options?: Record<string, unknown>): OtelSpan;
+}
+export interface OtelSinkOptions {
+    tracer: OtelTracer;
+}
+/**
+ * Creates an {@link ObservabilitySink} that forwards spans to an OpenTelemetry tracer.
+ *
+ * @example
+ * import { trace } from '@opentelemetry/api';
+ * const sink = openTelemetrySink({ tracer: trace.getTracer('my-service') });
+ * const bridge = await createBridge({ observability: { sinks: [sink] } });
+ */
+export declare function openTelemetrySink(opts: OtelSinkOptions): ObservabilitySink;
+export {};
+//# sourceMappingURL=otel-sink.d.ts.map

package/dist/observability/otel-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-sink.d.ts","sourceRoot":"","sources":["../../src/observability/otel-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAIvE,UAAU,QAAQ;IAChB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,UAAU;IAClB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;CACpB;AAKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAsC1E"}

package/dist/observability/otel-sink.js

@@ -0,0 +1,42 @@
+const OTEL_STATUS_OK = 1;
+const OTEL_STATUS_ERROR = 2;
+function openTelemetrySink(opts) {
+  const { tracer } = opts;
+  const activeSpans = /* @__PURE__ */ new Map();
+  return {
+    onSpanStart(span) {
+      const otelSpan = tracer.startSpan(span.name, {
+        startTime: span.startTime,
+        attributes: span.attributes
+      });
+      activeSpans.set(span.spanId, otelSpan);
+    },
+    onSpanEnd(span) {
+      const otelSpan = activeSpans.get(span.spanId);
+      if (!otelSpan) {
+        process.stderr.write(
+          `[octoflow] openTelemetrySink: onSpanEnd called for unknown spanId "${span.spanId}"
+`
+        );
+        return;
+      }
+      activeSpans.delete(span.spanId);
+      if (span.status === "ok") {
+        otelSpan.setStatus({ code: OTEL_STATUS_OK });
+      } else if (span.status === "error") {
+        otelSpan.setStatus({
+          code: OTEL_STATUS_ERROR,
+          message: span.error?.message
+        });
+        if (span.error) {
+          otelSpan.recordException(span.error);
+        }
+      }
+      otelSpan.end(span.endTime);
+    }
+  };
+}
+export {
+  openTelemetrySink
+};
+//# sourceMappingURL=otel-sink.js.map