stitchkit 0.85.1 → 0.86.0

package/dist/agent-runtime/sandbox.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import type { AgentRuntimeStore } from './store.js';
+export declare const AgentSandboxRestrictionSchema: z.ZodEnum<{
+    "network-denied": "network-denied";
+    "process-contained": "process-contained";
+    "secrets-hidden": "secrets-hidden";
+    "write-contained": "write-contained";
+}>;
+export declare const AgentSandboxGradeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    grade: z.ZodLiteral<"full">;
+    restrictions: z.ZodArray<z.ZodEnum<{
+        "network-denied": "network-denied";
+        "process-contained": "process-contained";
+        "secrets-hidden": "secrets-hidden";
+        "write-contained": "write-contained";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    grade: z.ZodLiteral<"partial">;
+    restrictions: z.ZodArray<z.ZodEnum<{
+        "network-denied": "network-denied";
+        "process-contained": "process-contained";
+        "secrets-hidden": "secrets-hidden";
+        "write-contained": "write-contained";
+    }>>;
+    gaps: z.ZodArray<z.ZodEnum<{
+        "network-denied": "network-denied";
+        "process-contained": "process-contained";
+        "secrets-hidden": "secrets-hidden";
+        "write-contained": "write-contained";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    grade: z.ZodLiteral<"unavailable">;
+    reason: z.ZodString;
+}, z.core.$strict>], "grade">;
+export type AgentSandboxRestriction = z.infer<typeof AgentSandboxRestrictionSchema>;
+export type AgentSandboxGrade = z.infer<typeof AgentSandboxGradeSchema>;
+export interface AgentProcessSandbox {
+    probe(): AgentSandboxGrade | Promise<AgentSandboxGrade>;
+    prepare(input: {
+        executable: string;
+        args: readonly string[];
+        cwd: string;
+        environment: Readonly<Record<string, string>>;
+    }): {
+        executable: string;
+        args: readonly string[];
+        environment?: Readonly<Record<string, string>>;
+    } | Promise<{
+        executable: string;
+        args: readonly string[];
+        environment?: Readonly<Record<string, string>>;
+    }>;
+}
+/** Probe once per process; invalidate only after the sandbox adapter itself fails. */
+export declare function probeAgentProcessSandbox(sandbox: AgentProcessSandbox, options?: {
+    refresh?: boolean;
+}): Promise<AgentSandboxGrade>;
+export declare function missingSandboxRestrictions(grade: AgentSandboxGrade, required: readonly AgentSandboxRestriction[]): readonly AgentSandboxRestriction[];
+/** Persist the process-wide probe result when a conversation first uses the sandbox. */
+export declare function recordAgentSandboxProbe(input: {
+    store: AgentRuntimeStore;
+    conversationId: string;
+    sandbox: AgentProcessSandbox;
+    required: readonly AgentSandboxRestriction[];
+}): Promise<AgentSandboxGrade>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/agent-runtime/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,6BAA6B;;;;;EAKxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;6BAYlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxD,OAAO,CAAC,KAAK,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAC/C,GACG;QACE,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAChD,GACD,OAAO,CAAC;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAChD,CAAC,CAAC;CACR;AAID,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,SAAS,uBAAuB,EAAE,CAIpC;AAED,wFAAwF;AACxF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,KAAK,EAAE,iBAAiB,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa7B"}

package/dist/agent-runtime/schedule-tools.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { AgentScheduleService } from './schedules.js';
+export declare function createAgentScheduleTools(service: AgentScheduleService): readonly [import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    conversationId: z.ZodString;
+    input: z.ZodJSONSchema;
+    afterMs: z.ZodInt;
+}, z.core.$strict>, z.ZodObject<{
+    scheduleId: z.ZodString;
+    nextAt: z.ZodString;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    conversationId: z.ZodString;
+    input: z.ZodJSONSchema;
+    at: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    scheduleId: z.ZodString;
+    nextAt: z.ZodString;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    conversationId: z.ZodString;
+    input: z.ZodJSONSchema;
+    everyMs: z.ZodInt;
+    timeZone: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    scheduleId: z.ZodString;
+    nextAt: z.ZodString;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    conversationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    schedules: z.ZodArray<z.ZodJSONSchema>;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    conversationId: z.ZodString;
+    scheduleId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    cancelled: z.ZodBoolean;
+}, z.core.$strict>>];
+//# sourceMappingURL=schedule-tools.d.ts.map

package/dist/agent-runtime/schedule-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tools.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/schedule-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOxD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA0ErE"}

package/dist/agent-runtime/schedules.d.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import type { SqliteAgentRuntimeStore } from './sqlite.js';
+export declare const AgentScheduleSchema: z.ZodObject<{
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    kind: z.ZodEnum<{
+        after: "after";
+        at: "at";
+        every: "every";
+    }>;
+    nextAt: z.ZodISODateTime;
+    intervalMs: z.ZodOptional<z.ZodInt>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    input: z.ZodJSONSchema;
+    state: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        scheduled: "scheduled";
+    }>;
+    occurrence: z.ZodInt;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type AgentSchedule = z.infer<typeof AgentScheduleSchema>;
+export interface AgentScheduleService {
+    scheduleInput(request: {
+        conversationId: string;
+        input: z.infer<typeof z.json>;
+        at?: string;
+        afterMs?: number;
+        everyMs?: number;
+        timeZone?: string;
+    }): Promise<AgentSchedule>;
+    cancelSchedule(conversationId: string, id: string): Promise<boolean>;
+    listSchedules(conversationId: string): readonly AgentSchedule[];
+    tick(): Promise<void>;
+    start(): void;
+    close(): void;
+}
+export declare function createAgentScheduleService(input: {
+    sqlite: SqliteAgentRuntimeStore;
+    dispatch(request: {
+        conversationId: string;
+        idempotencyKey: string;
+        input: z.infer<typeof z.json>;
+        schedule: {
+            id: string;
+            occurrence: number;
+            lateByMs: number;
+        };
+    }): void | Promise<void>;
+    now?: () => Date;
+    setTimer?: (callback: () => void, delayMs: number) => ReturnType<typeof setTimeout>;
+    clearTimer?: (timer: ReturnType<typeof setTimeout>) => void;
+    /**
+     * Where a tick's own failure goes — a claim on a closing store, an event on
+     * a purged conversation. Not a dispatch failure: that is recorded durably as
+     * `schedule/failed`. Without a handler the failure is printed, because a
+     * timer-driven loop has no caller to reject to and silence would be worse.
+     */
+    onError?: (error: unknown) => void;
+}): AgentScheduleService;
+//# sourceMappingURL=schedules.d.ts.map

package/dist/agent-runtime/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/schedules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;kBAcrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,OAAO,EAAE;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3B,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAAC;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf;AAiCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,QAAQ,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KAChE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACpF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,GAAG,oBAAoB,CAgTvB"}

package/dist/agent-runtime/schemas.d.ts

@@ -319,10 +319,13 @@ export declare const AgentTerminalReasonSchema: z.ZodEnum<{
     cancelled: "cancelled";
     context_overflow: "context_overflow";
     interrupted: "interrupted";
+    output_rejected: "output_rejected";
     policy_stop: "policy_stop";
     provider_failure: "provider_failure";
     provider_stop: "provider_stop";
+    runtime_failure: "runtime_failure";
     shutdown: "shutdown";
+    storage_conflict: "storage_conflict";
     success: "success";
     superseded: "superseded";
     timeout: "timeout";
@@ -504,10 +507,13 @@ export declare const AgentRunSchema: z.ZodObject<{
         cancelled: "cancelled";
         context_overflow: "context_overflow";
         interrupted: "interrupted";
+        output_rejected: "output_rejected";
         policy_stop: "policy_stop";
         provider_failure: "provider_failure";
         provider_stop: "provider_stop";
+        runtime_failure: "runtime_failure";
         shutdown: "shutdown";
+        storage_conflict: "storage_conflict";
         success: "success";
         superseded: "superseded";
         timeout: "timeout";
@@ -717,10 +723,13 @@ export declare const AgentSnapshotSchema: z.ZodObject<{
             cancelled: "cancelled";
             context_overflow: "context_overflow";
             interrupted: "interrupted";
+            output_rejected: "output_rejected";
             policy_stop: "policy_stop";
             provider_failure: "provider_failure";
             provider_stop: "provider_stop";
+            runtime_failure: "runtime_failure";
             shutdown: "shutdown";
+            storage_conflict: "storage_conflict";
             success: "success";
             superseded: "superseded";
             timeout: "timeout";

package/dist/agent-runtime/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,aAAoB,CAAC;AACrD,eAAO,MAAM,wBAAwB,UAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,kBAAmC,CAAC;AACrE,eAAO,MAAM,qBAAqB,2CAAiC,CAAC;AAEpE,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;iBAM7C,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;iBAK9C,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;iBAGjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAWjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB;;;;;;EAMjC,CAAC;AACH,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,+BAA+B;;;;;;;;iBAQ1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mBAAmB;;;;;;;;;;EAU9B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;EAA6B,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,2BAA2B;;;EAA0C,CAAC;AACnF,eAAO,MAAM,4BAA4B;;;;;;EAMvC,CAAC;AAcH,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAoCnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;EA0CpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAiBrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;iBAQhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAwD1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+CzB,CAAC;AAWH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/agent-runtime/spill.d.ts

@@ -0,0 +1,24 @@
+import type { AgentCodingArtifactStore } from './coding-tool-contract.js';
+import type { SqliteAgentRuntimeStore } from './sqlite.js';
+export declare function createSqliteAgentSpillStore(input: {
+    sqlite: SqliteAgentRuntimeStore;
+    conversationId: string;
+    runId?: string;
+    toolCallId?: string;
+    retentionMs?: number;
+    now?: () => Date;
+}): AgentCodingArtifactStore & {
+    search(request: {
+        reference: string;
+        query: string;
+        maxMatches: number;
+    }): readonly {
+        line: number;
+        text: string;
+    }[];
+    cleanup(): Promise<{
+        deleted: number;
+        bytes: number;
+    }>;
+};
+//# sourceMappingURL=spill.d.ts.map

package/dist/agent-runtime/spill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spill.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/spill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAkBxD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,uBAAuB,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,wBAAwB,GAAG;IAC7B,MAAM,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;QAClF,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,CAqHA"}

package/dist/agent-runtime/sqlite-purge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-purge.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sqlite-purge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AASlE,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAoBhF;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,GACvB,4BAA4B,CAAC,cAAc,CAAC,GAAG,SAAS,CA2B1D"}
+{"version":3,"file":"sqlite-purge.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sqlite-purge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAalE,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAoBhF;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,GACvB,4BAA4B,CAAC,cAAc,CAAC,GAAG,SAAS,CAgC1D"}

package/dist/agent-runtime/sqlite.d.ts

@@ -1,6 +1,7 @@
 import type { SqliteDatabase } from '../internal/sqlite.js';
 import { type AgentConversationReader } from './conversations.js';
 import { createAgentRuntimeStore } from './store-driver.js';
+import { type AgentStoreEventEnvelope, type AppendAgentStoreEvent } from './store-events.js';
 export type { SqliteDatabase, SqliteStatement, SqliteValue } from '../internal/sqlite.js';
 export interface SqliteAgentRuntimeStoreConfig {
     database: SqliteDatabase;
@@ -10,9 +11,34 @@ export interface SqliteAgentRuntimeStoreConfig {
 export interface SqliteAgentRuntimeStore {
     store: ReturnType<typeof createAgentRuntimeStore<SqliteDatabase>>;
     conversations: AgentConversationReader;
+    /**
+     * The connection the store owns — for the SQLite-bound companions
+     * (`createSqliteAgentProjectionStore`, `createSqliteAgentEventSearch`,
+     * `createSqliteAgentSpillStore`, `createSqliteAgentChildManager`,
+     * `createAgentScheduleService`), which share it rather than open a second.
+     * Without this a consumer following the guide had to copy the adapter out
+     * of the package source to reach any of them.
+     */
+    database: SqliteDatabase;
+    /**
+     * One write transaction shared with the store's own serialization.
+     *
+     * The companions that keep rows beside the ledger — spills, schedules,
+     * children, projections — write their row and append their event here, in
+     * the same transaction the store's operations queue behind. A bare write on
+     * the shared connection used to land inside whatever store transaction was
+     * open at that moment: a conflict's ROLLBACK took the row with it while the
+     * event, queued separately, was still written.
+     */
+    transaction<RESULT>(work: (scope: SqliteStoreTransaction) => Promise<RESULT>): Promise<RESULT>;
     /** Refuse new work, wait for queued operations, then close the owned connection. */
     close(): Promise<void>;
 }
+/** What a companion may do inside one store transaction. */
+export interface SqliteStoreTransaction {
+    database: SqliteDatabase;
+    appendEvent(input: AppendAgentStoreEvent): Promise<AgentStoreEventEnvelope>;
+}
 /**
  * Create Stitchkit's schema without claiming an application's tables or SQLite user_version.
  * An orphaned partial Stitchkit schema is refused rather than destructively repaired.

package/dist/agent-runtime/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAML,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,aAAa,EAAE,uBAAuB,CAAC;IACvC,oFAAoF;IACpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAqGD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAwF3E;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CA+azB"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAML,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,uBAAuB,EAG5B,KAAK,qBAAqB,EAG3B,MAAM,gBAAgB,CAAC;AAMxB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,aAAa,EAAE,uBAAuB,CAAC;IACvC;;;;;;;OAOG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB;;;;;;;;;OASG;IACH,WAAW,CAAC,MAAM,EAChB,IAAI,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,MAAM,CAAC,GACvD,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,oFAAoF;IACpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC7E;AAqJD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAqG3E;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CAioBzB"}

package/dist/agent-runtime/state-slots.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import type { AgentRuntimeStore } from './store.js';
+export interface AgentStateSlotDefinition<VALUE> {
+    name: string;
+    version: number;
+    schema: z.ZodType<VALUE>;
+    description?: string;
+}
+export interface AgentStateSlotValue {
+    name: string;
+    version: number;
+    value: unknown;
+    updatedAt: string;
+    seq: number;
+}
+export type AnyAgentStateSlot = AgentStateSlotDefinition<unknown>;
+export interface AgentStateSlotStore {
+    set(request: {
+        conversationId: string;
+        name: string;
+        value: unknown;
+        actor: 'agent' | 'human' | 'system';
+    }): Promise<AgentStateSlotValue>;
+    get(conversationId: string, name: string): Promise<AgentStateSlotValue | undefined>;
+    list(conversationId: string): Promise<readonly AgentStateSlotValue[]>;
+}
+export declare function defineStateSlot<VALUE>(input: {
+    name: string;
+    schema: z.ZodType<VALUE>;
+    version?: number;
+    description?: string;
+}): AgentStateSlotDefinition<VALUE>;
+export declare function createAgentStateSlotStore(input: {
+    store: AgentRuntimeStore;
+    definitions: readonly AnyAgentStateSlot[];
+}): AgentStateSlotStore;
+export declare function renderAgentStateSlots(values: readonly AgentStateSlotValue[]): string | undefined;
+export declare const agentGoalStateSlot: AgentStateSlotDefinition<{
+    objective: string;
+    status: "active" | "blocked" | "complete";
+}>;
+export declare const agentTodoStateSlot: AgentStateSlotDefinition<{
+    items: {
+        step: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}>;
+//# sourceMappingURL=state-slots.d.ts.map

package/dist/agent-runtime/state-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-slots.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/state-slots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,OAAO,EAAE;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;KACrC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjC,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACpF,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CACvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAYlC;AAqBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC3C,GAAG,mBAAmB,CAgEtB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GACrC,MAAM,GAAG,SAAS,CAMpB;AAED,eAAO,MAAM,kBAAkB;;;EAS7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;EAe7B,CAAC"}

package/dist/agent-runtime/state-tools.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import type { AgentStateSlotStore } from './state-slots.js';
+/** Agent tools bound to one conversation; callers cannot address a sibling's state. */
+export declare function createAgentStateTools(input: {
+    conversationId: string;
+    state: AgentStateSlotStore;
+}): readonly [import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    objective: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    objective: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        blocked: "blocked";
+        complete: "complete";
+    }>;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    objective: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        blocked: "blocked";
+        complete: "complete";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    objective: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        blocked: "blocked";
+        complete: "complete";
+    }>;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+    goal: z.ZodOptional<z.ZodObject<{
+        objective: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            blocked: "blocked";
+            complete: "complete";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>, import("./agent-tool.js").AgentToolDefinition<z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            in_progress: "in_progress";
+            pending: "pending";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            in_progress: "in_progress";
+            pending: "pending";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>];
+//# sourceMappingURL=state-tools.d.ts.map

package/dist/agent-runtime/state-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-tools.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/state-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAgBzD,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiFA"}

package/dist/agent-runtime/store-driver.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { type AgentMessage, type AgentRun } from './schemas.js';
 import { type AgentRecoverablePage, type AgentRuntimeStore } from './store.js';
+import { type AgentConversationArchive, type AgentStoreEventDraft, type AgentStoreEventEnvelope, type AgentStoreEventPage, ReadAgentStoreEventsSchema } from './store-events.js';
 import { type AgentConversationPurgeDriver } from './store-purge.js';
 export declare const AgentRuntimeHeadSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
@@ -39,10 +40,13 @@ export declare const AgentStoredRunSchema: z.ZodObject<{
             cancelled: "cancelled";
             context_overflow: "context_overflow";
             interrupted: "interrupted";
+            output_rejected: "output_rejected";
             policy_stop: "policy_stop";
             provider_failure: "provider_failure";
             provider_stop: "provider_stop";
+            runtime_failure: "runtime_failure";
             shutdown: "shutdown";
+            storage_conflict: "storage_conflict";
             success: "success";
             superseded: "superseded";
             timeout: "timeout";
@@ -652,6 +656,15 @@ export interface AgentRuntimeStoreDriver<TRANSACTION> {
         load(transaction: TRANSACTION, conversationId: string): Promise<readonly AgentMessage[]>;
         apply(transaction: TRANSACTION, mutation: AgentHistoryMutation): Promise<void>;
     };
+    events: {
+        append(transaction: TRANSACTION, event: AgentStoreEventDraft): Promise<AgentStoreEventEnvelope>;
+        list(transaction: TRANSACTION, input: z.infer<typeof ReadAgentStoreEventsSchema>): Promise<AgentStoreEventPage>;
+    };
+    /** Optional driver-owned durable payloads included in the canonical archive. */
+    archive?: {
+        export(transaction: TRANSACTION, conversationId: string): Promise<Pick<AgentConversationArchive, 'projections' | 'spills'>>;
+        import(transaction: TRANSACTION, archive: AgentConversationArchive): Promise<void>;
+    };
     scanRecoverable(input: {
         cursor?: string;
         limit: number;

package/dist/agent-runtime/store-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-driver.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/store-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store-driver.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/store-driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,YAAY,EAIjB,KAAK,QAAQ,EAKd,MAAM,WAAW,CAAC;AACnB,OAAO,EAML,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAgBvB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAQxB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,4BAA4B,EAElC,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,sBAAsB;;;;iBAIjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOtC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAWrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAO9E,MAAM,MAAM,8BAA8B,GACtC;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GACtB;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,uBAAuB,CAAC,WAAW;IAClD,aAAa,CAAC,EAAE,4BAA4B,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAChB,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EACnD,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACrC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,IAAI,EAAE;QACJ,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;QACzC,cAAc,CACZ,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YACL,cAAc,EAAE,MAAM,CAAC;YACvB,eAAe,EAAE,MAAM,CAAC;YACxB,IAAI,EAAE,gBAAgB,CAAC;SACxB,GACA,OAAO,CAAC,8BAA8B,CAAC,CAAC;KAC5C,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAC/C,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;QACvC,wBAAwB,CACtB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,kBAAkB,EAAE,MAAM,CAAA;SAAE,GAC5D,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;QACvC,QAAQ,CACN,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;SAAE,GAC3D,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;QACtC,UAAU,CACR,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACvE,CAAC;IACF,UAAU,EAAE;QACV,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,GACxD,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;QAC9C,oBAAoB,CAClB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YAAE,cAAc,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,GACxD,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACjF,CAAC;IACF,OAAO,EAAE;QACP,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;QACzF,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAChF,CAAC;IACF,MAAM,EAAE;QACN,MAAM,CACJ,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACpC,IAAI,CACF,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GAChD,OAAO,CAAC,mBAAmB,CAAC,CAAC;KACjC,CAAC;IACF,gFAAgF;IAChF,OAAO,CAAC,EAAE;QACR,MAAM,CACJ,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpF,CAAC;IACF,eAAe,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3F;AAuQD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,QAAQ,CAAC,OAAO,CAAC,EAI/D,CAAC;AAygBF,wBAAgB,uBAAuB,CAAC,WAAW,EACjD,MAAM,EAAE,uBAAuB,CAAC,WAAW,CAAC,GAC3C,iBAAiB,CA4anB;AAyCD,oGAAoG;AACpG,wBAAgB,6BAA6B,IAAI,iBAAiB,CAyPjE"}