@jpowersdev/effect-pi 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0 — 2026-09-21
+
+- Scoped direct, local-pool, and cluster-backed Pi sessions with authoritative KeyValueStore JSONL.
+- First-class ResourceLoader and ModelRuntime layers, typed SDK setup failures, and per-session isolation of resources, settings, and model runtimes. Session construction now requires ModelRuntime; SDK configuration callbacks no longer own these bindings.
+- Config-driven layer constructors for resources, model runtimes, local pools, and cluster runners; standalone examples compose top-level layers with lazy ConfigProvider resolution.
+- Cancellation-safe SDK acquisition; session-owned prompt fibers settle before release or reuse.
+- Interruptible cluster prompts, concurrent abort, and cancellation of queued prompts without aborting unrelated work.
+- Checkpoints on construction, completed/failed prompts, abort, and release; release checkpoint failures are surfaced.
+- Rejection of malformed JSON syntax and mismatched stored session identities.
+- Fresh-response detection, terminal model-error reporting, and prompt-wide recorded usage totals.
+- Bounded sliding event streams, coalesced checkpoint requests, and SDK diagnostic logging.
+- Isolated regression tests and self-contained session, pool, and single-process socket-cluster examples using SQLite.
+- Exact Effect peer dependency, source-map sources in the tarball, and MIT licensing.

package/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing and releasing
+
+This is a small experimental library. Bug reports and focused changes are welcome; discuss API expansion before investing in it. There is no promised support schedule.
+
+Use Node 26 and the pnpm version in `package.json`. Nix/direnv is optional. The Linux development shell downloads/refreshes a read-only Effect checkout in `.vendor/`; installed dependencies remain authoritative.
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm test
+pnpm pack --pack-destination /tmp/effect-pi-pack
+```
+
+`check` covers source, tests, and examples. `pack` starts with a clean build and runs checks/tests. Test fixtures must not load a contributor's Pi credentials, extensions, or working files. Normal tests never make model requests.
+
+## Design boundaries
+
+- Keep public exports under `src/index.ts`: `ResourceLoader`, `ModelRuntime`, `Session`, `Sessions`, `LocalSessions`, `ClusterSessions`.
+- `ModelRuntime` captures `ResourceLoader`. Reuse configuration layers while allocating mutable SDK bindings per live session; keep Promise adapters inside the library.
+- Pi owns JSONL formats/migrations/tree semantics. The configured `KeyValueStore` owns the durable document.
+- One live session serializes prompts; cancellation, snapshots, and event subscriptions must remain concurrent.
+- Prompt cancellation must settle the underlying SDK operation before the gate or resource is released.
+- Do not persist model prompt RPCs without a real idempotency protocol.
+- Live events are bounded and ephemeral, not another durable conversation log.
+- Keep examples self-contained, even when that repeats setup. The cluster example owns both the runner and client in one process.
+- Define reusable layers at module scope. Use `layerConfig` for config-driven options and reserve `Layer.unwrap` for construction that needs yielded values/services. Keep application Effects focused on consuming services.
+
+See `AGENTS.md` and `EFFECT.md` for implementation guidance. Where the SDK offers no cancellation API, document the protected acquisition/cleanup boundary rather than pretending interruption can force it to stop.
+
+## Release checklist
+
+1. Review changes and update `CHANGELOG.md` and the package version.
+2. Keep Effect and all `@effect/*` versions aligned and update the lockfile together; review Pi changes together with the SDK-boundary tests.
+3. Run a frozen install, checks, tests, and `pnpm pack`.
+4. Inspect the tarball: public exports, license, source maps, example assets, and no private/runtime data.
+5. Install the tarball in a fresh consumer; typecheck an import and run the compiled `--snapshot` examples with their optional dependencies. See `examples/README.md`.
+6. If Git history is available, scan it for secrets before making the repository public. Never include real credentials or transcripts in fixtures/issues.
+7. Review API/known-limitations documentation, then publish the reviewed tarball from the intended npm account. Use npm 2FA or trusted publishing; add provenance when the release environment supports it.
+
+CI checks build/test/package creation and exercises the self-contained session, pool, and single-process socket-cluster examples without model requests. Production network partitions, forced process loss, and paid provider behavior still require separate integration validation.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jpowersdev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# effect-pi
+
+Use the [Pi coding agent](https://github.com/earendil-works/pi) in an [Effect](https://effect.website) application.
+
+effect-pi wraps Pi's SDK so you can send prompts, follow responses as they arrive, and pick up saved conversations later. It handles session cleanup and makes sure prompts for the same session run one at a time.
+
+Start with sessions running in your own process. If you later want to run them on separate workers, switch to Effect Cluster—the code that uses a session stays the same.
+
+This is a small, experimental project for personal use. The API may change.
+
+## What using it looks like
+
+Once you've set up a `Sessions` layer, your application code looks like this:
+
+```ts
+import * as Console from "effect/Console"
+import * as Effect from "effect/Effect"
+
+import { Session, Sessions } from "@jpowersdev/effect-pi"
+
+export const program = Effect.gen(function* () {
+  const sessions = yield* Sessions
+
+  const id = Session.Id.make("my-project")
+
+  const session = yield* sessions.open(id)
+
+  const reply = yield* session.prompt("Explain how this project is organized")
+
+  yield* Console.log(reply.text)
+}).pipe(Effect.scoped)
+```
+
+Use the same id and storage to continue the conversation later. You can also listen to `session.events`, check progress with `session.snapshot`, or stop the current prompt with `session.abort`.
+
+Model and resource setup are Effect layers too: `ResourceLoader` feeds `ModelRuntime`, which sessions consume. Define and compose them at module scope; `layerConfig` reads configuration when they're built. The library handles Pi's asynchronous setup and errors—you don't need to write Promise adapters.
+
+The [complete local example](examples/local-session-pool.ts) shows how to provide these layers and storage around this code.
+
+## Try it
+
+You'll need **Node.js 26+**, pnpm, and a model provider's credentials to send prompts.
+
+```sh
+pnpm install --frozen-lockfile
+pnpm build
+```
+
+Follow the [example setup](examples/README.md#setup) to create the data directory and configure a model and credentials, then run:
+
+```sh
+pnpm example:pool "Say hello in one sentence"
+```
+
+The examples use SQLite to save conversations and explicitly configure Pi rather than loading your usual extensions and settings.
+
+There are three ways to use the library:
+
+- **One session:** [`single-session.ts`](examples/single-session.ts) sends a prompt and saves the conversation.
+- **A pool of sessions:** [`local-session-pool.ts`](examples/local-session-pool.ts) opens a session, releases it, and reopens it in another request. This is the best place to start.
+- **Cluster-backed sessions:** [`cluster-session.ts`](examples/cluster-session.ts) starts a client and runner in one process, communicating over a local socket.
+
+Each example is self-contained, including its configuration and storage setup.
+
+For use in another project, see [installation and compatibility](docs/reference.md#installation-and-compatibility). The package is named `@jpowersdev/effect-pi` and currently uses Effect `4.0.0-rc.116` and Pi `0.86.1`.
+
+## A few things to know
+
+- **This isn't a sandbox.** Pi's tools and extensions run with your process's permissions. Even read-only tools can read outside the working directory, so use trusted workspaces and protect your credentials.
+- **Saved conversations can contain private data.** Choose storage and access controls accordingly. The examples don't encrypt their database.
+- **Stopping work doesn't undo it.** Cancellation waits for Pi and its tools to stop. A timeout or lost connection doesn't undo file changes or model charges, so don't blindly retry a prompt.
+
+Pi still handles the agent loop and its conversation format. This library adds the Effect integration; it doesn't try to replace Pi or provide a hosted agent service.
+
+The [reference guide](docs/reference.md) covers configuration, storage requirements, cancellation, and the limits of cluster execution.
+
+## Development
+
+```sh
+pnpm check
+pnpm test
+pnpm pack
+```
+
+Tests don't make paid model requests. `pnpm pack` runs a clean build, checks, and tests before producing the package. Nix/direnv is available but optional.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development and release notes, and [CHANGELOG.md](CHANGELOG.md) for changes.
+
+## License
+
+[MIT](LICENSE), the same license used by Effect.

package/dist/ClusterSessions.d.ts

@@ -0,0 +1,2 @@
+export { clientLayer, runnerLayer, runnerLayerConfig, type Options } from "./internal/ClusterSessions.js";
+//# sourceMappingURL=ClusterSessions.d.ts.map

package/dist/ClusterSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSessions.d.ts","sourceRoot":"","sources":["../src/ClusterSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,KAAK,OAAO,EACb,MAAM,+BAA+B,CAAA"}

package/dist/ClusterSessions.js

@@ -0,0 +1,2 @@
+export { clientLayer, runnerLayer, runnerLayerConfig } from "./internal/ClusterSessions.js";
+//# sourceMappingURL=ClusterSessions.js.map

package/dist/ClusterSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSessions.js","sourceRoot":"","sources":["../src/ClusterSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EAElB,MAAM,+BAA+B,CAAA"}

package/dist/LocalSessions.d.ts

@@ -0,0 +1,2 @@
+export { layer, layerConfig, type Options } from "./internal/LocalSessions.js";
+//# sourceMappingURL=LocalSessions.d.ts.map

package/dist/LocalSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessions.d.ts","sourceRoot":"","sources":["../src/LocalSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/LocalSessions.js

@@ -0,0 +1,2 @@
+export { layer, layerConfig } from "./internal/LocalSessions.js";
+//# sourceMappingURL=LocalSessions.js.map

package/dist/LocalSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessions.js","sourceRoot":"","sources":["../src/LocalSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAgB,MAAM,6BAA6B,CAAA"}

package/dist/ModelRuntime.d.ts

@@ -0,0 +1,2 @@
+export { type Binding, Error, layer, layerConfig, make, ModelRuntime, type Operations, type Options } from "./internal/ModelRuntime.js";
+//# sourceMappingURL=ModelRuntime.d.ts.map

package/dist/ModelRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRuntime.d.ts","sourceRoot":"","sources":["../src/ModelRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,EACL,KAAK,EACL,WAAW,EACX,IAAI,EACJ,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAA"}

package/dist/ModelRuntime.js

@@ -0,0 +1,2 @@
+export { Error, layer, layerConfig, make, ModelRuntime } from "./internal/ModelRuntime.js";
+//# sourceMappingURL=ModelRuntime.js.map

package/dist/ModelRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRuntime.js","sourceRoot":"","sources":["../src/ModelRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,KAAK,EACL,WAAW,EACX,IAAI,EACJ,YAAY,EAGb,MAAM,4BAA4B,CAAA"}

package/dist/ResourceLoader.d.ts

@@ -0,0 +1,2 @@
+export { Error, layer, layerConfig, layerEmpty, layerEmptyConfig, type EmptyOptions, type Loaded, type Operations, type Options, ResourceLoader, type Settings } from "./internal/ResourceLoader.js";
+//# sourceMappingURL=ResourceLoader.d.ts.map

package/dist/ResourceLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceLoader.d.ts","sourceRoot":"","sources":["../src/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,cAAc,EACd,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAA"}

package/dist/ResourceLoader.js

@@ -0,0 +1,2 @@
+export { Error, layer, layerConfig, layerEmpty, layerEmptyConfig, ResourceLoader } from "./internal/ResourceLoader.js";
+//# sourceMappingURL=ResourceLoader.js.map

package/dist/ResourceLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceLoader.js","sourceRoot":"","sources":["../src/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAKhB,cAAc,EAEf,MAAM,8BAA8B,CAAA"}

package/dist/Session.d.ts

@@ -0,0 +1,3 @@
+export { Error, Event, Id, type Config, type MakeOptions, type Operation, type PiOptions, PromptResult, type Session, Snapshot, Status } from "./internal/Session.js";
+export { make } from "./internal/Pi.js";
+//# sourceMappingURL=Session.d.ts.map

package/dist/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../src/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,EAAE,EACF,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,YAAY,EACZ,KAAK,OAAO,EACZ,QAAQ,EACR,MAAM,EACP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/Session.js

@@ -0,0 +1,3 @@
+export { Error, Event, Id, PromptResult, Snapshot, Status } from "./internal/Session.js";
+export { make } from "./internal/Pi.js";
+//# sourceMappingURL=Session.js.map

package/dist/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../src/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,EAAE,EAKF,YAAY,EAEZ,QAAQ,EACR,MAAM,EACP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/Sessions.d.ts

@@ -0,0 +1,14 @@
+import * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type * as Session from "./internal/Session.js";
+export interface Operations {
+    /** Acquire the session for an id within the current scope. */
+    readonly open: (id: Session.Id) => Effect.Effect<Session.Session, Session.Error, Scope.Scope>;
+}
+declare const Sessions_base: Context.ServiceClass<Sessions, "@jpowersdev/effect-pi/Sessions", Operations>;
+/** Location-independent access to keyed Pi sessions. */
+export declare class Sessions extends Sessions_base {
+}
+export {};
+//# sourceMappingURL=Sessions.d.ts.map

package/dist/Sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../src/Sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAA;AAErD,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,CACb,EAAE,EAAE,OAAO,CAAC,EAAE,KACX,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CAChE;;AAED,wDAAwD;AACxD,qBAAa,QAAS,SAAQ,aAE7B;CAAG"}

package/dist/Sessions.js

@@ -0,0 +1,5 @@
+import * as Context from "effect/Context";
+/** Location-independent access to keyed Pi sessions. */
+export class Sessions extends Context.Service()("@jpowersdev/effect-pi/Sessions") {
+}
+//# sourceMappingURL=Sessions.js.map

package/dist/Sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sessions.js","sourceRoot":"","sources":["../src/Sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAazC,wDAAwD;AACxD,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAAwB,CACnE,gCAAgC,CACjC;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * as ClusterSessions from "./ClusterSessions.js";
+export * as LocalSessions from "./LocalSessions.js";
+export * as ModelRuntime from "./ModelRuntime.js";
+export * as ResourceLoader from "./ResourceLoader.js";
+export * as Session from "./Session.js";
+export { Sessions } from "./Sessions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * as ClusterSessions from "./ClusterSessions.js";
+export * as LocalSessions from "./LocalSessions.js";
+export * as ModelRuntime from "./ModelRuntime.js";
+export * as ResourceLoader from "./ResourceLoader.js";
+export * as Session from "./Session.js";
+export { Sessions } from "./Sessions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/dist/internal/ClusterSessions.d.ts

@@ -0,0 +1,44 @@
+import * as Config from "effect/Config";
+import type * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import * as Entity from "effect/unstable/cluster/Entity";
+import type * as Sharding from "effect/unstable/cluster/Sharding";
+import { Sessions } from "../Sessions.js";
+import * as Session from "./Session.js";
+export interface Options extends Session.Config {
+    /** Idle live-resource lifetime; defaults to 15 minutes. */
+    readonly resourceIdleTimeToLive?: Duration.Input;
+    readonly entityMaxIdleTime?: Duration.Input;
+    /** Queued entity messages; does not limit all concurrently executing handlers. Defaults to 128. */
+    readonly mailboxCapacity?: number | "unbounded";
+}
+type MakeSession<R> = (options: Session.MakeOptions) => Effect.Effect<Session.Session, Session.Error, Scope.Scope | R>;
+/** Internal constructor seam used to test entity behavior without model calls. */
+export declare const runnerLayerWith: <R>(options: Options, makeSession: MakeSession<R>) => Layer.Layer<never, never, Sharding.Sharding | R>;
+/** Registers the server-side cluster entity handlers. */
+export declare const runnerLayer: (options: Options) => Layer.Layer<never, never, import("effect/FileSystem").FileSystem | import("effect/unstable/persistence/KeyValueStore").KeyValueStore | import("./ModelRuntime.js").ModelRuntime | import("effect/Path").Path | Sharding.Sharding>;
+/** Resolve runner options using the active ConfigProvider at layer build time. */
+export declare const runnerLayerConfig: (options: Config.Wrap<Options>) => Layer.Layer<never, Config.ConfigError, import("effect/FileSystem").FileSystem | import("effect/unstable/persistence/KeyValueStore").KeyValueStore | import("./ModelRuntime.js").ModelRuntime | import("effect/Path").Path | Sharding.Sharding>;
+/** Implements Sessions using location-transparent Effect Cluster clients. */
+export declare const clientLayer: Layer.Layer<Sessions, never, Sharding.Sharding>;
+export declare const entity: Entity.Entity<"PiSession", import("effect/unstable/rpc/Rpc").Rpc<"Abort", Schema.Void, Schema.Void, typeof Session.Error, never, never> | import("effect/unstable/rpc/Rpc").Rpc<"Events", Schema.Void, import("effect/unstable/rpc/RpcSchema").Stream<Schema.Union<readonly [Schema.TaggedStruct<"Status", {
+    readonly sequence: Schema.Natural;
+    readonly status: Schema.Literals<readonly ["idle", "streaming"]>;
+}>, Schema.TaggedStruct<"TextDelta", {
+    readonly sequence: Schema.Natural;
+    readonly delta: Schema.String;
+}>, Schema.TaggedStruct<"ToolStarted", {
+    readonly sequence: Schema.Natural;
+    readonly toolName: Schema.String;
+}>, Schema.TaggedStruct<"ToolFinished", {
+    readonly sequence: Schema.Natural;
+    readonly toolName: Schema.String;
+    readonly isError: Schema.Boolean;
+}>]>, typeof Session.Error>, Schema.Never, never, never> | import("effect/unstable/rpc/Rpc").Rpc<"Jsonl", Schema.Void, Schema.String, typeof Session.Error, never, never> | import("effect/unstable/rpc/Rpc").Rpc<"Prompt", Schema.Struct<{
+    text: Schema.NonEmptyString;
+}>, typeof Session.PromptResult, typeof Session.Error, never, never> | import("effect/unstable/rpc/Rpc").Rpc<"Snapshot", Schema.Void, typeof Session.Snapshot, typeof Session.Error, never, never>>;
+export {};
+//# sourceMappingURL=ClusterSessions.d.ts.map

package/dist/internal/ClusterSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSessions.d.ts","sourceRoot":"","sources":["../../src/internal/ClusterSessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,MAAM,MAAM,gCAAgC,CAAA;AAExD,OAAO,KAAK,KAAK,QAAQ,MAAM,kCAAkC,CAAA;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAGzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,WAAW,OAAQ,SAAQ,OAAO,CAAC,MAAM;IAC7C,2DAA2D;IAC3D,QAAQ,CAAC,sBAAsB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;IAC3C,mGAAmG;IACnG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAChD;AAED,KAAK,WAAW,CAAC,CAAC,IAAI,CACpB,OAAO,EAAE,OAAO,CAAC,WAAW,KACzB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;AAqBnE,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAI,CAAC,WACtB,OAAO,eACH,WAAW,CAAC,CAAC,CAAC,KAC1B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAkCjD,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,WAAW,YAAa,OAAO,sOAAsC,CAAA;AAElF,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,YAAa,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,mPACS,CAAA;AAExE,6EAA6E;AAC7E,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CA4BvE,CAAA;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;mMAAkB,CAAA"}

package/dist/internal/ClusterSessions.js

@@ -0,0 +1,72 @@
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as Entity from "effect/unstable/cluster/Entity";
+import * as EntityResource from "effect/unstable/cluster/EntityResource";
+import { Sessions } from "../Sessions.js";
+import * as Pi from "./Pi.js";
+import * as Protocol from "./Protocol.js";
+import * as Session from "./Session.js";
+const failureMessage = (cause) => {
+    if (typeof cause === "object" && cause !== null && "message" in cause) {
+        return String(cause.message);
+    }
+    return String(cause);
+};
+const transportError = (id, operation, cause) => cause instanceof Session.Error
+    ? cause
+    : new Session.Error({
+        sessionId: id,
+        operation,
+        message: failureMessage(cause)
+    });
+/** Internal constructor seam used to test entity behavior without model calls. */
+export const runnerLayerWith = (options, makeSession) => {
+    const handlers = Effect.gen(function* () {
+        const address = yield* Entity.CurrentAddress;
+        const id = yield* Schema.decodeUnknownEffect(Session.Id)(address.entityId).pipe(Effect.orDie);
+        const resource = yield* EntityResource.make({
+            acquire: makeSession({
+                id,
+                cwd: options.cwd,
+                ...(options.keyPrefix === undefined ? {} : { keyPrefix: options.keyPrefix }),
+                ...(options.configure === undefined ? {} : { configure: options.configure })
+            }),
+            idleTimeToLive: options.resourceIdleTimeToLive ?? "15 minutes"
+        }).pipe(Effect.orDie);
+        return Protocol.entity.of({
+            Snapshot: () => resource.get.pipe(Effect.flatMap((session) => session.snapshot)),
+            Prompt: (request) => resource.get.pipe(Effect.flatMap((session) => session.prompt(request.payload.text))),
+            Abort: () => resource.get.pipe(Effect.flatMap((session) => session.abort)),
+            Jsonl: () => resource.get.pipe(Effect.flatMap((session) => session.jsonl)),
+            Events: () => Stream.unwrap(resource.get.pipe(Effect.map((session) => session.events)))
+        });
+    });
+    return Protocol.entity.toLayer(handlers, {
+        concurrency: "unbounded",
+        mailboxCapacity: options.mailboxCapacity ?? 128,
+        maxIdleTime: options.entityMaxIdleTime ?? "20 minutes"
+    });
+};
+/** Registers the server-side cluster entity handlers. */
+export const runnerLayer = (options) => runnerLayerWith(options, Pi.make);
+/** Resolve runner options using the active ConfigProvider at layer build time. */
+export const runnerLayerConfig = (options) => Layer.unwrap(Effect.map(Config.unwrap(options), runnerLayer));
+/** Implements Sessions using location-transparent Effect Cluster clients. */
+export const clientLayer = Layer.effect(Sessions, Protocol.entity.client.pipe(Effect.map((makeClient) => Sessions.of({
+    open: (id) => Effect.succeed((() => {
+        const client = makeClient(id);
+        return {
+            id,
+            snapshot: client.Snapshot().pipe(Effect.mapError((cause) => transportError(id, "snapshot", cause))),
+            prompt: (text) => Schema.decodeUnknownEffect(Schema.NonEmptyString)(text).pipe(Effect.flatMap((text) => client.Prompt({ text })), Effect.mapError((cause) => transportError(id, "prompt", cause))),
+            abort: client.Abort().pipe(Effect.mapError((cause) => transportError(id, "abort", cause))),
+            events: client.Events().pipe(Stream.mapError((cause) => transportError(id, "events", cause))),
+            jsonl: client.Jsonl().pipe(Effect.mapError((cause) => transportError(id, "jsonl", cause)))
+        };
+    })())
+}))));
+export const entity = Protocol.entity;
+//# sourceMappingURL=ClusterSessions.js.map

package/dist/internal/ClusterSessions.js.map

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

package/dist/internal/LocalSessions.d.ts

@@ -0,0 +1,19 @@
+import * as Config from "effect/Config";
+import type * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type * as Scope from "effect/Scope";
+import { Sessions } from "../Sessions.js";
+import type * as Session from "./Session.js";
+export interface Options extends Session.Config {
+    /** How long an unreferenced live Pi session remains resident. */
+    readonly idleTimeToLive?: Duration.Input;
+}
+type MakeSession<R> = (options: Session.MakeOptions) => Effect.Effect<Session.Session, Session.Error, Scope.Scope | R>;
+/** Internal constructor seam used to verify pool behavior without model calls. */
+export declare const layerWith: <R>(options: Options, makeSession: MakeSession<R>) => Layer.Layer<Sessions, never, R>;
+export declare const layer: (options: Options) => Layer.Layer<Sessions, never, import("effect/FileSystem").FileSystem | import("effect/unstable/persistence/KeyValueStore").KeyValueStore | import("./ModelRuntime.js").ModelRuntime | import("effect/Path").Path>;
+/** Resolve pool options using the active ConfigProvider at layer build time. */
+export declare const layerConfig: (options: Config.Wrap<Options>) => Layer.Layer<Sessions, Config.ConfigError, import("effect/FileSystem").FileSystem | import("effect/unstable/persistence/KeyValueStore").KeyValueStore | import("./ModelRuntime.js").ModelRuntime | import("effect/Path").Path>;
+export {};
+//# sourceMappingURL=LocalSessions.d.ts.map

package/dist/internal/LocalSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessions.d.ts","sourceRoot":"","sources":["../../src/internal/LocalSessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAE5C,MAAM,WAAW,OAAQ,SAAQ,OAAO,CAAC,MAAM;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;CACzC;AAED,KAAK,WAAW,CAAC,CAAC,IAAI,CACpB,OAAO,EAAE,OAAO,CAAC,WAAW,KACzB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;AAEnE,kFAAkF;AAClF,eAAO,MAAM,SAAS,GAAI,CAAC,WAChB,OAAO,eACH,WAAW,CAAC,CAAC,CAAC,KAC1B,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAc9B,CAAA;AAEH,eAAO,MAAM,KAAK,YAAa,OAAO,qNAAgC,CAAA;AAEtE,gFAAgF;AAChF,eAAO,MAAM,WAAW,YAAa,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,kOACS,CAAA"}

package/dist/internal/LocalSessions.js

@@ -0,0 +1,25 @@
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as RcMap from "effect/RcMap";
+import { Sessions } from "../Sessions.js";
+import * as Pi from "./Pi.js";
+/** Internal constructor seam used to verify pool behavior without model calls. */
+export const layerWith = (options, makeSession) => Layer.effect(Sessions, Effect.gen(function* () {
+    const sessions = yield* RcMap.make({
+        lookup: (id) => makeSession({
+            id,
+            cwd: options.cwd,
+            ...(options.keyPrefix === undefined ? {} : { keyPrefix: options.keyPrefix }),
+            ...(options.configure === undefined ? {} : { configure: options.configure })
+        }),
+        idleTimeToLive: options.idleTimeToLive ?? "15 minutes"
+    });
+    return Sessions.of({
+        open: (id) => RcMap.get(sessions, id)
+    });
+}));
+export const layer = (options) => layerWith(options, Pi.make);
+/** Resolve pool options using the active ConfigProvider at layer build time. */
+export const layerConfig = (options) => Layer.unwrap(Effect.map(Config.unwrap(options), layer));
+//# sourceMappingURL=LocalSessions.js.map

package/dist/internal/LocalSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessions.js","sourceRoot":"","sources":["../../src/internal/LocalSessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAY7B,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,OAAgB,EAChB,WAA2B,EACM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC/E,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACjC,MAAM,EAAE,CAAC,EAAc,EAAE,EAAE,CAAC,WAAW,CAAC;YACtC,EAAE;YACF,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;SAC7E,CAAC;QACF,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,YAAY;KACvD,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,EAAE,CAAC;QACjB,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;KACtC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;AAEtE,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAA6B,EAAE,EAAE,CAC3D,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAU,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA"}

package/dist/internal/ModelRuntime.d.ts

@@ -0,0 +1,42 @@
+import * as Pi from "@earendil-works/pi-coding-agent";
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import * as ResourceLoader from "./ResourceLoader.js";
+export interface Options extends Omit<Pi.CreateModelRuntimeOptions, "signal"> {
+    /** Omit to let Pi restore/select the model using the session and settings. */
+    readonly model?: {
+        readonly provider: string;
+        readonly id: string;
+    };
+    /** Runtime-only overrides. Keys are never persisted to auth.json. */
+    readonly apiKeys?: Readonly<Record<string, Redacted.Redacted<string>>>;
+}
+declare const Error_base: Schema.Class<Error, Schema.TaggedStruct<"ModelRuntimeError", {
+    readonly operation: Schema.Literals<readonly ["create", "providers", "credentials", "model"]>;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class Error extends Error_base {
+}
+/** SDK interoperability values; never share one binding between live sessions. */
+export interface Binding extends ResourceLoader.Loaded {
+    readonly modelRuntime: Pi.ModelRuntime;
+    readonly model?: NonNullable<Pi.CreateAgentSessionOptions["model"]>;
+}
+export interface Operations {
+    readonly sessionOptions: (cwd: string) => Effect.Effect<Binding, Error | ResourceLoader.Error, Scope.Scope>;
+}
+declare const ModelRuntime_base: Context.ServiceClass<ModelRuntime, "@jpowersdev/effect-pi/ModelRuntime", Operations>;
+export declare class ModelRuntime extends ModelRuntime_base {
+}
+/** Capture the loading policy; SDK objects are owned by each live session's scope. */
+export declare const make: (options?: Options | undefined) => Effect.Effect<Operations, never, ResourceLoader.ResourceLoader>;
+export declare const layer: (options?: Options) => Layer.Layer<ModelRuntime, never, ResourceLoader.ResourceLoader>;
+/** Resolve configuration when the layer is built, using the active ConfigProvider. */
+export declare const layerConfig: (options: Config.Wrap<Options>) => Layer.Layer<ModelRuntime, Config.ConfigError, ResourceLoader.ResourceLoader>;
+export {};
+//# sourceMappingURL=ModelRuntime.d.ts.map

package/dist/internal/ModelRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRuntime.d.ts","sourceRoot":"","sources":["../../src/internal/ModelRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,iCAAiC,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD,MAAM,WAAW,OAAQ,SAAQ,IAAI,CAAC,EAAE,CAAC,yBAAyB,EAAE,QAAQ,CAAC;IAC3E,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAEnE,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CACvE;;;;;AAED,qBAAa,KAAM,SAAQ,UAGzB;CAAG;AAEL,kFAAkF;AAClF,MAAM,WAAW,OAAQ,SAAQ,cAAc,CAAC,MAAM;IACpD,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAA;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAA;CACpE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,CACvB,GAAG,EAAE,MAAM,KACR,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CACvE;;AAED,qBAAa,YAAa,SAAQ,iBAEjC;CAAG;AAEJ,sFAAsF;AACtF,eAAO,MAAM,IAAI,oGAwDf,CAAA;AAEF,eAAO,MAAM,KAAK,aAAa,OAAO,KAAQ,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,cAAc,CAAC,cAAc,CACjE,CAAA;AAE3C,sFAAsF;AACtF,eAAO,MAAM,WAAW,YAAa,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,iFACS,CAAA"}