@attest-ai/core 0.3.0

package/dist/proto/types.d.ts

@@ -0,0 +1,104 @@
+export interface TraceMetadata {
+    readonly total_tokens?: number;
+    readonly cost_usd?: number;
+    readonly latency_ms?: number;
+    readonly model?: string;
+    readonly timestamp?: string;
+}
+export interface Step {
+    readonly type: string;
+    readonly name: string;
+    readonly args?: Record<string, unknown>;
+    readonly result?: Record<string, unknown>;
+    readonly sub_trace?: Trace;
+    readonly metadata?: Record<string, unknown>;
+    readonly started_at_ms?: number;
+    readonly ended_at_ms?: number;
+    readonly agent_id?: string;
+    readonly agent_role?: string;
+}
+export interface Trace {
+    readonly trace_id: string;
+    readonly output: Record<string, unknown>;
+    readonly schema_version?: number;
+    readonly agent_id?: string;
+    readonly input?: Record<string, unknown>;
+    readonly steps: readonly Step[];
+    readonly metadata?: TraceMetadata;
+    readonly parent_trace_id?: string;
+}
+export interface Assertion {
+    readonly assertion_id: string;
+    readonly type: string;
+    readonly spec: Record<string, unknown>;
+    readonly request_id?: string;
+}
+export interface AssertionResult {
+    readonly assertion_id: string;
+    readonly status: string;
+    readonly score: number;
+    readonly explanation: string;
+    readonly cost?: number;
+    readonly duration_ms?: number;
+    readonly request_id?: string;
+}
+export interface ErrorData {
+    readonly error_type: string;
+    readonly retryable: boolean;
+    readonly detail: string;
+}
+export interface RPCError {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: ErrorData;
+}
+export interface RPCRequest {
+    readonly jsonrpc: "2.0";
+    readonly id: number;
+    readonly method: string;
+    readonly params: Record<string, unknown>;
+}
+export interface RPCResponse {
+    readonly jsonrpc: "2.0";
+    readonly id: number;
+    readonly result?: unknown;
+    readonly error?: RPCError;
+}
+export interface InitializeParams {
+    readonly sdk_name: string;
+    readonly sdk_version: string;
+    readonly protocol_version: number;
+    readonly required_capabilities: readonly string[];
+    readonly preferred_encoding?: string;
+}
+export interface InitializeResult {
+    readonly engine_version: string;
+    readonly protocol_version: number;
+    readonly capabilities: readonly string[];
+    readonly missing: readonly string[];
+    readonly compatible: boolean;
+    readonly encoding?: string;
+    readonly max_concurrent_requests?: number;
+    readonly max_trace_size_bytes?: number;
+    readonly max_steps_per_trace?: number;
+}
+export interface EvaluateBatchParams {
+    readonly trace: Trace;
+    readonly assertions: readonly Assertion[];
+}
+export interface EvaluateBatchResult {
+    readonly results: readonly AssertionResult[];
+    readonly total_cost?: number;
+    readonly total_duration_ms?: number;
+}
+export interface ShutdownResult {
+    readonly sessions_completed: number;
+    readonly assertions_evaluated: number;
+}
+export interface SubmitPluginResultParams {
+    readonly trace_id: string;
+    readonly plugin_name: string;
+    readonly assertion_id: string;
+    readonly result: AssertionResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/proto/types.d.ts.map

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

package/dist/proto/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/proto/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/proto/types.ts"],"names":[],"mappings":""}

package/dist/result.d.ts

@@ -0,0 +1,15 @@
+import type { AssertionResult, Trace } from "./proto/types.js";
+export declare class AgentResult {
+    readonly trace: Trace;
+    readonly assertionResults: readonly AssertionResult[];
+    readonly totalCost: number;
+    readonly totalDurationMs: number;
+    constructor(trace: Trace, assertionResults?: readonly AssertionResult[], totalCost?: number, totalDurationMs?: number);
+    get passed(): boolean;
+    get failedAssertions(): readonly AssertionResult[];
+    get hardFailures(): readonly AssertionResult[];
+    get softFailures(): readonly AssertionResult[];
+    get passCount(): number;
+    get failCount(): number;
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAO/D,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAG/B,KAAK,EAAE,KAAK,EACZ,gBAAgB,GAAE,SAAS,eAAe,EAAO,EACjD,SAAS,SAAM,EACf,eAAe,SAAI;IAQrB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,gBAAgB,IAAI,SAAS,eAAe,EAAE,CAEjD;IAED,IAAI,YAAY,IAAI,SAAS,eAAe,EAAE,CAE7C;IAED,IAAI,YAAY,IAAI,SAAS,eAAe,EAAE,CAE7C;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/result.js

@@ -0,0 +1,32 @@
+import { STATUS_PASS, STATUS_SOFT_FAIL, STATUS_HARD_FAIL, } from "./proto/constants.js";
+export class AgentResult {
+    trace;
+    assertionResults;
+    totalCost;
+    totalDurationMs;
+    constructor(trace, assertionResults = [], totalCost = 0.0, totalDurationMs = 0) {
+        this.trace = trace;
+        this.assertionResults = assertionResults;
+        this.totalCost = totalCost;
+        this.totalDurationMs = totalDurationMs;
+    }
+    get passed() {
+        return this.assertionResults.every((r) => r.status === STATUS_PASS);
+    }
+    get failedAssertions() {
+        return this.assertionResults.filter((r) => r.status !== STATUS_PASS);
+    }
+    get hardFailures() {
+        return this.assertionResults.filter((r) => r.status === STATUS_HARD_FAIL);
+    }
+    get softFailures() {
+        return this.assertionResults.filter((r) => r.status === STATUS_SOFT_FAIL);
+    }
+    get passCount() {
+        return this.assertionResults.filter((r) => r.status === STATUS_PASS).length;
+    }
+    get failCount() {
+        return this.assertionResults.length - this.passCount;
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,OAAO,WAAW;IACb,KAAK,CAAQ;IACb,gBAAgB,CAA6B;IAC7C,SAAS,CAAS;IAClB,eAAe,CAAS;IAEjC,YACE,KAAY,EACZ,mBAA+C,EAAE,EACjD,SAAS,GAAG,GAAG,EACf,eAAe,GAAG,CAAC;QAEnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC9E,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}

package/dist/tier.d.ts

@@ -0,0 +1,5 @@
+export declare const TIER_1: 1;
+export declare const TIER_2: 2;
+export declare const TIER_3: 3;
+export declare function tier(level: number): <T extends (...args: never[]) => unknown>(fn: T) => T;
+//# sourceMappingURL=tier.d.ts.map

package/dist/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../src/tier.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,EAAG,CAAU,CAAC;AACjC,eAAO,MAAM,MAAM,EAAG,CAAU,CAAC;AACjC,eAAO,MAAM,MAAM,EAAG,CAAU,CAAC;AAEjC,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAKzF"}

package/dist/tier.js

@@ -0,0 +1,10 @@
+export const TIER_1 = 1;
+export const TIER_2 = 2;
+export const TIER_3 = 3;
+export function tier(level) {
+    return (fn) => {
+        fn._attest_tier = level;
+        return fn;
+    };
+}
+//# sourceMappingURL=tier.js.map

package/dist/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../src/tier.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,CAAC;AAEjC,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,CAA0C,EAAK,EAAK,EAAE;QAC1D,EAA8B,CAAC,YAAY,GAAG,KAAK,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/dist/trace-tree.d.ts

@@ -0,0 +1,20 @@
+import type { Step, Trace } from "./proto/types.js";
+export declare class TraceTree {
+    readonly root: Trace;
+    constructor(root: Trace);
+    get agents(): string[];
+    private collectAgents;
+    findAgent(agentId: string): Trace | undefined;
+    private findAgentIn;
+    get depth(): number;
+    private computeDepth;
+    flatten(): Trace[];
+    private flattenInto;
+    get delegations(): [string, string][];
+    private collectDelegations;
+    allToolCalls(): Step[];
+    get aggregateTokens(): number;
+    get aggregateCost(): number;
+    get aggregateLatency(): number;
+}
+//# sourceMappingURL=trace-tree.d.ts.map

package/dist/trace-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-tree.d.ts","sourceRoot":"","sources":["../src/trace-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGpD,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;gBAET,IAAI,EAAE,KAAK;IAIvB,IAAI,MAAM,IAAI,MAAM,EAAE,CAIrB;IAED,OAAO,CAAC,aAAa;IAWrB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI7C,OAAO,CAAC,WAAW;IAWnB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,OAAO,CAAC,YAAY;IAWpB,OAAO,IAAI,KAAK,EAAE;IAMlB,OAAO,CAAC,WAAW;IASnB,IAAI,WAAW,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAIpC;IAED,OAAO,CAAC,kBAAkB;IAW1B,YAAY,IAAI,IAAI,EAAE;IAMtB,IAAI,eAAe,IAAI,MAAM,CAK5B;IAED,IAAI,aAAa,IAAI,MAAM,CAK1B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAK7B;CACF"}

package/dist/trace-tree.js

@@ -0,0 +1,92 @@
+import { STEP_AGENT_CALL, STEP_TOOL_CALL } from "./proto/constants.js";
+export class TraceTree {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    get agents() {
+        const result = [];
+        this.collectAgents(this.root, result);
+        return result;
+    }
+    collectAgents(trace, acc) {
+        if (trace.agent_id != null) {
+            acc.push(trace.agent_id);
+        }
+        for (const step of trace.steps) {
+            if (step.type === STEP_AGENT_CALL && step.sub_trace != null) {
+                this.collectAgents(step.sub_trace, acc);
+            }
+        }
+    }
+    findAgent(agentId) {
+        return this.findAgentIn(this.root, agentId);
+    }
+    findAgentIn(trace, agentId) {
+        if (trace.agent_id === agentId)
+            return trace;
+        for (const step of trace.steps) {
+            if (step.type === STEP_AGENT_CALL && step.sub_trace != null) {
+                const found = this.findAgentIn(step.sub_trace, agentId);
+                if (found !== undefined)
+                    return found;
+            }
+        }
+        return undefined;
+    }
+    get depth() {
+        return this.computeDepth(this.root);
+    }
+    computeDepth(trace) {
+        let maxChild = -1;
+        for (const step of trace.steps) {
+            if (step.type === STEP_AGENT_CALL && step.sub_trace != null) {
+                const childDepth = this.computeDepth(step.sub_trace);
+                if (childDepth > maxChild)
+                    maxChild = childDepth;
+            }
+        }
+        return maxChild >= 0 ? maxChild + 1 : 0;
+    }
+    flatten() {
+        const result = [];
+        this.flattenInto(this.root, result);
+        return result;
+    }
+    flattenInto(trace, acc) {
+        acc.push(trace);
+        for (const step of trace.steps) {
+            if (step.type === STEP_AGENT_CALL && step.sub_trace != null) {
+                this.flattenInto(step.sub_trace, acc);
+            }
+        }
+    }
+    get delegations() {
+        const result = [];
+        this.collectDelegations(this.root, result);
+        return result;
+    }
+    collectDelegations(trace, acc) {
+        const parentId = trace.agent_id ?? "";
+        for (const step of trace.steps) {
+            if (step.type === STEP_AGENT_CALL && step.sub_trace != null) {
+                const childId = step.sub_trace.agent_id ?? "";
+                acc.push([parentId, childId]);
+                this.collectDelegations(step.sub_trace, acc);
+            }
+        }
+    }
+    allToolCalls() {
+        return this.flatten().flatMap((t) => t.steps.filter((step) => step.type === STEP_TOOL_CALL));
+    }
+    get aggregateTokens() {
+        return this.flatten().reduce((sum, t) => sum + (t.metadata?.total_tokens ?? 0), 0);
+    }
+    get aggregateCost() {
+        return this.flatten().reduce((sum, t) => sum + (t.metadata?.cost_usd ?? 0), 0);
+    }
+    get aggregateLatency() {
+        return this.flatten().reduce((sum, t) => sum + (t.metadata?.latency_ms ?? 0), 0);
+    }
+}
+//# sourceMappingURL=trace-tree.js.map

package/dist/trace-tree.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,40 @@
+import type { Step, Trace } from "./proto/types.js";
+export declare class TraceBuilder {
+    private traceId;
+    private agentId;
+    private input;
+    private readonly steps;
+    private output;
+    private metadata;
+    private parentTraceId;
+    constructor(agentId?: string);
+    setTraceId(traceId: string): this;
+    setInput(input: Record<string, unknown>): this;
+    addLlmCall(name: string, options?: {
+        args?: Record<string, unknown>;
+        result?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): this;
+    addToolCall(name: string, options?: {
+        args?: Record<string, unknown>;
+        result?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): this;
+    addRetrieval(name: string, options?: {
+        args?: Record<string, unknown>;
+        result?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): this;
+    addStep(step: Step): this;
+    setOutput(output: Record<string, unknown>): this;
+    setMetadata(metadata: {
+        total_tokens?: number;
+        cost_usd?: number;
+        latency_ms?: number;
+        model?: string;
+        timestamp?: string;
+    }): this;
+    setParentTraceId(parentId: string): this;
+    build(): Trace;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAiB,MAAM,kBAAkB,CAAC;AAOnE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,aAAa,CAAqB;gBAE9B,OAAO,CAAC,EAAE,MAAM;IAK5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK9C,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,IAAI;IAWP,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,IAAI;IAWP,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,IAAI;IAWP,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAKzB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD,WAAW,CAAC,QAAQ,EAAE;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAKR,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxC,KAAK,IAAI,KAAK;CAef"}

package/dist/trace.js

@@ -0,0 +1,85 @@
+import { randomUUID } from "node:crypto";
+import { STEP_LLM_CALL, STEP_TOOL_CALL, STEP_RETRIEVAL, } from "./proto/constants.js";
+export class TraceBuilder {
+    traceId;
+    agentId;
+    input;
+    steps = [];
+    output;
+    metadata;
+    parentTraceId;
+    constructor(agentId) {
+        this.traceId = `trc_${randomUUID().replace(/-/g, "").slice(0, 12)}`;
+        this.agentId = agentId;
+    }
+    setTraceId(traceId) {
+        this.traceId = traceId;
+        return this;
+    }
+    setInput(input) {
+        this.input = input;
+        return this;
+    }
+    addLlmCall(name, options) {
+        this.steps.push({
+            type: STEP_LLM_CALL,
+            name,
+            args: options?.args,
+            result: options?.result,
+            metadata: options?.metadata,
+        });
+        return this;
+    }
+    addToolCall(name, options) {
+        this.steps.push({
+            type: STEP_TOOL_CALL,
+            name,
+            args: options?.args,
+            result: options?.result,
+            metadata: options?.metadata,
+        });
+        return this;
+    }
+    addRetrieval(name, options) {
+        this.steps.push({
+            type: STEP_RETRIEVAL,
+            name,
+            args: options?.args,
+            result: options?.result,
+            metadata: options?.metadata,
+        });
+        return this;
+    }
+    addStep(step) {
+        this.steps.push(step);
+        return this;
+    }
+    setOutput(output) {
+        this.output = output;
+        return this;
+    }
+    setMetadata(metadata) {
+        this.metadata = metadata;
+        return this;
+    }
+    setParentTraceId(parentId) {
+        this.parentTraceId = parentId;
+        return this;
+    }
+    build() {
+        if (this.output === undefined) {
+            throw new Error("Trace output is required. Call setOutput() before build().");
+        }
+        return {
+            trace_id: this.traceId,
+            output: this.output,
+            schema_version: 1,
+            agent_id: this.agentId,
+            input: this.input,
+            steps: [...this.steps],
+            metadata: this.metadata,
+            parent_trace_id: this.parentTraceId,
+        };
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.3.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.3.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@attest-ai/core",
+  "version": "0.3.0",
+  "description": "Attest SDK for testing AI agents — protocol types, codec, trace builder, assertion DSL",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./proto": {
+      "import": "./dist/proto/index.js",
+      "types": "./dist/proto/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/attest-frameowrk/attest.git",
+    "directory": "sdks/typescript/packages/core"
+  },
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "testing",
+    "agent",
+    "llm",
+    "assertions",
+    "attest"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}