@nodetool-ai/runtime 0.8.1 → 0.8.2

package/dist/recommended-models.js

@@ -5,6 +5,26 @@
  * list without pulling in a Fastify server.
  */
 export const RECOMMENDED_MODELS = [
+    ...["ggml-base.en.bin", "ggml-small.bin", "ggml-large-v3-turbo-q5_0.bin"].map((file) => ({
+        id: `ggerganov/whisper.cpp/${file}`,
+        type: "hf.whisper_cpp",
+        name: file.replace(/^ggml-/, "").replace(/\.bin$/, ""),
+        repo_id: "ggerganov/whisper.cpp",
+        path: file,
+        downloaded: false,
+        modality: "asr",
+        provider: "whisper_cpp"
+    })),
+    {
+        id: "ggml-org/whisper-vad/ggml-silero-v5.1.2.bin",
+        type: "hf.whisper_cpp_vad",
+        name: "Silero VAD v5.1.2",
+        repo_id: "ggml-org/whisper-vad",
+        path: "ggml-silero-v5.1.2.bin",
+        downloaded: false,
+        modality: "asr",
+        provider: "whisper_cpp"
+    },
     {
         id: "gpt-5-mini",
         type: "language_model",

package/dist/recommended-models.js.map

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

package/dist/run-context.d.ts

@@ -0,0 +1,20 @@
+/** Immutable app identity. Secrets are held by ProcessingContext, never serialized. */
+export interface AppRunContext {
+    readonly userId: string;
+    readonly instanceId: string;
+    readonly appRunId: string;
+    readonly traceId: string;
+    readonly origin: "ui" | "agent" | "cli" | "debug" | "public";
+}
+/** Run-local accounting remains distinct from the node's retry account. */
+export interface AppRunCostAccount {
+    llmCostUsd: number;
+    unpriced: boolean;
+}
+export declare function inAppRunCostAccount<T>(account: AppRunCostAccount | null, execute: () => Promise<T>): Promise<T>;
+export declare function recordAppRunLlmCost(cost: number | undefined): void;
+export interface AppRunDocumentRef {
+    readonly kind: "sketch" | "timeline" | "script" | "storyboard";
+    readonly id: string;
+}
+//# sourceMappingURL=run-context.d.ts.map

package/dist/run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../src/run-context.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;CAC9D;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,OAAO,EAAE,iBAAiB,GAAG,IAAI,EACjC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB"}

package/dist/run-context.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from "./async-local-storage.js";
+const costStore = new AsyncLocalStorage();
+export function inAppRunCostAccount(account, execute) {
+    return account ? costStore.run(account, execute) : execute();
+}
+export function recordAppRunLlmCost(cost) {
+    const account = costStore.getStore();
+    if (!account) {
+        return;
+    }
+    if (cost === undefined || !Number.isFinite(cost) || cost < 0) {
+        account.unpriced = true;
+    }
+    else {
+        account.llmCostUsd += cost;
+    }
+}
+//# sourceMappingURL=run-context.js.map

package/dist/run-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.js","sourceRoot":"","sources":["../src/run-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAgB7D,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CACjC,OAAiC,EACjC,OAAyB;IAEzB,OAAO,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/run-trace-context.d.ts

@@ -0,0 +1,30 @@
+import { type Span, type SpanContext } from "@opentelemetry/api";
+export interface RunTraceScope {
+    readonly userId: string;
+    readonly runId: string;
+    readonly traceId: string;
+    readonly origin: "ui" | "agent" | "cli" | "debug" | "public";
+    readonly secretValues: ReadonlySet<string>;
+    readonly policy: {
+        contentSuppressed: boolean;
+    };
+    readonly parentSpanContext?: SpanContext;
+}
+export declare function bindSpanRunTraceScope(span: Span, scope: RunTraceScope): void;
+export declare function getSpanRunTraceScope(span: Span): RunTraceScope | undefined;
+/** Execute child work under a trusted durable run without inheriting another request's trace. */
+export declare function withRunTrace<T>(scope: RunTraceScope, fn: () => T): T;
+/** The owner and policy shared by every span beneath the current run. */
+export declare function getRunTraceScope(): RunTraceScope | undefined;
+/** Add credentials resolved outside ProcessingContext to the shared run redaction set. */
+export declare function recordRunTraceSecret(value: string | null | undefined): void;
+/** Producers report content caps before the original value leaves their scope. */
+export declare function markTraceContentTruncated(): void;
+/** Exclude third-party content from this run and all subsequent inseparable work. */
+export declare function suppressRunTraceContent(): void;
+/** Add a run event to an explicit span or the active span. */
+export declare function recordTraceEvent(name: string, attributes: Record<string, unknown>, span?: Span): void;
+/** Run-store IO and diagnostics must not recursively record themselves. */
+export declare function withoutRunTrace<T>(fn: () => T): T;
+export declare function isRunTraceSuppressed(): boolean;
+//# sourceMappingURL=run-trace-context.d.ts.map

package/dist/run-trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-trace-context.d.ts","sourceRoot":"","sources":["../src/run-trace-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAK/F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;CAC1C;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAiC;AAC9G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAiC;AAE5G,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAUpE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAG3E;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAiBrG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAA2C"}

package/dist/run-trace-context.js

@@ -0,0 +1,80 @@
+import { context, ROOT_CONTEXT, trace } from "@opentelemetry/api";
+import { isTraceContentKey } from "@nodetool-ai/protocol";
+import { AsyncLocalStorage } from "./async-local-storage.js";
+import { sanitizeTraceContentText, stringifyTraceContent } from "./run-trace-serialization.js";
+const runScope = new AsyncLocalStorage();
+const suppressed = new AsyncLocalStorage();
+const spanScopes = new WeakMap();
+export function bindSpanRunTraceScope(span, scope) { spanScopes.set(span, scope); }
+export function getSpanRunTraceScope(span) { return spanScopes.get(span); }
+/** Execute child work under a trusted durable run without inheriting another request's trace. */
+export function withRunTrace(scope, fn) {
+    if (!/^[0-9a-f]{32}$/.test(scope.traceId)) {
+        throw new Error("Invalid run trace id");
+    }
+    const active = context.active();
+    const activeSpan = trace.getSpanContext(active);
+    const parent = activeSpan?.traceId === scope.traceId
+        ? active
+        : scope.parentSpanContext?.traceId === scope.traceId
+            ? trace.setSpanContext(ROOT_CONTEXT, scope.parentSpanContext)
+            : ROOT_CONTEXT;
+    return runScope.run(scope, () => context.with(parent, fn));
+}
+/** The owner and policy shared by every span beneath the current run. */
+export function getRunTraceScope() {
+    return suppressed.getStore() ? undefined : runScope.getStore();
+}
+/** Add credentials resolved outside ProcessingContext to the shared run redaction set. */
+export function recordRunTraceSecret(value) {
+    const secrets = getRunTraceScope()?.secretValues;
+    if (value && secrets instanceof Set) {
+        secrets.add(value);
+    }
+}
+/** Producers report content caps before the original value leaves their scope. */
+export function markTraceContentTruncated() {
+    if (getRunTraceScope()) {
+        trace.getActiveSpan()?.setAttribute("nodetool.trace.truncated", true);
+    }
+}
+/** Exclude third-party content from this run and all subsequent inseparable work. */
+export function suppressRunTraceContent() {
+    const scope = getRunTraceScope();
+    if (scope) {
+        scope.policy.contentSuppressed = true;
+    }
+}
+/** Add a run event to an explicit span or the active span. */
+export function recordTraceEvent(name, attributes, span) {
+    if (isRunTraceSuppressed()) {
+        return;
+    }
+    const target = span ?? trace.getSpan(context.active());
+    const scope = getRunTraceScope() ?? (target ? spanScopes.get(target) : undefined);
+    if (!target || !scope) {
+        return;
+    }
+    const safe = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if ((scope.origin === "public" || scope.policy.contentSuppressed) && isTraceContentKey(key)) {
+            continue;
+        }
+        if (typeof value === "string" && isTraceContentKey(key)) {
+            safe[key] = sanitizeTraceContentText(value, scope.secretValues);
+        }
+        else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            safe[key] = value;
+        }
+        else if (value !== undefined) {
+            safe[key] = stringifyTraceContent(value, scope.secretValues);
+        }
+    }
+    target.addEvent(name, safe);
+}
+/** Run-store IO and diagnostics must not recursively record themselves. */
+export function withoutRunTrace(fn) {
+    return suppressed.run(true, () => context.with(ROOT_CONTEXT, fn));
+}
+export function isRunTraceSuppressed() { return suppressed.getStore() === true; }
+//# sourceMappingURL=run-trace-context.js.map

package/dist/run-trace-context.js.map

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

package/dist/run-trace-processor.d.ts

@@ -0,0 +1,65 @@
+import { type Context } from "@opentelemetry/api";
+import type { ReadableSpan, Span, SpanProcessor, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import { type TraceRecord, type RunTraceRegistration, type RunTraceUpdate } from "@nodetool-ai/protocol";
+import { type RunTraceScope } from "./run-trace-context.js";
+export type TraceIncompleteReason = "queue_overflow" | "store_failure";
+export interface RunTraceWrite {
+    readonly runId?: string;
+    readonly userId?: string;
+    readonly update: RunTraceUpdate;
+    readonly secretValues: ReadonlySet<string>;
+    readonly contentSuppressed: boolean;
+    readonly isRoot: boolean;
+}
+export interface TraceSanitizerOptions {
+    readonly secretValues: ReadonlySet<string>;
+    readonly public: boolean;
+    readonly contentSuppressed: boolean;
+}
+export interface RunTraceStore {
+    lookup(traceId: string): Promise<RunTraceRegistration | null>;
+    write(updates: readonly RunTraceWrite[]): Promise<void>;
+    markIncomplete(traceId: string, reason: TraceIncompleteReason): Promise<void>;
+    flush(): Promise<void>;
+    sanitize(record: TraceRecord, options: TraceSanitizerOptions): TraceRecord;
+}
+/** Attach durable storage independently of external sink initialization. */
+export declare function configureRunTraceStore(adapter: RunTraceStore): void;
+/** External copies always mask credentials and exclude visitor and suppressed content. */
+export declare function externalTraceRecord(record: TraceRecord, scope?: RunTraceScope): TraceRecord;
+/** Preserve the captured run policy even when an exporter runs after its async scope ends. */
+export declare function externalSpanRecord(span: ReadableSpan): TraceRecord;
+/** Filter before OTLP or the legacy console exporter can inspect an SDK span. */
+export declare class ContentFilteringSpanExporter implements SpanExporter {
+    private readonly exporter;
+    constructor(exporter: SpanExporter);
+    export(spans: ReadableSpan[], callback: Parameters<SpanExporter["export"]>[1]): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+/** Record registered spans with bounded coalescing, preserving final roots under pressure. */
+export declare class RunTraceSpanProcessor implements SpanProcessor {
+    private readonly queue;
+    private readonly roots;
+    private queueBytes;
+    private pending;
+    private readonly failed;
+    private readonly diagnosticQueue;
+    private diagnostic;
+    private readonly diagnosticWaiters;
+    private readonly eventIds;
+    private readonly eventCounters;
+    onStart(span: Span, _parent: Context): void;
+    onEnd(span: ReadableSpan): void;
+    private capture;
+    private flagIncomplete;
+    private scheduleDiagnostic;
+    private flushDiagnostics;
+    private schedule;
+    private drain;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/** Convert run log output to trace events and keep its external copy content-free. */
+export declare function installRunTraceLogHook(): void;
+//# sourceMappingURL=run-trace-processor.d.ts.map

package/dist/run-trace-processor.d.ts.map

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