@rivet-dev/pi 0.5.0 → 0.5.2

package/dist/actor.d.ts

@@ -1,32 +1,36 @@
-import type { AgentSession, AgentSessionEvent } from "@earendil-works/pi-coding-agent";
+import type { Harness } from "@earendil-works/pi-durable";
 import { type EventSchemaConfig, type QueueSchemaConfig, type Type } from "rivetkit";
 import { type PiActions } from "./actions.js";
 import type { PiActorDefinition, UserActions, UserActorConfig } from "./actor-types.js";
-import { type PiSessionOptions } from "./runtime.js";
-/** Every Pi `AgentSessionEvent`, in order, for connected clients. */
+import { type PiOptions } from "./runtime.js";
+import { type PiDocFrame, type PiEventsFrame, type PiTaskGraphFrame, type PiViewFrame } from "./watches.js";
+/** Watch frames, sent only to the connection that asked. See `PiWatchEvents`. */
 export type PiEvents = {
-    event: Type<AgentSessionEvent>;
+    "pi.events": Type<PiEventsFrame>;
+    "pi.view": Type<PiViewFrame>;
+    "pi.taskGraph": Type<PiTaskGraphFrame>;
+    "pi.doc": Type<PiDocFrame>;
 };
 /**
- * `c.pi`: the actor's Pi session, in the app's own actions and hooks. Reading
- * it throws when the session cannot open, such as while the sandbox provider
- * is down. In `onSleep` and `onDestroy` it is set only when the session is
- * already open in this actor generation.
+ * `c.pi`: the actor's Pi Durable harness, in the app's own actions and hooks.
+ * Reading it throws when Pi Durable cannot open, such as after a rollback to
+ * an older schema. In `onSleep` and `onDestroy` it is set only when Pi Durable
+ * is already open in this actor generation.
  */
 export interface PiAccess {
-    readonly pi: AgentSession;
+    readonly pi: Harness;
 }
 /** The app's own actions, which get `c.pi`. Nested objects become dotted action names. */
 export type PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = UserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, PiAccess>;
-/** Ordinary actor config plus Pi's session options. The app's actions and lifecycle hooks get `c.pi`. */
-export type PiActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = Record<never, never>> = UserActorConfig<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiSessionOptions, PiAccess>;
+/** Ordinary actor config plus the Pi Durable options. The app's actions and lifecycle hooks get `c.pi`. */
+export type PiActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = Record<never, never>> = UserActorConfig<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiOptions, PiAccess>;
 /**
- * Defines a Rivet Actor that owns one Pi coding-agent session.
+ * Defines a Rivet Actor that owns one Pi Durable harness.
  *
- * The session transcript and settings live in the actor's SQLite database and
- * are restored when the actor wakes. Pi events are broadcast on `event`.
- * Ordinary actor config (state, vars, actions, events, hooks) is passed through.
- * The app's own actions and lifecycle hooks get the session as `c.pi`.
+ * Pi Durable stores conversations, tasks, and documents in the actor's SQLite
+ * database. Runs survive sleep, upgrades, and crashes, and resume when the
+ * actor wakes. The actions match Pi Durable's API one to one. The app's own
+ * actions and lifecycle hooks get the harness as `c.pi`.
  */
-export declare function pi<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues>>(config?: PiActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions>): PiActorDefinition<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiEvents, PiActions>;
+export declare function pi<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues>>(config: PiActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions>): PiActorDefinition<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiEvents, PiActions>;
 //# sourceMappingURL=actor.d.ts.map

package/dist/actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,iBAAiB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEN,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EACtB,KAAK,IAAI,EACT,MAAM,UAAU,CAAC;AAElB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAO/D,OAAO,KAAK,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAKN,KAAK,gBAAgB,EAIrB,MAAM,cAAc,CAAC;AAGtB,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;CAC/B,CAAC;AAyBF;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;CAC1B;AAED,0FAA0F;AAC1F,MAAM,MAAM,aAAa,CACxB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,SAAS,iBAAiB,EACjC,OAAO,SAAS,iBAAiB,IAC9B,WAAW,CACd,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,QAAQ,CACR,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,kBAAkB,CAC7B,MAAM,GAAG,SAAS,EAClB,WAAW,GAAG,SAAS,EACvB,UAAU,GAAG,SAAS,EACtB,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,SAAS,EAClB,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,YAAY,SAAS,aAAa,CACjC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IACrB,eAAe,CAClB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,QAAQ,CACR,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,EAAE,CACjB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,YAAY,SAAS,aAAa,CACjC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,GAAG,aAAa,CAChB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,EAED,MAAM,GAAE,kBAAkB,CACzB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,CAUZ,GACC,iBAAiB,CACnB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,SAAS,CACT,CAyDA"}
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAEN,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EACtB,KAAK,IAAI,EACT,MAAM,UAAU,CAAC;AAElB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAO/D,OAAO,KAAK,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAMN,KAAK,SAAS,EAId,MAAM,cAAc,CAAC;AAEtB,OAAO,EACN,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEhB,MAAM,cAAc,CAAC;AAEtB,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7B,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;CAC3B,CAAC;AASF;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACrB;AAED,0FAA0F;AAC1F,MAAM,MAAM,aAAa,CACxB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,SAAS,iBAAiB,EACjC,OAAO,SAAS,iBAAiB,IAC9B,WAAW,CACd,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,QAAQ,CACR,CAAC;AAEF,2GAA2G;AAC3G,MAAM,MAAM,kBAAkB,CAC7B,MAAM,GAAG,SAAS,EAClB,WAAW,GAAG,SAAS,EACvB,UAAU,GAAG,SAAS,EACtB,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,SAAS,EAClB,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,YAAY,SAAS,aAAa,CACjC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IACrB,eAAe,CAClB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,QAAQ,CACR,CAAC;AAoBF;;;;;;;GAOG;AACH,wBAAgB,EAAE,CACjB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,YAAY,SAAS,aAAa,CACjC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,GAAG,aAAa,CAChB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,EAED,MAAM,EAAE,kBAAkB,CACzB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,CACZ,GACC,iBAAiB,CACnB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,SAAS,CACT,CAmFA"}

package/dist/actor.js

@@ -2,77 +2,105 @@ import { actor, event, } from "rivetkit";
 import { db } from "rivetkit/db";
 import { createPiActions } from "./actions.js";
 import { assertNoReservedNames, sharedActorConfig, splitConfig, wrapActions, } from "./actor-config.js";
-import { closePiSession, createPiRuntime, PI_RUNTIME, resumeInterruptedRun, stopRunWhenLost, withPiSession, } from "./runtime.js";
+import { closeHarness, createPiRuntime, openOnWake, PI_RUNTIME, piRuntime, withPiAccess, withUnavailablePi, } from "./runtime.js";
 import { migratePiTables } from "./storage.js";
+import { unwatchConnection, } from "./watches.js";
 const piEvents = {
-    event: event(),
+    "pi.events": event(),
+    "pi.view": event(),
+    "pi.taskGraph": event(),
+    "pi.doc": event(),
 };
 const piOptionKeys = [
-    "cwd",
-    "agentDir",
-    "providers",
-    "apiKeys",
-    "credentials",
+    "registry",
+    "models",
+    "settings",
+    "env",
+    "conversationCreated",
+    "now",
+    "onReport",
     "model",
     "thinkingLevel",
     "scopedModels",
-    "noTools",
-    "tools",
-    "excludeTools",
-    "customTools",
-    "resourceLoader",
-    "sessionStartEvent",
-    "settings",
+    "providers",
+    "apiKeys",
+    "credentials",
     "sandbox",
+    "documents",
 ];
 /**
- * Defines a Rivet Actor that owns one Pi coding-agent session.
+ * Defines a Rivet Actor that owns one Pi Durable harness.
  *
- * The session transcript and settings live in the actor's SQLite database and
- * are restored when the actor wakes. Pi events are broadcast on `event`.
- * Ordinary actor config (state, vars, actions, events, hooks) is passed through.
- * The app's own actions and lifecycle hooks get the session as `c.pi`.
+ * Pi Durable stores conversations, tasks, and documents in the actor's SQLite
+ * database. Runs survive sleep, upgrades, and crashes, and resume when the
+ * actor wakes. The actions match Pi Durable's API one to one. The app's own
+ * actions and lifecycle hooks get the harness as `c.pi`.
  */
-export function pi(config = {}) {
-    const { actorConfig, options: sessionOptions } = splitConfig(config, piOptionKeys);
+export function pi(config) {
+    const { actorConfig, options: piOptions } = splitConfig(config, piOptionKeys);
+    if (!piOptions.registry) {
+        throw new Error("pi() needs a registry; pass createRegistry() from @earendil-works/pi-durable");
+    }
     if (actorConfig.db !== undefined) {
         throw new Error("pi() owns the actor database; remove the db option");
     }
-    const actions = createPiActions(sessionOptions);
+    const actions = createPiActions(piOptions);
     assertNoReservedNames("pi()", actorConfig, {
         action: actions,
         event: piEvents,
     });
-    const withPi = (hook, opensSession = true) => hook &&
-        ((c, ...args) => withPiSession(c, sessionOptions, () => hook(c, ...args), {
-            opensSession,
+    const withPi = (hook, opensHarness = true) => hook &&
+        ((c, ...args) => withPiAccess(c, piOptions, () => hook(c, ...args), {
+            opensHarness,
         }));
-    const userOnWake = withPi(actorConfig.onWake);
+    const userOnWake = actorConfig.onWake;
+    const userOnDisconnect = withPi(actorConfig.onDisconnect);
     // The config is built from untyped parts, so `actor()` cannot check it
     // against the generics. The declared return type is the public contract.
     return actor({
-        ...sharedActorConfig("pi()", actorConfig, { slot: PI_RUNTIME, create: createPiRuntime }, (c, stop) => closePiSession(c, sessionOptions, stop), {
+        ...sharedActorConfig("pi()", actorConfig, { slot: PI_RUNTIME, create: createPiRuntime }, (c, stop) => closeHarness(c, piOptions, stop), {
             onSleep: withPi(actorConfig.onSleep, false),
             onDestroy: withPi(actorConfig.onDestroy, false),
         }),
         db: db({ onMigrate: migratePiTables }),
         events: { ...(actorConfig.events ?? {}), ...piEvents },
         actions: {
-            ...wrapActions(actorConfig.actions ?? {}, (c, action) => withPiSession(c, sessionOptions, action)),
+            ...wrapActions(actorConfig.actions ?? {}, (c, action) => withPiAccess(c, piOptions, action)),
             ...actions,
         },
+        // Opening on wake resumes interrupted work, after the app's own onWake.
         onWake: async (c) => {
-            stopRunWhenLost(c);
-            await userOnWake?.(c);
-            await resumeInterruptedRun(c, sessionOptions).catch((error) => {
+            let harness;
+            try {
+                harness = await openOnWake(c, piOptions);
+            }
+            catch (error) {
+                // The actor stays up so actions can report the cause, such as a
+                // schema newer than the code. Using c.pi throws it.
                 c.log.error({
-                    msg: "pi could not resume the run that was active when the actor stopped",
+                    msg: "pi durable could not open on wake; actions will retry",
                     error,
                 });
-            });
+                return withUnavailablePi(c, error, () => userOnWake?.(c));
+            }
+            Object.defineProperty(c, "pi", { value: harness, configurable: true });
+            try {
+                await userOnWake?.(c);
+            }
+            finally {
+                harness.resume();
+            }
         },
         onConnect: withPi(actorConfig.onConnect),
-        onDisconnect: withPi(actorConfig.onDisconnect),
+        onDisconnect: async (c, conn) => {
+            try {
+                await userOnDisconnect?.(c, conn);
+            }
+            finally {
+                const runtime = piRuntime(c);
+                await unwatchConnection(runtime.actor ?? c, runtime.watches, conn.id);
+            }
+        },
     });
 }
 //# sourceMappingURL=actor.js.map

package/dist/actor.js.map

@@ -1 +1 @@
-{"version":3,"file":"actor.js","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,KAAK,EAEL,KAAK,GAGL,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAC/D,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,WAAW,GACX,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACN,cAAc,EACd,eAAe,EACf,UAAU,EAGV,oBAAoB,EACpB,eAAe,EACf,aAAa,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,QAAQ,GAAa;IAC1B,KAAK,EAAE,KAAK,EAAqB;CACjC,CAAC;AAEF,MAAM,YAAY,GAAG;IACpB,KAAK;IACL,UAAU;IACV,WAAW;IACX,SAAS;IACT,aAAa;IACb,OAAO;IACP,eAAe;IACf,cAAc;IACd,SAAS;IACT,OAAO;IACP,cAAc;IACd,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,UAAU;IACV,SAAS;CAC8C,CAAC;AA+DzD;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CA0BjB,SASI,EASH;IAaD,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,GAC7C,WAAW,CAAmB,MAAM,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,WAAW,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAChD,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE;QAC1C,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CACd,IAA6D,EAC7D,YAAY,GAAG,IAAI,EAClB,EAAE,CACH,IAAI;QACJ,CAAC,CAAC,CAAY,EAAE,GAAG,IAAW,EAAE,EAAE,CACjC,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE;YACxD,YAAY;SACZ,CAAC,CAAC,CAAC;IACN,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE9C,uEAAuE;IACvE,yEAAyE;IACzE,OAAO,KAAK,CAAC;QACZ,GAAG,iBAAiB,CACnB,MAAM,EACN,WAAW,EACX,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,EAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EACpD;YACC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;YAC3C,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC;SAC/C,CACD;QACD,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;QACtC,MAAM,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE;QACtD,OAAO,EAAE;YACR,GAAG,WAAW,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAY,EAAE,MAAM,EAAE,EAAE,CAClE,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,CACxC;YACD,GAAG,OAAO;SACV;QACD,MAAM,EAAE,KAAK,EAAE,CAAY,EAAE,EAAE;YAC9B,eAAe,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,oBAAoB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;oBACX,GAAG,EAAE,oEAAoE;oBACzE,KAAK;iBACL,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC;QACxC,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;KACvC,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"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"}

package/dist/credentials.d.ts

@@ -24,7 +24,7 @@ export interface PiCredentialInfo {
 export interface PiCredentialSource {
     /** Providers that have a credential. */
     list(): Promise<PiCredentialInfo[]>;
-    /** A provider's credential, possibly expired. */
+    /** A provider's credential, possibly expired, or `undefined` when it has none. */
     read(providerId: string): Promise<PiProviderCredential | undefined>;
     /**
      * A provider's credential after the application refreshed it. Pi calls this
@@ -35,14 +35,14 @@ export interface PiCredentialSource {
 }
 /**
  * Adapts an application's credential source to Pi's credential store. It
- * reads only providers the source lists, keeps what it read until
- * `invalidate` runs, and never writes.
+ * asks the source each time Pi needs a credential, so logins and logouts
+ * apply to the next model call, and never writes. Pi's `{ signal }` is not
+ * passed on, because a source is often an Actor handle, whose actions would
+ * receive the signal as an argument.
  */
 export declare class SourceCredentialStore implements PiCredentialStore {
     #private;
     constructor(source: PiCredentialSource);
-    /** Drops what was read so the next read sees new logins and logouts. */
-    invalidate(): void;
     list(): Promise<PiCredentialInfo[]>;
     read(providerId: string): Promise<PiCredential | undefined>;
     /**

package/dist/credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC1C;IACA,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEL,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpC,iDAAiD;IACjD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IACpE;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CACvE;AAKD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;;gBAKlD,MAAM,EAAE,kBAAkB;IAItC,wEAAwE;IACxE,UAAU,IAAI,IAAI;IAKlB,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQ7B,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAiBjE;;;OAGG;IACG,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,CACH,OAAO,EAAE,YAAY,GAAG,SAAS,KAC7B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,GACpC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IA0B9B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC1C;IACA,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEL,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpC,kFAAkF;IAClF,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IACpE;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CACvE;AAKD;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;;gBAGlD,MAAM,EAAE,kBAAkB;IAItC,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI7B,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIjE;;;OAGG;IACG,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,CACH,OAAO,EAAE,YAAY,GAAG,SAAS,KAC7B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,GACpC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAmB9B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C"}

package/dist/credentials.js

@@ -2,62 +2,33 @@
 const PI_OAUTH_MIN_VALIDITY_MS = 5 * 60_000;
 /**
  * Adapts an application's credential source to Pi's credential store. It
- * reads only providers the source lists, keeps what it read until
- * `invalidate` runs, and never writes.
+ * asks the source each time Pi needs a credential, so logins and logouts
+ * apply to the next model call, and never writes. Pi's `{ signal }` is not
+ * passed on, because a source is often an Actor handle, whose actions would
+ * receive the signal as an argument.
  */
 export class SourceCredentialStore {
     #source;
-    #listed;
-    #read = new Map();
     constructor(source) {
         this.#source = source;
     }
-    /** Drops what was read so the next read sees new logins and logouts. */
-    invalidate() {
-        this.#listed = undefined;
-        this.#read.clear();
-    }
     list() {
-        this.#listed ??= this.#source.list().catch((error) => {
-            this.#listed = undefined;
-            throw error;
-        });
-        return this.#listed;
+        return this.#source.list();
     }
     async read(providerId) {
-        if (!(await this.list()).some((entry) => entry.providerId === providerId))
-            return undefined;
-        let read = this.#read.get(providerId);
-        if (!read) {
-            read = this.#source
-                .read(providerId)
-                .then(toPiCredential)
-                .catch((error) => {
-                this.#read.delete(providerId);
-                throw error;
-            });
-            this.#read.set(providerId, read);
-        }
-        return read;
+        return toPiCredential(await this.#source.read(providerId));
     }
     /**
      * Pi calls this to refresh a subscription token that expires soon. The
      * source refreshes it, so `fn` sees a fresh credential and never writes.
      */
     async modify(providerId, fn) {
-        const refreshed = this.#source.refresh(providerId).then((credential) => {
-            if (credential?.type === "oauth" &&
-                credential.expires - Date.now() <= PI_OAUTH_MIN_VALIDITY_MS) {
-                throw new Error(`the credential source returned a ${providerId} token that expires within five minutes`);
-            }
-            return toPiCredential(credential);
-        });
-        this.#read.set(providerId, refreshed);
-        refreshed.catch(() => {
-            if (this.#read.get(providerId) === refreshed)
-                this.#read.delete(providerId);
-        });
-        const current = await refreshed;
+        const credential = await this.#source.refresh(providerId);
+        if (credential?.type === "oauth" &&
+            credential.expires - Date.now() <= PI_OAUTH_MIN_VALIDITY_MS) {
+            throw new Error(`the credential source returned a ${providerId} token that expires within five minutes`);
+        }
+        const current = toPiCredential(credential);
         if ((await fn(current)) !== undefined) {
             throw new Error(`pi actor cannot store credentials for ${providerId}; the credential source owns them`);
         }

package/dist/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAuCA,gFAAgF;AAChF,MAAM,wBAAwB,GAAG,CAAC,GAAG,MAAM,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,CAAqB;IAErC,YAAY,MAA0B;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC5B,OAAO,cAAc,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACX,UAAkB,EAClB,EAEsC;QAEtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,IACC,UAAU,EAAE,IAAI,KAAK,OAAO;YAC5B,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,wBAAwB,EAC1D,CAAC;YACF,MAAM,IAAI,KAAK,CACd,oCAAoC,UAAU,yCAAyC,CACvF,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACd,yCAAyC,UAAU,mCAAmC,CACtF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC9B,MAAM,IAAI,KAAK,CACd,0CAA0C,UAAU,mCAAmC,CACvF,CAAC;IACH,CAAC;CACD;AAED,+HAA+H;AAC/H,SAAS,cAAc,CACtB,UAA4C;IAE5C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACrD,OAAO,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACvC,CAAC"}

package/dist/database-env.d.ts

@@ -0,0 +1,14 @@
+import { type ExecutionEnv } from "@earendil-works/pi-durable/env";
+import type { PiDatabase } from "./storage.js";
+/**
+ * Pi Durable's `ExecutionEnv` over files stored in the actor's database, in
+ * the `pi_file` table, for Pi's `read`, `write`, and `edit` tools. Directories
+ * exist only as the paths of their files. There is no shell, so `exec` fails
+ * with `shell_unavailable`, and operations the tools do not use return
+ * `not_supported`.
+ */
+export declare function databaseEnv(db: PiDatabase, options: {
+    id: string;
+    cwd?: string;
+}): ExecutionEnv;
+//# sourceMappingURL=database-env.d.ts.map

package/dist/database-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-env.d.ts","sourceRoot":"","sources":["../src/database-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,KAAK,YAAY,EASjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO/C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,YAAY,CA8Fd"}

package/dist/database-env.js

@@ -0,0 +1,173 @@
+import { posix } from "node:path";
+import { ExecutionError, err, FileError, LineScanner, ok, toError, } from "@earendil-works/pi-durable/env";
+const DEFAULT_CWD = "/workspace";
+/** Bytes per query when a scan walks a whole file. */
+const SCAN_CHUNK_BYTES = 64 * 1024;
+/**
+ * Pi Durable's `ExecutionEnv` over files stored in the actor's database, in
+ * the `pi_file` table, for Pi's `read`, `write`, and `edit` tools. Directories
+ * exist only as the paths of their files. There is no shell, so `exec` fails
+ * with `shell_unavailable`, and operations the tools do not use return
+ * `not_supported`.
+ */
+export function databaseEnv(db, options) {
+    const env = {
+        id: options.id,
+        cwd: posix.resolve(DEFAULT_CWD, options.cwd ?? DEFAULT_CWD),
+        absolutePath: async (path) => ok(posix.resolve(env.cwd, path)),
+        joinPath: async (parts) => ok(posix.join(...parts)),
+        canonicalPath: async (path) => ok(posix.resolve(env.cwd, path)),
+        exists: (path, context) => attempt(path, context, async (resolved) => (await entry(db, resolved)) !== undefined),
+        fileInfo: (path, context) => attempt(path, context, async (resolved) => {
+            const info = await entry(db, resolved);
+            if (!info)
+                throw notFound(resolved);
+            return info;
+        }),
+        readTextFile: (path, context) => attempt(path, context, async (resolved) => new TextDecoder().decode(await readFile(db, resolved))),
+        readBinaryFile: (path, context) => attempt(path, context, (resolved) => readFile(db, resolved)),
+        openBinaryReader: (path, _options, context) => attempt(path, context, async (resolved) => {
+            await requireFile(db, resolved);
+            return fileReader(db, resolved);
+        }),
+        writeFile: (path, content, context) => attempt(path, context, async (resolved) => {
+            const bytes = typeof content === "string"
+                ? new TextEncoder().encode(content)
+                : content;
+            await db.execute(`INSERT INTO pi_file (path, content, mtime_ms) VALUES (?, ?, ?)
+					 ON CONFLICT (path) DO UPDATE SET
+						content = excluded.content,
+						mtime_ms = excluded.mtime_ms`, resolved, bytes, Date.now());
+        }),
+        exec: async () => err(new ExecutionError("shell_unavailable", "There is no shell: files are stored in the actor's database. Give pi() a sandbox to run commands.")),
+        openTextLineReader: async (path) => notSupported("openTextLineReader", path),
+        readTextLines: async (path) => notSupported("readTextLines", path),
+        appendFile: async (path) => notSupported("appendFile", path),
+        truncateFile: async (path) => notSupported("truncateFile", path),
+        flushFile: async (path) => notSupported("flushFile", path),
+        renameFile: async (path) => notSupported("renameFile", path),
+        listDir: async (path) => notSupported("listDir", path),
+        openDirReader: async (path) => notSupported("openDirReader", path),
+        watch: async () => notSupported("watch"),
+        createDir: async (path) => notSupported("createDir", path),
+        remove: async (path) => notSupported("remove", path),
+        createTempDir: async () => notSupported("createTempDir"),
+        createTempFile: async () => notSupported("createTempFile"),
+        cleanup: async () => { },
+    };
+    /**
+     * Resolves `path`, runs `operation` unless the run is aborted, and returns a
+     * thrown error as a `FileError`.
+     */
+    async function attempt(path, context, operation) {
+        const resolved = posix.resolve(env.cwd, path);
+        if (context.abortSignal?.aborted)
+            return err(aborted(resolved));
+        try {
+            return ok(await operation(resolved));
+        }
+        catch (error) {
+            if (error instanceof FileError)
+                return err(error);
+            const cause = toError(error);
+            return err(new FileError("unknown", cause.message, resolved, cause));
+        }
+    }
+    return env;
+}
+/** The file or directory at `path`. A directory exists when a file below it does. */
+async function entry(db, path) {
+    const [file] = await db.execute(`SELECT length(content) AS size, mtime_ms FROM pi_file WHERE path = ?`, path);
+    if (file) {
+        return {
+            name: posix.basename(path),
+            path,
+            kind: "file",
+            size: file.size,
+            mtimeMs: file.mtime_ms,
+        };
+    }
+    const below = path === "/" ? "/" : `${path}/`;
+    // Paths below `below` sort from it up to the same prefix ending in the next byte.
+    const [child] = await db.execute(`SELECT 1 FROM pi_file WHERE path > ? AND path < ? LIMIT 1`, below, `${below.slice(0, -1)}0`);
+    if (!child)
+        return undefined;
+    return {
+        name: posix.basename(path),
+        path,
+        kind: "directory",
+        size: 0,
+        mtimeMs: 0,
+    };
+}
+async function requireFile(db, path) {
+    const info = await entry(db, path);
+    if (!info)
+        throw notFound(path);
+    if (info.kind === "directory") {
+        throw new FileError("is_directory", `${path} is a directory`, path);
+    }
+    return info;
+}
+async function readFile(db, path) {
+    const [row] = await db.execute(`SELECT content FROM pi_file WHERE path = ?`, path);
+    if (row)
+        return new Uint8Array(row.content);
+    await requireFile(db, path);
+    throw notFound(path);
+}
+/** Reads byte ranges of the stored file with SQL, so a large file is never loaded whole. */
+function fileReader(db, path) {
+    const range = async (offset, length) => {
+        const [row] = await db.execute(`SELECT substr(content, ?, ?) AS chunk FROM pi_file WHERE path = ?`, offset + 1, length, path);
+        if (!row)
+            throw notFound(path);
+        return new Uint8Array(row.chunk ?? new Uint8Array());
+    };
+    const guarded = async (context, operation) => {
+        if (context.abortSignal?.aborted)
+            return err(aborted(path));
+        try {
+            return ok(await operation());
+        }
+        catch (error) {
+            if (error instanceof FileError)
+                return err(error);
+            const cause = toError(error);
+            return err(new FileError("unknown", cause.message, path, cause));
+        }
+    };
+    return {
+        info: (context) => guarded(context, () => requireFile(db, path)),
+        read: (offset, length, context) => guarded(context, () => range(offset, length)),
+        scanLines: ({ startLine, endLine }, context) => guarded(context, async () => {
+            let scanner;
+            try {
+                scanner = new LineScanner(startLine, endLine);
+            }
+            catch {
+                throw new FileError("invalid", "Invalid line range", path);
+            }
+            for (let offset = 0;; offset += SCAN_CHUNK_BYTES) {
+                if (context.abortSignal?.aborted)
+                    throw aborted(path);
+                const chunk = await range(offset, SCAN_CHUNK_BYTES);
+                if (chunk.length > 0)
+                    scanner.push(chunk);
+                if (chunk.length < SCAN_CHUNK_BYTES)
+                    return scanner.finish();
+            }
+        }),
+        close: async () => { },
+    };
+}
+function aborted(path) {
+    return new FileError("aborted", "aborted", path);
+}
+function notFound(path) {
+    return new FileError("not_found", `${path} does not exist`, path);
+}
+function notSupported(operation, path) {
+    return err(new FileError("not_supported", `${operation} is not supported for files stored in the database`, path));
+}
+//# sourceMappingURL=database-env.js.map

package/dist/database-env.js.map

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

package/dist/drain.d.ts

@@ -1,6 +1,6 @@
 /**
  * Fifteen minutes, so a running model call or tool call can finish before a
- * deploy moves the actor. The engine's stop threshold still bounds it.
+ * an upgrade restarts the actor. The engine's stop threshold still bounds it.
  */
 export declare const DEFAULT_SLEEP_GRACE_PERIOD_MS: number;
 /**

package/dist/drain.js

@@ -1,6 +1,6 @@
 /**
  * Fifteen minutes, so a running model call or tool call can finish before a
- * deploy moves the actor. The engine's stop threshold still bounds it.
+ * an upgrade restarts the actor. The engine's stop threshold still bounds it.
  */
 export const DEFAULT_SLEEP_GRACE_PERIOD_MS = 15 * 60_000;
 /**

package/dist/durable.d.ts

@@ -0,0 +1,24 @@
+import type { EventSchemaConfig, QueueSchemaConfig } from "rivetkit";
+import type { PiActions, PiPromptOptions, PiPromptResult } from "./actions.js";
+import { type PiAccess, type PiActorConfigInput, type PiEvents, type PiUserActions, pi } from "./actor.js";
+import type { PiOptions } from "./runtime.js";
+export * from "./index.js";
+/** @deprecated Use `pi()` from `@rivet-dev/pi`. `piDurable()` is the same actor under its old name. */
+export declare const piDurable: typeof pi;
+/** @deprecated Use `PiActions` from `@rivet-dev/pi`. */
+export type PiDurableActions = PiActions;
+/** @deprecated Use `PiPromptOptions` from `@rivet-dev/pi`. */
+export type PiDurablePromptOptions = PiPromptOptions;
+/** @deprecated Use `PiPromptResult` from `@rivet-dev/pi`. */
+export type PiDurablePromptResult = PiPromptResult;
+/** @deprecated Use `PiAccess` from `@rivet-dev/pi`. */
+export type PiDurableAccess = PiAccess;
+/** @deprecated Use `PiActorConfigInput` from `@rivet-dev/pi`. */
+export type PiDurableActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = Record<never, never>> = PiActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions>;
+/** @deprecated Use `PiEvents` from `@rivet-dev/pi`. */
+export type PiDurableEvents = PiEvents;
+/** @deprecated Use `PiUserActions` from `@rivet-dev/pi`. */
+export type PiDurableUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = PiUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues>;
+/** @deprecated Use `PiOptions` from `@rivet-dev/pi`. */
+export type PiDurableOptions = PiOptions;
+//# sourceMappingURL=durable.d.ts.map

package/dist/durable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable.d.ts","sourceRoot":"","sources":["../src/durable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,EAAE,EACF,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,cAAc,YAAY,CAAC;AAE3B,uGAAuG;AACvG,eAAO,MAAM,SAAS,WAAK,CAAC;AAE5B,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACzC,8DAA8D;AAC9D,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC;AACrD,6DAA6D;AAC7D,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AACnD,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AACvC,iEAAiE;AACjE,MAAM,MAAM,yBAAyB,CACpC,MAAM,GAAG,SAAS,EAClB,WAAW,GAAG,SAAS,EACvB,UAAU,GAAG,SAAS,EACtB,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,SAAS,EAClB,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,OAAO,SAAS,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxD,YAAY,SAAS,aAAa,CACjC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IACrB,kBAAkB,CACrB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,CACZ,CAAC;AACF,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AACvC,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,CAC/B,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,SAAS,iBAAiB,EACjC,OAAO,SAAS,iBAAiB,IAC9B,aAAa,CAChB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CACP,CAAC;AACF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC"}

package/dist/durable.js

@@ -0,0 +1,5 @@
+import { pi, } from "./actor.js";
+export * from "./index.js";
+/** @deprecated Use `pi()` from `@rivet-dev/pi`. `piDurable()` is the same actor under its old name. */
+export const piDurable = pi;
+//# sourceMappingURL=durable.js.map

package/dist/durable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable.js","sourceRoot":"","sources":["../src/durable.ts"],"names":[],"mappings":"AAEA,OAAO,EAKN,EAAE,GACF,MAAM,YAAY,CAAC;AAGpB,cAAc,YAAY,CAAC;AAE3B,uGAAuG;AACvG,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC"}