@prismatic-io/lux 0.0.1

package/lib/core/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../../src/core/case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;oBAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO5D,eAAO,MAAM,eAAe;;;oBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;oBAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;iBASlB,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAaxD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;kBAiBvB,CAAC;AACL,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc,UAAW,QAAQ,KAAG,QAMhD,CAAC;AAmBF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/core/case.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { formatZodIssues } from "./zod.js";
+export const FixturesRefSchema = z.union([
+    z.string(),
+    z.object({ kind: z.literal("dir"), path: z.string() }).strict(),
+]);
+// A driver/answerer is referenced either by a bare registry name (no config)
+// or by an object pairing the name with its config. Keeping the name and its
+// config in one object (rather than a name + a sibling `*Config` key) removes
+// the question of which config goes with which plugin and lets a future typed
+// `defineEvalCase` discriminate the config type on `name`.
+export const DriverRefSchema = z.union([
+    z.string(),
+    z.object({ name: z.string(), config: z.unknown().optional() }).strict(),
+]);
+export const AnswererRefSchema = z.union([
+    z.string(),
+    z.object({ name: z.string(), config: z.unknown().optional() }).strict(),
+]);
+export const AssertionSchema = z
+    .object({
+    /** Stable identity used to compare this assertion across variants and repetitions. */
+    id: z.string().min(1).optional(),
+    type: z.string(),
+    name: z.string().optional(),
+    weight: z.number().positive().optional(),
+    threshold: z.number().min(0).max(1).optional(),
+})
+    .loose();
+const EvalCaseObjectSchema = z.object({
+    id: z.string().optional(),
+    prompt: z.string().min(1, "prompt is required"),
+    persona: z.string().min(1).optional(),
+    driver: DriverRefSchema.optional(),
+    answerer: AnswererRefSchema.optional(),
+    fixtures: FixturesRefSchema.optional(),
+    assertions: z.array(AssertionSchema).optional(),
+    meta: z.record(z.string(), z.unknown()).optional(),
+});
+export const EvalCaseSchema = EvalCaseObjectSchema
+    // strict so a stray `driverConfig`/`answererConfig` (the old shape) or a
+    // typo'd field fails loudly instead of being silently dropped.
+    .strict()
+    .superRefine((evalCase, ctx) => {
+    const seen = new Set();
+    for (const [index, assertion] of (evalCase.assertions ?? []).entries()) {
+        if (!assertion.id)
+            continue;
+        if (seen.has(assertion.id)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["assertions", index, "id"],
+                message: `duplicate assertion id '${assertion.id}'`,
+            });
+        }
+        seen.add(assertion.id);
+    }
+});
+export const defineEvalCase = (input) => {
+    const parsed = EvalCaseSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new Error(`Invalid eval case: ${formatZodIssues(parsed.error)}`);
+    }
+    return parsed.data;
+};
+const PersistedFixturesRefSchema = z.union([
+    z.string(),
+    z.looseObject({ kind: z.literal("dir"), path: z.string() }),
+]);
+const PersistedDriverRefSchema = z.union([
+    z.string(),
+    z.looseObject({ name: z.string(), config: z.unknown().optional() }),
+]);
+const PersistedAnswererRefSchema = z.union([
+    z.string(),
+    z.looseObject({ name: z.string(), config: z.unknown().optional() }),
+]);
+// The `case.json` frozen into a run dir. Reading run history stays permissive
+// where authoring is strict: every field optional, unknown keys kept —
+// serialization drops what it can't represent (predicate functions), and a
+// frozen case from any other lux version must still load.
+export const PersistedCaseSchema = EvalCaseObjectSchema.partial()
+    .extend({
+    casePath: z.exactOptional(z.string()),
+    driver: PersistedDriverRefSchema.optional(),
+    answerer: PersistedAnswererRefSchema.optional(),
+    fixtures: PersistedFixturesRefSchema.optional(),
+})
+    .loose();
+//# sourceMappingURL=case.js.map

package/lib/core/case.js.map

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

package/lib/core/conversation-turn.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { Answer, Interrupt } from "./events.js";
+export declare const CONVERSATION_TURN_REQUEST: "lux.conversation-turn.v1";
+export declare const ConversationTurnRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"lux.conversation-turn.v1">;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type ConversationTurnRequest = z.infer<typeof ConversationTurnRequestSchema>;
+export declare const ConversationTurnResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"stop">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"reply">;
+    text: z.ZodString;
+}, z.core.$strict>], "action">;
+export type ConversationTurnResponse = z.infer<typeof ConversationTurnResponseSchema>;
+export declare const conversationTurnInterrupt: (id: string, message: string, context?: unknown) => Interrupt;
+export declare const isConversationTurnInterrupt: (interrupt: Interrupt) => interrupt is Extract<Interrupt, {
+    kind: "custom";
+}> & {
+    payload: ConversationTurnRequest;
+};
+export declare const conversationTurnResponse: (answer: Answer) => ConversationTurnResponse | null;
+//# sourceMappingURL=conversation-turn.d.ts.map

package/lib/core/conversation-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-turn.d.ts","sourceRoot":"","sources":["../../src/core/conversation-turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,yBAAyB,EAAG,0BAAmC,CAAC;AAE7E,eAAO,MAAM,6BAA6B;;;kBAM/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,8BAA8B;;;;;8BAQzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,yBAAyB,OAChC,MAAM,WACD,MAAM,YACL,OAAO,KAChB,SAKD,CAAC;AAEH,eAAO,MAAM,2BAA2B,cAC3B,SAAS,KACnB,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG;IACvD,OAAO,EAAE,uBAAuB,CAAC;CAEgE,CAAC;AAEpG,eAAO,MAAM,wBAAwB,WAAY,MAAM,KAAG,wBAAwB,GAAG,IAGpF,CAAC"}

package/lib/core/conversation-turn.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export const CONVERSATION_TURN_REQUEST = "lux.conversation-turn.v1";
+export const ConversationTurnRequestSchema = z
+    .object({
+    type: z.literal(CONVERSATION_TURN_REQUEST),
+    /** The agent's user-visible message at the end of its current turn. */
+    message: z.string(),
+})
+    .strict();
+export const ConversationTurnResponseSchema = z.discriminatedUnion("action", [
+    z.object({ action: z.literal("stop") }).strict(),
+    z
+        .object({
+        action: z.literal("reply"),
+        text: z.string().trim().min(1),
+    })
+        .strict(),
+]);
+export const conversationTurnInterrupt = (id, message, context) => ({
+    kind: "custom",
+    id,
+    payload: { type: CONVERSATION_TURN_REQUEST, message },
+    ...(context === undefined ? {} : { context }),
+});
+export const isConversationTurnInterrupt = (interrupt) => interrupt.kind === "custom" && ConversationTurnRequestSchema.safeParse(interrupt.payload).success;
+export const conversationTurnResponse = (answer) => {
+    if (answer.kind !== "custom")
+        return null;
+    return ConversationTurnResponseSchema.safeParse(answer.payload).data ?? null;
+};
+//# sourceMappingURL=conversation-turn.js.map

package/lib/core/conversation-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-turn.js","sourceRoot":"","sources":["../../src/core/conversation-turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,yBAAyB,GAAG,0BAAmC,CAAC;AAE7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;IAC1C,uEAAuE;IACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC3E,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAChD,CAAC;SACE,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,EAAU,EACV,OAAe,EACf,OAAiB,EACN,EAAE,CAAC,CAAC;IACf,IAAI,EAAE,QAAQ;IACd,EAAE;IACF,OAAO,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE;IACrD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,SAAoB,EAGpB,EAAE,CACF,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,6BAA6B,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;AAEpG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAmC,EAAE;IAC1F,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,8BAA8B,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;AAC/E,CAAC,CAAC"}

package/lib/core/driver.d.ts

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import type { EventHandler } from "./emitter.js";
+import type { Answer, Done, ErrorEvent, Interrupt, Progress, ReadyState } from "./events.js";
+export declare const ArtifactSchema: z.ZodObject<{
+    path: z.ZodString;
+    root: z.ZodExactOptional<z.ZodString>;
+    contentType: z.ZodExactOptional<z.ZodString>;
+    size: z.ZodExactOptional<z.ZodNumber>;
+    meta: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type Artifact = z.infer<typeof ArtifactSchema>;
+export declare const ResolvedFixturesSchema: z.ZodObject<{
+    rootDir: z.ZodString;
+    meta: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ResolvedFixtures = z.infer<typeof ResolvedFixturesSchema>;
+export type StartContext = {
+    /** Stable selected case id, available to drivers that multiplex scenarios. */
+    caseId?: string;
+    prompt: string;
+    fixtures?: ResolvedFixtures | undefined;
+    /** Root containing persisted runs. Drivers may use it as an isolation boundary. */
+    runsRoot?: string | undefined;
+    runDir: string;
+    artifactsDir: string;
+    abortSignal: AbortSignal;
+};
+export type DriverEventMap = {
+    interrupt: Interrupt;
+    progress: Progress;
+    done: Done;
+    error: ErrorEvent;
+};
+/**
+ * Handlers may be async, and a driver **must await** every handler before
+ * emitting its next event: the orchestrator's `interrupt` handler awaits the
+ * answerer and calls `respond` before the agent may continue, so dispatching
+ * without awaiting breaks that interrupt/respond serialization. Backing the
+ * event surface with `TypedEmitter` provides this ordering.
+ */
+export interface AgentDriver {
+    start(ctx: StartContext): Promise<ReadyState>;
+    on<K extends keyof DriverEventMap>(event: K, handler: EventHandler<DriverEventMap[K]>): void;
+    off<K extends keyof DriverEventMap>(event: K, handler: EventHandler<DriverEventMap[K]>): void;
+    respond(answer: Answer): Promise<void>;
+    /**
+     * Stop agent work after a terminal protocol event but before evidence is
+     * collected. Process-backed drivers should implement this so a child cannot
+     * mutate artifacts while assertions are reading them.
+     */
+    quiesce?(): Promise<void>;
+    /**
+     * Return a stable evidence snapshot. Drivers without `quiesce` are
+     * responsible for stopping background writers before this promise resolves.
+     */
+    collect(): Promise<Artifact[]>;
+    close(): Promise<void>;
+}
+export type DriverPlugin<Cfg = unknown> = {
+    name: string;
+    configSchema?: z.ZodTypeAny;
+    create: (config: Cfg) => AgentDriver | Promise<AgentDriver>;
+};
+//# sourceMappingURL=driver.d.ts.map

package/lib/core/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7F,eAAO,MAAM,cAAc;;;;;;iBAWzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACxC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7F,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,CAAC,GAAG,GAAG,OAAO,IAAI;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7D,CAAC"}

package/lib/core/driver.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const ArtifactSchema = z.object({
+    path: z.string(),
+    /**
+     * Absolute dir `path` is relative to, when it is not the run's default
+     * `<runDir>/artifacts` (e.g. a driver configured to run in a checkout).
+     * Consumers resolve `path` against this before falling back to the default.
+     */
+    root: z.exactOptional(z.string()),
+    contentType: z.exactOptional(z.string()),
+    size: z.exactOptional(z.number()),
+    meta: z.exactOptional(z.record(z.string(), z.unknown())),
+});
+export const ResolvedFixturesSchema = z.object({
+    rootDir: z.string(),
+    meta: z.exactOptional(z.record(z.string(), z.unknown())),
+});
+//# sourceMappingURL=driver.js.map

package/lib/core/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC"}

package/lib/core/emitter.d.ts

@@ -0,0 +1,20 @@
+export type EventHandler<E> = (event: E) => void | Promise<void>;
+/**
+ * Minimal typed event emitter (Node's EventEmitter is untyped on the
+ * listener side).
+ *
+ * Handlers are awaited serially within a single emit — the orchestrator's
+ * interrupt handler must finish before the driver continues — so keep
+ * handlers cheap. Dispatch is fail-fast: a throwing handler propagates out
+ * of `emit` and later handlers are skipped; callers treat a broken handler
+ * as a broken run. Handlers live in a Set: double registration is a no-op,
+ * and changes mid-emit affect the remainder of that dispatch.
+ */
+export declare class TypedEmitter<EventMap extends Record<string, unknown>> {
+    private readonly handlers;
+    on<K extends keyof EventMap>(event: K, handler: EventHandler<EventMap[K]>): void;
+    off<K extends keyof EventMap>(event: K, handler: EventHandler<EventMap[K]>): void;
+    emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): Promise<void>;
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/lib/core/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/core/emitter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAElF,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAI/E;IAED,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAEhF;IAEK,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF;IAED,kBAAkB,IAAI,IAAI,CAEzB;CACF"}

package/lib/core/emitter.js

@@ -0,0 +1,34 @@
+/**
+ * Minimal typed event emitter (Node's EventEmitter is untyped on the
+ * listener side).
+ *
+ * Handlers are awaited serially within a single emit — the orchestrator's
+ * interrupt handler must finish before the driver continues — so keep
+ * handlers cheap. Dispatch is fail-fast: a throwing handler propagates out
+ * of `emit` and later handlers are skipped; callers treat a broken handler
+ * as a broken run. Handlers live in a Set: double registration is a no-op,
+ * and changes mid-emit affect the remainder of that dispatch.
+ */
+export class TypedEmitter {
+    handlers = new Map();
+    on(event, handler) {
+        const set = this.handlers.get(event) ?? new Set();
+        this.handlers.set(event, set);
+        set.add(handler);
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    async emit(event, payload) {
+        const set = this.handlers.get(event);
+        if (!set)
+            return;
+        for (const handler of set) {
+            await handler(payload);
+        }
+    }
+    removeAllListeners() {
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/lib/core/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/core/emitter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAA8C,CAAC;IAElF,EAAE,CAA2B,KAAQ,EAAE,OAAkC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAyB,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,GAAG,CAAC,GAAG,CAAC,OAAgC,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAA2B,KAAQ,EAAE,OAAkC;QACxE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAgC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAI,CAA2B,KAAQ,EAAE,OAAoB;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;YAC1B,MAAO,OAAqC,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/lib/core/events.d.ts

@@ -0,0 +1,202 @@
+import { z } from "zod";
+export declare const InterruptKindSchema: z.ZodEnum<{
+    approve: "approve";
+    ask: "ask";
+    custom: "custom";
+}>;
+export type InterruptKind = z.infer<typeof InterruptKindSchema>;
+export declare const AskInterruptSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    question: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const ApproveInterruptSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    request: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const CustomInterruptSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const InterruptSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    question: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    request: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+    context: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>], "kind">;
+export type Interrupt = z.infer<typeof InterruptSchema>;
+export declare const AskAnswerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const ApproveAnswerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    approved: z.ZodBoolean;
+    reason: z.ZodExactOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CustomAnswerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const AnswerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    approved: z.ZodBoolean;
+    reason: z.ZodExactOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strip>], "kind">;
+export type Answer = z.infer<typeof AnswerSchema>;
+export declare const ProgressSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    payload: z.ZodUnknown;
+    ts: z.ZodNumber;
+}, z.core.$strip>;
+export type Progress = z.infer<typeof ProgressSchema>;
+export declare const DoneSchema: z.ZodObject<{
+    exitReason: z.ZodLiteral<"done">;
+    summary: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type Done = z.infer<typeof DoneSchema>;
+export declare const ErrorEventReasonSchema: z.ZodEnum<{
+    error: "error";
+    "idle-timeout": "idle-timeout";
+    "max-interactions": "max-interactions";
+}>;
+export type ErrorEventReason = z.infer<typeof ErrorEventReasonSchema>;
+export declare const ErrorEventSchema: z.ZodObject<{
+    exitReason: z.ZodEnum<{
+        error: "error";
+        "idle-timeout": "idle-timeout";
+        "max-interactions": "max-interactions";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type ErrorEvent = z.infer<typeof ErrorEventSchema>;
+export declare const LifecycleStageSchema: z.ZodEnum<{
+    close: "close";
+    "collect-end": "collect-end";
+    "collect-start": "collect-start";
+    "grade-end": "grade-end";
+    "grade-start": "grade-start";
+    load: "load";
+    "prepare-answerer": "prepare-answerer";
+    "run-loop": "run-loop";
+    "start-driver": "start-driver";
+}>;
+export type LifecycleStage = z.infer<typeof LifecycleStageSchema>;
+export declare const ReadyStateSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    agentVersion: z.ZodExactOptional<z.ZodString>;
+    model: z.ZodExactOptional<z.ZodString>;
+    detail: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ReadyState = z.infer<typeof ReadyStateSchema>;
+export declare const RunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    agentId: z.ZodString;
+    agentVersion: z.ZodExactOptional<z.ZodString>;
+    model: z.ZodExactOptional<z.ZodString>;
+    detail: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"ready">;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    question: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"interrupt">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    request: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"interrupt">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+    context: z.ZodOptional<z.ZodUnknown>;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"interrupt">;
+}, z.core.$strip>], "kind">, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ask">;
+    id: z.ZodString;
+    text: z.ZodString;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"responded">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"approve">;
+    id: z.ZodString;
+    approved: z.ZodBoolean;
+    reason: z.ZodExactOptional<z.ZodString>;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"responded">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    id: z.ZodString;
+    payload: z.ZodUnknown;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"responded">;
+}, z.core.$strip>], "kind">, z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    payload: z.ZodUnknown;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"progress">;
+}, z.core.$strip>, z.ZodObject<{
+    exitReason: z.ZodLiteral<"done">;
+    summary: z.ZodOptional<z.ZodUnknown>;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"done">;
+}, z.core.$strip>, z.ZodObject<{
+    exitReason: z.ZodEnum<{
+        error: "error";
+        "idle-timeout": "idle-timeout";
+        "max-interactions": "max-interactions";
+    }>;
+    reason: z.ZodString;
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"error">;
+}, z.core.$strip>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"lifecycle">;
+    stage: z.ZodEnum<{
+        close: "close";
+        "collect-end": "collect-end";
+        "collect-start": "collect-start";
+        "grade-end": "grade-end";
+        "grade-start": "grade-start";
+        load: "load";
+        "prepare-answerer": "prepare-answerer";
+        "run-loop": "run-loop";
+        "start-driver": "start-driver";
+    }>;
+}, z.core.$strip>], "type">;
+export type RunEvent = z.infer<typeof RunEventSchema>;
+//# sourceMappingURL=events.d.ts.map

package/lib/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;EAAuC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;2BAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;2BAIvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,UAAU;;;iBAQrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,sBAAsB;;;;EAAwD,CAAC;AAC5F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,gBAAgB;;;;;;;iBAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;EAU/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAiB1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAUzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/core/events.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+export const InterruptKindSchema = z.enum(["ask", "approve", "custom"]);
+export const AskInterruptSchema = z.object({
+    kind: z.literal("ask"),
+    id: z.string(),
+    question: z.string(),
+    context: z.unknown().optional(),
+});
+export const ApproveInterruptSchema = z.object({
+    kind: z.literal("approve"),
+    id: z.string(),
+    request: z.string(),
+    context: z.unknown().optional(),
+});
+export const CustomInterruptSchema = z.object({
+    kind: z.literal("custom"),
+    id: z.string(),
+    payload: z.unknown(),
+    context: z.unknown().optional(),
+});
+export const InterruptSchema = z.discriminatedUnion("kind", [
+    AskInterruptSchema,
+    ApproveInterruptSchema,
+    CustomInterruptSchema,
+]);
+export const AskAnswerSchema = z.object({
+    kind: z.literal("ask"),
+    id: z.string(),
+    text: z.string(),
+});
+export const ApproveAnswerSchema = z.object({
+    kind: z.literal("approve"),
+    id: z.string(),
+    approved: z.boolean(),
+    reason: z.exactOptional(z.string()),
+});
+export const CustomAnswerSchema = z.object({
+    kind: z.literal("custom"),
+    id: z.string(),
+    payload: z.unknown(),
+});
+export const AnswerSchema = z.discriminatedUnion("kind", [
+    AskAnswerSchema,
+    ApproveAnswerSchema,
+    CustomAnswerSchema,
+]);
+export const ProgressSchema = z.object({
+    id: z.string(),
+    kind: z.string(),
+    payload: z.unknown(),
+    ts: z.number(),
+});
+export const DoneSchema = z.object({
+    exitReason: z.literal("done"),
+    /**
+     * Driver-defined summary. The orchestrator recognizes `usage`, `cost`,
+     * `modelCalls`, and `unpricedModelCalls` when present while preserving room
+     * for domain-specific measurements.
+     */
+    summary: z.unknown().optional(),
+});
+export const ErrorEventReasonSchema = z.enum(["error", "idle-timeout", "max-interactions"]);
+export const ErrorEventSchema = z.object({
+    exitReason: ErrorEventReasonSchema,
+    reason: z.string(),
+});
+export const LifecycleStageSchema = z.enum([
+    "load",
+    "prepare-answerer",
+    "start-driver",
+    "run-loop",
+    "collect-start",
+    "collect-end",
+    "grade-start",
+    "grade-end",
+    "close",
+]);
+export const ReadyStateSchema = z.object({
+    agentId: z.string(),
+    agentVersion: z.exactOptional(z.string()),
+    model: z.exactOptional(z.string()),
+    detail: z.exactOptional(z.record(z.string(), z.unknown())),
+});
+const stamped = { ts: z.number() };
+// Nested because a flat union on `type` would collide across the arms sharing it.
+const InterruptEventSchema = z.discriminatedUnion("kind", [
+    AskInterruptSchema.extend({ type: z.literal("interrupt"), ...stamped }),
+    ApproveInterruptSchema.extend({ type: z.literal("interrupt"), ...stamped }),
+    CustomInterruptSchema.extend({ type: z.literal("interrupt"), ...stamped }),
+]);
+const RespondedEventSchema = z.discriminatedUnion("kind", [
+    AskAnswerSchema.extend({ type: z.literal("responded"), ...stamped }),
+    ApproveAnswerSchema.extend({ type: z.literal("responded"), ...stamped }),
+    CustomAnswerSchema.extend({ type: z.literal("responded"), ...stamped }),
+]);
+export const RunEventSchema = z.discriminatedUnion("type", [
+    // `ready` is the one un-stamped arm: the orchestrator persists the driver's
+    // ReadyState verbatim, and the adjacent `lifecycle` events carry its timing.
+    ReadyStateSchema.extend({ type: z.literal("ready") }),
+    InterruptEventSchema,
+    RespondedEventSchema,
+    ProgressSchema.extend({ type: z.literal("progress") }),
+    DoneSchema.extend({ type: z.literal("done"), ...stamped }),
+    ErrorEventSchema.extend({ type: z.literal("error"), ...stamped }),
+    z.object({ type: z.literal("lifecycle"), stage: LifecycleStageSchema, ...stamped }),
+]);
+//# sourceMappingURL=events.js.map

package/lib/core/events.js.map

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