@asterxsk/kiln 0.1.0 → 0.2.0

package/agent/extensions/subagents/package.json

@@ -1,19 +1,19 @@
-{
-  "name": "subagents",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "check": "tsc --noEmit -p .",
-    "prepare": "effect-tsgo patch",
-    "test": "node --test --experimental-strip-types manager.test.ts result-delivery.test.ts context-usage.test.ts takeover.test.ts by-the-way.test.ts",
-    "test:live": "node --test --experimental-strip-types claude.test.ts codex.test.ts"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.216",
-    "effect": "^4.0.0-beta.99"
-  },
-  "devDependencies": {
-    "@effect/tsgo": "^0.24.2",
-    "typescript": "^7.0.2"
-  }
-}
+{
+  "name": "subagents",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "check": "tsc --noEmit -p .",
+    "prepare": "effect-tsgo patch",
+    "test": "node --test --experimental-strip-types manager.test.ts result-delivery.test.ts context-usage.test.ts takeover.test.ts by-the-way.test.ts",
+    "test:live": "node --test --experimental-strip-types claude.test.ts codex.test.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.216",
+    "effect": "^4.0.0-beta.99"
+  },
+  "devDependencies": {
+    "@effect/tsgo": "^0.24.2",
+    "typescript": "^7.0.2"
+  }
+}

package/agent/extensions/subagents/result-delivery.test.ts

@@ -1,27 +1,27 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { createDeferredResultDelivery } from "./src/result-delivery.ts";
-
-test("a result consumed by a later wait is not delivered", () => {
-  const delivery = createDeferredResultDelivery<{
-    id: string;
-    output: string;
-  }>();
-
-  delivery.defer({ id: "sa-1", output: "done" });
-  delivery.consume(["sa-1"]);
-
-  assert.deepEqual(delivery.drain(), []);
-});
-
-test("unconsumed results are delivered once in settlement order", () => {
-  const delivery = createDeferredResultDelivery<{ id: string }>();
-  const first = { id: "sa-1" };
-  const second = { id: "sa-2" };
-
-  delivery.defer(first);
-  delivery.defer(second);
-
-  assert.deepEqual(delivery.drain(), [first, second]);
-  assert.deepEqual(delivery.drain(), []);
-});
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createDeferredResultDelivery } from "./src/result-delivery.ts";
+
+test("a result consumed by a later wait is not delivered", () => {
+  const delivery = createDeferredResultDelivery<{
+    id: string;
+    output: string;
+  }>();
+
+  delivery.defer({ id: "sa-1", output: "done" });
+  delivery.consume(["sa-1"]);
+
+  assert.deepEqual(delivery.drain(), []);
+});
+
+test("unconsumed results are delivered once in settlement order", () => {
+  const delivery = createDeferredResultDelivery<{ id: string }>();
+  const first = { id: "sa-1" };
+  const second = { id: "sa-2" };
+
+  delivery.defer(first);
+  delivery.defer(second);
+
+  assert.deepEqual(delivery.drain(), [first, second]);
+  assert.deepEqual(delivery.drain(), []);
+});

package/agent/extensions/subagents/src/backend.ts

@@ -1,73 +1,73 @@
-/**
- * The unified backend interface: one `SubagentBackend` per agent runtime
- * (pi, Claude Code, Codex), all producing the same `SubagentSession` shape.
- *
- * Planned real implementations (currently stubbed in ./backends/):
- * - pi: in-process `createAgentSession()` via the pi SDK.
- * - claude: `@anthropic-ai/claude-agent-sdk` `query()` in streaming-input mode.
- * - codex: `codex app-server` child process speaking JSON-RPC over stdio.
- */
-
-import type { Effect, Scope, Stream } from "effect";
-import { Context } from "effect";
-import type {
-  BackendName,
-  SendError,
-  SpawnError,
-  SpawnTask,
-  SubagentEvent,
-  SubagentMeta,
-} from "./domain.ts";
-
-export interface BackendCapabilities {
-  /** Can send() steer a live run (vs. only starting a fresh run when idle). */
-  readonly steering: boolean;
-  readonly modelSelection: boolean;
-  readonly reasoningEffort: boolean;
-}
-
-/**
- * A live subagent session. The manager is the single consumer of `events`;
- * it folds them into the `SubagentSnapshot` everything else reads.
- */
-export interface SubagentSession {
-  /** Current metadata snapshot. Updates also arrive as MetaChanged events. */
-  readonly meta: Effect.Effect<SubagentMeta>;
-  /**
-   * All activity, normalized. Ends when the session's scope closes. Every
-   * run started within the session terminates with a RunSettled event.
-   */
-  readonly events: Stream.Stream<SubagentEvent>;
-  /**
-   * Steer the active run, or start a fresh run when idle (v1 `manager.send`
-   * semantics — the "is a run active" decision is backend-native state).
-   */
-  send(text: string): Effect.Effect<void, SendError>;
-  /**
-   * Interrupt the active run. Resolves once the backend acknowledges; the
-   * corresponding RunSettled(Interrupted) arrives on `events`. Callers bound
-   * this with a timeout and fall back to closing the session scope.
-   */
-  readonly interrupt: Effect.Effect<void>;
-}
-
-export interface SubagentBackend {
-  readonly name: BackendName;
-  readonly capabilities: BackendCapabilities;
-  /** Probe availability (binary on PATH, SDK importable, credentials). */
-  readonly available: Effect.Effect<boolean>;
-  /**
-   * Spawn a session. Scoped: closing the scope interrupts/kills the
-   * underlying session or process and ends `events`. Fire-and-forget
-   * semantics (background fibers, result delivery) live in the manager.
-   */
-  spawn(
-    task: SpawnTask,
-  ): Effect.Effect<SubagentSession, SpawnError, Scope.Scope>;
-}
-
-/** Registry of all wired backends, keyed by name. */
-export class BackendRegistry extends Context.Service<
-  BackendRegistry,
-  ReadonlyMap<BackendName, SubagentBackend>
->()("subagents/BackendRegistry") {}
+/**
+ * The unified backend interface: one `SubagentBackend` per agent runtime
+ * (pi, Claude Code, Codex), all producing the same `SubagentSession` shape.
+ *
+ * Planned real implementations (currently stubbed in ./backends/):
+ * - pi: in-process `createAgentSession()` via the pi SDK.
+ * - claude: `@anthropic-ai/claude-agent-sdk` `query()` in streaming-input mode.
+ * - codex: `codex app-server` child process speaking JSON-RPC over stdio.
+ */
+
+import type { Effect, Scope, Stream } from "effect";
+import { Context } from "effect";
+import type {
+  BackendName,
+  SendError,
+  SpawnError,
+  SpawnTask,
+  SubagentEvent,
+  SubagentMeta,
+} from "./domain.ts";
+
+export interface BackendCapabilities {
+  /** Can send() steer a live run (vs. only starting a fresh run when idle). */
+  readonly steering: boolean;
+  readonly modelSelection: boolean;
+  readonly reasoningEffort: boolean;
+}
+
+/**
+ * A live subagent session. The manager is the single consumer of `events`;
+ * it folds them into the `SubagentSnapshot` everything else reads.
+ */
+export interface SubagentSession {
+  /** Current metadata snapshot. Updates also arrive as MetaChanged events. */
+  readonly meta: Effect.Effect<SubagentMeta>;
+  /**
+   * All activity, normalized. Ends when the session's scope closes. Every
+   * run started within the session terminates with a RunSettled event.
+   */
+  readonly events: Stream.Stream<SubagentEvent>;
+  /**
+   * Steer the active run, or start a fresh run when idle (v1 `manager.send`
+   * semantics — the "is a run active" decision is backend-native state).
+   */
+  send(text: string): Effect.Effect<void, SendError>;
+  /**
+   * Interrupt the active run. Resolves once the backend acknowledges; the
+   * corresponding RunSettled(Interrupted) arrives on `events`. Callers bound
+   * this with a timeout and fall back to closing the session scope.
+   */
+  readonly interrupt: Effect.Effect<void>;
+}
+
+export interface SubagentBackend {
+  readonly name: BackendName;
+  readonly capabilities: BackendCapabilities;
+  /** Probe availability (binary on PATH, SDK importable, credentials). */
+  readonly available: Effect.Effect<boolean>;
+  /**
+   * Spawn a session. Scoped: closing the scope interrupts/kills the
+   * underlying session or process and ends `events`. Fire-and-forget
+   * semantics (background fibers, result delivery) live in the manager.
+   */
+  spawn(
+    task: SpawnTask,
+  ): Effect.Effect<SubagentSession, SpawnError, Scope.Scope>;
+}
+
+/** Registry of all wired backends, keyed by name. */
+export class BackendRegistry extends Context.Service<
+  BackendRegistry,
+  ReadonlyMap<BackendName, SubagentBackend>
+>()("subagents/BackendRegistry") {}