@plurnk/plurnk-aliases 1.6.1 → 1.8.0

package/README.md

@@ -1,14 +1,15 @@
 # @plurnk/plurnk-aliases
 
-Zero-dependency parser for the plurnk model-alias cascade. Vendor-agnostic, MIT.
+Runtime-free parser for Plurnk model selectors and the optional alias cascade.
+Vendor-agnostic, MIT.
 
 Resolves `PLURNK_MODEL_<alias>=<provider>/<model>` env vars (plus per-alias
 `PLURNK_BASEURL_<alias>` endpoint overrides) into structured `ProviderAlias`
-records. Extracted from `@plurnk/plurnk-providers` so a **thin client** can
-resolve aliases from its own always-fresh env — and send the daemon a resolved
-`{ provider, model, baseUrl? }` — without pulling the provider-instantiation or
-tokenizer machinery. `@plurnk/plurnk-providers` depends on this and re-exports
-the same surface, so it stays the single source of truth.
+records. `PLURNK_MODEL` may select one of those aliases or an exact
+`provider/model` route. `@plurnk/plurnk-providers` depends on this package and
+re-exports the same surface, keeping environment parsing separate from provider
+construction. Clients send selector strings; the daemon resolves them against
+its own operator environment.
 
 ## Install
 
@@ -21,10 +22,11 @@ Node ≥26, ESM.
 ## API
 
 ```ts
-import { parseAliasesFromEnv, resolveActiveAlias, type ProviderAlias } from "@plurnk/plurnk-aliases";
+import { parseAliasesFromEnv, resolveActiveRoute, resolveModelSelector, type ProviderAlias, type ProviderSpec } from "@plurnk/plurnk-aliases";
 
 parseAliasesFromEnv(env = process.env): ProviderAlias[]   // every declared alias
-resolveActiveAlias(env = process.env): ProviderAlias | null // the PLURNK_MODEL-selected one, or null
+resolveModelSelector(selector, aliases): ProviderSpec | null // alias or exact route
+resolveActiveRoute(env = process.env): ProviderSpec | null  // the PLURNK_MODEL-selected route, or null
 ```
 
 ```ts
@@ -36,10 +38,10 @@ interface ProviderAlias {
 }
 ```
 
-To resolve a named alias (e.g. from `loop.run({ alias })`), parse and find:
+To resolve a selector from a client control:
 
 ```ts
-const alias = parseAliasesFromEnv().find((a) => a.alias === name.toLowerCase());
+const route = resolveModelSelector(selector, parseAliasesFromEnv());
 ```
 
 ## Contract
@@ -47,4 +49,5 @@ const alias = parseAliasesFromEnv().find((a) => a.alias === name.toLowerCase());
 The provider segment is the **first** `/`-delimited field; the model id is the
 remainder (it may itself contain `/`). Aliases are case-folded. Fail-hard on a
 case-folding collision (two keys → one alias) and on a `PLURNK_BASEURL_*`
-override with no matching alias (a typo, never a silent no-op). See `SPEC.md`.
+override with no matching alias (a typo, never a silent no-op). Exact routes do
+not manufacture aliases or gain alias-scoped tuning. See `SPEC.md`.

package/SPEC.md

@@ -1,18 +1,22 @@
 # @plurnk/plurnk-aliases — contract
 
-The canonical parser for the plurnk model-alias cascade. Zero runtime
+The canonical runtime-free parser for Plurnk model selectors and the optional
+model-alias cascade. Zero runtime
 dependencies. `@plurnk/plurnk-providers` depends on this package and re-exports
-its surface unchanged; thin clients depend on it directly to resolve aliases
-without the provider/tokenizer machinery.
+its surface unchanged. Clients transmit selector strings and never resolve the
+daemon's environment themselves; this package is the daemon/provider runtime's
+single parsing authority.
 
 ## The cascade
 
 - **`PLURNK_MODEL_<alias>=<provider>/<model>`** declares an alias. The provider
   segment is the **first** `/`-delimited field; the model id is everything after
   that first `/` (it MAY contain further `/`, e.g. `openrouter/anthropic/claude-…`).
-- **`PLURNK_MODEL=<alias>`** selects the active alias at boot.
-- §alias-child-selector-reserved **`PLURNK_MODEL_CHILD=<alias>` is reserved as
-  the child-provider selector** and is never parsed as an alias declaration.
+- **`PLURNK_MODEL=<selector>`** selects either a declared alias or an exact
+  `<provider>/<model>` route at boot.
+- §alias-child-selector-reserved **`PLURNK_MODEL_CHILD=<selector>` is reserved as
+  the child-provider selector** and is never parsed as an alias declaration. It
+  accepts the same alias-or-route vocabulary.
 - **`PLURNK_BASEURL_<alias>`** attaches a per-alias endpoint override — the one
   thing a per-provider base-URL var can't express (two aliases on the same
   provider name pointing at different self-hosted boxes).
@@ -20,24 +24,34 @@ without the provider/tokenizer machinery.
 Alias keys are **case-folded** (the suffix after `PLURNK_MODEL_` / `PLURNK_BASEURL_`
 is downcased), so `PLURNK_MODEL_opus` and `PLURNK_MODEL_OPUS` name the same alias.
 
-## `ProviderAlias`
+## Route types
 
 ```ts
-interface ProviderAlias {
-    readonly alias: string;
+interface ProviderSpec {
     readonly provider: string;
     readonly model: string;
-    readonly baseUrl?: string;  // present only when PLURNK_BASEURL_<alias> is set
+    readonly alias?: string;
+    readonly baseUrl?: string;
 }
+
+type ProviderAlias = ProviderSpec & { readonly alias: string };
 ```
 
+This daemon-private construction shape is distinct from the client-visible
+`ModelRoute`, which contains only `provider`, `model`, and optional alias
+provenance. An exact provider spec omits `alias` and `baseUrl`. A declared alias
+carries both its provenance and any `PLURNK_BASEURL_<alias>` override;
+alias-scoped tuning applies only when that real alias is present.
+
 ## Functions
 
 - **`parseAliasesFromEnv(env = process.env): ProviderAlias[]`** — every declared
   alias. Skips entries with an empty value or no `/` in the value.
-- **`resolveActiveAlias(env = process.env): ProviderAlias | null`** — the alias
-  named by `PLURNK_MODEL` (case-insensitive), or `null` when `PLURNK_MODEL` is
-  unset or names no declared alias.
+- **`resolveModelSelector(selector, aliases): ProviderSpec | null`** — resolves a
+  case-insensitive declared alias or splits one exact route at its first `/`.
+- **`resolveActiveRoute(env = process.env): ProviderSpec | null`** — resolves
+  `PLURNK_MODEL`, or returns `null` only when it is unset. An explicit unknown or
+  malformed selector fails instead of silently disabling the provider.
 
 ## Fail-hard rules
 
@@ -45,5 +59,7 @@ interface ProviderAlias {
   same alias throw (`Duplicate provider alias "<alias>"`). No silent pick.
 - **Dangling override** — a `PLURNK_BASEURL_*` whose alias has no matching
   `PLURNK_MODEL_*` throws (a typo, not a silent no-op).
+- **Unresolved active selector** — a non-empty `PLURNK_MODEL` that is neither a
+  declared alias nor a complete exact route throws.
 
 Both are contract violations surfaced loudly, never recovered.

package/dist/aliases.d.ts

@@ -1,4 +1,5 @@
-import type { ProviderAlias } from "./types.ts";
+import type { ProviderAlias, ProviderSpec } from "./types.ts";
 export declare const parseAliasesFromEnv: (env?: NodeJS.ProcessEnv) => ProviderAlias[];
-export declare const resolveActiveAlias: (env?: NodeJS.ProcessEnv) => ProviderAlias | null;
+export declare const resolveModelSelector: (selector: string, aliases: readonly ProviderAlias[]) => ProviderSpec | null;
+export declare const resolveActiveRoute: (env?: NodeJS.ProcessEnv) => ProviderSpec | null;
 //# sourceMappingURL=aliases.d.ts.map

package/dist/aliases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD,eAAO,MAAM,mBAAmB,SAAS,MAAM,CAAC,UAAU,KAAiB,aAAa,EAwBvF,CAAC;AAEF,eAAO,MAAM,kBAAkB,SAAS,MAAM,CAAC,UAAU,KAAiB,aAAa,GAAG,IAKzF,CAAC"}
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkB9D,eAAO,MAAM,mBAAmB,SAAS,MAAM,CAAC,UAAU,KAAiB,aAAa,EAwBvF,CAAC;AAEF,eAAO,MAAM,oBAAoB,aACnB,MAAM,WACP,SAAS,aAAa,EAAE,KAClC,YAAY,GAAG,IAOjB,CAAC;AAEF,eAAO,MAAM,kBAAkB,SAAS,MAAM,CAAC,UAAU,KAAiB,YAAY,GAAG,IAWxF,CAAC"}

package/dist/aliases.js

@@ -1,7 +1,7 @@
 // The plurnk model-alias cascade — pure env parsing, zero runtime deps.
 //
-// PLURNK_MODEL_<alias>=<provider>/<model> declares an alias; PLURNK_MODEL=<alias>
-// selects the active one at boot. The provider segment is the first "/"-delimited
+// PLURNK_MODEL_<alias>=<provider>/<model> declares an alias; PLURNK_MODEL selects
+// either one declared alias or one exact provider/model route at boot. The provider segment is the first "/"-delimited
 // field; the model id is the remainder (it may itself contain "/"). Aliases are
 // case-folded (the .env key suffix downcased). PLURNK_BASEURL_<alias> attaches a
 // per-alias endpoint override — the one thing a per-provider base-URL var can't
@@ -59,11 +59,24 @@ export const parseAliasesFromEnv = (env = process.env) => {
         throw new Error(`PLURNK_BASEURL_* override(s) with no matching PLURNK_MODEL_* alias: ${unmatched.join(", ")}. Declare the alias or remove the override.`);
     return out;
 };
-export const resolveActiveAlias = (env = process.env) => {
+export const resolveModelSelector = (selector, aliases) => {
+    const slash = selector.indexOf("/");
+    if (slash > 0 && slash < selector.length - 1) {
+        return { provider: selector.slice(0, slash), model: selector.slice(slash + 1) };
+    }
+    if (slash !== -1)
+        return null;
+    return aliases.find((alias) => alias.alias === selector.toLowerCase()) ?? null;
+};
+export const resolveActiveRoute = (env = process.env) => {
     const selected = env.PLURNK_MODEL;
     if (selected === undefined || selected.length === 0)
         return null;
     const aliases = parseAliasesFromEnv(env);
-    return aliases.find((a) => a.alias === selected.toLowerCase()) ?? null;
+    const route = resolveModelSelector(selected, aliases);
+    if (route === null) {
+        throw new Error(`PLURNK_MODEL '${selected}' is neither a declared alias nor a provider/model route.`);
+    }
+    return route;
 };
 //# sourceMappingURL=aliases.js.map

package/dist/aliases.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export type { ProviderAlias } from "./types.ts";
-export { parseAliasesFromEnv, resolveActiveAlias } from "./aliases.ts";
+export type { ModelRoute, ProviderAlias, ProviderSpec } from "./types.ts";
+export { parseAliasesFromEnv, resolveActiveRoute, resolveModelSelector } from "./aliases.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { parseAliasesFromEnv, resolveActiveAlias } from "./aliases.js";
+export { parseAliasesFromEnv, resolveActiveRoute, resolveModelSelector } from "./aliases.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -1,7 +1,9 @@
-export interface ProviderAlias {
-    readonly alias: string;
-    readonly provider: string;
-    readonly model: string;
+import type { ModelRoute } from "@plurnk/plurnk-contracts";
+export type ProviderSpec = ModelRoute & {
     readonly baseUrl?: string;
-}
+};
+export type ProviderAlias = ProviderSpec & {
+    readonly alias: string;
+};
+export type { ModelRoute } from "@plurnk/plurnk-contracts";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@plurnk/plurnk-aliases",
-    "version": "1.6.1",
-    "description": "Zero-dependency parser for the plurnk model-alias cascade (PLURNK_MODEL_<alias>=<provider>/<model>, PLURNK_BASEURL_<alias>). Shared by @plurnk/plurnk-providers and thin plurnk clients that resolve aliases without pulling the provider/tokenizer machinery.",
+    "version": "1.8.0",
+    "description": "Runtime-free parser for PLURNK model selectors and the model-alias cascade.",
     "keywords": [
         "plurnk",
         "alias",
@@ -48,5 +48,8 @@
         "build:dist": "tsc -p tsconfig.build.json",
         "build": "npm run build:clean && npm run build:dist",
         "prepack": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-contracts": "1.8.0"
     }
 }