@skaile/workspaces 3.27.1 → 4.1.0

package/dist/types/src/lifecycle.d.ts

@@ -15,6 +15,7 @@
  * @category Lifecycle
  * @since 3.0.0
  */
+import type { AIProviderRegistry, MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
 import type { Capability } from "./capabilities.js";
 import type { LogStoreConfig } from "./logging.js";
 import type { ResourceDeclaration } from "./protocol.js";
@@ -139,24 +140,48 @@ export type CredentialRejection = "auth" | "usage-limit";
  * the same values it bakes into the generated skaile.yaml `agent-config.default`
  * (driver already precedence-resolved, model already alias-translated).
  *
+ * The provider axis is the **AI provider registry**
+ * (`@skaile/workspaces/core/provider-registry`): `registry` carries every
+ * endpoint the session may address, already merged by the control plane, and
+ * `modelRef` selects one. Per-entry `credential.ref` values of the form
+ * `platform:<configId>` resolve against the sibling `secrets` map, which the
+ * platform keys by the bare config id.
+ *
+ * The pre-4.0.0 `provider` / `cloud` / `cloudConfig` triple is gone. A
+ * `session_init` that still sends one is **rejected** with an error naming
+ * the replacement — never silently ignored, because running the session
+ * against a different endpoint than the control plane resolved is worse than
+ * failing.
+ *
  * @category Lifecycle
  * @since 3.6.0
  */
 export type ResolvedAgentConfig = {
     driver?: string;
-    provider?: string;
     /** Explicit managed OpenAI billing mode; never inferred from available credentials. */
     authMode?: "subscription" | "api-key";
     model?: string;
-    /** AI cloud transport (`default | bedrock | vertex | azure | gateway`). */
-    cloud?: string;
-    /** Non-secret cloud transport settings (camelCase wire shape). */
-    cloudConfig?: {
-        region?: string;
-        projectId?: string;
-        resource?: string;
-        baseUrl?: string;
-    };
+    /**
+     * The merged AI provider registry for this session. Either the bare
+     * `id → entry` map or the {@link MergedAIProviderRegistry} view carrying
+     * registry order and merge provenance; the runner normalizes whichever
+     * arrives into the merged view before handing it to a driver.
+     *
+     * Never carries a literal secret: each entry names its credential through a
+     * `credential.ref` (`platform:<configId>` for control-plane-injected values,
+     * `env:NAME` otherwise).
+     *
+     * @since 4.0.0
+     */
+    registry?: AIProviderRegistry | MergedAIProviderRegistry;
+    /**
+     * Model selector resolved against {@link ResolvedAgentConfig.registry}:
+     * `"<providerId>/<modelId>"`, a bare `"<modelId>"` (first registry entry
+     * that maps it wins), or `"@role"`.
+     *
+     * @since 4.0.0
+     */
+    modelRef?: string;
     thinking?: "adaptive" | "enabled" | "disabled";
     effort?: "low" | "medium" | "high" | "max" | (string & {});
 };

package/dist/types/src/lifecycle.d.ts.map

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

package/dist/types/src/manifests/agent.d.ts

@@ -71,24 +71,112 @@ export declare const BEDROCK_MODEL_ID_PATTERN: RegExp;
  */
 export declare const VERTEX_MODEL_ID_PATTERN: RegExp;
 /**
- * Zod schema accepting a Claude Code alias, a full Anthropic ID, a Bedrock-form
- * ID (see {@link BEDROCK_MODEL_ID_PATTERN}), or a Vertex `@date`-pinned ID
- * (see {@link VERTEX_MODEL_ID_PATTERN}).
+ * Zod schema for a **first-party Anthropic** model identifier: a Claude Code
+ * alias, a full Anthropic ID, a Bedrock-form ID (see
+ * {@link BEDROCK_MODEL_ID_PATTERN}), or a Vertex `@date`-pinned ID (see
+ * {@link VERTEX_MODEL_ID_PATTERN}).
  *
- * Anything else fails validation. Use {@link normalizeAnthropicModel} to coerce
- * unrecognized values to a safe alias instead of failing, and
- * {@link modelIdSchemaForCloud} for free-form IDs under `cloud: gateway`.
+ * This is **not** a universal model-id rule. It is the vocabulary of exactly
+ * one wire target — `surface: anthropic-messages` on `transport: direct`
+ * pointed at Anthropic's own host — because that is the only endpoint whose
+ * model namespace this package knows. Every other endpoint names models it
+ * cannot enumerate (a Bedrock ARN, an Azure deployment name,
+ * `accounts/fireworks/models/…`, `meta-llama/Llama-3.3-70B`, an Ollama tag),
+ * and applying this schema there rejected working configurations. Pick between
+ * the two vocabularies with {@link modelIdSchemaForTarget}.
+ *
+ * Use {@link normalizeAnthropicModel} to coerce an unrecognized value to a safe
+ * alias instead of failing.
  */
 export declare const ModelIdSchema: z.ZodUnion<readonly [z.ZodEnum<{
     inherit: "inherit";
+    haiku: "haiku";
     opus: "opus";
     sonnet: "sonnet";
-    haiku: "haiku";
 }>, z.ZodString, z.ZodString, z.ZodString]>;
 /**
- * Contextual model-ID schema: `cloud: gateway` routes through an arbitrary
- * proxy whose model namespace we cannot know, so any non-empty string is
- * accepted there; every other cloud (or none) uses {@link ModelIdSchema}.
+ * Hosts that serve the first-party Anthropic Messages API. An
+ * `anthropic-messages` entry pointed anywhere else — a gateway, LiteLLM, an
+ * Azure AI Foundry deployment — speaks the same wire protocol over its own
+ * model namespace.
+ *
+ * @since 3.21.0
+ */
+export declare const ANTHROPIC_FIRST_PARTY_HOSTS: readonly string[];
+/**
+ * The slice of a provider-registry `llm` entry that decides which model-id
+ * vocabulary applies.
+ *
+ * Structurally a subset of `AIProviderLlmEntry`
+ * (`@skaile/workspaces/core/provider-registry`), so a registry entry can be
+ * passed straight in. The fields are plain strings because this module sits
+ * *below* the registry in the dependency graph and must not import it; the
+ * enums live in exactly one place, and this is not it.
+ *
+ * @since 3.21.0
+ */
+export interface ModelIdTarget {
+    /** omp `api` value — `anthropic-messages`, `openai-completions`, … */
+    surface?: string;
+    /** `direct` when absent. */
+    transport?: string;
+    /** Resolved endpoint: `resolveEntryBaseUrl(entry)`, or the preset literal. */
+    base_url?: string;
+}
+/**
+ * True when `baseUrl` is the first-party Anthropic API.
+ *
+ * An absent URL counts: an `anthropic-messages` entry with no endpoint of its
+ * own is the first-party API (the catalog layer fills in
+ * `https://api.anthropic.com` during the merge). A URL that will not parse is
+ * treated as *not* first-party — guessing the other way would reject ids that
+ * whatever is at the other end serves.
+ *
+ * @since 3.21.0
+ */
+export declare function isFirstPartyAnthropicEndpoint(baseUrl?: string): boolean;
+/**
+ * Whether `target` demands an Anthropic-shaped model id.
+ *
+ * Exactly one combination does: the Anthropic Messages wire, spoken directly,
+ * to Anthropic's own host. Every gateway transport (`bedrock`, `vertex`,
+ * `foundry`, `azure-openai`) addresses the same models under a renamed
+ * namespace — an inference-profile ARN, a publisher path, a deployment name —
+ * and an `anthropic-messages` proxy owns its namespace outright.
+ *
+ * An absent `target` is the pre-registry default: first-party Anthropic is what
+ * the Claude drivers talk to when nothing says otherwise, so the strict
+ * vocabulary still applies there and nothing that validates today stops
+ * validating.
+ *
+ * @since 3.21.0
+ */
+export declare function requiresAnthropicModelId(target?: ModelIdTarget): boolean;
+/**
+ * Any non-empty, whitespace-free model id — the vocabulary of every endpoint
+ * whose model namespace belongs to the operator rather than to us.
+ *
+ * @since 3.21.0
+ */
+export declare const FreeFormModelIdSchema: z.ZodString;
+/**
+ * The model-id schema a given wire target enforces: {@link ModelIdSchema} for
+ * first-party Anthropic, {@link FreeFormModelIdSchema} everywhere else.
+ *
+ * @since 3.21.0
+ */
+export declare function modelIdSchemaForTarget(target?: ModelIdTarget): z.ZodType<string>;
+/**
+ * Contextual model-ID schema for the legacy `cloud` dimension.
+ *
+ * `default` (or absent) is the first-party Anthropic API, so the strict
+ * vocabulary applies. Every other value either renames the namespace
+ * (`bedrock` ARNs, `vertex` publisher paths, `azure` deployments) or is an
+ * unknowable proxy (`gateway`) — all free-form, the same answer
+ * {@link modelIdSchemaForTarget} gives for the equivalent registry entry.
+ *
+ * Superseded by {@link modelIdSchemaForTarget}; it goes when the rest of the
+ * `cloud` surface does.
  *
  * @since 1.3.0
  */
@@ -108,6 +196,22 @@ export declare function modelIdSchemaForCloud(cloud?: string): z.ZodType<string>
  * fallback so a valid Bedrock/Vertex ID is never downgraded to an alias.
  */
 export declare function normalizeAnthropicModel(input: string | undefined | null, fallback?: AnthropicModelAlias): string;
+/**
+ * A model *selector* as a manifest writes it: `@role`,
+ * `<providerId>/<modelId>`, a bare provider-side id, or an Anthropic alias.
+ * Resolved against the provider registry — and only then checked against the
+ * selected entry's own vocabulary — by `resolveManifestModel`
+ * (`@skaile/workspaces/bridge`).
+ *
+ * Structural on purpose. An agent manifest is portable across providers: it
+ * cannot know which registry entry will serve it, so an id-vocabulary check
+ * here would enforce one endpoint's namespace on every other one. That check
+ * belongs to {@link modelIdSchemaForTarget}, at the point where the endpoint is
+ * known.
+ *
+ * @since 3.21.0
+ */
+export declare const ModelSelectorSchema: z.ZodString;
 export declare const BindingValues: readonly ["discoverable", "inline-live", "inline-snapshot"];
 export declare const BindingSchema: z.ZodEnum<{
     discoverable: "discoverable";
@@ -167,18 +271,8 @@ export declare const AgentManifestSchema: z.ZodObject<{
     description: z.ZodString;
     extends: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodObject<{
-        preferred: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-            inherit: "inherit";
-            opus: "opus";
-            sonnet: "sonnet";
-            haiku: "haiku";
-        }>, z.ZodString, z.ZodString, z.ZodString]>>;
-        fallback: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
-            inherit: "inherit";
-            opus: "opus";
-            sonnet: "sonnet";
-            haiku: "haiku";
-        }>, z.ZodString, z.ZodString, z.ZodString]>>>;
+        preferred: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodArray<z.ZodString>>;
         constraints: z.ZodOptional<z.ZodObject<{
             temperature: z.ZodOptional<z.ZodNumber>;
             max_tokens: z.ZodOptional<z.ZodNumber>;

package/dist/types/src/manifests/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../types/src/manifests/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,KAAK,wBAAwB,EAAoB,MAAM,cAAc,CAAC;AAM/E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,iDAAkD,CAAC;AACvF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,+CAAgD,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAsB7E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,QAAuD,CAAC;AAE5F;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;2CAUxB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAEvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,QAAQ,GAAE,mBAA8B,GACvC,MAAM,CAWR;AAiBD,eAAO,MAAM,aAAa,6DAA8D,CAAC;AACzF,eAAO,MAAM,aAAa;;;;EAAwB,CAAC;AACnD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAEpF"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../types/src/manifests/agent.ts"],"names":[],"mappings":"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"}

package/dist/types/src/manifests/index.d.ts

@@ -8,8 +8,8 @@
  */
 export type { AssetKind, ManifestValidationFailure, ManifestValidationResult, ManifestValidationSuccess, } from "./_shared.js";
 export { ArtifactRefSchema, AssetKindSchema, AssetKindValues, BaseFrontmatterSchema, CommonMetadataSchema, FieldSchema, FilePrerequisiteSchema, UserInputSchema, validateManifest, } from "./_shared.js";
-export type { AgentComposeItem, AgentManifest, AgentTools, AnthropicModelAlias, AnthropicModelFamily, Binding, } from "./agent.js";
-export { AgentComposeItemSchema, AgentManifestSchema, AgentToolsSchema, ANTHROPIC_FULL_ID_PATTERN, ANTHROPIC_MODEL_ALIASES, ANTHROPIC_MODEL_FAMILIES, BEDROCK_MODEL_ID_PATTERN, BindingSchema, BindingValues, ModelIdSchema, modelIdSchemaForCloud, normalizeAnthropicModel, validateAgent, VERTEX_MODEL_ID_PATTERN, } from "./agent.js";
+export type { AgentComposeItem, AgentManifest, AgentTools, AnthropicModelAlias, AnthropicModelFamily, Binding, ModelIdTarget, } from "./agent.js";
+export { AgentComposeItemSchema, AgentManifestSchema, AgentToolsSchema, ANTHROPIC_FIRST_PARTY_HOSTS, ANTHROPIC_FULL_ID_PATTERN, ANTHROPIC_MODEL_ALIASES, ANTHROPIC_MODEL_FAMILIES, BEDROCK_MODEL_ID_PATTERN, BindingSchema, BindingValues, FreeFormModelIdSchema, isFirstPartyAnthropicEndpoint, ModelIdSchema, modelIdSchemaForCloud, modelIdSchemaForTarget, ModelSelectorSchema, normalizeAnthropicModel, requiresAnthropicModelId, validateAgent, VERTEX_MODEL_ID_PATTERN, } from "./agent.js";
 export type { ConnectorManifest } from "./connector.js";
 export { ConnectorManifestSchema, validateConnector } from "./connector.js";
 export type { MountManifest } from "./mount.js";

package/dist/types/src/manifests/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../types/src/manifests/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,SAAS,EACT,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKnE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMtE,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AA+BxE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAMhG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../types/src/manifests/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,SAAS,EACT,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKnE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMtE,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AA+BxE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAMhG"}

package/dist/types/src/manifests/preset.d.ts

@@ -13,11 +13,11 @@ import { type ManifestValidationResult } from "./_shared.js";
 export declare const PlaceholderTypeSchema: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
+    oauth: "oauth";
     text: "text";
     enum: "enum";
     multiline: "multiline";
     secret: "secret";
-    oauth: "oauth";
     "instance-picker": "instance-picker";
 }>;
 export declare const PlaceholderSchema: z.ZodObject<{
@@ -26,11 +26,11 @@ export declare const PlaceholderSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<{
         number: "number";
         boolean: "boolean";
+        oauth: "oauth";
         text: "text";
         enum: "enum";
         multiline: "multiline";
         secret: "secret";
-        oauth: "oauth";
         "instance-picker": "instance-picker";
     }>>;
     required: z.ZodOptional<z.ZodBoolean>;
@@ -47,11 +47,11 @@ export declare const PresetItemSchema: z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<{
             number: "number";
             boolean: "boolean";
+            oauth: "oauth";
             text: "text";
             enum: "enum";
             multiline: "multiline";
             secret: "secret";
-            oauth: "oauth";
             "instance-picker": "instance-picker";
         }>>;
         required: z.ZodOptional<z.ZodBoolean>;
@@ -88,11 +88,11 @@ export declare const PresetManifestSchema: z.ZodObject<{
             type: z.ZodOptional<z.ZodEnum<{
                 number: "number";
                 boolean: "boolean";
+                oauth: "oauth";
                 text: "text";
                 enum: "enum";
                 multiline: "multiline";
                 secret: "secret";
-                oauth: "oauth";
                 "instance-picker": "instance-picker";
             }>>;
             required: z.ZodOptional<z.ZodBoolean>;
@@ -111,11 +111,11 @@ export declare const PresetManifestSchema: z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<{
             number: "number";
             boolean: "boolean";
+            oauth: "oauth";
             text: "text";
             enum: "enum";
             multiline: "multiline";
             secret: "secret";
-            oauth: "oauth";
             "instance-picker": "instance-picker";
         }>>;
         prompt: z.ZodOptional<z.ZodString>;

package/dist/types/src/runtime.d.ts

@@ -5,27 +5,41 @@
  * implement IAgentRuntime, allowing consumers to drive agents through
  * the same API regardless of where the agent runs.
  */
+import type { AIProviderRegistry, AIProviderSurface, MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
 import type { AgentEvent } from "./events.js";
 /**
  * Initial configuration passed to `IAgentRuntime.start()`.
  *
- * Sets the working directory, model, system prompt, API keys, environment variables,
- * and initial subagent definitions for the agent session.
+ * Sets the working directory, model, system prompt, environment variables,
+ * AI provider registry and initial subagent definitions for the agent session.
  *
  * @docLink packages/types/runtime#agent-runtime-config
  */
 export type AgentRuntimeConfig = {
     cwd: string;
-    provider?: string;
     model?: string;
     maxTurns?: number;
     systemPrompt?: string;
-    apiKeys?: Record<string, string>;
+    /**
+     * Extra child-process environment. Credentials reach a driver here, under
+     * the `SKAILE_AIP_<ID>_KEY` name each registry entry references.
+     */
     env?: Record<string, string>;
     agentDir?: string;
     sessionId?: string;
     resumeSessionId?: string;
     subagents?: Record<string, SubagentDefinition>;
+    /**
+     * The AI provider registry this runtime dispatches against — the only
+     * provider surface. Omit it and the driver runs on whatever native auth it
+     * can discover on its own.
+     */
+    registry?: AIProviderRegistry | MergedAIProviderRegistry;
+    /**
+     * Model selector resolved against {@link AgentRuntimeConfig.registry}:
+     * `"<providerId>/<modelId>"`, a bare `"<modelId>"`, or `"@role"`.
+     */
+    modelRef?: string;
 };
 /**
  * Definition for a named subagent that the primary agent can dispatch.
@@ -208,14 +222,46 @@ export interface IAgentRuntime {
     readonly isRunning: boolean;
 }
 /**
- * Metadata about an agent driver backend, returned by bridge driver introspection.
+ * How many AI provider registry entries a backend can actually use at once
+ * (plan §2.3).
+ *
+ * - `registry` — every entry is selectable, so roles, fallback chains and
+ *   per-subagent models all work (`omp`).
+ * - `credentials-n` — every credential is delivered, but one model is active
+ *   at a time (`opencode`, `goose`, `continue`).
+ * - `single` — exactly one entry resolves; a second one is a configuration
+ *   error rather than a fallback (`claude-sdk`, `codex`, `gemini`, `qwen`).
+ */
+export type DriverProviderPlurality = "registry" | "credentials-n" | "single";
+/**
+ * Static metadata about an agent driver backend, returned by bridge driver
+ * introspection (`listDrivers`) and exposed on every driver instance via
+ * `driverInfo`.
  *
  * @docLink packages/types/runtime#driver-info
  */
 export type DriverInfo = {
+    /** Stable machine identifier used to look up the driver in the registry (e.g. `"omp"`, `"claude-sdk"`). */
     id: string;
+    /** Human-readable display name shown in UIs and logs. */
     name: string;
+    /** `true` when the driver can target any LLM provider; `false` for Anthropic-only drivers. */
     modelAgnostic: boolean;
+    /**
+     * `true` when the driver supports mid-stream abort via `abort()` without killing the process.
+     * Drivers that return `false` can only be stopped via `kill()`.
+     */
     supportsInBandAbort: boolean;
+    /**
+     * Wire protocols this backend can speak. A registry entry whose `surface` is
+     * absent from this list cannot be dispatched to by this driver — that is the
+     * filter the platform's resolver applies instead of matching vendor names.
+     *
+     * Optional so a third-party `DriverTarget` that declares nothing still
+     * produces a valid row; every built-in in `BUILTIN_DRIVER_CATALOG` sets it.
+     */
+    surfaces?: readonly AIProviderSurface[];
+    /** How many registry entries this backend can use at once. */
+    providerPlurality?: DriverProviderPlurality;
 };
 //# sourceMappingURL=runtime.d.ts.map

package/dist/types/src/runtime.d.ts.map

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

package/dist/types/src/version.d.ts

@@ -48,6 +48,22 @@ export type ProtocolVersion = {
  * @category Protocol
  * @since 3.0.0
  *
+ * Changed in 4.0.0 (breaking):
+ * The AI provider registry is the only provider surface on the wire.
+ * `ResolvedAgentConfig` **loses** `provider`, `cloud` and `cloudConfig`; what
+ * remains is `registry?` (the merged AI provider registry — `id → entry`, or
+ * the merged view with registry order and merge provenance) and `modelRef?`
+ * (`"<providerId>/<modelId>"`, a bare model id, or `"@role"`). Registry
+ * entries never carry a literal secret: a control-plane-injected credential
+ * is named by a `credential.ref` of the form `platform:<configId>` and
+ * resolved against the sibling `secrets` map, which the platform keys by the
+ * bare config id. A `session_init` whose `resolvedConfig.agentConfig` still
+ * carries one of the removed fields is **rejected** with a fatal `error`
+ * naming the replacement — silently ignoring them would run the session
+ * against a different endpoint than the control plane resolved. Peers
+ * negotiate on `major`, so a 3.x platform and a 4.x runner refuse each other
+ * at boot rather than degrading.
+ *
  * Changed in 3.15.0:
  * Classifier nodes. A new runtime-audience capability, `host.classify`
  * (`HostClassifyInput` → `HostClassifyResult`), which the runner invokes for a
@@ -150,7 +166,7 @@ export type ProtocolVersion = {
  * Changed in 3.6.0:
  * Additive resolved-agent-config wire field. `ResolvedSkaileConfig` gains an
  * optional `agentConfig?: ResolvedAgentConfig` carrying the platform-resolved
- * driver / provider / model / cloud / cloudConfig / thinking / effort — the
+ * driver / model / registry / modelRef / thinking / effort — the
  * same values the platform bakes into the generated skaile.yaml
  * `agent-config.default`. The runner applies it disk-first: any on-disk
  * `agent-config` profile with at least one agent setting disables the wire
@@ -245,7 +261,7 @@ export declare const PROTOCOL_VERSION: ProtocolVersion;
  * @since 3.0.0
  * @docLink packages/types/protocol-v3#protocol-version
  */
-export declare const PROTOCOL_VERSION_STRING = "3.15.0";
+export declare const PROTOCOL_VERSION_STRING = "4.0.0";
 /**
  * Parse a `"major.minor.patch"` string into a {@link ProtocolVersion}.
  *

package/dist/types/src/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../types/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2MG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAmD,CAAC;AAEnF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAoBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAExD"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../types/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2NG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAkD,CAAC;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAoBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAExD"}

package/dist/validator-P5ESKTW5.js

@@ -0,0 +1,5 @@
+export { workspaceInfo, workspaceReload, workspaceTestSecret, workspaceValidate } from './chunk-JXCUUZA3.js';
+import './chunk-X5YPJV4N.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=validator-P5ESKTW5.js.map
+//# sourceMappingURL=validator-P5ESKTW5.js.map

package/dist/{validator-RN64BKFW.js.map → validator-P5ESKTW5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"validator-RN64BKFW.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validator-P5ESKTW5.js"}

package/dist/workspace-plugin/adapters/mcp.js

@@ -1,25 +1,27 @@
-export { buildWorkspaceMcpServer, buildWorkspaceMcpStdioServer, buildWorkspaceToolDefs, runMcpServerStdio } from '../../chunk-FFE7YLYO.js';
-import '../../chunk-E7HKNQTH.js';
-import '../../chunk-FUCYTGAE.js';
-import '../../chunk-773WLEXL.js';
-import '../../chunk-R6O6YWU7.js';
+export { buildWorkspaceMcpServer, buildWorkspaceMcpStdioServer, buildWorkspaceToolDefs, runMcpServerStdio } from '../../chunk-AN7E2IL5.js';
+import '../../chunk-MVBK4JUK.js';
 import '../../chunk-FAI2SMFE.js';
 import '../../chunk-7IRJ4K4F.js';
+import '../../chunk-JXCUUZA3.js';
+import '../../chunk-FUCYTGAE.js';
+import '../../chunk-R6O6YWU7.js';
 import '../../chunk-X5YPJV4N.js';
 import '../../chunk-3XXQPHGL.js';
 import '../../chunk-7BUZQVRR.js';
-import '../../chunk-72DG6GSB.js';
-import '../../chunk-HSRHO7SK.js';
+import '../../chunk-YS4XBN7O.js';
+import '../../chunk-3VSRJE3M.js';
+import '../../chunk-REILIKVM.js';
 import '../../chunk-F3HNW354.js';
 import '../../chunk-K5GBV4SA.js';
 import '../../chunk-QVZA2MDT.js';
-import '../../chunk-IB4XKQMQ.js';
-import '../../chunk-MBARHWMZ.js';
+import '../../chunk-K27T47OO.js';
 import '../../chunk-MENCWIHW.js';
 import '../../chunk-P4VHQA4N.js';
 import '../../chunk-MKZOK4JU.js';
 import '../../chunk-GEEW6SY2.js';
 import '../../chunk-FTG7CRFD.js';
+import '../../chunk-KSIRR5PL.js';
+import '../../chunk-ILG4BXYE.js';
 import '../../chunk-W4IPN3DD.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=mcp.js.map