@rivet-dev/pi 0.1.0 → 0.5.1

package/dist/actor-types.d.ts

@@ -0,0 +1,34 @@
+import type { ActionContext, ActorConfigInput, ActorDefinition, Conn, ConnectContext, DestroyContext, DisconnectContext, EventSchemaConfig, QueueSchemaConfig, SleepContext, WakeContext } from "rivetkit";
+import type { PiDatabaseProvider } from "./runtime.js";
+/** `Omit` that keeps each member of a union, so `state` and `createState` stay alternatives. */
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/** The app's actions as clients see them: the same arguments, without `c.pi`. */
+type ClientActions<T, TContext> = string extends keyof T ? Record<never, never> : {
+    [K in keyof T]: T[K] extends (c: any, ...args: infer TArgs) => infer TResult ? (c: TContext, ...args: TArgs) => TResult : ClientActions<T[K], TContext>;
+};
+/**
+ * The app's own actions, which get `c.pi` through `TAccess`. Nested objects
+ * become dotted action names.
+ */
+export interface UserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig, TAccess> {
+    [action: string]: ((c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess, ...args: any[]) => any) | UserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TAccess>;
+}
+/** Lifecycle hooks that get `c.pi` through `TAccess`. */
+interface UserHooks<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig, TAccess> {
+    onWake?: (c: WakeContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess) => void | Promise<void>;
+    onSleep?: (c: SleepContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess) => void | Promise<void>;
+    onDestroy?: (c: DestroyContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess) => void | Promise<void>;
+    onConnect?: (c: ConnectContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues>) => void | Promise<void>;
+    onDisconnect?: (c: DisconnectContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> & TAccess, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues>) => void | Promise<void>;
+}
+/**
+ * Ordinary actor config with the app's actions and hooks typed to get `c.pi`,
+ * plus the Pi options in `TOptions`.
+ */
+export type UserActorConfig<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig, TUserActions, TOptions, TAccess> = DistributiveOmit<ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues>, "actions" | keyof UserHooks<any, any, any, any, any, any, any, unknown>> & UserHooks<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TAccess> & TOptions & {
+    actions?: TUserActions;
+};
+/** The actor definition clients see: the app's actions and events plus the built-in ones. */
+export type PiActorDefinition<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig, TUserActions, TBuiltInEvents extends EventSchemaConfig, TBuiltInActions> = ActorDefinition<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents & TBuiltInEvents, TQueues, ClientActions<TUserActions, ActionContext<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues>> & TBuiltInActions>;
+export {};
+//# sourceMappingURL=actor-types.d.ts.map

package/dist/actor-types.d.ts.map

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

package/dist/actor-types.js

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

package/dist/actor-types.js.map

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

package/dist/actor.d.ts

@@ -1,24 +1,36 @@
-import type { AgentSessionEvent } from "@earendil-works/pi-coding-agent";
-import { type Actions, type ActorConfigInput, type ActorDefinition, type EventSchemaConfig, type QueueSchemaConfig, type Type } from "rivetkit";
+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 PiDatabaseProvider, type PiSessionOptions } from "./runtime.js";
-/** Every Pi `AgentSessionEvent`, in order, for connected clients. */
+import type { PiActorDefinition, UserActions, UserActorConfig } from "./actor-types.js";
+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>;
 };
-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 Actions<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> = Record<never, never>> = ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues, TUserActions> & PiSessionOptions;
 /**
- * The actions the user defined. With no `actions` option, TypeScript uses the
- * default, a record with an index signature, which would hide the Pi actions.
+ * `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.
  */
-type UserActions<T> = string extends keyof T ? Record<never, never> : T;
+export interface PiAccess {
+    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 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.
+ * 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 Actions<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues> = Actions<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents, TQueues>>(config?: PiActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions>): ActorDefinition<TState, TConnParams, TConnState, TVars, TInput, PiDatabaseProvider, TEvents & PiEvents, TQueues, UserActions<TUserActions> & PiActions>;
-export {};
+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,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAGpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,IAAI,EACT,MAAM,UAAU,CAAC;AAElB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAKN,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,MAAM,cAAc,CAAC;AAMtB,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;CAC/B,CAAC;AAyBF,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,OAAO,CAC3B,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,EACP,OAAO,CACP,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IACrB,gBAAgB,CACnB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,YAAY,CACZ,GACA,gBAAgB,CAAC;AAElB;;;GAGG;AACH,KAAK,WAAW,CAAC,CAAC,IAAI,MAAM,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;AAExE;;;;;;GAMG;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,OAAO,CAC3B,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,EACP,OAAO,CACP,GAAG,OAAO,CACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,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,eAAe,CACjB,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,GAAG,QAAQ,EAClB,OAAO,EACP,WAAW,CAAC,YAAY,CAAC,GAAG,SAAS,CACrC,CAyDA"}
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"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"}

package/dist/actor.js

@@ -1,113 +1,106 @@
 import { actor, event, } from "rivetkit";
 import { db } from "rivetkit/db";
 import { createPiActions } from "./actions.js";
-import { closePiSession, createPiRuntime, PI_RUNTIME, } from "./runtime.js";
+import { assertNoReservedNames, sharedActorConfig, splitConfig, wrapActions, } from "./actor-config.js";
+import { closeHarness, createPiRuntime, openOnWake, PI_RUNTIME, piRuntime, withPiAccess, withUnavailablePi, } from "./runtime.js";
 import { migratePiTables } from "./storage.js";
-/** Ten minutes. Pi actions such as `waitForIdle` and `compact` outlive RivetKit's one-minute default. */
-const DEFAULT_ACTION_TIMEOUT_MS = 10 * 60_000;
+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.
+ * 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, sessionOptions } = splitConfig(config);
+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);
-    assertNoReservedKeys("action", actorConfig.actions, actions);
-    assertNoReservedKeys("event", actorConfig.events, piEvents);
-    const userVars = actorConfig.vars;
-    const userCreateVars = actorConfig.createVars;
-    const userOnSleep = actorConfig.onSleep;
-    const userOnDestroy = actorConfig.onDestroy;
-    delete actorConfig.vars;
+    const actions = createPiActions(piOptions);
+    assertNoReservedNames("pi()", actorConfig, {
+        action: actions,
+        event: piEvents,
+    });
+    const withPi = (hook, opensHarness = true) => hook &&
+        ((c, ...args) => withPiAccess(c, piOptions, () => hook(c, ...args), {
+            opensHarness,
+        }));
+    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({
-        ...actorConfig,
-        options: {
-            actionTimeout: DEFAULT_ACTION_TIMEOUT_MS,
-            ...actorConfig.options,
-        },
+        ...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: { ...(actorConfig.actions ?? {}), ...actions },
-        createVars: async (c, driverCtx) => {
-            const vars = userCreateVars
-                ? await userCreateVars(c, driverCtx)
-                : userVars === undefined
-                    ? undefined
-                    : structuredClone(userVars);
-            return attachRuntime(vars);
+        actions: {
+            ...wrapActions(actorConfig.actions ?? {}, (c, action) => withPiAccess(c, piOptions, action)),
+            ...actions,
         },
-        onSleep: async (c) => {
+        // Opening on wake resumes interrupted work, after the app's own onWake.
+        onWake: async (c) => {
+            let harness;
             try {
-                await userOnSleep?.(c);
+                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 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 {
-                await closePiSession(c, sessionOptions, "sleep");
+                harness.resume();
             }
         },
-        onDestroy: async (c) => {
+        onConnect: withPi(actorConfig.onConnect),
+        onDisconnect: async (c, conn) => {
             try {
-                await userOnDestroy?.(c);
+                await userOnDisconnect?.(c, conn);
             }
             finally {
-                await closePiSession(c, sessionOptions, "destroy");
+                const runtime = piRuntime(c);
+                await unwatchConnection(runtime.actor ?? c, runtime.watches, conn.id);
             }
         },
     });
 }
-function splitConfig(config) {
-    const actorConfig = { ...config };
-    const sessionOptions = {};
-    for (const key of piOptionKeys) {
-        if (key in actorConfig) {
-            sessionOptions[key] = actorConfig[key];
-            delete actorConfig[key];
-        }
-    }
-    return { actorConfig, sessionOptions: sessionOptions };
-}
-/** Adds the Pi runtime slot to the user's vars without changing their shape. */
-function attachRuntime(vars) {
-    const runtime = createPiRuntime();
-    if (vars === undefined) {
-        return { [PI_RUNTIME]: runtime };
-    }
-    if (typeof vars !== "object" || vars === null) {
-        throw new Error("pi() requires actor vars to be an object");
-    }
-    return Object.assign(vars, { [PI_RUNTIME]: runtime });
-}
-function assertNoReservedKeys(kind, custom, builtIns) {
-    for (const key of Object.keys(custom ?? {})) {
-        if (key in builtIns) {
-            throw new Error(`pi() ${kind} name is reserved: ${key}`);
-        }
-    }
-}
 //# sourceMappingURL=actor.js.map

package/dist/actor.js.map

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

package/dist/credentials.d.ts

@@ -35,14 +35,13 @@ 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.
+ * reads only providers the source lists, asks the source each time Pi needs a
+ * credential, so logins and logouts apply to the next model call, and never
+ * writes.
  */
 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;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEhF,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;IAgBjE;;;OAGG;IACG,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,GAC1E,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAkB9B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/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,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;;;;;GAKG;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;IAMjE;;;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,61 +2,34 @@
 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.
+ * reads only providers the source lists, asks the source each time Pi needs a
+ * credential, so logins and logouts apply to the next model call, and never
+ * writes.
  */
 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;;;;;GAKG;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,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC;YACxE,OAAO,SAAS,CAAC;QAClB,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/drain.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fifteen minutes, so a running model call or tool call can finish before a
+ * an upgrade restarts the actor. The engine's stop threshold still bounds it.
+ */
+export declare const DEFAULT_SLEEP_GRACE_PERIOD_MS: number;
+/**
+ * The time a drain must end by. RivetKit's grace deadline starts when the
+ * stop starts, just before `onSleep` runs, so the caller takes this before the
+ * app's own `onSleep`.
+ */
+export declare function drainDeadline(gracePeriodMs: number): number;
+//# sourceMappingURL=drain.d.ts.map

package/dist/drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../src/drain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAQzD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/drain.js

@@ -0,0 +1,20 @@
+/**
+ * Fifteen minutes, so a running model call or tool call can finish before a
+ * an upgrade restarts the actor. The engine's stop threshold still bounds it.
+ */
+export const DEFAULT_SLEEP_GRACE_PERIOD_MS = 15 * 60_000;
+/**
+ * Time kept back from the grace period for closing Pi and suspending the
+ * sandbox after a drain, so both finish before RivetKit's grace deadline.
+ */
+const MAX_CLOSE_RESERVE_MS = 30_000;
+/**
+ * The time a drain must end by. RivetKit's grace deadline starts when the
+ * stop starts, just before `onSleep` runs, so the caller takes this before the
+ * app's own `onSleep`.
+ */
+export function drainDeadline(gracePeriodMs) {
+    const closeReserve = Math.min(MAX_CLOSE_RESERVE_MS, gracePeriodMs / 4);
+    return Date.now() + gracePeriodMs - closeReserve;
+}
+//# sourceMappingURL=drain.js.map

package/dist/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../src/drain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,MAAM,CAAC;AAEzD;;;GAGG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,YAAY,CAAC;AAClD,CAAC"}

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"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The error a client receives for a failed Pi Durable call. `ConversationBusy`
+ * is the one Pi error a caller is meant to handle, so it becomes a
+ * `UserError` with Pi's error name as the code. Every other error is returned
+ * as is, and RivetKit reports it to clients as an internal error.
+ */
+export declare function toClientError(error: unknown): unknown;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASrD"}

package/dist/errors.js

@@ -0,0 +1,19 @@
+import { ConversationBusy } from "@earendil-works/pi-durable";
+import { UserError } from "rivetkit";
+/**
+ * The error a client receives for a failed Pi Durable call. `ConversationBusy`
+ * is the one Pi error a caller is meant to handle, so it becomes a
+ * `UserError` with Pi's error name as the code. Every other error is returned
+ * as is, and RivetKit reports it to clients as an internal error.
+ */
+export function toClientError(error) {
+    if (error instanceof ConversationBusy) {
+        return new UserError(error.message, {
+            code: error.name,
+            metadata: { conversationId: error.conversationId },
+            cause: error,
+        });
+    }
+    return error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;QACvC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;YAClD,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export type { PiActions, PiBashResult, PiPromptOptions, PiSessionInfo, } from "./actions.js";
-export { pi, type PiActorConfigInput, type PiEvents } from "./actor.js";
+export type { PiActions, PiAgentChange, PiAgentInfo, PiCreateConversationOptions, PiPromptOptions, PiPromptResult, } from "./actions.js";
+export { type PiAccess, type PiActorConfigInput, type PiEvents, type PiUserActions, pi, } from "./actor.js";
 export type { PiCredentialInfo, PiCredentialSource, PiProviderCredential, } from "./credentials.js";
-export type { PiModelInfo, PiModelOptions, PiProviderConfig, } from "./models.js";
-export type { PiSessionOptions } from "./runtime.js";
+export type { PiModelOptions, PiProviderConfig } from "./models.js";
+export type { PiOptions } from "./runtime.js";
+export type { PiDocFrame, PiEventsFrame, PiTaskGraphFrame, PiViewFrame, PiWatchEvents, } from "./watches.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,aAAa,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,EAAE,EAAE,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,2BAA2B,EAC3B,eAAe,EACf,cAAc,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,EAAE,GACF,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { pi } from "./actor.js";
+export { pi, } from "./actor.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,EAAE,EAA0C,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAKN,EAAE,GACF,MAAM,YAAY,CAAC"}