@rivet-dev/pi 0.1.0 → 0.5.0

package/dist/durable/actions.js

@@ -0,0 +1,289 @@
+import { UserError } from "rivetkit";
+import { assertModelAllowed } from "../models.js";
+import { traceDurableRun } from "../tracing.js";
+import { documentsByKind, piDurableRuntime, withHarness, } from "./runtime.js";
+import { unwatch, watch } from "./watches.js";
+/**
+ * The `piDurable()` actions: Pi Durable's `Harness`, `Conversation`, and
+ * `Submission` methods under `harness`, `conversation`, and `submission`, with
+ * the same names. Ids replace objects, and conversation methods take the
+ * conversation id first. `prompt` is the one convenience action.
+ */
+export function createPiDurableActions(options) {
+    const documents = documentsByKind(options);
+    const run = (c, body) => withHarness(c, options, body);
+    const agentChange = (change) => change === undefined ? undefined : resolveAgentChange(options, change);
+    /**
+     * Starts a watch for the calling connection. Frames go to that connection
+     * only. `T` is the starting value `start` in `watches.ts` returns for the
+     * kind in `spec`; each action below names it.
+     */
+    const watchFor = (c, spec) => run(c, async (harness, context) => {
+        const connId = connectionId(c);
+        const runtime = piDurableRuntime(c);
+        return (await watch(runtime.actor ?? c, runtime.watches, harness, documents, connId, spec, () => requireWatchTarget(harness, spec, context)));
+    });
+    const unwatchFor = (c, spec) => run(c, async () => {
+        const runtime = piDurableRuntime(c);
+        await unwatch(runtime.actor ?? c, runtime.watches, connectionId(c), spec);
+    });
+    const requireWatchTarget = async (harness, spec, context) => {
+        if (spec.kind === "doc")
+            requireDocument(spec.docKind);
+        if (spec.kind !== "taskGraph")
+            await requireConversation(harness, spec.conversationId, context);
+    };
+    const requireDocument = (kind) => {
+        const doc = documents.get(kind);
+        if (!doc) {
+            throw new UserError(`Document ${kind} is not listed in piDurable({ documents }).`);
+        }
+        return doc;
+    };
+    // Ids arrive as plain numbers and are cast to Pi's branded id types. Pi's
+    // lookups check that each one exists, and a missing one is a `UserError`.
+    return {
+        harness: {
+            root: (c, rootOptions) => run(c, async (harness, context) => ({
+                id: (await harness.root(context, {
+                    agent: agentChange(rootOptions?.agent),
+                })).id,
+            })),
+            conversation: (c, id) => run(c, (harness, context) => harness.commit((tx) => tx.conversation(id), context)),
+            createConversation: (c, create) => run(c, async (harness, context) => ({
+                id: (await harness.createConversation({ ownership: create.ownership, agent: agentChange(create.agent) }, context)).id,
+            })),
+            submission: (c, id) => run(c, async (harness, context) => (await harness.submission(id, context))?.status(context)),
+            abortSubmission: (c, id, conversationId) => run(c, async (harness, context) => {
+                const result = await harness.abortSubmission(id, context, conversationId);
+                if (result === "not_found")
+                    throw submissionNotFound(id);
+                return result;
+            }),
+            getTask: (c, id) => run(c, (harness, context) => harness.getTask(id, context)),
+            abortTask: (c, id) => run(c, async (harness, context) => {
+                await requireTask(harness, id, context);
+                return harness.abortTask(id, context);
+            }),
+            waitForTask: (c, id) => run(c, async (harness, context) => {
+                await requireTask(harness, id, context);
+                return harness.waitForTask(id, context);
+            }),
+            waitForIdle: (c) => run(c, (harness, context) => harness.waitForIdle(context)),
+            inspect: (c) => run(c, async (harness, context) => {
+                const inspection = await harness.inspect(context);
+                return {
+                    ...inspection,
+                    // A migration failure carries an Error, which does not cross the wire.
+                    tasks: inspection.tasks.map((task) => task.state.kind === "blocked" && task.state.error !== undefined
+                        ? {
+                            ...task,
+                            state: {
+                                ...task.state,
+                                error: errorMessage(task.state.error),
+                            },
+                        }
+                        : task),
+                };
+            }),
+            usage: (c) => run(c, (harness, context) => harness.usage(context)),
+            taskGraph: (c) => run(c, async (harness, context) => {
+                const graph = await harness.taskGraph(context);
+                try {
+                    return graph.value;
+                }
+                finally {
+                    graph.dispose();
+                }
+            }),
+            snapshot: (c, kind, conversationId) => run(c, async (harness, context) => harness.snapshot(requireDocument(kind), conversationId, context)),
+            /** The task graph; then `pi.taskGraph` frames to this connection. */
+            watchTaskGraph: (c) => watchFor(c, { kind: "taskGraph" }),
+            unwatchTaskGraph: (c) => unwatchFor(c, { kind: "taskGraph" }),
+            /**
+             * The document's value; then `pi.doc` frames to this connection. A
+             * document that does not exist yet has value `undefined`, and its
+             * first frame arrives when a commit creates it.
+             */
+            watchDoc: (c, kind, conversationId) => watchFor(c, {
+                kind: "doc",
+                docKind: kind,
+                conversationId,
+            }),
+            unwatchDoc: (c, kind, conversationId) => unwatchFor(c, { kind: "doc", docKind: kind, conversationId }),
+        },
+        conversation: {
+            agent: (c, conversationId) => run(c, async (harness, context) => agentInfo(await (await requireConversation(harness, conversationId, context)).agent(context))),
+            configure: (c, conversationId, change) => run(c, async (harness, context) => {
+                const resolved = resolveAgentChange(options, change);
+                await (await requireConversation(harness, conversationId, context)).configure(resolved, context);
+            }),
+            submit: (c, conversationId, draft) => run(c, async (harness, context) => (await (await requireConversation(harness, conversationId, context)).submit(draft, context)).status(context)),
+            reset: (c, conversationId, handoff) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).reset(handoff, context)),
+            compact: (c, conversationId, instructions) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).compact(instructions, context)),
+            context: (c, conversationId) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).context(context)),
+            entries: (c, conversationId, query, limit, cursor) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).entries(query, limit, cursor, context)),
+            fork: (c, conversationId, at, fork) => run(c, async (harness, context) => {
+                const conversation = await requireConversation(harness, conversationId, context);
+                const forked = await conversation.fork(at, { ownership: fork.ownership, agent: agentChange(fork.agent) }, context);
+                return { id: forked.id };
+            }),
+            abort: (c, conversationId, abortOptions) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).abort(context, abortOptions)),
+            waitForIdle: (c, conversationId) => run(c, async (harness, context) => (await requireConversation(harness, conversationId, context)).waitForIdle(context)),
+            /** The structural view; then `pi.view` frames with Chord operations to this connection. */
+            watch: (c, conversationId) => watchFor(c, {
+                kind: "view",
+                conversationId,
+            }),
+            unwatch: (c, conversationId) => unwatchFor(c, { kind: "view", conversationId }),
+            /** A snapshot, partial answer included; then `pi.events` batches to this connection. Nothing is replayed. */
+            watchEvents: (c, conversationId) => watchFor(c, {
+                kind: "events",
+                conversationId,
+            }),
+            unwatchEvents: (c, conversationId) => unwatchFor(c, { kind: "events", conversationId }),
+        },
+        submission: {
+            status: (c, id) => run(c, async (harness, context) => (await requireSubmission(harness, id, context)).status(context)),
+            wait: (c, id) => run(c, async (harness, context) => (await requireSubmission(harness, id, context)).wait(context)),
+            abort: (c, id) => run(c, async (harness, context) => (await requireSubmission(harness, id, context)).abort(context)),
+        },
+        /**
+         * Submits user input, waits for the run to settle, and returns the
+         * answer's text. A model error does not reject: the status is
+         * `unanswered` with Pi's reason.
+         */
+        prompt: (c, content, promptOptions) => run(c, async (harness, context) => {
+            const conversation = promptOptions?.conversationId === undefined
+                ? await harness.root(context)
+                : await requireConversation(harness, promptOptions.conversationId, context);
+            const submission = await conversation.submit({
+                type: "input",
+                content,
+                requestId: promptOptions?.requestId,
+                whenBusy: promptOptions?.whenBusy,
+            }, context);
+            const model = (await conversation.agent(context)).model;
+            const settled = await traceDurableRun(c.actorId, conversation.id, model && `${model.provider}/${model.modelId}`, () => submission.wait(context));
+            if (settled.status === "unanswered") {
+                return {
+                    status: settled.status,
+                    reason: settled.reason,
+                    submissionId: submission.id,
+                };
+            }
+            return {
+                status: settled.status,
+                text: settled.type === "input"
+                    ? await answerText(conversation, settled.answer, context)
+                    : undefined,
+                submissionId: submission.id,
+            };
+        }),
+        pi: {
+            /** Scheduled at the end of a long wait. Opening the harness resumes the waiting work. */
+            wake: (c) => run(c, async () => { }),
+        },
+    };
+}
+/**
+ * The calling connection, which receives the watch's frames. A stateless call
+ * gets the starting value, and its watch ends with the request. Only a call
+ * with no connection at all, such as a scheduled action, cannot watch.
+ */
+function connectionId(c) {
+    const conn = c.conn;
+    if (!conn) {
+        throw new UserError("Watching needs a calling connection. Call it from a client handle, and use connect() to receive frames.");
+    }
+    return conn.id;
+}
+async function requireConversation(harness, id, context) {
+    const conversation = await harness.conversation(id, context);
+    if (!conversation) {
+        throw new UserError(`Conversation ${id} does not exist.`);
+    }
+    return conversation;
+}
+async function requireSubmission(harness, id, context) {
+    const submission = await harness.submission(id, context);
+    if (!submission)
+        throw submissionNotFound(id);
+    return submission;
+}
+function submissionNotFound(id) {
+    return new UserError(`Submission ${id} does not exist.`);
+}
+async function requireTask(harness, id, context) {
+    if (!(await harness.getTask(id, context))) {
+        throw new UserError(`Task ${id} does not exist.`);
+    }
+}
+/**
+ * Resolves extension and tool names against the installed registry. A model
+ * outside `scopedModels`, or other than `model` when `scopedModels` is unset,
+ * is rejected.
+ */
+function resolveAgentChange(options, change) {
+    const snapshot = options.registry.snapshot();
+    const extension = (name) => {
+        const found = snapshot.extension(name);
+        if (!found)
+            throw new UserError(`Extension ${name} is not installed.`);
+        return found;
+    };
+    const tool = (name) => {
+        const found = snapshot.tools().find((entry) => entry.tool.name === name);
+        if (!found)
+            throw new UserError(`Tool ${name} is not installed.`);
+        return found.tool;
+    };
+    if (change.model) {
+        assertModelAllowed(options, change.model.provider, change.model.modelId);
+    }
+    const { extensions, tools, ...rest } = change;
+    return {
+        ...rest,
+        extensions: extensions === undefined || extensions === null
+            ? extensions
+            : isNameList(extensions)
+                ? extensions.map(extension)
+                : {
+                    add: extensions.add?.map(extension),
+                    remove: extensions.remove?.map(extension),
+                },
+        tools: tools === undefined || tools === null
+            ? tools
+            : isNameList(tools)
+                ? tools.map(tool)
+                : { remove: tools.remove.map(tool) },
+    };
+}
+function isNameList(value) {
+    return Array.isArray(value);
+}
+function agentInfo(agent) {
+    return {
+        model: agent.model,
+        thinkingLevel: agent.thinkingLevel,
+        extensions: agent.extensions.map((extension) => extension.name),
+        tools: agent.tools.map((tool) => tool.name),
+        sections: agent.sections.map((section) => section.key),
+        instructions: agent.instructions,
+        cwd: agent.cwd,
+    };
+}
+/** The text blocks of the answer entry, which holds the assistant message. */
+async function answerText(conversation, answer, context) {
+    const page = await conversation.entries({ minEntryId: answer, maxEntryId: answer }, 1, undefined, context);
+    const message = page.items[0]?.model?.[0];
+    if (message?.role !== "assistant")
+        return undefined;
+    return message.content
+        .map((block) => (block.type === "text" ? block.text : ""))
+        .join("");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=actions.js.map

package/dist/durable/actions.js.map

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

package/dist/durable/actor-sqlite.d.ts

@@ -0,0 +1,10 @@
+import type { SqliteDatabase } from "@earendil-works/pi-durable/storage/sqlite";
+import type { RawAccess } from "rivetkit/db";
+/**
+ * Pi Durable's `SqliteDatabase` over the actor's SQLite database.
+ *
+ * The actor owns the database, so `close` does nothing. Pi Durable calls it from
+ * `storage.close()`, and the actor closes the database itself when it stops.
+ */
+export declare function actorSqlite(db: RawAccess): SqliteDatabase;
+//# sourceMappingURL=actor-sqlite.d.ts.map

package/dist/durable/actor-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-sqlite.d.ts","sourceRoot":"","sources":["../../src/durable/actor-sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,cAAc,CASzD"}

package/dist/durable/actor-sqlite.js

@@ -0,0 +1,32 @@
+/**
+ * Pi Durable's `SqliteDatabase` over the actor's SQLite database.
+ *
+ * The actor owns the database, so `close` does nothing. Pi Durable calls it from
+ * `storage.close()`, and the actor closes the database itself when it stops.
+ */
+export function actorSqlite(db) {
+    return {
+        ...actorSqliteExecutor(db),
+        transaction: (callback) => db.transaction((tx) => callback(actorSqliteExecutor(tx)), {
+            name: "pi-durable",
+        }),
+        close: async () => { },
+    };
+}
+/**
+ * Pi Durable names the row type of each query it sends. SQLite returns plain
+ * rows, so `get` and `all` take Pi's word for their shape.
+ */
+function actorSqliteExecutor(db) {
+    return {
+        exec: async (sql) => {
+            await db.execute(sql);
+        },
+        run: async (sql, ...params) => {
+            await db.execute(sql, ...params);
+        },
+        get: async (sql, ...params) => (await db.execute(sql, ...params)).at(0),
+        all: async (sql, ...params) => (await db.execute(sql, ...params)),
+    };
+}
+//# sourceMappingURL=actor-sqlite.js.map

package/dist/durable/actor-sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-sqlite.js","sourceRoot":"","sources":["../../src/durable/actor-sqlite.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,EAAa;IACxC,OAAO;QACN,GAAG,mBAAmB,CAAC,EAAE,CAAC;QAC1B,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CACzB,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE;YACzD,IAAI,EAAE,YAAY;SAClB,CAAC;QACH,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,EAA8B;IAC1D,OAAO;QACN,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE;YAC7B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,GAAG,EAAE,KAAK,EAAoB,GAAW,EAAE,GAAG,MAAqB,EAAE,EAAE,CACrE,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,GAAG,EAAE,KAAK,EAAoB,GAAW,EAAE,GAAG,MAAqB,EAAE,EAAE,CACtE,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAQ;KAC1C,CAAC;AACH,CAAC"}

package/dist/durable/actor.d.ts

@@ -0,0 +1,36 @@
+import type { Harness } from "@earendil-works/pi-durable";
+import { type EventSchemaConfig, type QueueSchemaConfig, type Type } from "rivetkit";
+import type { PiActorDefinition, UserActions, UserActorConfig } from "../actor-types.js";
+import { type PiDurableActions } from "./actions.js";
+import { type PiDurableOptions } 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 PiDurableEvents = {
+    "pi.events": Type<PiEventsFrame>;
+    "pi.view": Type<PiViewFrame>;
+    "pi.taskGraph": Type<PiTaskGraphFrame>;
+    "pi.doc": Type<PiDocFrame>;
+};
+/**
+ * `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 PiDurableAccess {
+    readonly pi: Harness;
+}
+/** The app's own actions, which get `c.pi`. Nested objects become dotted action names. */
+export type PiDurableUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = UserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, PiDurableAccess>;
+/** Ordinary actor config plus the Pi Durable options. The app's actions and lifecycle hooks get `c.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 PiDurableUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = Record<never, never>> = UserActorConfig<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiDurableOptions, PiDurableAccess>;
+/**
+ * Defines a Rivet Actor that owns one Pi Durable harness.
+ *
+ * Pi Durable stores conversations, tasks, and documents in the actor's SQLite
+ * database. Runs survive sleep, deploys, 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 piDurable<TState, TConnParams, TConnState, TVars, TInput, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TUserActions extends PiDurableUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues> = PiDurableUserActions<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues>>(config: PiDurableActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions>): PiActorDefinition<TState, TConnParams, TConnState, TVars, TInput, TEvents, TQueues, TUserActions, PiDurableEvents, PiDurableActions>;
+//# sourceMappingURL=actor.d.ts.map

package/dist/durable/actor.d.ts.map

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

package/dist/durable/actor.js

@@ -0,0 +1,107 @@
+import { actor, event, } from "rivetkit";
+import { db } from "rivetkit/db";
+import { assertNoReservedNames, sharedActorConfig, splitConfig, wrapActions, } from "../actor-config.js";
+import { withUnavailablePi } from "../runtime.js";
+import { createPiDurableActions } from "./actions.js";
+import { closeHarness, createPiDurableRuntime, openOnWake, PI_DURABLE_RUNTIME, piDurableRuntime, withPiAccess, } from "./runtime.js";
+import { migratePiDurableTables } from "./storage.js";
+import { unwatchConnection, } from "./watches.js";
+const piDurableEvents = {
+    "pi.events": event(),
+    "pi.view": event(),
+    "pi.taskGraph": event(),
+    "pi.doc": event(),
+};
+const piDurableOptionKeys = [
+    "registry",
+    "models",
+    "settings",
+    "env",
+    "conversationCreated",
+    "now",
+    "onReport",
+    "model",
+    "thinkingLevel",
+    "scopedModels",
+    "providers",
+    "apiKeys",
+    "credentials",
+    "sandbox",
+    "documents",
+];
+/**
+ * Defines a Rivet Actor that owns one Pi Durable harness.
+ *
+ * Pi Durable stores conversations, tasks, and documents in the actor's SQLite
+ * database. Runs survive sleep, deploys, 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 piDurable(config) {
+    const { actorConfig, options: durableOptions } = splitConfig(config, piDurableOptionKeys);
+    if (!durableOptions.registry) {
+        throw new Error("piDurable() needs a registry; pass createRegistry() from @earendil-works/pi-durable");
+    }
+    if (actorConfig.db !== undefined) {
+        throw new Error("piDurable() owns the actor database; remove the db option");
+    }
+    const actions = createPiDurableActions(durableOptions);
+    assertNoReservedNames("piDurable()", actorConfig, {
+        action: actions,
+        event: piDurableEvents,
+    });
+    const withPi = (hook, opensHarness = true) => hook &&
+        ((c, ...args) => withPiAccess(c, durableOptions, () => 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({
+        ...sharedActorConfig("piDurable()", actorConfig, { slot: PI_DURABLE_RUNTIME, create: createPiDurableRuntime }, (c, stop) => closeHarness(c, durableOptions, stop), {
+            onSleep: withPi(actorConfig.onSleep, false),
+            onDestroy: withPi(actorConfig.onDestroy, false),
+        }),
+        db: db({ onMigrate: migratePiDurableTables }),
+        events: { ...(actorConfig.events ?? {}), ...piDurableEvents },
+        actions: {
+            ...wrapActions(actorConfig.actions ?? {}, (c, action) => withPiAccess(c, durableOptions, action)),
+            ...actions,
+        },
+        // Opening on wake resumes interrupted work, after the app's own onWake.
+        onWake: async (c) => {
+            let harness;
+            try {
+                harness = await openOnWake(c, durableOptions);
+            }
+            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 {
+                harness.resume();
+            }
+        },
+        onConnect: withPi(actorConfig.onConnect),
+        onDisconnect: async (c, conn) => {
+            try {
+                await userOnDisconnect?.(c, conn);
+            }
+            finally {
+                const runtime = piDurableRuntime(c);
+                await unwatchConnection(runtime.actor ?? c, runtime.watches, conn.id);
+            }
+        },
+    });
+}
+//# sourceMappingURL=actor.js.map

package/dist/durable/actor.js.map

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

package/dist/durable/env.d.ts

@@ -0,0 +1,13 @@
+import { type ExecutionEnv } from "@earendil-works/pi-durable/env";
+import type { Sandbox } from "@rivet-dev/sandbox-adapter";
+/**
+ * Pi Durable's `ExecutionEnv` inside a sandbox, for Pi's built-in tools
+ * (`CodingTools`). Paths outside the sandbox `cwd` are rejected, and commands
+ * never receive the actor host's environment variables.
+ *
+ * Only the operations Pi's tools use are supported. Every other operation
+ * returns a `not_supported` error. Operations return failures instead of
+ * throwing. Building the environment throws when `cwd` is outside the sandbox.
+ */
+export declare function sandboxEnv(id: string, sandbox: Sandbox, cwd: string | undefined): ExecutionEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/durable/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/durable/env.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,YAAY,EAWjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GAAG,SAAS,GACrB,YAAY,CA8Ed"}