@petepetrash/circuit 0.1.0

package/dist/schemas/config.d.ts.map

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

package/dist/schemas/config.js

@@ -0,0 +1,240 @@
+import { z } from 'zod';
+import { ConnectorName, CustomConnectorDescriptor, EnabledConnector, RESERVED_CONNECTOR_NAMES, } from './connector.js';
+import { HostConfig } from './host.js';
+import { CompiledFlowId, SkillId, SkillSlotId } from './ids.js';
+import { Power, PowerDialSetting, powerIndex } from './power.js';
+import { Effort, ProviderScopedModel, SelectionOverride } from './selection-policy.js';
+import { SkillHookConfig } from './skill-hook.js';
+import { RelayRole } from './step.js';
+// connector-I5 + connector-I9: the registry-layer `ConnectorReference` is a
+// 2-variant discriminated union with per-variant `.strict()`. Inline
+// `CustomConnectorDescriptor` is NOT a legal registry-layer reference —
+// custom connectors must be registered in `relay.connectors` exactly once
+// and referenced by name. Surplus keys (typos like `nmae: 'gemini'`) are
+// rejected at parse time so they point at the typo directly.
+//
+// `ConnectorReference` is exported so future callers
+// can validate registry-layer references directly (instead of reaching for
+// `ConnectorRef`, which admits inline custom descriptors and would silently
+// relax connector-I5).
+export const ConnectorReference = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('builtin'), name: EnabledConnector }).strict(),
+    z.object({ kind: z.literal('named'), name: ConnectorName }).strict(),
+]);
+// connector-I9: `.strict()` on RelayConfigBody rejects surplus keys at the
+// top level (e.g. `relay.adpaters` typo transposition), so the author's
+// intent — "register a custom connector" — fails loudly rather than silently
+// producing an empty registry whose named references then fail closure with
+// a misleading error far from the typo.
+const RelayConfigBody = z
+    .object({
+    default: z.union([EnabledConnector, z.literal('auto'), ConnectorName]).default('auto'),
+    roles: z.partialRecord(RelayRole, ConnectorReference).default({}),
+    flows: z.record(CompiledFlowId, ConnectorReference).default({}),
+    connectors: z.record(ConnectorName, CustomConnectorDescriptor).default({}),
+})
+    .strict();
+const issueAt = (ctx, path, message) => {
+    ctx.addIssue({ code: 'custom', path, message });
+};
+export const RelayConfig = RelayConfigBody.superRefine((cfg, ctx) => {
+    // connector-I2: reserved-name disjointness. A custom connector keyed under a
+    // `EnabledConnector` value or the `'auto'` sentinel would silently shadow
+    // the built-in in `relay.default` resolution — it would parse, appear
+    // in the registry, and be picked by `default: 'codex'`, producing a
+    // behavior divergence the author did not intend. Reject at parse time.
+    //
+    // Iterate only OWN keys via `Object.keys` and
+    // check membership via a Set (not via bracket access on the record), so
+    // inherited prototype names like `constructor`, `toString`, `__proto__`,
+    // and `hasOwnProperty` cannot smuggle past closure checks. Bracket
+    // access `cfg.connectors['constructor']` on a parsed object would resolve
+    // to `Object.prototype.constructor` and satisfy a truthiness check even
+    // when no own property exists.
+    const ownConnectorKeys = Object.keys(cfg.connectors);
+    const registered = new Set(ownConnectorKeys);
+    const reserved = new Set(RESERVED_CONNECTOR_NAMES);
+    for (const name of ownConnectorKeys) {
+        if (reserved.has(name)) {
+            issueAt(ctx, ['connectors', name], `connector name '${name}' is reserved (built-in or 'auto') and cannot be used as a custom connector key`);
+        }
+        // Registry key and descriptor `name` must
+        // agree. `{connectors: {gemini: {name: 'ollama', ...}}}` parses per
+        // ConnectorName regex but leaves two connector identities (`gemini` via
+        // registry key, `ollama` via emitted descriptor) for a single
+        // registered executor. TraceEntries would carry a `name` the audit index
+        // doesn't know about.
+        const descriptor = cfg.connectors[name];
+        if (descriptor && descriptor.name !== name) {
+            issueAt(ctx, ['connectors', name, 'name'], `connector registry key '${name}' does not match descriptor name '${descriptor.name}'`);
+        }
+    }
+    const known = new Set(['auto', ...EnabledConnector.options, ...ownConnectorKeys]);
+    if (typeof cfg.default === 'string' && !known.has(cfg.default)) {
+        issueAt(ctx, ['default'], `relay.default references unknown connector: ${cfg.default}`);
+    }
+    for (const [role, ref] of Object.entries(cfg.roles)) {
+        if (ref && ref.kind === 'named' && !registered.has(ref.name)) {
+            issueAt(ctx, ['roles', role], `role connector not registered: ${ref.name}`);
+        }
+        if (role === 'implementer' && ref && ref.kind === 'named') {
+            const descriptor = cfg.connectors[ref.name];
+            if (descriptor?.capabilities.filesystem === 'read-only') {
+                issueAt(ctx, ['roles', role], `custom connector '${ref.name}' is read-only and cannot be used for implementer relay steps`);
+            }
+        }
+    }
+    for (const [flowId, ref] of Object.entries(cfg.flows)) {
+        if (ref && ref.kind === 'named' && !registered.has(ref.name)) {
+            issueAt(ctx, ['flows', flowId], `connector for flow not registered: ${ref.name}`);
+        }
+    }
+});
+export const SkillBindings = z.record(SkillSlotId, SkillId);
+export const SkillsConfig = z
+    .object({
+    bindings: SkillBindings.default({}),
+})
+    .strict();
+export const FlowVariantModelId = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9-]*$/, {
+    message: 'variant model id must be a fanout-safe kebab-case slug',
+});
+export const FlowVariantModel = z
+    .object({
+    id: FlowVariantModelId,
+    label: z.string().min(1),
+    connector: ConnectorReference.optional(),
+    selection: SelectionOverride,
+})
+    .strict()
+    .superRefine((variant, ctx) => {
+    if (variant.selection.model === undefined) {
+        issueAt(ctx, ['selection', 'model'], 'variant model selection.model is required');
+    }
+    if (variant.selection.effort === undefined) {
+        issueAt(ctx, ['selection', 'effort'], 'variant model selection.effort is required');
+    }
+});
+export const FlowVariantModels = z
+    .array(FlowVariantModel)
+    .min(2)
+    .max(4)
+    .superRefine((variants, ctx) => {
+    const seen = new Set();
+    for (const [index, variant] of variants.entries()) {
+        if (seen.has(variant.id)) {
+            issueAt(ctx, [index, 'id'], `duplicate variant model id '${variant.id}'`);
+        }
+        seen.add(variant.id);
+    }
+});
+// Per-circuit skill contribution flows through `selection.skills` via
+// typed `SkillOverride` operations. (Earlier shapes accepted an untyped
+// `skills: string[]` channel that bypassed validation.)
+export const FlowOverride = z
+    .object({
+    selection: SelectionOverride.optional(),
+    skill_bindings: SkillBindings.default({}),
+    variant_models: FlowVariantModels.optional(),
+})
+    .strict();
+// Top-level Config and its nested `defaults` object both `.strict()` so
+// authorial typos (e.g. `defuults: {...}` at root or
+// `defaults: {selections: ...}` nested) fail fast at parse time rather
+// than silently stripping to empty defaults. `.default(...)` on every
+// non-version field preserves the ergonomic that a minimal
+// `{schema_version: 1}` parses as a fully-populated Config.
+// Slice 5 (D1): the operator-set project-identity override for self-auditing
+// project memory. When present it wins over git-remote inference and the
+// runs-base fallback (resolveProjectId), so an operator can pin a stable key
+// across worktrees/clones (or make the explicit value mandatory by setting it
+// and never relying on inference). A fanout-safe kebab-case slug because the id
+// is later hashed and stamped into provenance, never joined into a path.
+export const ProjectId = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9-]*$/, {
+    message: 'project_id must be a fanout-safe kebab-case slug',
+});
+// One Power tier's translation for one connector: the concrete model and/or
+// effort that tier word means there. At least one field is required — an
+// empty spec would silently make the tier a no-op.
+export const PowerTierSpec = z
+    .object({
+    model: ProviderScopedModel.optional(),
+    effort: Effort.optional(),
+})
+    .strict()
+    .superRefine((spec, ctx) => {
+    if (spec.model === undefined && spec.effort === undefined) {
+        issueAt(ctx, [], 'power tier spec must set model, effort, or both');
+    }
+});
+// Per-connector translation from Power tier words to concrete selections.
+// Keyed by connector name (built-in or registered custom). Layered: a
+// project config can override a single tier of a single connector and the
+// shipped defaults fill the rest (src/selection/power-tiers.ts).
+export const PowerTierTable = z.partialRecord(Power, PowerTierSpec);
+// Operator bounds on the auto dial: when `defaults.power` is `auto`, the
+// run's inferred tier is clamped into [floor, ceiling]. Bounds are concrete
+// tiers (never `auto`), each optional — absent means the full range on that
+// side. Inert unless the dial setting is auto.
+export const PowerAutoBounds = z
+    .object({
+    floor: Power.optional(),
+    ceiling: Power.optional(),
+})
+    .strict()
+    .superRefine((bounds, ctx) => {
+    if (bounds.floor !== undefined &&
+        bounds.ceiling !== undefined &&
+        powerIndex(bounds.floor) > powerIndex(bounds.ceiling)) {
+        issueAt(ctx, [], 'power_auto floor must not be above ceiling');
+    }
+});
+export const Config = z
+    .object({
+    schema_version: z.literal(1),
+    // Optional so a minimal `{schema_version: 1}` still parses; absent means
+    // "infer the project identity from the git remote, then the runs base".
+    project_id: ProjectId.optional(),
+    // Optional at the layer level so composition can distinguish "this layer
+    // has no host opinion" from an explicit `host: {kind: generic-shell}` reset.
+    host: HostConfig.optional(),
+    relay: RelayConfig.default({
+        default: 'auto',
+        roles: {},
+        flows: {},
+        connectors: {},
+    }),
+    skills: SkillsConfig.default({ bindings: {} }),
+    skill_hooks: SkillHookConfig.default({ policy: {}, detection: { disabled_patterns: {} } }),
+    flows: z.record(CompiledFlowId, FlowOverride).default({}),
+    power_tiers: z.record(ConnectorName, PowerTierTable).default({}),
+    power_auto: PowerAutoBounds.optional(),
+    defaults: z
+        .object({
+        selection: SelectionOverride.optional(),
+        power: PowerDialSetting.optional(),
+    })
+        .strict()
+        .default({}),
+})
+    .strict();
+export const ConfigLayer = z.enum(['default', 'user-global', 'project', 'invocation']);
+// CONFIG-I2 — `.strict()` on the layer wrapper: the three-field shape
+// (`layer`, `source_path?`, `config`) does not silently grow a fourth
+// field. Future ledger additions (checksum, origin, etc.) require an ADR.
+export const LayeredConfig = z
+    .object({
+    layer: ConfigLayer,
+    source_path: z.string().optional(),
+    config: Config,
+})
+    .strict();
+//# sourceMappingURL=config.js.map

package/dist/schemas/config.js.map

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

package/dist/schemas/connector.d.ts

@@ -0,0 +1,216 @@
+import { z } from 'zod';
+export declare const EnabledConnector: z.ZodEnum<{
+    "claude-code": "claude-code";
+    codex: "codex";
+    "cursor-agent": "cursor-agent";
+}>;
+export type EnabledConnector = z.infer<typeof EnabledConnector>;
+export declare const FilesystemCapability: z.ZodEnum<{
+    "read-only": "read-only";
+    "trusted-write": "trusted-write";
+    "isolated-write": "isolated-write";
+}>;
+export type FilesystemCapability = z.infer<typeof FilesystemCapability>;
+export declare const StructuredOutputCapability: z.ZodEnum<{
+    json: "json";
+}>;
+export type StructuredOutputCapability = z.infer<typeof StructuredOutputCapability>;
+export declare const ToolScopeCapability: z.ZodEnum<{
+    none: "none";
+    "allow-list": "allow-list";
+}>;
+export type ToolScopeCapability = z.infer<typeof ToolScopeCapability>;
+export declare const ConnectorCapabilities: z.ZodObject<{
+    filesystem: z.ZodEnum<{
+        "read-only": "read-only";
+        "trusted-write": "trusted-write";
+        "isolated-write": "isolated-write";
+    }>;
+    structured_output: z.ZodEnum<{
+        json: "json";
+    }>;
+    tool_scope: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        "allow-list": "allow-list";
+    }>>;
+}, z.core.$strict>;
+export type ConnectorCapabilities = z.infer<typeof ConnectorCapabilities>;
+export declare const PromptTransport: z.ZodEnum<{
+    "prompt-file": "prompt-file";
+}>;
+export type PromptTransport = z.infer<typeof PromptTransport>;
+export declare const ConnectorOutputExtraction: z.ZodObject<{
+    kind: z.ZodLiteral<"output-file">;
+}, z.core.$strict>;
+export type ConnectorOutputExtraction = z.infer<typeof ConnectorOutputExtraction>;
+export type ConnectorProvider = 'anthropic' | 'openai' | 'gemini';
+export interface ConnectorSpec {
+    readonly provider: ConnectorProvider;
+    readonly supportedEfforts: readonly string[];
+    readonly capabilities: ConnectorCapabilities;
+}
+export declare const CLAUDE_CODE_SUPPORTED_EFFORTS: readonly ["low", "medium", "high", "xhigh", "max"];
+export declare const CODEX_SUPPORTED_EFFORTS: readonly ["low", "medium", "high", "xhigh"];
+export declare const CURSOR_AGENT_SUPPORTED_EFFORTS: readonly ["none"];
+export declare const BUILTIN_CONNECTOR_SPECS: {
+    readonly 'claude-code': {
+        readonly provider: "anthropic";
+        readonly supportedEfforts: readonly ["low", "medium", "high", "xhigh", "max"];
+        readonly capabilities: {
+            readonly filesystem: "trusted-write";
+            readonly structured_output: "json";
+            readonly tool_scope: "allow-list";
+        };
+    };
+    readonly codex: {
+        readonly provider: "openai";
+        readonly supportedEfforts: readonly ["low", "medium", "high", "xhigh"];
+        readonly capabilities: {
+            readonly filesystem: "trusted-write";
+            readonly structured_output: "json";
+            readonly tool_scope: "none";
+        };
+    };
+    readonly 'cursor-agent': {
+        readonly provider: "gemini";
+        readonly supportedEfforts: readonly ["none"];
+        readonly capabilities: {
+            readonly filesystem: "trusted-write";
+            readonly structured_output: "json";
+            readonly tool_scope: "none";
+        };
+    };
+};
+export declare const BUILTIN_CONNECTOR_CAPABILITIES: Readonly<Record<EnabledConnector, ConnectorCapabilities>>;
+export declare const RESERVED_CONNECTOR_NAMES: readonly string[];
+export declare const ConnectorName: z.ZodString;
+export type ConnectorName = z.infer<typeof ConnectorName>;
+export declare const CustomConnectorDescriptor: z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    name: z.ZodString;
+    command: z.ZodArray<z.ZodString>;
+    prompt_transport: z.ZodEnum<{
+        "prompt-file": "prompt-file";
+    }>;
+    output: z.ZodObject<{
+        kind: z.ZodLiteral<"output-file">;
+    }, z.core.$strict>;
+    capabilities: z.ZodObject<{
+        filesystem: z.ZodEnum<{
+            "read-only": "read-only";
+            "trusted-write": "trusted-write";
+            "isolated-write": "isolated-write";
+        }>;
+        structured_output: z.ZodEnum<{
+            json: "json";
+        }>;
+        tool_scope: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            "allow-list": "allow-list";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CustomConnectorDescriptor = z.infer<typeof CustomConnectorDescriptor>;
+export declare const BuiltInConnectorRef: z.ZodObject<{
+    kind: z.ZodLiteral<"builtin">;
+    name: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "cursor-agent": "cursor-agent";
+    }>;
+}, z.core.$strict>;
+export type BuiltInConnectorRef = z.infer<typeof BuiltInConnectorRef>;
+export declare const NamedConnectorRef: z.ZodObject<{
+    kind: z.ZodLiteral<"named">;
+    name: z.ZodString;
+}, z.core.$strict>;
+export type NamedConnectorRef = z.infer<typeof NamedConnectorRef>;
+export declare const ConnectorRef: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"builtin">;
+    name: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "cursor-agent": "cursor-agent";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"named">;
+    name: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    name: z.ZodString;
+    command: z.ZodArray<z.ZodString>;
+    prompt_transport: z.ZodEnum<{
+        "prompt-file": "prompt-file";
+    }>;
+    output: z.ZodObject<{
+        kind: z.ZodLiteral<"output-file">;
+    }, z.core.$strict>;
+    capabilities: z.ZodObject<{
+        filesystem: z.ZodEnum<{
+            "read-only": "read-only";
+            "trusted-write": "trusted-write";
+            "isolated-write": "isolated-write";
+        }>;
+        structured_output: z.ZodEnum<{
+            json: "json";
+        }>;
+        tool_scope: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            "allow-list": "allow-list";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export type ConnectorRef = z.infer<typeof ConnectorRef>;
+export declare const ResolvedConnector: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"builtin">;
+    name: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "cursor-agent": "cursor-agent";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    name: z.ZodString;
+    command: z.ZodArray<z.ZodString>;
+    prompt_transport: z.ZodEnum<{
+        "prompt-file": "prompt-file";
+    }>;
+    output: z.ZodObject<{
+        kind: z.ZodLiteral<"output-file">;
+    }, z.core.$strict>;
+    capabilities: z.ZodObject<{
+        filesystem: z.ZodEnum<{
+            "read-only": "read-only";
+            "trusted-write": "trusted-write";
+            "isolated-write": "isolated-write";
+        }>;
+        structured_output: z.ZodEnum<{
+            json: "json";
+        }>;
+        tool_scope: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            "allow-list": "allow-list";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export type ResolvedConnector = z.infer<typeof ResolvedConnector>;
+export declare function connectorToolScopeCapability(connector: ResolvedConnector): ToolScopeCapability;
+export declare const RelayResolutionSource: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodLiteral<"explicit">;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<"role">;
+    role: z.ZodEnum<{
+        researcher: "researcher";
+        implementer: "implementer";
+        reviewer: "reviewer";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<"flow">;
+    flow_id: z.core.$ZodBranded<z.ZodString, "CompiledFlowId", "out">;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<"default">;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<"auto">;
+}, z.core.$strict>], "source">;
+export type RelayResolutionSource = z.infer<typeof RelayResolutionSource>;
+//# sourceMappingURL=connector.d.ts.map

package/dist/schemas/connector.d.ts.map

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

package/dist/schemas/connector.js

@@ -0,0 +1,150 @@
+import { z } from 'zod';
+import { CompiledFlowId } from './ids.js';
+import { RelayRole } from './step.js';
+export const EnabledConnector = z.enum(['claude-code', 'codex', 'cursor-agent']);
+export const FilesystemCapability = z.enum(['read-only', 'trusted-write', 'isolated-write']);
+export const StructuredOutputCapability = z.enum(['json']);
+// Whether a connector can restrict a worker's tool surface to a declared
+// allow-list (the enforcement lever for equipment scope).
+//   "none"       — cannot restrict tools; an enforced equipment scope is
+//                  downgraded to trusted guidance against this connector.
+//   "allow-list" — can spawn the worker with exactly a named set of tools, so
+//                  an enforced equipment scope becomes a real boundary.
+export const ToolScopeCapability = z.enum(['none', 'allow-list']);
+export const ConnectorCapabilities = z
+    .object({
+    filesystem: FilesystemCapability,
+    structured_output: StructuredOutputCapability,
+    // Defaulted so a capability set serialized before this field existed (and a
+    // custom descriptor that omits it) parses as the safe "cannot restrict"
+    // value rather than failing.
+    tool_scope: ToolScopeCapability.default('none'),
+})
+    .strict();
+export const PromptTransport = z.enum(['prompt-file']);
+export const ConnectorOutputExtraction = z
+    .object({
+    kind: z.literal('output-file'),
+})
+    .strict();
+// Effort tuples are declared here as the single source of truth and
+// re-exported from the connector modules under their established names
+// (CLAUDE_CODE_SUPPORTED_EFFORTS, etc.). The `as const` preserves the literal
+// tuple type those modules rely on for their `asserts effort is ...` guards.
+export const CLAUDE_CODE_SUPPORTED_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
+export const CODEX_SUPPORTED_EFFORTS = ['low', 'medium', 'high', 'xhigh'];
+export const CURSOR_AGENT_SUPPORTED_EFFORTS = ['none'];
+export const BUILTIN_CONNECTOR_SPECS = {
+    'claude-code': {
+        provider: 'anthropic',
+        supportedEfforts: CLAUDE_CODE_SUPPORTED_EFFORTS,
+        // The CLI's `--tools` flag restricts the worker's tool surface, so an
+        // enforced equipment scope becomes a real boundary on this connector.
+        capabilities: {
+            filesystem: 'trusted-write',
+            structured_output: 'json',
+            tool_scope: 'allow-list',
+        },
+    },
+    codex: {
+        provider: 'openai',
+        supportedEfforts: CODEX_SUPPORTED_EFFORTS,
+        capabilities: { filesystem: 'trusted-write', structured_output: 'json', tool_scope: 'none' },
+    },
+    'cursor-agent': {
+        provider: 'gemini',
+        supportedEfforts: CURSOR_AGENT_SUPPORTED_EFFORTS,
+        capabilities: { filesystem: 'trusted-write', structured_output: 'json', tool_scope: 'none' },
+    },
+};
+// Derived capability view, preserved for callers that only need the
+// filesystem / structured-output capabilities. Single source of truth is
+// `BUILTIN_CONNECTOR_SPECS`; this projection cannot drift from it.
+export const BUILTIN_CONNECTOR_CAPABILITIES = Object.fromEntries(EnabledConnector.options.map((name) => [name, BUILTIN_CONNECTOR_SPECS[name].capabilities]));
+// connector-I2: the `'auto'` literal is a reserved sentinel for
+// `RelayConfig.default`; connector names must not collide with it.
+export const RESERVED_CONNECTOR_NAMES = [
+    ...EnabledConnector.options,
+    'auto',
+];
+export const ConnectorName = z.string().regex(/^[a-z][a-z0-9-]*$/);
+// connector-I3: element-level `.min(1)` forbids empty argv elements
+// (e.g. `['']` or `['codex', '']`) which either signal a bug or are a
+// silent gotcha — shells drop them; `execve(2)` does not.
+export const CustomConnectorDescriptor = z
+    .object({
+    kind: z.literal('custom'),
+    name: ConnectorName,
+    command: z.array(z.string().min(1)).min(1),
+    prompt_transport: PromptTransport,
+    output: ConnectorOutputExtraction,
+    capabilities: ConnectorCapabilities,
+})
+    .strict()
+    .superRefine((descriptor, ctx) => {
+    if (descriptor.capabilities.filesystem !== 'read-only') {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['capabilities', 'filesystem'],
+            message: 'custom connectors are read-only in V1; writable custom workers require a later isolated mode',
+        });
+    }
+    if (descriptor.capabilities.tool_scope !== 'none') {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['capabilities', 'tool_scope'],
+            message: 'custom connectors cannot enforce a tool allow-list in V1; declare tool_scope "none" (an enforced equipment scope is honored only by a built-in connector that can restrict tools)',
+        });
+    }
+});
+export const BuiltInConnectorRef = z
+    .object({
+    kind: z.literal('builtin'),
+    name: EnabledConnector,
+})
+    .strict();
+export const NamedConnectorRef = z
+    .object({
+    kind: z.literal('named'),
+    name: ConnectorName,
+})
+    .strict();
+export const ConnectorRef = z.union([
+    BuiltInConnectorRef,
+    NamedConnectorRef,
+    CustomConnectorDescriptor,
+]);
+// A resolved connector MUST NOT still be a named
+// reference. Named references are pre-resolution pointers at the registry;
+// the relayer must dereference them before emitting RelayStartedTraceEntry.
+// `ResolvedConnector` is the 2-variant discriminated union used at the trace_entry
+// layer; `ConnectorRef` remains the 3-variant pre-resolution union used in
+// config and CLI parsing.
+export const ResolvedConnector = z.union([BuiltInConnectorRef, CustomConnectorDescriptor]);
+// The tool-scope capability of a fully-resolved connector — the single lookup
+// the equipment-enforcement resolver needs. Built-ins read from the registry;
+// a custom descriptor carries its own (forced to 'none' in V1).
+export function connectorToolScopeCapability(connector) {
+    if (connector.kind === 'custom')
+        return connector.capabilities.tool_scope;
+    return BUILTIN_CONNECTOR_CAPABILITIES[connector.name].tool_scope;
+}
+// Relay resolution source carries a category plus a disambiguator. Same
+// shape as the applied[] entries on the selection side. An audit reading
+// `RelayStartedTraceEntry.resolved_from` can identify the exact config
+// entry that chose the connector, not just the category.
+const ExplicitResolutionSource = z.object({ source: z.literal('explicit') }).strict();
+const RoleResolutionSource = z.object({ source: z.literal('role'), role: RelayRole }).strict();
+const FlowResolutionSource = z
+    .object({ source: z.literal('flow'), flow_id: CompiledFlowId })
+    .strict();
+const DefaultResolutionSource = z.object({ source: z.literal('default') }).strict();
+const AutoResolutionSource = z.object({ source: z.literal('auto') }).strict();
+export const RelayResolutionSource = z.discriminatedUnion('source', [
+    ExplicitResolutionSource,
+    RoleResolutionSource,
+    FlowResolutionSource,
+    DefaultResolutionSource,
+    AutoResolutionSource,
+]);
+//# sourceMappingURL=connector.js.map

package/dist/schemas/connector.js.map

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