@skaile/workspaces 6.14.0 → 6.16.0

package/dist/bridge/src/preflight.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The one start check of every command that starts or configures a harness: `run` (also with
+ * `--dry-run`), `repl`, `serve`, `validate` and `config set harness|model`. It answers, without
+ * starting a harness or a model: would this harness start with this model and this agent?
+ *
+ * Each problem is one line plus a {@link HarnessErrorClass}, the same four classes a failed turn
+ * has (`driver-contract.ts`), so a refusal before the start and a failure after it read alike:
+ *
+ * - `crash`: the harness is not registered, its program or SDK is missing, an agent ref does not
+ *   resolve;
+ * - `model-refused`: the harness does not take the model (an unknown provider prefix, ADR 0014; a
+ *   provider surface it cannot speak; a model omp does not list; no model for omp to start on);
+ * - `auth`: codex has nothing to sign in with.
+ *
+ * A caller that must keep an older, narrower verdict (`validate` judges the harness name only,
+ * `config set model` the refusal only, `serve` is stricter for omp and does not look for the
+ * harness program) names the checks it wants in {@link PreflightOptions.checks}.
+ */
+import { type MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
+import type { HarnessErrorClass } from "./driver-contract.js";
+import { HARNESS_SDKS } from "./harness-detect.js";
+/** One thing that would stop the harness, in the class a host acts on and the line to print. */
+export interface PreflightProblem {
+    class: HarnessErrorClass;
+    line: string;
+}
+/** The project the harness would run in. */
+export interface PreflightProject {
+    projectDir: string;
+    /** The merged provider registry; default: the project's own files and the catalog. */
+    registry?: MergedAIProviderRegistry;
+    /** `@role` selectors resolve through this table. */
+    roles?: Record<string, string>;
+    /** Ids a session is narrowed to (`serve --providers`); the registry is narrowed the same way. */
+    providers?: readonly string[];
+}
+/** The agent definition and instances the project names, as the refs were typed. */
+export interface PreflightAgentRef {
+    /** `agent.definition`. */
+    definition?: string;
+    /** `agents.<id>.ref`, by instance id. */
+    instances?: Readonly<Record<string, string>>;
+}
+/**
+ * How an agent ref is resolved. The CLI owns the rule (`validate` and `serve` print its lines),
+ * so it passes it in; the bridge does not read the asset tree.
+ */
+export interface AgentRefLookups {
+    /** Why `agent.definition` does not resolve, or `null`. */
+    definition: (projectDir: string, definition: string) => string | null;
+    /** Why the `ref` of instance `id` does not resolve, or `null`. */
+    instance: (projectDir: string, id: string, ref: string) => string | null;
+}
+/**
+ * - `harness`: the harness is registered;
+ * - `start`: its program or SDK is found;
+ * - `refusal`: it takes the model's provider and id;
+ * - `readiness`: the rest of what the model needs (provider surface, credential, omp's own list);
+ * - `agent`: the agent refs resolve.
+ */
+export type PreflightCheck = "harness" | "start" | "refusal" | "readiness" | "agent";
+/** Replaceable lookups and switches. */
+export interface PreflightOptions {
+    /** Which checks to make; default: all. Problems come in the order of {@link PreflightCheck}. */
+    checks?: readonly PreflightCheck[];
+    /**
+     * Judge a server, not a run: only an explicit model is checked, omp must be known to take it
+     * now (a server answers its first prompt after it is ready), the provider surface and the
+     * codex credential are left to the first prompt, and the harness program is not looked for.
+     */
+    serve?: boolean;
+    /** Whether the harness's program is found. */
+    hasBinary?: (harnessId: string) => boolean;
+    /** The SDK probe; the line it returns, or `null`. */
+    sdkProblem?: (projectDir: string, harness: string) => Promise<string | null>;
+    /** Asks omp itself whether it lists a model (`omp models find`). */
+    ompListed?: (model: string) => Promise<string | undefined>;
+    /** The line codex gives when nothing is left to sign in with, or `undefined`. */
+    codexCredential?: (input: {
+        projectDir: string;
+        harness: string;
+        model?: string;
+        registry: MergedAIProviderRegistry;
+        roles?: Record<string, string>;
+    }) => string | undefined;
+    /**
+     * Whether omp has a model to start on when none is selected and no registry entry serves one
+     * (`true`), or none (`false`), or cannot say (`undefined`). Asked only when given: it costs a
+     * program start.
+     */
+    ompHasModel?: () => Promise<boolean | undefined>;
+    /** Required when an agent ref is given. */
+    agentRefs?: AgentRefLookups;
+}
+/**
+ * The one-line problem when the harness cannot load its SDK, or `null`. The probe is the same
+ * lookup the harness runs in `start()` (the project's `node_modules`, then next to skaile), so a
+ * compiled binary that bundles the SDK passes. A harness with no SDK passes.
+ */
+export declare function harnessSdkProblem(projectDir: string, harness: string, probe?: typeof HARNESS_SDKS): Promise<string | null>;
+/**
+ * Everything that would stop the harness from starting this run, one problem each, empty when it
+ * can start. A harness this has no check for (`echo`, a plugin's) has none beyond being
+ * registered. Starts no harness and no model; the SDK probe loads the SDK the way the harness
+ * does.
+ *
+ * @param project - The project, its registry, roles and provider narrowing.
+ * @param harness - The resolved harness id.
+ * @param model - The model as typed (`--model`, `skaile.yaml`, settings); none to leave it out.
+ * @param agentRef - The agent refs to resolve; none to leave them out.
+ * @param options - Which checks, and replaceable lookups for tests.
+ */
+export declare function preflight(project: PreflightProject, harness: string, model: string | undefined, agentRef?: PreflightAgentRef, options?: PreflightOptions): Promise<PreflightProblem[]>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/bridge/src/preflight.d.ts.map

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

package/dist/bridge/src/registry.d.ts

@@ -19,9 +19,21 @@ import type { AgentConfig, AgentHarness, HarnessInfo } from "./types.js";
  * once. The platform's resolver filters candidate entries on `surfaces`
  * instead of matching vendor names.
  *
+ * `stability` is `experimental` for the harnesses the release tests only smoke-check
+ * (`run --dry-run`): qwen, opencode, goose and continue.
+ *
  * @docLink packages/bridge/api-reference#registry
  */
 export declare const BUILTIN_HARNESS_CATALOG: Record<string, HarnessInfo>;
+/**
+ * The `harnessInfo` a built-in harness instance reports: its {@link BUILTIN_HARNESS_CATALOG} row
+ * without the provider-registry declaration (`surfaces`, `providerPlurality`), which the
+ * platform reads from {@link listHarnesses} and not from an instance. One lookup for every
+ * instance, so an instance cannot differ from the catalog.
+ *
+ * @param id - A key of {@link BUILTIN_HARNESS_CATALOG}.
+ */
+export declare function harnessInfoFor(id: string): HarnessInfo;
 /**
  * Register every built-in harness's `HarnessTarget` into the plugin registry.
  *

package/dist/bridge/src/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../bridge/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE1F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4BzE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA+F/D,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,GAAE,cAA+B,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,YAAY,CAAC,CAGvB;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CA0B7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB,EACvD,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../bridge/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE1F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4BzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAwG/D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAOtD;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,GAAE,cAA+B,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,YAAY,CAAC,CAGvB;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CA0B7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB,EACvD,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB"}