clanka 0.1.1 → 0.1.2

package/dist/AgentExecutor.d.ts

@@ -1,8 +1,9 @@
 /**
  * @since 1.0.0
  */
-import { Effect, FileSystem, Layer, Option, Path, ServiceMap, Stream } from "effect";
+import { Effect, FileSystem, Layer, Option, Path, Schema, Scope, ServiceMap, Stream } from "effect";
 import { Tool, Toolkit } from "effect/unstable/ai";
+import { Rpc, RpcClient, RpcGroup, RpcServer } from "effect/unstable/rpc";
 import { CurrentDirectory, SubagentExecutor, TaskCompleter } from "./AgentTools.ts";
 import { ToolkitRenderer } from "./ToolkitRenderer.ts";
 import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
@@ -39,120 +40,133 @@ export declare const makeLocal: <Toolkit extends Toolkit.Any = never>(options: {
     }): Stream.Stream<string>;
 }, never, Tool.HandlersFor<{
     readonly readFile: Tool.Tool<"readFile", {
-        readonly parameters: import("effect/Schema").Struct<{
-            readonly path: import("effect/Schema").String;
-            readonly startLine: import("effect/Schema").optional<import("effect/Schema").Number>;
-            readonly endLine: import("effect/Schema").optional<import("effect/Schema").Number>;
+        readonly parameters: Schema.Struct<{
+            readonly path: Schema.String;
+            readonly startLine: Schema.optional<Schema.Number>;
+            readonly endLine: Schema.optional<Schema.Number>;
         }>;
-        readonly success: import("effect/Schema").NullOr<import("effect/Schema").String>;
-        readonly failure: import("effect/Schema").Never;
+        readonly success: Schema.NullOr<Schema.String>;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly writeFile: Tool.Tool<"writeFile", {
-        readonly parameters: import("effect/Schema").Struct<{
-            readonly path: import("effect/Schema").String;
-            readonly content: import("effect/Schema").String;
+        readonly parameters: Schema.Struct<{
+            readonly path: Schema.String;
+            readonly content: Schema.String;
         }>;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly applyPatch: Tool.Tool<"applyPatch", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly removeFile: Tool.Tool<"removeFile", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly renameFile: Tool.Tool<"renameFile", {
-        readonly parameters: import("effect/Schema").Struct<{
-            readonly from: import("effect/Schema").String;
-            readonly to: import("effect/Schema").String;
+        readonly parameters: Schema.Struct<{
+            readonly from: Schema.String;
+            readonly to: Schema.String;
         }>;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly mkdir: Tool.Tool<"mkdir", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly ls: Tool.Tool<"ls", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").$Array<import("effect/Schema").String>;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.$Array<Schema.String>;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly rg: Tool.Tool<"rg", {
-        readonly parameters: import("effect/Schema").Struct<{
-            readonly pattern: import("effect/Schema").String;
-            readonly glob: import("effect/Schema").optional<import("effect/Schema").String>;
-            readonly noIgnore: import("effect/Schema").optional<import("effect/Schema").Boolean>;
-            readonly maxLines: import("effect/Schema").optional<import("effect/Schema").Finite>;
+        readonly parameters: Schema.Struct<{
+            readonly pattern: Schema.String;
+            readonly glob: Schema.optional<Schema.String>;
+            readonly noIgnore: Schema.optional<Schema.Boolean>;
+            readonly maxLines: Schema.optional<Schema.Finite>;
         }>;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly glob: Tool.Tool<"glob", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").$Array<import("effect/Schema").String>;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.$Array<Schema.String>;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly bash: Tool.Tool<"bash", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly gh: Tool.Tool<"gh", {
-        readonly parameters: import("effect/Schema").$Array<import("effect/Schema").String>;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.$Array<Schema.String>;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, CurrentDirectory>;
     readonly delegate: Tool.Tool<"delegate", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, SubagentExecutor>;
     readonly webSearch: Tool.Tool<"webSearch", {
-        readonly parameters: import("effect/Schema").Struct<{
-            readonly query: import("effect/Schema").String;
-            readonly numResults: import("effect/Schema").optional<import("effect/Schema").Number>;
+        readonly parameters: Schema.Struct<{
+            readonly query: Schema.String;
+            readonly numResults: Schema.optional<Schema.Number>;
         }>;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, never>;
     readonly fetchMarkdown: Tool.Tool<"fetchMarkdown", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").String;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.String;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, never>;
     readonly sleep: Tool.Tool<"sleep", {
-        readonly parameters: import("effect/Schema").Finite;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.Finite;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, never>;
     readonly taskComplete: Tool.Tool<"taskComplete", {
-        readonly parameters: import("effect/Schema").String;
-        readonly success: import("effect/Schema").Void;
-        readonly failure: import("effect/Schema").Never;
+        readonly parameters: Schema.String;
+        readonly success: Schema.Void;
+        readonly failure: Schema.Never;
         readonly failureMode: "error";
     }, TaskCompleter>;
 }> | FileSystem.FileSystem | Path.Path | ToolkitRenderer | Exclude<Toolkit extends Toolkit.Toolkit<infer T extends Record<string, Tool.Any>> ? Tool.HandlersFor<T> | Tool.HandlerServices<T[keyof T]> : never, CurrentDirectory | TaskCompleter | SubagentExecutor>>;
+/**
+ * @since 1.0.0
+ * @category Constructors
+ */
+export declare const makeRpc: Effect.Effect<{
+    readonly toolsDts: Effect.Effect<string>;
+    readonly agentsMd: Effect.Effect<Option.Option<string>>;
+    execute(options: {
+        readonly script: string;
+        readonly onTaskComplete: (summary: string) => Effect.Effect<void>;
+        readonly onSubagent: (message: string) => Effect.Effect<string>;
+    }): Stream.Stream<string>;
+}, never, Scope.Scope | RpcClient.Protocol>;
 /**
  * @since 1.0.0
  * @category Layers
@@ -161,5 +175,64 @@ export declare const layerLocal: <Toolkit extends Toolkit.Any = never>(options:
     readonly directory: string;
     readonly tools?: Toolkit | undefined;
 }) => Layer.Layer<AgentExecutor, never, FileSystem.FileSystem | Path.Path | ChildProcessSpawner | HttpClient | Exclude<Toolkit extends Toolkit.Toolkit<infer T> ? Tool.HandlersFor<T> | Tool.HandlerServices<T[keyof T]> : never, CurrentDirectory | SubagentExecutor | TaskCompleter>>;
+/**
+ * Create an AgentExecutor that communicates with a remote RpcServer serving the
+ * AgentExecutor protocol.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layerRpc: Layer.Layer<AgentExecutor, never, RpcClient.Protocol>;
+/**
+ * Create a RpcServer that serves the AgentExecutor rpc protocol.
+ *
+ * This can be used to run the AgentExecutor in a remote location.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export declare const layerRpcServer: <Toolkit extends Toolkit.Any = never>(options: {
+    readonly directory: string;
+    readonly tools?: Toolkit | undefined;
+}) => Layer.Layer<never, never, RpcServer.Protocol | FileSystem.FileSystem | HttpClient | Path.Path | ChildProcessSpawner | Exclude<Toolkit extends Toolkit.Toolkit<infer T> ? Tool.HandlersFor<T> | Tool.HandlerServices<T[keyof T]> : never, CurrentDirectory | SubagentExecutor | TaskCompleter>>;
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export declare const ExecuteOutput: Schema.TaggedUnion<{
+    readonly Text: Schema.TaggedStruct<"Text", {
+        readonly text: Schema.String;
+    }>;
+    readonly TaskComplete: Schema.TaggedStruct<"TaskComplete", {
+        readonly summary: Schema.String;
+    }>;
+    readonly Subagent: Schema.TaggedStruct<"Subagent", {
+        readonly id: Schema.Finite;
+        readonly prompt: Schema.String;
+    }>;
+}>;
+declare const Rpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"toolsDts", Schema.Void, Schema.String, Schema.Never, never, never> | Rpc.Rpc<"agentsMd", Schema.Void, Schema.Option<Schema.String>, Schema.Never, never, never> | Rpc.Rpc<"subagentOutput", Schema.Struct<{
+    id: Schema.Finite;
+    output: Schema.String;
+}>, Schema.Void, Schema.Never, never, never> | Rpc.Rpc<"execute", Schema.Struct<{
+    readonly script: Schema.String;
+}>, import("effect/unstable/rpc/RpcSchema").Stream<Schema.TaggedUnion<{
+    readonly Text: Schema.TaggedStruct<"Text", {
+        readonly text: Schema.String;
+    }>;
+    readonly TaskComplete: Schema.TaggedStruct<"TaskComplete", {
+        readonly summary: Schema.String;
+    }>;
+    readonly Subagent: Schema.TaggedStruct<"Subagent", {
+        readonly id: Schema.Finite;
+        readonly prompt: Schema.String;
+    }>;
+}>, Schema.Never>, Schema.Never, never, never>>;
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export declare class Rpcs extends Rpcs_base {
+}
 export {};
 //# sourceMappingURL=AgentExecutor.d.ts.map

package/dist/AgentExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../src/AgentExecutor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,MAAM,EAGN,UAAU,EACV,KAAK,EACL,MAAM,EACN,IAAI,EAIJ,UAAU,EACV,MAAM,EACP,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAIlD,OAAO,EAGL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;;uBAS1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;uBACrB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;qBACtC;QACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACjE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;KAChE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;;AAb7B;;;GAGG;AACH,qBAAa,aAAc,SAAQ,kBAWR;CAAG;AAE9B;;;GAGG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,SAAS,OAAO,CAAC,GAAG;wBAEP,MAAM;qBACT,OAAO,GAAG,SAAS;;uBAlBf,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;uBACrB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;qBACtC;QACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACjE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;KAChE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yGAqBe,CAAC,0JA8G3C,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,OAAO,CAAC,GAAG,GAAG,KAAK,EAAE,SAAS;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACrC,KAAG,KAAK,CAAC,KAAK,CACb,aAAa,EACb,KAAK,EACH,UAAU,CAAC,UAAU,GACrB,IAAI,CAAC,IAAI,GACT,mBAAmB,GACnB,UAAU,GACV,OAAO,CACL,OAAO,SAAS,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GACpC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACtD,KAAK,EACT,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CACpD,CAIF,CAAA"}
+{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../src/AgentExecutor.ts"],"names":[],"mappings":"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"}

package/dist/AgentExecutor.js

@@ -1,8 +1,9 @@
 /**
  * @since 1.0.0
  */
-import { Cause, Console, Effect, Exit, Fiber, FileSystem, Layer, Option, Path, pipe, Queue, Scope, ServiceMap, Stream, } from "effect";
+import { Cause, Console, Effect, Exit, Fiber, FileSystem, Layer, Option, Path, pipe, Queue, Result, Schema, Scope, ServiceMap, Stream, } from "effect";
 import { Tool, Toolkit } from "effect/unstable/ai";
+import { Rpc, RpcClient, RpcGroup, RpcServer } from "effect/unstable/rpc";
 import * as NodeConsole from "node:console";
 import * as NodeVm from "node:vm";
 import { Writable } from "node:stream";
@@ -90,11 +91,139 @@ ${opts.script}
         execute,
     });
 });
+/**
+ * @since 1.0.0
+ * @category Constructors
+ */
+export const makeRpc = Effect.gen(function* () {
+    const client = yield* RpcClient.make(Rpcs, {
+        spanPrefix: "AgentExecutorClient",
+    });
+    return AgentExecutor.of({
+        toolsDts: Effect.orDie(client.toolsDts()),
+        agentsMd: Effect.orDie(client.agentsMd()),
+        execute: (opts) => Scope.Scope.useSync((scope) => client.execute({ script: opts.script }).pipe(Stream.tap((part) => {
+            switch (part._tag) {
+                case "Text": {
+                    return Effect.void;
+                }
+                case "TaskComplete": {
+                    return opts.onTaskComplete(part.summary);
+                }
+                case "Subagent": {
+                    const id = part.id;
+                    return pipe(opts.onSubagent(part.prompt), Effect.flatMap((output) => client.subagentOutput({ id, output })), Effect.forkIn(scope));
+                }
+            }
+        }), Stream.orDie, Stream.filterMap((part) => part._tag === "Text" ? Result.succeed(part.text) : Result.failVoid))).pipe(Stream.unwrap),
+    });
+});
 /**
  * @since 1.0.0
  * @category Layers
  */
 export const layerLocal = (options) => Layer.effect(AgentExecutor, makeLocal(options)).pipe(Layer.provide([AgentToolHandlers, ToolkitRenderer.layer]));
+/**
+ * Create an AgentExecutor that communicates with a remote RpcServer serving the
+ * AgentExecutor protocol.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerRpc = Layer.effect(AgentExecutor, makeRpc);
+/**
+ * Create a RpcServer that serves the AgentExecutor rpc protocol.
+ *
+ * This can be used to run the AgentExecutor in a remote location.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerRpcServer = (options) => RpcServer.layer(Rpcs, {
+    spanPrefix: "AgentExecutorServer",
+    disableFatalDefects: true,
+}).pipe(Layer.provide(Rpcs.toLayer(Effect.gen(function* () {
+    const local = yield* makeLocal(options);
+    const subagentResumes = new Map();
+    return Rpcs.of({
+        agentsMd: () => local.agentsMd,
+        toolsDts: () => local.toolsDts,
+        subagentOutput: ({ id, output }) => {
+            const resume = subagentResumes.get(id);
+            if (resume) {
+                resume(Effect.succeed(output));
+                subagentResumes.delete(id);
+            }
+            return Effect.void;
+        },
+        execute: Effect.fnUntraced(function* ({ script }) {
+            const queue = yield* Queue.unbounded();
+            let subagentId = 0;
+            yield* pipe(local.execute({
+                script,
+                onTaskComplete(summary) {
+                    return Queue.offer(queue, {
+                        _tag: "TaskComplete",
+                        summary,
+                    });
+                },
+                onSubagent(prompt) {
+                    const id = subagentId++;
+                    return Effect.callback((resume) => {
+                        subagentResumes.set(id, resume);
+                        Queue.offerUnsafe(queue, {
+                            _tag: "Subagent",
+                            id,
+                            prompt,
+                        });
+                        return Effect.sync(() => {
+                            subagentResumes.delete(id);
+                        });
+                    });
+                },
+            }), Stream.runForEachArray((parts) => {
+                for (const part of parts) {
+                    Queue.offerUnsafe(queue, {
+                        _tag: "Text",
+                        text: part,
+                    });
+                }
+                return Effect.void;
+            }), Effect.forkScoped);
+            return queue;
+        }),
+    });
+}))), Layer.provide([AgentToolHandlers, ToolkitRenderer.layer]));
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export const ExecuteOutput = Schema.TaggedUnion({
+    Text: { text: Schema.String },
+    TaskComplete: { summary: Schema.String },
+    Subagent: { id: Schema.Finite, prompt: Schema.String },
+});
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export class Rpcs extends RpcGroup.make(Rpc.make("toolsDts", {
+    success: Schema.String,
+}), Rpc.make("agentsMd", {
+    success: Schema.Option(Schema.String),
+}), Rpc.make("subagentOutput", {
+    payload: {
+        id: Schema.Finite,
+        output: Schema.String,
+    },
+}), Rpc.make("execute", {
+    payload: Schema.Struct({
+        script: Schema.String,
+    }),
+    success: ExecuteOutput,
+    stream: true,
+})) {
+}
 const defaultMain = () => Promise.resolve();
 const makeConsole = Effect.fn(function* (queue) {
     const writable = new QueueWriteStream(queue);

package/dist/AgentExecutor.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clanka",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "publishConfig": {
     "access": "public"
   },

package/src/AgentExecutor.ts

@@ -13,11 +13,14 @@ import {
   Path,
   pipe,
   Queue,
+  Result,
+  Schema,
   Scope,
   ServiceMap,
   Stream,
 } from "effect"
 import { Tool, Toolkit } from "effect/unstable/ai"
+import { Rpc, RpcClient, RpcGroup, RpcServer } from "effect/unstable/rpc"
 import * as NodeConsole from "node:console"
 import * as NodeVm from "node:vm"
 import { Writable } from "node:stream"
@@ -178,6 +181,50 @@ ${opts.script}
   })
 })
 
+/**
+ * @since 1.0.0
+ * @category Constructors
+ */
+export const makeRpc = Effect.gen(function* () {
+  const client = yield* RpcClient.make(Rpcs, {
+    spanPrefix: "AgentExecutorClient",
+  })
+
+  return AgentExecutor.of({
+    toolsDts: Effect.orDie(client.toolsDts()),
+    agentsMd: Effect.orDie(client.agentsMd()),
+    execute: (opts) =>
+      Scope.Scope.useSync((scope) =>
+        client.execute({ script: opts.script }).pipe(
+          Stream.tap((part) => {
+            switch (part._tag) {
+              case "Text": {
+                return Effect.void
+              }
+              case "TaskComplete": {
+                return opts.onTaskComplete(part.summary)
+              }
+              case "Subagent": {
+                const id = part.id
+                return pipe(
+                  opts.onSubagent(part.prompt),
+                  Effect.flatMap((output) =>
+                    client.subagentOutput({ id, output }),
+                  ),
+                  Effect.forkIn(scope),
+                )
+              }
+            }
+          }),
+          Stream.orDie,
+          Stream.filterMap((part) =>
+            part._tag === "Text" ? Result.succeed(part.text) : Result.failVoid,
+          ),
+        ),
+      ).pipe(Stream.unwrap),
+  })
+})
+
 /**
  * @since 1.0.0
  * @category Layers
@@ -203,6 +250,154 @@ export const layerLocal = <Toolkit extends Toolkit.Any = never>(options: {
     Layer.provide([AgentToolHandlers, ToolkitRenderer.layer]),
   )
 
+/**
+ * Create an AgentExecutor that communicates with a remote RpcServer serving the
+ * AgentExecutor protocol.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerRpc: Layer.Layer<AgentExecutor, never, RpcClient.Protocol> =
+  Layer.effect(AgentExecutor, makeRpc)
+
+/**
+ * Create a RpcServer that serves the AgentExecutor rpc protocol.
+ *
+ * This can be used to run the AgentExecutor in a remote location.
+ *
+ * @since 1.0.0
+ * @category Layers
+ */
+export const layerRpcServer = <Toolkit extends Toolkit.Any = never>(options: {
+  readonly directory: string
+  readonly tools?: Toolkit | undefined
+}): Layer.Layer<
+  never,
+  never,
+  | RpcServer.Protocol
+  | FileSystem.FileSystem
+  | HttpClient
+  | Path.Path
+  | ChildProcessSpawner
+  | Exclude<
+      Toolkit extends Toolkit.Toolkit<infer T>
+        ? Tool.HandlersFor<T> | Tool.HandlerServices<T[keyof T]>
+        : never,
+      CurrentDirectory | SubagentExecutor | TaskCompleter
+    >
+> =>
+  RpcServer.layer(Rpcs, {
+    spanPrefix: "AgentExecutorServer",
+    disableFatalDefects: true,
+  }).pipe(
+    Layer.provide(
+      Rpcs.toLayer(
+        Effect.gen(function* () {
+          const local = yield* makeLocal(options)
+          const subagentResumes = new Map<
+            number,
+            (effect: Effect.Effect<string>) => void
+          >()
+
+          return Rpcs.of({
+            agentsMd: () => local.agentsMd,
+            toolsDts: () => local.toolsDts,
+            subagentOutput: ({ id, output }) => {
+              const resume = subagentResumes.get(id)
+              if (resume) {
+                resume(Effect.succeed(output))
+                subagentResumes.delete(id)
+              }
+              return Effect.void
+            },
+            execute: Effect.fnUntraced(function* ({ script }) {
+              const queue = yield* Queue.unbounded<
+                typeof ExecuteOutput.Type,
+                Cause.Done
+              >()
+              let subagentId = 0
+
+              yield* pipe(
+                local.execute({
+                  script,
+                  onTaskComplete(summary) {
+                    return Queue.offer(queue, {
+                      _tag: "TaskComplete",
+                      summary,
+                    })
+                  },
+                  onSubagent(prompt) {
+                    const id = subagentId++
+                    return Effect.callback((resume) => {
+                      subagentResumes.set(id, resume)
+                      Queue.offerUnsafe(queue, {
+                        _tag: "Subagent",
+                        id,
+                        prompt,
+                      })
+                      return Effect.sync(() => {
+                        subagentResumes.delete(id)
+                      })
+                    })
+                  },
+                }),
+                Stream.runForEachArray((parts) => {
+                  for (const part of parts) {
+                    Queue.offerUnsafe(queue, {
+                      _tag: "Text",
+                      text: part,
+                    })
+                  }
+                  return Effect.void
+                }),
+                Effect.forkScoped,
+              )
+
+              return queue
+            }),
+          })
+        }),
+      ),
+    ),
+    Layer.provide([AgentToolHandlers, ToolkitRenderer.layer]),
+  )
+
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export const ExecuteOutput = Schema.TaggedUnion({
+  Text: { text: Schema.String },
+  TaskComplete: { summary: Schema.String },
+  Subagent: { id: Schema.Finite, prompt: Schema.String },
+})
+
+/**
+ * @since 1.0.0
+ * @category Rpcs
+ */
+export class Rpcs extends RpcGroup.make(
+  Rpc.make("toolsDts", {
+    success: Schema.String,
+  }),
+  Rpc.make("agentsMd", {
+    success: Schema.Option(Schema.String),
+  }),
+  Rpc.make("subagentOutput", {
+    payload: {
+      id: Schema.Finite,
+      output: Schema.String,
+    },
+  }),
+  Rpc.make("execute", {
+    payload: Schema.Struct({
+      script: Schema.String,
+    }),
+    success: ExecuteOutput,
+    stream: true,
+  }),
+) {}
+
 // ------------------------------------------
 // Internal
 // -------------------------------------------