thehood 0.1.0-preview.0

package/dist/runtime/runtime.js

@@ -0,0 +1,199 @@
+import { loadConfig } from "./config.js";
+import { autopilotApprovalReason, autopilotPolicyReason, isAutopilotEnabled } from "./approvalPolicy.js";
+import { InputError } from "./errors.js";
+import { createRunHandoff } from "./handoffs.js";
+import { newId, nowIso } from "./ids.js";
+import { assertRoleInvariants } from "./permissions.js";
+import { getProjectPaths, resolveRepoPath } from "./paths.js";
+import { saveRun, loadRun, listRuns as loadRuns } from "./store.js";
+const createEvent = (type, message, data) => ({
+    id: newId("event"),
+    createdAt: nowIso(),
+    type,
+    message,
+    ...(data ? { data } : {})
+});
+const createApprovalEvent = (decision, reason) => ({
+    id: newId("approval"),
+    createdAt: nowIso(),
+    decision,
+    reason
+});
+const requiredApprovalPhrase = (run) => run.approvalReason?.match(/Approval message must mention "([^"]+)"/)?.[1];
+const includesApprovalPhrase = (reason, phrase) => reason.toLowerCase().includes(phrase.toLowerCase());
+const assertApprovalPhrase = (run, decision, reason) => {
+    if (decision !== "approve" || !run.approvalRequired) {
+        return;
+    }
+    const phrase = requiredApprovalPhrase(run);
+    if (phrase && !includesApprovalPhrase(reason, phrase)) {
+        throw new InputError(`Approval message must mention "${phrase}" to continue run ${run.runId}.`);
+    }
+};
+const approvedStateForRun = (run) => {
+    if (run.state !== "awaiting_approval") {
+        return run.state;
+    }
+    if (run.approvalReason?.includes("apply isolated patch")) {
+        return "integrating";
+    }
+    if (run.approvalReason?.includes("protected test changes")) {
+        return "verifying";
+    }
+    if (run.mode === "implement" && run.approvalReason?.includes(" for qa requires explicit approval")) {
+        return "verifying";
+    }
+    return run.mode === "implement" ? "delegating" : "planning";
+};
+const isPostCompletionApproval = (run) => run.state === "completed" && Boolean(run.approvalReason?.includes("progress packet"));
+const initialStateForMode = (mode) => {
+    if (mode === "implement") {
+        return {
+            state: "awaiting_approval",
+            approvalRequired: true,
+            reason: "Implementation mode requires approval before edit-capable worker execution."
+        };
+    }
+    return {
+        state: "created",
+        approvalRequired: false
+    };
+};
+export const createRun = async (input) => {
+    const repoPath = resolveRepoPath(input.repoPath);
+    const goal = input.goal.trim();
+    if (!goal) {
+        throw new InputError("Run goal cannot be empty.");
+    }
+    const config = await loadConfig(repoPath);
+    const roleMapping = {
+        ...config.roles,
+        ...(input.roleOverrides ?? {})
+    };
+    assertRoleInvariants(roleMapping);
+    const initial = initialStateForMode(input.mode);
+    const createdAt = nowIso();
+    const run = {
+        runId: newId("run"),
+        createdAt,
+        updatedAt: createdAt,
+        repoPath,
+        userGoal: goal,
+        mode: input.mode,
+        state: initial.state,
+        ...(input.preferredRole ? { preferredRole: input.preferredRole } : {}),
+        roleMapping,
+        constraints: input.constraints ?? [],
+        maxIterations: input.maxIterations ?? config.defaults.maxIterations,
+        approvalRequired: initial.approvalRequired,
+        artifacts: [
+            {
+                kind: "metadata",
+                ref: getProjectPaths(repoPath).configPath,
+                summary: "Runtime configuration used to create this run."
+            }
+        ],
+        approvalEvents: [],
+        toolEvents: [],
+        handoffs: [],
+        events: [
+            createEvent("run_created", `Created ${input.mode} run.`),
+            createEvent("run_ready", "Run is ready for the next runtime transition.")
+        ]
+    };
+    if (initial.reason && isAutopilotEnabled(config)) {
+        const approvalReason = autopilotApprovalReason(initial.reason);
+        const approval = createApprovalEvent("approve", approvalReason);
+        const stateBefore = run.state;
+        run.state = approvedStateForRun(run);
+        run.approvalRequired = false;
+        run.approvalEvents.push(approval);
+        run.handoffs.push(createRunHandoff({ ...run, state: stateBefore }, {
+            kind: "approval_auto_approved",
+            reason: approvalReason,
+            stateAfter: run.state,
+            gate: "implementation_start",
+            approvalEventId: approval.id
+        }));
+        run.events.push(createEvent("approval_auto_approved", approvalReason, {
+            gate: "implementation_start",
+            reason: "implementation_start",
+            gateReason: initial.reason,
+            policyDecision: "auto_approve",
+            policyReason: autopilotPolicyReason("implementation_start"),
+            policyMode: config.approvalPolicy.mode
+        }));
+    }
+    else if (initial.reason) {
+        run.approvalReason = initial.reason;
+        run.handoffs.push(createRunHandoff(run, {
+            kind: "approval_gate",
+            reason: initial.reason,
+            stateAfter: run.state,
+            gate: "implementation_start"
+        }));
+        run.events.push(createEvent("approval_required", initial.reason));
+    }
+    await saveRun(run);
+    return run;
+};
+export const getRun = async (repoPath, runId) => loadRun(repoPath, runId);
+export const listRuns = async (repoPath) => loadRuns(repoPath);
+export const recordApproval = async (repoPath, runId, decision, reason) => {
+    const run = await loadRun(repoPath, runId);
+    assertApprovalPhrase(run, decision, reason);
+    const approval = createApprovalEvent(decision, reason);
+    const updatedAt = nowIso();
+    const { approvalReason: _approvalReason, ...runWithoutApprovalReason } = run;
+    const preservesCompletedRun = isPostCompletionApproval(run);
+    const state = decision === "reject"
+        ? preservesCompletedRun ? "completed" : "aborted"
+        : decision === "revise"
+            ? preservesCompletedRun ? "completed" : "awaiting_approval"
+            : approvedStateForRun(run);
+    const base = {
+        ...(decision === "revise" ? run : runWithoutApprovalReason),
+        updatedAt,
+        state,
+        approvalRequired: decision === "revise",
+        approvalEvents: [...run.approvalEvents, approval],
+        handoffs: [
+            ...(run.handoffs ?? []),
+            createRunHandoff(run, {
+                kind: "approval_gate",
+                reason,
+                stateAfter: state,
+                gate: `manual_${decision}`,
+                approvalEventId: approval.id
+            })
+        ],
+        events: [
+            ...run.events,
+            createEvent("approval_recorded", `Recorded approval decision: ${decision}.`)
+        ]
+    };
+    const updated = decision === "revise"
+        ? {
+            ...base,
+            approvalReason: preservesCompletedRun
+                ? "Revision requested before reconciliation."
+                : "Revision requested before continuing."
+        }
+        : base;
+    await saveRun(updated);
+    return updated;
+};
+export const abortRun = async (repoPath, runId, reason) => {
+    const run = await loadRun(repoPath, runId);
+    const updated = {
+        ...run,
+        updatedAt: nowIso(),
+        state: "aborted",
+        approvalRequired: false,
+        stopReason: reason,
+        events: [...run.events, createEvent("run_aborted", reason)]
+    };
+    await saveRun(updated);
+    return updated;
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

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

package/dist/runtime/runtimeInfo.d.ts

@@ -0,0 +1,9 @@
+export declare const runtimeCapabilities: readonly ["structured_mcp_next_actions", "approval_artifact_next_actions", "isolated_patch_integration", "protected_integrated_patch_gate", "repo_context_external_approval", "chatgpt_web_bridge", "chatgpt_web_bridge_fail_fast", "chatgpt_web_session_isolation", "chatgpt_web_auth_readiness", "chatgpt_browser_manager", "cli_artifact_reads", "approval_phrase_enforcement", "final_report_artifacts", "progress_packet_artifacts", "external_transfer_manifests", "external_transfer_approval_policy", "targeted_repo_context_followups", "github_connector_repo_context", "planner_reconciliation", "canonical_memory_rehydration", "provider_directive_ack", "provider_markdown_payloads", "local_agent_execution_artifacts", "mcp_final_report_next_action", "max_iteration_enforcement", "validation_command_capture", "review_routing_policy", "model_assisted_qa_tester", "critic_trigger_artifacts", "revision_packet_artifacts", "revision_trail", "runtime_revision_delegation", "branded_tui_shell", "approval_inbox_tui", "operator_run_monitor", "operator_next_actions", "loop_responsibility_schedule", "crew_lane_trail", "runtime_loop_runner", "autopilot_approval_policy", "mcp_autopilot_continue_guidance", "run_status_insights", "compact_mcp_host_responses", "same_run_agent_summons", "bounded_same_run_fanout", "runtime_team_presets", "multi_model_team_presets", "loop_recommendation_router", "codex_loop_plan_artifact", "provider_model_passthrough", "configurable_budget_envelopes", "provider_access_modes", "mcp_repo_gateway_tools", "chatgpt_mcp_connector_mode", "pro_access_preflight", "model_access_preflight", "codex_agent_board", "codex_agent_board_artifact"];
+export type RuntimeCapability = (typeof runtimeCapabilities)[number];
+export interface RuntimeInfo {
+    name: "thehood";
+    version: string;
+    capabilities: RuntimeCapability[];
+}
+export declare const runtimeVersion: string;
+export declare const runtimeInfo: RuntimeInfo;

package/dist/runtime/runtimeInfo.js

@@ -0,0 +1,76 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export const runtimeCapabilities = [
+    "structured_mcp_next_actions",
+    "approval_artifact_next_actions",
+    "isolated_patch_integration",
+    "protected_integrated_patch_gate",
+    "repo_context_external_approval",
+    "chatgpt_web_bridge",
+    "chatgpt_web_bridge_fail_fast",
+    "chatgpt_web_session_isolation",
+    "chatgpt_web_auth_readiness",
+    "chatgpt_browser_manager",
+    "cli_artifact_reads",
+    "approval_phrase_enforcement",
+    "final_report_artifacts",
+    "progress_packet_artifacts",
+    "external_transfer_manifests",
+    "external_transfer_approval_policy",
+    "targeted_repo_context_followups",
+    "github_connector_repo_context",
+    "planner_reconciliation",
+    "canonical_memory_rehydration",
+    "provider_directive_ack",
+    "provider_markdown_payloads",
+    "local_agent_execution_artifacts",
+    "mcp_final_report_next_action",
+    "max_iteration_enforcement",
+    "validation_command_capture",
+    "review_routing_policy",
+    "model_assisted_qa_tester",
+    "critic_trigger_artifacts",
+    "revision_packet_artifacts",
+    "revision_trail",
+    "runtime_revision_delegation",
+    "branded_tui_shell",
+    "approval_inbox_tui",
+    "operator_run_monitor",
+    "operator_next_actions",
+    "loop_responsibility_schedule",
+    "crew_lane_trail",
+    "runtime_loop_runner",
+    "autopilot_approval_policy",
+    "mcp_autopilot_continue_guidance",
+    "run_status_insights",
+    "compact_mcp_host_responses",
+    "same_run_agent_summons",
+    "bounded_same_run_fanout",
+    "runtime_team_presets",
+    "multi_model_team_presets",
+    "loop_recommendation_router",
+    "codex_loop_plan_artifact",
+    "provider_model_passthrough",
+    "configurable_budget_envelopes",
+    "provider_access_modes",
+    "mcp_repo_gateway_tools",
+    "chatgpt_mcp_connector_mode",
+    "pro_access_preflight",
+    "model_access_preflight",
+    "codex_agent_board",
+    "codex_agent_board_artifact"
+];
+const readRuntimeVersion = () => {
+    const packageJson = require("../../package.json");
+    if (typeof packageJson.version !== "string" || packageJson.version.trim().length === 0) {
+        throw new Error("Could not read TheHood package version from package.json.");
+    }
+    return packageJson.version;
+};
+export const runtimeVersion = readRuntimeVersion();
+export const runtimeInfo = {
+    name: "thehood",
+    version: runtimeVersion,
+    capabilities: [...runtimeCapabilities]
+};
+//# sourceMappingURL=runtimeInfo.js.map

package/dist/runtime/runtimeInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeInfo.js","sourceRoot":"","sources":["../../src/runtime/runtimeInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,6BAA6B;IAC7B,gCAAgC;IAChC,4BAA4B;IAC5B,iCAAiC;IACjC,gCAAgC;IAChC,oBAAoB;IACpB,8BAA8B;IAC9B,+BAA+B;IAC/B,4BAA4B;IAC5B,yBAAyB;IACzB,oBAAoB;IACpB,6BAA6B;IAC7B,wBAAwB;IACxB,2BAA2B;IAC3B,6BAA6B;IAC7B,mCAAmC;IACnC,iCAAiC;IACjC,+BAA+B;IAC/B,wBAAwB;IACxB,8BAA8B;IAC9B,wBAAwB;IACxB,4BAA4B;IAC5B,iCAAiC;IACjC,8BAA8B;IAC9B,2BAA2B;IAC3B,4BAA4B;IAC5B,uBAAuB;IACvB,0BAA0B;IAC1B,0BAA0B;IAC1B,2BAA2B;IAC3B,gBAAgB;IAChB,6BAA6B;IAC7B,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,uBAAuB;IACvB,8BAA8B;IAC9B,iBAAiB;IACjB,qBAAqB;IACrB,2BAA2B;IAC3B,iCAAiC;IACjC,qBAAqB;IACrB,4BAA4B;IAC5B,wBAAwB;IACxB,yBAAyB;IACzB,sBAAsB;IACtB,0BAA0B;IAC1B,4BAA4B;IAC5B,0BAA0B;IAC1B,4BAA4B;IAC5B,+BAA+B;IAC/B,uBAAuB;IACvB,wBAAwB;IACxB,4BAA4B;IAC5B,sBAAsB;IACtB,wBAAwB;IACxB,mBAAmB;IACnB,4BAA4B;CACpB,CAAC;AAUX,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAA0B,CAAC;IAE3E,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC;AAEnD,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,cAAc;IACvB,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC;CACvC,CAAC"}

package/dist/runtime/store.d.ts

@@ -0,0 +1,4 @@
+import type { RunRecord } from "./types.js";
+export declare const saveRun: (run: RunRecord) => Promise<void>;
+export declare const loadRun: (repoPath: string, runId: string) => Promise<RunRecord>;
+export declare const listRuns: (repoPath: string) => Promise<RunRecord[]>;

package/dist/runtime/store.js

@@ -0,0 +1,48 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureLocalStateIgnored } from "./localStateIgnore.js";
+import { getProjectPaths } from "./paths.js";
+const runFileName = "run.json";
+const getRunDir = (repoPath, runId) => path.join(getProjectPaths(repoPath).runsDir, runId);
+export const saveRun = async (run) => {
+    const runDir = getRunDir(run.repoPath, run.runId);
+    await ensureLocalStateIgnored(run.repoPath);
+    await fs.mkdir(runDir, { recursive: true });
+    await fs.writeFile(path.join(runDir, runFileName), `${JSON.stringify(run, null, 2)}\n`, "utf8");
+};
+const hydrateRun = (value) => {
+    const run = value;
+    return {
+        ...run,
+        handoffs: Array.isArray(run.handoffs) ? run.handoffs : []
+    };
+};
+export const loadRun = async (repoPath, runId) => {
+    const raw = await fs.readFile(path.join(getRunDir(repoPath, runId), runFileName), "utf8");
+    return hydrateRun(JSON.parse(raw));
+};
+export const listRuns = async (repoPath) => {
+    const runsDir = getProjectPaths(repoPath).runsDir;
+    try {
+        const entries = await fs.readdir(runsDir, { withFileTypes: true });
+        const runDirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+        const runs = await Promise.all(runDirs.map(async (runId) => {
+            try {
+                return await loadRun(repoPath, runId);
+            }
+            catch {
+                return null;
+            }
+        }));
+        return runs
+            .filter((run) => run !== null)
+            .sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=store.js.map

package/dist/runtime/store.js.map

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

package/dist/runtime/summons.d.ts

@@ -0,0 +1,25 @@
+import type { AgentResponse } from "../providers/types.js";
+import type { RoleAssignment, RunArtifact, RunRecord, RuntimeRole } from "./types.js";
+export interface SummonAgentInput {
+    repoPath: string;
+    runId: string;
+    role: RuntimeRole;
+    brief: string;
+    summonKind?: string;
+    persona?: string;
+    agent?: RoleAssignment;
+    constraints?: string[];
+    evidenceRefs?: string[];
+}
+export interface SummonAgentResult {
+    run: RunRecord;
+    role: RuntimeRole;
+    assignment: RoleAssignment;
+    summonKind: string;
+    advanced: boolean;
+    stopReason: string;
+    providerResponses: AgentResponse[];
+    directiveArtifact?: RunArtifact;
+    responseArtifact?: RunArtifact;
+}
+export declare const summonAgent: (input: SummonAgentInput) => Promise<SummonAgentResult>;