@petepetrash/circuit 0.1.0

package/dist/connectors/remediation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/connectors/remediation.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CASvE"}

package/dist/connectors/remediation.js

@@ -0,0 +1,16 @@
+// Plain-English fixes for broken builtin connector CLIs. Shared by the
+// connectors' own spawn-failure errors (so a mid-run death names its fix) and
+// by `circuit doctor` (so the operator hears about it before any spend).
+// Standalone module with no imports: connectors and health checks both use
+// it without creating an import cycle.
+export function connectorRemediation(name) {
+    switch (name) {
+        case 'claude-code':
+            return 'Fix: install Claude Code (https://claude.com/claude-code), then check it with: claude --version';
+        case 'codex':
+            return 'Fix: reinstall the Codex CLI (npm install -g @openai/codex), then check it with: codex --version. If it is installed but signed out, run: codex login';
+        case 'cursor-agent':
+            return 'Fix: install the Cursor CLI, then check it with: cursor-agent status. If it is installed but signed out, run: cursor-agent login';
+    }
+}
+//# sourceMappingURL=remediation.js.map

package/dist/connectors/remediation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediation.js","sourceRoot":"","sources":["../../src/connectors/remediation.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,8EAA8E;AAC9E,yEAAyE;AACzE,2EAA2E;AAC3E,uCAAuC;AAIvC,MAAM,UAAU,oBAAoB,CAAC,IAA0B;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,iGAAiG,CAAC;QAC3G,KAAK,OAAO;YACV,OAAO,uJAAuJ,CAAC;QACjK,KAAK,cAAc;YACjB,OAAO,kIAAkI,CAAC;IAC9I,CAAC;AACH,CAAC"}

package/dist/connectors/resolver.d.ts

@@ -0,0 +1,44 @@
+import type { WorkRootKind } from '../schemas/change-packet.js';
+import type { LayeredConfig as LayeredConfigValue } from '../schemas/config.js';
+import type { ConnectorReference } from '../schemas/config.js';
+import type { ConnectorCapabilities, ResolvedConnector } from '../schemas/connector.js';
+import type { HostKind } from '../schemas/host.js';
+import type { ResolvedSelection } from '../schemas/selection-policy.js';
+import type { RelayRole } from '../schemas/step.js';
+import type { ResolvedConnectorDecision } from './connector.js';
+type RelayConfigValue = LayeredConfigValue['config']['relay'];
+export declare function customConnectorRegistryFromLayers(layers: readonly LayeredConfigValue[] | undefined): {
+    readonly registry: RelayConfigValue['connectors'];
+    readonly projectDeclaredNames: ReadonlySet<string>;
+};
+export declare function projectCustomConnectorRefusalMessage(name: string): string;
+export declare function connectorCapabilities(connector: ResolvedConnector): ConnectorCapabilities;
+export type RelayWriteClassification = {
+    readonly filesystem: 'read-only';
+    readonly write_capable: false;
+    readonly may_unlock_higher_autonomy_after_safe_apply: false;
+    readonly reason: string;
+} | {
+    readonly filesystem: 'trusted-write' | 'isolated-write';
+    readonly write_capable: true;
+    readonly work_root_kind: WorkRootKind;
+    readonly may_unlock_higher_autonomy_after_safe_apply: boolean;
+    readonly reason: string;
+};
+export declare function classifyConnectorFilesystem(capabilities: ConnectorCapabilities): RelayWriteClassification;
+export declare function classifyRelayWriteMode(connector: ResolvedConnector): RelayWriteClassification;
+export declare function assertConnectorCanRunRole(connector: ResolvedConnector, role: RelayRole): void;
+export declare function resolveConnectorReference(input: {
+    readonly ref: ConnectorReference;
+    readonly configLayers?: readonly LayeredConfigValue[];
+}): ResolvedConnector;
+export declare function resolveConnectorForGuidanceInput(input: {
+    readonly flowId: string;
+    readonly role: RelayRole;
+    readonly configLayers?: readonly LayeredConfigValue[];
+    readonly explicitConnector?: ResolvedConnector;
+    readonly hostKind?: HostKind;
+}): ResolvedConnectorDecision;
+export declare function assertConnectorSelectionCompatible(connectorName: string, selection: ResolvedSelection | undefined): void;
+export {};
+//# sourceMappingURL=resolver.d.ts.map

package/dist/connectors/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/connectors/resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EACV,qBAAqB,EAGrB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,KAAK,gBAAgB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;AAoB9D,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,GAChD;IACD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAClD,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpD,CAeA;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAmDD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,GAAG,qBAAqB,CAGzF;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,2CAA2C,EAAE,KAAK,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,2CAA2C,EAAE,OAAO,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,qBAAqB,GAClC,wBAAwB,CA2B1B;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,iBAAiB,GAAG,wBAAwB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAO7F;AAkBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACvD,GAAG,iBAAiB,CAEpB;AA0CD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,GAAG,yBAAyB,CA4C5B;AAgBD,wBAAgB,kCAAkC,CAChD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACvC,IAAI,CAgBN"}

package/dist/connectors/resolver.js

@@ -0,0 +1,204 @@
+import { BUILTIN_CONNECTOR_CAPABILITIES, BUILTIN_CONNECTOR_SPECS, EnabledConnector as EnabledConnectorSchema, } from '../schemas/connector.js';
+// SECURITY BOUNDARY (C1 — arbitrary command execution from a cloned repo).
+// A custom connector descriptor carries an arbitrary `command` that the engine
+// spawns with the full inherited environment. A project's committed
+// `.circuit/config.yaml` is untrusted input: cloning a repository and running
+// any flow (even a read-only review) must never let the repository author's
+// config execute a command on the operator's machine. So custom connector
+// definitions are honored only from layers the operator controls on their own
+// machine — their user-global config or an explicit invocation override — and
+// never from the project layer. Built-in connector names (claude-code / codex
+// / cursor-agent) name a fixed, Circuit-shipped executable rather than an
+// arbitrary command, so they stay selectable from any layer.
+//
+// This is the single place the project-vs-trusted partition of the custom
+// connector registry lives. Every path that turns a connector name into a
+// command-bearing descriptor resolves it through this registry (relay default
+// / role / flow resolution here, and the step-pinned connector path in
+// runtime/run/relay-guidance.ts), so the boundary cannot be forgotten by one
+// caller while another honors it.
+export function customConnectorRegistryFromLayers(layers) {
+    const registry = {};
+    const projectDeclaredNames = new Set();
+    for (const layer of layers ?? []) {
+        if (layer.layer === 'project') {
+            // Record the names a project tried to register (to explain the refusal
+            // clearly if a selection points at one) but never adopt the command.
+            for (const name of Object.keys(layer.config.relay.connectors)) {
+                projectDeclaredNames.add(name);
+            }
+            continue;
+        }
+        Object.assign(registry, layer.config.relay.connectors);
+    }
+    return { registry, projectDeclaredNames };
+}
+export function projectCustomConnectorRefusalMessage(name) {
+    return `This project config (.circuit/config.yaml) defines a custom connector '${name}' that runs its own command. Circuit does not run custom command connectors that come from a project config, because cloning or opening a repository could then run code on your machine. If you trust this connector, define '${name}' in your personal config at ~/.config/circuit/config.yaml instead.`;
+}
+function mergedRelayConfig(layers) {
+    const merged = {
+        default: 'auto',
+        roles: {},
+        flows: {},
+        connectors: {},
+    };
+    for (const layer of layers ?? []) {
+        if (layer.config.relay.default !== 'auto' || merged.default === 'auto') {
+            merged.default = layer.config.relay.default;
+        }
+        merged.roles = { ...merged.roles, ...layer.config.relay.roles };
+        merged.flows = { ...merged.flows, ...layer.config.relay.flows };
+    }
+    const { registry, projectDeclaredNames } = customConnectorRegistryFromLayers(layers);
+    merged.connectors = registry;
+    return { relay: merged, projectDeclaredCustomConnectors: projectDeclaredNames };
+}
+function projectCustomRefusalOrNotDeclared(name, merged, notDeclaredMessage) {
+    if (merged.projectDeclaredCustomConnectors.has(name)) {
+        return new Error(projectCustomConnectorRefusalMessage(name));
+    }
+    return new Error(notDeclaredMessage);
+}
+function mergedHostKind(layers) {
+    let hostKind;
+    for (const layer of layers ?? []) {
+        const configuredHostKind = layer.config.host?.kind;
+        if (configuredHostKind !== undefined) {
+            hostKind = configuredHostKind;
+        }
+    }
+    return hostKind ?? 'generic-shell';
+}
+export function connectorCapabilities(connector) {
+    if (connector.kind === 'builtin')
+        return BUILTIN_CONNECTOR_CAPABILITIES[connector.name];
+    return connector.capabilities;
+}
+export function classifyConnectorFilesystem(capabilities) {
+    if (capabilities.filesystem === 'read-only') {
+        return {
+            filesystem: 'read-only',
+            write_capable: false,
+            may_unlock_higher_autonomy_after_safe_apply: false,
+            reason: 'connector is read-only',
+        };
+    }
+    if (capabilities.filesystem === 'isolated-write') {
+        return {
+            filesystem: 'isolated-write',
+            write_capable: true,
+            work_root_kind: 'isolated_worktree',
+            may_unlock_higher_autonomy_after_safe_apply: true,
+            reason: 'connector writes outside the parent checkout',
+        };
+    }
+    return {
+        filesystem: 'trusted-write',
+        write_capable: true,
+        work_root_kind: 'pre_safe_apply_trusted_write',
+        may_unlock_higher_autonomy_after_safe_apply: false,
+        reason: 'connector can mutate the parent checkout before SafeApply',
+    };
+}
+export function classifyRelayWriteMode(connector) {
+    return classifyConnectorFilesystem(connectorCapabilities(connector));
+}
+export function assertConnectorCanRunRole(connector, role) {
+    const capabilities = connectorCapabilities(connector);
+    if (role === 'implementer' && capabilities.filesystem === 'read-only') {
+        throw new Error(`relay connector '${connector.name}' is read-only and cannot run implementer step role '${role}'`);
+    }
+}
+function resolvedConnectorFromReference(ref, merged) {
+    if (ref.kind === 'builtin')
+        return ref;
+    const descriptor = merged.relay.connectors[ref.name];
+    if (descriptor === undefined) {
+        throw projectCustomRefusalOrNotDeclared(ref.name, merged, `relay connector '${ref.name}' is referenced but not declared`);
+    }
+    return descriptor;
+}
+export function resolveConnectorReference(input) {
+    return resolvedConnectorFromReference(input.ref, mergedRelayConfig(input.configLayers));
+}
+function isEnabledConnector(value) {
+    return EnabledConnectorSchema.options.includes(value);
+}
+function resolvedConnectorFromDefault(defaultRef, merged) {
+    if (isEnabledConnector(defaultRef)) {
+        return { kind: 'builtin', name: defaultRef };
+    }
+    const descriptor = merged.relay.connectors[defaultRef];
+    if (descriptor === undefined) {
+        throw projectCustomRefusalOrNotDeclared(defaultRef, merged, `relay default connector '${defaultRef}' is referenced but not declared`);
+    }
+    return descriptor;
+}
+function decision(connector, resolvedFrom, role) {
+    assertConnectorCanRunRole(connector, role);
+    return {
+        connectorName: connector.name,
+        connector,
+        resolvedFrom,
+    };
+}
+function autoConnectorForHost(hostKind) {
+    if (hostKind === 'codex')
+        return { kind: 'builtin', name: 'codex' };
+    return { kind: 'builtin', name: 'claude-code' };
+}
+export function resolveConnectorForGuidanceInput(input) {
+    if (input.explicitConnector !== undefined) {
+        return decision(input.explicitConnector, { source: 'explicit' }, input.role);
+    }
+    const merged = mergedRelayConfig(input.configLayers);
+    const roleRef = merged.relay.roles[input.role];
+    if (roleRef !== undefined) {
+        return decision(resolvedConnectorFromReference(roleRef, merged), {
+            source: 'role',
+            role: input.role,
+        }, input.role);
+    }
+    const flowId = input.flowId;
+    const flowRef = merged.relay.flows[flowId];
+    if (flowRef !== undefined) {
+        return decision(resolvedConnectorFromReference(flowRef, merged), {
+            source: 'flow',
+            flow_id: flowId,
+        }, input.role);
+    }
+    if (merged.relay.default !== 'auto') {
+        return decision(resolvedConnectorFromDefault(merged.relay.default, merged), { source: 'default' }, input.role);
+    }
+    return decision(autoConnectorForHost(input.hostKind ?? mergedHostKind(input.configLayers)), { source: 'auto' }, input.role);
+}
+// Provider / supported-effort lookups are now registry-driven. A custom
+// connector name is not in the built-in registry and resolves to `undefined`,
+// which the callers treat as "no built-in compatibility constraint to assert"
+// — identical to the prior if-chain fall-through.
+function expectedProvider(connectorName) {
+    if (!isEnabledConnector(connectorName))
+        return undefined;
+    return BUILTIN_CONNECTOR_SPECS[connectorName].provider;
+}
+function supportedEfforts(connectorName) {
+    if (!isEnabledConnector(connectorName))
+        return undefined;
+    return BUILTIN_CONNECTOR_SPECS[connectorName].supportedEfforts;
+}
+export function assertConnectorSelectionCompatible(connectorName, selection) {
+    const expected = expectedProvider(connectorName);
+    const model = selection?.model;
+    if (expected !== undefined && model !== undefined && model.provider !== expected) {
+        throw new Error(`${connectorName} connector cannot honor model provider '${model.provider}' for model '${model.model}'; expected provider '${expected}'`);
+    }
+    const effort = selection?.effort;
+    if (effort === undefined)
+        return;
+    const supported = supportedEfforts(connectorName);
+    if (supported !== undefined && !supported.includes(effort)) {
+        throw new Error(`${connectorName} connector cannot honor effort '${effort}'; supported efforts: ${supported.join(', ')}`);
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/connectors/resolver.js.map

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

package/dist/connectors/subprocess.d.ts

@@ -0,0 +1,59 @@
+export declare class ConnectorSubprocessSpawnError extends Error {
+    readonly phase: 'spawn-failed' | 'spawn-error';
+    constructor(phase: 'spawn-failed' | 'spawn-error', message: string);
+}
+export declare function isConnectorSubprocessSpawnError(error: unknown): error is ConnectorSubprocessSpawnError;
+export type ConnectorTimeoutKind = 'idle' | 'absolute';
+export interface ConnectorSubprocessResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly stdoutCapped: boolean;
+    readonly stderrCapped: boolean;
+    readonly timedOut: boolean;
+    readonly timeoutKind?: ConnectorTimeoutKind;
+    readonly killGroupSucceeded: boolean;
+    readonly code: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly durationMs: number;
+}
+export interface RunConnectorSubprocessInput {
+    readonly executable: string;
+    readonly args: readonly string[];
+    readonly timeoutMs: number;
+    readonly idleTimeoutMs?: number;
+    readonly stdoutMaxBytes: number;
+    readonly stderrMaxBytes: number;
+    readonly sigtermToSigkillGraceMs: number;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly cwd?: string;
+}
+export interface CreateTimeoutControllerInput {
+    readonly absoluteMs: number;
+    readonly idleMs?: number;
+    readonly onFire: (kind: ConnectorTimeoutKind) => void;
+}
+export interface TimeoutController {
+    readonly onActivity: () => void;
+    readonly clear: () => void;
+}
+export declare function createTimeoutController(input: CreateTimeoutControllerInput): TimeoutController;
+export declare function spawnErrorVerb(error: ConnectorSubprocessSpawnError): 'spawn failed' | 'spawn error';
+export declare function cappedSuffix(capped: boolean, stream: 'stdout' | 'stderr'): string;
+export declare function describeTimeout(result: Pick<ConnectorSubprocessResult, 'timeoutKind'>, bounds: {
+    readonly idleMs?: number;
+    readonly absoluteMs: number;
+}): string;
+export declare function launchFailureSummary(cli: string, errorText: string): string;
+export interface ConnectorFailureSummaryInput {
+    readonly cli: string;
+    readonly signInHint: string;
+    readonly stderr: string;
+    readonly stdout: string;
+    readonly streamError: string | undefined;
+}
+export declare function connectorFailureSummary(input: ConnectorFailureSummaryInput): string | undefined;
+export declare function lastStreamErrorMessage(stdout: string): string | undefined;
+export declare function condenseRepeatedLines(text: string): string;
+export declare function parseNdjsonObjects(stdout: string, label: string): Array<Record<string, unknown>>;
+export declare function runConnectorSubprocess(input: RunConnectorSubprocessInput): Promise<ConnectorSubprocessResult>;
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/connectors/subprocess.d.ts.map

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