@nodetool-ai/runtime 0.7.0-rc.11

package/dist/trace-exporters.js

@@ -0,0 +1,216 @@
+/**
+ * Custom OpenTelemetry span exporters for NodeTool.
+ *
+ * - {@link JsonlFileSpanExporter}  — appends one JSON line per span to a file
+ * - {@link StdoutSpanExporter}     — writes spans to stdout in `json` (JSONL)
+ *                                    or `pretty` (human-readable) format
+ *
+ * Both produce the same structured shape, so an analyzer agent reading either
+ * file or stdout output gets identical fields.
+ */
+import { createWriteStream } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { ExportResultCode } from "@opentelemetry/core";
+const SPAN_KINDS = ["INTERNAL", "SERVER", "CLIENT", "PRODUCER", "CONSUMER"];
+const STATUS_CODES = ["UNSET", "OK", "ERROR"];
+/**
+ * Convert an OTel hrTime ([seconds, nanoseconds]) to integer unix-epoch ms.
+ *
+ * We round (rather than truncate) so a 0.6ms span doesn't read as 0ms, and
+ * we keep the schema integer-typed for downstream JSONL consumers that
+ * assume `start_time_ms`/`end_time_ms`/`duration_ms` are whole numbers.
+ */
+function hrTimeToMs(hrTime) {
+    return Math.round(hrTime[0] * 1000 + hrTime[1] / 1_000_000);
+}
+export function spanToRecord(span) {
+    const ctx = span.spanContext();
+    const startMs = hrTimeToMs(span.startTime);
+    const endMs = hrTimeToMs(span.endTime);
+    return {
+        trace_id: ctx.traceId,
+        span_id: ctx.spanId,
+        parent_span_id: span.parentSpanContext?.spanId ?? null,
+        name: span.name,
+        kind: SPAN_KINDS[span.kind] ?? "INTERNAL",
+        start_time_ms: startMs,
+        end_time_ms: endMs,
+        duration_ms: endMs - startMs,
+        status: {
+            code: STATUS_CODES[span.status.code] ?? "UNSET",
+            ...(span.status.message ? { message: span.status.message } : {})
+        },
+        attributes: { ...span.attributes },
+        events: span.events.map((e) => ({
+            name: e.name,
+            time_ms: hrTimeToMs(e.time),
+            ...(e.attributes ? { attributes: { ...e.attributes } } : {})
+        })),
+        resource: { ...span.resource.attributes }
+    };
+}
+/**
+ * Append spans as JSONL to a file. Creates parent directories as needed.
+ *
+ * Spans are written as soon as `export()` is called (use a SimpleSpanProcessor
+ * for immediate flush, BatchSpanProcessor for buffered).
+ *
+ * Honors stream backpressure: each batch awaits the underlying `write`
+ * callback (and a `drain` event when the stream reports it's full) before
+ * reporting SUCCESS, so high trace volume can't accumulate unbounded.
+ */
+export class JsonlFileSpanExporter {
+    stream = null;
+    streamReady;
+    constructor(filePath) {
+        this.streamReady = (async () => {
+            await mkdir(dirname(filePath), { recursive: true });
+            this.stream = createWriteStream(filePath, { flags: "a" });
+        })();
+    }
+    export(spans, resultCallback) {
+        void this.streamReady
+            .then(async () => {
+            if (!this.stream)
+                throw new Error("trace stream not initialized");
+            for (const span of spans) {
+                await writeLine(this.stream, JSON.stringify(spanToRecord(span)) + "\n");
+            }
+            resultCallback({ code: ExportResultCode.SUCCESS });
+        })
+            .catch((err) => {
+            resultCallback({ code: ExportResultCode.FAILED, error: err });
+        });
+    }
+    async shutdown() {
+        await this.streamReady;
+        await new Promise((resolve) => {
+            if (!this.stream)
+                return resolve();
+            this.stream.end(resolve);
+        });
+    }
+    async forceFlush() {
+        // WriteStream auto-flushes on write; nothing to do.
+    }
+}
+/**
+ * Write a single line to a WriteStream, respecting backpressure.
+ *
+ * Resolves once the write callback has fired AND the stream has drained
+ * (if `write()` returned false). Rejects on any stream error during the
+ * write — caller is responsible for re-attaching listeners afterwards.
+ */
+function writeLine(stream, line) {
+    return new Promise((resolve, reject) => {
+        let written = false;
+        let drained = false;
+        let needsDrain = false;
+        const onError = (err) => {
+            stream.off("drain", onDrain);
+            reject(err);
+        };
+        const onDrain = () => {
+            drained = true;
+            maybeDone();
+        };
+        const maybeDone = () => {
+            if (written && (!needsDrain || drained)) {
+                stream.off("error", onError);
+                stream.off("drain", onDrain);
+                resolve();
+            }
+        };
+        stream.once("error", onError);
+        const ok = stream.write(line, (err) => {
+            if (err)
+                return onError(err);
+            written = true;
+            maybeDone();
+        });
+        if (!ok) {
+            needsDrain = true;
+            stream.once("drain", onDrain);
+        }
+    });
+}
+/**
+ * Write spans to stdout. `format: "json"` emits JSONL; `format: "pretty"`
+ * emits a human-readable single-line summary that's still grep-friendly.
+ */
+export class StdoutSpanExporter {
+    format;
+    constructor(format = "pretty") {
+        this.format = format;
+    }
+    export(spans, resultCallback) {
+        try {
+            for (const span of spans) {
+                const rec = spanToRecord(span);
+                if (this.format === "json") {
+                    process.stdout.write(JSON.stringify(rec) + "\n");
+                }
+                else {
+                    process.stdout.write(formatPretty(rec) + "\n");
+                }
+            }
+            resultCallback({ code: ExportResultCode.SUCCESS });
+        }
+        catch (err) {
+            resultCallback({ code: ExportResultCode.FAILED, error: err });
+        }
+    }
+    async shutdown() {
+        // Nothing to clean up.
+    }
+    async forceFlush() {
+        // stdout writes are synchronous-ish; nothing to do.
+    }
+}
+const COLOR = {
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    green: "\x1b[32m",
+    cyan: "\x1b[36m",
+    bold: "\x1b[1m",
+    reset: "\x1b[0m"
+};
+function colorize(s, color) {
+    return process.stdout.isTTY ? `${COLOR[color]}${s}${COLOR.reset}` : s;
+}
+function formatPretty(r) {
+    const dur = `${r.duration_ms.toFixed(1)}ms`;
+    const statusColor = r.status.code === "ERROR"
+        ? "red"
+        : r.status.code === "OK"
+            ? "green"
+            : "dim";
+    const tags = [];
+    // Surface the most useful attributes inline, in priority order.
+    const inlineKeys = [
+        "llm.provider",
+        "llm.model",
+        "gen_ai.usage.input_tokens",
+        "gen_ai.usage.output_tokens",
+        "agent.objective",
+        "node.type",
+        "node.id",
+        "workflow.id"
+    ];
+    for (const k of inlineKeys) {
+        const v = r.attributes[k];
+        if (v !== undefined && v !== null && v !== "") {
+            tags.push(`${colorize(k, "dim")}=${truncate(String(v), 60)}`);
+        }
+    }
+    const status = r.status.code === "ERROR"
+        ? colorize(`[${r.status.code}${r.status.message ? `: ${r.status.message}` : ""}]`, statusColor)
+        : "";
+    return `${colorize(r.name, "cyan")} ${colorize(dur, "yellow")} ${tags.join(" ")} ${status}`.trimEnd();
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+//# sourceMappingURL=trace-exporters.js.map

package/dist/trace-exporters.js.map

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

package/dist/tracing-helpers.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Helpers for wrapping agent / workflow / node code in OpenTelemetry spans.
+ *
+ * All helpers degrade gracefully when telemetry is disabled (no tracer
+ * configured) — the wrapped function runs as if no span existed, with
+ * essentially zero overhead.
+ *
+ * # Span hierarchy
+ *
+ *   workflow.run                     ← `withWorkflowSpan`
+ *     node.process (per node)        ← `withNodeSpan`
+ *       llm.chat / llm.stream        ← BaseProvider (existing)
+ *
+ *   agent.execute                    ← `withAgentSpan({ kind: "execute" })`
+ *     agent.plan                     ← `withAgentSpan({ kind: "plan" })`
+ *     agent.step                     ← `withAgentSpan({ kind: "step" })`
+ *       llm.chat / llm.stream        ← BaseProvider (existing)
+ *
+ * Child spans nest automatically because OTel's `startActiveSpan` makes the
+ * span active in AsyncLocalStorage for the duration of the callback.
+ */
+import { type Span } from "@opentelemetry/api";
+export type AgentSpanKind = "execute" | "plan" | "step";
+/** Token counts and computed cost for one LLM call. */
+export interface LlmUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+    /** In NodeTool credits (1 credit ≈ $0.01). */
+    cost?: number;
+}
+/**
+ * Run `fn` inside a fresh usage slot. `consumeLastUsage()` afterwards returns
+ * whatever the deepest `setLastUsage()` call wrote.
+ */
+export declare function withUsageCapture<T>(fn: () => Promise<T>): Promise<T>;
+/** Provider hook: record token usage for the in-flight LLM call. */
+export declare function setLastUsage(usage: LlmUsage): void;
+/** Read and clear the most recent usage recorded in this async context. */
+export declare function consumeLastUsage(): LlmUsage | null;
+/** Read (without clearing) the most recent usage in this async context. */
+export declare function peekLastUsage(): LlmUsage | null;
+/**
+ * Create a per-call usage slot that survives across async-generator yields.
+ *
+ * `AsyncLocalStorage.run()` only persists across awaits within its callback,
+ * so for streaming we explicitly wrap each `gen.next()` call in `runInSlot`.
+ * After the generator finishes, `getUsage()` returns whatever the deepest
+ * `setLastUsage()` call wrote.
+ */
+export declare function createUsageSlot(): {
+    runInSlot: <T>(fn: () => Promise<T>) => Promise<T>;
+    getUsage: () => LlmUsage | null;
+};
+/**
+ * Wrap an async generator in an OTel span. Each `next()` call runs in the
+ * span's context, so any spans created inside `genFactory` nest under it.
+ *
+ * Preserves the generator's `TReturn` so callers reading `.next().value`
+ * after `done` still get the underlying return value. If the consumer
+ * cancels (breaks out of `for await`, calls `return()`, or throws), the
+ * inner generator's `return()` is invoked so its `finally` blocks run.
+ */
+export declare function withSpanGen<T, TReturn = void>(name: string, attributes: Record<string, unknown>, genFactory: () => AsyncGenerator<T, TReturn>): AsyncGenerator<T, TReturn>;
+/**
+ * Wrap an agent operation (execute / plan / step) in a span.
+ *
+ * @param kind        — which agent stage this is (becomes part of span name)
+ * @param attributes  — agent.* attributes (objective, model, provider, ...)
+ * @param fn          — the body of the agent stage
+ */
+export declare function withAgentSpan<T>(kind: AgentSpanKind, attributes: {
+    objective?: string;
+    provider?: string;
+    model?: string;
+    /** For `step`: which task / sub-objective is being executed. */
+    task?: string;
+    /** For `plan`: number of skills / tools available. */
+    toolsCount?: number;
+    /** Any additional attributes to attach. */
+    extra?: Record<string, unknown>;
+}, fn: (span: Span | null) => Promise<T>): Promise<T>;
+/** Wrap a workflow run (kernel WorkflowRunner) in a span. */
+export declare function withWorkflowSpan<T>(attributes: {
+    workflowId?: string;
+    workflowName?: string;
+    nodeCount?: number;
+    extra?: Record<string, unknown>;
+}, fn: (span: Span | null) => Promise<T>): Promise<T>;
+/** Async-generator variant of {@link withAgentSpan}. */
+export declare function withAgentSpanGen<T, TReturn = void>(kind: AgentSpanKind, attributes: Parameters<typeof withAgentSpan>[1], genFactory: () => AsyncGenerator<T, TReturn>): AsyncGenerator<T, TReturn>;
+/** Wrap a single node execution (kernel Actor) in a span. */
+export declare function withNodeSpan<T>(attributes: {
+    nodeId: string;
+    nodeType: string;
+    workflowId?: string;
+    extra?: Record<string, unknown>;
+}, fn: (span: Span | null) => Promise<T>): Promise<T>;
+//# sourceMappingURL=tracing-helpers.d.ts.map

package/dist/tracing-helpers.d.ts.map

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

package/dist/tracing-helpers.js

@@ -0,0 +1,217 @@
+/**
+ * Helpers for wrapping agent / workflow / node code in OpenTelemetry spans.
+ *
+ * All helpers degrade gracefully when telemetry is disabled (no tracer
+ * configured) — the wrapped function runs as if no span existed, with
+ * essentially zero overhead.
+ *
+ * # Span hierarchy
+ *
+ *   workflow.run                     ← `withWorkflowSpan`
+ *     node.process (per node)        ← `withNodeSpan`
+ *       llm.chat / llm.stream        ← BaseProvider (existing)
+ *
+ *   agent.execute                    ← `withAgentSpan({ kind: "execute" })`
+ *     agent.plan                     ← `withAgentSpan({ kind: "plan" })`
+ *     agent.step                     ← `withAgentSpan({ kind: "step" })`
+ *       llm.chat / llm.stream        ← BaseProvider (existing)
+ *
+ * Child spans nest automatically because OTel's `startActiveSpan` makes the
+ * span active in AsyncLocalStorage for the duration of the callback.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { SpanStatusCode, context as otelContext, trace as otelTrace } from "@opentelemetry/api";
+import { getTracer } from "./telemetry.js";
+/**
+ * Per-call usage slot. Providers' `trackUsage` writes into the active slot
+ * via {@link setLastUsage}, and the traced wrapper reads it via
+ * {@link consumeLastUsage} so it can attach the numbers to its span and
+ * `llm_call` event.
+ *
+ * We use AsyncLocalStorage rather than an instance field so concurrent calls
+ * on the same provider instance don't clobber each other.
+ */
+const usageStore = new AsyncLocalStorage();
+/**
+ * Run `fn` inside a fresh usage slot. `consumeLastUsage()` afterwards returns
+ * whatever the deepest `setLastUsage()` call wrote.
+ */
+export function withUsageCapture(fn) {
+    return usageStore.run({ usage: null }, fn);
+}
+/** Provider hook: record token usage for the in-flight LLM call. */
+export function setLastUsage(usage) {
+    const slot = usageStore.getStore();
+    if (slot)
+        slot.usage = usage;
+}
+/** Read and clear the most recent usage recorded in this async context. */
+export function consumeLastUsage() {
+    const slot = usageStore.getStore();
+    if (!slot)
+        return null;
+    const u = slot.usage;
+    slot.usage = null;
+    return u;
+}
+/** Read (without clearing) the most recent usage in this async context. */
+export function peekLastUsage() {
+    return usageStore.getStore()?.usage ?? null;
+}
+/**
+ * Create a per-call usage slot that survives across async-generator yields.
+ *
+ * `AsyncLocalStorage.run()` only persists across awaits within its callback,
+ * so for streaming we explicitly wrap each `gen.next()` call in `runInSlot`.
+ * After the generator finishes, `getUsage()` returns whatever the deepest
+ * `setLastUsage()` call wrote.
+ */
+export function createUsageSlot() {
+    const slot = { usage: null };
+    return {
+        runInSlot: (fn) => usageStore.run(slot, fn),
+        getUsage: () => slot.usage
+    };
+}
+/** Wrap a function in an OTel span; pass-through if telemetry is disabled. */
+async function withSpan(name, attributes, fn) {
+    const tracer = getTracer();
+    if (!tracer)
+        return fn(null);
+    return tracer.startActiveSpan(name, async (span) => {
+        setAttributes(span, attributes);
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
+            span.recordException(err);
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+/**
+ * Wrap an async generator in an OTel span. Each `next()` call runs in the
+ * span's context, so any spans created inside `genFactory` nest under it.
+ *
+ * Preserves the generator's `TReturn` so callers reading `.next().value`
+ * after `done` still get the underlying return value. If the consumer
+ * cancels (breaks out of `for await`, calls `return()`, or throws), the
+ * inner generator's `return()` is invoked so its `finally` blocks run.
+ */
+export async function* withSpanGen(name, attributes, genFactory) {
+    const tracer = getTracer();
+    if (!tracer) {
+        return yield* genFactory();
+    }
+    const span = tracer.startSpan(name);
+    setAttributes(span, attributes);
+    const ctx = otelTrace.setSpan(otelContext.active(), span);
+    const inner = otelContext.with(ctx, () => genFactory());
+    let exhausted = false;
+    try {
+        while (true) {
+            const result = await otelContext.with(ctx, () => inner.next());
+            if (result.done) {
+                exhausted = true;
+                span.setStatus({ code: SpanStatusCode.OK });
+                return result.value;
+            }
+            yield result.value;
+        }
+    }
+    catch (err) {
+        span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
+        span.recordException(err);
+        throw err;
+    }
+    finally {
+        if (!exhausted) {
+            // Consumer cancelled early — give the inner generator a chance to
+            // run its own finally blocks (close streams, end child spans, etc).
+            await otelContext
+                .with(ctx, () => inner.return?.(undefined))
+                ?.catch(() => { });
+        }
+        span.end();
+    }
+}
+function setAttributes(span, attributes) {
+    for (const [k, v] of Object.entries(attributes)) {
+        if (v !== undefined && v !== null) {
+            span.setAttribute(k, v);
+        }
+    }
+}
+/**
+ * Wrap an agent operation (execute / plan / step) in a span.
+ *
+ * @param kind        — which agent stage this is (becomes part of span name)
+ * @param attributes  — agent.* attributes (objective, model, provider, ...)
+ * @param fn          — the body of the agent stage
+ */
+export function withAgentSpan(kind, attributes, fn) {
+    return withSpan(`agent.${kind}`, agentAttrs(kind, attributes), fn);
+}
+/** Wrap a workflow run (kernel WorkflowRunner) in a span. */
+export function withWorkflowSpan(attributes, fn) {
+    const attrs = {};
+    if (attributes.workflowId !== undefined) {
+        attrs["workflow.id"] = attributes.workflowId;
+    }
+    if (attributes.workflowName !== undefined) {
+        attrs["workflow.name"] = attributes.workflowName;
+    }
+    if (attributes.nodeCount !== undefined) {
+        attrs["workflow.node_count"] = attributes.nodeCount;
+    }
+    if (attributes.extra)
+        Object.assign(attrs, attributes.extra);
+    return withSpan("workflow.run", attrs, fn);
+}
+/** Async-generator variant of {@link withAgentSpan}. */
+export function withAgentSpanGen(kind, attributes, genFactory) {
+    return withSpanGen(`agent.${kind}`, agentAttrs(kind, attributes), genFactory);
+}
+function agentAttrs(kind, attributes) {
+    const attrs = { "agent.kind": kind };
+    if (attributes.objective !== undefined) {
+        attrs["agent.objective"] = truncate(attributes.objective, 1000);
+    }
+    if (attributes.provider !== undefined) {
+        attrs["agent.provider"] = attributes.provider;
+    }
+    if (attributes.model !== undefined)
+        attrs["agent.model"] = attributes.model;
+    if (attributes.task !== undefined) {
+        attrs["agent.task"] = truncate(attributes.task, 1000);
+    }
+    if (attributes.toolsCount !== undefined) {
+        attrs["agent.tools_count"] = attributes.toolsCount;
+    }
+    if (attributes.extra)
+        Object.assign(attrs, attributes.extra);
+    return attrs;
+}
+/** Wrap a single node execution (kernel Actor) in a span. */
+export function withNodeSpan(attributes, fn) {
+    const attrs = {
+        "node.id": attributes.nodeId,
+        "node.type": attributes.nodeType
+    };
+    if (attributes.workflowId !== undefined) {
+        attrs["workflow.id"] = attributes.workflowId;
+    }
+    if (attributes.extra)
+        Object.assign(attrs, attributes.extra);
+    return withSpan("node.process", attrs, fn);
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+//# sourceMappingURL=tracing-helpers.js.map

package/dist/tracing-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-helpers.js","sourceRoot":"","sources":["../src/tracing-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,OAAO,IAAI,WAAW,EACtB,KAAK,IAAI,SAAS,EAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAa3C;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAA8B,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAI,EAAoB;IACtD,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,IAAI,IAAI;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;AAC/B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAI7B,MAAM,IAAI,GAA+B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzD,OAAO;QACL,SAAS,EAAE,CAAI,EAAoB,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAChE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,QAAQ,CACrB,IAAY,EACZ,UAAmC,EACnC,EAAqC;IAErC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;YACnC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,IAAY,EACZ,UAAmC,EACnC,UAA4C;IAE5C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IACxD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5C,OAAO,MAAM,CAAC,KAAK,CAAC;YACtB,CAAC;YACD,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;QACnC,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,kEAAkE;YAClE,oEAAoE;YACpE,MAAM,WAAW;iBACd,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAkB,CAAC,CAAC;gBACpD,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAU,EAAE,UAAmC;IACpE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAmB,EACnB,UAUC,EACD,EAAqC;IAErC,OAAO,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAC9B,UAKC,EACD,EAAqC;IAErC,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;IACnD,CAAC;IACD,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,qBAAqB,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC;IACtD,CAAC;IACD,IAAI,UAAU,CAAC,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,UAA+C,EAC/C,UAA4C;IAE5C,OAAO,WAAW,CAAC,SAAS,IAAI,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,UAAU,CACjB,IAAmB,EACnB,UAA+C;IAE/C,MAAM,KAAK,GAA4B,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,iBAAiB,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;IAC5E,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,mBAAmB,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC;IACrD,CAAC;IACD,IAAI,UAAU,CAAC,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAC1B,UAKC,EACD,EAAqC;IAErC,MAAM,KAAK,GAA4B;QACrC,SAAS,EAAE,UAAU,CAAC,MAAM;QAC5B,WAAW,EAAE,UAAU,CAAC,QAAQ;KACjC,CAAC;IACF,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,CAAC,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,GAAW;IACtC,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@nodetool-ai/runtime",
+  "version": "0.7.0-rc.11",
+  "description": "Processing context, message queue, and output normalization",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs && node -e \"require('node:fs').mkdirSync('dist/providers',{recursive:true}); require('node:fs').cpSync('src/providers/aki-manifest.json', 'dist/providers/aki-manifest.json')\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@aki-io/aki-io": "^1.0.1",
+    "@anthropic-ai/sdk": "^0.33.1",
+    "@msgpack/msgpack": "^3.1.3",
+    "@nodetool-ai/config": "^0.7.0-rc.11",
+    "@nodetool-ai/protocol": "^0.7.0-rc.11",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.203.0",
+    "@opentelemetry/resources": "^2.6.0",
+    "@opentelemetry/sdk-node": "^0.203.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "openai": "^4.104.0",
+    "replicate": "^1.4.0",
+    "ws": "^8.19.0"
+  },
+  "optionalDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.101"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.2"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}