@agnt5/sdk 0.2.1

package/dist/eval.js

@@ -0,0 +1,452 @@
+/**
+ * Evaluation framework for scoring component outputs.
+ *
+ * Provides EvalResponse, BatchEval types, EvalContext, and LLMJudge
+ * for local and platform-based evaluation workflows.
+ */
+import { RunError } from './errors.js';
+// ─── EvalContext ─────────────────────────────────────────────────────
+/**
+ * Context passed to custom evaluation logic.
+ * Contains the input/output pair, optional expected value, and trace events.
+ */
+export class EvalContext {
+    constructor(opts) {
+        this.input = opts.input;
+        this.output = opts.output;
+        this.expected = opts.expected;
+        this.runId = opts.runId;
+        this.traceId = opts.traceId;
+        this.events = opts.events || [];
+    }
+    /** Get events filtered by type */
+    getEventsByType(eventType) {
+        return this.events.filter(e => e.eventType === eventType);
+    }
+    /** Get LM call events */
+    getLmCalls() {
+        return this.events.filter(e => e.eventType === 'lm.call.completed');
+    }
+    /** Get total tokens across all LM calls */
+    getTotalTokens() {
+        return this.getLmCalls().reduce((sum, e) => sum + (e.data.total_tokens || 0), 0);
+    }
+    /** Get events for a specific step */
+    getStepEvents(stepName) {
+        return this.events.filter(e => e.name === stepName);
+    }
+}
+// ─── EvalResponse ────────────────────────────────────────────────────
+/**
+ * Response from a single evaluation (client.eval()).
+ *
+ * Contains the component output, scorer results, and pass/fail status.
+ */
+export class EvalResponse {
+    constructor(raw) {
+        this.output = raw.output;
+        this.runId = raw.run_id || raw.runId || '';
+        this.traceId = raw.trace_id || raw.traceId;
+        this.durationMs = raw.duration_ms || raw.durationMs;
+        // Parse error
+        if (raw.error) {
+            if (typeof raw.error === 'string') {
+                this.error = { code: 'EVAL_FAILED', message: raw.error };
+            }
+            else {
+                this.error = {
+                    code: raw.error.code || 'EVAL_FAILED',
+                    message: raw.error.message || String(raw.error),
+                    details: raw.error.details,
+                };
+            }
+        }
+        // Parse scores
+        const rawScores = raw.scores || raw.scorer_results || [];
+        this.scores = rawScores.map((s) => ({
+            scorer: s.scorer || s.name || '',
+            score: s.score ?? 0,
+            passed: s.passed ?? (s.score >= 0.5),
+            explanation: s.explanation,
+            label: s.label,
+            metadata: s.metadata,
+        }));
+        // Overall pass: all scorers pass and no error
+        this.passed = raw.passed ?? (!this.error && this.scores.every(s => s.passed));
+    }
+    /** True if run completed without error (may have failing scores) */
+    get isSuccess() {
+        return !this.error;
+    }
+    /** True if there was an error */
+    get isError() {
+        return !!this.error;
+    }
+    /** Duration as milliseconds */
+    get elapsed() {
+        return this.durationMs;
+    }
+    /** Get score by scorer name */
+    getScore(scorerName) {
+        return this.scores.find(s => s.scorer === scorerName);
+    }
+    /** Throw if there was an error */
+    raiseForStatus() {
+        if (this.error) {
+            throw new RunError(this.error.message, this.runId, undefined, this.error.code);
+        }
+    }
+}
+/** Result of a single item in a batch evaluation */
+export class BatchEvalItemResult {
+    constructor(raw) {
+        this.index = raw.index ?? 0;
+        this.runId = raw.run_id || raw.runId || '';
+        this.output = raw.output;
+        this.durationMs = raw.duration_ms || raw.durationMs || 0;
+        this.itemId = raw.item_id || raw.itemId;
+        this.traceId = raw.trace_id || raw.traceId;
+        this.error = raw.error;
+        const rawScores = raw.scores || raw.scorer_results || [];
+        this.scores = rawScores.map((s) => ({
+            scorer: s.scorer || s.name || '',
+            score: s.score ?? 0,
+            passed: s.passed ?? (s.score >= 0.5),
+            explanation: s.explanation,
+            label: s.label,
+            metadata: s.metadata,
+        }));
+        this.passed = raw.passed ?? (!this.error && this.scores.every(s => s.passed));
+    }
+    get isSuccess() {
+        return !this.error;
+    }
+    get isFailed() {
+        return !!this.error;
+    }
+    /** Get score by scorer name */
+    getScore(scorerName) {
+        return this.scores.find(s => s.scorer === scorerName);
+    }
+    /** Create from an EvalResponse */
+    static fromEvalResponse(response, index, itemId) {
+        return new BatchEvalItemResult({
+            index,
+            run_id: response.runId,
+            output: response.output,
+            scores: response.scores,
+            passed: response.passed,
+            duration_ms: response.durationMs || 0,
+            item_id: itemId,
+            trace_id: response.traceId,
+            error: response.error?.message,
+        });
+    }
+    /** Create from an exception */
+    static fromException(error, index, itemId) {
+        return new BatchEvalItemResult({
+            index,
+            run_id: '',
+            output: undefined,
+            scores: [],
+            passed: false,
+            duration_ms: 0,
+            item_id: itemId,
+            error: error.message,
+        });
+    }
+}
+/**
+ * Result of a batch evaluation (client.batchEval()).
+ */
+export class BatchEvalResult {
+    constructor(opts) {
+        this.batchId = opts.batchId;
+        this.status = opts.status;
+        this.results = opts.results.sort((a, b) => a.index - b.index);
+        if (opts.stats) {
+            this.stats = opts.stats;
+        }
+        else {
+            // Compute stats from results
+            const completed = this.results.filter(r => r.isSuccess).length;
+            const failed = this.results.filter(r => r.isFailed).length;
+            const passed = this.results.filter(r => r.passed).length;
+            const totalDuration = this.results.reduce((s, r) => s + r.durationMs, 0);
+            this.stats = {
+                totalItems: this.results.length,
+                completedItems: completed,
+                failedItems: failed,
+                passedItems: passed,
+                avgDurationMs: this.results.length > 0 ? Math.round(totalDuration / this.results.length) : 0,
+                durationMs: opts.durationMs || totalDuration,
+            };
+        }
+    }
+    /** Pass rate: fraction of items where passed=true */
+    get passRate() {
+        if (this.results.length === 0)
+            return 0;
+        return this.stats.passedItems / this.stats.totalItems;
+    }
+    get isSuccess() {
+        return this.status === 'completed';
+    }
+    get isPartialFailure() {
+        return this.status === 'partial_failure';
+    }
+    /** All outputs sorted by index */
+    get outputs() {
+        return this.results.map(r => r.output);
+    }
+    /** Items that had errors */
+    failedItems() {
+        return this.results.filter(r => r.isFailed);
+    }
+    /** Items where passed=false (may not have errors) */
+    failingItems() {
+        return this.results.filter(r => !r.passed);
+    }
+    /** Items where passed=true */
+    passingItems() {
+        return this.results.filter(r => r.passed);
+    }
+}
+/**
+ * LLM-as-judge scorer specification.
+ *
+ * Used with client.eval() to evaluate outputs using an LLM.
+ *
+ * @example
+ * ```typescript
+ * const judge = new LLMJudge({
+ *   criteria: 'Is the response helpful and accurate?',
+ *   model: 'openai/gpt-4o-mini',
+ * });
+ *
+ * const result = await client.eval('my-function', { input: 'hello' }, {
+ *   scorers: [judge],
+ * });
+ * ```
+ */
+export class LLMJudge {
+    constructor(config) {
+        this.criteria = config.criteria;
+        this.model = config.model || 'openai/gpt-4o-mini';
+        this.includeInput = config.includeInput ?? false;
+        this.temperature = config.temperature ?? 0.0;
+    }
+    /** Convert to scorer spec for platform API */
+    toScorerSpec() {
+        const [provider, ...modelParts] = this.model.split('/');
+        return {
+            name: 'llm_judge',
+            config: {
+                criteria: this.criteria,
+                provider,
+                model: modelParts.join('/'),
+                include_input: this.includeInput,
+                temperature: this.temperature,
+            },
+        };
+    }
+}
+/**
+ * Assertion types for glassbox trace evaluation.
+ *
+ * Mirrors the Rust sdk-core TraceAssertion enum.
+ *
+ * @example
+ * ```typescript
+ * const assertions = [
+ *   TraceAssertion.maxTokens(1000),
+ *   TraceAssertion.maxLmCalls(5),
+ *   TraceAssertion.noErrors(),
+ * ];
+ * const result = traceScorer(trace, assertions);
+ * ```
+ */
+export class TraceAssertion {
+    constructor(_check) {
+        this._check = _check;
+    }
+    check(trace) {
+        return this._check(trace);
+    }
+    /** Assert total tokens used is at most `max`. */
+    static maxTokens(max) {
+        return new TraceAssertion((trace) => {
+            const total = trace
+                .filter(e => e.eventType === 'lm.call.completed')
+                .reduce((sum, e) => sum + (e.data.total_tokens ?? 0), 0);
+            return {
+                name: `max_tokens(${max})`,
+                passed: total <= max,
+                explanation: `Token usage: ${total} (max: ${max})`,
+            };
+        });
+    }
+    /** Assert number of LLM calls is at most `max`. */
+    static maxLmCalls(max) {
+        return new TraceAssertion((trace) => {
+            const count = trace.filter(e => e.eventType === 'lm.call.completed').length;
+            return {
+                name: `max_lm_calls(${max})`,
+                passed: count <= max,
+                explanation: `LLM calls: ${count} (max: ${max})`,
+            };
+        });
+    }
+    /** Assert events occur in the specified order (subsequence match). */
+    static eventSequence(events) {
+        return new TraceAssertion((trace) => {
+            const types = trace.map(e => e.eventType);
+            let j = 0;
+            for (const expected of events) {
+                while (j < types.length && types[j] !== expected)
+                    j++;
+                if (j >= types.length) {
+                    return {
+                        name: 'event_sequence',
+                        passed: false,
+                        explanation: `Missing event '${expected}' in sequence`,
+                    };
+                }
+                j++;
+            }
+            return { name: 'event_sequence', passed: true, explanation: 'All events found in expected order' };
+        });
+    }
+    /** Assert a specific step was memoized (retrieved from cache). */
+    static stepMemoized(stepName) {
+        return new TraceAssertion((trace) => {
+            const memoized = trace
+                .filter(e => e.eventType === 'workflow.step.completed' && e.name === stepName)
+                .some(e => e.data.is_memoized === true);
+            return {
+                name: `step_memoized(${stepName})`,
+                passed: memoized,
+                explanation: memoized
+                    ? `Step '${stepName}' was memoized`
+                    : `Step '${stepName}' was NOT memoized`,
+            };
+        });
+    }
+    /** Assert no error events occurred. */
+    static noErrors() {
+        const errorTypes = ['run.failed', 'workflow.step.failed', 'agent.failed', 'lm.call.failed', 'function.failed'];
+        return new TraceAssertion((trace) => {
+            const errors = trace.filter(e => errorTypes.includes(e.eventType));
+            return {
+                name: 'no_errors',
+                passed: errors.length === 0,
+                explanation: errors.length === 0 ? 'No error events found' : `Found ${errors.length} error event(s)`,
+            };
+        });
+    }
+    /** Assert total duration is under `maxMs` milliseconds. */
+    static durationUnder(maxMs) {
+        return new TraceAssertion((trace) => {
+            if (trace.length === 0) {
+                return { name: `duration_under(${maxMs}ms)`, passed: true, explanation: 'Duration: 0ms (no events)' };
+            }
+            const first = Math.min(...trace.map(e => e.timestampNs));
+            const last = Math.max(...trace.map(e => e.timestampNs));
+            const durationMs = Math.floor((last - first) / 1000000);
+            return {
+                name: `duration_under(${maxMs}ms)`,
+                passed: durationMs <= maxMs,
+                explanation: `Duration: ${durationMs}ms (max: ${maxMs}ms)`,
+            };
+        });
+    }
+    /** Assert a specific event type occurred at least `min` times. */
+    static eventCount(eventType, min) {
+        return new TraceAssertion((trace) => {
+            const count = trace.filter(e => e.eventType === eventType).length;
+            return {
+                name: `event_count(${eventType}, min=${min})`,
+                passed: count >= min,
+                explanation: `Event '${eventType}' occurred ${count} times (min: ${min})`,
+            };
+        });
+    }
+}
+/**
+ * Score a trace against multiple assertions.
+ *
+ * @returns TraceScorerResult with aggregate score (proportion of assertions passed)
+ *
+ * @example
+ * ```typescript
+ * const trace = await client.getEvents(runId);
+ * const result = traceScorer(trace.events, [
+ *   TraceAssertion.maxTokens(1000),
+ *   TraceAssertion.noErrors(),
+ * ]);
+ * console.log(`Score: ${result.score}, Passed: ${result.passed}`);
+ * ```
+ */
+export function traceScorer(trace, assertions) {
+    if (assertions.length === 0) {
+        return { score: 1.0, passed: true, label: 'pass', explanation: 'No assertions to check' };
+    }
+    const results = assertions.map(a => a.check(trace));
+    const passedCount = results.filter(r => r.passed).length;
+    const score = passedCount / results.length;
+    const allPassed = results.every(r => r.passed);
+    const failed = results.filter(r => !r.passed);
+    const explanation = failed.length === 0
+        ? 'All assertions passed'
+        : 'Failed assertions:\n' + failed.map(r => `- ${r.name}: ${r.explanation}`).join('\n');
+    return {
+        score,
+        passed: allPassed,
+        label: allPassed ? 'pass' : 'fail',
+        explanation,
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Normalize batch eval items to a consistent format.
+ *
+ * Accepts:
+ * 1. BatchEvalItem[] — already normalized
+ * 2. { input, expected }[] — dict format
+ * 3. Plain input dicts with separate expected list
+ */
+export function normalizeBatchEvalItems(items, expected) {
+    return items.map((item, i) => {
+        if ('input' in item && item.input !== undefined) {
+            return {
+                input: item.input,
+                expected: item.expected ?? expected?.[i],
+                itemId: item.itemId,
+                index: item.index ?? i,
+            };
+        }
+        // Plain input dict
+        return {
+            input: item,
+            expected: expected?.[i],
+            index: i,
+        };
+    });
+}
+/**
+ * Normalize scorer specs for the platform API.
+ *
+ * Accepts strings ("exact_match"), LLMJudge instances, or raw spec dicts.
+ */
+export function normalizeScorerSpecs(scorers) {
+    return scorers.map(s => {
+        if (typeof s === 'string') {
+            return { name: s };
+        }
+        if (s instanceof LLMJudge) {
+            return s.toScorerSpec();
+        }
+        return s;
+    });
+}
+//# sourceMappingURL=eval.js.map

package/dist/eval.js.map

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

package/dist/event-emitter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * EventEmitter routes events to the platform via NAPI Worker methods.
+ *
+ * Mirrors Python SDK's EventEmitter (events.py):
+ * - Checkpoint events → nativeWorker.emitCheckpoint() → EE gRPC WriteCheckpoint
+ * - SSE-only events → nativeWorker.queueEvent() → JournalEventQueue → flush task
+ */
+import type { BaseEvent } from './events.js';
+export declare class EventEmitter {
+    private runId;
+    private baseMetadata;
+    private sequence;
+    private nativeWorker;
+    constructor(runId: string, baseMetadata?: Record<string, string>);
+    /**
+     * Set the NAPI Worker reference for event emission.
+     * Must be called before emit() — events are silently dropped without a worker.
+     */
+    setWorker(nativeWorker: any): void;
+    /**
+     * Emit an event to the platform.
+     *
+     * Checkpoint events (lifecycle) are sent synchronously via gRPC WriteCheckpoint.
+     * SSE-only events (streaming) are queued for async batch flush.
+     */
+    emit(event: BaseEvent): Promise<void>;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../src/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA6B7C,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAa;gBAErB,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKpE;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI;IAIlC;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAiD5C"}

package/dist/event-emitter.js

@@ -0,0 +1,79 @@
+/**
+ * EventEmitter routes events to the platform via NAPI Worker methods.
+ *
+ * Mirrors Python SDK's EventEmitter (events.py):
+ * - Checkpoint events → nativeWorker.emitCheckpoint() → EE gRPC WriteCheckpoint
+ * - SSE-only events → nativeWorker.queueEvent() → JournalEventQueue → flush task
+ */
+import { isCheckpointEvent } from './events.js';
+/**
+ * Convert camelCase key to snake_case.
+ */
+function toSnakeCase(key) {
+    return key.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);
+}
+/**
+ * Serialize a BaseEvent to a full JSON string matching Python SDK's event.to_dict().
+ *
+ * Python sends ALL fields (event_type, correlation_id, name, etc.) in the event data.
+ * The EE/Studio UI needs these fields (especially correlation_id) to link events
+ * to the correct run lifecycle. Keys are converted from camelCase to snake_case.
+ */
+function serializeEvent(event) {
+    const payload = {};
+    for (const [key, value] of Object.entries(event)) {
+        // Convert BigInt to Number for JSON serialization
+        const serializedValue = typeof value === 'bigint' ? Number(value) : value;
+        payload[toSnakeCase(key)] = serializedValue;
+    }
+    return JSON.stringify(payload);
+}
+export class EventEmitter {
+    constructor(runId, baseMetadata = {}) {
+        this.sequence = 0;
+        this.nativeWorker = null;
+        this.runId = runId;
+        this.baseMetadata = baseMetadata;
+    }
+    /**
+     * Set the NAPI Worker reference for event emission.
+     * Must be called before emit() — events are silently dropped without a worker.
+     */
+    setWorker(nativeWorker) {
+        this.nativeWorker = nativeWorker;
+    }
+    /**
+     * Emit an event to the platform.
+     *
+     * Checkpoint events (lifecycle) are sent synchronously via gRPC WriteCheckpoint.
+     * SSE-only events (streaming) are queued for async batch flush.
+     */
+    async emit(event) {
+        if (!this.nativeWorker) {
+            return; // No worker — running locally or in tests
+        }
+        this.sequence++;
+        // Serialize full event with snake_case keys (matches Python SDK's event.to_dict())
+        const eventData = serializeEvent(event);
+        const metadata = { ...this.baseMetadata };
+        // Copy string metadata from event (skip non-string values)
+        for (const [k, v] of Object.entries(event.metadata || {})) {
+            if (typeof v === 'string') {
+                metadata[k] = v;
+            }
+        }
+        const timestampNs = Number(event.timestampNs);
+        if (isCheckpointEvent(event.eventType)) {
+            // Add correlation IDs to metadata (matches Python EventEmitter convention)
+            metadata['cid'] = event.correlationId;
+            metadata['pcid'] = event.parentCorrelationId || '';
+            await this.nativeWorker.emitCheckpoint(this.runId, event.eventType, eventData, this.sequence, metadata, timestampNs, 5000);
+        }
+        else {
+            // SSE-only — push to journal queue (non-blocking)
+            this.nativeWorker.queueEvent(this.runId, event.eventType, eventData, 0, // contentIndex
+            this.sequence, metadata, timestampNs, event.correlationId, event.parentCorrelationId || '');
+        }
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/event-emitter.js.map

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