@llblab/pi-actors 0.23.0 → 0.24.1

package/dist/recipes/coordinator-locker.json

@@ -0,0 +1,45 @@
+{
+  "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/dist/recipes/lens-swarm.json

@@ -0,0 +1,66 @@
+{
+  "description": "General-purpose multi-lens review swarm. Launches independent reviewers by lens, then verifies, merges, judges, and normalizes the result.",
+  "async": true,
+  "imports": {
+    "coordinator": "subagent-review-coordinator.json"
+  },
+  "args": [
+    "scope:string",
+    "lenses:array",
+    "model:string",
+    "thinking:string",
+    "tools:string",
+    "claim:string",
+    "evidence_policy:string",
+    "risk_policy:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "lenses": [
+      "correctness",
+      "architecture",
+      "operator UX"
+    ],
+    "thinking": "off",
+    "tools": "",
+    "claim": "The reviewed scope has clear, evidence-based findings, risks, and recommended next actions.",
+    "evidence_policy": "Cite inspected files, command outputs, or explicit uncertainty for every material claim.",
+    "risk_policy": "Preserve minority high-impact risks and ideas; separate confirmed issues from hypotheses.",
+    "output_format": "Markdown sections: Summary, Consensus Findings, Minority Findings, Verification, Judge Notes, Risks, Next Actions."
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "review.completed",
+      "verification.completed",
+      "merge.completed",
+      "judge.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "coordinator",
+      "values": {
+        "scope": "{scope}",
+        "lenses": "{lenses}",
+        "claim": "{claim}",
+        "reviewer_model": "{model}",
+        "verifier_model": "{model}",
+        "merger_model": "{model}",
+        "judge_model": "{model}",
+        "thinking": "{thinking}",
+        "tools": "{tools}",
+        "evidence_policy": "{evidence_policy}",
+        "risk_policy": "{risk_policy}",
+        "output_format": "{output_format}"
+      }
+    }
+  ]
+}

package/dist/recipes/locker.json

@@ -0,0 +1,45 @@
+{
+  "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/dist/recipes/music-player.json

@@ -0,0 +1,38 @@
+{
+  "async": true,
+  "args": [
+    "repo:path",
+    "command:enum(play,pause,resume,toggle,next,previous,stop,status)",
+    "source:string",
+    "loop:bool",
+    "volume:int",
+    "player:enum(auto,mpv,afplay,ffplay,cvlc,play,wmp)",
+    "state_dir:path"
+  ],
+  "defaults": {
+    "repo": "~/.pi/agent/extensions/pi-actors",
+    "command": "play",
+    "loop": "true",
+    "volume": "70",
+    "player": "auto"
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill",
+      "player.play",
+      "player.pause",
+      "player.resume",
+      "player.toggle",
+      "player.next",
+      "player.previous",
+      "player.stop",
+      "player.status"
+    ],
+    "emits": [
+      "player.track"
+    ]
+  },
+  "template": "{repo}/scripts/music-player.mjs {command} {source} {loop} {volume} {player} {state_dir}"
+}

package/dist/recipes/pipeline-architect-coordinator.json

@@ -0,0 +1,95 @@
+{
+  "async": true,
+  "imports": {
+    "reviewer": "subagent-review.json",
+    "critic": "subagent-critic.json",
+    "verifier": "subagent-verify.json",
+    "merger": "subagent-merge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "problem:string",
+    "lenses:array",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "lenses": [
+      "architecture",
+      "implementation pragmatism",
+      "operator UX",
+      "failure modes"
+    ],
+    "constraints": "Prefer small composable pieces, explicit contracts, and no broad workflow DSL.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "pipeline.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "parallel": true,
+      "repeat": "{lenses.length}",
+      "failure": "branch",
+      "template": {
+        "name": "reviewer",
+        "values": {
+          "scope": "{problem}",
+          "lens": "{lenses[index]}",
+          "instructions": "Propose one architecture direction and one smallest next slice within constraints: {constraints}",
+          "model": "{model}",
+          "thinking": "medium",
+          "tools": "{tools}"
+        }
+      }
+    },
+    {
+      "name": "critic",
+      "values": {
+        "target": "Use proposed directions from stdin for problem: {problem}",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "verifier",
+      "values": {
+        "claim": "The proposed architecture can be advanced by a small validated next slice.",
+        "evidence": "Use proposed directions and critique from stdin.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use brainstorm, critique, and verification outputs from stdin.",
+        "mode": "risk-first",
+        "risk_policy": "Prefer a feasible smallest next slice over ambitious completeness.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use architecture synthesis from stdin.",
+        "format": "Markdown sections: Direction, Rejected Alternatives, Risks, Component Contracts, Next Slice, Validation Gates.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-artifact-bundle.json

@@ -0,0 +1,100 @@
+{
+  "async": true,
+  "imports": {
+    "artifactWrite": "pipeline-artifact-write.json",
+    "manifest": "utility-artifact-manifest.json",
+    "manifestWrite": "utility-artifact-write.json",
+    "validation": "utility-validation-wrapper.json",
+    "message": "utility-actor-message.json"
+  },
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "manifest_path:path",
+    "artifact_title:string",
+    "artifact_format:string",
+    "artifact_status:enum(draft,ready,blocked,accepted)",
+    "write_mode:enum(create,overwrite,append)",
+    "run_validation:bool",
+    "validation_command:string",
+    "validation_scope:string",
+    "validation_timeout_ms:int",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_title": "Artifact Bundle",
+    "artifact_format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "artifact_status": "ready",
+    "write_mode": "create",
+    "run_validation": "false",
+    "validation_command": "true",
+    "validation_scope": ".",
+    "validation_timeout_ms": "300000",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "artifact.bundle_ready",
+      "artifact.written",
+      "artifact.blocked",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "artifacts": {
+    "artifact": "{artifact_path}",
+    "manifest": "{manifest_path}"
+  },
+  "template": [
+    {
+      "when": "run_validation",
+      "name": "validation",
+      "values": {
+        "command": "{validation_command}",
+        "scope": "{validation_scope}",
+        "timeout_ms": "{validation_timeout_ms}"
+      }
+    },
+    {
+      "name": "artifactWrite",
+      "values": {
+        "input": "{input}",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "{artifact_format}",
+        "write_mode": "{write_mode}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "manifest",
+      "values": {
+        "artifact_path": "{artifact_path}",
+        "title": "{artifact_title}",
+        "status": "{artifact_status}",
+        "summary": "Artifact bundle manifest for {artifact_path}."
+      }
+    },
+    {
+      "name": "manifestWrite",
+      "values": {
+        "artifact_path": "{manifest_path}",
+        "mode": "{write_mode}"
+      }
+    },
+    {
+      "name": "message",
+      "values": {
+        "type": "artifact.bundle_ready",
+        "summary": "Artifact bundle ready: {artifact_path} with manifest {manifest_path}.",
+        "metadata": "{\"artifact\":\"{artifact_path}\",\"manifest\":\"{manifest_path}\"}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-artifact-report.json

@@ -0,0 +1,58 @@
+{
+  "async": true,
+  "imports": {
+    "normalizer": "subagent-normalize.json",
+    "artifact": "subagent-artifact.json",
+    "message": "utility-actor-message.json"
+  },
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "artifact_format:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "artifact.prepared",
+      "artifact.blocked"
+    ]
+  },
+  "template": [
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "{input}",
+        "format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "message",
+      "values": {
+        "type": "artifact.prepared",
+        "summary": "Artifact prepared for path {artifact_path}."
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-artifact-write.json

@@ -0,0 +1,72 @@
+{
+  "async": true,
+  "imports": {
+    "normalizer": "subagent-normalize.json",
+    "artifact": "subagent-artifact.json",
+    "writer": "utility-artifact-write.json",
+    "message": "utility-actor-message.json"
+  },
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "artifact_format:string",
+    "write_mode:enum(create,overwrite,append)",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "write_mode": "create",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "artifact.written",
+      "artifact.blocked"
+    ]
+  },
+  "artifacts": {
+    "artifact": "{artifact_path}"
+  },
+  "template": [
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "{input}",
+        "format": "{artifact_format}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "{artifact_format}",
+        "write_policy": "The caller selected deterministic write mode {write_mode}; produce only the artifact content that should be written, with no surrounding commentary outside the artifact body.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "writer",
+      "values": {
+        "artifact_path": "{artifact_path}",
+        "mode": "{write_mode}"
+      }
+    },
+    {
+      "name": "message",
+      "values": {
+        "type": "artifact.written",
+        "summary": "Artifact written to path {artifact_path} using mode {write_mode}."
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-async-run-ops.json

@@ -0,0 +1,70 @@
+{
+  "async": true,
+  "imports": {
+    "snapshot": "utility-run-ops-snapshot.json",
+    "normalizer": "subagent-normalize.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "state_root:path",
+    "run_id:string",
+    "lines:int",
+    "stale_minutes:int",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "state_root": "~/.pi/agent/tmp/pi-actors/runs",
+    "run_id": "music",
+    "lines": "80",
+    "stale_minutes": "60",
+    "artifact_path": "./async-run-ops.md",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "operations.completed",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "snapshot",
+      "values": {
+        "state_root": "{state_root}",
+        "run_id": "{run_id}",
+        "lines": "{lines}",
+        "stale_minutes": "{stale_minutes}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use actor run operations snapshot JSON from stdin. State root: {state_root}. Inspected run: {run_id}.",
+        "format": "Markdown sections: Active Runs, Terminal Runs, Recent Actor Messages, Stale/Risky Runs, Recommended Controls, Follow-up Needed.",
+        "model": "{model}",
+        "thinking": "off",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized async-run operations report from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Status, Actor Messages, Risks, Recommended Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-checkpoint-continuation.json

@@ -0,0 +1,67 @@
+{
+  "async": true,
+  "imports": {
+    "checkpoint": "subagent-checkpoint.json",
+    "followup": "subagent-followup.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "state:string",
+    "question:string",
+    "reply:string",
+    "mode:enum(same-context,degraded-new-branch)",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "reply": "No coordinator reply provided yet; produce a checkpoint artifact only.",
+    "mode": "degraded-new-branch",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.reply",
+      "control.revise",
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "checkpoint.needs_input",
+      "checkpoint.continued",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "checkpoint",
+      "values": {
+        "state": "{state}",
+        "question": "{question}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "followup",
+      "values": {
+        "checkpoint": "Use checkpoint output from stdin.",
+        "reply": "{reply}",
+        "mode": "{mode}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use checkpoint and follow-up outputs from stdin.",
+        "format": "Markdown sections: Checkpoint, Coordinator Reply, Continuation Mode, Lost Context, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}