@llblab/pi-actors 0.22.5 → 0.24.0

package/dist/recipes/pipeline-review-readiness.json

@@ -0,0 +1,54 @@
+{
+  "async": true,
+  "imports": {
+    "coordinator": "subagent-review-coordinator.json"
+  },
+  "args": [
+    "scope:string",
+    "lenses:array",
+    "release_gate:string",
+    "reviewer_model:string",
+    "verifier_model:string",
+    "merger_model:string",
+    "judge_model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "lenses": [
+      "correctness",
+      "tests",
+      "release",
+      "operator UX"
+    ],
+    "release_gate": "The scope is safe to ship or hand to the next release step.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "review.completed",
+      "pipeline.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": {
+    "name": "coordinator",
+    "values": {
+      "scope": "{scope}",
+      "lenses": "{lenses}",
+      "claim": "{release_gate}",
+      "reviewer_model": "{reviewer_model}",
+      "verifier_model": "{verifier_model}",
+      "merger_model": "{merger_model}",
+      "judge_model": "{judge_model}",
+      "tools": "{tools}",
+      "output_format": "Markdown sections: Ship Verdict, Blocking Findings, Nonblocking Risks, Evidence, Required Follow-up."
+    }
+  }
+}

package/dist/recipes/pipeline-room-swarm.json

@@ -0,0 +1,50 @@
+{
+  "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",
+    "artifact_path:path",
+    "repo:path"
+  ],
+  "defaults": {
+    "mode": "consensus",
+    "thinking": "off",
+    "roles": "",
+    "roles_path": "",
+    "rounds": "4",
+    "delay": "10",
+    "locker": "false",
+    "locker_lease_ms": "600000",
+    "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.stop",
+      "control.cancel",
+      "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} --artifact-path={artifact_path}"
+}

package/dist/recipes/subagent-artifact.json

@@ -0,0 +1,32 @@
+{
+  "async": true,
+  "args": [
+    "input:string",
+    "artifact_path:path",
+    "artifact_format:string",
+    "write_policy:string",
+    "validation_policy:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "artifact_format": "Markdown with stable headings and preserved evidence.",
+    "write_policy": "Prepare content for the artifact path and state whether the caller should write, append, or review before writing.",
+    "validation_policy": "List checks the caller should run before accepting the artifact; distinguish required checks from optional review.",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "artifact.prepared",
+      "artifact.blocked"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Prepare a durable artifact. Target path: {artifact_path}. Format: {artifact_format}. Write policy: {write_policy}. Validation policy: {validation_policy}. Input: {input}"
+}

package/dist/recipes/subagent-checkpoint.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "state:string",
+    "question:string",
+    "options:string",
+    "resume_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "options": "List options considered, recommendation, and risk if the coordinator does not answer.",
+    "resume_policy": "Do not claim same-context resume unless the adapter provides a resumable session id; otherwise emit degraded artifact state.",
+    "output_format": "Markdown sections: Preserved State, Question, Options, Recommendation, Risk If Guessed, Resume Mode.",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.continue",
+      "control.revise",
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "checkpoint.needs_input"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Create a bounded coordinator checkpoint. State to preserve: {state}. Question: {question}. Options/risk format: {options}. Resume policy: {resume_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-conflict-report.json

@@ -0,0 +1,32 @@
+{
+  "async": true,
+  "args": [
+    "change:string",
+    "conflict:string",
+    "preserve_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "preserve_policy": "Describe what must be preserved, what can be discarded, and suggested resolver action.",
+    "output_format": "Markdown sections: Conflict, My Changes, Other Changes, Preserve, Discard, Suggested Resolution, Risks.",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "conflict_report.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Write a bounded conflict report. My change: {change}. Conflict: {conflict}. Preserve policy: {preserve_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-contradiction-map.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "inputs:string",
+    "focus:string",
+    "resolution_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "focus": "Find contradictions, unresolved assumptions, incompatible recommendations, and evidence gaps.",
+    "resolution_policy": "Do not force consensus; preserve unresolved conflicts and name what evidence would resolve them.",
+    "output_format": "Markdown sections: Contradictions, Affected Claims, Resolution Evidence, Unresolved Risks.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "contradiction.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Map contradictions in these inputs: {inputs}. Focus: {focus}. Resolution policy: {resolution_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-critic.json

@@ -0,0 +1,35 @@
+{
+  "async": true,
+  "args": [
+    "target:string",
+    "lens:string",
+    "constraints:string",
+    "risk_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "lens": "assumption and failure-mode critic",
+    "constraints": "Stay bounded to the target; do not redesign unrelated systems.",
+    "risk_policy": "Prefer falsifiable objections and separate blockers from caveats.",
+    "output_format": "Markdown sections: Assumptions, Failure Modes, Counterarguments, Tests, Recommendation.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "critique.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Critique this target through lens {lens}: {target}. Constraints: {constraints}. Risk policy: {risk_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-evidence-map.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "question:string",
+    "sources:string",
+    "source_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "sources": "Use only provided source notes, inspected artifacts, or explicit uncertainty.",
+    "source_policy": "Separate direct evidence, weak evidence, contradictions, and missing evidence.",
+    "output_format": "Markdown sections: Question, Evidence Map, Contradictions, Missing Evidence, Confidence.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "evidence.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Build an evidence map for question: {question}. Sources: {sources}. Source policy: {source_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-followup.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "checkpoint:string",
+    "reply:string",
+    "mode:enum(same-context,degraded-new-branch)",
+    "continuity_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "mode": "degraded-new-branch",
+    "continuity_policy": "If mode is degraded-new-branch, explicitly state what context continuity was lost and what was reconstructed from the checkpoint.",
+    "output_format": "Markdown sections: Continuation Mode, Applied Reply, Lost Context, Continued Work, Next Actions.",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.reply",
+      "control.revise",
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "checkpoint.continued"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Continue from checkpoint using mode {mode}. Checkpoint: {checkpoint}. Coordinator reply: {reply}. Continuity policy: {continuity_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-judge.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "report:string",
+    "rubric:string",
+    "evidence:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "rubric": "Judge evidence preservation, severity calibration, consensus purity, internal consistency, and merge bias.",
+    "evidence": "Use the provided raw outputs or artifact paths; mark any missing evidence.",
+    "output_format": "Markdown sections: Verdict, Issues, Evidence Preservation, Bias Risks, Required Fixes.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "judge.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Judge this report: {report}. Rubric: {rubric}. Evidence: {evidence}. Output format: {output_format}"
+}

package/dist/recipes/subagent-merge.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "inputs:string",
+    "mode:enum(consensus-first,risk-first)",
+    "risk_policy:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "mode": "consensus-first",
+    "risk_policy": "Preserve minority severe findings and mark merger-added claims explicitly.",
+    "output_format": "Markdown sections: Summary, Consensus, Minority Findings, Contradictions, Next Actions.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "merge.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Merge these subagent outputs using mode {mode}: {inputs}. Risk policy: {risk_policy}. Output format: {output_format}"
+}

package/dist/recipes/subagent-message.json

@@ -0,0 +1,34 @@
+{
+  "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.stop",
+      "control.cancel",
+      "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/dist/recipes/subagent-normalize.json

@@ -0,0 +1,31 @@
+{
+  "async": true,
+  "args": [
+    "input:string",
+    "format:string",
+    "preservation_policy:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "format": "Markdown sections: Summary, Findings, Evidence, Risks, Next Actions.",
+    "preservation_policy": "Do not change meaning, severity, evidence, or uncertainty while normalizing.",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "normalize.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Normalize this subagent output. Target format: {format}. Preservation policy: {preservation_policy}. Input: {input}"
+}

package/dist/recipes/subagent-plan.json

@@ -0,0 +1,33 @@
+{
+  "async": true,
+  "args": [
+    "goal:string",
+    "constraints:string",
+    "scope:string",
+    "output_format:string",
+    "model:string",
+    "thinking:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "constraints": "Prefer small reversible slices, explicit validation gates, and no broad speculative rewrites.",
+    "scope": "Use the provided problem statement and any named artifact paths.",
+    "output_format": "Markdown sections: Goal, Constraints, Plan Slices, Risks, Validation Gates, Stop Conditions.",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "plan.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} Plan how to reach this goal: {goal}. Scope: {scope}. Constraints: {constraints}. Output format: {output_format}"
+}

package/dist/recipes/subagent-prompt.json

@@ -0,0 +1,28 @@
+{
+  "async": true,
+  "args": [
+    "prompt:string",
+    "model:string",
+    "thinking:string",
+    "tools:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "thinking": "off",
+    "tools": "",
+    "output_format": "Concise Markdown with assumptions and next actions."
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": "pi -p --model {model} --thinking {thinking} {tools?--tools:--no-tools} {tools} {prompt}. Output format: {output_format}"
+}

package/dist/recipes/subagent-quorum.json

@@ -0,0 +1,43 @@
+{
+  "async": true,
+  "imports": {
+    "subagent": "subagent-prompt.json"
+  },
+  "args": [
+    "prompt:string",
+    "models:array",
+    "thinking:string",
+    "tools:string",
+    "output_format:string"
+  ],
+  "defaults": {
+    "thinking": "off",
+    "tools": "",
+    "output_format": "Vote-style Markdown: Verdict, Rationale, Evidence, Confidence."
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "repeat": "{models.length}",
+  "parallel": true,
+  "failure": "branch",
+  "template": {
+    "name": "subagent",
+    "values": {
+      "prompt": "{prompt}",
+      "model": "{models[index]}",
+      "thinking": "{thinking}",
+      "tools": "{tools}",
+      "output_format": "{output_format}"
+    }
+  }
+}