@akagilnc/pi-workflow-roles 0.1.3733 → 0.1.3741

package/dist/public-cli/config.js

@@ -139,50 +139,6 @@ function parseAutoResumeLimit(value) {
 function setAutoResumeLimit(config, limit) {
   return { ...config, autoResumeLimit: parseAutoResumeLimit(limit) };
 }
-function requireNonEmptyToken(value, label) {
-  const trimmed = value.trim();
-  if (trimmed === "") {
-    throw new Error(`${label} must be a non-empty string`);
-  }
-  return trimmed;
-}
-function setProviderHostAlias(config, provider, host, alias) {
-  const from = requireNonEmptyToken(provider, "provider");
-  const hostName = requireNonEmptyToken(host, "host");
-  const to = requireNonEmptyToken(alias, "alias");
-  const previous = config.providerAliases ?? {};
-  return {
-    ...config,
-    providerAliases: {
-      ...previous,
-      [from]: {
-        ...previous[from] ?? {},
-        [hostName]: to
-      }
-    }
-  };
-}
-function unsetProviderHostAlias(config, provider, host) {
-  const from = requireNonEmptyToken(provider, "provider");
-  const hostName = requireNonEmptyToken(host, "host");
-  const previous = config.providerAliases;
-  if (previous === void 0 || previous[from] === void 0) return config;
-  const { [hostName]: _dropped, ...restHosts } = previous[from];
-  const nextForProvider = Object.keys(restHosts).length === 0 ? void 0 : restHosts;
-  const { [from]: _provider, ...restProviders } = previous;
-  const nextAliases = nextForProvider === void 0 ? restProviders : { ...restProviders, [from]: nextForProvider };
-  if (Object.keys(nextAliases).length === 0) {
-    const { providerAliases: _gone, ...rest } = config;
-    return rest;
-  }
-  return { ...config, providerAliases: nextAliases };
-}
-function applyProviderHostAlias(selection, host, aliases) {
-  if (selection === void 0 || aliases === void 0) return selection;
-  const mapped = aliases[selection.provider]?.[host];
-  if (mapped === void 0) return selection;
-  return { ...selection, provider: mapped };
-}
 function validatePublicCliConfigAxes(config, _packageRoot) {
   for (const seat of Object.keys(config.seats)) {
     const row = config.seats[seat];
@@ -252,44 +208,9 @@ function serializePublicCliConfig(config) {
       ...config.unknownSeats ?? {},
       ...config.seats
     },
-    ...config.autoResumeLimit === void 0 ? {} : { autoResumeLimit: config.autoResumeLimit },
-    ...config.providerAliases === void 0 || Object.keys(config.providerAliases).length === 0 ? {} : { providerAliases: config.providerAliases }
+    ...config.autoResumeLimit === void 0 ? {} : { autoResumeLimit: config.autoResumeLimit }
   };
 }
-function parseProviderHostAliases(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("public CLI config.providerAliases must be an object");
-  }
-  const out = {};
-  for (const [provider, byHost] of Object.entries(value)) {
-    if (provider.trim() === "") {
-      throw new Error("public CLI config.providerAliases provider key must be non-empty");
-    }
-    if (byHost === null || typeof byHost !== "object" || Array.isArray(byHost)) {
-      throw new Error(
-        `public CLI config.providerAliases[${provider}] must be an object`
-      );
-    }
-    const hosts = {};
-    for (const [host, alias] of Object.entries(byHost)) {
-      if (host.trim() === "") {
-        throw new Error(
-          `public CLI config.providerAliases[${provider}] host key must be non-empty`
-        );
-      }
-      if (typeof alias !== "string" || alias.trim() === "") {
-        throw new Error(
-          `public CLI config.providerAliases[${provider}][${host}] must be a non-empty string`
-        );
-      }
-      hosts[host] = alias;
-    }
-    if (Object.keys(hosts).length > 0) {
-      out[provider] = hosts;
-    }
-  }
-  return out;
-}
 function parsePublicCliConfig(value) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new Error("public CLI config must be an object");
@@ -299,13 +220,6 @@ function parsePublicCliConfig(value) {
   if (record.autoResumeLimit !== void 0) {
     autoResumeLimit = parseAutoResumeLimit(record.autoResumeLimit);
   }
-  let providerAliases;
-  if (record.providerAliases !== void 0) {
-    const parsed = parseProviderHostAliases(record.providerAliases);
-    if (Object.keys(parsed).length > 0) {
-      providerAliases = parsed;
-    }
-  }
   const unknownSeats = {};
   if (record.unknownSeats !== void 0) {
     if (record.unknownSeats === null || typeof record.unknownSeats !== "object" || Array.isArray(record.unknownSeats)) {
@@ -316,7 +230,6 @@ function parsePublicCliConfig(value) {
   const withOpaque = (seats2) => ({
     seats: seats2,
     ...autoResumeLimit === void 0 ? {} : { autoResumeLimit },
-    ...providerAliases === void 0 ? {} : { providerAliases },
     ...Object.keys(unknownSeats).length === 0 ? {} : { unknownSeats }
   });
   if (record.seats === void 0) {
@@ -493,21 +406,11 @@ function resolveEffectiveSeat(config, seat, credentials, invocation) {
       };
     }
   }
-  const withAxes = attachHostAxis(
+  return attachHostAxis(
     attachEngineAxis(modelSeat, config, invocation),
     config,
     invocation
   );
-  const selection = applyProviderHostAlias(
-    withAxes.selection,
-    withAxes.host,
-    config.providerAliases
-  );
-  if (selection === void 0) {
-    const { selection: _dropped, ...rest } = withAxes;
-    return rest;
-  }
-  return { ...withAxes, selection };
 }
 function effectiveSeatConfigurations(config, credentials, invocation) {
   return PUBLIC_CONFIGURABLE_SEATS.map(
@@ -540,7 +443,6 @@ async function loadCredentialProviders(agentDir) {
 }
 export {
   GATE_OFFICER_SEATS,
-  applyProviderHostAlias,
   buildSeatModelCliArgs,
   clearPersistentSeatConfig,
   credentialProvidersFromAuthData,
@@ -561,7 +463,5 @@ export {
   setPersistentSeatConfig,
   setPersistentSeatEngine,
   setPersistentSeatHost,
-  setProviderHostAlias,
-  unsetProviderHostAlias,
   validatePublicCliConfigAxes
 };

package/dist/public-cli/host-providers.js

@@ -0,0 +1,188 @@
+/**
+ * #788: owner-editable host provider map + host-directory resolution.
+ *
+ * Data file `~/.ak-roles/host-providers.json` is the sole owner-written map.
+ * Shape: { "<host>": { "<seat-provider>": "<host-provider>" } }.
+ * Code only reads it — no built-in pairs, no registration commands.
+ *
+ * Priority: table > unique directory match > loud failure.
+ * This ticket implements directory query for hermes only.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+export function hostProvidersPath(home) {
+    if (typeof home !== "string" || home.trim() === "") {
+        throw new Error("home must be explicitly provided");
+    }
+    return join(home, ".ak-roles", "host-providers.json");
+}
+/** Hermes provider model catalog under the operator home. */
+export function hermesProviderModelsCachePath(home) {
+    return join(home, ".hermes", "provider_models_cache.json");
+}
+export function parseHostProvidersTable(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("host-providers.json must be an object");
+    }
+    const out = {};
+    for (const [host, byProvider] of Object.entries(value)) {
+        if (host.trim() === "") {
+            throw new Error("host-providers.json host key must be non-empty");
+        }
+        if (byProvider === null ||
+            typeof byProvider !== "object" ||
+            Array.isArray(byProvider)) {
+            throw new Error(`host-providers.json[${host}] must be an object`);
+        }
+        const providers = {};
+        for (const [seatProvider, hostProvider] of Object.entries(byProvider)) {
+            if (seatProvider.trim() === "") {
+                throw new Error(`host-providers.json[${host}] seat-provider key must be non-empty`);
+            }
+            if (typeof hostProvider !== "string" || hostProvider.trim() === "") {
+                throw new Error(`host-providers.json[${host}][${seatProvider}] must be a non-empty string`);
+            }
+            providers[seatProvider] = hostProvider;
+        }
+        if (Object.keys(providers).length > 0) {
+            out[host] = providers;
+        }
+    }
+    return out;
+}
+/**
+ * Load the owner map. Missing file → empty table (directory / pass-through next).
+ * Malformed file fails loud — owner edits this by hand.
+ */
+export function loadHostProvidersTable(home) {
+    const path = hostProvidersPath(home);
+    try {
+        const raw = readFileSync(path, "utf8");
+        return parseHostProvidersTable(JSON.parse(raw));
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return {};
+        }
+        throw error;
+    }
+}
+/** True when the host catalog entry names the seat model (bare or slash-suffixed). */
+export function hostCatalogOffersModel(catalogModels, seatModel) {
+    return catalogModels.some((entry) => entry === seatModel || entry.endsWith(`/${seatModel}`));
+}
+/**
+ * Providers in the hermes catalog that offer `seatModel`.
+ * Reads `~/.hermes/provider_models_cache.json` under the given home.
+ * Missing file (ENOENT) → empty list (zero → loud failure upstream).
+ * Other read/parse failures keep their identity — never washed as "no model".
+ */
+export function listHermesProvidersForModel(home, seatModel) {
+    const path = hermesProviderModelsCachePath(home);
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const raw = JSON.parse(text);
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`hermes provider_models_cache.json must be an object: ${path}`);
+    }
+    const found = [];
+    for (const [provider, entry] of Object.entries(raw)) {
+        if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
+            continue;
+        }
+        const models = entry.models;
+        if (!Array.isArray(models))
+            continue;
+        const names = models.filter((m) => typeof m === "string");
+        if (hostCatalogOffersModel(names, seatModel)) {
+            found.push(provider);
+        }
+    }
+    return found.sort();
+}
+/** Hosts this build knows how to query a provider-model directory for. */
+function listDirectoryProvidersForModel(home, host, seatModel) {
+    if (host === "hermes") {
+        return listHermesProvidersForModel(home, seatModel);
+    }
+    // No directory for this host → caller falls through to pass-through.
+    return undefined;
+}
+export class HostProviderResolutionError extends Error {
+    host;
+    seatProvider;
+    seatModel;
+    candidates;
+    constructor(options) {
+        super(options.message);
+        this.name = "HostProviderResolutionError";
+        this.host = options.host;
+        this.seatProvider = options.seatProvider;
+        this.seatModel = options.seatModel;
+        this.candidates = options.candidates ?? [];
+    }
+}
+/**
+ * Project seat-table provider to the host-facing name.
+ * Priority: owner table > unique host-directory match > loud failure.
+ * Hosts without a directory and without a table entry pass the seat provider through.
+ */
+export function projectHostFacingProvider(selection, host, table, home) {
+    if (selection === undefined)
+        return undefined;
+    const mapped = table[host]?.[selection.provider];
+    if (mapped !== undefined) {
+        return mapped === selection.provider
+            ? selection
+            : { ...selection, provider: mapped };
+    }
+    const directory = listDirectoryProvidersForModel(home, host, selection.model);
+    if (directory === undefined) {
+        // No directory for this host → pass-through (pi, grok-build, …).
+        return selection;
+    }
+    if (directory.length === 1) {
+        const only = directory[0];
+        return only === selection.provider
+            ? selection
+            : { ...selection, provider: only };
+    }
+    if (directory.length === 0) {
+        throw new HostProviderResolutionError({
+            message: `host ${host} has no provider offering model ${selection.model}; seat provider was ${selection.provider}`,
+            host,
+            seatProvider: selection.provider,
+            seatModel: selection.model,
+        });
+    }
+    throw new HostProviderResolutionError({
+        message: `host ${host} has multiple providers for model ${selection.model}: ${directory.join(", ")}; set host-providers.json[${host}][${selection.provider}] to one of them`,
+        host,
+        seatProvider: selection.provider,
+        seatModel: selection.model,
+        candidates: directory,
+    });
+}
+/** Render the owner table for `config show` (disk face, unchanged). */
+export function renderHostProvidersTable(table) {
+    const lines = [];
+    for (const host of Object.keys(table).sort()) {
+        const byProvider = table[host];
+        for (const seatProvider of Object.keys(byProvider).sort()) {
+            lines.push(`hostProvider\t${host}\t${seatProvider}\t${byProvider[seatProvider]}`);
+        }
+    }
+    return lines.length === 0 ? "" : `${lines.join("\n")}\n`;
+}