@senpi/runtime 1.1.0-dev.runtime-phase-2.20260515135454 → 1.1.0-dev.runtime-phase-2.20260519125628

package/dist/tracking/spans/span-hooks.js

@@ -0,0 +1,399 @@
+import { HEADER_ADDRESS, HEADER_CORRELATION_ID, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("[senpi-core][span-hooks]");
+export function registerSpanHooks(options) {
+    const { api, tracker } = options;
+    // Tool hooks often arrive with a ctx that lacks sessionKey/runId — OpenClaw
+    // doesn't always thread the host agent's identity through to tool calls.
+    // Mirror opik's fallback strategy: remember (agentId → sessionKey/runId)
+    // from llm_input, and the last seen pair, so tool hooks can resolve them.
+    const sessionByAgentId = new Map();
+    let lastActive = null;
+    const rememberSession = (agentCtx, sessionKey, runId) => {
+        const agentId = nonEmptyString(asRecord(agentCtx)?.agentId);
+        if (agentId)
+            sessionByAgentId.set(agentId, { sessionKey, runId });
+        lastActive = { sessionKey, runId };
+    };
+    const resolveToolSession = (ctx) => {
+        const direct = {
+            sessionKey: readSessionKey(ctx, undefined),
+            runId: readRunId(ctx, undefined),
+        };
+        if (direct.sessionKey && direct.runId) {
+            return { sessionKey: direct.sessionKey, runId: direct.runId };
+        }
+        const agentId = nonEmptyString(asRecord(ctx)?.agentId);
+        if (agentId) {
+            const hit = sessionByAgentId.get(agentId);
+            if (hit)
+                return hit;
+        }
+        return lastActive;
+    };
+    // ─── LLM ───────────────────────────────────────────────────────────────
+    api.on("llm_input", (event, agentCtx) => {
+        try {
+            const ctx = readContext(agentCtx);
+            const sessionKey = readSessionKey(agentCtx, event);
+            const runId = readRunId(agentCtx, event);
+            if (!sessionKey || !runId) {
+                logger.warn("llm_input missing sessionKey/runId; skipping span");
+                return;
+            }
+            rememberSession(agentCtx, sessionKey, runId);
+            tracker.openLlmSpan({
+                sessionKey,
+                runId,
+                emissionSource: "hook",
+                input: extractLlmInput(event),
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("llm_input handler failed", { err: errMsg(err) });
+        }
+    });
+    api.on("llm_output", (event, agentCtx) => {
+        try {
+            const ctx = readContext(agentCtx);
+            const sessionKey = readSessionKey(agentCtx, event);
+            const runId = readRunId(agentCtx, event);
+            if (!sessionKey || !runId) {
+                logger.warn("llm_output missing sessionKey/runId; skipping span");
+                return;
+            }
+            rememberSession(agentCtx, sessionKey, runId);
+            const out = extractLlmOutput(event);
+            tracker.finalizeLlmSpan({
+                sessionKey,
+                runId,
+                output: out.output,
+                model: out.model,
+                tokensIn: out.tokensIn,
+                tokensOut: out.tokensOut,
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("llm_output handler failed", { err: errMsg(err) });
+        }
+    });
+    // ─── Tool ──────────────────────────────────────────────────────────────
+    // OpenClaw's tool-hook context often omits sessionKey/runId. Fall back to
+    // (agentId → session/run) learned from the most recent llm_input, then to
+    // the last-active pair, matching opik's strategy.
+    api.on("before_tool_call", (event, toolCtx) => {
+        try {
+            const ctx = readContext(toolCtx);
+            const resolved = resolveToolSession(toolCtx);
+            if (!resolved) {
+                logger.debug("before_tool_call sessionKey/runId unresolved (no llm_input seen yet); skipping");
+                return;
+            }
+            const evObj = asRecord(event);
+            const toolName = nonEmptyString(evObj?.toolName) ?? nonEmptyString(evObj?.name) ?? "unknown";
+            const toolCallId = nonEmptyString(evObj?.toolCallId) ??
+                nonEmptyString(asRecord(toolCtx)?.toolCallId) ??
+                null;
+            tracker.openToolSpan({
+                sessionKey: resolved.sessionKey,
+                runId: resolved.runId,
+                emissionSource: "hook",
+                toolCallId,
+                toolName,
+                toolInput: asRecord(evObj?.params) ?? asRecord(evObj?.input),
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("before_tool_call handler failed", { err: errMsg(err) });
+        }
+    });
+    api.on("after_tool_call", (event, toolCtx) => {
+        try {
+            const ctx = readContext(toolCtx);
+            const resolved = resolveToolSession(toolCtx);
+            if (!resolved) {
+                logger.debug("after_tool_call sessionKey/runId unresolved (no llm_input seen yet); skipping");
+                return;
+            }
+            const evObj = asRecord(event);
+            const toolName = nonEmptyString(evObj?.toolName) ?? nonEmptyString(evObj?.name) ?? "unknown";
+            const toolCallId = nonEmptyString(evObj?.toolCallId) ??
+                nonEmptyString(asRecord(toolCtx)?.toolCallId) ??
+                null;
+            const error = evObj?.error;
+            const result = evObj?.result;
+            const durationMs = typeof evObj?.durationMs === "number" ? evObj.durationMs : undefined;
+            tracker.finalizeToolSpan({
+                sessionKey: resolved.sessionKey,
+                runId: resolved.runId,
+                toolCallId,
+                toolName,
+                output: error !== undefined ? undefined : result,
+                error: error !== undefined ? error : undefined,
+                durationMs,
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("after_tool_call handler failed", { err: errMsg(err) });
+        }
+    });
+    // ─── Subagent (four hooks) ─────────────────────────────────────────────
+    api.on("subagent_spawning", (event, subagentCtx) => {
+        try {
+            const ctx = readContext(subagentCtx);
+            const evObj = asRecord(event);
+            const ctxObj = asRecord(subagentCtx);
+            const hostSessionKey = nonEmptyString(ctxObj?.requesterSessionKey) ??
+                nonEmptyString(ctxObj?.sessionKey) ??
+                "";
+            const hostRunId = nonEmptyString(ctxObj?.runId) ??
+                nonEmptyString(ctxObj?.requesterRunId) ??
+                "";
+            const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
+                nonEmptyString(ctxObj?.childSessionKey);
+            if (!childSessionKey) {
+                logger.warn("subagent_spawning missing childSessionKey; skipping span");
+                return;
+            }
+            const parentSpanId = hostSessionKey && hostRunId
+                ? tracker.getActiveLlmSpanId(hostSessionKey, hostRunId)
+                : null;
+            tracker.openSubagentSpan({
+                hostSessionKey,
+                hostRunId,
+                childSessionKey,
+                parentSpanId,
+                input: {
+                    agentId: evObj?.agentId,
+                    label: evObj?.label,
+                    mode: evObj?.mode,
+                    requester: evObj?.requester,
+                    threadRequested: evObj?.threadRequested,
+                },
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("subagent_spawning handler failed", { err: errMsg(err) });
+        }
+    });
+    api.on("subagent_spawned", (event, subagentCtx) => {
+        try {
+            const ctx = readContext(subagentCtx);
+            const evObj = asRecord(event);
+            const ctxObj = asRecord(subagentCtx);
+            const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
+                nonEmptyString(ctxObj?.childSessionKey);
+            if (!childSessionKey)
+                return;
+            tracker.mergeSubagentSpan({
+                childSessionKey,
+                status: "spawned",
+                patch: {
+                    runId: nonEmptyString(evObj?.runId) ?? nonEmptyString(ctxObj?.runId),
+                    agentId: evObj?.agentId,
+                    mode: evObj?.mode,
+                    threadRequested: evObj?.threadRequested,
+                },
+            }, ctx);
+        }
+        catch (err) {
+            logger.warn("subagent_spawned handler failed", { err: errMsg(err) });
+        }
+    });
+    api.on("subagent_delivery_target", (event, subagentCtx) => {
+        try {
+            const ctx = readContext(subagentCtx);
+            const evObj = asRecord(event);
+            const ctxObj = asRecord(subagentCtx);
+            const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
+                nonEmptyString(ctxObj?.childSessionKey);
+            if (!childSessionKey)
+                return;
+            const requesterOrigin = asRecord(evObj?.requesterOrigin) ?? {};
+            tracker.mergeSubagentSpan({
+                childSessionKey,
+                status: "delivery_target",
+                patch: {
+                    delivery: {
+                        channel: nonEmptyString(requesterOrigin.channel),
+                        accountId: nonEmptyString(requesterOrigin.accountId),
+                        to: nonEmptyString(requesterOrigin.to),
+                        threadId: requesterOrigin.threadId,
+                        childRunId: nonEmptyString(evObj?.childRunId),
+                        spawnMode: nonEmptyString(evObj?.spawnMode),
+                        expectsCompletionMessage: typeof evObj?.expectsCompletionMessage === "boolean"
+                            ? evObj.expectsCompletionMessage
+                            : undefined,
+                    },
+                },
+            }, ctx);
+        }
+        catch (err) {
+            logger.warn("subagent_delivery_target handler failed", { err: errMsg(err) });
+        }
+    });
+    api.on("subagent_ended", (event, subagentCtx) => {
+        try {
+            const ctx = readContext(subagentCtx);
+            const evObj = asRecord(event);
+            const ctxObj = asRecord(subagentCtx);
+            const childSessionKey = nonEmptyString(evObj?.targetSessionKey) ??
+                nonEmptyString(ctxObj?.childSessionKey) ??
+                nonEmptyString(evObj?.childSessionKey);
+            if (!childSessionKey)
+                return;
+            const error = evObj?.error;
+            tracker.finalizeSubagentSpan({
+                childSessionKey,
+                status: "ended",
+                output: error === undefined
+                    ? {
+                        outcome: evObj?.outcome,
+                        reason: evObj?.reason,
+                    }
+                    : undefined,
+                error: error !== undefined ? error : undefined,
+            }, ctx);
+        }
+        catch (err) {
+            logger.warn("subagent_ended handler failed", { err: errMsg(err) });
+        }
+    });
+    // ─── Agent end (sweep orphans + emit marker) ───────────────────────────
+    api.on("agent_end", (event, agentCtx) => {
+        try {
+            const ctx = readContext(agentCtx);
+            const sessionKey = readSessionKey(agentCtx, event);
+            const runId = readRunId(agentCtx, event);
+            if (!sessionKey || !runId) {
+                logger.warn("agent_end missing sessionKey/runId; skipping marker");
+                return;
+            }
+            const evObj = asRecord(event);
+            tracker.captureAgentEnd({
+                sessionKey,
+                runId,
+                outcome: evObj?.outcome,
+                error: evObj?.error,
+                ...ctx,
+            });
+        }
+        catch (err) {
+            logger.warn("agent_end handler failed", { err: errMsg(err) });
+        }
+    });
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────
+function asRecord(v) {
+    if (v && typeof v === "object" && !Array.isArray(v)) {
+        return v;
+    }
+    return undefined;
+}
+function nonEmptyString(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+/**
+ * Pull senpi-context headers out of agentCtx. Several common locations are
+ * checked because the exact shape depends on OpenClaw's runtime extension SDK.
+ */
+function readContext(agentCtx) {
+    const headers = readHeaders(agentCtx);
+    return {
+        correlationId: headers[HEADER_CORRELATION_ID] ?? null,
+        address: headers[HEADER_ADDRESS] ?? null,
+        recipeName: headers[HEADER_RECIPE_NAME] ?? null,
+        runtimeId: headers[HEADER_RUNTIME_ID] ?? null,
+        runtimeVersion: headers[HEADER_RUNTIME_VERSION] ?? null,
+    };
+}
+function readHeaders(agentCtx) {
+    const ctxObj = asRecord(agentCtx);
+    if (!ctxObj)
+        return {};
+    const candidates = [
+        asRecord(ctxObj.headers),
+        asRecord(asRecord(ctxObj.request)?.headers),
+        asRecord(ctxObj.requestHeaders),
+        asRecord(asRecord(ctxObj.meta)?.headers),
+    ];
+    const out = {};
+    for (const candidate of candidates) {
+        if (!candidate)
+            continue;
+        for (const [k, v] of Object.entries(candidate)) {
+            // HTTP headers should be case-insensitive; normalize to lowercase.
+            const lk = k.toLowerCase();
+            if (typeof v === "string" && v.length > 0 && out[lk] === undefined) {
+                out[lk] = v;
+            }
+            else if (Array.isArray(v) && v.length > 0 && typeof v[0] === "string") {
+                out[lk] = v[0];
+            }
+        }
+    }
+    return out;
+}
+function readSessionKey(ctx, event) {
+    return (nonEmptyString(asRecord(ctx)?.sessionKey) ??
+        nonEmptyString(asRecord(ctx)?.sessionId) ??
+        nonEmptyString(asRecord(event)?.sessionKey) ??
+        nonEmptyString(asRecord(event)?.sessionId));
+}
+function readRunId(ctx, event) {
+    return (nonEmptyString(asRecord(ctx)?.runId) ??
+        nonEmptyString(asRecord(event)?.runId));
+}
+function extractLlmInput(event) {
+    const ev = asRecord(event);
+    if (!ev)
+        return {};
+    return {
+        system: ev.systemPrompt ?? ev.system,
+        prompt: ev.prompt,
+        messages: ev.historyMessages ?? ev.messages,
+        model: ev.model,
+        provider: ev.provider,
+        imagesCount: ev.imagesCount,
+        temperature: ev.temperature,
+        maxTokens: ev.maxTokens,
+        tools: ev.tools,
+    };
+}
+function extractLlmOutput(event) {
+    const ev = asRecord(event);
+    if (!ev)
+        return { model: null, tokensIn: null, tokensOut: null };
+    const usage = asRecord(ev.usage);
+    return {
+        output: {
+            assistantTexts: ev.assistantTexts,
+            lastAssistant: ev.lastAssistant,
+            content: ev.content,
+            finishReason: ev.finishReason ?? ev.stopReason,
+        },
+        model: nonEmptyString(ev.model) ?? null,
+        // Token field naming varies by provider:
+        //   Anthropic       → input_tokens / output_tokens
+        //   OpenAI          → promptTokens / completionTokens
+        //   OpenClaw/Gemini → input        / output
+        tokensIn: firstNumber(usage?.input_tokens, usage?.promptTokens, usage?.input),
+        tokensOut: firstNumber(usage?.output_tokens, usage?.completionTokens, usage?.output),
+    };
+}
+function firstNumber(...values) {
+    for (const v of values) {
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+    }
+    return null;
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=span-hooks.js.map

package/dist/tracking/spans/span-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-hooks.js","sourceRoot":"","sources":["../../../src/tracking/spans/span-hooks.ts"],"names":[],"mappings":"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"}

package/dist/tracking/spans/span-tracker.d.ts

@@ -0,0 +1,120 @@
+import type { EmissionSource, SpanTransport } from "./types.js";
+export interface SpanContextFields {
+    correlationId?: string | null;
+    address?: string | null;
+    recipeName?: string | null;
+    runtimeId?: string | null;
+    runtimeVersion?: string | null;
+}
+export interface OpenLlmSpanInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    emissionSource: EmissionSource;
+    startedAt?: number;
+    input: Record<string, unknown>;
+}
+export interface FinalizeLlmSpanInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    output?: Record<string, unknown>;
+    error?: unknown;
+    model?: string | null;
+    tokensIn?: number | null;
+    tokensOut?: number | null;
+    costUsd?: number | null;
+}
+export interface OpenToolSpanInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    emissionSource: EmissionSource;
+    toolCallId: string | null;
+    toolName: string;
+    toolInput?: Record<string, unknown>;
+    startedAt?: number;
+}
+export interface FinalizeToolSpanInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    toolCallId: string | null;
+    toolName: string;
+    output?: unknown;
+    error?: unknown;
+    durationMs?: number;
+}
+export interface DirectLlmSpanInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    startedAt: number;
+    endedAt: number;
+    model?: string | null;
+    tokensIn?: number | null;
+    tokensOut?: number | null;
+    costUsd?: number | null;
+    input: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    error?: unknown;
+    parentSpanId?: string | null;
+}
+export interface OpenSubagentInput extends SpanContextFields {
+    hostSessionKey: string;
+    hostRunId: string;
+    childSessionKey: string;
+    parentSpanId: string | null;
+    input: Record<string, unknown>;
+    startedAt?: number;
+}
+export interface MergeSubagentInput {
+    childSessionKey: string;
+    /** Status to record (e.g., "spawned", "delivery_target"). */
+    status: string;
+    /** Additional fields to merge into `data` (e.g., delivery metadata). */
+    patch?: Record<string, unknown>;
+}
+export interface FinalizeSubagentInput {
+    childSessionKey: string;
+    status: string;
+    output?: Record<string, unknown>;
+    error?: unknown;
+}
+export interface AgentEndInput extends SpanContextFields {
+    sessionKey: string;
+    runId: string;
+    outcome?: unknown;
+    error?: unknown;
+}
+export interface SpanTrackerOptions {
+    transport: SpanTransport;
+    /** Override Date.now for tests. */
+    now?: () => number;
+    staleTimeoutMs?: number;
+    sweepIntervalMs?: number;
+    /** Start the periodic stale sweeper. Set false in tests for determinism. */
+    enableSweeper?: boolean;
+}
+export declare class SpanTracker {
+    private readonly transport;
+    private readonly now;
+    private readonly staleTimeoutMs;
+    private readonly openSpans;
+    private readonly openSubagents;
+    private toolSeq;
+    private sweepTimer;
+    constructor(options: SpanTrackerOptions);
+    openLlmSpan(input: OpenLlmSpanInput): string;
+    finalizeLlmSpan(input: FinalizeLlmSpanInput): void;
+    /** Returns the id of the currently-open LLM span for (session, run), or null. */
+    getActiveLlmSpanId(sessionKey: string, runId: string): string | null;
+    openToolSpan(input: OpenToolSpanInput): string;
+    finalizeToolSpan(input: FinalizeToolSpanInput): void;
+    openSubagentSpan(input: OpenSubagentInput): string;
+    /** Merge fields into an existing subagent (e.g., on _spawned, _delivery_target). Lazy-creates if missing. */
+    mergeSubagentSpan(input: MergeSubagentInput, context?: SpanContextFields): void;
+    finalizeSubagentSpan(input: FinalizeSubagentInput, context?: SpanContextFields): void;
+    captureAgentEnd(input: AgentEndInput): void;
+    captureLlmSpan(input: DirectLlmSpanInput): void;
+    sweepStale(): void;
+    shutdown(): Promise<void>;
+    private enqueueOrphan;
+    private enqueueSubagentOrphan;
+}
+//# sourceMappingURL=span-tracker.d.ts.map

package/dist/tracking/spans/span-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-tracker.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/span-tracker.ts"],"names":[],"mappings":"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"}