@morsehq-dev/sdk 0.4.1 → 0.5.0-rc.1

package/dist/browser/chunk-454FDWBM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/_agent-sdk-common/span-emitter.ts"],"names":[],"mappings":"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","file":"chunk-454FDWBM.js","sourcesContent":["/**\n * `_agent-sdk-common/span-emitter.ts` — shared span-emission helpers used by\n * all three agent-SDK adapters (`anthropic-agent-sdk`, `openai-agents`,\n * `langgraph-js`).\n *\n * Each helper:\n *\n *   1. Validates the required metadata for its logical span type.\n *   2. Calls `startSpan(...)` from `_internal/tracing.ts` to allocate the\n *      wire-format span and push it onto the active trace's span stack.\n *   3. Tags `metadata.adapter` on every span so the UI can attribute spans\n *      back to their adapter origin.\n *   4. Hydrates type-specific top-level fields (`model`, `input_tokens`,\n *      `output_tokens`, `total_tokens`, `context_segments`) onto `SpanData`.\n *   5. Returns the `SpanHandle` so callers can later call `.end(err?)`.\n *\n * All helpers are wrapped in `absorbErrorsSync` — telemetry MUST NOT throw\n * at the caller. If `startSpan` returns `null` (no active trace), the\n * helper also returns `null`; callers must tolerate this case.\n *\n * Logical → wire `type` mapping (per `design.md` §Span schema):\n *\n *   agent     → \"agent\"\n *   llm       → \"llm\"\n *   tool      → \"tool\"\n *   subagent  → \"agent\" + metadata.spawn_kind = \"subagent\"\n *   hook      → \"tool\"  + metadata.tool_kind  = \"hook\"\n *\n * Adapter-flavoured redaction (tool-arg truncation, base64/image\n * stripping) lives in a sibling `redaction.ts` (W1.2). This file is\n * intentionally agnostic: the only redaction it applies is a minimal\n * string-length guard on free-form fields that would otherwise blow up\n * the wire payload (task descriptions, hook names, tool names).\n */\n\nimport { absorbErrorsSync } from \"../_internal/errors\";\nimport type { ContextSegment, SpanData } from \"../_internal/spans\";\nimport { startSpan, type SpanHandle } from \"../_internal/tracing\";\n\n/* ------------------------------------------------------------------------ */\n/*  Public types                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport type AdapterName = \"anthropic-agent-sdk\" | \"openai-agents\" | \"langgraph-js\" | \"vercel-ai\";\n\n/** Soft cap for free-form identifier-ish strings (tool names, hook names, etc.). */\nconst MAX_NAME_BYTES = 256;\n\n/** Soft cap for free-form description strings (task descriptions). */\nconst MAX_DESCRIPTION_BYTES = 2048;\n\n/** Trim a string to `maxBytes` bytes (UTF-8 codepoint-safe at the JS-string level). */\nfunction truncate(value: string, maxBytes: number): string {\n  if (value.length <= maxBytes) return value;\n  return `${value.slice(0, maxBytes)}…[truncated]`;\n}\n\nfunction requireNonEmpty(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    throw new Error(`morse span-emitter: ${field} must be a non-empty string`);\n  }\n  return value;\n}\n\n/* ------------------------------------------------------------------------ */\n/*  emitAgentSpan                                                            */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitAgentSpanOptions {\n  adapter: AdapterName;\n  agentName: string;\n  model?: string;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitAgentSpan = (opts: EmitAgentSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const agentName = requireNonEmpty(opts.agentName, \"agentName\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    agent_name: agentName,\n  };\n  const handle = startSpan({\n    name: `${adapter}.agent`,\n    type: \"agent\",\n    metadata,\n  });\n  if (handle === null) return null;\n  if (typeof opts.model === \"string\" && opts.model.length > 0) {\n    handle.span.model = opts.model;\n    metadata.model = opts.model;\n  }\n  return handle;\n};\n\n/**\n * Emit a wire `type=agent` span. Returns `null` when no active trace exists\n * (callers MUST tolerate this); never throws.\n */\nexport const emitAgentSpan: (opts: EmitAgentSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitAgentSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitAgentSpan\",\n  },\n) as (opts: EmitAgentSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitLlmSpan                                                              */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitLlmSpanOptions {\n  adapter: AdapterName;\n  model: string;\n  provider?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n  contextSegments?: ContextSegment[];\n  attributes?: Record<string, unknown>;\n  // MHQ-858: prompt/response capture. Adapters pass already-truncated\n  // values (see `_internal/llm-io.ts`); this emitter does not truncate.\n  inputData?: unknown;\n  outputData?: unknown;\n}\n\nconst _emitLlmSpan = (opts: EmitLlmSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const model = requireNonEmpty(opts.model, \"model\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    model,\n  };\n  if (typeof opts.provider === \"string\" && opts.provider.length > 0) {\n    metadata.provider = opts.provider;\n  }\n  const handle = startSpan({\n    name: `${adapter}.llm`,\n    type: \"llm\",\n    metadata,\n  });\n  if (handle === null) return null;\n  const span: SpanData = handle.span;\n  span.model = model;\n  if (typeof opts.inputTokens === \"number\" && Number.isFinite(opts.inputTokens)) {\n    span.input_tokens = opts.inputTokens;\n  }\n  if (typeof opts.outputTokens === \"number\" && Number.isFinite(opts.outputTokens)) {\n    span.output_tokens = opts.outputTokens;\n  }\n  if (typeof opts.totalTokens === \"number\" && Number.isFinite(opts.totalTokens)) {\n    span.total_tokens = opts.totalTokens;\n  } else if (span.input_tokens !== undefined && span.output_tokens !== undefined) {\n    span.total_tokens = span.input_tokens + span.output_tokens;\n  }\n  if (Array.isArray(opts.contextSegments)) {\n    span.context_segments = opts.contextSegments;\n  }\n  if (opts.inputData !== undefined) span.input_data = opts.inputData;\n  if (opts.outputData !== undefined) span.output_data = opts.outputData;\n  return handle;\n};\n\n/**\n * Emit a wire `type=llm` span. Returns `null` when no active trace exists;\n * never throws. Hydrates `model`, `input_tokens`, `output_tokens`,\n * `total_tokens` (derived if absent), and `context_segments` onto the\n * underlying `SpanData` so downstream consumers see them at the top level\n * — not buried in `metadata`.\n */\nexport const emitLlmSpan: (opts: EmitLlmSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitLlmSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitLlmSpan\",\n  },\n) as (opts: EmitLlmSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitToolSpan                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitToolSpanOptions {\n  adapter: AdapterName;\n  toolName: string;\n  inputSummary?: unknown;\n  outputSummary?: unknown;\n  durationMs?: number;\n  success?: boolean;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitToolSpan = (opts: EmitToolSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const toolName = truncate(requireNonEmpty(opts.toolName, \"toolName\"), MAX_NAME_BYTES);\n  const tool: Record<string, unknown> = { name: toolName };\n  if (opts.inputSummary !== undefined) tool.input_summary = opts.inputSummary;\n  if (opts.outputSummary !== undefined) tool.output_summary = opts.outputSummary;\n  if (typeof opts.durationMs === \"number\" && Number.isFinite(opts.durationMs)) {\n    tool.duration_ms = opts.durationMs;\n  }\n  if (typeof opts.success === \"boolean\") tool.success = opts.success;\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    tool,\n  };\n  return startSpan({\n    name: `${adapter}.tool.${toolName}`,\n    type: \"tool\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=tool` span. Returns `null` when no active trace exists;\n * never throws.\n */\nexport const emitToolSpan: (opts: EmitToolSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitToolSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitToolSpan\",\n  },\n) as (opts: EmitToolSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitSubagentSpan                                                         */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitSubagentSpanOptions {\n  adapter: AdapterName;\n  parentAgentName: string;\n  subagentName: string;\n  taskDescription?: string;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitSubagentSpan = (opts: EmitSubagentSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const parentAgentName = requireNonEmpty(opts.parentAgentName, \"parentAgentName\");\n  const subagentName = requireNonEmpty(opts.subagentName, \"subagentName\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    spawn_kind: \"subagent\",\n    parent_agent_name: parentAgentName,\n    subagent_name: subagentName,\n  };\n  if (typeof opts.taskDescription === \"string\" && opts.taskDescription.length > 0) {\n    metadata.task_description = truncate(opts.taskDescription, MAX_DESCRIPTION_BYTES);\n  }\n  return startSpan({\n    name: `${adapter}.subagent.${subagentName}`,\n    type: \"agent\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=agent` span with `metadata.spawn_kind=\"subagent\"` — the\n * UI inspects this metadata key to render subagent-spawn relationships\n * until the backend gains a native `subagent` enum value. Returns `null`\n * when no active trace exists; never throws.\n */\nexport const emitSubagentSpan: (opts: EmitSubagentSpanOptions) => SpanHandle | null =\n  absorbErrorsSync(_emitSubagentSpan, {\n    fingerprint: \"morse.adapters.shared.emitSubagentSpan\",\n  }) as (opts: EmitSubagentSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitHookSpan                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitHookSpanOptions {\n  adapter: AdapterName;\n  hookName: string;\n  hookKind: \"pre_tool\" | \"post_tool\" | \"on_error\";\n  durationMs?: number;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitHookSpan = (opts: EmitHookSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const hookName = truncate(requireNonEmpty(opts.hookName, \"hookName\"), MAX_NAME_BYTES);\n  const hookKind = opts.hookKind;\n  if (hookKind !== \"pre_tool\" && hookKind !== \"post_tool\" && hookKind !== \"on_error\") {\n    throw new Error(\n      `morse span-emitter: hookKind must be one of pre_tool|post_tool|on_error (got ${String(\n        hookKind,\n      )})`,\n    );\n  }\n  const hook: Record<string, unknown> = { name: hookName, kind: hookKind };\n  if (typeof opts.durationMs === \"number\" && Number.isFinite(opts.durationMs)) {\n    hook.duration_ms = opts.durationMs;\n  }\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    tool_kind: \"hook\",\n    hook,\n  };\n  return startSpan({\n    name: `${adapter}.hook.${hookKind}.${hookName}`,\n    type: \"tool\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=tool` span with `metadata.tool_kind=\"hook\"` — the UI\n * inspects this metadata key to render hook spans separately from regular\n * tool spans. Returns `null` when no active trace exists; never throws.\n */\nexport const emitHookSpan: (opts: EmitHookSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitHookSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitHookSpan\",\n  },\n) as (opts: EmitHookSpanOptions) => SpanHandle | null;\n"]}

package/dist/browser/{chunk-EFUQVASI.cjs → chunk-5EFKNOO7.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk3BGG7GH3_cjs = require('./chunk-3BGG7GH3.cjs');
-var chunkDXWHT3HK_cjs = require('./chunk-DXWHT3HK.cjs');
+var chunkFNZWJU64_cjs = require('./chunk-FNZWJU64.cjs');
+var chunkZGYZZCUK_cjs = require('./chunk-ZGYZZCUK.cjs');
 
 // src/_agent-sdk-common/span-emitter.ts
-chunkDXWHT3HK_cjs.init_tracing();
+chunkZGYZZCUK_cjs.init_tracing();
 var MAX_NAME_BYTES = 256;
 var MAX_DESCRIPTION_BYTES = 2048;
 function truncate(value, maxBytes) {
@@ -25,7 +25,7 @@ var _emitAgentSpan = (opts) => {
     adapter,
     agent_name: agentName
   };
-  const handle = chunkDXWHT3HK_cjs.startSpan({
+  const handle = chunkZGYZZCUK_cjs.startSpan({
     name: `${adapter}.agent`,
     type: "agent",
     metadata
@@ -37,7 +37,7 @@ var _emitAgentSpan = (opts) => {
   }
   return handle;
 };
-var emitAgentSpan = chunk3BGG7GH3_cjs.absorbErrorsSync(
+var emitAgentSpan = chunkFNZWJU64_cjs.absorbErrorsSync(
   _emitAgentSpan,
   {
     fingerprint: "morse.adapters.shared.emitAgentSpan"
@@ -54,7 +54,7 @@ var _emitLlmSpan = (opts) => {
   if (typeof opts.provider === "string" && opts.provider.length > 0) {
     metadata.provider = opts.provider;
   }
-  const handle = chunkDXWHT3HK_cjs.startSpan({
+  const handle = chunkZGYZZCUK_cjs.startSpan({
     name: `${adapter}.llm`,
     type: "llm",
     metadata
@@ -76,9 +76,11 @@ var _emitLlmSpan = (opts) => {
   if (Array.isArray(opts.contextSegments)) {
     span.context_segments = opts.contextSegments;
   }
+  if (opts.inputData !== void 0) span.input_data = opts.inputData;
+  if (opts.outputData !== void 0) span.output_data = opts.outputData;
   return handle;
 };
-var emitLlmSpan = chunk3BGG7GH3_cjs.absorbErrorsSync(
+var emitLlmSpan = chunkFNZWJU64_cjs.absorbErrorsSync(
   _emitLlmSpan,
   {
     fingerprint: "morse.adapters.shared.emitLlmSpan"
@@ -99,13 +101,13 @@ var _emitToolSpan = (opts) => {
     adapter,
     tool
   };
-  return chunkDXWHT3HK_cjs.startSpan({
+  return chunkZGYZZCUK_cjs.startSpan({
     name: `${adapter}.tool.${toolName}`,
     type: "tool",
     metadata
   });
 };
-var emitToolSpan = chunk3BGG7GH3_cjs.absorbErrorsSync(
+var emitToolSpan = chunkFNZWJU64_cjs.absorbErrorsSync(
   _emitToolSpan,
   {
     fingerprint: "morse.adapters.shared.emitToolSpan"
@@ -125,13 +127,13 @@ var _emitSubagentSpan = (opts) => {
   if (typeof opts.taskDescription === "string" && opts.taskDescription.length > 0) {
     metadata.task_description = truncate(opts.taskDescription, MAX_DESCRIPTION_BYTES);
   }
-  return chunkDXWHT3HK_cjs.startSpan({
+  return chunkZGYZZCUK_cjs.startSpan({
     name: `${adapter}.subagent.${subagentName}`,
     type: "agent",
     metadata
   });
 };
-var emitSubagentSpan = chunk3BGG7GH3_cjs.absorbErrorsSync(_emitSubagentSpan, {
+var emitSubagentSpan = chunkFNZWJU64_cjs.absorbErrorsSync(_emitSubagentSpan, {
   fingerprint: "morse.adapters.shared.emitSubagentSpan"
 });
 var _emitHookSpan = (opts) => {
@@ -155,13 +157,13 @@ var _emitHookSpan = (opts) => {
     tool_kind: "hook",
     hook
   };
-  return chunkDXWHT3HK_cjs.startSpan({
+  return chunkZGYZZCUK_cjs.startSpan({
     name: `${adapter}.hook.${hookKind}.${hookName}`,
     type: "tool",
     metadata
   });
 };
-var emitHookSpan = chunk3BGG7GH3_cjs.absorbErrorsSync(
+var emitHookSpan = chunkFNZWJU64_cjs.absorbErrorsSync(
   _emitHookSpan,
   {
     fingerprint: "morse.adapters.shared.emitHookSpan"
@@ -173,5 +175,5 @@ exports.emitHookSpan = emitHookSpan;
 exports.emitLlmSpan = emitLlmSpan;
 exports.emitSubagentSpan = emitSubagentSpan;
 exports.emitToolSpan = emitToolSpan;
-//# sourceMappingURL=chunk-EFUQVASI.cjs.map
-//# sourceMappingURL=chunk-EFUQVASI.cjs.map
+//# sourceMappingURL=chunk-5EFKNOO7.cjs.map
+//# sourceMappingURL=chunk-5EFKNOO7.cjs.map

package/dist/browser/chunk-5EFKNOO7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/_agent-sdk-common/span-emitter.ts"],"names":["init_tracing","startSpan","absorbErrorsSync"],"mappings":"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","file":"chunk-5EFKNOO7.cjs","sourcesContent":["/**\n * `_agent-sdk-common/span-emitter.ts` — shared span-emission helpers used by\n * all three agent-SDK adapters (`anthropic-agent-sdk`, `openai-agents`,\n * `langgraph-js`).\n *\n * Each helper:\n *\n *   1. Validates the required metadata for its logical span type.\n *   2. Calls `startSpan(...)` from `_internal/tracing.ts` to allocate the\n *      wire-format span and push it onto the active trace's span stack.\n *   3. Tags `metadata.adapter` on every span so the UI can attribute spans\n *      back to their adapter origin.\n *   4. Hydrates type-specific top-level fields (`model`, `input_tokens`,\n *      `output_tokens`, `total_tokens`, `context_segments`) onto `SpanData`.\n *   5. Returns the `SpanHandle` so callers can later call `.end(err?)`.\n *\n * All helpers are wrapped in `absorbErrorsSync` — telemetry MUST NOT throw\n * at the caller. If `startSpan` returns `null` (no active trace), the\n * helper also returns `null`; callers must tolerate this case.\n *\n * Logical → wire `type` mapping (per `design.md` §Span schema):\n *\n *   agent     → \"agent\"\n *   llm       → \"llm\"\n *   tool      → \"tool\"\n *   subagent  → \"agent\" + metadata.spawn_kind = \"subagent\"\n *   hook      → \"tool\"  + metadata.tool_kind  = \"hook\"\n *\n * Adapter-flavoured redaction (tool-arg truncation, base64/image\n * stripping) lives in a sibling `redaction.ts` (W1.2). This file is\n * intentionally agnostic: the only redaction it applies is a minimal\n * string-length guard on free-form fields that would otherwise blow up\n * the wire payload (task descriptions, hook names, tool names).\n */\n\nimport { absorbErrorsSync } from \"../_internal/errors\";\nimport type { ContextSegment, SpanData } from \"../_internal/spans\";\nimport { startSpan, type SpanHandle } from \"../_internal/tracing\";\n\n/* ------------------------------------------------------------------------ */\n/*  Public types                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport type AdapterName = \"anthropic-agent-sdk\" | \"openai-agents\" | \"langgraph-js\" | \"vercel-ai\";\n\n/** Soft cap for free-form identifier-ish strings (tool names, hook names, etc.). */\nconst MAX_NAME_BYTES = 256;\n\n/** Soft cap for free-form description strings (task descriptions). */\nconst MAX_DESCRIPTION_BYTES = 2048;\n\n/** Trim a string to `maxBytes` bytes (UTF-8 codepoint-safe at the JS-string level). */\nfunction truncate(value: string, maxBytes: number): string {\n  if (value.length <= maxBytes) return value;\n  return `${value.slice(0, maxBytes)}…[truncated]`;\n}\n\nfunction requireNonEmpty(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    throw new Error(`morse span-emitter: ${field} must be a non-empty string`);\n  }\n  return value;\n}\n\n/* ------------------------------------------------------------------------ */\n/*  emitAgentSpan                                                            */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitAgentSpanOptions {\n  adapter: AdapterName;\n  agentName: string;\n  model?: string;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitAgentSpan = (opts: EmitAgentSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const agentName = requireNonEmpty(opts.agentName, \"agentName\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    agent_name: agentName,\n  };\n  const handle = startSpan({\n    name: `${adapter}.agent`,\n    type: \"agent\",\n    metadata,\n  });\n  if (handle === null) return null;\n  if (typeof opts.model === \"string\" && opts.model.length > 0) {\n    handle.span.model = opts.model;\n    metadata.model = opts.model;\n  }\n  return handle;\n};\n\n/**\n * Emit a wire `type=agent` span. Returns `null` when no active trace exists\n * (callers MUST tolerate this); never throws.\n */\nexport const emitAgentSpan: (opts: EmitAgentSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitAgentSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitAgentSpan\",\n  },\n) as (opts: EmitAgentSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitLlmSpan                                                              */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitLlmSpanOptions {\n  adapter: AdapterName;\n  model: string;\n  provider?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n  contextSegments?: ContextSegment[];\n  attributes?: Record<string, unknown>;\n  // MHQ-858: prompt/response capture. Adapters pass already-truncated\n  // values (see `_internal/llm-io.ts`); this emitter does not truncate.\n  inputData?: unknown;\n  outputData?: unknown;\n}\n\nconst _emitLlmSpan = (opts: EmitLlmSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const model = requireNonEmpty(opts.model, \"model\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    model,\n  };\n  if (typeof opts.provider === \"string\" && opts.provider.length > 0) {\n    metadata.provider = opts.provider;\n  }\n  const handle = startSpan({\n    name: `${adapter}.llm`,\n    type: \"llm\",\n    metadata,\n  });\n  if (handle === null) return null;\n  const span: SpanData = handle.span;\n  span.model = model;\n  if (typeof opts.inputTokens === \"number\" && Number.isFinite(opts.inputTokens)) {\n    span.input_tokens = opts.inputTokens;\n  }\n  if (typeof opts.outputTokens === \"number\" && Number.isFinite(opts.outputTokens)) {\n    span.output_tokens = opts.outputTokens;\n  }\n  if (typeof opts.totalTokens === \"number\" && Number.isFinite(opts.totalTokens)) {\n    span.total_tokens = opts.totalTokens;\n  } else if (span.input_tokens !== undefined && span.output_tokens !== undefined) {\n    span.total_tokens = span.input_tokens + span.output_tokens;\n  }\n  if (Array.isArray(opts.contextSegments)) {\n    span.context_segments = opts.contextSegments;\n  }\n  if (opts.inputData !== undefined) span.input_data = opts.inputData;\n  if (opts.outputData !== undefined) span.output_data = opts.outputData;\n  return handle;\n};\n\n/**\n * Emit a wire `type=llm` span. Returns `null` when no active trace exists;\n * never throws. Hydrates `model`, `input_tokens`, `output_tokens`,\n * `total_tokens` (derived if absent), and `context_segments` onto the\n * underlying `SpanData` so downstream consumers see them at the top level\n * — not buried in `metadata`.\n */\nexport const emitLlmSpan: (opts: EmitLlmSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitLlmSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitLlmSpan\",\n  },\n) as (opts: EmitLlmSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitToolSpan                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitToolSpanOptions {\n  adapter: AdapterName;\n  toolName: string;\n  inputSummary?: unknown;\n  outputSummary?: unknown;\n  durationMs?: number;\n  success?: boolean;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitToolSpan = (opts: EmitToolSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const toolName = truncate(requireNonEmpty(opts.toolName, \"toolName\"), MAX_NAME_BYTES);\n  const tool: Record<string, unknown> = { name: toolName };\n  if (opts.inputSummary !== undefined) tool.input_summary = opts.inputSummary;\n  if (opts.outputSummary !== undefined) tool.output_summary = opts.outputSummary;\n  if (typeof opts.durationMs === \"number\" && Number.isFinite(opts.durationMs)) {\n    tool.duration_ms = opts.durationMs;\n  }\n  if (typeof opts.success === \"boolean\") tool.success = opts.success;\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    tool,\n  };\n  return startSpan({\n    name: `${adapter}.tool.${toolName}`,\n    type: \"tool\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=tool` span. Returns `null` when no active trace exists;\n * never throws.\n */\nexport const emitToolSpan: (opts: EmitToolSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitToolSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitToolSpan\",\n  },\n) as (opts: EmitToolSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitSubagentSpan                                                         */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitSubagentSpanOptions {\n  adapter: AdapterName;\n  parentAgentName: string;\n  subagentName: string;\n  taskDescription?: string;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitSubagentSpan = (opts: EmitSubagentSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const parentAgentName = requireNonEmpty(opts.parentAgentName, \"parentAgentName\");\n  const subagentName = requireNonEmpty(opts.subagentName, \"subagentName\");\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    spawn_kind: \"subagent\",\n    parent_agent_name: parentAgentName,\n    subagent_name: subagentName,\n  };\n  if (typeof opts.taskDescription === \"string\" && opts.taskDescription.length > 0) {\n    metadata.task_description = truncate(opts.taskDescription, MAX_DESCRIPTION_BYTES);\n  }\n  return startSpan({\n    name: `${adapter}.subagent.${subagentName}`,\n    type: \"agent\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=agent` span with `metadata.spawn_kind=\"subagent\"` — the\n * UI inspects this metadata key to render subagent-spawn relationships\n * until the backend gains a native `subagent` enum value. Returns `null`\n * when no active trace exists; never throws.\n */\nexport const emitSubagentSpan: (opts: EmitSubagentSpanOptions) => SpanHandle | null =\n  absorbErrorsSync(_emitSubagentSpan, {\n    fingerprint: \"morse.adapters.shared.emitSubagentSpan\",\n  }) as (opts: EmitSubagentSpanOptions) => SpanHandle | null;\n\n/* ------------------------------------------------------------------------ */\n/*  emitHookSpan                                                             */\n/* ------------------------------------------------------------------------ */\n\nexport interface EmitHookSpanOptions {\n  adapter: AdapterName;\n  hookName: string;\n  hookKind: \"pre_tool\" | \"post_tool\" | \"on_error\";\n  durationMs?: number;\n  attributes?: Record<string, unknown>;\n}\n\nconst _emitHookSpan = (opts: EmitHookSpanOptions): SpanHandle | null => {\n  const adapter = requireNonEmpty(opts.adapter, \"adapter\");\n  const hookName = truncate(requireNonEmpty(opts.hookName, \"hookName\"), MAX_NAME_BYTES);\n  const hookKind = opts.hookKind;\n  if (hookKind !== \"pre_tool\" && hookKind !== \"post_tool\" && hookKind !== \"on_error\") {\n    throw new Error(\n      `morse span-emitter: hookKind must be one of pre_tool|post_tool|on_error (got ${String(\n        hookKind,\n      )})`,\n    );\n  }\n  const hook: Record<string, unknown> = { name: hookName, kind: hookKind };\n  if (typeof opts.durationMs === \"number\" && Number.isFinite(opts.durationMs)) {\n    hook.duration_ms = opts.durationMs;\n  }\n  const metadata: Record<string, unknown> = {\n    ...(opts.attributes ?? {}),\n    adapter,\n    tool_kind: \"hook\",\n    hook,\n  };\n  return startSpan({\n    name: `${adapter}.hook.${hookKind}.${hookName}`,\n    type: \"tool\",\n    metadata,\n  });\n};\n\n/**\n * Emit a wire `type=tool` span with `metadata.tool_kind=\"hook\"` — the UI\n * inspects this metadata key to render hook spans separately from regular\n * tool spans. Returns `null` when no active trace exists; never throws.\n */\nexport const emitHookSpan: (opts: EmitHookSpanOptions) => SpanHandle | null = absorbErrorsSync(\n  _emitHookSpan,\n  {\n    fingerprint: \"morse.adapters.shared.emitHookSpan\",\n  },\n) as (opts: EmitHookSpanOptions) => SpanHandle | null;\n"]}

package/dist/browser/{chunk-DOLWR7LD.js → chunk-5IWGFPKQ.js}

@@ -1,5 +1,5 @@
-import { absorbErrorsSync } from './chunk-YHV5GL32.js';
-import { init_redaction, init_tracing, getTransport, getActiveTraceState, getRedactionConfig, redactValue } from './chunk-F3B4UR64.js';
+import { absorbErrorsSync } from './chunk-VFNNU3AX.js';
+import { init_redaction, init_tracing, getTransport, getActiveTraceState, getRedactionConfig, redactValue } from './chunk-6DOP3MTY.js';
 
 // src/log.ts
 init_redaction();
@@ -49,5 +49,5 @@ var log = absorbErrorsSync(logImpl, {
 });
 
 export { _setEnsureInitialized, log };
-//# sourceMappingURL=chunk-DOLWR7LD.js.map
-//# sourceMappingURL=chunk-DOLWR7LD.js.map
+//# sourceMappingURL=chunk-5IWGFPKQ.js.map
+//# sourceMappingURL=chunk-5IWGFPKQ.js.map

package/dist/browser/{chunk-DOLWR7LD.js.map → chunk-5IWGFPKQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/log.ts"],"names":[],"mappings":";;;;AA8BA,cAAA,EAAA;AACA,YAAA,EAAA;AA2BA,IAAM,oBAAA,GAAuB,cAAA;AAS7B,IAAI,oBAAgC,MAAM;AAE1C,CAAA;AAGO,SAAS,sBAAsB,EAAA,EAAsB;AAC1D,EAAA,iBAAA,GAAoB,EAAA;AACtB;AAEA,SAAS,OAAA,CAAQ,OAAA,EAAiB,OAAA,GAAsB,EAAC,EAAS;AAGhE,EAAA,iBAAA,EAAkB;AAClB,EAAA,MAAM,YAAkC,YAAA,EAAa;AACrD,EAAA,IAAI,cAAc,IAAA,EAAM;AAGtB,IAAA;AAAA,EACF;AAMA,EAAA,IAAI,OAAA,GAAyB,QAAQ,OAAA,IAAW,IAAA;AAChD,EAAA,IAAI,MAAA,GAAwB,QAAQ,MAAA,IAAU,IAAA;AAC9C,EAAA,IAAI,OAAA,KAAY,IAAA,IAAQ,MAAA,KAAW,IAAA,EAAM;AACvC,IAAA,MAAM,QAAQ,mBAAA,EAAoB;AAClC,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,IAAI,OAAA,KAAY,IAAA,EAAM,OAAA,GAAU,KAAA,CAAM,OAAA;AACtC,MAAA,IAAI,MAAA,KAAW,IAAA,IAAQ,KAAA,CAAM,SAAA,CAAU,SAAS,CAAA,EAAG;AACjD,QAAA,MAAA,GAAS,MAAM,SAAA,CAAU,KAAA,CAAM,SAAA,CAAU,MAAA,GAAS,CAAC,CAAA,CAAG,OAAA;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAA,CAAY,OAAA,CAAQ,QAAA,IAAY,MAAA,EAAQ,WAAA,EAAY;AAC1D,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,oBAAA;AAK3C,EAAA,MAAM,SAAS,kBAAA,EAAmB;AAClC,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,UAAA,IAAc,EAAC;AAC7C,EAAA,MAAM,qBAAqB,MAAA,CAAO,OAAA,GAC7B,WAAA,CAAY,aAAA,EAAe,MAAM,CAAA,GAClC,aAAA;AACJ,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,GACvB,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA,EAAG,MAAM,CAAA,GACpC,MAAA,CAAO,OAAO,CAAA;AAElB,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,IAClC,QAAA;AAAA,IACA,YAAA,EAAc,WAAA;AAAA,IACd,IAAA,EAAM,YAAA;AAAA,IACN,UAAA,EAAY,kBAAA;AAAA,IACZ,QAAA,EAAU,OAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAEA,EAAA,SAAA,CAAU,MAAM,EAAE,IAAA,EAAM,CAAC,MAAM,GAAG,CAAA;AACpC;AAmCO,IAAM,GAAA,GAAM,iBAAiB,OAAA,EAAS;AAAA,EAC3C,WAAA,EAAa;AACf,CAAC","file":"chunk-DOLWR7LD.js","sourcesContent":["/**\n * Phase 12.5 Tier 1.2 — TypeScript SDK `log()` export.\n *\n * Closes the TS side of Feature #4 \"Gap A\": before this module, customers\n * using the TS SDK had no way to populate the Logs tab of a trace's\n * Correlation panel without standing up their own OTel collector. The\n * Python SDK already had `morse.log(...)` (AGE-240); this is the\n * cross-language peer.\n *\n * Semantics mirror Python's `morse.log()`\n * (`apps/sdk/python/src/morse/__init__.py:360-411`):\n *\n *   - Default severity: \"info\" (case-normalised to upper on the wire).\n *   - Default service_name: \"morse-sdk-ts\" (overridable).\n *   - Auto-reads the active trace_id + span_id from the SDK's existing\n *     `node:async_hooks.AsyncLocalStorage` context (re-uses\n *     `getActiveTraceState()` — the same primitive `run()`/`span()` use).\n *   - Batched: the record is enqueued on the existing `BatchTransport`,\n *     which flushes it to `/api/v1/logs/ingest` (derived from the traces\n *     batch endpoint) on the next tick. NO synchronous fetch per call.\n *   - Internal errors are absorbed via `absorbErrorsSync` so they never\n *     propagate into the customer's logging call. Mirrors the Python\n *     `@absorb_errors` decorator pattern.\n *\n * Wire shape: `{ logs: [{ timestamp, severity, service_name, body,\n * attributes, trace_id, span_id }] }`. See `apps/api/apps/logs/\n * controllers.py:66-134` for the API contract.\n */\n\nimport { absorbErrorsSync } from \"./_internal/errors\";\nimport { redactValue } from \"./_internal/redaction\";\nimport {\n  getActiveTraceState,\n  getRedactionConfig,\n  getTransport,\n  type TransportLike,\n} from \"./_internal/tracing\";\n\n/** Log severity — case-insensitive on input, upper-cased on the wire. */\nexport type LogSeverity = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\n/** Options accepted by `log()`. */\nexport interface LogOptions {\n  /** Default: `\"info\"`. Upper-cased server-side. */\n  severity?: LogSeverity;\n  /** Free-form structured fields persisted on the record. */\n  attributes?: Record<string, unknown>;\n  /**\n   * Override the auto-detected trace_id. Use only when emitting on\n   * behalf of a known external trace (rare).\n   */\n  traceId?: string;\n  /** Override the auto-detected span_id. Same caveat as `traceId`. */\n  spanId?: string;\n  /** Logical service tag. Default: `\"morse-sdk-ts\"`. */\n  serviceName?: string;\n}\n\nconst DEFAULT_SERVICE_NAME = \"morse-sdk-ts\";\n\n/**\n * Lazy-init hook injected by `index.ts`. Allows `log()` to participate\n * in env-driven auto-init (matching the behaviour of `track()` /\n * `record()`) without `log.ts` reaching into the singleton state.\n *\n * @internal\n */\nlet ensureInitialized: () => void = () => {\n  /* default no-op; replaced from index.ts */\n};\n\n/** @internal */\nexport function _setEnsureInitialized(fn: () => void): void {\n  ensureInitialized = fn;\n}\n\nfunction logImpl(message: string, options: LogOptions = {}): void {\n  // Match Python semantics: env-driven auto-init kicks in if the SDK\n  // hasn't been explicitly init()'d yet but MORSE_API_KEY is set.\n  ensureInitialized();\n  const transport: TransportLike | null = getTransport();\n  if (transport === null) {\n    // SDK not initialised — silent no-op. Matches Python behaviour\n    // (`_ensure_initialized()` short-circuit).\n    return;\n  }\n\n  // Auto-pull trace + span IDs from the active context. Re-uses the\n  // exact same context primitive that `track()` / `run()` / `span()`\n  // use, so a `log()` call inside an `await run(...)` callback will\n  // see the active trace's IDs.\n  let traceId: string | null = options.traceId ?? null;\n  let spanId: string | null = options.spanId ?? null;\n  if (traceId === null || spanId === null) {\n    const state = getActiveTraceState();\n    if (state !== null) {\n      if (traceId === null) traceId = state.traceId;\n      if (spanId === null && state.spanStack.length > 0) {\n        spanId = state.spanStack[state.spanStack.length - 1]!.span_id;\n      }\n    }\n  }\n\n  const severity = (options.severity ?? \"info\").toUpperCase();\n  const serviceName = options.serviceName ?? DEFAULT_SERVICE_NAME;\n\n  // PII redaction reuses the trace path's allow-list config. Mirrors\n  // the Python client's `self._redaction_config.redact_value(payload)`\n  // call.\n  const config = getRedactionConfig();\n  const rawAttributes = options.attributes ?? {};\n  const redactedAttributes = config.enabled\n    ? (redactValue(rawAttributes, config) as Record<string, unknown>)\n    : rawAttributes;\n  const redactedBody = config.enabled\n    ? (redactValue(String(message), config) as string)\n    : String(message);\n\n  const record = {\n    timestamp: new Date().toISOString(),\n    severity,\n    service_name: serviceName,\n    body: redactedBody,\n    attributes: redactedAttributes,\n    trace_id: traceId,\n    span_id: spanId,\n  };\n\n  transport.track({ logs: [record] });\n}\n\n/**\n * Emit a log record correlated to the current trace context.\n *\n * Auto-correlates to the surrounding `morse.run()` /\n * `morse.span()` if one is active. Inside a trace, the record's\n * `trace_id` + `span_id` are filled in from `AsyncLocalStorage`;\n * outside a trace, both fields are `null` and the record is still\n * accepted by the backend (it surfaces in the service-wide Logs view\n * but not on any individual trace's Correlation panel).\n *\n * Non-blocking. Batched alongside trace events on the existing\n * transport — flushes at the SDK's configured interval (default 2s).\n * Internal errors are absorbed; this call never throws.\n *\n * Silent no-op when the SDK isn't initialised (no `MORSE_API_KEY`\n * and no explicit `init()` call).\n *\n * @example\n * ```ts\n * import { init, runTraced, log } from \"@morsehq-dev/sdk\";\n *\n * init({ apiKey: process.env.MORSE_API_KEY });\n *\n * await runTraced({ agentName: \"lead-qualifier\" }, async () => {\n *   log(\"starting search\", { attributes: { query: \"morse\" } });\n *   const results = await search();\n *   log(\"search complete\", {\n *     severity: \"info\",\n *     attributes: { result_count: results.length },\n *   });\n * });\n * ```\n */\nexport const log = absorbErrorsSync(logImpl, {\n  fingerprint: \"morse.log\",\n});\n"]}
+{"version":3,"sources":["../../src/log.ts"],"names":[],"mappings":";;;;AA8BA,cAAA,EAAA;AACA,YAAA,EAAA;AA2BA,IAAM,oBAAA,GAAuB,cAAA;AAS7B,IAAI,oBAAgC,MAAM;AAE1C,CAAA;AAGO,SAAS,sBAAsB,EAAA,EAAsB;AAC1D,EAAA,iBAAA,GAAoB,EAAA;AACtB;AAEA,SAAS,OAAA,CAAQ,OAAA,EAAiB,OAAA,GAAsB,EAAC,EAAS;AAGhE,EAAA,iBAAA,EAAkB;AAClB,EAAA,MAAM,YAAkC,YAAA,EAAa;AACrD,EAAA,IAAI,cAAc,IAAA,EAAM;AAGtB,IAAA;AAAA,EACF;AAMA,EAAA,IAAI,OAAA,GAAyB,QAAQ,OAAA,IAAW,IAAA;AAChD,EAAA,IAAI,MAAA,GAAwB,QAAQ,MAAA,IAAU,IAAA;AAC9C,EAAA,IAAI,OAAA,KAAY,IAAA,IAAQ,MAAA,KAAW,IAAA,EAAM;AACvC,IAAA,MAAM,QAAQ,mBAAA,EAAoB;AAClC,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,IAAI,OAAA,KAAY,IAAA,EAAM,OAAA,GAAU,KAAA,CAAM,OAAA;AACtC,MAAA,IAAI,MAAA,KAAW,IAAA,IAAQ,KAAA,CAAM,SAAA,CAAU,SAAS,CAAA,EAAG;AACjD,QAAA,MAAA,GAAS,MAAM,SAAA,CAAU,KAAA,CAAM,SAAA,CAAU,MAAA,GAAS,CAAC,CAAA,CAAG,OAAA;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAA,CAAY,OAAA,CAAQ,QAAA,IAAY,MAAA,EAAQ,WAAA,EAAY;AAC1D,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,oBAAA;AAK3C,EAAA,MAAM,SAAS,kBAAA,EAAmB;AAClC,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,UAAA,IAAc,EAAC;AAC7C,EAAA,MAAM,qBAAqB,MAAA,CAAO,OAAA,GAC7B,WAAA,CAAY,aAAA,EAAe,MAAM,CAAA,GAClC,aAAA;AACJ,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,GACvB,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA,EAAG,MAAM,CAAA,GACpC,MAAA,CAAO,OAAO,CAAA;AAElB,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,IAClC,QAAA;AAAA,IACA,YAAA,EAAc,WAAA;AAAA,IACd,IAAA,EAAM,YAAA;AAAA,IACN,UAAA,EAAY,kBAAA;AAAA,IACZ,QAAA,EAAU,OAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAEA,EAAA,SAAA,CAAU,MAAM,EAAE,IAAA,EAAM,CAAC,MAAM,GAAG,CAAA;AACpC;AAmCO,IAAM,GAAA,GAAM,iBAAiB,OAAA,EAAS;AAAA,EAC3C,WAAA,EAAa;AACf,CAAC","file":"chunk-5IWGFPKQ.js","sourcesContent":["/**\n * Phase 12.5 Tier 1.2 — TypeScript SDK `log()` export.\n *\n * Closes the TS side of Feature #4 \"Gap A\": before this module, customers\n * using the TS SDK had no way to populate the Logs tab of a trace's\n * Correlation panel without standing up their own OTel collector. The\n * Python SDK already had `morse.log(...)` (AGE-240); this is the\n * cross-language peer.\n *\n * Semantics mirror Python's `morse.log()`\n * (`apps/sdk/python/src/morse/__init__.py:360-411`):\n *\n *   - Default severity: \"info\" (case-normalised to upper on the wire).\n *   - Default service_name: \"morse-sdk-ts\" (overridable).\n *   - Auto-reads the active trace_id + span_id from the SDK's existing\n *     `node:async_hooks.AsyncLocalStorage` context (re-uses\n *     `getActiveTraceState()` — the same primitive `run()`/`span()` use).\n *   - Batched: the record is enqueued on the existing `BatchTransport`,\n *     which flushes it to `/api/v1/logs/ingest` (derived from the traces\n *     batch endpoint) on the next tick. NO synchronous fetch per call.\n *   - Internal errors are absorbed via `absorbErrorsSync` so they never\n *     propagate into the customer's logging call. Mirrors the Python\n *     `@absorb_errors` decorator pattern.\n *\n * Wire shape: `{ logs: [{ timestamp, severity, service_name, body,\n * attributes, trace_id, span_id }] }`. See `apps/api/apps/logs/\n * controllers.py:66-134` for the API contract.\n */\n\nimport { absorbErrorsSync } from \"./_internal/errors\";\nimport { redactValue } from \"./_internal/redaction\";\nimport {\n  getActiveTraceState,\n  getRedactionConfig,\n  getTransport,\n  type TransportLike,\n} from \"./_internal/tracing\";\n\n/** Log severity — case-insensitive on input, upper-cased on the wire. */\nexport type LogSeverity = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\n/** Options accepted by `log()`. */\nexport interface LogOptions {\n  /** Default: `\"info\"`. Upper-cased server-side. */\n  severity?: LogSeverity;\n  /** Free-form structured fields persisted on the record. */\n  attributes?: Record<string, unknown>;\n  /**\n   * Override the auto-detected trace_id. Use only when emitting on\n   * behalf of a known external trace (rare).\n   */\n  traceId?: string;\n  /** Override the auto-detected span_id. Same caveat as `traceId`. */\n  spanId?: string;\n  /** Logical service tag. Default: `\"morse-sdk-ts\"`. */\n  serviceName?: string;\n}\n\nconst DEFAULT_SERVICE_NAME = \"morse-sdk-ts\";\n\n/**\n * Lazy-init hook injected by `index.ts`. Allows `log()` to participate\n * in env-driven auto-init (matching the behaviour of `track()` /\n * `record()`) without `log.ts` reaching into the singleton state.\n *\n * @internal\n */\nlet ensureInitialized: () => void = () => {\n  /* default no-op; replaced from index.ts */\n};\n\n/** @internal */\nexport function _setEnsureInitialized(fn: () => void): void {\n  ensureInitialized = fn;\n}\n\nfunction logImpl(message: string, options: LogOptions = {}): void {\n  // Match Python semantics: env-driven auto-init kicks in if the SDK\n  // hasn't been explicitly init()'d yet but MORSE_API_KEY is set.\n  ensureInitialized();\n  const transport: TransportLike | null = getTransport();\n  if (transport === null) {\n    // SDK not initialised — silent no-op. Matches Python behaviour\n    // (`_ensure_initialized()` short-circuit).\n    return;\n  }\n\n  // Auto-pull trace + span IDs from the active context. Re-uses the\n  // exact same context primitive that `track()` / `run()` / `span()`\n  // use, so a `log()` call inside an `await run(...)` callback will\n  // see the active trace's IDs.\n  let traceId: string | null = options.traceId ?? null;\n  let spanId: string | null = options.spanId ?? null;\n  if (traceId === null || spanId === null) {\n    const state = getActiveTraceState();\n    if (state !== null) {\n      if (traceId === null) traceId = state.traceId;\n      if (spanId === null && state.spanStack.length > 0) {\n        spanId = state.spanStack[state.spanStack.length - 1]!.span_id;\n      }\n    }\n  }\n\n  const severity = (options.severity ?? \"info\").toUpperCase();\n  const serviceName = options.serviceName ?? DEFAULT_SERVICE_NAME;\n\n  // PII redaction reuses the trace path's allow-list config. Mirrors\n  // the Python client's `self._redaction_config.redact_value(payload)`\n  // call.\n  const config = getRedactionConfig();\n  const rawAttributes = options.attributes ?? {};\n  const redactedAttributes = config.enabled\n    ? (redactValue(rawAttributes, config) as Record<string, unknown>)\n    : rawAttributes;\n  const redactedBody = config.enabled\n    ? (redactValue(String(message), config) as string)\n    : String(message);\n\n  const record = {\n    timestamp: new Date().toISOString(),\n    severity,\n    service_name: serviceName,\n    body: redactedBody,\n    attributes: redactedAttributes,\n    trace_id: traceId,\n    span_id: spanId,\n  };\n\n  transport.track({ logs: [record] });\n}\n\n/**\n * Emit a log record correlated to the current trace context.\n *\n * Auto-correlates to the surrounding `morse.run()` /\n * `morse.span()` if one is active. Inside a trace, the record's\n * `trace_id` + `span_id` are filled in from `AsyncLocalStorage`;\n * outside a trace, both fields are `null` and the record is still\n * accepted by the backend (it surfaces in the service-wide Logs view\n * but not on any individual trace's Correlation panel).\n *\n * Non-blocking. Batched alongside trace events on the existing\n * transport — flushes at the SDK's configured interval (default 2s).\n * Internal errors are absorbed; this call never throws.\n *\n * Silent no-op when the SDK isn't initialised (no `MORSE_API_KEY`\n * and no explicit `init()` call).\n *\n * @example\n * ```ts\n * import { init, runTraced, log } from \"@morsehq-dev/sdk\";\n *\n * init({ apiKey: process.env.MORSE_API_KEY });\n *\n * await runTraced({ agentName: \"lead-qualifier\" }, async () => {\n *   log(\"starting search\", { attributes: { query: \"morse\" } });\n *   const results = await search();\n *   log(\"search complete\", {\n *     severity: \"info\",\n *     attributes: { result_count: results.length },\n *   });\n * });\n * ```\n */\nexport const log = absorbErrorsSync(logImpl, {\n  fingerprint: \"morse.log\",\n});\n"]}