thehood 0.1.0-preview.0

package/dist/runtime/approvalInbox.js

@@ -0,0 +1,143 @@
+import { recentRunHandoffSummaries } from "./handoffs.js";
+const defaultAutopilotApprovalLimit = 8;
+export const approvalMessageHint = (run) => {
+    const reason = run.approvalReason ?? "";
+    const quoted = reason.match(/"([^"]+)"/)?.[1];
+    if (quoted) {
+        return `I approve ${quoted} for run ${run.runId}.`;
+    }
+    if (reason.includes("Implementation mode requires approval")) {
+        return `I approve starting implementation for run ${run.runId}.`;
+    }
+    return `I approve the next TheHood transition for run ${run.runId}.`;
+};
+const stringField = (value) => typeof value === "string" ? value : undefined;
+const objectField = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : undefined;
+const artifactForRef = (run, artifactRef) => {
+    if (typeof artifactRef !== "string") {
+        return undefined;
+    }
+    const artifact = run.artifacts.find((candidate) => candidate.ref === artifactRef);
+    if (!artifact) {
+        return undefined;
+    }
+    return {
+        kind: artifact.kind,
+        ref: artifact.ref,
+        summary: artifact.summary
+    };
+};
+const autopilotApprovalForEvent = (run, event) => {
+    if (event.type !== "approval_auto_approved") {
+        return undefined;
+    }
+    const gate = stringField(event.data?.gate) ?? stringField(event.data?.reason);
+    const gateReason = stringField(event.data?.gateReason);
+    const policyDecision = stringField(event.data?.policyDecision);
+    const policyReason = stringField(event.data?.policyReason);
+    const artifact = artifactForRef(run, event.data?.artifactRef);
+    const sourceArtifact = artifactForRef(run, event.data?.sourceArtifactRef);
+    const transfer = objectField(event.data?.transfer);
+    const approval = {
+        runId: run.runId,
+        createdAt: event.createdAt,
+        updatedAt: run.updatedAt,
+        repoPath: run.repoPath,
+        mode: run.mode,
+        state: run.state,
+        goal: run.userGoal,
+        message: event.message
+    };
+    if (gate) {
+        approval.gate = gate;
+    }
+    if (gateReason) {
+        approval.gateReason = gateReason;
+    }
+    if (policyDecision) {
+        approval.policyDecision = policyDecision;
+    }
+    if (policyReason) {
+        approval.policyReason = policyReason;
+    }
+    if (artifact) {
+        approval.artifact = artifact;
+    }
+    if (sourceArtifact) {
+        approval.sourceArtifact = sourceArtifact;
+    }
+    if (transfer) {
+        approval.transfer = transfer;
+    }
+    return approval;
+};
+const compactArtifacts = (artifacts) => {
+    const seen = new Set();
+    const compacted = [];
+    for (const artifact of artifacts) {
+        if (!artifact || seen.has(artifact.ref)) {
+            continue;
+        }
+        seen.add(artifact.ref);
+        compacted.push(artifact);
+    }
+    return compacted;
+};
+export const approvalArtifactsForRun = (run) => {
+    const approvalEvent = run.events.filter((event) => event.type === "approval_required").at(-1);
+    const integrationReportEvent = run.events
+        .filter((event) => event.type === "integration_report_written")
+        .at(-1);
+    return compactArtifacts([
+        artifactForRef(run, approvalEvent?.data?.artifactRef),
+        artifactForRef(run, approvalEvent?.data?.sourceArtifactRef),
+        run.approvalReason?.includes("protected test changes")
+            ? artifactForRef(run, integrationReportEvent?.data?.artifactRef)
+            : undefined
+    ]);
+};
+export const pendingApprovalForRun = (run) => {
+    if (!run.approvalRequired) {
+        return undefined;
+    }
+    return {
+        runId: run.runId,
+        createdAt: run.createdAt,
+        updatedAt: run.updatedAt,
+        repoPath: run.repoPath,
+        mode: run.mode,
+        state: run.state,
+        goal: run.userGoal,
+        reason: run.approvalReason ?? "Approval is required before this run can continue.",
+        suggestedApprovalMessage: approvalMessageHint(run),
+        artifacts: approvalArtifactsForRun(run)
+    };
+};
+export const pendingApprovalsFromRuns = (runs) => runs
+    .map(pendingApprovalForRun)
+    .filter((approval) => approval !== undefined)
+    .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+export const recentAutopilotApprovalsFromRuns = (runs, limit = defaultAutopilotApprovalLimit) => runs
+    .flatMap((run) => run.events
+    .map((event) => autopilotApprovalForEvent(run, event))
+    .filter((approval) => approval !== undefined))
+    .sort((left, right) => right.createdAt.localeCompare(left.createdAt))
+    .slice(0, limit);
+export const recentHandoffsFromRuns = (runs, limit = defaultAutopilotApprovalLimit) => runs
+    .flatMap((run) => recentRunHandoffSummaries(run, limit).map((handoff) => ({
+    ...handoff,
+    runId: run.runId,
+    updatedAt: run.updatedAt,
+    state: run.state,
+    goal: run.userGoal
+})))
+    .sort((left, right) => right.createdAt.localeCompare(left.createdAt))
+    .slice(0, limit);
+export const approvalInboxViewFromRuns = (runs, limit = defaultAutopilotApprovalLimit) => ({
+    pendingApprovals: pendingApprovalsFromRuns(runs),
+    recentAutopilotApprovals: recentAutopilotApprovalsFromRuns(runs, limit),
+    recentHandoffs: recentHandoffsFromRuns(runs, limit)
+});
+//# sourceMappingURL=approvalInbox.js.map

package/dist/runtime/approvalInbox.js.map

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

package/dist/runtime/approvalPolicy.d.ts

@@ -0,0 +1,11 @@
+import type { ExternalTransferManifest, ExternalTransferPolicyDecision, TheHoodConfig } from "./types.js";
+export interface ExternalTransferPolicyEvaluation {
+    decision: ExternalTransferPolicyDecision;
+    reason: string;
+}
+export declare const activeApprovalPolicyMode: (config: TheHoodConfig) => TheHoodConfig["approvalPolicy"]["mode"];
+export declare const isAutopilotEnabled: (config: TheHoodConfig) => boolean;
+export declare const autopilotApprovalReason: (summary: string) => string;
+export declare const autopilotPolicyReason: (gate: string) => string;
+export declare const evaluateExternalTransferPolicy: (config: TheHoodConfig, manifest: ExternalTransferManifest) => ExternalTransferPolicyEvaluation;
+export declare const autoApprovalReason: (manifest: ExternalTransferManifest, evaluation: ExternalTransferPolicyEvaluation) => string;

package/dist/runtime/approvalPolicy.js

@@ -0,0 +1,58 @@
+export const activeApprovalPolicyMode = (config) => config.approvalPolicy.mode ?? config.approvalPolicy.externalTransfers.mode;
+export const isAutopilotEnabled = (config) => activeApprovalPolicyMode(config) === "autopilot";
+export const autopilotApprovalReason = (summary) => `Auto-approved by TheHood autopilot policy: ${summary}`;
+export const autopilotPolicyReason = (gate) => `Approval policy autopilot allowed ${gate}.`;
+const ruleMatches = (rule, manifest) => {
+    if (rule.provider && rule.provider !== manifest.destination.provider) {
+        return false;
+    }
+    if (rule.model && rule.model !== manifest.destination.model) {
+        return false;
+    }
+    if (rule.purposes && !rule.purposes.includes(manifest.purpose)) {
+        return false;
+    }
+    if (rule.riskClasses && !rule.riskClasses.includes(manifest.risk.class)) {
+        return false;
+    }
+    if (rule.maxBytes !== undefined && manifest.totalBytes > rule.maxBytes) {
+        return false;
+    }
+    return true;
+};
+export const evaluateExternalTransferPolicy = (config, manifest) => {
+    const policy = config.approvalPolicy.externalTransfers;
+    const mode = activeApprovalPolicyMode(config);
+    const matchingRule = policy.rules.find((rule) => ruleMatches(rule, manifest));
+    if (matchingRule) {
+        return {
+            decision: matchingRule.decision,
+            reason: `Matched external transfer policy rule for ${manifest.destination.provider}:${manifest.destination.model}.`
+        };
+    }
+    if (mode === "autopilot" &&
+        manifest.risk.class !== "secret_risk" &&
+        manifest.totalBytes <= policy.maxAutoApproveBytes) {
+        return {
+            decision: "auto_approve",
+            reason: `Approval policy autopilot allowed ${manifest.purpose} ` +
+                `(${manifest.totalBytes}/${policy.maxAutoApproveBytes} bytes, risk ${manifest.risk.class}).`
+        };
+    }
+    if ((mode === "auto_low_risk" || policy.mode === "auto_low_risk") &&
+        manifest.risk.class !== "secret_risk" &&
+        manifest.totalBytes <= policy.maxAutoApproveBytes) {
+        return {
+            decision: "auto_approve",
+            reason: `External transfer policy auto_low_risk allowed ${manifest.purpose} ` +
+                `(${manifest.totalBytes}/${policy.maxAutoApproveBytes} bytes, risk ${manifest.risk.class}).`
+        };
+    }
+    return {
+        decision: "manual",
+        reason: `External transfer policy requires manual approval ` +
+            `(${manifest.purpose}, risk ${manifest.risk.class}, ${manifest.totalBytes} bytes).`
+    };
+};
+export const autoApprovalReason = (manifest, evaluation) => `Auto-approved by TheHood approval policy: ${manifest.approvalHint} ${evaluation.reason}`;
+//# sourceMappingURL=approvalPolicy.js.map

package/dist/runtime/approvalPolicy.js.map

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

package/dist/runtime/artifacts.d.ts

@@ -0,0 +1,23 @@
+import type { RunArtifact, RunArtifactKind } from "./types.js";
+export interface WriteArtifactInput {
+    repoPath: string;
+    runId: string;
+    kind: RunArtifactKind;
+    name: string;
+    content: string;
+    summary: string;
+}
+export interface ReadArtifactInput {
+    repoPath: string;
+    runId: string;
+    ref: string;
+    maxBytes?: number;
+}
+export interface ReadArtifactResult {
+    artifact: RunArtifact;
+    content: string;
+    truncated: boolean;
+    byteLength: number;
+}
+export declare const writeRunArtifact: (input: WriteArtifactInput) => Promise<RunArtifact>;
+export declare const readRunArtifact: (input: ReadArtifactInput) => Promise<ReadArtifactResult>;

package/dist/runtime/artifacts.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";
+import { loadRun } from "./store.js";
+import { InputError, PermissionDeniedError } from "./errors.js";
+const safeArtifactName = (name) => name.replace(/[^a-zA-Z0-9._-]/g, "_").replace(/^_+/, "") || "artifact.txt";
+const maxArtifactReadBytes = 200_000;
+export const writeRunArtifact = async (input) => {
+    const artifactDir = path.join(getProjectPaths(input.repoPath).artifactsDir, input.runId, input.kind);
+    const artifactPath = path.join(artifactDir, safeArtifactName(input.name));
+    await ensureLocalStateIgnored(input.repoPath);
+    await fs.mkdir(artifactDir, { recursive: true });
+    await fs.writeFile(artifactPath, input.content, "utf8");
+    return {
+        kind: input.kind,
+        ref: artifactPath,
+        summary: input.summary
+    };
+};
+const assertArtifactPath = (repoPath, runId, ref) => {
+    const artifactRoot = path.join(getProjectPaths(repoPath).artifactsDir, runId);
+    const resolved = path.resolve(ref);
+    const relative = path.relative(artifactRoot, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new PermissionDeniedError(`Artifact ref is outside this run's artifact directory: ${ref}`);
+    }
+    return resolved;
+};
+export const readRunArtifact = async (input) => {
+    const run = await loadRun(input.repoPath, input.runId);
+    const artifact = run.artifacts.find((candidate) => candidate.ref === input.ref);
+    if (!artifact) {
+        throw new InputError(`Artifact ref is not attached to run ${input.runId}.`);
+    }
+    const artifactPath = assertArtifactPath(input.repoPath, input.runId, input.ref);
+    const raw = await fs.readFile(artifactPath);
+    const requestedMaxBytes = input.maxBytes ?? 20_000;
+    const maxBytes = Math.min(Math.max(1, requestedMaxBytes), maxArtifactReadBytes);
+    const sliced = raw.subarray(0, maxBytes);
+    return {
+        artifact,
+        content: sliced.toString("utf8"),
+        truncated: raw.byteLength > maxBytes,
+        byteLength: raw.byteLength
+    };
+};
+//# sourceMappingURL=artifacts.js.map

package/dist/runtime/artifacts.js.map

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

package/dist/runtime/browserManager.d.ts

@@ -0,0 +1,37 @@
+export interface BrowserManagerOptions {
+    port?: number;
+    cdpUrl?: string;
+    profile?: string;
+    profilePath?: string;
+    url?: string;
+    chromePath?: string;
+}
+export interface BrowserStatus {
+    provider: "chatgpt-web";
+    cdpUrl: string;
+    profilePath: string;
+    chromePath?: string;
+    pid?: number;
+    cdpReachable: boolean;
+    chatGptTabFound: boolean;
+    chatGptPageInspected: boolean;
+    chatGptAuthenticated: boolean;
+    chatGptComposerReady: boolean;
+    readyForBridge: boolean;
+    targetCount: number;
+    issues: string[];
+}
+export interface BrowserStartResult {
+    launched: boolean;
+    status: BrowserStatus;
+}
+export interface BrowserStopResult {
+    stopped: boolean;
+    status: BrowserStatus;
+    reason?: string;
+}
+export declare const defaultBrowserProfilePath: (profile?: string) => string;
+export declare const resolveChromePath: (requestedPath?: string) => Promise<string>;
+export declare const inspectBrowser: (options?: BrowserManagerOptions) => Promise<BrowserStatus>;
+export declare const startBrowser: (options?: BrowserManagerOptions) => Promise<BrowserStartResult>;
+export declare const stopBrowser: (options?: BrowserManagerOptions) => Promise<BrowserStopResult>;