@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/trajectory/processors/path-scrub.d.ts

@@ -0,0 +1,15 @@
+import { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+export declare const PATH_SCRUB_VERSION = "1.0.0";
+export interface PathScrubConfig {
+    home: string;
+    repoRoot?: string;
+}
+export declare function scrubPathString(s: string, cfg: PathScrubConfig): string;
+export declare class PathScrubProcessor implements SpanProcessor {
+    private readonly cfg;
+    constructor(cfg: PathScrubConfig);
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    onStart(): void;
+    onEnd(span: ReadableSpan): void;
+}

package/dist/trajectory/processors/path-scrub.js

@@ -0,0 +1,52 @@
+export const PATH_SCRUB_VERSION = '1.0.0';
+function replaceAllLiteral(value, search, replacement) {
+    return search.length === 0 ? value : value.split(search).join(replacement);
+}
+export function scrubPathString(s, cfg) {
+    const homePrefix = cfg.home.endsWith('/') ? cfg.home : cfg.home + '/';
+    const repoExact = cfg.repoRoot;
+    const repoPrefix = cfg.repoRoot
+        ? (cfg.repoRoot.endsWith('/') ? cfg.repoRoot : cfg.repoRoot + '/')
+        : undefined;
+    // repoRoot match wins over home match: a path under the repo is more
+    // useful as a repo-relative reference than as a /users/anon/... blob.
+    if (repoExact !== undefined && s === repoExact)
+        return '.';
+    let out = s;
+    if (repoPrefix !== undefined) {
+        if (out.startsWith(repoPrefix)) {
+            out = out.slice(repoPrefix.length);
+        }
+        else {
+            out = replaceAllLiteral(out, repoPrefix, '');
+        }
+    }
+    if (repoExact !== undefined && out !== '.') {
+        out = replaceAllLiteral(out, repoExact, '.');
+    }
+    if (out === cfg.home)
+        return '/users/anon';
+    if (out.startsWith(homePrefix)) {
+        return '/users/anon/' + out.slice(homePrefix.length);
+    }
+    return replaceAllLiteral(out, homePrefix, '/users/anon/');
+}
+export class PathScrubProcessor {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    forceFlush() { return Promise.resolve(); }
+    shutdown() { return Promise.resolve(); }
+    onStart() { }
+    onEnd(span) {
+        const attrs = span.attributes;
+        for (const key of Object.keys(attrs)) {
+            const v = attrs[key];
+            if (typeof v === 'string') {
+                attrs[key] = scrubPathString(v, this.cfg);
+            }
+        }
+    }
+}
+//# sourceMappingURL=path-scrub.js.map

package/dist/trajectory/processors/path-scrub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-scrub.js","sourceRoot":"","sources":["../../../src/trajectory/processors/path-scrub.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAO1C,SAAS,iBAAiB,CAAC,KAAa,EAAE,MAAc,EAAE,WAAmB;IAC3E,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,GAAoB;IAC7D,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;IACtE,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ;QAC7B,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;QAClE,CAAC,CAAC,SAAS,CAAC;IAEd,qEAAqE;IACrE,sEAAsE;IACtE,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAC3D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAC3C,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI;QAAE,OAAO,aAAa,CAAC;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAErD,UAAU,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxC,OAAO,KAAI,CAAC;IAEZ,KAAK,CAAC,IAAkB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAqC,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1B,KAAK,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/trajectory/processors/sentinel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sentinel pattern shared by scrub-aware processors (manifest-builder,
+ * sqlite-exporter). Any string attribute value matching this pattern is
+ * treated as a redaction placeholder produced upstream by an identity-,
+ * path-, or credential-scrub processor.
+ *
+ * Recognised placeholders include `<USER>`, `<HOST>`, `<MACHINE>`,
+ * `<EMAIL>`, `<AUTHOR>`, `<IPV4>`, `<REDACTED>` — the digit class is
+ * required for `<IPV4>`.
+ *
+ * Both processors MUST use this constant rather than defining their own,
+ * because they need to agree on what counts as redacted: manifest-builder
+ * records the keys, sqlite-exporter increments redactedSpanCount, and a
+ * silent disagreement between them would corrupt the audit trail.
+ */
+export declare const SENTINEL_PATTERN: RegExp;

package/dist/trajectory/processors/sentinel.js

@@ -0,0 +1,17 @@
+/**
+ * Sentinel pattern shared by scrub-aware processors (manifest-builder,
+ * sqlite-exporter). Any string attribute value matching this pattern is
+ * treated as a redaction placeholder produced upstream by an identity-,
+ * path-, or credential-scrub processor.
+ *
+ * Recognised placeholders include `<USER>`, `<HOST>`, `<MACHINE>`,
+ * `<EMAIL>`, `<AUTHOR>`, `<IPV4>`, `<REDACTED>` — the digit class is
+ * required for `<IPV4>`.
+ *
+ * Both processors MUST use this constant rather than defining their own,
+ * because they need to agree on what counts as redacted: manifest-builder
+ * records the keys, sqlite-exporter increments redactedSpanCount, and a
+ * silent disagreement between them would corrupt the audit trail.
+ */
+export const SENTINEL_PATTERN = /^<[A-Z0-9_]+>$/;
+//# sourceMappingURL=sentinel.js.map

package/dist/trajectory/processors/sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.js","sourceRoot":"","sources":["../../../src/trajectory/processors/sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC"}

package/dist/trajectory/processors/sqlite-exporter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Custom OTel SpanProcessor that persists capture-bound spans to SQLite.
+ *
+ * Capture-bound spans are those carrying a `jinn.session.id` attribute. They
+ * land in the `capture_spans` table (keyed by sessionId + spanId) and the
+ * corresponding `pending_captures` row's aggregate counters
+ * (span_count, redacted_span_count, duration_ms) are updated per-span.
+ *
+ * Out of scope for Phase 2: solver-bound spans (`jinn.task.id`). Those are
+ * still served by the in-memory TrajectoryCollector; migration to the SDK
+ * pipeline is a later phase.
+ *
+ * Spans whose session has no `pending_captures` row are silently dropped
+ * (e.g. session ended after the queue drained). This keeps the exporter
+ * idempotent and race-free without requiring foreign-key cascades.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.3
+ */
+import { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import type { CapturesStore } from '../../store/captures.js';
+export declare const SQLITE_EXPORTER_VERSION = "1.0.0";
+export interface SqliteExporterConfig {
+    captures: CapturesStore;
+}
+export declare class SqliteExporterProcessor implements SpanProcessor {
+    private readonly cfg;
+    constructor(cfg: SqliteExporterConfig);
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    onStart(): void;
+    onEnd(span: ReadableSpan): void;
+}

package/dist/trajectory/processors/sqlite-exporter.js

@@ -0,0 +1,48 @@
+import { SENTINEL_PATTERN } from './sentinel.js';
+export const SQLITE_EXPORTER_VERSION = '1.0.0';
+export class SqliteExporterProcessor {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    forceFlush() { return Promise.resolve(); }
+    shutdown() { return Promise.resolve(); }
+    onStart() { }
+    onEnd(span) {
+        const sessionId = span.attributes['jinn.session.id'];
+        if (typeof sessionId !== 'string')
+            return; // out of scope: solver flows
+        // Skip spans whose session has no pending row (e.g. session ended
+        // after queue drain, or capture was already approved/skipped).
+        const pending = this.cfg.captures.listPending();
+        if (!pending.some((r) => r.sessionId === sessionId))
+            return;
+        // Compute redactedKeys using the same sentinel pattern that
+        // ManifestBuilderProcessor uses for the redaction manifest.
+        const redactedKeys = [];
+        for (const [k, v] of Object.entries(span.attributes)) {
+            if (typeof v === 'string' && SENTINEL_PATTERN.test(v))
+                redactedKeys.push(k);
+        }
+        const startNs = BigInt(span.startTime[0]) * 1000000000n + BigInt(span.startTime[1]);
+        const endNs = BigInt(span.endTime[0]) * 1000000000n + BigInt(span.endTime[1]);
+        const durationMsDelta = Number((endNs - startNs) / 1000000n);
+        this.cfg.captures.appendSpan({
+            sessionId,
+            spanId: span.spanContext().spanId,
+            traceId: span.spanContext().traceId,
+            parentSpanId: span.parentSpanContext?.spanId ?? null,
+            name: span.name,
+            startTimeUnixNano: startNs.toString(),
+            endTimeUnixNano: endNs.toString(),
+            attributes: { ...span.attributes },
+            redactedKeys,
+        });
+        this.cfg.captures.incrementSpanCounts(sessionId, {
+            spans: 1,
+            redactedSpans: redactedKeys.length > 0 ? 1 : 0,
+            durationMsDelta,
+        });
+    }
+}
+//# sourceMappingURL=sqlite-exporter.js.map

package/dist/trajectory/processors/sqlite-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-exporter.js","sourceRoot":"","sources":["../../../src/trajectory/processors/sqlite-exporter.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAM/C,MAAM,OAAO,uBAAuB;IACL;IAA7B,YAA6B,GAAyB;QAAzB,QAAG,GAAH,GAAG,CAAsB;IAAG,CAAC;IAE1D,UAAU,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxC,OAAO,KAAI,CAAC;IAEZ,KAAK,CAAC,IAAkB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrD,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,CAAE,6BAA6B;QAEzE,kEAAkE;QAClE,+DAA+D;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;YAAE,OAAO;QAE5D,4DAA4D;QAC5D,4DAA4D;QAC5D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,WAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,WAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,QAAU,CAAC,CAAC;QAE/D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC3B,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM;YACjC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO;YACnC,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,IAAI,IAAI;YACpD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,iBAAiB,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrC,eAAe,EAAE,KAAK,CAAC,QAAQ,EAAE;YACjC,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;YAClC,YAAY;SACb,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE;YAC/C,KAAK,EAAE,CAAC;YACR,aAAa,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/trajectory/processors/transcript-content-scrub.d.ts

@@ -0,0 +1,9 @@
+import { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+export declare const TRANSCRIPT_CONTENT_SCRUB_VERSION = "1.0.0";
+export declare function containsSensitiveTranscriptContent(value: unknown): boolean;
+export declare class TranscriptContentScrubProcessor implements SpanProcessor {
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    onStart(): void;
+    onEnd(span: ReadableSpan): void;
+}

package/dist/trajectory/processors/transcript-content-scrub.js

@@ -0,0 +1,58 @@
+import { CREDENTIAL_REDACTED, isSensitiveCredentialKey, } from './credential-scrub.js';
+export const TRANSCRIPT_CONTENT_SCRUB_VERSION = '1.0.0';
+const TRANSCRIPT_CONTENT_KEYS = new Set([
+    'message.content',
+    'tool.args',
+    'tool.result',
+    'edit.diff',
+    'file.diff',
+]);
+const RAW_CREDENTIAL_PATTERNS = [
+    /\bBearer\s+[A-Za-z0-9._-]{10,}/i,
+    /\bsk-ant-[A-Za-z0-9_-]{20,}\b/,
+    /\bsk-[A-Za-z0-9_-]{20,}\b/,
+    /\bgh[pousr]_[A-Za-z0-9_]{20,}\b/,
+    /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/,
+];
+const CREDENTIAL_ASSIGNMENT_PATTERN = /\b[A-Za-z0-9_.-]*(?:authorization|api[_-]?key|apikey|bearer|password|secret|token|private[_-]?key|privatekey)[A-Za-z0-9_.-]*\b\s*[:=]/i;
+export function containsSensitiveTranscriptContent(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trimStart();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            try {
+                return containsSensitiveTranscriptContent(JSON.parse(value));
+            }
+            catch {
+                // Fall through to text checks.
+            }
+        }
+        return CREDENTIAL_ASSIGNMENT_PATTERN.test(value)
+            || RAW_CREDENTIAL_PATTERNS.some((pattern) => pattern.test(value));
+    }
+    if (Array.isArray(value)) {
+        return value.some((entry) => containsSensitiveTranscriptContent(entry));
+    }
+    if (value && typeof value === 'object') {
+        for (const [key, nested] of Object.entries(value)) {
+            if (isSensitiveCredentialKey(key))
+                return true;
+            if (containsSensitiveTranscriptContent(nested))
+                return true;
+        }
+    }
+    return false;
+}
+export class TranscriptContentScrubProcessor {
+    forceFlush() { return Promise.resolve(); }
+    shutdown() { return Promise.resolve(); }
+    onStart() { }
+    onEnd(span) {
+        const attrs = span.attributes;
+        for (const key of TRANSCRIPT_CONTENT_KEYS) {
+            if (containsSensitiveTranscriptContent(attrs[key])) {
+                attrs[key] = CREDENTIAL_REDACTED;
+            }
+        }
+    }
+}
+//# sourceMappingURL=transcript-content-scrub.js.map

package/dist/trajectory/processors/transcript-content-scrub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-content-scrub.js","sourceRoot":"","sources":["../../../src/trajectory/processors/transcript-content-scrub.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAExD,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,iBAAiB;IACjB,WAAW;IACX,aAAa;IACb,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAsB;IACjD,iCAAiC;IACjC,+BAA+B;IAC/B,2BAA2B;IAC3B,iCAAiC;IACjC,uDAAuD;CACxD,CAAC;AAEF,MAAM,6BAA6B,GACjC,wIAAwI,CAAC;AAE3I,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,OAAO,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QACD,OAAO,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC;eAC3C,uBAAuB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kCAAkC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,wBAAwB,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,IAAI,kCAAkC,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,+BAA+B;IAC1C,UAAU,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxC,OAAO,KAAI,CAAC;IAEZ,KAAK,CAAC,IAAkB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAqC,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;YAC1C,IAAI,kCAAkC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACnD,KAAK,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/trajectory/receiver.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Embedded OTLP receiver — accepts OpenTelemetry traces over OTLP/HTTP
+ * (`POST /v1/traces`, default JSON encoding from `@opentelemetry/exporter-trace-otlp-http`)
+ * and OTLP/gRPC (`/opentelemetry.proto.collector.trace.v1.TraceService/Export`).
+ *
+ * Decoded spans are converted to `ReadableSpan`-shaped objects and pushed
+ * through the configured `SpanProcessor` chain (`onEnd` only — receivers
+ * don't observe `onStart`).
+ *
+ * In production the receiver listens on standard OTel ports (4317 / 4318);
+ * in tests pass `grpcPort: 0` / `httpPort: 0` for ephemeral binds.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.1, §4.3.
+ */
+import type { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+export interface ReceiverOptions {
+    /** TCP port for OTLP/gRPC. `0` = ephemeral (use the resolved value from `Receiver.grpcPort`). */
+    grpcPort: number;
+    /** TCP port for OTLP/HTTP. `0` = ephemeral. */
+    httpPort: number;
+    /**
+     * Optional processor chain. Each processor's `onEnd(span)` receives every
+     * decoded span, in receive order. If omitted, only the test sink is used.
+     */
+    processors?: SpanProcessor[];
+}
+export interface TestSink {
+    spans: ReadableSpan[];
+}
+export interface Receiver {
+    grpcPort: number;
+    httpPort: number;
+    /** Always-on test capture of every span the receiver decoded. */
+    testSink: TestSink;
+    shutdown(): Promise<void>;
+}
+export declare function startReceiver(opts: ReceiverOptions): Promise<Receiver>;