weave-codex 0.1.0

package/dist/semconv.js

@@ -0,0 +1,41 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * The pieces the OpenTelemetry semantic-conventions package doesn't give us as a
+ * usable value. Standard attribute keys and gen_ai.* enum values are imported
+ * straight from the package where they're used (see spans/emit.ts); this file
+ * holds only what the package doesn't export:
+ *   - gen_ai.tool.type values (the package exports the key, not the values)
+ *   - our vendor keys (weave / wandb / codex / mcp)
+ */
+/** `gen_ai.tool.type` values (the spec package exports the key, not the values). */
+export const TOOL_TYPE = {
+    FUNCTION: 'function', // local_shell, apply_patch, MCP, user functions
+    EXTENSION: 'extension', // provider-executed tools (e.g. web_search)
+};
+/**
+ * MCP tool-call context. Attached to the same execute_tool span (per the spec)
+ * rather than a separate MCP span. Not typed by the spec package.
+ */
+export const MCP = {
+    SERVER_NAME: 'mcp.server.name',
+    TOOL_NAME: 'mcp.tool.name',
+};
+/** Resource attributes — entity/project routing also goes via the project_id header. */
+export const RESOURCE = {
+    WANDB_ENTITY: 'wandb.entity',
+    WANDB_PROJECT: 'wandb.project',
+    SDK_LANGUAGE: 'weave.sdk.language',
+    SDK_VERSION: 'weave.sdk.version',
+};
+/** Codex-specific vendor extensions (no canonical gen_ai key exists for these). */
+export const CODEX = {
+    SESSION_ID: 'codex.session.id',
+    TURN_ID: 'codex.turn.id',
+    CLI_VERSION: 'codex.cli_version',
+    CWD: 'codex.cwd',
+    /** Stamped only once we wire up model price tables; UI sums tokens meanwhile. */
+    COST_USD: 'codex.usage.cost_usd',
+};
+//# sourceMappingURL=semconv.js.map

package/dist/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../src/semconv.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAEhC;;;;;;;GAOG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,UAAU,EAAE,gDAAgD;IACtE,SAAS,EAAE,WAAW,EAAE,4CAA4C;CAC5D,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,eAAe;CAClB,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,mBAAmB;CACxB,CAAC;AAEX,mFAAmF;AACnF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,eAAe;IACxB,WAAW,EAAE,mBAAmB;IAChC,GAAG,EAAE,WAAW;IAChB,iFAAiF;IACjF,QAAQ,EAAE,sBAAsB;CACxB,CAAC"}

package/dist/spans/emit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Turn a ReconstructedTurn into a backdated OTEL span tree:
+ *
+ *   invoke_agent codex            (root; start/end = turn bounds)
+ *   ├─ chat <model>               (one per model call; per-call usage + output)
+ *   └─ execute_tool <name>        (one per tool; arguments + result)
+ *
+ * chat and execute_tool are siblings under the turn (the GenAI-spec convention).
+ * Every span carries gen_ai.conversation.id so Weave stitches turns server-side.
+ * Start/end times come from the rollout, which is the whole point of the shim.
+ */
+import { type Tracer } from '@opentelemetry/api';
+import type { ReconstructedTurn } from '../model.js';
+export declare function emitTurn(tracer: Tracer, turn: ReconstructedTurn, captureContent: boolean): void;

package/dist/spans/emit.js

@@ -0,0 +1,143 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Turn a ReconstructedTurn into a backdated OTEL span tree:
+ *
+ *   invoke_agent codex            (root; start/end = turn bounds)
+ *   ├─ chat <model>               (one per model call; per-call usage + output)
+ *   └─ execute_tool <name>        (one per tool; arguments + result)
+ *
+ * chat and execute_tool are siblings under the turn (the GenAI-spec convention).
+ * Every span carries gen_ai.conversation.id so Weave stitches turns server-side.
+ * Start/end times come from the rollout, which is the whole point of the shim.
+ */
+import { context, SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
+import { ATTR_ERROR_TYPE, ATTR_SERVER_ADDRESS, ATTR_SERVER_PORT, } from '@opentelemetry/semantic-conventions';
+import { ATTR_GEN_AI_AGENT_NAME, ATTR_GEN_AI_AGENT_VERSION, ATTR_GEN_AI_CONVERSATION_ID, ATTR_GEN_AI_INPUT_MESSAGES, ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_OUTPUT_MESSAGES, ATTR_GEN_AI_PROVIDER_NAME, ATTR_GEN_AI_REQUEST_MODEL, ATTR_GEN_AI_REQUEST_STREAM, ATTR_GEN_AI_RESPONSE_FINISH_REASONS, ATTR_GEN_AI_RESPONSE_MODEL, ATTR_GEN_AI_TOOL_CALL_ARGUMENTS, ATTR_GEN_AI_TOOL_CALL_ID, ATTR_GEN_AI_TOOL_CALL_RESULT, ATTR_GEN_AI_TOOL_NAME, ATTR_GEN_AI_TOOL_TYPE, ATTR_GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS, ATTR_GEN_AI_USAGE_INPUT_TOKENS, ATTR_GEN_AI_USAGE_OUTPUT_TOKENS, ATTR_GEN_AI_USAGE_REASONING_OUTPUT_TOKENS, GEN_AI_OPERATION_NAME_VALUE_CHAT, GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL, GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT, GEN_AI_PROVIDER_NAME_VALUE_OPENAI, } from '@opentelemetry/semantic-conventions/incubating';
+import { CODEX, MCP, TOOL_TYPE } from '../semconv.js';
+import { chatOutputMessages, finalMessages, userMessages } from './messages.js';
+const AGENT_NAME = 'codex';
+const OPENAI_API_HOST = 'api.openai.com';
+const OPENAI_API_PORT = 443;
+/** Truncate any single attribute value (tool args/results, messages) past this. */
+const MAX_ATTR_VALUE_BYTES = 128 * 1024;
+const TRUNCATION_MARKER = '…[truncated]';
+export function emitTurn(tracer, turn, captureContent) {
+    const root = tracer.startSpan(`${GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT} ${AGENT_NAME}`, {
+        kind: SpanKind.INTERNAL, // in-process agent (GenAI-spec span kind)
+        startTime: turn.startTime,
+        attributes: invokeAgentAttributes(turn, captureContent),
+    });
+    const parentCtx = trace.setSpan(context.active(), root);
+    for (const chat of turn.chats)
+        emitChat(tracer, parentCtx, turn, chat, captureContent);
+    for (const tool of turn.tools)
+        emitTool(tracer, parentCtx, turn, tool, captureContent);
+    root.end(turn.endTime);
+}
+function invokeAgentAttributes(turn, captureContent) {
+    const spanAttributes = {
+        [ATTR_GEN_AI_OPERATION_NAME]: GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT,
+        [ATTR_GEN_AI_PROVIDER_NAME]: GEN_AI_PROVIDER_NAME_VALUE_OPENAI,
+        [ATTR_GEN_AI_AGENT_NAME]: AGENT_NAME,
+        [ATTR_GEN_AI_CONVERSATION_ID]: turn.conversationId,
+        [ATTR_GEN_AI_REQUEST_MODEL]: turn.model,
+        [ATTR_GEN_AI_RESPONSE_FINISH_REASONS]: ['stop'],
+        [CODEX.SESSION_ID]: turn.sessionId,
+        [CODEX.TURN_ID]: turn.turnId,
+    };
+    if (turn.cliVersion)
+        spanAttributes[ATTR_GEN_AI_AGENT_VERSION] = turn.cliVersion;
+    if (turn.cwd)
+        spanAttributes[CODEX.CWD] = turn.cwd;
+    addUsage(spanAttributes, turn.usageTotal);
+    if (captureContent) {
+        setJson(spanAttributes, ATTR_GEN_AI_INPUT_MESSAGES, userMessages(turn));
+        setJson(spanAttributes, ATTR_GEN_AI_OUTPUT_MESSAGES, finalMessages(turn));
+    }
+    return spanAttributes;
+}
+function emitChat(tracer, parent, turn, chat, captureContent) {
+    const spanAttributes = {
+        [ATTR_GEN_AI_OPERATION_NAME]: GEN_AI_OPERATION_NAME_VALUE_CHAT,
+        [ATTR_GEN_AI_PROVIDER_NAME]: GEN_AI_PROVIDER_NAME_VALUE_OPENAI,
+        [ATTR_GEN_AI_REQUEST_MODEL]: turn.model,
+        [ATTR_GEN_AI_RESPONSE_MODEL]: turn.model,
+        [ATTR_GEN_AI_CONVERSATION_ID]: turn.conversationId,
+        [ATTR_GEN_AI_REQUEST_STREAM]: true,
+        [ATTR_GEN_AI_RESPONSE_FINISH_REASONS]: [chat.finishReason],
+        [ATTR_SERVER_ADDRESS]: OPENAI_API_HOST,
+        [ATTR_SERVER_PORT]: OPENAI_API_PORT,
+    };
+    if (chat.usage)
+        addUsage(spanAttributes, chat.usage);
+    if (captureContent)
+        setJson(spanAttributes, ATTR_GEN_AI_OUTPUT_MESSAGES, chatOutputMessages(chat));
+    const span = tracer.startSpan(`${GEN_AI_OPERATION_NAME_VALUE_CHAT} ${turn.model}`, {
+        kind: SpanKind.CLIENT, // model round-trip (GenAI-spec span kind)
+        startTime: clamp(chat.startTime, turn.startTime, turn.endTime),
+        attributes: spanAttributes,
+    }, parent);
+    span.end(clamp(chat.endTime, turn.startTime, turn.endTime));
+}
+function emitTool(tracer, parent, turn, tool, captureContent) {
+    const spanAttributes = {
+        [ATTR_GEN_AI_OPERATION_NAME]: GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL,
+        [ATTR_GEN_AI_TOOL_NAME]: tool.name,
+        [ATTR_GEN_AI_TOOL_TYPE]: tool.kind === 'web_search' ? TOOL_TYPE.EXTENSION : TOOL_TYPE.FUNCTION,
+        [ATTR_GEN_AI_TOOL_CALL_ID]: tool.callId,
+        [ATTR_GEN_AI_CONVERSATION_ID]: turn.conversationId,
+    };
+    if (tool.mcpServer)
+        spanAttributes[MCP.SERVER_NAME] = tool.mcpServer;
+    if (tool.error)
+        spanAttributes[ATTR_ERROR_TYPE] = tool.error;
+    if (captureContent) {
+        if (tool.arguments)
+            spanAttributes[ATTR_GEN_AI_TOOL_CALL_ARGUMENTS] = truncate(tool.arguments);
+        if (tool.result != null)
+            spanAttributes[ATTR_GEN_AI_TOOL_CALL_RESULT] = truncate(tool.result);
+    }
+    const span = tracer.startSpan(`${GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL} ${tool.name}`, {
+        kind: SpanKind.INTERNAL, // tool execution (GenAI-spec span kind)
+        startTime: clamp(tool.startTime, turn.startTime, turn.endTime),
+        attributes: spanAttributes,
+    }, parent);
+    if (tool.error)
+        span.setStatus({ code: SpanStatusCode.ERROR, message: tool.error });
+    span.end(clamp(tool.endTime, turn.startTime, turn.endTime));
+}
+function addUsage(spanAttributes, usage) {
+    spanAttributes[ATTR_GEN_AI_USAGE_INPUT_TOKENS] = usage.inputTokens;
+    spanAttributes[ATTR_GEN_AI_USAGE_OUTPUT_TOKENS] = usage.outputTokens;
+    if (usage.cachedInputTokens > 0) {
+        spanAttributes[ATTR_GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS] =
+            usage.cachedInputTokens;
+    }
+    if (usage.reasoningOutputTokens > 0) {
+        spanAttributes[ATTR_GEN_AI_USAGE_REASONING_OUTPUT_TOKENS] =
+            usage.reasoningOutputTokens;
+    }
+}
+function setJson(spanAttributes, key, value) {
+    if (Array.isArray(value) && value.length === 0)
+        return;
+    spanAttributes[key] = truncate(JSON.stringify(value));
+}
+function truncate(value) {
+    const buffer = Buffer.from(value, 'utf8');
+    if (buffer.byteLength <= MAX_ATTR_VALUE_BYTES)
+        return value;
+    // Cut on a byte boundary (the budget is bytes), and let a non-fatal decode drop
+    // a trailing split multibyte char so we never emit a lone surrogate.
+    const keepBytes = MAX_ATTR_VALUE_BYTES - Buffer.byteLength(TRUNCATION_MARKER, 'utf8');
+    const head = new TextDecoder('utf-8').decode(buffer.subarray(0, keepBytes));
+    return head + TRUNCATION_MARKER;
+}
+/** Keep a child span's timestamps within its parent's window so traces render. */
+function clamp(time, windowStart, windowEnd) {
+    const clampedMs = Math.min(Math.max(time.getTime(), windowStart.getTime()), windowEnd.getTime());
+    return new Date(clampedMs);
+}
+//# sourceMappingURL=emit.js.map

package/dist/spans/emit.js.map

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

package/dist/spans/messages.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Build `gen_ai.input.messages` / `gen_ai.output.messages` payloads.
+ *
+ * The Weave Agents extractor mines `text` and `reasoning` parts for chat content
+ * and renders tool cards from `execute_tool` SPANS (not from tool_call message
+ * parts) — so we keep messages focused on assistant content and let the tool
+ * spans carry arguments/results. Shapes follow the Weave SDK MessagePart union.
+ */
+import type { ChatCall, ReconstructedTurn } from '../model.js';
+interface MessagePart {
+    type: 'text' | 'reasoning' | 'tool_call';
+    content?: string;
+    toolCallId?: string;
+    toolName?: string;
+    arguments?: string;
+}
+interface ChatMessage {
+    role: string;
+    content?: string;
+    parts?: MessagePart[];
+    finish_reason?: string;
+}
+export declare function userMessages(turn: ReconstructedTurn): ChatMessage[];
+export declare function finalMessages(turn: ReconstructedTurn): ChatMessage[];
+export declare function chatOutputMessages(chat: ChatCall): ChatMessage[];
+export {};

package/dist/spans/messages.js

@@ -0,0 +1,38 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+export function userMessages(turn) {
+    if (!turn.userMessage)
+        return [];
+    return [{ role: 'user', content: turn.userMessage }];
+}
+export function finalMessages(turn) {
+    if (!turn.finalAssistantMessage)
+        return [];
+    return [
+        {
+            role: 'assistant',
+            content: turn.finalAssistantMessage,
+            finish_reason: 'stop',
+        },
+    ];
+}
+export function chatOutputMessages(chat) {
+    const parts = [];
+    if (chat.reasoning)
+        parts.push({ type: 'reasoning', content: chat.reasoning });
+    if (chat.text)
+        parts.push({ type: 'text', content: chat.text });
+    for (const toolCall of chat.toolCalls) {
+        parts.push({
+            type: 'tool_call',
+            toolCallId: toolCall.callId,
+            toolName: toolCall.name,
+            ...(toolCall.arguments ? { arguments: toolCall.arguments } : {}),
+        });
+    }
+    if (parts.length === 0)
+        return [];
+    return [{ role: 'assistant', parts, finish_reason: chat.finishReason }];
+}
+//# sourceMappingURL=messages.js.map

package/dist/spans/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/spans/messages.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AA2BhC,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,IAAI,CAAC,IAAI,CAAC,qBAAqB;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO;QACL;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,IAAI,CAAC,qBAAqB;YACnC,aAAa,EAAE,MAAM;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAC,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAC,CAAC,CAAC;IAC9D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,EAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/spans/tracer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A self-owned OpenTelemetry pipeline pointed at Weave's Agents OTLP endpoint.
+ * Spans are built through the raw OTel API rather than the Weave TS SDK's GenAI
+ * helpers because those helpers cannot set historical timestamps, and this
+ * collector backdates every span to when the turn actually happened. The emitter
+ * can move onto the SDK if it gains start/end-time parameters.
+ *
+ * Auth headers for the Agents OTLP endpoint:
+ *   Authorization: Basic base64("api:" + WANDB_API_KEY)
+ *   project_id:    <entity>/<project>
+ */
+import type { Tracer } from '@opentelemetry/api';
+import type { ResolvedConfig } from '../config.js';
+/** The OTel pipeline as one unit; injected into the collector so tests can swap in an in-memory exporter. */
+export interface TracerHandle {
+    tracer: Tracer;
+    /** Flush queued spans and tear down the exporter. Always await before exit. */
+    shutdown: () => Promise<void>;
+}
+export declare function buildTracer(config: ResolvedConfig): TracerHandle;

package/dist/spans/tracer.js

@@ -0,0 +1,43 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { BasicTracerProvider, BatchSpanProcessor, } from '@opentelemetry/sdk-trace-base';
+import { GENAI_OTLP_PATH, VERSION } from '../constants.js';
+import { RESOURCE } from '../semconv.js';
+const SERVICE_NAME = 'weave-codex';
+export function buildTracer(config) {
+    const exporter = new OTLPTraceExporter({
+        url: `${config.baseUrl}${GENAI_OTLP_PATH}`,
+        headers: {
+            Authorization: `Basic ${Buffer.from(`api:${config.apiKey}`).toString('base64')}`,
+            project_id: config.projectId,
+        },
+    });
+    const resource = resourceFromAttributes({
+        'service.name': SERVICE_NAME,
+        [RESOURCE.WANDB_ENTITY]: config.entity,
+        [RESOURCE.WANDB_PROJECT]: config.project,
+        [RESOURCE.SDK_LANGUAGE]: 'node',
+        [RESOURCE.SDK_VERSION]: VERSION,
+    });
+    const provider = new BasicTracerProvider({
+        resource,
+        spanProcessors: [new BatchSpanProcessor(exporter)],
+    });
+    return {
+        tracer: provider.getTracer(SERVICE_NAME, VERSION),
+        shutdown: async () => {
+            // Always tear the provider down, but let a forceFlush rejection (transport
+            // failure) propagate so the caller knows the spans did not land.
+            try {
+                await provider.forceFlush();
+            }
+            finally {
+                await provider.shutdown();
+            }
+        },
+    };
+}
+//# sourceMappingURL=tracer.js.map

package/dist/spans/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/spans/tracer.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAchC,OAAO,EAAC,iBAAiB,EAAC,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAC,eAAe,EAAE,OAAO,EAAC,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAEvC,MAAM,YAAY,GAAG,aAAa,CAAC;AASnC,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACrC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG,eAAe,EAAE;QAC1C,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAChF,UAAU,EAAE,MAAM,CAAC,SAAS;SAC7B;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACtC,cAAc,EAAE,YAAY;QAC5B,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM;QACtC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,OAAO;QACxC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;QAC/B,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC;QACvC,QAAQ;QACR,cAAc,EAAE,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;KACnD,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC;QACjD,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,2EAA2E;YAC3E,iEAAiE;YACjE,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC9B,CAAC;oBAAS,CAAC;gBACT,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "weave-codex",
+  "version": "0.1.0",
+  "description": "W&B Weave observability for OpenAI Codex CLI — reconstructs gen_ai OpenTelemetry spans from Codex rollout sessions and ships them to Weave, fully off the critical path.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wandb/codex_weave_plugin.git"
+  },
+  "bin": {
+    "weave-codex": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "LICENSES/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/build/postbuild.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "prettier --check . && tsc -p tsconfig.json --noEmit",
+    "format": "prettier --write .",
+    "secrets:scan": "gitleaks dir . --no-banner --redact",
+    "secrets:scan:staged": "gitleaks git --pre-commit --staged --redact --verbose",
+    "check": "npm run build && npm run lint && npm test && npm run secrets:scan",
+    "setup-hooks": "node scripts/install-git-hooks.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "prettier": "^3.3",
+    "typescript": "^5.6",
+    "vitest": "^4.1.8"
+  }
+}