@tokenjam/sdk 0.2.0

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeEvents = exports.TjAttributes = exports.GenAIAttributes = exports.SpanBuilder = exports.SpanStatus = exports.SpanKind = exports.TjClient = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "TjClient", { enumerable: true, get: function () { return client_js_1.TjClient; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return types_js_1.SpanKind; } });
+Object.defineProperty(exports, "SpanStatus", { enumerable: true, get: function () { return types_js_1.SpanStatus; } });
+var span_builder_js_1 = require("./span-builder.js");
+Object.defineProperty(exports, "SpanBuilder", { enumerable: true, get: function () { return span_builder_js_1.SpanBuilder; } });
+var semconv_js_1 = require("./semconv.js");
+Object.defineProperty(exports, "GenAIAttributes", { enumerable: true, get: function () { return semconv_js_1.GenAIAttributes; } });
+Object.defineProperty(exports, "TjAttributes", { enumerable: true, get: function () { return semconv_js_1.TjAttributes; } });
+Object.defineProperty(exports, "ClaudeCodeEvents", { enumerable: true, get: function () { return semconv_js_1.ClaudeCodeEvents; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6D;AAApD,qGAAA,QAAQ,OAAA;AACjB,uCAAgG;AAAzC,oGAAA,QAAQ,OAAA;AAAE,sGAAA,UAAU,OAAA;AAC3E,qDAAgD;AAAvC,8GAAA,WAAW,OAAA;AACpB,2CAA+E;AAAtE,6GAAA,eAAe,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,8GAAA,gBAAgB,OAAA"}

package/dist/semconv.d.ts

@@ -0,0 +1,69 @@
+/**
+ * OpenTelemetry GenAI Semantic Convention attribute names.
+ * Mirrors ocw/otel/semconv.py — keep in sync.
+ */
+export declare const GenAIAttributes: {
+    readonly AGENT_ID: "gen_ai.agent.id";
+    readonly AGENT_NAME: "gen_ai.agent.name";
+    readonly AGENT_VERSION: "gen_ai.agent.version";
+    readonly PROVIDER_NAME: "gen_ai.provider.name";
+    readonly REQUEST_MODEL: "gen_ai.request.model";
+    readonly REQUEST_TYPE: "gen_ai.request.type";
+    readonly INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+    readonly CACHE_READ_TOKENS: "gen_ai.usage.cache_read_tokens";
+    readonly CACHE_CREATE_TOKENS: "gen_ai.usage.cache_creation_tokens";
+    readonly TOOL_NAME: "gen_ai.tool.name";
+    readonly TOOL_DESCRIPTION: "gen_ai.tool.description";
+    readonly TOOL_INPUT: "gen_ai.tool.input";
+    readonly TOOL_OUTPUT: "gen_ai.tool.output";
+    readonly CONVERSATION_ID: "gen_ai.conversation.id";
+    readonly PROMPT_CONTENT: "gen_ai.prompt.content";
+    readonly COMPLETION_CONTENT: "gen_ai.completion.content";
+    readonly SPAN_INVOKE_AGENT: "invoke_agent";
+    readonly SPAN_CREATE_AGENT: "create_agent";
+    readonly SPAN_TOOL_CALL: "gen_ai.tool.call";
+    readonly SPAN_LLM_CALL: "gen_ai.llm.call";
+};
+export declare const TjAttributes: {
+    readonly COST_USD: "ocw.cost_usd";
+    readonly ALERT_TYPE: "ocw.alert.type";
+    readonly ALERT_SEVERITY: "ocw.alert.severity";
+    readonly SANDBOX_EVENT: "ocw.sandbox.event";
+    readonly EGRESS_HOST: "ocw.sandbox.egress_host";
+    readonly EGRESS_PORT: "ocw.sandbox.egress_port";
+    readonly FILESYSTEM_PATH: "ocw.sandbox.filesystem_path";
+    readonly SYSCALL_NAME: "ocw.sandbox.syscall_name";
+};
+/**
+ * Event names and attribute constants from Claude Code's OTel log exporter.
+ * Mirrors ClaudeCodeEvents in ocw/otel/semconv.py — keep in sync.
+ */
+export declare const ClaudeCodeEvents: {
+    readonly API_REQUEST: "claude_code.api_request";
+    readonly TOOL_RESULT: "claude_code.tool_result";
+    readonly API_ERROR: "claude_code.api_error";
+    readonly USER_PROMPT: "claude_code.user_prompt";
+    readonly TOOL_DECISION: "claude_code.tool_decision";
+    readonly SESSION_ID: "session.id";
+    readonly PROMPT_ID: "prompt.id";
+    readonly EVENT_SEQUENCE: "event.sequence";
+    readonly COST_USD: "cost_usd";
+    readonly DURATION_MS: "duration_ms";
+    readonly SPEED: "speed";
+    readonly INPUT_TOKENS: "input_tokens";
+    readonly OUTPUT_TOKENS: "output_tokens";
+    readonly CACHE_READ_TOKENS: "cache_read_tokens";
+    readonly CACHE_CREATION_TOKENS: "cache_creation_tokens";
+    readonly TOOL_NAME: "tool_name";
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+    readonly TOOL_PARAMETERS: "tool_parameters";
+    readonly TOOL_INPUT: "tool_input";
+    readonly DECISION_TYPE: "decision_type";
+    readonly TOOL_RESULT_SIZE: "tool_result_size_bytes";
+    readonly STATUS_CODE_HTTP: "status_code";
+    readonly ATTEMPT: "attempt";
+    readonly DECISION: "decision";
+    readonly DECISION_SOURCE: "source";
+};

package/dist/semconv.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeEvents = exports.TjAttributes = exports.GenAIAttributes = void 0;
+/**
+ * OpenTelemetry GenAI Semantic Convention attribute names.
+ * Mirrors ocw/otel/semconv.py — keep in sync.
+ */
+exports.GenAIAttributes = {
+    AGENT_ID: "gen_ai.agent.id",
+    AGENT_NAME: "gen_ai.agent.name",
+    AGENT_VERSION: "gen_ai.agent.version",
+    PROVIDER_NAME: "gen_ai.provider.name",
+    REQUEST_MODEL: "gen_ai.request.model",
+    REQUEST_TYPE: "gen_ai.request.type",
+    INPUT_TOKENS: "gen_ai.usage.input_tokens",
+    OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+    CACHE_READ_TOKENS: "gen_ai.usage.cache_read_tokens",
+    CACHE_CREATE_TOKENS: "gen_ai.usage.cache_creation_tokens",
+    TOOL_NAME: "gen_ai.tool.name",
+    TOOL_DESCRIPTION: "gen_ai.tool.description",
+    TOOL_INPUT: "gen_ai.tool.input",
+    TOOL_OUTPUT: "gen_ai.tool.output",
+    CONVERSATION_ID: "gen_ai.conversation.id",
+    PROMPT_CONTENT: "gen_ai.prompt.content",
+    COMPLETION_CONTENT: "gen_ai.completion.content",
+    SPAN_INVOKE_AGENT: "invoke_agent",
+    SPAN_CREATE_AGENT: "create_agent",
+    SPAN_TOOL_CALL: "gen_ai.tool.call",
+    SPAN_LLM_CALL: "gen_ai.llm.call",
+};
+exports.TjAttributes = {
+    COST_USD: "ocw.cost_usd",
+    ALERT_TYPE: "ocw.alert.type",
+    ALERT_SEVERITY: "ocw.alert.severity",
+    SANDBOX_EVENT: "ocw.sandbox.event",
+    EGRESS_HOST: "ocw.sandbox.egress_host",
+    EGRESS_PORT: "ocw.sandbox.egress_port",
+    FILESYSTEM_PATH: "ocw.sandbox.filesystem_path",
+    SYSCALL_NAME: "ocw.sandbox.syscall_name",
+};
+/**
+ * Event names and attribute constants from Claude Code's OTel log exporter.
+ * Mirrors ClaudeCodeEvents in ocw/otel/semconv.py — keep in sync.
+ */
+exports.ClaudeCodeEvents = {
+    // Event names (logRecord body values)
+    API_REQUEST: "claude_code.api_request",
+    TOOL_RESULT: "claude_code.tool_result",
+    API_ERROR: "claude_code.api_error",
+    USER_PROMPT: "claude_code.user_prompt",
+    TOOL_DECISION: "claude_code.tool_decision",
+    // Standard context attributes present on all events
+    SESSION_ID: "session.id",
+    PROMPT_ID: "prompt.id",
+    EVENT_SEQUENCE: "event.sequence",
+    // api_request attributes
+    COST_USD: "cost_usd",
+    DURATION_MS: "duration_ms",
+    SPEED: "speed",
+    INPUT_TOKENS: "input_tokens",
+    OUTPUT_TOKENS: "output_tokens",
+    CACHE_READ_TOKENS: "cache_read_tokens",
+    CACHE_CREATION_TOKENS: "cache_creation_tokens",
+    // tool_result attributes
+    TOOL_NAME: "tool_name",
+    SUCCESS: "success",
+    ERROR: "error",
+    TOOL_PARAMETERS: "tool_parameters",
+    TOOL_INPUT: "tool_input",
+    DECISION_TYPE: "decision_type",
+    TOOL_RESULT_SIZE: "tool_result_size_bytes",
+    // api_error attributes
+    STATUS_CODE_HTTP: "status_code",
+    ATTEMPT: "attempt",
+    // tool_decision attributes
+    DECISION: "decision",
+    DECISION_SOURCE: "source",
+};
+//# 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;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,2BAA2B;IACzC,aAAa,EAAE,4BAA4B;IAC3C,iBAAiB,EAAE,gCAAgC;IACnD,mBAAmB,EAAE,oCAAoC;IACzD,SAAS,EAAE,kBAAkB;IAC7B,gBAAgB,EAAE,yBAAyB;IAC3C,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,oBAAoB;IACjC,eAAe,EAAE,wBAAwB;IACzC,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAAE,2BAA2B;IAC/C,iBAAiB,EAAE,cAAc;IACjC,iBAAiB,EAAE,cAAc;IACjC,cAAc,EAAE,kBAAkB;IAClC,aAAa,EAAE,iBAAiB;CACxB,CAAC;AAEE,QAAA,YAAY,GAAG;IAC1B,QAAQ,EAAE,cAAc;IACxB,UAAU,EAAE,gBAAgB;IAC5B,cAAc,EAAE,oBAAoB;IACpC,aAAa,EAAE,mBAAmB;IAClC,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,yBAAyB;IACtC,eAAe,EAAE,6BAA6B;IAC9C,YAAY,EAAE,0BAA0B;CAChC,CAAC;AAEX;;;GAGG;AACU,QAAA,gBAAgB,GAAG;IAC9B,sCAAsC;IACtC,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,yBAAyB;IACtC,SAAS,EAAE,uBAAuB;IAClC,WAAW,EAAE,yBAAyB;IACtC,aAAa,EAAE,2BAA2B;IAE1C,oDAAoD;IACpD,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAEhC,yBAAyB;IACzB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,mBAAmB;IACtC,qBAAqB,EAAE,uBAAuB;IAE9C,yBAAyB;IACzB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,eAAe,EAAE,iBAAiB;IAClC,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,wBAAwB;IAE1C,uBAAuB;IACvB,gBAAgB,EAAE,aAAa;IAC/B,OAAO,EAAE,SAAS;IAElB,2BAA2B;IAC3B,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,QAAQ;CACjB,CAAC"}

package/dist/semconv.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/semconv.test.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const semconv_js_1 = require("./semconv.js");
+(0, node_test_1.describe)("GenAIAttributes", () => {
+    (0, node_test_1.it)("has standard GenAI attribute keys", () => {
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.AGENT_ID, "gen_ai.agent.id");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.PROVIDER_NAME, "gen_ai.provider.name");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.REQUEST_MODEL, "gen_ai.request.model");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.INPUT_TOKENS, "gen_ai.usage.input_tokens");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.OUTPUT_TOKENS, "gen_ai.usage.output_tokens");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.TOOL_NAME, "gen_ai.tool.name");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.CONVERSATION_ID, "gen_ai.conversation.id");
+    });
+    (0, node_test_1.it)("has standard span names", () => {
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.SPAN_LLM_CALL, "gen_ai.llm.call");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.SPAN_TOOL_CALL, "gen_ai.tool.call");
+        strict_1.default.equal(semconv_js_1.GenAIAttributes.SPAN_INVOKE_AGENT, "invoke_agent");
+    });
+});
+(0, node_test_1.describe)("TjAttributes", () => {
+    (0, node_test_1.it)("has ocw-specific attribute keys", () => {
+        strict_1.default.equal(semconv_js_1.TjAttributes.COST_USD, "ocw.cost_usd");
+        strict_1.default.equal(semconv_js_1.TjAttributes.ALERT_TYPE, "ocw.alert.type");
+        strict_1.default.equal(semconv_js_1.TjAttributes.SANDBOX_EVENT, "ocw.sandbox.event");
+    });
+});
+//# sourceMappingURL=semconv.test.js.map

package/dist/semconv.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.test.js","sourceRoot":"","sources":["../src/semconv.test.ts"],"names":[],"mappings":";;;;;AAAA,yCAAyC;AACzC,gEAAwC;AACxC,6CAA6D;AAE7D,IAAA,oBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,cAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC1D,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;QACpE,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;QACpE,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QACxE,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;QAC1E,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAC5D,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAA,cAAE,EAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;QAC/D,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACjE,gBAAM,CAAC,KAAK,CAAC,4BAAe,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,oBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,cAAE,EAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,gBAAM,CAAC,KAAK,CAAC,yBAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACpD,gBAAM,CAAC,KAAK,CAAC,yBAAY,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACxD,gBAAM,CAAC,KAAK,CAAC,yBAAY,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/span-builder.d.ts

@@ -0,0 +1,29 @@
+import { type Span, SpanKind, SpanStatus } from "./types.js";
+export declare class SpanBuilder {
+    private span;
+    constructor(name: string);
+    traceId(id: string): this;
+    spanId(id: string): this;
+    parentSpanId(id: string): this;
+    kind(kind: SpanKind): this;
+    status(code: SpanStatus, message?: string): this;
+    startTime(iso: string): this;
+    endTime(iso: string): this;
+    durationMs(ms: number): this;
+    agentId(id: string): this;
+    agentName(name: string): this;
+    agentVersion(version: string): this;
+    sessionId(id: string): this;
+    conversationId(id: string): this;
+    provider(name: string): this;
+    model(name: string): this;
+    inputTokens(n: number): this;
+    outputTokens(n: number): this;
+    cacheReadTokens(n: number): this;
+    cacheCreateTokens(n: number): this;
+    toolName(name: string): this;
+    toolInput(input: string): this;
+    toolOutput(output: string): this;
+    attribute(key: string, value: unknown): this;
+    build(): Span;
+}

package/dist/span-builder.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanBuilder = void 0;
+/**
+ * Fluent builder for constructing Span objects with GenAI semantic conventions.
+ */
+const node_crypto_1 = require("node:crypto");
+const semconv_js_1 = require("./semconv.js");
+const types_js_1 = require("./types.js");
+function newTraceId() {
+    return (0, node_crypto_1.randomUUID)().replace(/-/g, "");
+}
+function newSpanId() {
+    return (0, node_crypto_1.randomUUID)().replace(/-/g, "").slice(0, 16);
+}
+class SpanBuilder {
+    span;
+    constructor(name) {
+        const now = new Date().toISOString();
+        this.span = {
+            spanId: newSpanId(),
+            traceId: newTraceId(),
+            name,
+            kind: types_js_1.SpanKind.CLIENT,
+            statusCode: types_js_1.SpanStatus.OK,
+            startTime: now,
+            attributes: {},
+        };
+    }
+    traceId(id) {
+        this.span.traceId = id;
+        return this;
+    }
+    spanId(id) {
+        this.span.spanId = id;
+        return this;
+    }
+    parentSpanId(id) {
+        this.span.parentSpanId = id;
+        return this;
+    }
+    kind(kind) {
+        this.span.kind = kind;
+        return this;
+    }
+    status(code, message) {
+        this.span.statusCode = code;
+        if (message)
+            this.span.statusMessage = message;
+        return this;
+    }
+    startTime(iso) {
+        this.span.startTime = iso;
+        return this;
+    }
+    endTime(iso) {
+        this.span.endTime = iso;
+        return this;
+    }
+    durationMs(ms) {
+        this.span.durationMs = ms;
+        return this;
+    }
+    agentId(id) {
+        this.span.agentId = id;
+        this.span.attributes[semconv_js_1.GenAIAttributes.AGENT_ID] = id;
+        return this;
+    }
+    agentName(name) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.AGENT_NAME] = name;
+        return this;
+    }
+    agentVersion(version) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.AGENT_VERSION] = version;
+        return this;
+    }
+    sessionId(id) {
+        this.span.sessionId = id;
+        this.span.attributes["gen_ai.session.id"] = id;
+        return this;
+    }
+    conversationId(id) {
+        this.span.conversationId = id;
+        this.span.attributes[semconv_js_1.GenAIAttributes.CONVERSATION_ID] = id;
+        return this;
+    }
+    provider(name) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.PROVIDER_NAME] = name;
+        return this;
+    }
+    model(name) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.REQUEST_MODEL] = name;
+        return this;
+    }
+    inputTokens(n) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.INPUT_TOKENS] = n;
+        return this;
+    }
+    outputTokens(n) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.OUTPUT_TOKENS] = n;
+        return this;
+    }
+    cacheReadTokens(n) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.CACHE_READ_TOKENS] = n;
+        return this;
+    }
+    cacheCreateTokens(n) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.CACHE_CREATE_TOKENS] = n;
+        return this;
+    }
+    toolName(name) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.TOOL_NAME] = name;
+        return this;
+    }
+    toolInput(input) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.TOOL_INPUT] = input;
+        return this;
+    }
+    toolOutput(output) {
+        this.span.attributes[semconv_js_1.GenAIAttributes.TOOL_OUTPUT] = output;
+        return this;
+    }
+    attribute(key, value) {
+        this.span.attributes[key] = value;
+        return this;
+    }
+    build() {
+        const endTime = (!this.span.endTime && this.span.durationMs != null)
+            ? new Date(new Date(this.span.startTime).getTime() + this.span.durationMs).toISOString()
+            : this.span.endTime;
+        return { ...this.span, endTime, attributes: { ...this.span.attributes } };
+    }
+}
+exports.SpanBuilder = SpanBuilder;
+//# sourceMappingURL=span-builder.js.map

package/dist/span-builder.js.map

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

package/dist/span-builder.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/span-builder.test.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const span_builder_js_1 = require("./span-builder.js");
+const types_js_1 = require("./types.js");
+const semconv_js_1 = require("./semconv.js");
+(0, node_test_1.describe)("SpanBuilder", () => {
+    (0, node_test_1.it)("creates a span with required fields", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call").build();
+        strict_1.default.ok(span.spanId);
+        strict_1.default.ok(span.traceId);
+        strict_1.default.equal(span.name, "gen_ai.llm.call");
+        strict_1.default.equal(span.kind, types_js_1.SpanKind.CLIENT);
+        strict_1.default.equal(span.statusCode, types_js_1.SpanStatus.OK);
+        strict_1.default.ok(span.startTime);
+    });
+    (0, node_test_1.it)("sets agent and provider attributes", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .agentId("my-agent")
+            .provider("anthropic")
+            .model("claude-haiku-4-5")
+            .build();
+        strict_1.default.equal(span.agentId, "my-agent");
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.AGENT_ID], "my-agent");
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.PROVIDER_NAME], "anthropic");
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.REQUEST_MODEL], "claude-haiku-4-5");
+    });
+    (0, node_test_1.it)("sets token counts", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .inputTokens(1000)
+            .outputTokens(200)
+            .cacheReadTokens(500)
+            .build();
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.INPUT_TOKENS], 1000);
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.OUTPUT_TOKENS], 200);
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.CACHE_READ_TOKENS], 500);
+    });
+    (0, node_test_1.it)("sets tool call attributes", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.tool.call")
+            .kind(types_js_1.SpanKind.INTERNAL)
+            .toolName("search")
+            .toolInput('{"query": "test"}')
+            .toolOutput('{"results": []}')
+            .build();
+        strict_1.default.equal(span.kind, types_js_1.SpanKind.INTERNAL);
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.TOOL_NAME], "search");
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.TOOL_INPUT], '{"query": "test"}');
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.TOOL_OUTPUT], '{"results": []}');
+    });
+    (0, node_test_1.it)("sets conversation and session IDs", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .conversationId("conv-123")
+            .sessionId("sess-456")
+            .build();
+        strict_1.default.equal(span.conversationId, "conv-123");
+        strict_1.default.equal(span.sessionId, "sess-456");
+        strict_1.default.equal(span.attributes[semconv_js_1.GenAIAttributes.CONVERSATION_ID], "conv-123");
+    });
+    (0, node_test_1.it)("calculates endTime from durationMs", () => {
+        const start = "2026-03-28T10:00:00.000Z";
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .startTime(start)
+            .durationMs(500)
+            .build();
+        strict_1.default.equal(span.endTime, "2026-03-28T10:00:00.500Z");
+    });
+    (0, node_test_1.it)("sets custom attributes", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .attribute("custom.key", "custom-value")
+            .attribute("custom.number", 42)
+            .build();
+        strict_1.default.equal(span.attributes["custom.key"], "custom-value");
+        strict_1.default.equal(span.attributes["custom.number"], 42);
+    });
+    (0, node_test_1.it)("sets error status", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .status(types_js_1.SpanStatus.ERROR, "rate limited")
+            .build();
+        strict_1.default.equal(span.statusCode, types_js_1.SpanStatus.ERROR);
+        strict_1.default.equal(span.statusMessage, "rate limited");
+    });
+    (0, node_test_1.it)("sets parent span ID and trace ID", () => {
+        const span = new span_builder_js_1.SpanBuilder("gen_ai.llm.call")
+            .traceId("aabbccdd00112233aabbccdd00112233")
+            .parentSpanId("1122334455667788")
+            .build();
+        strict_1.default.equal(span.traceId, "aabbccdd00112233aabbccdd00112233");
+        strict_1.default.equal(span.parentSpanId, "1122334455667788");
+    });
+    (0, node_test_1.it)("returns a copy on build (immutable)", () => {
+        const builder = new span_builder_js_1.SpanBuilder("gen_ai.llm.call").agentId("agent-1");
+        const span1 = builder.build();
+        const span2 = builder.agentId("agent-2").build();
+        strict_1.default.equal(span1.agentId, "agent-1");
+        strict_1.default.equal(span2.agentId, "agent-2");
+        // Attributes should be independent copies
+        strict_1.default.equal(span1.attributes[semconv_js_1.GenAIAttributes.AGENT_ID], "agent-1");
+    });
+});
+//# sourceMappingURL=span-builder.test.js.map

package/dist/span-builder.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Core types for the OCW TypeScript SDK.
+ */
+export declare enum SpanKind {
+    INTERNAL = "internal",
+    CLIENT = "client",
+    SERVER = "server",
+    PRODUCER = "producer",
+    CONSUMER = "consumer"
+}
+export declare enum SpanStatus {
+    OK = "ok",
+    ERROR = "error",
+    UNSET = "unset"
+}
+export interface Span {
+    spanId: string;
+    traceId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    statusCode: SpanStatus;
+    statusMessage?: string;
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    attributes: Record<string, unknown>;
+    events?: Array<Record<string, unknown>>;
+    agentId?: string;
+    sessionId?: string;
+    conversationId?: string;
+}
+export interface SpanBatch {
+    resourceSpans: Array<{
+        resource: {
+            attributes: Array<{
+                key: string;
+                value: {
+                    stringValue: string;
+                };
+            }>;
+        };
+        scopeSpans: Array<{
+            spans: Array<OtlpSpan>;
+        }>;
+    }>;
+}
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano?: string;
+    status: {
+        code: number;
+        message?: string;
+    };
+    attributes: Array<{
+        key: string;
+        value: OtlpValue;
+    }>;
+    events?: Array<{
+        timeUnixNano: string;
+        name: string;
+        attributes?: Array<{
+            key: string;
+            value: OtlpValue;
+        }>;
+    }>;
+}
+export type OtlpValue = {
+    stringValue: string;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    boolValue: boolean;
+} | {
+    arrayValue: {
+        values: OtlpValue[];
+    };
+};
+export interface IngestResult {
+    ingested: number;
+    rejected: number;
+    rejections: Array<{
+        span_id: string;
+        reason: string;
+    }>;
+}

package/dist/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Core types for the OCW TypeScript SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanStatus = exports.SpanKind = void 0;
+var SpanKind;
+(function (SpanKind) {
+    SpanKind["INTERNAL"] = "internal";
+    SpanKind["CLIENT"] = "client";
+    SpanKind["SERVER"] = "server";
+    SpanKind["PRODUCER"] = "producer";
+    SpanKind["CONSUMER"] = "consumer";
+})(SpanKind || (exports.SpanKind = SpanKind = {}));
+var SpanStatus;
+(function (SpanStatus) {
+    SpanStatus["OK"] = "ok";
+    SpanStatus["ERROR"] = "error";
+    SpanStatus["UNSET"] = "unset";
+})(SpanStatus || (exports.SpanStatus = SpanStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAED,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,uBAAS,CAAA;IACT,6BAAe,CAAA;IACf,6BAAe,CAAA;AACjB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@tokenjam/sdk",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for TokenJam — local-first observability for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test dist/client.test.js dist/span-builder.test.js dist/semconv.test.js",
+    "pretest": "tsc",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "observability",
+    "opentelemetry",
+    "llm"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.4"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}