whale-code 6.5.5 → 6.5.6

package/dist/server/lib/compaction-service.js

@@ -3,121 +3,13 @@
 // Used for non-Anthropic providers (OpenAI, Gemini) that lack native
 // server-side compaction. Calls Haiku to produce a transparent summary
 // using the same instructions as compact_20260112.
-import { djb2Hash } from "../../shared/agent-core.js";
+
+// Re-export preCompact from shared module — single source of truth
+export { preCompact } from "../../shared/compaction.js";
 const COMPACTION_MODEL = "claude-haiku-4-5-20251001";
 const COMPACTION_MAX_TOKENS = 4096;
 const COMPACTION_TIMEOUT_MS = 30_000;
-const COMPACTION_INSTRUCTIONS = "Summarize the conversation preserving: (1) task goals and constraints, " +
-    "(2) files created/modified with paths, (3) decisions made and rationale, " +
-    "(4) errors encountered and resolutions, (5) exact next steps. " +
-    "Be concise but preserve all state needed to continue work without repeating mistakes.";
-/**
- * Pre-compaction pass: strip redundant data before calling LLM summarizer.
- * Mechanically removes large tool results already processed by the agent
- * and thinking blocks from older turns. Returns modified messages array
- * with reduced content so the LLM summarizer (or API context_management)
- * has less to work with.
- */
-export function preCompact(messages) {
-    let bytesRemoved = 0;
-    const compacted = messages.map((msg, idx) => {
-        if (msg.role !== "user")
-            return msg;
-        const content = msg.content;
-        if (!Array.isArray(content))
-            return msg;
-        const newContent = content.map((block) => {
-            // 1. Replace large tool results (>2KB) that the agent already acted on
-            if (block.type === "tool_result") {
-                const rc = typeof block.content === "string"
-                    ? block.content
-                    : JSON.stringify(block.content);
-                if (rc.length > 2048) {
-                    // Check if there's a subsequent assistant message (meaning agent processed this)
-                    const hasFollowup = messages
-                        .slice(idx + 1)
-                        .some((m) => m.role === "assistant");
-                    if (hasFollowup) {
-                        const originalSize = rc.length;
-                        bytesRemoved += originalSize - 100;
-                        return {
-                            ...block,
-                            content: `[Tool result: ${block.tool_use_id || "unknown"} returned ${Math.round(originalSize / 1024)}KB — agent processed and continued]`,
-                        };
-                    }
-                }
-            }
-            return block;
-        });
-        return { ...msg, content: newContent };
-    });
-    // 2. Deduplicate tool results — detect identical content (e.g. same file read multiple times)
-    //    and replace duplicates with a pointer to the first occurrence.
-    const contentHashes = new Map();
-    for (let i = 0; i < compacted.length; i++) {
-        const msg = compacted[i];
-        if (msg.role !== "user" || !Array.isArray(msg.content))
-            continue;
-        for (const block of msg.content) {
-            if (block.type !== "tool_result")
-                continue;
-            const rc = typeof block.content === "string" ? block.content : JSON.stringify(block.content);
-            if (rc.length < 200)
-                continue; // Skip small results — not worth deduping
-            const hashKey = djb2Hash(rc);
-            const existing = contentHashes.get(hashKey);
-            if (existing) {
-                existing.count++;
-            }
-            else {
-                contentHashes.set(hashKey, { count: 1, firstIdx: i });
-            }
-        }
-    }
-    // Second pass: replace duplicates (not the first occurrence) with pointer
-    for (let i = 0; i < compacted.length; i++) {
-        const msg = compacted[i];
-        if (msg.role !== "user" || !Array.isArray(msg.content))
-            continue;
-        const newContent = msg.content.map((block) => {
-            if (block.type !== "tool_result")
-                return block;
-            const rc = typeof block.content === "string" ? block.content : JSON.stringify(block.content);
-            if (rc.length < 200)
-                return block;
-            const hashKey = djb2Hash(rc);
-            const entry = contentHashes.get(hashKey);
-            if (entry && entry.count >= 2 && i !== entry.firstIdx) {
-                bytesRemoved += rc.length - 50;
-                return { ...block, content: "[Duplicate — same content as earlier read]" };
-            }
-            return block;
-        });
-        compacted[i] = { ...msg, content: newContent };
-    }
-    // 3. Remove thinking blocks older than 3 turns from the end
-    const thinkingCutoff = Math.max(0, compacted.length - 6); // 3 turns = ~6 messages
-    const result = compacted.map((msg, idx) => {
-        if (idx >= thinkingCutoff)
-            return msg;
-        if (msg.role !== "assistant")
-            return msg;
-        const content = msg.content;
-        if (!Array.isArray(content))
-            return msg;
-        const filtered = content.filter((block) => {
-            if (block.type === "thinking") {
-                bytesRemoved += String(block.thinking || "").length;
-                return false;
-            }
-            return true;
-        });
-        if (filtered.length === 0)
-            return msg; // Keep at least something
-        return { ...msg, content: filtered };
-    });
-    return { messages: result, bytesRemoved };
-}
+const COMPACTION_INSTRUCTIONS = "Summarize the conversation preserving: (1) task goals and constraints, " + "(2) files created/modified with paths, (3) decisions made and rationale, " + "(4) errors encountered and resolutions, (5) exact next steps. " + "Be concise but preserve all state needed to continue work without repeating mistakes.";
 /**
  * Generate a compaction summary using Haiku.
  *
@@ -127,81 +19,79 @@ export function preCompact(messages) {
  * caller can keep the unsummarized history.
  */
 export async function generateCompaction(opts) {
-    const { anthropic, messages, systemPrompt, instructions } = opts;
-    // Build a text representation of the conversation for summarization
-    const conversationText = messages
-        .map((msg) => {
-        const role = msg.role;
-        let content;
-        if (typeof msg.content === "string") {
-            content = msg.content;
-        }
-        else if (Array.isArray(msg.content)) {
-            content = msg.content
-                .map((block) => {
-                if (block.type === "text")
-                    return block.text;
-                if (block.type === "tool_use")
-                    return `[Tool: ${block.name}]`;
-                if (block.type === "tool_result") {
-                    const rc = block.content;
-                    if (typeof rc === "string")
-                        return rc.slice(0, 500);
-                    if (Array.isArray(rc)) {
-                        return rc
-                            .map((b) => (b.type === "text" ? b.text.slice(0, 500) : `[${b.type}]`))
-                            .join(" ");
-                    }
-                    return "[tool_result]";
-                }
-                if (block.type === "compaction")
-                    return `[Previous summary: ${block.content.slice(0, 200)}...]`;
-                return `[${block.type}]`;
-            })
-                .join("\n");
-        }
-        else {
-            content = String(msg.content);
-        }
-        return `${role.toUpperCase()}:\n${content}`;
-    })
-        .join("\n\n---\n\n");
-    // Truncate if conversation is very long (Haiku has 200K context)
-    const maxInputChars = 400_000; // ~100K tokens
-    const truncatedConversation = conversationText.length > maxInputChars
-        ? conversationText.slice(-maxInputChars) + "\n\n... (earlier messages truncated)"
-        : conversationText;
-    const summaryInstructions = instructions || COMPACTION_INSTRUCTIONS;
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), COMPACTION_TIMEOUT_MS);
-        try {
-            const response = await anthropic.messages.create({
-                model: COMPACTION_MODEL,
-                max_tokens: COMPACTION_MAX_TOKENS,
-                system: `You are summarizing an AI agent conversation for context compaction. ${summaryInstructions}`,
-                messages: [
-                    {
-                        role: "user",
-                        content: `Summarize this conversation. The agent's system prompt was:\n\n${systemPrompt.slice(0, 2000)}\n\n---\n\nConversation:\n\n${truncatedConversation}`,
-                    },
-                ],
-            }, { signal: controller.signal });
-            clearTimeout(timeout);
-            const textBlock = response.content.find((b) => b.type === "text");
-            if (!textBlock || textBlock.type !== "text") {
-                return { success: false, error: "No text in compaction response" };
-            }
-            return { success: true, content: textBlock.text };
-        }
-        finally {
-            clearTimeout(timeout);
+  const {
+    anthropic,
+    messages,
+    systemPrompt,
+    instructions
+  } = opts;
+
+  // Build a text representation of the conversation for summarization
+  const conversationText = messages.map(msg => {
+    const role = msg.role;
+    let content;
+    if (typeof msg.content === "string") {
+      content = msg.content;
+    } else if (Array.isArray(msg.content)) {
+      content = msg.content.map(block => {
+        if (block.type === "text") return block.text;
+        if (block.type === "tool_use") return `[Tool: ${block.name}]`;
+        if (block.type === "tool_result") {
+          const rc = block.content;
+          if (typeof rc === "string") return rc.slice(0, 500);
+          if (Array.isArray(rc)) {
+            return rc.map(b => b.type === "text" ? b.text.slice(0, 500) : `[${b.type}]`).join(" ");
+          }
+          return "[tool_result]";
         }
+        if (block.type === "compaction") return `[Previous summary: ${block.content.slice(0, 200)}...]`;
+        return `[${block.type}]`;
+      }).join("\n");
+    } else {
+      content = String(msg.content);
     }
-    catch (err) {
+    return `${role.toUpperCase()}:\n${content}`;
+  }).join("\n\n---\n\n");
+
+  // Truncate if conversation is very long (Haiku has 200K context)
+  const maxInputChars = 400_000; // ~100K tokens
+  const truncatedConversation = conversationText.length > maxInputChars ? conversationText.slice(-maxInputChars) + "\n\n... (earlier messages truncated)" : conversationText;
+  const summaryInstructions = instructions || COMPACTION_INSTRUCTIONS;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), COMPACTION_TIMEOUT_MS);
+    try {
+      const response = await anthropic.messages.create({
+        model: COMPACTION_MODEL,
+        max_tokens: COMPACTION_MAX_TOKENS,
+        system: `You are summarizing an AI agent conversation for context compaction. ${summaryInstructions}`,
+        messages: [{
+          role: "user",
+          content: `Summarize this conversation. The agent's system prompt was:\n\n${systemPrompt.slice(0, 2000)}\n\n---\n\nConversation:\n\n${truncatedConversation}`
+        }]
+      }, {
+        signal: controller.signal
+      });
+      clearTimeout(timeout);
+      const textBlock = response.content.find(b => b.type === "text");
+      if (!textBlock || textBlock.type !== "text") {
         return {
-            success: false,
-            error: `Compaction failed: ${err.message}`,
+          success: false,
+          error: "No text in compaction response"
         };
+      }
+      return {
+        success: true,
+        content: textBlock.text
+      };
+    } finally {
+      clearTimeout(timeout);
     }
+  } catch (err) {
+    return {
+      success: false,
+      error: `Compaction failed: ${err.message}`
+    };
+  }
 }
+//# sourceMappingURL=compaction-service.js.map

package/dist/server/lib/compaction-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-service.js","names":["preCompact","COMPACTION_MODEL","COMPACTION_MAX_TOKENS","COMPACTION_TIMEOUT_MS","COMPACTION_INSTRUCTIONS","generateCompaction","opts","anthropic","messages","systemPrompt","instructions","conversationText","map","msg","role","content","Array","isArray","block","type","text","name","rc","slice","b","join","String","toUpperCase","maxInputChars","truncatedConversation","length","summaryInstructions","controller","AbortController","timeout","setTimeout","abort","response","create","model","max_tokens","system","signal","clearTimeout","textBlock","find","success","error","err","message"],"sources":["../../../src/server/lib/compaction-service.ts"],"sourcesContent":["// server/lib/compaction-service.ts — Haiku-based conversation compaction\n//\n// Used for non-Anthropic providers (OpenAI, Gemini) that lack native\n// server-side compaction. Calls Haiku to produce a transparent summary\n// using the same instructions as compact_20260112.\n\nimport Anthropic from \"@anthropic-ai/sdk\";\n\n// Re-export preCompact from shared module — single source of truth\nexport { preCompact } from \"../../shared/compaction.js\";\nexport type { PreCompactResult, PreCompactOptions } from \"../../shared/compaction.js\";\n\nconst COMPACTION_MODEL = \"claude-haiku-4-5-20251001\";\nconst COMPACTION_MAX_TOKENS = 4096;\nconst COMPACTION_TIMEOUT_MS = 30_000;\n\nconst COMPACTION_INSTRUCTIONS =\n  \"Summarize the conversation preserving: (1) task goals and constraints, \" +\n  \"(2) files created/modified with paths, (3) decisions made and rationale, \" +\n  \"(4) errors encountered and resolutions, (5) exact next steps. \" +\n  \"Be concise but preserve all state needed to continue work without repeating mistakes.\";\n\nexport interface CompactionResult {\n  success: boolean;\n  content?: string;\n  error?: string;\n}\n\n/**\n * Generate a compaction summary using Haiku.\n *\n * Takes the full conversation history and produces a concise summary\n * that preserves all state needed to continue the conversation.\n * Falls back gracefully — returns null content on failure so the\n * caller can keep the unsummarized history.\n */\nexport async function generateCompaction(opts: {\n  anthropic: Anthropic;\n  messages: Array<Record<string, unknown>>;\n  systemPrompt: string;\n  instructions?: string;\n}): Promise<CompactionResult> {\n  const { anthropic, messages, systemPrompt, instructions } = opts;\n\n  // Build a text representation of the conversation for summarization\n  const conversationText = messages\n    .map((msg) => {\n      const role = msg.role as string;\n      let content: string;\n      if (typeof msg.content === \"string\") {\n        content = msg.content;\n      } else if (Array.isArray(msg.content)) {\n        content = (msg.content as Array<Record<string, unknown>>)\n          .map((block) => {\n            if (block.type === \"text\") return block.text as string;\n            if (block.type === \"tool_use\") return `[Tool: ${block.name}]`;\n            if (block.type === \"tool_result\") {\n              const rc = block.content;\n              if (typeof rc === \"string\") return rc.slice(0, 500);\n              if (Array.isArray(rc)) {\n                return (rc as Array<Record<string, unknown>>)\n                  .map((b) => (b.type === \"text\" ? (b.text as string).slice(0, 500) : `[${b.type}]`))\n                  .join(\" \");\n              }\n              return \"[tool_result]\";\n            }\n            if (block.type === \"compaction\") return `[Previous summary: ${(block.content as string).slice(0, 200)}...]`;\n            return `[${block.type}]`;\n          })\n          .join(\"\\n\");\n      } else {\n        content = String(msg.content);\n      }\n      return `${role.toUpperCase()}:\\n${content}`;\n    })\n    .join(\"\\n\\n---\\n\\n\");\n\n  // Truncate if conversation is very long (Haiku has 200K context)\n  const maxInputChars = 400_000; // ~100K tokens\n  const truncatedConversation =\n    conversationText.length > maxInputChars\n      ? conversationText.slice(-maxInputChars) + \"\\n\\n... (earlier messages truncated)\"\n      : conversationText;\n\n  const summaryInstructions = instructions || COMPACTION_INSTRUCTIONS;\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), COMPACTION_TIMEOUT_MS);\n\n    try {\n      const response = await anthropic.messages.create(\n        {\n          model: COMPACTION_MODEL,\n          max_tokens: COMPACTION_MAX_TOKENS,\n          system: `You are summarizing an AI agent conversation for context compaction. ${summaryInstructions}`,\n          messages: [\n            {\n              role: \"user\",\n              content: `Summarize this conversation. The agent's system prompt was:\\n\\n${systemPrompt.slice(0, 2000)}\\n\\n---\\n\\nConversation:\\n\\n${truncatedConversation}`,\n            },\n          ],\n        },\n        { signal: controller.signal },\n      );\n\n      clearTimeout(timeout);\n\n      const textBlock = response.content.find((b) => b.type === \"text\");\n      if (!textBlock || textBlock.type !== \"text\") {\n        return { success: false, error: \"No text in compaction response\" };\n      }\n\n      return { success: true, content: textBlock.text };\n    } finally {\n      clearTimeout(timeout);\n    }\n  } catch (err) {\n    return {\n      success: false,\n      error: `Compaction failed: ${(err as Error).message}`,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/lib/logger.js

@@ -4,43 +4,55 @@
  * JSON output in production, optional pino-pretty in dev.
  * Provides child loggers with context and correlation IDs.
  */
+
 import pino from "pino";
 const logger = pino({
-    level: process.env.LOG_LEVEL || "info",
-    formatters: {
-        level(label) {
-            return { level: label };
-        },
-    },
-    // Pretty print in dev if pino-pretty is installed, JSON in production
-    transport: process.env.NODE_ENV !== "production"
-        ? (() => {
-            try {
-                // pino-pretty is optional — if not installed, fall back to JSON
-                require.resolve("pino-pretty");
-                return { target: "pino-pretty", options: { colorize: true } };
-            }
-            catch {
-                return undefined;
-            }
-        })()
-        : undefined,
+  level: process.env.LOG_LEVEL || "info",
+  formatters: {
+    level(label) {
+      return {
+        level: label
+      };
+    }
+  },
+  // Pretty print in dev if pino-pretty is installed, JSON in production
+  transport: process.env.NODE_ENV !== "production" ? (() => {
+    try {
+      // pino-pretty is optional — if not installed, fall back to JSON
+      require.resolve("pino-pretty");
+      return {
+        target: "pino-pretty",
+        options: {
+          colorize: true
+        }
+      };
+    } catch {
+      return undefined;
+    }
+  })() : undefined
 });
+
 /**
  * Create a child logger bound to a specific context (module name).
  * Usage: const log = createLogger('agent-loop');
  */
 export function createLogger(context) {
-    return logger.child({ context });
+  return logger.child({
+    context
+  });
 }
+
 /**
  * Create a child logger with correlation IDs for request tracing.
  * Usage: const log = withTrace(traceId, conversationId);
  */
 export function withTrace(traceId, conversationId) {
-    return logger.child({
-        traceId,
-        ...(conversationId ? { conversationId } : {}),
-    });
+  return logger.child({
+    traceId,
+    ...(conversationId ? {
+      conversationId
+    } : {})
+  });
 }
 export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/server/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":["pino","logger","level","process","env","LOG_LEVEL","formatters","label","transport","NODE_ENV","require","resolve","target","options","colorize","undefined","createLogger","context","child","withTrace","traceId","conversationId"],"sources":["../../../src/server/lib/logger.ts"],"sourcesContent":["/**\n * Structured logging with pino — Phase 6.1\n *\n * JSON output in production, optional pino-pretty in dev.\n * Provides child loggers with context and correlation IDs.\n */\n\nimport pino from \"pino\";\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || \"info\",\n  formatters: {\n    level(label: string) {\n      return { level: label };\n    },\n  },\n  // Pretty print in dev if pino-pretty is installed, JSON in production\n  transport:\n    process.env.NODE_ENV !== \"production\"\n      ? (() => {\n          try {\n            // pino-pretty is optional — if not installed, fall back to JSON\n            require.resolve(\"pino-pretty\");\n            return { target: \"pino-pretty\", options: { colorize: true } };\n          } catch {\n            return undefined;\n          }\n        })()\n      : undefined,\n});\n\n/**\n * Create a child logger bound to a specific context (module name).\n * Usage: const log = createLogger('agent-loop');\n */\nexport function createLogger(context: string): pino.Logger {\n  return logger.child({ context });\n}\n\n/**\n * Create a child logger with correlation IDs for request tracing.\n * Usage: const log = withTrace(traceId, conversationId);\n */\nexport function withTrace(traceId: string, conversationId?: string): pino.Logger {\n  return logger.child({\n    traceId,\n    ...(conversationId ? { conversationId } : {}),\n  });\n}\n\nexport default logger;\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,IAAI,MAAM,MAAM;AAEvB,MAAMC,MAAM,GAAGD,IAAI,CAAC;EAClBE,KAAK,EAAEC,OAAO,CAACC,GAAG,CAACC,SAAS,IAAI,MAAM;EACtCC,UAAU,EAAE;IACVJ,KAAKA,CAACK,KAAa,EAAE;MACnB,OAAO;QAAEL,KAAK,EAAEK;MAAM,CAAC;IACzB;EACF,CAAC;EACD;EACAC,SAAS,EACPL,OAAO,CAACC,GAAG,CAACK,QAAQ,KAAK,YAAY,GACjC,CAAC,MAAM;IACL,IAAI;MACF;MACAC,OAAO,CAACC,OAAO,CAAC,aAAa,CAAC;MAC9B,OAAO;QAAEC,MAAM,EAAE,aAAa;QAAEC,OAAO,EAAE;UAAEC,QAAQ,EAAE;QAAK;MAAE,CAAC;IAC/D,CAAC,CAAC,MAAM;MACN,OAAOC,SAAS;IAClB;EACF,CAAC,EAAE,CAAC,GACJA;AACR,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,OAAe,EAAe;EACzD,OAAOhB,MAAM,CAACiB,KAAK,CAAC;IAAED;EAAQ,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,SAASA,CAACC,OAAe,EAAEC,cAAuB,EAAe;EAC/E,OAAOpB,MAAM,CAACiB,KAAK,CAAC;IAClBE,OAAO;IACP,IAAIC,cAAc,GAAG;MAAEA;IAAe,CAAC,GAAG,CAAC,CAAC;EAC9C,CAAC,CAAC;AACJ;AAEA,eAAepB,MAAM","ignoreList":[]}

package/dist/server/lib/otel.js

@@ -11,116 +11,137 @@
  *
  * Backward compatible: If OTEL is not enabled, all functions are no-ops.
  */
+
+// Types for OTEL spans — allows code to use these without requiring the SDK
+
 const OTEL_ENABLED = process.env.OTEL_ENABLED === "true";
 const OTEL_ENDPOINT = process.env.OTEL_EXPORTER_OTLP_ENDPOINT || "";
 const SERVICE_NAME = process.env.OTEL_SERVICE_NAME || "whale-workflow-engine";
+
 // Lazy-loaded SDK references
 let _tracer = null;
 let _sdk = null;
+
 /**
  * Initialize OpenTelemetry SDK. Call once at startup.
  * No-op if OTEL_ENABLED !== "true".
  */
 export async function initOtel() {
-    if (!OTEL_ENABLED || !OTEL_ENDPOINT)
-        return;
-    try {
-        // @ts-ignore — optional runtime dependency, gracefully handled by try/catch
-        const { NodeSDK } = await import("@opentelemetry/sdk-node");
-        // @ts-ignore
-        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
-        // @ts-ignore
-        const { Resource } = await import("@opentelemetry/resources");
-        // @ts-ignore
-        const { ATTR_SERVICE_NAME } = await import("@opentelemetry/semantic-conventions");
-        // @ts-ignore
-        const { trace } = await import("@opentelemetry/api");
-        const exporter = new OTLPTraceExporter({ url: `${OTEL_ENDPOINT}/v1/traces` });
-        _sdk = new NodeSDK({
-            resource: new Resource({ [ATTR_SERVICE_NAME]: SERVICE_NAME }),
-            traceExporter: exporter,
-        });
-        _sdk.start();
-        _tracer = trace.getTracer(SERVICE_NAME);
-        console.log(`[otel] initialized — exporting to ${OTEL_ENDPOINT}`);
-    }
-    catch (err) {
-        console.warn("[otel] Failed to initialize (SDK not installed?):", err.message);
-        // Non-fatal — all functions remain no-ops
-    }
+  if (!OTEL_ENABLED || !OTEL_ENDPOINT) return;
+  try {
+    // @ts-ignore — optional runtime dependency, gracefully handled by try/catch
+    const {
+      NodeSDK
+    } = await import("@opentelemetry/sdk-node");
+    // @ts-ignore
+    const {
+      OTLPTraceExporter
+    } = await import("@opentelemetry/exporter-trace-otlp-http");
+    // @ts-ignore
+    const {
+      Resource
+    } = await import("@opentelemetry/resources");
+    // @ts-ignore
+    const {
+      ATTR_SERVICE_NAME
+    } = await import("@opentelemetry/semantic-conventions");
+    // @ts-ignore
+    const {
+      trace
+    } = await import("@opentelemetry/api");
+    const exporter = new OTLPTraceExporter({
+      url: `${OTEL_ENDPOINT}/v1/traces`
+    });
+    _sdk = new NodeSDK({
+      resource: new Resource({
+        [ATTR_SERVICE_NAME]: SERVICE_NAME
+      }),
+      traceExporter: exporter
+    });
+    _sdk.start();
+    _tracer = trace.getTracer(SERVICE_NAME);
+    console.log(`[otel] initialized — exporting to ${OTEL_ENDPOINT}`);
+  } catch (err) {
+    console.warn("[otel] Failed to initialize (SDK not installed?):", err.message);
+    // Non-fatal — all functions remain no-ops
+  }
 }
+
 /**
  * Graceful shutdown — flush pending spans.
  */
 export async function shutdownOtel() {
-    if (_sdk) {
-        try {
-            await _sdk.shutdown();
-        }
-        catch { /* ignore */ }
-    }
+  if (_sdk) {
+    try {
+      await _sdk.shutdown();
+    } catch {/* ignore */}
+  }
 }
+
 /** No-op span for when OTEL is disabled */
 const noopSpan = {
-    end: () => { },
-    setError: () => { },
-    setAttribute: () => { },
-    addEvent: () => { },
+  end: () => {},
+  setError: () => {},
+  setAttribute: () => {},
+  addEvent: () => {}
 };
+
 /**
  * Start a new span for tracking an operation.
  * Returns a SpanContext that wraps the OTEL span API.
  * If OTEL is disabled, returns a no-op.
  */
 export function startSpan(name, attributes) {
-    if (!_tracer)
-        return noopSpan;
-    try {
-        const span = _tracer.startSpan(name, {
-            attributes: attributes || {},
+  if (!_tracer) return noopSpan;
+  try {
+    const span = _tracer.startSpan(name, {
+      attributes: attributes || {}
+    });
+    return {
+      end: attrs => {
+        if (attrs) {
+          for (const [k, v] of Object.entries(attrs)) {
+            if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+              span.setAttribute(k, v);
+            }
+          }
+        }
+        span.end();
+      },
+      setError: err => {
+        span.setStatus({
+          code: 2 /* ERROR */,
+          message: typeof err === "string" ? err : err.message
         });
-        return {
-            end: (attrs) => {
-                if (attrs) {
-                    for (const [k, v] of Object.entries(attrs)) {
-                        if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-                            span.setAttribute(k, v);
-                        }
-                    }
-                }
-                span.end();
-            },
-            setError: (err) => {
-                span.setStatus({ code: 2 /* ERROR */, message: typeof err === "string" ? err : err.message });
-                if (err instanceof Error) {
-                    span.recordException(err);
-                }
-            },
-            setAttribute: (key, value) => {
-                span.setAttribute(key, value);
-            },
-            addEvent: (eventName, attrs) => {
-                span.addEvent(eventName, attrs);
-            },
-        };
-    }
-    catch {
-        return noopSpan;
-    }
+        if (err instanceof Error) {
+          span.recordException(err);
+        }
+      },
+      setAttribute: (key, value) => {
+        span.setAttribute(key, value);
+      },
+      addEvent: (eventName, attrs) => {
+        span.addEvent(eventName, attrs);
+      }
+    };
+  } catch {
+    return noopSpan;
+  }
 }
+
 /**
  * Convenience: wrap an async function in a span.
  */
 export async function withSpan(name, attributes, fn) {
-    const span = startSpan(name, attributes);
-    try {
-        const result = await fn(span);
-        span.end();
-        return result;
-    }
-    catch (err) {
-        span.setError(err);
-        span.end();
-        throw err;
-    }
+  const span = startSpan(name, attributes);
+  try {
+    const result = await fn(span);
+    span.end();
+    return result;
+  } catch (err) {
+    span.setError(err);
+    span.end();
+    throw err;
+  }
 }
+//# sourceMappingURL=otel.js.map

package/dist/server/lib/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","names":["OTEL_ENABLED","process","env","OTEL_ENDPOINT","OTEL_EXPORTER_OTLP_ENDPOINT","SERVICE_NAME","OTEL_SERVICE_NAME","_tracer","_sdk","initOtel","NodeSDK","OTLPTraceExporter","Resource","ATTR_SERVICE_NAME","trace","exporter","url","resource","traceExporter","start","getTracer","console","log","err","warn","message","shutdownOtel","shutdown","noopSpan","end","setError","setAttribute","addEvent","startSpan","name","attributes","span","attrs","k","v","Object","entries","setStatus","code","Error","recordException","key","value","eventName","withSpan","fn","result"],"sources":["../../../src/server/lib/otel.ts"],"sourcesContent":["/**\n * lib/otel.ts — OpenTelemetry SDK setup for workflow engine observability\n *\n * Phase 3.3: Adds distributed tracing spans for step execution, tool calls, LLM calls.\n * Exports to any OTLP-compatible collector (Jaeger, Grafana Tempo, Honeycomb, etc.)\n *\n * Configuration:\n *   OTEL_EXPORTER_OTLP_ENDPOINT — Collector endpoint (e.g., http://localhost:4318)\n *   OTEL_SERVICE_NAME — Service name (default: \"whale-workflow-engine\")\n *   OTEL_ENABLED — Set to \"true\" to enable (disabled by default)\n *\n * Backward compatible: If OTEL is not enabled, all functions are no-ops.\n */\n\n// Types for OTEL spans — allows code to use these without requiring the SDK\nexport interface SpanContext {\n  end: (attrs?: Record<string, unknown>) => void;\n  setError: (err: Error | string) => void;\n  setAttribute: (key: string, value: string | number | boolean) => void;\n  addEvent: (name: string, attrs?: Record<string, unknown>) => void;\n}\n\nconst OTEL_ENABLED = process.env.OTEL_ENABLED === \"true\";\nconst OTEL_ENDPOINT = process.env.OTEL_EXPORTER_OTLP_ENDPOINT || \"\";\nconst SERVICE_NAME = process.env.OTEL_SERVICE_NAME || \"whale-workflow-engine\";\n\n// Lazy-loaded SDK references\nlet _tracer: any = null;\nlet _sdk: any = null;\n\n/**\n * Initialize OpenTelemetry SDK. Call once at startup.\n * No-op if OTEL_ENABLED !== \"true\".\n */\nexport async function initOtel(): Promise<void> {\n  if (!OTEL_ENABLED || !OTEL_ENDPOINT) return;\n\n  try {\n    // @ts-ignore — optional runtime dependency, gracefully handled by try/catch\n    const { NodeSDK } = await import(\"@opentelemetry/sdk-node\");\n    // @ts-ignore\n    const { OTLPTraceExporter } = await import(\"@opentelemetry/exporter-trace-otlp-http\");\n    // @ts-ignore\n    const { Resource } = await import(\"@opentelemetry/resources\");\n    // @ts-ignore\n    const { ATTR_SERVICE_NAME } = await import(\"@opentelemetry/semantic-conventions\");\n    // @ts-ignore\n    const { trace } = await import(\"@opentelemetry/api\");\n\n    const exporter = new OTLPTraceExporter({ url: `${OTEL_ENDPOINT}/v1/traces` });\n\n    _sdk = new NodeSDK({\n      resource: new Resource({ [ATTR_SERVICE_NAME]: SERVICE_NAME }),\n      traceExporter: exporter,\n    });\n\n    _sdk.start();\n    _tracer = trace.getTracer(SERVICE_NAME);\n    console.log(`[otel] initialized — exporting to ${OTEL_ENDPOINT}`);\n  } catch (err) {\n    console.warn(\"[otel] Failed to initialize (SDK not installed?):\", (err as Error).message);\n    // Non-fatal — all functions remain no-ops\n  }\n}\n\n/**\n * Graceful shutdown — flush pending spans.\n */\nexport async function shutdownOtel(): Promise<void> {\n  if (_sdk) {\n    try {\n      await _sdk.shutdown();\n    } catch { /* ignore */ }\n  }\n}\n\n/** No-op span for when OTEL is disabled */\nconst noopSpan: SpanContext = {\n  end: () => {},\n  setError: () => {},\n  setAttribute: () => {},\n  addEvent: () => {},\n};\n\n/**\n * Start a new span for tracking an operation.\n * Returns a SpanContext that wraps the OTEL span API.\n * If OTEL is disabled, returns a no-op.\n */\nexport function startSpan(\n  name: string,\n  attributes?: Record<string, string | number | boolean>,\n): SpanContext {\n  if (!_tracer) return noopSpan;\n\n  try {\n    const span = _tracer.startSpan(name, {\n      attributes: attributes || {},\n    });\n\n    return {\n      end: (attrs?: Record<string, unknown>) => {\n        if (attrs) {\n          for (const [k, v] of Object.entries(attrs)) {\n            if (typeof v === \"string\" || typeof v === \"number\" || typeof v === \"boolean\") {\n              span.setAttribute(k, v);\n            }\n          }\n        }\n        span.end();\n      },\n      setError: (err: Error | string) => {\n        span.setStatus({ code: 2 /* ERROR */, message: typeof err === \"string\" ? err : err.message });\n        if (err instanceof Error) {\n          span.recordException(err);\n        }\n      },\n      setAttribute: (key: string, value: string | number | boolean) => {\n        span.setAttribute(key, value);\n      },\n      addEvent: (eventName: string, attrs?: Record<string, unknown>) => {\n        span.addEvent(eventName, attrs);\n      },\n    };\n  } catch {\n    return noopSpan;\n  }\n}\n\n/**\n * Convenience: wrap an async function in a span.\n */\nexport async function withSpan<T>(\n  name: string,\n  attributes: Record<string, string | number | boolean>,\n  fn: (span: SpanContext) => Promise<T>,\n): Promise<T> {\n  const span = startSpan(name, attributes);\n  try {\n    const result = await fn(span);\n    span.end();\n    return result;\n  } catch (err) {\n    span.setError(err as Error);\n    span.end();\n    throw err;\n  }\n}\n"],"mappings":"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","ignoreList":[]}