@llblab/pi-actors 0.42.3 → 0.43.1

package/recipes/coordinator-locker.json

@@ -1,45 +0,0 @@
-{
-  "async": true,
-  "args": [
-    "repo:path",
-    "lease_ms:int"
-  ],
-  "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
-    "lease_ms": "600000"
-  },
-  "mailbox": {
-    "accepts": [
-      "coord.enqueue",
-      "coord.claim",
-      "coord.complete",
-      "coord.fail",
-      "lock.acquire",
-      "lock.renew",
-      "lock.release",
-      "control.stop",
-      "control.cancel",
-      "control.kill"
-    ],
-    "emits": [
-      "coord.started",
-      "coord.enqueued",
-      "coord.assigned",
-      "coord.empty",
-      "coord.completed",
-      "coord.failed",
-      "lock.granted",
-      "lock.denied",
-      "lock.renewed",
-      "lock.released",
-      "run.done",
-      "run.failed"
-    ]
-  },
-  "artifacts": {
-    "queue": "{state_dir}/queue.json",
-    "locks": "{state_dir}/locks.json",
-    "journal": "{state_dir}/journal.jsonl"
-  },
-  "template": "{repo}/scripts/locker.mjs serve --state-dir {state_dir} --lease-ms {lease_ms}"
-}

package/recipes/locker.json

@@ -1,45 +0,0 @@
-{
-  "async": true,
-  "args": [
-    "repo:path",
-    "lease_ms:int"
-  ],
-  "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
-    "lease_ms": "600000"
-  },
-  "mailbox": {
-    "accepts": [
-      "lock.enqueue",
-      "lock.claim",
-      "lock.complete",
-      "lock.fail",
-      "lock.acquire",
-      "lock.renew",
-      "lock.release",
-      "control.stop",
-      "control.cancel",
-      "control.kill"
-    ],
-    "emits": [
-      "lock.started",
-      "lock.enqueued",
-      "lock.assigned",
-      "lock.empty",
-      "lock.completed",
-      "lock.failed",
-      "lock.granted",
-      "lock.denied",
-      "lock.renewed",
-      "lock.released",
-      "run.done",
-      "run.failed"
-    ]
-  },
-  "artifacts": {
-    "queue": "{state_dir}/queue.json",
-    "locks": "{state_dir}/locks.json",
-    "journal": "{state_dir}/journal.jsonl"
-  },
-  "template": "{repo}/scripts/locker.mjs serve --state-dir {state_dir} --lease-ms {lease_ms}"
-}

package/recipes/pipeline-room-swarm.json

@@ -1,50 +0,0 @@
-{
-  "async": true,
-  "args": [
-    "mode:enum(consensus,pipeline,fanout,pool)",
-    "mission:string",
-    "model:string",
-    "thinking:string",
-    "roles:string",
-    "roles_path:path",
-    "rounds:int",
-    "delay:int",
-    "locker:bool",
-    "locker_lease_ms:int",
-    "subagent_ttl_ms:int",
-    "artifact_path:path",
-    "repo:path"
-  ],
-  "defaults": {
-    "mode": "consensus",
-    "thinking": "off",
-    "roles": "",
-    "roles_path": "",
-    "rounds": "4",
-    "delay": "10",
-    "locker": "false",
-    "locker_lease_ms": "600000",
-    "subagent_ttl_ms": "0",
-    "artifact_path": "{state_dir}/room-swarm-artifact.md",
-    "repo": "~/.pi/agent/extensions/pi-actors"
-  },
-  "artifacts": {
-    "artifact": "{artifact_path}",
-    "locker_journal": "{state_dir}/locker/journal.jsonl",
-    "locker_locks": "{state_dir}/locker/locks.json",
-    "locker_queue": "{state_dir}/locker/queue.json"
-  },
-  "mailbox": {
-    "accepts": [
-      "control.kill"
-    ],
-    "emits": [
-      "chat.message",
-      "actor.join",
-      "actor.leave",
-      "run.done",
-      "run.failed"
-    ]
-  },
-  "template": "{repo}/scripts/coordinator.mjs --run-id={run_id} --mode={mode} --mission={mission} --model={model} --thinking={thinking} --roles={roles} --roles-path={roles_path} --rounds={rounds} --delay={delay} --locker={locker} --locker-lease-ms={locker_lease_ms} --subagent-ttl-ms={subagent_ttl_ms} --artifact-path={artifact_path}"
-}

package/recipes/subagent-message.json

@@ -1,32 +0,0 @@
-{
-  "async": true,
-  "args": [
-    "type:string",
-    "payload:string",
-    "to:string",
-    "from:string",
-    "message_policy:string",
-    "output_format:string",
-    "model:string",
-    "thinking:string",
-    "tools:string"
-  ],
-  "defaults": {
-    "type": "component.update",
-    "to": "coordinator",
-    "from": "run:{run_id}",
-    "message_policy": "Emit an actor-message envelope-shaped JSON object for the coordinator; do not call transport tools directly.",
-    "output_format": "JSON object with to, from, type, summary, body, metadata, confidence, and next_action.",
-    "thinking": "off",
-    "tools": ""
-  },
-  "mailbox": {
-    "accepts": [
-      "control.kill"
-    ],
-    "emits": [
-      "component.*"
-    ]
-  },
-  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Create an actor-message envelope-shaped record. To: {to}. From: {from}. Type: {type}. Message policy: {message_policy}. Payload/body: {payload}. Output format: {output_format}"
-}

package/recipes/utility-actor-message.json

@@ -1,23 +0,0 @@
-{
-  "async": false,
-  "args": [
-    "type:string",
-    "to:string",
-    "from:string",
-    "summary:string",
-    "metadata:string",
-    "correlation_id:string",
-    "reply_to:string",
-    "repo:path"
-  ],
-  "defaults": {
-    "to": "coordinator",
-    "from": "run:{run_id}",
-    "summary": "",
-    "metadata": "{}",
-    "correlation_id": "",
-    "reply_to": "",
-    "repo": "~/.pi/agent/extensions/pi-actors"
-  },
-  "template": "node {repo}/scripts/recipe-utils.mjs actor-message {type} {to} {from} {summary} {metadata} {correlation_id} {reply_to}"
-}

package/scripts/actor-worker.mjs

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Canonical mailbox-backed actor worker demo.
- *
- * Owns the worker argument parsing and control loop directly. Reusable room and
- * mailbox primitives stay in lib/; this script remains the public executable.
- */
-
-import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-function packageRoot() {
-  return dirname(dirname(fileURLToPath(import.meta.url)));
-}
-
-async function importRuntimeModule(name) {
-  const root = packageRoot();
-  const compiled = join(root, "dist", "lib", `${name}.js`);
-  const source = join(root, "lib", `${name}.ts`);
-  return await import(
-    pathToFileURL(existsSync(compiled) ? compiled : source).href
-  );
-}
-
-const { appendRoomMessage, ensureRoomMember, readBranchInboxMessages } =
-  await importRuntimeModule("rooms");
-const { handleMailboxLoopOnce, isMailboxLoopStopMessage } =
-  await importRuntimeModule("mailbox-loop");
-
-export function parseActorWorkerArgs(argv) {
-  const args = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith("--")) continue;
-    const key = token.slice(2).replaceAll("-", "_");
-    const next = argv[index + 1];
-    if (!next || next.startsWith("--")) {
-      args[key] = true;
-      continue;
-    }
-    args[key] = next;
-    index += 1;
-  }
-  return args;
-}
-
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function text(value) {
-  return typeof value === "string" ? value : JSON.stringify(value);
-}
-
-function enabled(value) {
-  return value !== false && value !== "false" && value !== "0";
-}
-
-function safeName(value) {
-  return String(value ?? "unknown").replaceAll(/[^A-Za-z0-9_.-]+/g, "_");
-}
-
-export async function runActorWorker(argv = process.argv.slice(2)) {
-  const args = parseActorWorkerArgs(argv);
-  const stateDir = String(args.state_dir ?? "");
-  const run = String(args.run ?? "");
-  const branch = String(args.branch ?? "worker");
-  const pollMs = Math.max(50, Number(args.poll_ms ?? 1000));
-  const staleClaimMs = Math.max(0, Number(args.stale_claim_ms ?? 0));
-  const artifactDir = String(
-    args.artifact_dir ?? join(stateDir, "worker-artifacts"),
-  );
-  const writeArtifacts = enabled(args.write_artifacts ?? true);
-
-  if (!stateDir || !run) {
-    throw new Error(
-      "usage: actor-worker.mjs --state-dir <dir> --run <id> [--branch worker] [--poll-ms 1000]",
-    );
-  }
-
-  const branchAddress = `branch:${run}/${branch}`;
-  const roomAddress = `room:${run}`;
-  const journalPath = join(stateDir, "worker-events.jsonl");
-  const statusPath = join(stateDir, "worker-status.json");
-  if (writeArtifacts) mkdirSync(artifactDir, { recursive: true });
-
-  function journal(event, data = {}) {
-    appendFileSync(
-      journalPath,
-      `${JSON.stringify({ event, ts: new Date().toISOString(), ...data })}\n`,
-    );
-  }
-
-  function staleClaims() {
-    if (staleClaimMs <= 0) return 0;
-    const cutoff = Date.now() - staleClaimMs;
-    return readBranchInboxMessages(stateDir, run, branchAddress).filter(
-      (record) => {
-        if (record.status !== "claimed" || !record.claimed_at) return false;
-        const claimedAt = Date.parse(record.claimed_at);
-        return Number.isFinite(claimedAt) && claimedAt < cutoff;
-      },
-    ).length;
-  }
-
-  function status(state, data = {}) {
-    writeFileSync(
-      statusPath,
-      `${JSON.stringify({ artifact_dir: artifactDir, branch, run, stale_claims: staleClaims(), state, ts: new Date().toISOString(), ...data }, null, 2)}\n`,
-    );
-  }
-
-  function writeResultArtifact(id, result) {
-    if (!writeArtifacts) return undefined;
-    const path = join(artifactDir, `${safeName(id)}.txt`);
-    writeFileSync(path, `${result}\n`);
-    return path;
-  }
-
-  function room(type, summary, body = {}) {
-    appendRoomMessage(stateDir, "main", {
-      body,
-      from: branchAddress,
-      summary,
-      to: roomAddress,
-      type,
-    });
-  }
-
-  ensureRoomMember(
-    stateDir,
-    run,
-    "main",
-    branchAddress,
-    { display: branch, role: "worker", status: "present" },
-    `${branch} joined as mailbox worker`,
-  );
-  room("awaiting_assignment", `${branch} awaiting assignment`, {
-    branch,
-    stale_claim_ms: staleClaimMs,
-    stale_claims: staleClaims(),
-  });
-  journal("worker.started", {
-    artifact_dir: artifactDir,
-    branch,
-    run,
-    stale_claim_ms: staleClaimMs,
-  });
-  status("awaiting_assignment", { handled: 0, stale_claim_ms: staleClaimMs });
-
-  let handled = 0;
-  let stopping = false;
-  while (!stopping) {
-    const result = await handleMailboxLoopOnce(
-      { address: branchAddress, kind: "branch", run, stateDir },
-      (message) => {
-        if (isMailboxLoopStopMessage(message)) {
-          stopping = true;
-          room("actor.leave", `${branch} stopping`, {
-            branch,
-            reason: message.type,
-          });
-          journal("worker.stopping", { id: message.id, type: message.type });
-          status("stopping", { handled, reason: message.type });
-          return;
-        }
-        room("task.claim", `${branch} claimed ${message.type}`, {
-          branch,
-          id: message.id,
-          type: message.type,
-        });
-        const result = text(message.body);
-        const artifact = writeResultArtifact(message.id, result);
-        handled += 1;
-        room("task.result", `${branch} handled ${message.type}`, {
-          artifact,
-          branch,
-          id: message.id,
-          result,
-          type: message.type,
-        });
-        room("awaiting_assignment", `${branch} awaiting assignment`, {
-          branch,
-        });
-        journal("task.handled", {
-          artifact,
-          id: message.id,
-          type: message.type,
-        });
-        status("awaiting_assignment", {
-          handled,
-          last_artifact: artifact,
-          last_id: message.id,
-          last_type: message.type,
-          stale_claim_ms: staleClaimMs,
-        });
-      },
-      { owner: branchAddress },
-    );
-    if (!result.handled) await sleep(pollMs);
-  }
-
-  journal("worker.done", { branch, handled, run });
-  status("done", { handled });
-}
-
-try {
-  await runActorWorker(process.argv.slice(2));
-} catch (error) {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(2);
-}