@llblab/pi-actors 0.12.0

package/recipes/pipeline-release-readiness.json

@@ -0,0 +1,83 @@
+{
+  "name": "pipeline-release-readiness",
+  "async": true,
+  "imports": {
+    "changelog": "utility-changelog-section.json",
+    "validation": "utility-validation-wrapper.json",
+    "review": "subagent-review-coordinator.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "scope:path",
+    "version:string",
+    "validation_command:string",
+    "artifact_path:path",
+    "lenses:array",
+    "reviewer_model:string",
+    "verifier_model:string",
+    "merger_model:string",
+    "judge_model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "scope": ".",
+    "version": "0.7.1",
+    "validation_command": "npm run validate",
+    "artifact_path": "./release-readiness.md",
+    "lenses": [
+      "release",
+      "package contents",
+      "operator UX",
+      "documentation"
+    ],
+    "reviewer_model": "openai-codex/gpt-5.5",
+    "verifier_model": "openai-codex/gpt-5.5",
+    "merger_model": "openai-codex/gpt-5.5",
+    "judge_model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["release.completed", "artifact.prepared", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "changelog",
+      "values": {
+        "file": "{scope}/CHANGELOG.md",
+        "version": "{version}"
+      }
+    },
+    {
+      "name": "validation",
+      "values": {
+        "scope": "{scope}",
+        "command": "{validation_command}"
+      }
+    },
+    {
+      "name": "review",
+      "values": {
+        "scope": "Release scope {scope} for version {version}. Use changelog and validation output from stdin.",
+        "lenses": "{lenses}",
+        "claim": "Version {version} is ready for release or the remaining blockers are explicitly identified.",
+        "reviewer_model": "{reviewer_model}",
+        "verifier_model": "{verifier_model}",
+        "merger_model": "{merger_model}",
+        "judge_model": "{judge_model}",
+        "tools": "{tools}",
+        "output_format": "Markdown sections: Release Verdict, Blocking Issues, Package/Docs Risks, Validation Evidence, Publish Notes, Required Follow-up."
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use release readiness review from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Release Verdict, Evidence, Risks, Checklist, Next Actions.",
+        "model": "{merger_model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-repo-health.json

@@ -0,0 +1,81 @@
+{
+  "name": "pipeline-repo-health",
+  "async": true,
+  "imports": {
+    "git_status": "utility-git-status.json",
+    "git_log": "utility-git-log.json",
+    "docs_index": "utility-markdown-index.json",
+    "validation": "utility-validation-wrapper.json",
+    "normalizer": "subagent-normalize.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "repo:path",
+    "docs_dir:path",
+    "validation_command:string",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "repo": ".",
+    "docs_dir": "docs",
+    "validation_command": "npm run validate",
+    "artifact_path": "./repo-health.md",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["repo_health.completed", "artifact.prepared", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "git_status",
+      "values": {
+        "repo": "{repo}"
+      }
+    },
+    {
+      "name": "git_log",
+      "values": {
+        "repo": "{repo}",
+        "count": "8"
+      }
+    },
+    {
+      "name": "docs_index",
+      "values": {
+        "directory": "{repo}/{docs_dir}",
+        "title": "Documentation Index"
+      }
+    },
+    {
+      "name": "validation",
+      "values": {
+        "scope": "{repo}",
+        "command": "{validation_command}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use repository status, recent log, docs index, and validation output from stdin. Repo: {repo}.",
+        "format": "Markdown sections: Branch State, Recent Commits, Docs Surface, Validation, Risks, Next Actions.",
+        "model": "{model}",
+        "thinking": "off",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized repo health output from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Branch State, Validation, Risks, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-research-synthesis.json

@@ -0,0 +1,87 @@
+{
+  "name": "pipeline-research-synthesis",
+  "async": true,
+  "imports": {
+    "planner": "subagent-plan.json",
+    "evidence": "subagent-evidence-map.json",
+    "contradictions": "subagent-contradiction-map.json",
+    "verifier": "subagent-verify.json",
+    "merger": "subagent-merge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "question:string",
+    "sources:string",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "sources": "Use provided source notes or artifact paths only; mark missing evidence.",
+    "constraints": "Bound the question, preserve contradictions, and avoid publication-style certainty when evidence is weak.",
+    "model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "emits": ["research.completed", "command.done", "run.done", "run.failed"]
+  },
+  "template": [
+    {
+      "name": "planner",
+      "values": {
+        "goal": "Answer research question: {question}",
+        "scope": "Sources: {sources}",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "evidence",
+      "values": {
+        "question": "{question}",
+        "sources": "{sources}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "contradictions",
+      "values": {
+        "inputs": "Use plan and evidence map from stdin.",
+        "focus": "Contradictions, weak evidence, and missing source classes for question: {question}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "verifier",
+      "values": {
+        "claim": "The synthesis can answer the research question within the stated constraints.",
+        "evidence": "Use plan, evidence map, and contradiction map from stdin.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use all previous research outputs from stdin.",
+        "mode": "risk-first",
+        "risk_policy": "Preserve uncertainty and contradictions over forced consensus.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use merged research synthesis from stdin.",
+        "format": "Markdown sections: Question, Evidence Map, Synthesis, Contradictions, Confidence, Missing Evidence, Next Evidence Slice.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/recipes/pipeline-review-readiness.json

@@ -0,0 +1,49 @@
+{
+  "name": "pipeline-review-readiness",
+  "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.",
+    "reviewer_model": "openai-codex/gpt-5.5",
+    "verifier_model": "openai-codex/gpt-5.5",
+    "merger_model": "openai-codex/gpt-5.5",
+    "judge_model": "openai-codex/gpt-5.5",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-artifact.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-artifact",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "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/recipes/subagent-checkpoint.json

@@ -0,0 +1,27 @@
+{
+  "name": "subagent-checkpoint",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.continue", "control.revise", "control.stop"],
+    "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/recipes/subagent-conflict-report.json

@@ -0,0 +1,25 @@
+{
+  "name": "subagent-conflict-report",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-contradiction-map.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-contradiction-map",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-critic.json

@@ -0,0 +1,28 @@
+{
+  "name": "subagent-critic",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-evidence-map.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-evidence-map",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-followup.json

@@ -0,0 +1,27 @@
+{
+  "name": "subagent-followup",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.reply", "control.revise", "control.stop"],
+    "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/recipes/subagent-judge.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-judge",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-merge.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-merge",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-message.json

@@ -0,0 +1,29 @@
+{
+  "name": "subagent-message",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "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/subagent-normalize.json

@@ -0,0 +1,24 @@
+{
+  "name": "subagent-normalize",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "off",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-plan.json

@@ -0,0 +1,26 @@
+{
+  "name": "subagent-plan",
+  "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.",
+    "model": "openai-codex/gpt-5.5",
+    "thinking": "medium",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": ["control.stop"],
+    "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/recipes/subagent-prompt.json

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