neatlogs 1.0.4 → 1.0.6

package/dist/strands.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/strands.ts"],"sourcesContent":["/**\n * Neatlogs Strands Agents integration.\n *\n * Usage:\n *   import { init } from 'neatlogs';\n *   import { strandsHooks } from 'neatlogs/strands';\n *   import { Agent } from '@strands-agents/sdk';\n *\n *   await init({ apiKey, workflowName });\n *   const agent = strandsHooks(new Agent({ model }));\n *\n * Strands self-instruments via native OpenTelemetry (gen_ai.* spans for agent /\n * model / tool calls), which `init()` captures and the attribute mapper classifies\n * (kind, model, token counts).\n *\n * BUT Strands records prompt/response CONTENT as OTel span EVENTS\n * (gen_ai.user.message, gen_ai.system.message, gen_ai.choice, gen_ai.tool.message,\n * gen_ai.client.inference.operation.details) — not as span attributes. neatlogs\n * renders I/O from attributes, so without help those spans show tokens but EMPTY\n * input/output. `strandsHooks()` installs a single class-level hook on Strands'\n * own `Tracer._addEvent` chokepoint: after Strands records a message/choice event,\n * we also copy its content onto the span as input.value / output.value (+ the LLM\n * message attributes). We do NOT create spans — Strands' native tracing stays the\n * source of truth; we only enrich it. Mirrors the Python SDK's strands hook.\n */\n\nconst PATCH_FLAG = '_neatlogs_patched';\n\nexport function strandsHooks<T extends object>(agent: T): T {\n  // Each Strands Agent constructs its OWN private Tracer (`agent._tracer = new\n  // Tracer(...)`), and the Tracer class is NOT publicly exported — so we reach it\n  // through the agent instance and patch its `_addEvent` chokepoint. Patching the\n  // PROTOTYPE (reached via the instance) covers every agent sharing that class and\n  // is idempotent. This is the only access path: the package's exports map blocks\n  // deep imports and the top-level index doesn't export Tracer.\n  installEventHookFromAgent(agent);\n\n  if (agent && typeof agent === 'object') {\n    try {\n      Object.defineProperty(agent, PATCH_FLAG, {\n        value: true,\n        enumerable: false,\n        configurable: true,\n      });\n    } catch {\n      (agent as any)[PATCH_FLAG] = true;\n    }\n  }\n  return agent;\n}\n\nfunction installEventHookFromAgent(agent: any): void {\n  const tracer = agent?._tracer;\n  const proto = tracer ? Object.getPrototypeOf(tracer) : undefined;\n  if (!proto || typeof proto._addEvent !== 'function') return;\n  if (proto._addEvent[PATCH_FLAG]) return;\n\n  const orig = proto._addEvent;\n  function patchedAddEvent(this: any, span: any, eventName: string, eventAttributes?: Record<string, unknown>) {\n    const result = orig.call(this, span, eventName, eventAttributes);\n    try {\n      enrichSpanFromEvent(span, eventName, eventAttributes || {});\n    } catch {\n      // never break the agent run over tracing\n    }\n    return result;\n  }\n  (patchedAddEvent as any)[PATCH_FLAG] = true;\n  proto._addEvent = patchedAddEvent;\n}\n\nfunction enrichSpanFromEvent(\n  span: any,\n  eventName: string,\n  attrs: Record<string, unknown>,\n): void {\n  if (!span || typeof span.setAttribute !== 'function') return;\n  if (typeof span.isRecording === 'function' && !span.isRecording()) return;\n\n  // Classify from the span's own gen_ai.operation.name (set at creation): the same\n  // message/choice events fire on chat (LLM), execute_tool (TOOL) and agent spans.\n  // We don't set neatlogs.span.kind (the mapper does, from the span name); we only\n  // route I/O to the correct namespace so a {span_kind}-templated key isn't needed.\n  const isTool = readSpanOp(span) === 'execute_tool';\n\n  // Input-side messages: gen_ai.{system,user,assistant,tool}.message\n  if (eventName.startsWith('gen_ai.') && eventName.endsWith('.message')) {\n    const role = eventName.slice('gen_ai.'.length, -'.message'.length);\n    const content = flattenStrandsContent(attrs.content);\n    if (content) {\n      if (isTool) {\n        span.setAttribute('input.value', content);\n        span.setAttribute('neatlogs.tool.input', content);\n      } else {\n        appendInputMessage(span, role, content);\n      }\n    }\n    return;\n  }\n\n  // Output: legacy gen_ai.choice or the latest-convention details event.\n  if (eventName === 'gen_ai.choice') {\n    const out = flattenStrandsContent(attrs.message);\n    if (out) setOutput(span, isTool, out);\n    return;\n  }\n  if (eventName === 'gen_ai.client.inference.operation.details') {\n    const out = flattenStrandsContent(attrs['gen_ai.output.messages']);\n    if (out) setOutput(span, isTool, out);\n  }\n}\n\nfunction setOutput(span: any, isTool: boolean, out: string): void {\n  span.setAttribute('output.value', out);\n  if (isTool) {\n    span.setAttribute('neatlogs.tool.output', out);\n  } else {\n    span.setAttribute('neatlogs.llm.output_messages.0.role', 'assistant');\n    span.setAttribute('neatlogs.llm.output_messages.0.content', out);\n    span.setAttribute('neatlogs.llm.output', safeStringify({ role: 'assistant', content: out }));\n  }\n}\n\nfunction appendInputMessage(span: any, role: string, content: string): void {\n  const idx = (span.__neatlogs_in_idx as number) ?? 0;\n  span.setAttribute(`neatlogs.llm.input_messages.${idx}.role`, role);\n  span.setAttribute(`neatlogs.llm.input_messages.${idx}.content`, content);\n  span.__neatlogs_in_idx = idx + 1;\n  const existing: Array<{ role: string; content: string }> = span.__neatlogs_in_msgs ?? [];\n  existing.push({ role, content });\n  span.__neatlogs_in_msgs = existing;\n  const blob = safeStringify({ messages: existing });\n  span.setAttribute('input.value', blob);\n  // Flat LLM input the backend reads directly (no reliance on {span_kind} mapping).\n  span.setAttribute('neatlogs.llm.input', blob);\n}\n\nfunction readSpanOp(span: any): string {\n  // OTel spans don't expose attributes publicly; Strands' span objects carry them\n  // on `.attributes`. Best-effort read of gen_ai.operation.name.\n  try {\n    const a = span.attributes;\n    if (!a) return '';\n    const v = typeof a.get === 'function' ? a.get('gen_ai.operation.name') : a['gen_ai.operation.name'];\n    return typeof v === 'string' ? v.toLowerCase() : '';\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Strands event content arrives as a JSON string of content blocks\n * ([{text}], [{toolUse|toolResult}], or {role,parts,...}) or a plain string.\n */\nfunction flattenStrandsContent(content: unknown): string {\n  if (content == null) return '';\n  let val: unknown = content;\n  if (typeof val === 'string') {\n    const s = val.trim();\n    if (!(s.startsWith('[') || s.startsWith('{'))) return val; // already plain text\n    try {\n      val = JSON.parse(s);\n    } catch {\n      return val as string;\n    }\n  }\n  return flattenBlocks(val);\n}\n\nfunction flattenBlocks(val: unknown): string {\n  const items = Array.isArray(val) ? val : [val];\n  const out: string[] = [];\n  for (const item of items) {\n    if (typeof item === 'string') {\n      out.push(item);\n      continue;\n    }\n    if (!item || typeof item !== 'object') {\n      if (item != null) out.push(String(item));\n      continue;\n    }\n    const o = item as Record<string, any>;\n    if (typeof o.text === 'string') out.push(o.text);\n    else if (typeof o.content === 'string') out.push(o.content);\n    else if (o.toolUse) out.push(`${o.toolUse.name ?? 'tool'}(${safeStringify(o.toolUse.input ?? {})})`);\n    else if (o.toolResult) out.push(flattenBlocks(o.toolResult.content ?? o.toolResult));\n    else if (Array.isArray(o.parts)) out.push(flattenBlocks(o.parts));\n    else if (Array.isArray(o.content)) out.push(flattenBlocks(o.content));\n    else out.push(safeStringify(o));\n  }\n  return out.filter(Boolean).join('\\n');\n}\n\nfunction safeStringify(value: unknown): string {\n  if (typeof value === 'string') return value;\n  try {\n    return JSON.stringify(value) ?? '';\n  } catch {\n    return '';\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neatlogs",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "AI agent debugging, collaboration, and trace observability. Built for teams using CrewAI, OpenAI, and more.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -8,7 +8,7 @@
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/index.d.mts",
+        "types": "./dist/index.d.ts",
         "default": "./dist/index.mjs"
       },
       "require": {
@@ -18,13 +18,83 @@
     },
     "./ai": {
       "import": {
-        "types": "./dist/ai-sdk.d.mts",
+        "types": "./dist/ai-sdk.d.ts",
         "default": "./dist/ai-sdk.mjs"
       },
       "require": {
         "types": "./dist/ai-sdk.d.ts",
         "default": "./dist/ai-sdk.cjs"
       }
+    },
+    "./openai": {
+      "import": {
+        "types": "./dist/openai.d.ts",
+        "default": "./dist/openai.mjs"
+      },
+      "require": {
+        "types": "./dist/openai.d.ts",
+        "default": "./dist/openai.cjs"
+      }
+    },
+    "./anthropic": {
+      "import": {
+        "types": "./dist/anthropic.d.ts",
+        "default": "./dist/anthropic.mjs"
+      },
+      "require": {
+        "types": "./dist/anthropic.d.ts",
+        "default": "./dist/anthropic.cjs"
+      }
+    },
+    "./langchain": {
+      "import": {
+        "types": "./dist/langchain.d.ts",
+        "default": "./dist/langchain.mjs"
+      },
+      "require": {
+        "types": "./dist/langchain.d.ts",
+        "default": "./dist/langchain.cjs"
+      }
+    },
+    "./strands": {
+      "import": {
+        "types": "./dist/strands.d.ts",
+        "default": "./dist/strands.mjs"
+      },
+      "require": {
+        "types": "./dist/strands.d.ts",
+        "default": "./dist/strands.cjs"
+      }
+    },
+    "./openai-agents": {
+      "import": {
+        "types": "./dist/openai-agents.d.ts",
+        "default": "./dist/openai-agents.mjs"
+      },
+      "require": {
+        "types": "./dist/openai-agents.d.ts",
+        "default": "./dist/openai-agents.cjs"
+      }
+    },
+    "./mastra": {
+      "import": {
+        "types": "./dist/mastra-wrap.d.ts",
+        "default": "./dist/mastra-wrap.mjs"
+      },
+      "require": {
+        "types": "./dist/mastra-wrap.d.ts",
+        "default": "./dist/mastra-wrap.cjs"
+      }
+    },
+    "./pi-agent": {
+      "import": {
+        "types": "./dist/pi-agent.d.ts",
+        "default": "./dist/pi-agent.mjs"
+      },
+      "require": {
+        "types": "./dist/pi-agent.d.ts",
+        "default": "./dist/pi-agent.cjs"
+      }
     }
   },
   "files": [
@@ -34,6 +104,8 @@
     "node": ">=18.0.0"
   },
   "scripts": {
+    "version:sync": "node scripts/sync-version.mjs",
+    "prebuild": "node scripts/sync-version.mjs",
     "build": "tsup && rm -f dist/*.d.mts",
     "test": "vitest run",
     "test:watch": "vitest",