thehood 0.1.0-preview.0

package/dist/providers/markdownPayload.js

@@ -0,0 +1,29 @@
+export const agentMarkdownField = "markdown";
+export const agentMarkdownTruncatedField = "markdownTruncated";
+export const agentMarkdownCharLengthField = "markdownCharLength";
+export const agentMarkdownFieldDescription = "Human-facing markdown for plans, reports, reviews, rationale, or other narrative content. Keep mechanical control fields outside this markdown.";
+export const extractAgentMarkdown = (payload) => {
+    const value = payload?.[agentMarkdownField];
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+};
+const isJsonObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const boundMarkdownField = (payload, maxChars) => {
+    const markdown = payload[agentMarkdownField];
+    if (typeof markdown !== "string" || markdown.length <= maxChars) {
+        return;
+    }
+    payload[agentMarkdownField] = markdown.slice(0, maxChars);
+    payload[agentMarkdownTruncatedField] = true;
+    payload[agentMarkdownCharLengthField] = markdown.length;
+};
+export const boundAgentMarkdownPayloads = (data, maxChars) => {
+    const bounded = JSON.parse(JSON.stringify(data));
+    boundMarkdownField(bounded, maxChars);
+    for (const value of Object.values(bounded)) {
+        if (isJsonObject(value)) {
+            boundMarkdownField(value, maxChars);
+        }
+    }
+    return bounded;
+};
+//# sourceMappingURL=markdownPayload.js.map

package/dist/providers/markdownPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownPayload.js","sourceRoot":"","sources":["../../src/providers/markdownPayload.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEjE,MAAM,CAAC,MAAM,6BAA6B,GACxC,iJAAiJ,CAAC;AAEpJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAA+B,EAAsB,EAAE;IAC1F,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAE5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE,CAC3D,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,kBAAkB,GAAG,CAAC,OAAmB,EAAE,QAAgB,EAAQ,EAAE;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAChE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,CAAC,2BAA2B,CAAC,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,4BAA4B,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,IAAgB,EAAE,QAAgB,EAAc,EAAE;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAe,CAAC;IAE/D,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/providers/responseSchema.d.ts

@@ -0,0 +1,3 @@
+import type { AgentRequest } from "./types.js";
+import type { JsonObject } from "../runtime/types.js";
+export declare const buildAgentResponseSchema: (request: AgentRequest) => JsonObject;

package/dist/providers/responseSchema.js

@@ -0,0 +1,187 @@
+import { agentMarkdownField, agentMarkdownFieldDescription } from "./markdownPayload.js";
+const nullableStringSchema = () => ({
+    type: ["string", "null"]
+});
+const nullableBooleanSchema = () => ({
+    type: ["boolean", "null"]
+});
+const nullableStringArraySchema = () => ({
+    type: ["array", "null"],
+    items: {
+        type: "string"
+    }
+});
+const basePayloadSchema = () => ({
+    type: "object",
+    additionalProperties: false
+});
+const withDirectiveAckSchema = (request, schema) => {
+    const required = Array.isArray(schema.required) ? schema.required.filter((value) => typeof value === "string") : [];
+    const properties = schema.properties !== null && typeof schema.properties === "object" && !Array.isArray(schema.properties)
+        ? schema.properties
+        : {};
+    const finalProperties = {
+        ...properties,
+        [agentMarkdownField]: {
+            type: ["string", "null"],
+            description: agentMarkdownFieldDescription
+        },
+        [request.directive.directiveAck.responseField]: {
+            type: "object",
+            additionalProperties: false,
+            required: ["runId", "nonce", "responseField"],
+            properties: {
+                runId: {
+                    type: "string",
+                    enum: [request.directive.directiveAck.runId]
+                },
+                nonce: {
+                    type: "string",
+                    enum: [request.directive.directiveAck.nonce]
+                },
+                responseField: {
+                    type: "string",
+                    enum: [request.directive.directiveAck.responseField]
+                }
+            }
+        }
+    };
+    return {
+        ...schema,
+        required: [...new Set([...required, ...Object.keys(finalProperties)])],
+        properties: finalProperties
+    };
+};
+const payloadSchemaForRole = (request) => {
+    const schema = (() => {
+        switch (request.role) {
+            case "orchestrator":
+            case "planner":
+                return {
+                    ...basePayloadSchema(),
+                    required: ["action", "reason"],
+                    properties: {
+                        action: {
+                            type: "string",
+                            enum: ["delegate", "verify", "critique", "request_approval", "revise_plan", "complete", "abort"]
+                        },
+                        reason: {
+                            type: "string"
+                        },
+                        delegateTo: {
+                            type: ["string", "null"],
+                            enum: ["orchestrator", "planner", "implementer", "qa", "verifier", "critic", null]
+                        },
+                        nextRole: {
+                            type: ["string", "null"],
+                            enum: ["orchestrator", "planner", "implementer", "qa", "verifier", "critic", null]
+                        },
+                        requiresMoreEvidence: nullableBooleanSchema(),
+                        sliceName: nullableStringSchema(),
+                        targetPaths: nullableStringArraySchema(),
+                        requestedPaths: nullableStringArraySchema(),
+                        evidenceRefs: nullableStringArraySchema(),
+                        artifactRefs: nullableStringArraySchema(),
+                        callCritic: nullableBooleanSchema(),
+                        reasonCode: nullableStringSchema(),
+                        sourceRoles: nullableStringArraySchema(),
+                        acceptanceCriteria: nullableStringArraySchema()
+                    }
+                };
+            case "implementer":
+                return {
+                    ...basePayloadSchema(),
+                    required: ["status"],
+                    properties: {
+                        status: {
+                            type: "string",
+                            enum: ["changed", "no_change", "blocked", "failed"]
+                        },
+                        changedFiles: nullableStringArraySchema(),
+                        commandsRun: nullableStringArraySchema(),
+                        unresolvedRisks: nullableStringArraySchema(),
+                        evidenceRefs: nullableStringArraySchema()
+                    }
+                };
+            case "qa":
+                return {
+                    ...basePayloadSchema(),
+                    required: ["verdict", "summary"],
+                    properties: {
+                        verdict: {
+                            type: "string",
+                            enum: ["pass", "needs_revision", "needs_more_evidence", "blocked"]
+                        },
+                        summary: {
+                            type: "string"
+                        },
+                        suggestedCommands: nullableStringArraySchema(),
+                        risks: nullableStringArraySchema(),
+                        evidenceRefs: nullableStringArraySchema()
+                    }
+                };
+            case "verifier":
+                return {
+                    ...basePayloadSchema(),
+                    required: ["verdict", "summary"],
+                    properties: {
+                        verdict: {
+                            type: "string",
+                            enum: ["approve", "revise", "abort", "ask_user"]
+                        },
+                        summary: {
+                            type: "string"
+                        },
+                        failedCriteria: nullableStringArraySchema(),
+                        risks: nullableStringArraySchema(),
+                        nextAction: nullableStringSchema(),
+                        evidenceRefs: nullableStringArraySchema()
+                    }
+                };
+            case "critic":
+                return {
+                    ...basePayloadSchema(),
+                    required: ["verdict"],
+                    properties: {
+                        verdict: {
+                            type: "string",
+                            enum: ["acceptable", "needs_revision", "unsafe", "unclear"]
+                        },
+                        blockingConcerns: nullableStringArraySchema(),
+                        nonBlockingConcerns: nullableStringArraySchema(),
+                        risks: nullableStringArraySchema(),
+                        evidenceRefs: nullableStringArraySchema()
+                    }
+                };
+            default:
+                return basePayloadSchema();
+        }
+    })();
+    return withDirectiveAckSchema(request, schema);
+};
+export const buildAgentResponseSchema = (request) => {
+    const requiredDataKey = request.directive.outputContract.requiredDataKey;
+    return {
+        type: "object",
+        additionalProperties: false,
+        required: ["status", "summary", "data"],
+        properties: {
+            status: {
+                type: "string",
+                enum: ["ok", "blocked", "failed"]
+            },
+            summary: {
+                type: "string"
+            },
+            data: {
+                type: "object",
+                additionalProperties: false,
+                required: [requiredDataKey],
+                properties: {
+                    [requiredDataKey]: payloadSchemaForRole(request)
+                }
+            }
+        }
+    };
+};
+//# sourceMappingURL=responseSchema.js.map

package/dist/providers/responseSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseSchema.js","sourceRoot":"","sources":["../../src/providers/responseSchema.ts"],"names":[],"mappings":"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"}

package/dist/providers/router.d.ts

@@ -0,0 +1,3 @@
+import type { RoleAssignment } from "../runtime/types.js";
+import type { ProviderAdapter } from "./types.js";
+export declare const getProviderAdapter: (assignment: RoleAssignment) => ProviderAdapter;

package/dist/providers/router.js

@@ -0,0 +1,21 @@
+import { ProviderUnavailableError } from "../runtime/errors.js";
+import { chatGptWebProvider } from "./chatgptWeb.js";
+import { claudeCodeProvider } from "./claudeCode.js";
+import { codexCliProvider } from "./codexCli.js";
+import { stubProvider } from "./stub.js";
+export const getProviderAdapter = (assignment) => {
+    if (assignment.provider === stubProvider.id) {
+        return stubProvider;
+    }
+    if (assignment.provider === chatGptWebProvider.id) {
+        return chatGptWebProvider;
+    }
+    if (assignment.provider === codexCliProvider.id) {
+        return codexCliProvider;
+    }
+    if (assignment.provider === claudeCodeProvider.id) {
+        return claudeCodeProvider;
+    }
+    throw new ProviderUnavailableError(`Provider "${assignment.provider}" is not implemented yet. Use stub:<role>, chatgpt-web:chatgpt-pro, codex-cli:<model>, or claude-code:<model>.`);
+};
+//# sourceMappingURL=router.js.map

package/dist/providers/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/providers/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAA0B,EAAmB,EAAE;IAChF,IAAI,UAAU,CAAC,QAAQ,KAAK,YAAY,CAAC,EAAE,EAAE,CAAC;QAC5C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,KAAK,kBAAkB,CAAC,EAAE,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,KAAK,gBAAgB,CAAC,EAAE,EAAE,CAAC;QAChD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,KAAK,kBAAkB,CAAC,EAAE,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,IAAI,wBAAwB,CAChC,aAAa,UAAU,CAAC,QAAQ,gHAAgH,CACjJ,CAAC;AACJ,CAAC,CAAC"}

package/dist/providers/stub.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderAdapter } from "./types.js";
+export declare const stubProvider: ProviderAdapter;

package/dist/providers/stub.js

@@ -0,0 +1,177 @@
+const response = (summary, data) => ({
+    status: "ok",
+    summary,
+    data
+});
+const hasRepoContext = (request) => request.context.repoContext !== undefined || request.context.repoContextArtifact !== undefined;
+const shouldExerciseRepoContext = (request) => request.run.mode === "plan" && request.run.userGoal.includes("repo-context-smoke");
+const shouldExerciseRoleDelegate = (request) => request.run.mode === "plan" && request.run.userGoal.includes("role-delegate-smoke");
+const shouldExercisePlannerDelegate = (request) => request.run.mode === "plan" && request.run.userGoal.includes("planner-delegate-smoke");
+const isJsonObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const hasRevisionPacket = (request) => isJsonObject(request.context.latestRevisionPacket);
+const shouldExerciseQaRevisionLoop = (request) => request.run.mode === "implement" && request.run.userGoal.includes("qa-revision-loop-smoke");
+const shouldExerciseVerifierRevisionLoop = (request) => request.run.mode === "implement" && request.run.userGoal.includes("verifier-revision-loop-smoke");
+const orchestratorResponse = (request) => {
+    if (shouldExerciseRepoContext(request) && !hasRepoContext(request)) {
+        return response("Stub orchestrator requested deterministic repo context.", {
+            decision: {
+                action: "delegate",
+                reason: "Stub provider is exercising repo context capture before planning.",
+                delegate: {
+                    role: "repo_reader",
+                    task: "Capture bounded repository context for planning."
+                }
+            }
+        });
+    }
+    if (shouldExerciseRoleDelegate(request)) {
+        return response("Stub orchestrator delegated a ready implementation slice.", {
+            decision: {
+                action: "delegate",
+                reason: "Planning is complete; this slice is ready for implementation.",
+                delegateTo: "implementer",
+                sliceName: "role-delegate-smoke-ready-slice",
+                requiresMoreEvidence: false,
+                requiresUserApproval: false
+            },
+            acceptanceCriteria: [
+                "Plan runs complete after a ready implementer handoff.",
+                "Repo context is not recaptured for implementation handoffs."
+            ]
+        });
+    }
+    if (request.role === "orchestrator" && shouldExercisePlannerDelegate(request)) {
+        return response("Stub orchestrator delegated a ready planning pass.", {
+            decision: {
+                action: "delegate",
+                reason: "Planner should synthesize the roadmap from existing repo context.",
+                delegateTo: "planner",
+                sliceName: "planner-delegate-smoke-ready-slice",
+                requiresMoreEvidence: false,
+                requiresUserApproval: false
+            },
+            acceptanceCriteria: [
+                "Read-only planner handoffs invoke the configured planner role.",
+                "Planner handoffs are not treated as repeated repo-context delegation."
+            ]
+        });
+    }
+    return response("Stub orchestrator created a deterministic delegation plan.", {
+        decision: {
+            action: request.run.mode === "implement" ? "delegate" : "complete",
+            reason: hasRepoContext(request)
+                ? "Stub provider received runtime repo context and completed planning."
+                : "Stub provider is exercising the loop without external model calls.",
+            nextRole: request.run.mode === "implement" ? "implementer" : null
+        },
+        plan: [
+            "Capture baseline evidence.",
+            "Run scoped implementer.",
+            "Capture post-work evidence.",
+            "Ask independent verifier for a verdict."
+        ],
+        acceptanceCriteria: [
+            "Runtime state advances without bypassing approval gates.",
+            "Verifier remains separate from implementer.",
+            "Evidence artifacts are available for inspection."
+        ]
+    });
+};
+const researcherResponse = () => response("Stub researcher returned deterministic findings.", {
+    researchResult: {
+        summary: "Stub research completed without external calls.",
+        findings: [
+            "Runtime can dispatch a read-only research role.",
+            "Research output is schema-bound before state advances."
+        ],
+        openQuestions: []
+    }
+});
+const implementerResponse = (request) => response(hasRevisionPacket(request)
+    ? "Stub implementer handled the runtime revision packet."
+    : "Stub implementer performed no file edits.", {
+    implementationResult: {
+        status: "no_change",
+        changedFiles: [],
+        commandsRun: [],
+        unresolvedRisks: []
+    }
+});
+const qaResponse = (request) => {
+    if (shouldExerciseQaRevisionLoop(request) && !hasRevisionPacket(request)) {
+        return response("Stub QA tester requested a repair loop.", {
+            qaResult: {
+                verdict: "needs_revision",
+                summary: "QA found a deterministic missed-case marker for the repair loop smoke.",
+                suggestedCommands: ["npm run smoke:runtime"],
+                risks: ["The first pass intentionally needs a repair delegation."]
+            }
+        });
+    }
+    return response("Stub QA tester found no missing validation concerns.", {
+        qaResult: {
+            verdict: "pass",
+            summary: "Stub QA tester reviewed available evidence and found no extra concerns.",
+            suggestedCommands: [],
+            risks: []
+        }
+    });
+};
+const verifierResponse = (request) => {
+    const protectedChangeCount = Number(request.context.protectedChangeCount ?? 0);
+    const validationFailureCount = Number(request.context.validationFailureCount ?? 0);
+    const exerciseVerifierRevision = shouldExerciseVerifierRevisionLoop(request) && !hasRevisionPacket(request);
+    const verdict = exerciseVerifierRevision
+        ? "revise"
+        : protectedChangeCount > 0 || validationFailureCount > 0 ? "ask_user" : "approve";
+    return response(`Stub verifier returned ${verdict}.`, {
+        verificationResult: {
+            verdict,
+            summary: exerciseVerifierRevision
+                ? "Verifier found a deterministic repair-loop marker."
+                : protectedChangeCount > 0
+                    ? "Protected files changed; user approval is required."
+                    : validationFailureCount > 0
+                        ? "Runtime validation commands failed; user review is required."
+                        : "No protected changes were detected in runtime evidence.",
+            failedCriteria: exerciseVerifierRevision ? ["Repair-loop verifier criterion was not satisfied on first pass."] : [],
+            risks: [
+                ...(exerciseVerifierRevision ? ["The first verifier pass intentionally needs a repair delegation."] : []),
+                ...(protectedChangeCount > 0 ? ["Protected path changes need explicit review."] : []),
+                ...(validationFailureCount > 0 ? ["Runtime validation command failures need review."] : [])
+            ],
+            nextAction: verdict === "approve" ? "complete" : "ask_user"
+        }
+    });
+};
+export const stubProvider = {
+    id: "stub",
+    async runAgent(request) {
+        switch (request.role) {
+            case "orchestrator":
+            case "planner":
+                return orchestratorResponse(request);
+            case "researcher":
+                return researcherResponse();
+            case "implementer":
+                return implementerResponse(request);
+            case "qa":
+                return qaResponse(request);
+            case "verifier":
+                return verifierResponse(request);
+            case "critic":
+                return response("Stub critic found no blocking concerns.", {
+                    critiqueResult: {
+                        verdict: "acceptable",
+                        blockingConcerns: [],
+                        nonBlockingConcerns: []
+                    }
+                });
+            default:
+                return response(`Stub ${request.role} completed.`, {
+                    role: request.role
+                });
+        }
+    }
+};
+//# sourceMappingURL=stub.js.map

package/dist/providers/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../src/providers/stub.ts"],"names":[],"mappings":"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"}

package/dist/providers/types.d.ts

@@ -0,0 +1,37 @@
+import type { JsonObject, RoleAssignment, RunRecord, RuntimeRole } from "../runtime/types.js";
+import type { RolePermissionProfile } from "../runtime/permissions.js";
+export interface AgentOutputContract {
+    schemaVersion: 1;
+    name: string;
+    requiredDataKey: string;
+}
+export interface AgentDirectiveAck {
+    runId: string;
+    nonce: string;
+    responseField: "thehoodDirectiveAck";
+}
+export interface AgentDirective {
+    role: RuntimeRole;
+    objective: string;
+    instructions: string[];
+    toolPermissions: RolePermissionProfile;
+    outputContract: AgentOutputContract;
+    directiveAck: AgentDirectiveAck;
+    variables: JsonObject;
+}
+export interface AgentRequest {
+    run: RunRecord;
+    role: RuntimeRole;
+    assignment: RoleAssignment;
+    context: JsonObject;
+    directive: AgentDirective;
+}
+export interface AgentResponse {
+    status: "ok" | "blocked" | "failed";
+    summary: string;
+    data: JsonObject;
+}
+export interface ProviderAdapter {
+    id: string;
+    runAgent(request: AgentRequest): Promise<AgentResponse>;
+}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/runtime/agentBoard.d.ts

@@ -0,0 +1,79 @@
+import type { RoleRosterItem } from "./roleRoster.js";
+import type { RunInsights } from "./runInsights.js";
+import type { OperatorNextAction, RuntimeRole, RunRecord } from "./types.js";
+export type AgentBoardScope = "repo" | "run";
+export type AgentBoardCardStatus = "active" | "blocked" | "ready" | "satisfied" | "pending" | "skipped" | "advisory" | "unassigned" | "needs_attention";
+export interface AgentBoardCard {
+    id: string;
+    role: RuntimeRole;
+    laneLabel: string;
+    title: string;
+    assignmentLabel: string;
+    assignmentSource: RoleRosterItem["assignmentSource"];
+    readiness: RoleRosterItem["state"];
+    status: AgentBoardCardStatus;
+    authority: RoleRosterItem["authority"];
+    readOnly: boolean;
+    permissions: RoleRosterItem["permissions"];
+    responsibility: string;
+    issues: string[];
+    provider?: string;
+    model?: string;
+    run?: {
+        runId: string;
+        state: RunRecord["state"];
+        mode: RunRecord["mode"];
+        currentLane?: string;
+        laneStatus?: string;
+        laneSummary?: string;
+        required?: boolean;
+        blocking?: boolean;
+        canSatisfyGate?: boolean;
+        satisfiesRequired?: boolean;
+        sidecarOnly?: boolean;
+        artifactRefs: string[];
+        eventRefs: string[];
+        handoffRefs: string[];
+    };
+}
+export interface AgentBoardAction {
+    action: OperatorNextAction["action"];
+    label: string;
+    ownerLabel: string;
+    role?: RuntimeRole;
+    blocking: boolean;
+    required: boolean;
+    state: string;
+    description: string;
+    commandHint?: string;
+    mcpToolHint?: string;
+    tool?: string;
+    artifactRefs: string[];
+    eventRefs: string[];
+}
+export interface AgentBoard {
+    schemaVersion: 1;
+    kind: "agent_board";
+    scope: AgentBoardScope;
+    repoPath: string;
+    runId?: string;
+    runState?: RunRecord["state"];
+    runMode?: RunRecord["mode"];
+    summary: {
+        total: number;
+        ready: number;
+        active: number;
+        blocked: number;
+        unassigned: number;
+        needsAttention: number;
+    };
+    cards: AgentBoardCard[];
+    actions: AgentBoardAction[];
+    notes: string[];
+}
+export declare const buildAgentBoard: (input: {
+    repoPath: string;
+    roster: RoleRosterItem[];
+    run?: RunRecord;
+    insights?: RunInsights;
+}) => AgentBoard;