@bakers-build/conductor 0.0.0-stage → 0.1.0-next.42

package/dist/src/types.d.ts

@@ -0,0 +1,132 @@
+import type { AgentRoutes } from '@bakers-build/core';
+import type { DropSHPlugin } from 'dropsh/plugin';
+import type { ResolvedBbProjectContext } from './bakers-project-context.js';
+import type { BbProjectSelection } from './cli/project-context.js';
+import type { HookListener } from './plugins/executor.js';
+import type { LoadedInbox } from './plugins/message.js';
+import type { AgentCandidate, ExecutorPlugin, RemotePlugin, ResolvedAgent, WorkspacePlugin } from './plugins/plugins.js';
+import type { HerdrHost } from './plugins/process-host.js';
+import type { Ticket } from './plugins/remote.js';
+/** Normalized single conductor. */
+export interface ConductorSettings {
+    /** Default: `${project} @ ${checkoutRoot}`. */
+    label: string;
+    /**
+     * Stable conductor registration key (bb_conductor.conductor_id). Composed
+     * as `${user_id}-${host}-${project}` from the machine context. Set it to pin
+     * a conductor to a known identity — e.g. so a ticket can be pre-assigned to
+     * it (conductor assignment is the run-start trigger).
+     */
+    conductor_id?: string;
+    /**
+     * @deprecated BB-353 — alias for `conductor_id` during cutover.
+     */
+    machine_id?: string;
+    /** Project name (bb_project.name); resolved at registration. */
+    project: string;
+    /**
+     * Workflow states this conductor serves. An empty list means it serves every
+     * claimable state in its project; a non-empty list narrows it to those
+     * states (BB-207).
+     */
+    states: string[];
+    /**
+     * Agent prompt template - the bakers.build run contract, NOT project workflow. Bounds
+     * the agent to exactly one state and tells it to release + stop, keeping run
+     * mechanics out of the repo's WORKFLOW.md. Placeholders: `{identifier}`,
+     * `{state}`, `{runUuid}`. Defaults to `DEFAULT_AGENT_PROMPT`.
+     */
+    prompt: string;
+    /**
+     * Host concurrent-run budget. Sourced from machine context max_parallel
+     * (BB-353); engine-config leftovers are ignored with a warning.
+     */
+    max_parallel: number;
+    /**
+     * Machine preview-link policy. True when `machine.config.js` sets `tunnel: true`.
+     * Runtime-derived; ticket and project env cannot override it.
+     */
+    tunnel?: boolean;
+    /**
+     * Host identity stem (bb_machine.host_key). Sourced from
+     * MachineContext.machine_id — not derived by hyphen-splitting conductor_id
+     * (that mis-parses when project or host segments contain hyphens).
+     */
+    host_key?: string;
+    poll_interval_ms: number;
+    lease_seconds: number;
+    /**
+     * Whether to upload the agent transcript at finalize. Default true.
+     *
+     * Turning it off keeps this conductor's runs out of the log store entirely —
+     * for a machine whose transcripts are large, uninteresting, or subject to a
+     * local policy. Metrics are unaffected: the footprint is derived from the
+     * agent's own session files in this process, never from the uploaded log.
+     *
+     * Client-side by design. It lets an operator opt out; it is not a policy the
+     * server enforces, so a conductor running an older build still uploads.
+     */
+    capture_logs?: boolean;
+    /** Project shell commands, one per slot; run after the addon listeners. */
+    hooks?: {
+        after_create?: string;
+        before_run?: string;
+        after_run?: string;
+        after_done?: string;
+        /** Runs once in a ticket's worktree when a poll sees it frozen. */
+        on_freeze?: string;
+        /** Runs once in a ticket's worktree when a poll sees it unfrozen. */
+        on_resume?: string;
+    };
+    /** Control-plane site settings used for dropsh and agent env. */
+    site: {
+        base_url: string;
+        jsonapi_prefix: string;
+    };
+    /** Absolute path of the loaded config. */
+    config_path: string;
+}
+/** Whole conductor.config.js (dropsh-superset): site + named plugin slots. */
+export interface ConductorFileConfig extends ConductorSettings {
+    bakers: BbProjectSelection;
+    resolved_bakers?: ResolvedBbProjectContext;
+    remote: RemotePlugin;
+    executor: ExecutorPlugin;
+    /** Effective addon-derived catalog after machine overlays and filters. */
+    agents: AgentCandidate[];
+    enabled_agents: string[];
+    disabled_agents: string[];
+    default_agent: string;
+    routes: AgentRoutes;
+    /** Replaces the shipped label/default resolution for this project. */
+    selectAgent?: (candidates: ResolvedAgent[], ticket: Ticket) => ResolvedAgent;
+    workspace: WorkspacePlugin;
+    /**
+     * Addon lifecycle listeners from the conductor `addons[]` `hooks`
+     * accumulator (BB-599), validated at load. Kept apart from the shell
+     * `hooks` strings. Absent means none.
+     */
+    hookListeners?: HookListener[];
+    /**
+     * Addons with contract-2 inbox messages from the conductor `addons[]`,
+     * validated at load (BB-661). Absent means none.
+     */
+    inboxAddons?: LoadedInbox[];
+    /**
+     * Conductor process host from the `processHosts` accumulator (last wins).
+     * Absent when no addon contributed one — `bakers oven start` then fails
+     * with the existing no-herdr hint.
+     */
+    processHost?: HerdrHost;
+    /** dropsh-layer plugins (auth etc.); separate from the bakers.build slots. */
+    plugins?: DropSHPlugin[];
+}
+/**
+ * BB-201 split config model: the ENGINE half of a conductor config —
+ * everything a `conductor.config.js` carries EXCEPT the connection (`site`) and
+ * the auth `plugins`, which now live in a separate `bakers.config.js`
+ * (`BbConnectionConfig`). `loadConductorConfig` returns this; the conductor
+ * command composes it with the connection (`composeConductorConfig`) into the
+ * full `ConductorFileConfig` the engine consumes.
+ */
+export type ConductorEngineConfig = Omit<ConductorFileConfig, 'site' | 'plugins'>;

package/dist/src/types.js

@@ -0,0 +1,6 @@
+// BB-224 (Finding 6, decision 6): the conductor CONFIG CONTRACT lives here, in
+// `@bakers-build/conductor`, not in `@bakers-build/core`. It is typed BY the
+// conductor-surface plugin interfaces (`remote: RemotePlugin`, …), so it had to
+// move with them — otherwise the surface-agnostic kernel would have to edge the
+// engine, violating the acyclic rule "core has zero @bakers-build/* edges".
+export {};

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@bakers-build/conductor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.42",
+  "description": "bakers.build conductor engine + CLI: registers, claims tickets via JSON:API, dispatches agents.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./contract": "./dist/src/contract.js",
+    "./preset": "./dist/src/preset.js",
+    "./commands/conductor": "./dist/src/commands/conductor.js",
+    "./project-context": "./dist/src/cli/project-context.js",
+    "./package.json": "./package.json",
+    "./config": "./dist/src/cli/config-plan.js"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/bakers-build/bakers-build.git",
+    "directory": "bakers-cli/conductor"
+  },
+  "dependencies": {
+    "@dropsh/plugin-jsonapi-schema": "^0.7.1",
+    "@dropsh/plugin-oauth2": "^0.7.5",
+    "@bakers-build/core": "^0.1.0-next.42",
+    "@bakers-build/message": "^0.1.0-next.42",
+    "commander": "^12.1.0",
+    "dropsh": "^0.7.5"
+  }
+}