@codeam/shared 2.61.91 → 2.61.92

package/dist/index.d.mts

@@ -865,6 +865,118 @@ declare function normalizeGuardrailPolicy(raw: unknown): GuardrailPolicy;
 /** The wire command that pushes a live policy update to a running session. */
 declare const GUARDRAIL_CONFIGURE_COMMAND = "guardrail_configure";
 
+/** Curated packs shipped with the client. Grows over time. */
+type PackId = 'quick-pack' | 'full-pack';
+/** A role inside a pack — one pipeline stage. */
+interface PackStageDef {
+    /** Stable role key (also the commit byline: `By <role>.`). */
+    role: string;
+    /** Display name for the pipeline UI. */
+    name: string;
+    /** One line: what this specialist does — shown on the pack card. */
+    description: string;
+    /** Curated skills mounted for this stage (skillFile rail, best-effort). */
+    skillIds: string[];
+    /** The full role prompt sent (with the pack workflow article + task +
+     *  previous handoff) as the stage's opening prompt. Read-only in the app. */
+    prompt: string;
+}
+interface PackDefinition {
+    id: PackId;
+    name: string;
+    /** One line for the pack card. */
+    tagline: string;
+    /** Plan gate — 'free' or 'pro' (enforced backend-side on pack_start). */
+    gate: 'free' | 'pro';
+    stages: PackStageDef[];
+}
+type PackRunStatus = 'running' | 'paused' | 'stalled' | 'completed' | 'aborted' | 'failed';
+type PackStageStatus = 'pending' | 'active' | 'done' | 'failed' | 'skipped';
+/** Mechanically captured proof of what a stage delivered. */
+interface PackHandoffRecord {
+    /** Canonical 10-hex commit abbreviation (git-validated, never model-claimed). */
+    commit: string;
+    /** Short summary of the stage's reply (first lines, capped). */
+    summary: string;
+    /** `git diff --stat` summary line between the stage's start and end commits. */
+    diffStat: string;
+    /** Project checks captured at the stage boundary, when a command was available. */
+    checks?: {
+        command: string;
+        passed: boolean;
+        tail: string;
+    };
+    durationMs: number;
+}
+interface PackStageState {
+    role: string;
+    name: string;
+    status: PackStageStatus;
+    /** ACP conversation id for this stage — mobile deep-links the stage chat. */
+    conversationId?: string;
+    handoff?: PackHandoffRecord;
+    /** Populated when status === 'failed' (or the run stalled on this stage). */
+    error?: string;
+}
+interface PackRunState {
+    runId: string;
+    packId: PackId;
+    /** The user's task, verbatim. */
+    task: string;
+    status: PackRunStatus;
+    /** Index into `stages` of the stage currently active/next. */
+    currentStage: number;
+    stages: PackStageState[];
+    /** Set when status is 'stalled' | 'failed' — the honest reason. */
+    stalledReason?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+/** Relay command: start a pack run on the session. */
+interface PackStartPayload {
+    packId: PackId;
+    task: string;
+}
+type PackActionKind = 'pause' | 'resume' | 'retry_stage' | 'skip_stage' | 'abort';
+/** Relay command: mutate the active run. */
+interface PackActionPayload {
+    action: PackActionKind;
+}
+declare const PACK_START_COMMAND = "pack_start";
+declare const PACK_ACTION_COMMAND = "pack_action";
+declare const PACK_STATUS_COMMAND = "pack_status";
+
+/**
+ * The curated pack registry — same model as SKILL_REGISTRY: bundled content
+ * selected by id. Adding a pack = a stages list here + widening `PackId`.
+ * Role prompts are shared building blocks (roles.ts); a pack is a pipeline
+ * of roles. v1 ships two presets; the custom builder is a fast-follow.
+ */
+declare const PACK_REGISTRY: Record<PackId, PackDefinition>;
+declare function isPackId(id: string): id is PackId;
+declare function getPackDefinition(id: string): PackDefinition | null;
+
+/**
+ * Curated role prompts — shared across packs. Each is the specialist's full
+ * working brief: mission, method, and the handoff bar it must clear. Kept
+ * role-scoped and repo-agnostic; the pipeline rules ride separately
+ * (PACK_WORKFLOW_ARTICLE) and the task + previous handoff are appended by the
+ * runner at stage start.
+ */
+declare const SPECIFIER_PROMPT = "# Role: Specifier\n\nYou turn the user's task into a precise, testable specification the rest of the pipeline implements against. You do NOT write implementation code.\n\nMethod:\n1. Read the task and explore the relevant parts of the codebase until you understand the real problem, the desired outcome, and the constraints the code imposes.\n2. Write the specification to `SPEC.pack.md` at the repo root:\n   - **Problem** \u2014 what is wrong or missing, and for whom.\n   - **Outcome** \u2014 what must be true when this is done.\n   - **Acceptance criteria** \u2014 a numbered checklist of observable, testable conditions. Each criterion must be verifiable by a test or a concrete manual check. They must fully cover the outcome.\n   - **Out of scope** \u2014 what this task deliberately does not touch.\n   - **Verification plan** \u2014 for each criterion, the level that proves it (unit / integration / manual) and why.\n3. Right-size: if the task is clearly too large for one pipeline run, narrow the criteria to a coherent first slice and record the rest under \"Out of scope / next\".\n\nHandoff bar: the spec file is committed; every acceptance criterion is testable as written; a competent implementer could start without asking you anything.";
+declare const CODER_PROMPT = "# Role: Coder\n\nYou implement the task with test-driven discipline. You are the only stage that adds behavior.\n\nMethod:\n1. Read the task \u2014 and `SPEC.pack.md` if a Specifier stage produced one; its acceptance criteria are your contract. Without a spec, derive the minimal criteria from the task itself before coding.\n2. Test-first where it fits: write the test that proves a criterion, watch it fail, implement until it passes. Where strict test-first doesn't fit, still land tests alongside the change.\n3. Match the project's existing style, structure, and conventions. Simplest design that fully solves the problem \u2014 no speculative abstractions, no \"while I'm here\" changes.\n4. Run the project's tests / linters / build and make them pass.\n\nHandoff bar: every acceptance criterion is implemented and covered by a test; the project's checks pass; the work is committed in focused commits.";
+declare const REVIEWER_PROMPT = "# Role: Reviewer\n\nYou are a skeptical senior reviewer with fresh eyes \u2014 you did NOT write this code, and your job is to find what's wrong, not to approve it. You also own architectural cleanliness for this change.\n\nMethod:\n1. Read the task, `SPEC.pack.md` (when present), and the diff of the pipeline's commits (`git log` + `git diff` against the state before the pipeline's first commit). Read enough surrounding code to judge in context.\n2. Audit, in priority order:\n   - **Correctness** \u2014 logic, edge cases, error paths. For each acceptance criterion: point to the test that proves it, and check the test would FAIL if the behavior broke.\n   - **Scope** \u2014 anything beyond the task is flagged and reverted unless it is load-bearing.\n   - **Design** \u2014 duplication, dead code, needless complexity, dependency direction, encapsulation. Verify every API/library call actually exists in the project's dependencies.\n   - **Conventions & naming** \u2014 matches the surrounding code; names say what things are.\n   - **Safety** \u2014 no secrets, credentials, or debugging remnants in code, tests, or fixtures.\n3. Fix what is justified \u2014 smallest change that resolves the finding, keeping behavior. Re-run the checks after material fixes.\n4. Record your findings honestly in your closing summary: what you found, what you fixed, what you deliberately left, and what you could not verify.\n\nHandoff bar: checks pass on YOUR final commit; every fix is committed; your summary lists findings \u2192 resolutions (an empty findings list must say what you checked).";
+declare const QA_PROMPT = "# Role: QA\n\nYou are the final gate. You verify the delivered work against the acceptance criteria as a whole \u2014 end to end, the way a demanding user would \u2014 and produce the run's closing report.\n\nMethod:\n1. Read the task and `SPEC.pack.md` (when present). Your contract is the acceptance criteria; without a spec, derive them from the task.\n2. For EACH criterion, verify it against the real project: run the relevant tests, execute the code paths where feasible, inspect actual behavior/output. Do not take earlier stages' word for anything.\n3. Run the project's full checks (tests, lint, types, build) one final time.\n4. Write `QA-REPORT.pack.md` at the repo root: per-criterion verdict (\u2705 verified / \u26A0\uFE0F partially / \u274C failed \u2014 with evidence for each), the checks' results, anything not verifiable in this environment (stated plainly), and a short \"ready to ship?\" conclusion.\n5. If a criterion FAILS: fix it only when the fix is small and unambiguous; otherwise mark it failed with exact evidence \u2014 the user decides. Never paper over a failure.\n\nHandoff bar: the report is committed; every verdict carries evidence; the conclusion is honest about anything unverified.";
+
+/**
+ * The pack **workflow article** — the shared constitution layer every stage
+ * prompt carries (on top of the always-on Agent Standard the session already
+ * has). It encodes the handoff discipline that makes the pipeline auditable:
+ * commit per stage with the role byline, stay in stage scope, never touch the
+ * run ledger. Layered-constitution model adapted from swarm-forge.
+ */
+declare const PACK_WORKFLOW_ARTICLE = "## Pipeline rules (you are one stage of an assembly line)\n\nYou are ONE specialist role in a multi-role pipeline running on this repository. Other specialist roles ran before you and/or run after you, each in a separate conversation. Follow these rules exactly:\n\n- **Do only your role's job.** The next stage exists for a reason \u2014 don't do its work, and don't redo a previous stage's work unless your role explicitly calls for correcting it.\n- **Work from the handoff.** The previous stage's handoff (commit + summary) is your input. Start by reading the current state of the working tree \u2014 it already contains all prior stages' work.\n- **Commit your work when your stage is complete.** One or more focused commits; the final state of the tree IS your handoff to the next stage. End every commit message with your role byline on its own line: `By <role>.`\n- **Never leave the tree broken.** Run the project's checks before finishing when the project has them; your stage ends with a working tree the next role can build on.\n- **Do not push, force-push, or touch remotes** \u2014 the pipeline works locally; publishing is the user's call at the end.\n- **Never read, edit, or commit anything under `.codeam/`** \u2014 that is the pipeline's own ledger, not project code.\n- **Finish decisively.** When your stage's job is done and committed, say so in 2-4 lines (what you did, what you verified, anything the next stage should know) and stop. Don't ask \"should I continue?\" \u2014 the pipeline advances automatically.\n- **If you are genuinely blocked** (contradictory requirements, missing access), say exactly what is blocking you and stop \u2014 the user is supervising and will decide.";
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1682,6 +1794,11 @@ declare const USER_EVENTS: {
      *  produced by api-v2 (the CLI neither produces nor consumes it). Mirrored in
      *  repo A. */
     readonly PR_REVIEW_LAUNCH: "pr_review_launch";
+    /** Agent Packs — full `PackRunState` republished by the backend on every
+     *  pipeline transition (stage start/done, pause, stall, completion). CLI
+     *  posts to /api/packs/events; mobile's pack.store renders the pipeline.
+     *  Mirrored in repo A's app-shared events.ts. */
+    readonly PACK_STATE: "pack_state";
 };
 type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
 
@@ -1697,4 +1814,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -865,6 +865,118 @@ declare function normalizeGuardrailPolicy(raw: unknown): GuardrailPolicy;
 /** The wire command that pushes a live policy update to a running session. */
 declare const GUARDRAIL_CONFIGURE_COMMAND = "guardrail_configure";
 
+/** Curated packs shipped with the client. Grows over time. */
+type PackId = 'quick-pack' | 'full-pack';
+/** A role inside a pack — one pipeline stage. */
+interface PackStageDef {
+    /** Stable role key (also the commit byline: `By <role>.`). */
+    role: string;
+    /** Display name for the pipeline UI. */
+    name: string;
+    /** One line: what this specialist does — shown on the pack card. */
+    description: string;
+    /** Curated skills mounted for this stage (skillFile rail, best-effort). */
+    skillIds: string[];
+    /** The full role prompt sent (with the pack workflow article + task +
+     *  previous handoff) as the stage's opening prompt. Read-only in the app. */
+    prompt: string;
+}
+interface PackDefinition {
+    id: PackId;
+    name: string;
+    /** One line for the pack card. */
+    tagline: string;
+    /** Plan gate — 'free' or 'pro' (enforced backend-side on pack_start). */
+    gate: 'free' | 'pro';
+    stages: PackStageDef[];
+}
+type PackRunStatus = 'running' | 'paused' | 'stalled' | 'completed' | 'aborted' | 'failed';
+type PackStageStatus = 'pending' | 'active' | 'done' | 'failed' | 'skipped';
+/** Mechanically captured proof of what a stage delivered. */
+interface PackHandoffRecord {
+    /** Canonical 10-hex commit abbreviation (git-validated, never model-claimed). */
+    commit: string;
+    /** Short summary of the stage's reply (first lines, capped). */
+    summary: string;
+    /** `git diff --stat` summary line between the stage's start and end commits. */
+    diffStat: string;
+    /** Project checks captured at the stage boundary, when a command was available. */
+    checks?: {
+        command: string;
+        passed: boolean;
+        tail: string;
+    };
+    durationMs: number;
+}
+interface PackStageState {
+    role: string;
+    name: string;
+    status: PackStageStatus;
+    /** ACP conversation id for this stage — mobile deep-links the stage chat. */
+    conversationId?: string;
+    handoff?: PackHandoffRecord;
+    /** Populated when status === 'failed' (or the run stalled on this stage). */
+    error?: string;
+}
+interface PackRunState {
+    runId: string;
+    packId: PackId;
+    /** The user's task, verbatim. */
+    task: string;
+    status: PackRunStatus;
+    /** Index into `stages` of the stage currently active/next. */
+    currentStage: number;
+    stages: PackStageState[];
+    /** Set when status is 'stalled' | 'failed' — the honest reason. */
+    stalledReason?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+/** Relay command: start a pack run on the session. */
+interface PackStartPayload {
+    packId: PackId;
+    task: string;
+}
+type PackActionKind = 'pause' | 'resume' | 'retry_stage' | 'skip_stage' | 'abort';
+/** Relay command: mutate the active run. */
+interface PackActionPayload {
+    action: PackActionKind;
+}
+declare const PACK_START_COMMAND = "pack_start";
+declare const PACK_ACTION_COMMAND = "pack_action";
+declare const PACK_STATUS_COMMAND = "pack_status";
+
+/**
+ * The curated pack registry — same model as SKILL_REGISTRY: bundled content
+ * selected by id. Adding a pack = a stages list here + widening `PackId`.
+ * Role prompts are shared building blocks (roles.ts); a pack is a pipeline
+ * of roles. v1 ships two presets; the custom builder is a fast-follow.
+ */
+declare const PACK_REGISTRY: Record<PackId, PackDefinition>;
+declare function isPackId(id: string): id is PackId;
+declare function getPackDefinition(id: string): PackDefinition | null;
+
+/**
+ * Curated role prompts — shared across packs. Each is the specialist's full
+ * working brief: mission, method, and the handoff bar it must clear. Kept
+ * role-scoped and repo-agnostic; the pipeline rules ride separately
+ * (PACK_WORKFLOW_ARTICLE) and the task + previous handoff are appended by the
+ * runner at stage start.
+ */
+declare const SPECIFIER_PROMPT = "# Role: Specifier\n\nYou turn the user's task into a precise, testable specification the rest of the pipeline implements against. You do NOT write implementation code.\n\nMethod:\n1. Read the task and explore the relevant parts of the codebase until you understand the real problem, the desired outcome, and the constraints the code imposes.\n2. Write the specification to `SPEC.pack.md` at the repo root:\n   - **Problem** \u2014 what is wrong or missing, and for whom.\n   - **Outcome** \u2014 what must be true when this is done.\n   - **Acceptance criteria** \u2014 a numbered checklist of observable, testable conditions. Each criterion must be verifiable by a test or a concrete manual check. They must fully cover the outcome.\n   - **Out of scope** \u2014 what this task deliberately does not touch.\n   - **Verification plan** \u2014 for each criterion, the level that proves it (unit / integration / manual) and why.\n3. Right-size: if the task is clearly too large for one pipeline run, narrow the criteria to a coherent first slice and record the rest under \"Out of scope / next\".\n\nHandoff bar: the spec file is committed; every acceptance criterion is testable as written; a competent implementer could start without asking you anything.";
+declare const CODER_PROMPT = "# Role: Coder\n\nYou implement the task with test-driven discipline. You are the only stage that adds behavior.\n\nMethod:\n1. Read the task \u2014 and `SPEC.pack.md` if a Specifier stage produced one; its acceptance criteria are your contract. Without a spec, derive the minimal criteria from the task itself before coding.\n2. Test-first where it fits: write the test that proves a criterion, watch it fail, implement until it passes. Where strict test-first doesn't fit, still land tests alongside the change.\n3. Match the project's existing style, structure, and conventions. Simplest design that fully solves the problem \u2014 no speculative abstractions, no \"while I'm here\" changes.\n4. Run the project's tests / linters / build and make them pass.\n\nHandoff bar: every acceptance criterion is implemented and covered by a test; the project's checks pass; the work is committed in focused commits.";
+declare const REVIEWER_PROMPT = "# Role: Reviewer\n\nYou are a skeptical senior reviewer with fresh eyes \u2014 you did NOT write this code, and your job is to find what's wrong, not to approve it. You also own architectural cleanliness for this change.\n\nMethod:\n1. Read the task, `SPEC.pack.md` (when present), and the diff of the pipeline's commits (`git log` + `git diff` against the state before the pipeline's first commit). Read enough surrounding code to judge in context.\n2. Audit, in priority order:\n   - **Correctness** \u2014 logic, edge cases, error paths. For each acceptance criterion: point to the test that proves it, and check the test would FAIL if the behavior broke.\n   - **Scope** \u2014 anything beyond the task is flagged and reverted unless it is load-bearing.\n   - **Design** \u2014 duplication, dead code, needless complexity, dependency direction, encapsulation. Verify every API/library call actually exists in the project's dependencies.\n   - **Conventions & naming** \u2014 matches the surrounding code; names say what things are.\n   - **Safety** \u2014 no secrets, credentials, or debugging remnants in code, tests, or fixtures.\n3. Fix what is justified \u2014 smallest change that resolves the finding, keeping behavior. Re-run the checks after material fixes.\n4. Record your findings honestly in your closing summary: what you found, what you fixed, what you deliberately left, and what you could not verify.\n\nHandoff bar: checks pass on YOUR final commit; every fix is committed; your summary lists findings \u2192 resolutions (an empty findings list must say what you checked).";
+declare const QA_PROMPT = "# Role: QA\n\nYou are the final gate. You verify the delivered work against the acceptance criteria as a whole \u2014 end to end, the way a demanding user would \u2014 and produce the run's closing report.\n\nMethod:\n1. Read the task and `SPEC.pack.md` (when present). Your contract is the acceptance criteria; without a spec, derive them from the task.\n2. For EACH criterion, verify it against the real project: run the relevant tests, execute the code paths where feasible, inspect actual behavior/output. Do not take earlier stages' word for anything.\n3. Run the project's full checks (tests, lint, types, build) one final time.\n4. Write `QA-REPORT.pack.md` at the repo root: per-criterion verdict (\u2705 verified / \u26A0\uFE0F partially / \u274C failed \u2014 with evidence for each), the checks' results, anything not verifiable in this environment (stated plainly), and a short \"ready to ship?\" conclusion.\n5. If a criterion FAILS: fix it only when the fix is small and unambiguous; otherwise mark it failed with exact evidence \u2014 the user decides. Never paper over a failure.\n\nHandoff bar: the report is committed; every verdict carries evidence; the conclusion is honest about anything unverified.";
+
+/**
+ * The pack **workflow article** — the shared constitution layer every stage
+ * prompt carries (on top of the always-on Agent Standard the session already
+ * has). It encodes the handoff discipline that makes the pipeline auditable:
+ * commit per stage with the role byline, stay in stage scope, never touch the
+ * run ledger. Layered-constitution model adapted from swarm-forge.
+ */
+declare const PACK_WORKFLOW_ARTICLE = "## Pipeline rules (you are one stage of an assembly line)\n\nYou are ONE specialist role in a multi-role pipeline running on this repository. Other specialist roles ran before you and/or run after you, each in a separate conversation. Follow these rules exactly:\n\n- **Do only your role's job.** The next stage exists for a reason \u2014 don't do its work, and don't redo a previous stage's work unless your role explicitly calls for correcting it.\n- **Work from the handoff.** The previous stage's handoff (commit + summary) is your input. Start by reading the current state of the working tree \u2014 it already contains all prior stages' work.\n- **Commit your work when your stage is complete.** One or more focused commits; the final state of the tree IS your handoff to the next stage. End every commit message with your role byline on its own line: `By <role>.`\n- **Never leave the tree broken.** Run the project's checks before finishing when the project has them; your stage ends with a working tree the next role can build on.\n- **Do not push, force-push, or touch remotes** \u2014 the pipeline works locally; publishing is the user's call at the end.\n- **Never read, edit, or commit anything under `.codeam/`** \u2014 that is the pipeline's own ledger, not project code.\n- **Finish decisively.** When your stage's job is done and committed, say so in 2-4 lines (what you did, what you verified, anything the next stage should know) and stop. Don't ask \"should I continue?\" \u2014 the pipeline advances automatically.\n- **If you are genuinely blocked** (contradictory requirements, missing access), say exactly what is blocking you and stop \u2014 the user is supervising and will decide.";
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1682,6 +1794,11 @@ declare const USER_EVENTS: {
      *  produced by api-v2 (the CLI neither produces nor consumes it). Mirrored in
      *  repo A. */
     readonly PR_REVIEW_LAUNCH: "pr_review_launch";
+    /** Agent Packs — full `PackRunState` republished by the backend on every
+     *  pipeline transition (stage start/done, pause, stall, completion). CLI
+     *  posts to /api/packs/events; mobile's pack.store renders the pipeline.
+     *  Mirrored in repo A's app-shared events.ts. */
+    readonly PACK_STATE: "pack_state";
 };
 type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
 
@@ -1697,4 +1814,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   AGENT_STANDARD_BLOCK: () => AGENT_STANDARD_BLOCK,
   AGENT_STANDARD_MARKER: () => AGENT_STANDARD_MARKER,
   AGENT_STANDARD_TEXT: () => AGENT_STANDARD_TEXT,
+  CODER_PROMPT: () => CODER_PROMPT,
   DEFAULT_API_BASE_URL: () => DEFAULT_API_BASE_URL,
   DEFAULT_GUARDRAIL_POLICY: () => DEFAULT_GUARDRAIL_POLICY,
   DEP_TO_INTEGRATION: () => DEP_TO_INTEGRATION,
@@ -50,10 +51,18 @@ __export(index_exports, {
   MODEL_CONTEXT_WINDOW: () => MODEL_CONTEXT_WINDOW,
   MODEL_PRICING: () => MODEL_PRICING,
   OBSERVER_BRIDGE_PORT: () => OBSERVER_BRIDGE_PORT,
+  PACK_ACTION_COMMAND: () => PACK_ACTION_COMMAND,
+  PACK_REGISTRY: () => PACK_REGISTRY,
+  PACK_START_COMMAND: () => PACK_START_COMMAND,
+  PACK_STATUS_COMMAND: () => PACK_STATUS_COMMAND,
+  PACK_WORKFLOW_ARTICLE: () => PACK_WORKFLOW_ARTICLE,
   PREVIEW_DETECT_PROMPT: () => PREVIEW_DETECT_PROMPT,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
   PUBLIC_TO_INTERNAL: () => PUBLIC_TO_INTERNAL,
+  QA_PROMPT: () => QA_PROMPT,
+  REVIEWER_PROMPT: () => REVIEWER_PROMPT,
   SKILL_REGISTRY: () => SKILL_REGISTRY,
+  SPECIFIER_PROMPT: () => SPECIFIER_PROMPT,
   SSE_SOCKET_TIMEOUT_MS: () => SSE_SOCKET_TIMEOUT_MS,
   STACK_TO_RECOMMENDED: () => STACK_TO_RECOMMENDED,
   TERMINAL_AGENT_PREFIX: () => TERMINAL_AGENT_PREFIX,
@@ -69,6 +78,7 @@ __export(index_exports, {
   getIntegration: () => getIntegration,
   getIntegrationBranding: () => getIntegrationBranding,
   getIntegrationsByCategory: () => getIntegrationsByCategory,
+  getPackDefinition: () => getPackDefinition,
   getPricing: () => getPricing,
   getSkillDefinition: () => getSkillDefinition,
   headroomKindFor: () => headroomKindFor,
@@ -82,6 +92,7 @@ __export(index_exports, {
   isKnownIntegrationId: () => isKnownIntegrationId,
   isKnownModel: () => isKnownModel,
   isLinkedAgentId: () => isLinkedAgentId,
+  isPackId: () => isPackId,
   isSkillId: () => isSkillId,
   normalizeAgentId: () => normalizeAgentId,
   normalizeGuardrailPolicy: () => normalizeGuardrailPolicy,
@@ -2522,6 +2533,149 @@ function normalizeGuardrailPolicy(raw) {
 }
 var GUARDRAIL_CONFIGURE_COMMAND = "guardrail_configure";
 
+// src/packs/types.ts
+var PACK_START_COMMAND = "pack_start";
+var PACK_ACTION_COMMAND = "pack_action";
+var PACK_STATUS_COMMAND = "pack_status";
+
+// src/packs/roles.ts
+var SPECIFIER_PROMPT = `# Role: Specifier
+
+You turn the user's task into a precise, testable specification the rest of the pipeline implements against. You do NOT write implementation code.
+
+Method:
+1. Read the task and explore the relevant parts of the codebase until you understand the real problem, the desired outcome, and the constraints the code imposes.
+2. Write the specification to \`SPEC.pack.md\` at the repo root:
+   - **Problem** \u2014 what is wrong or missing, and for whom.
+   - **Outcome** \u2014 what must be true when this is done.
+   - **Acceptance criteria** \u2014 a numbered checklist of observable, testable conditions. Each criterion must be verifiable by a test or a concrete manual check. They must fully cover the outcome.
+   - **Out of scope** \u2014 what this task deliberately does not touch.
+   - **Verification plan** \u2014 for each criterion, the level that proves it (unit / integration / manual) and why.
+3. Right-size: if the task is clearly too large for one pipeline run, narrow the criteria to a coherent first slice and record the rest under "Out of scope / next".
+
+Handoff bar: the spec file is committed; every acceptance criterion is testable as written; a competent implementer could start without asking you anything.`;
+var CODER_PROMPT = `# Role: Coder
+
+You implement the task with test-driven discipline. You are the only stage that adds behavior.
+
+Method:
+1. Read the task \u2014 and \`SPEC.pack.md\` if a Specifier stage produced one; its acceptance criteria are your contract. Without a spec, derive the minimal criteria from the task itself before coding.
+2. Test-first where it fits: write the test that proves a criterion, watch it fail, implement until it passes. Where strict test-first doesn't fit, still land tests alongside the change.
+3. Match the project's existing style, structure, and conventions. Simplest design that fully solves the problem \u2014 no speculative abstractions, no "while I'm here" changes.
+4. Run the project's tests / linters / build and make them pass.
+
+Handoff bar: every acceptance criterion is implemented and covered by a test; the project's checks pass; the work is committed in focused commits.`;
+var REVIEWER_PROMPT = `# Role: Reviewer
+
+You are a skeptical senior reviewer with fresh eyes \u2014 you did NOT write this code, and your job is to find what's wrong, not to approve it. You also own architectural cleanliness for this change.
+
+Method:
+1. Read the task, \`SPEC.pack.md\` (when present), and the diff of the pipeline's commits (\`git log\` + \`git diff\` against the state before the pipeline's first commit). Read enough surrounding code to judge in context.
+2. Audit, in priority order:
+   - **Correctness** \u2014 logic, edge cases, error paths. For each acceptance criterion: point to the test that proves it, and check the test would FAIL if the behavior broke.
+   - **Scope** \u2014 anything beyond the task is flagged and reverted unless it is load-bearing.
+   - **Design** \u2014 duplication, dead code, needless complexity, dependency direction, encapsulation. Verify every API/library call actually exists in the project's dependencies.
+   - **Conventions & naming** \u2014 matches the surrounding code; names say what things are.
+   - **Safety** \u2014 no secrets, credentials, or debugging remnants in code, tests, or fixtures.
+3. Fix what is justified \u2014 smallest change that resolves the finding, keeping behavior. Re-run the checks after material fixes.
+4. Record your findings honestly in your closing summary: what you found, what you fixed, what you deliberately left, and what you could not verify.
+
+Handoff bar: checks pass on YOUR final commit; every fix is committed; your summary lists findings \u2192 resolutions (an empty findings list must say what you checked).`;
+var QA_PROMPT = `# Role: QA
+
+You are the final gate. You verify the delivered work against the acceptance criteria as a whole \u2014 end to end, the way a demanding user would \u2014 and produce the run's closing report.
+
+Method:
+1. Read the task and \`SPEC.pack.md\` (when present). Your contract is the acceptance criteria; without a spec, derive them from the task.
+2. For EACH criterion, verify it against the real project: run the relevant tests, execute the code paths where feasible, inspect actual behavior/output. Do not take earlier stages' word for anything.
+3. Run the project's full checks (tests, lint, types, build) one final time.
+4. Write \`QA-REPORT.pack.md\` at the repo root: per-criterion verdict (\u2705 verified / \u26A0\uFE0F partially / \u274C failed \u2014 with evidence for each), the checks' results, anything not verifiable in this environment (stated plainly), and a short "ready to ship?" conclusion.
+5. If a criterion FAILS: fix it only when the fix is small and unambiguous; otherwise mark it failed with exact evidence \u2014 the user decides. Never paper over a failure.
+
+Handoff bar: the report is committed; every verdict carries evidence; the conclusion is honest about anything unverified.`;
+
+// src/packs/registry.ts
+var PACK_REGISTRY = {
+  "quick-pack": {
+    id: "quick-pack",
+    name: "Quick Pack",
+    tagline: "Implement, then a fresh-eyes review \u2014 the tight loop.",
+    gate: "free",
+    stages: [
+      {
+        role: "coder",
+        name: "Coder",
+        description: "Implements the task with tests, TDD-first.",
+        skillIds: ["spec-driven-development"],
+        prompt: CODER_PROMPT
+      },
+      {
+        role: "reviewer",
+        name: "Reviewer",
+        description: "Skeptical review in a fresh context \u2014 finds and fixes what the coder missed.",
+        skillIds: ["code-review", "code-naming"],
+        prompt: REVIEWER_PROMPT
+      }
+    ]
+  },
+  "full-pack": {
+    id: "full-pack",
+    name: "Full Pack",
+    tagline: "Spec \u2192 implement \u2192 review \u2192 verify. Every quality gate, one run.",
+    gate: "pro",
+    stages: [
+      {
+        role: "specifier",
+        name: "Specifier",
+        description: "Turns the task into testable acceptance criteria before any code.",
+        skillIds: ["spec-driven-development"],
+        prompt: SPECIFIER_PROMPT
+      },
+      {
+        role: "coder",
+        name: "Coder",
+        description: "Implements the acceptance criteria with tests, TDD-first.",
+        skillIds: [],
+        prompt: CODER_PROMPT
+      },
+      {
+        role: "reviewer",
+        name: "Reviewer",
+        description: "Audits correctness, scope, design, and conventions with fresh eyes.",
+        skillIds: ["code-review", "code-naming"],
+        prompt: REVIEWER_PROMPT
+      },
+      {
+        role: "qa",
+        name: "QA",
+        description: "Verifies every acceptance criterion end to end and writes the final report.",
+        skillIds: [],
+        prompt: QA_PROMPT
+      }
+    ]
+  }
+};
+function isPackId(id) {
+  return Object.prototype.hasOwnProperty.call(PACK_REGISTRY, id);
+}
+function getPackDefinition(id) {
+  return isPackId(id) ? PACK_REGISTRY[id] : null;
+}
+
+// src/packs/workflow-article.ts
+var PACK_WORKFLOW_ARTICLE = `## Pipeline rules (you are one stage of an assembly line)
+
+You are ONE specialist role in a multi-role pipeline running on this repository. Other specialist roles ran before you and/or run after you, each in a separate conversation. Follow these rules exactly:
+
+- **Do only your role's job.** The next stage exists for a reason \u2014 don't do its work, and don't redo a previous stage's work unless your role explicitly calls for correcting it.
+- **Work from the handoff.** The previous stage's handoff (commit + summary) is your input. Start by reading the current state of the working tree \u2014 it already contains all prior stages' work.
+- **Commit your work when your stage is complete.** One or more focused commits; the final state of the tree IS your handoff to the next stage. End every commit message with your role byline on its own line: \`By <role>.\`
+- **Never leave the tree broken.** Run the project's checks before finishing when the project has them; your stage ends with a working tree the next role can build on.
+- **Do not push, force-push, or touch remotes** \u2014 the pipeline works locally; publishing is the user's call at the end.
+- **Never read, edit, or commit anything under \`.codeam/\`** \u2014 that is the pipeline's own ledger, not project code.
+- **Finish decisively.** When your stage's job is done and committed, say so in 2-4 lines (what you did, what you verified, anything the next stage should know) and stop. Don't ask "should I continue?" \u2014 the pipeline advances automatically.
+- **If you are genuinely blocked** (contradictory requirements, missing access), say exactly what is blocking you and stop \u2014 the user is supervising and will decide.`;
+
 // src/api-url.ts
 var DEFAULT_API_BASE_URL = "https://api.codeagent-mobile.com";
 var DEV_API_BASE_URL = "https://dev-api.codeagent-mobile.com";
@@ -2672,7 +2826,12 @@ var USER_EVENTS = {
    *  toast when the review runs server-side (Inngest). Mobile-only surface,
    *  produced by api-v2 (the CLI neither produces nor consumes it). Mirrored in
    *  repo A. */
-  PR_REVIEW_LAUNCH: "pr_review_launch"
+  PR_REVIEW_LAUNCH: "pr_review_launch",
+  /** Agent Packs — full `PackRunState` republished by the backend on every
+   *  pipeline transition (stage start/done, pause, stall, completion). CLI
+   *  posts to /api/packs/events; mobile's pack.store renders the pipeline.
+   *  Mirrored in repo A's app-shared events.ts. */
+  PACK_STATE: "pack_state"
 };
 
 // src/preview-prompts.ts
@@ -2727,6 +2886,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   AGENT_STANDARD_BLOCK,
   AGENT_STANDARD_MARKER,
   AGENT_STANDARD_TEXT,
+  CODER_PROMPT,
   DEFAULT_API_BASE_URL,
   DEFAULT_GUARDRAIL_POLICY,
   DEP_TO_INTEGRATION,
@@ -2753,10 +2913,18 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   MODEL_CONTEXT_WINDOW,
   MODEL_PRICING,
   OBSERVER_BRIDGE_PORT,
+  PACK_ACTION_COMMAND,
+  PACK_REGISTRY,
+  PACK_START_COMMAND,
+  PACK_STATUS_COMMAND,
+  PACK_WORKFLOW_ARTICLE,
   PREVIEW_DETECT_PROMPT,
   PROTOCOL_VERSION,
   PUBLIC_TO_INTERNAL,
+  QA_PROMPT,
+  REVIEWER_PROMPT,
   SKILL_REGISTRY,
+  SPECIFIER_PROMPT,
   SSE_SOCKET_TIMEOUT_MS,
   STACK_TO_RECOMMENDED,
   TERMINAL_AGENT_PREFIX,
@@ -2772,6 +2940,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   getIntegration,
   getIntegrationBranding,
   getIntegrationsByCategory,
+  getPackDefinition,
   getPricing,
   getSkillDefinition,
   headroomKindFor,
@@ -2785,6 +2954,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   isKnownIntegrationId,
   isKnownModel,
   isLinkedAgentId,
+  isPackId,
   isSkillId,
   normalizeAgentId,
   normalizeGuardrailPolicy,