@attestplane/attestplane 0.0.1 → 0.0.4-alpha

package/README.md

@@ -1,10 +1,14 @@
 # @attestplane/attestplane — TypeScript SDK
 
-Verifiable audit substrate for AI agents. EU AI Act Article 12 ready.
+Apache-2.0 attestation and audit substrate for AI agent evidence chains.
 
-> **Status: alpha (v0.0.1).** Wire format is byte-locked against the Python
+> **Status: alpha (v0.0.4-alpha).** Wire format is byte-locked against the Python
 > SDK's [`vectors.json`](../python/tests/conformance/vectors.json) — see
 > [ADR-0002][adr2]. APIs may still change before v0.1.0.
+> The current Python CLI `attestplane verify` path is chain/report-oriented
+> with ProofBundle metadata and `policy_trace_refs` closure checks. It does
+> not perform full ProofBundle, signature, anchor, or compliance
+> certification verification.
 
 See the [project README][project-readme] for background, governance, and
 trademark policy.
@@ -15,9 +19,16 @@ trademark policy.
 ## Install
 
 ```bash
-npm install @attestplane/attestplane
+# Pin the alpha explicitly; v0.0.4-alpha is the next prepared alpha version.
+npm install @attestplane/attestplane@alpha
+# or, equivalent:
+npm install @attestplane/attestplane@0.0.4-alpha
 ```
 
+`npm install @attestplane/attestplane` without a tag also resolves to
+the current published dist-tag. Treat the `alpha` tag as the authoritative
+pre-release channel until v0.1.0 ships.
+
 Requires Node.js ≥ 22.
 
 ## Quickstart
@@ -55,9 +66,11 @@ will reproduce the exact byte value from the same input.
 ## What this SDK gives you
 
 - An **append-only** audit log with cryptographic integrity (SHA-256 hash chain).
-- Built-in **EU AI Act Art. 12(2)(a)** field coverage from day one.
+- Built-in fields designed toward **EU AI Act Art. 12(2)(a)** auditability from day one.
 - Byte-identical canonical format compatible with the Python SDK.
 - Strong **GDPR pseudonymization typing** via `SubjectRef`.
+- Alpha-grade verifier predicates; do not treat this SDK as production-ready
+  governance, compliance certification, or runtime execution authority.
 
 ## API conventions
 
@@ -76,17 +89,18 @@ Payloads must satisfy the restricted profile of ADR-0002:
 |---|---|
 | `string` (NFC-normalized UTF-8) | non-NFC strings |
 | `number` (integer, safe range) | floats, `NaN`, `Infinity` |
-| `bigint` (within signed 64-bit range) | bigint outside int64 |
+| `number` values must be safe integers | unsafe integers; direct `bigint` |
 | `true` / `false` / `null` | — |
 | plain objects (string keys) | non-string keys; duplicate keys |
-| arrays | — |
+| arrays | sparse arrays; `undefined` items |
 | `Uint8Array` (emits as base64url no padding) | other byte types |
-| `Date` (UTC, encoded as RFC 3339 µs `Z`) | invalid Date |
+| explicit RFC 3339 timestamp strings | direct `Date` objects in canonical JSON payloads |
 
 Violations throw `CanonicalizationError` at append time.
 
-For sub-millisecond precision, encode the timestamp as a string (JS `Date`
-only stores millisecond resolution).
+`AttestSubstrate.append()` accepts `Date` at the typed SDK boundary for
+`AuditEvent.timestamp` and converts it explicitly before hashing. Payloads
+should carry timestamps as strings when they need to be part of canonical JSON.
 
 ## Development
 

package/dist/adapter_conformance.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Adapter-conformance fixture replayer (ADR-0014 P2.2).
+ *
+ * TypeScript mirror of `attestplane.adapter_conformance` (Python).
+ * Loads a fixture file, calls `adapter.translate()` per case, asserts
+ * canonical-bytes equality against `expected_event_draft`. Pure — no
+ * I/O beyond the fixture file read.
+ */
+import type { EventDraft } from './types.js';
+export interface AdapterCaseResult {
+    readonly case_name: string;
+    readonly ok: boolean;
+    readonly reason: string | null;
+    readonly expected_canonical_hash: string | null;
+    readonly actual_canonical_hash: string | null;
+}
+export interface AdapterConformanceReport {
+    readonly fixture_path: string;
+    readonly runtime_kind: string;
+    readonly fixture_version: number;
+    readonly cases_total: number;
+    readonly cases_passed: number;
+    readonly cases_failed: number;
+    readonly results: readonly AdapterCaseResult[];
+    readonly ok: boolean;
+}
+export declare class AdapterConformanceError extends Error {
+    constructor(message: string);
+}
+export interface ReplayOptions {
+    /** Optional callback to convert raw `runtime_event_input` into the
+     *  runtime-event type the adapter's `translate()` expects. */
+    readonly pre_translate?: (raw: Record<string, unknown>) => unknown;
+}
+/** An adapter-shaped object: has a `translate()` method returning an `EventDraft`. */
+export interface TranslateAdapter<RE = unknown> {
+    translate(runtimeEvent: RE): EventDraft;
+}
+/**
+ * Replay every case in `fixturePath` against `adapter.translate()`.
+ *
+ * `report.ok` is true iff every case's adapter output matches its
+ * `expected_event_draft` byte-equal under canonical-JSON.
+ */
+export declare function replayFixture(fixturePath: string, adapter: TranslateAdapter, options?: ReplayOptions): AdapterConformanceReport;
+//# sourceMappingURL=adapter_conformance.d.ts.map

package/dist/adapter_conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter_conformance.d.ts","sourceRoot":"","sources":["../src/adapter_conformance.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AA+HD,MAAM,WAAW,aAAa;IAC5B;kEAC8D;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CACpE;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB,CAAC,EAAE,GAAG,OAAO;IAC5C,SAAS,CAAC,YAAY,EAAE,EAAE,GAAG,UAAU,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,aAAkB,GAC1B,wBAAwB,CAyD1B"}

package/dist/adapter_conformance.js

@@ -0,0 +1,160 @@
+// SPDX-FileCopyrightText: 2026 The Attestplane Authors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Adapter-conformance fixture replayer (ADR-0014 P2.2).
+ *
+ * TypeScript mirror of `attestplane.adapter_conformance` (Python).
+ * Loads a fixture file, calls `adapter.translate()` per case, asserts
+ * canonical-bytes equality against `expected_event_draft`. Pure — no
+ * I/O beyond the fixture file read.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { canonicalize } from './canonical.js';
+export class AdapterConformanceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AdapterConformanceError';
+    }
+}
+function subjectRefToDict(ref) {
+    if (ref === null || ref === undefined)
+        return null;
+    return { scheme: ref.scheme, value: ref.value };
+}
+function eventDraftToDict(draft) {
+    return {
+        event_type: draft.event_type,
+        actor: draft.actor,
+        payload: draft.payload,
+        subject_ref: subjectRefToDict(draft.subject_ref),
+        session_id: draft.session_id,
+        reference_db_ref: draft.reference_db_ref,
+        matched_input_ref: draft.matched_input_ref,
+        human_verifier: subjectRefToDict(draft.human_verifier),
+    };
+}
+function canonicalBytesHash(d) {
+    return createHash('sha256').update(canonicalize(d)).digest('hex');
+}
+function loadAndValidateFixture(fixturePath) {
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(fixturePath, 'utf-8'));
+    }
+    catch (exc) {
+        throw new AdapterConformanceError(`cannot load fixture ${fixturePath}: ${exc.message}`);
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: top level must be object, got ${Array.isArray(raw) ? 'array' : raw === null ? 'null' : typeof raw}`);
+    }
+    const obj = raw;
+    if (obj.$schema_version !== 1) {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: $schema_version must be 1, got ${JSON.stringify(obj.$schema_version)}`);
+    }
+    if (obj.fixture_kind !== 'adapter_conformance') {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: fixture_kind must be 'adapter_conformance', got ${JSON.stringify(obj.fixture_kind)}`);
+    }
+    if (typeof obj.runtime_kind !== 'string' || obj.runtime_kind.length === 0) {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: runtime_kind must be non-empty string`);
+    }
+    if (typeof obj.fixture_version !== 'number' ||
+        !Number.isInteger(obj.fixture_version) ||
+        obj.fixture_version < 1) {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: fixture_version must be integer >= 1`);
+    }
+    if (!Array.isArray(obj.cases) || obj.cases.length === 0) {
+        throw new AdapterConformanceError(`fixture ${fixturePath}: cases must be non-empty array`);
+    }
+    const seenNames = new Set();
+    for (let i = 0; i < obj.cases.length; i++) {
+        const c = obj.cases[i];
+        if (c === null || typeof c !== 'object' || Array.isArray(c)) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: cases[${i}] must be object`);
+        }
+        const co = c;
+        if (typeof co.name !== 'string' || co.name.length === 0) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: cases[${i}].name must be non-empty string`);
+        }
+        if (seenNames.has(co.name)) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: duplicate case name ${JSON.stringify(co.name)}`);
+        }
+        seenNames.add(co.name);
+        if (!('runtime_event_input' in co)) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: cases[${i}] missing runtime_event_input`);
+        }
+        if (!('expected_event_draft' in co)) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: cases[${i}] missing expected_event_draft`);
+        }
+        if (co.expected_event_draft === null ||
+            typeof co.expected_event_draft !== 'object' ||
+            Array.isArray(co.expected_event_draft)) {
+            throw new AdapterConformanceError(`fixture ${fixturePath}: cases[${i}].expected_event_draft must be object`);
+        }
+    }
+    return obj;
+}
+/**
+ * Replay every case in `fixturePath` against `adapter.translate()`.
+ *
+ * `report.ok` is true iff every case's adapter output matches its
+ * `expected_event_draft` byte-equal under canonical-JSON.
+ */
+export function replayFixture(fixturePath, adapter, options = {}) {
+    const fixture = loadAndValidateFixture(fixturePath);
+    const results = [];
+    let passed = 0;
+    let failed = 0;
+    for (const c of fixture.cases) {
+        const expectedHash = canonicalBytesHash(c.expected_event_draft);
+        try {
+            const runtimeEvent = options.pre_translate !== undefined
+                ? options.pre_translate(c.runtime_event_input)
+                : c.runtime_event_input;
+            const actualDraft = adapter.translate(runtimeEvent);
+            const actual = eventDraftToDict(actualDraft);
+            const actualHash = canonicalBytesHash(actual);
+            if (actualHash === expectedHash) {
+                results.push({
+                    case_name: c.name,
+                    ok: true,
+                    reason: null,
+                    expected_canonical_hash: expectedHash,
+                    actual_canonical_hash: actualHash,
+                });
+                passed++;
+            }
+            else {
+                results.push({
+                    case_name: c.name,
+                    ok: false,
+                    reason: `canonical-bytes mismatch (expected hash ${expectedHash}, got ${actualHash})`,
+                    expected_canonical_hash: expectedHash,
+                    actual_canonical_hash: actualHash,
+                });
+                failed++;
+            }
+        }
+        catch (exc) {
+            results.push({
+                case_name: c.name,
+                ok: false,
+                reason: `adapter raised: ${exc.name}: ${exc.message}`,
+                expected_canonical_hash: expectedHash,
+                actual_canonical_hash: null,
+            });
+            failed++;
+        }
+    }
+    return {
+        fixture_path: fixturePath,
+        runtime_kind: fixture.runtime_kind,
+        fixture_version: fixture.fixture_version,
+        cases_total: fixture.cases.length,
+        cases_passed: passed,
+        cases_failed: failed,
+        results,
+        ok: failed === 0,
+    };
+}
+//# sourceMappingURL=adapter_conformance.js.map

package/dist/adapter_conformance.js.map

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

package/dist/adapters/langfuse.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LangFuse → Attestplane evidence-event adapter (TypeScript port of
+ * `sdk/python/src/attestplane/adapters/langfuse.py`).
+ *
+ * Byte-identical translation semantics with the Python adapter.
+ *
+ * Pure function per GenericRuntimeAdapter contract: no I/O, no
+ * LangFuse API calls.
+ *
+ * Trust boundary (ADR-0004 § 4): adapter consumes the public
+ * LangFuse Observation shape; LangFuse / ClickHouse do not endorse
+ * this adapter (see docs/policy/forbidden_claims.md § G).
+ *
+ * Redaction (ADR-0008 § Boundary anti-requirements):
+ * - Raw input / output never copied to payload — only SHA-256 hashes.
+ * - status_message truncated to 200 chars before placing in error_code.
+ * - user_id (from parent Trace) wrapped in SubjectRef(scheme="opaque").
+ *
+ * Observation type → event_type mapping:
+ *   GENERATION / SPAN / EVENT → tool_call_event with payload.kind set.
+ *
+ * Level → result_status mapping:
+ *   ERROR → "ERROR"; everything else → "OK" (WARNING preserved as
+ *   payload.level but not flipping status).
+ */
+import { GenericRuntimeAdapter } from '../adapters.js';
+import { type EventDraft } from '../types.js';
+export interface LangFuseObservation {
+    readonly id: string;
+    readonly trace_id: string;
+    readonly type: string;
+    readonly name?: string | null;
+    readonly start_time?: Date | null;
+    readonly end_time?: Date | null;
+    readonly input?: unknown;
+    readonly output?: unknown;
+    readonly level?: string | null;
+    readonly metadata?: Record<string, unknown>;
+    readonly status_message?: string | null;
+    readonly model?: string | null;
+    readonly user_id?: string | null;
+}
+export declare class LangFuseAdapter extends GenericRuntimeAdapter<LangFuseObservation> {
+    readonly runtime_name = "langfuse";
+    readonly schema_version = 1;
+    translate(runtime_event: LangFuseObservation): EventDraft;
+    static fromDict(raw: Record<string, unknown>, options?: {
+        readonly user_id?: string;
+    }): LangFuseObservation;
+}
+//# sourceMappingURL=langfuse.d.ts.map

package/dist/adapters/langfuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuse.d.ts","sourceRoot":"","sources":["../../src/adapters/langfuse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAA2B,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,KAAK,UAAU,EAAkC,MAAM,aAAa,CAAC;AAK9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAiCD,qBAAa,eAAgB,SAAQ,qBAAqB,CAAC,mBAAmB,CAAC;IAC7E,QAAQ,CAAC,YAAY,cAAc;IACnC,QAAQ,CAAC,cAAc,KAAK;IAE5B,SAAS,CAAC,aAAa,EAAE,mBAAmB,GAAG,UAAU;IA+DzD,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,mBAAmB;CA4CvB"}

package/dist/adapters/langfuse.js

@@ -0,0 +1,157 @@
+// SPDX-FileCopyrightText: 2026 The Attestplane Authors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * LangFuse → Attestplane evidence-event adapter (TypeScript port of
+ * `sdk/python/src/attestplane/adapters/langfuse.py`).
+ *
+ * Byte-identical translation semantics with the Python adapter.
+ *
+ * Pure function per GenericRuntimeAdapter contract: no I/O, no
+ * LangFuse API calls.
+ *
+ * Trust boundary (ADR-0004 § 4): adapter consumes the public
+ * LangFuse Observation shape; LangFuse / ClickHouse do not endorse
+ * this adapter (see docs/policy/forbidden_claims.md § G).
+ *
+ * Redaction (ADR-0008 § Boundary anti-requirements):
+ * - Raw input / output never copied to payload — only SHA-256 hashes.
+ * - status_message truncated to 200 chars before placing in error_code.
+ * - user_id (from parent Trace) wrapped in SubjectRef(scheme="opaque").
+ *
+ * Observation type → event_type mapping:
+ *   GENERATION / SPAN / EVENT → tool_call_event with payload.kind set.
+ *
+ * Level → result_status mapping:
+ *   ERROR → "ERROR"; everything else → "OK" (WARNING preserved as
+ *   payload.level but not flipping status).
+ */
+import { createHash } from 'node:crypto';
+import { AdapterTranslationError, GenericRuntimeAdapter } from '../adapters.js';
+import { TOOL_CALL_EVENT } from '../event_types.js';
+import { makeEventDraft, makeSubjectRef } from '../types.js';
+const KNOWN_OBSERVATION_TYPES = new Set(['GENERATION', 'SPAN', 'EVENT']);
+const KNOWN_LEVELS = new Set(['DEFAULT', 'DEBUG', 'WARNING', 'ERROR']);
+function _canonicalReplacer() {
+    return function (_key, value) {
+        if (value === undefined)
+            return undefined;
+        if (value instanceof Date)
+            return value.toISOString();
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            const sorted = {};
+            const obj = value;
+            for (const k of Object.keys(obj).sort()) {
+                sorted[k] = obj[k];
+            }
+            return sorted;
+        }
+        return value;
+    };
+}
+function _hashJson(value) {
+    const sorted = JSON.parse(JSON.stringify(value, _canonicalReplacer()));
+    const compact = JSON.stringify(sorted);
+    return createHash('sha256').update(compact, 'utf-8').digest('hex');
+}
+function _truncate(text, n = 200) {
+    if (text.length <= n)
+        return text;
+    return `${text.slice(0, n - 3)}...`;
+}
+function _levelToStatus(level) {
+    return level === 'ERROR' ? 'ERROR' : 'OK';
+}
+export class LangFuseAdapter extends GenericRuntimeAdapter {
+    runtime_name = 'langfuse';
+    schema_version = 1;
+    translate(runtime_event) {
+        if (typeof runtime_event !== 'object' ||
+            runtime_event === null ||
+            typeof runtime_event.id !== 'string' ||
+            typeof runtime_event.trace_id !== 'string' ||
+            typeof runtime_event.type !== 'string') {
+            throw new AdapterTranslationError(`expected LangFuseObservation object, got ${runtime_event === null ? 'null' : typeof runtime_event}`);
+        }
+        const obs = runtime_event;
+        const kind = KNOWN_OBSERVATION_TYPES.has(obs.type) ? obs.type.toLowerCase() : 'unknown';
+        const resultStatus = _levelToStatus(obs.level);
+        const payload = {
+            kind,
+            tool_name: `langfuse.${kind}.${obs.name ?? 'unnamed'}`,
+            tool_call_id: obs.id,
+            result_status: resultStatus,
+        };
+        if (obs.input !== undefined && obs.input !== null) {
+            payload.arguments_hash = _hashJson(obs.input);
+        }
+        else {
+            // Schema requires arguments_hash always present; hash empty dict.
+            payload.arguments_hash = _hashJson({});
+        }
+        if (obs.output !== undefined && obs.output !== null) {
+            payload.result_hash = _hashJson(obs.output);
+        }
+        if (obs.start_time != null && obs.end_time != null) {
+            const ms = obs.end_time.getTime() - obs.start_time.getTime();
+            payload.latency_ms = Math.trunc(ms);
+        }
+        if (obs.status_message && resultStatus === 'ERROR') {
+            payload.error_code = _truncate(obs.status_message);
+        }
+        if (obs.model) {
+            payload.tool_version = obs.model;
+        }
+        if (obs.level && KNOWN_LEVELS.has(obs.level) && obs.level !== 'DEFAULT') {
+            payload.level = obs.level;
+        }
+        return makeEventDraft({
+            event_type: TOOL_CALL_EVENT,
+            actor: `langfuse://${kind}/${obs.name ?? 'unnamed'}`,
+            payload,
+            subject_ref: obs.user_id ? makeSubjectRef('opaque', obs.user_id) : null,
+            session_id: obs.trace_id,
+        });
+    }
+    static fromDict(raw, options) {
+        const required = ['id', 'trace_id', 'type'];
+        const missing = required.filter((k) => !(k in raw));
+        if (missing.length > 0) {
+            throw new AdapterTranslationError(`LangFuse observation dict missing required fields: ${JSON.stringify(missing.sort())}`);
+        }
+        const parseDt = (value) => {
+            if (value == null)
+                return null;
+            if (value instanceof Date)
+                return value;
+            if (typeof value === 'string') {
+                const normalized = value.endsWith('Z') ? value.replace('Z', '+00:00') : value;
+                const d = new Date(normalized);
+                if (Number.isNaN(d.getTime())) {
+                    throw new AdapterTranslationError(`unparsable datetime ${JSON.stringify(value)}`);
+                }
+                return d;
+            }
+            throw new AdapterTranslationError(`datetime field has type ${typeof value}`);
+        };
+        const metadata = raw.metadata ?? {};
+        if (typeof metadata !== 'object' || Array.isArray(metadata)) {
+            throw new AdapterTranslationError('metadata must be an object');
+        }
+        return {
+            id: String(raw.id),
+            trace_id: String(raw.trace_id),
+            type: String(raw.type),
+            name: raw.name ?? null,
+            start_time: parseDt(raw.start_time),
+            end_time: parseDt(raw.end_time),
+            input: raw.input,
+            output: raw.output,
+            level: raw.level ?? null,
+            metadata,
+            status_message: raw.status_message ?? null,
+            model: raw.model ?? null,
+            user_id: options?.user_id ?? null,
+        };
+    }
+}
+//# sourceMappingURL=langfuse.js.map

package/dist/adapters/langfuse.js.map

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

package/dist/adapters/langsmith.d.ts

@@ -0,0 +1,53 @@
+/**
+ * LangSmith → Attestplane evidence-event adapter (TypeScript port of
+ * `sdk/python/src/attestplane/adapters/langsmith.py`).
+ *
+ * Byte-identical translation semantics with the Python adapter:
+ * given the same LangSmith Run, both adapters produce the same
+ * EventDraft fields (event_type, actor, payload, subject_ref,
+ * session_id, reference_db_ref).
+ *
+ * Pure function per GenericRuntimeAdapter contract: no I/O, no
+ * LangSmith API calls.
+ *
+ * Trust boundary (ADR-0004 § 4): adapter consumes the public
+ * LangSmith Run shape, not LangChain proprietary code. LangChain
+ * does not endorse this adapter; see docs/policy/forbidden_claims.md
+ * § G.
+ *
+ * Redaction (ADR-0008 § Boundary anti-requirements):
+ * - Raw inputs / outputs are NEVER copied to payload — only SHA-256
+ *   hashes go in `arguments_hash` / `result_hash`.
+ * - Error strings are truncated to 200 chars to limit PII leakage.
+ * - end_user_id (from LangSmith metadata.user_id) is wrapped in
+ *   SubjectRef(scheme="opaque").
+ *
+ * Run type → event_type mapping is identical to the Python adapter:
+ * all run_types map to `tool_call_event` in v1; payload.kind carries
+ * the LangSmith run_type for downstream filtering.
+ */
+import { GenericRuntimeAdapter } from '../adapters.js';
+import { type EventDraft } from '../types.js';
+export interface LangSmithRun {
+    readonly id: string;
+    readonly name: string;
+    readonly run_type: string;
+    readonly start_time: Date;
+    readonly end_time?: Date | null;
+    readonly inputs?: Record<string, unknown>;
+    readonly outputs?: Record<string, unknown> | null;
+    readonly error?: string | null;
+    readonly trace_id?: string | null;
+    readonly parent_run_id?: string | null;
+    readonly status?: string | null;
+    readonly tags?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+    readonly end_user_id?: string | null;
+}
+export declare class LangSmithAdapter extends GenericRuntimeAdapter<LangSmithRun> {
+    readonly runtime_name = "langsmith";
+    readonly schema_version = 1;
+    translate(runtime_event: LangSmithRun): EventDraft;
+    static fromDict(raw: Record<string, unknown>): LangSmithRun;
+}
+//# sourceMappingURL=langsmith.d.ts.map

package/dist/adapters/langsmith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langsmith.d.ts","sourceRoot":"","sources":["../../src/adapters/langsmith.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAA2B,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,KAAK,UAAU,EAAkC,MAAM,aAAa,CAAC;AAY9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAmCD,qBAAa,gBAAiB,SAAQ,qBAAqB,CAAC,YAAY,CAAC;IACvE,QAAQ,CAAC,YAAY,eAAe;IACpC,QAAQ,CAAC,cAAc,KAAK;IAE5B,SAAS,CAAC,aAAa,EAAE,YAAY,GAAG,UAAU;IAyDlD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAoD5D"}