agent-nuvira 3.3.0 → 3.3.3

package/dist/config/live-credentials.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Credentials that grant a REAL, outward action — and the rule that they must
+ * never reach a test process.
+ *
+ * WHY THIS EXISTS. It is the reason agent-nuvira could not publish its own
+ * release, and the reason the failure looked inexplicable for three attempts.
+ *
+ * The release pipeline spawns `npm test` with its own environment, and the
+ * credential store loads that environment from `~/.nuvira/.env` — so the test
+ * process inherited the operator's LIVE provider keys (GROQ, GEMINI, NVIDIA NIM,
+ * OPENROUTER) along with Twilio / Slack / Telegram tokens and AWS/Bedrock
+ * credentials. Tests that are conditioned on a key being present — correctly, so
+ * that someone with a key can exercise the real path — then woke up and took a
+ * real network path. MEASURED: the same 350 files that are green in a shell
+ * without those keys (349 passed, 99-133s, twice) produced 7 failed files with
+ * 25 x `Test timed out in 15000ms` when run with the release's environment
+ * (363s). Phase 1 therefore failed every release attempt on an environment
+ * difference that left no trace in its own output.
+ *
+ * The fix is deliberately at BOTH ends:
+ *   - the SUITE strips these keys (`tests/setup/hermetic-env.ts`) so no test can
+ *     reach a live provider or send a real message, no matter who starts it; and
+ *   - the PIPELINE spawns the suite without them (`runTestsPhase`), because
+ *     handing live credentials to a process whose job is to not use them is the
+ *     pipeline's own bug.
+ * A test that genuinely needs a key sets one itself, as the credential tests
+ * already do.
+ *
+ * The release's OWN git/npm credentials are stripped from the suite as well, and
+ * the measurement is the reason. `IssueTriageAgent.detectSource` infers `github`
+ * from the presence of a GitHub token, so `should detect auto when no keyword
+ * matches` returned `github` and failed — under the release, which must hold
+ * `GITHUB_TOKEN` to push, that is EVERY release. A test that needs a token now
+ * provides its own: the credential tests already set and delete these in their
+ * `beforeEach` (see tests/agents/credential-store.test.ts), so nothing depends on
+ * inheriting them.
+ */
+/**
+ * Every provider API key the catalog knows about, derived rather than copied —
+ * a hardcoded list here would silently fall behind the providers being added.
+ */
+export declare const PROVIDER_CREDENTIAL_ENV_KEYS: string[];
+/** {@link SIDE_EFFECT_ENV_KEYS}, exported for the tests that pin the list. */
+export declare const SIDE_EFFECT_CREDENTIAL_ENV_KEYS: string[];
+/** The keys {@link stripTestUnsafeEnv} removes, sorted. */
+export declare const TEST_UNSAFE_ENV_KEYS: string[];
+/**
+ * A COPY of `env` without the credentials above — for spawning a child (the
+ * release spawns the suite) without mutating this process's own environment.
+ */
+export declare function stripTestUnsafeEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Remove the credentials above from `env` IN PLACE, returning the names that were
+ * actually present — so a suite can report what it closed rather than assuming.
+ */
+export declare function deleteTestUnsafeEnv(env?: NodeJS.ProcessEnv): string[];
+//# sourceMappingURL=live-credentials.d.ts.map

package/dist/config/live-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-credentials.d.ts","sourceRoot":"","sources":["../../src/config/live-credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAoCH;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,EAOzC,CAAC;AAET,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,EAAE,MAAM,EAA8B,CAAC;AAiBnF,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAIhC,CAAC;AAEV;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAI1F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CASlF"}

package/dist/config/live-credentials.js

@@ -0,0 +1,126 @@
+/**
+ * Credentials that grant a REAL, outward action — and the rule that they must
+ * never reach a test process.
+ *
+ * WHY THIS EXISTS. It is the reason agent-nuvira could not publish its own
+ * release, and the reason the failure looked inexplicable for three attempts.
+ *
+ * The release pipeline spawns `npm test` with its own environment, and the
+ * credential store loads that environment from `~/.nuvira/.env` — so the test
+ * process inherited the operator's LIVE provider keys (GROQ, GEMINI, NVIDIA NIM,
+ * OPENROUTER) along with Twilio / Slack / Telegram tokens and AWS/Bedrock
+ * credentials. Tests that are conditioned on a key being present — correctly, so
+ * that someone with a key can exercise the real path — then woke up and took a
+ * real network path. MEASURED: the same 350 files that are green in a shell
+ * without those keys (349 passed, 99-133s, twice) produced 7 failed files with
+ * 25 x `Test timed out in 15000ms` when run with the release's environment
+ * (363s). Phase 1 therefore failed every release attempt on an environment
+ * difference that left no trace in its own output.
+ *
+ * The fix is deliberately at BOTH ends:
+ *   - the SUITE strips these keys (`tests/setup/hermetic-env.ts`) so no test can
+ *     reach a live provider or send a real message, no matter who starts it; and
+ *   - the PIPELINE spawns the suite without them (`runTestsPhase`), because
+ *     handing live credentials to a process whose job is to not use them is the
+ *     pipeline's own bug.
+ * A test that genuinely needs a key sets one itself, as the credential tests
+ * already do.
+ *
+ * The release's OWN git/npm credentials are stripped from the suite as well, and
+ * the measurement is the reason. `IssueTriageAgent.detectSource` infers `github`
+ * from the presence of a GitHub token, so `should detect auto when no keyword
+ * matches` returned `github` and failed — under the release, which must hold
+ * `GITHUB_TOKEN` to push, that is EVERY release. A test that needs a token now
+ * provides its own: the credential tests already set and delete these in their
+ * `beforeEach` (see tests/agents/credential-store.test.ts), so nothing depends on
+ * inheriting them.
+ */
+import { PROVIDER_CATALOG } from '../inference/provider-catalog.js';
+/** Provider keys that are not in the catalog (legacy or bespoke). */
+const EXTRA_PROVIDER_ENV_KEYS = ['TOKENRA_API_KEY', 'AZURE_OPENAI_ENDPOINT'];
+/**
+ * The release's own credentials. Not "side effects" in the same sense — they are
+ * how the release pushes and publishes — but a test process must not inherit
+ * them either: their mere PRESENCE changes behaviour (see the note above).
+ */
+const RELEASE_CREDENTIAL_ENV_KEYS = [
+    'GITHUB_TOKEN',
+    'GH_TOKEN',
+    'GITHUB_API_KEY',
+    'GIT_USERNAME',
+    'NPM_TOKEN',
+];
+/** Credentials that can cause an outward action: send a message, spend money. */
+const SIDE_EFFECT_ENV_KEYS = [
+    'TWILIO_ACCOUNT_SID',
+    'TWILIO_AUTH_TOKEN',
+    'TWILIO_PHONE_NUMBER',
+    'SLACK_BOT_TOKEN',
+    'TELEGRAM_BOT_TOKEN',
+    'TELEGRAM_TOKEN',
+    'WHATSAPP_SELF_CHAT',
+    'AWS_ACCESS_KEY_ID',
+    'AWS_SECRET_ACCESS_KEY',
+    'AWS_SESSION_TOKEN',
+    'AWS_BEARER_TOKEN',
+    'BEDROCK_REGION',
+];
+/**
+ * Every provider API key the catalog knows about, derived rather than copied —
+ * a hardcoded list here would silently fall behind the providers being added.
+ */
+export const PROVIDER_CREDENTIAL_ENV_KEYS = [
+    ...new Set([
+        ...Object.values(PROVIDER_CATALOG)
+            .map((provider) => provider.envVar)
+            .filter((name) => Boolean(name)),
+        ...EXTRA_PROVIDER_ENV_KEYS,
+    ]),
+].sort();
+/** {@link SIDE_EFFECT_ENV_KEYS}, exported for the tests that pin the list. */
+export const SIDE_EFFECT_CREDENTIAL_ENV_KEYS = [...SIDE_EFFECT_ENV_KEYS];
+/**
+ * One base key plus the `NUVIRA_` / `BUFF_` spellings the resolvers accept:
+ * `TELEGRAM_TOKEN` is also read as `NUVIRA_TELEGRAM_TOKEN`, and a split pair
+ * (one spelling stripped, the other kept) would leave the live key reachable.
+ */
+function withPrefixedAliases(keys) {
+    const out = new Set();
+    for (const key of keys) {
+        out.add(key);
+        out.add(`NUVIRA_${key}`);
+        out.add(`BUFF_${key}`);
+    }
+    return [...out];
+}
+/** The keys {@link stripTestUnsafeEnv} removes, sorted. */
+export const TEST_UNSAFE_ENV_KEYS = withPrefixedAliases([
+    ...PROVIDER_CREDENTIAL_ENV_KEYS,
+    ...SIDE_EFFECT_ENV_KEYS,
+    ...RELEASE_CREDENTIAL_ENV_KEYS,
+]).sort();
+/**
+ * A COPY of `env` without the credentials above — for spawning a child (the
+ * release spawns the suite) without mutating this process's own environment.
+ */
+export function stripTestUnsafeEnv(env = process.env) {
+    const copy = { ...env };
+    for (const key of TEST_UNSAFE_ENV_KEYS)
+        delete copy[key];
+    return copy;
+}
+/**
+ * Remove the credentials above from `env` IN PLACE, returning the names that were
+ * actually present — so a suite can report what it closed rather than assuming.
+ */
+export function deleteTestUnsafeEnv(env = process.env) {
+    const removed = [];
+    for (const key of TEST_UNSAFE_ENV_KEYS) {
+        if (env[key] !== undefined) {
+            delete env[key];
+            removed.push(key);
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=live-credentials.js.map

package/dist/config/live-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-credentials.js","sourceRoot":"","sources":["../../src/config/live-credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,qEAAqE;AACrE,MAAM,uBAAuB,GAAG,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG;IAClC,cAAc;IACd,UAAU;IACV,gBAAgB;IAChB,cAAc;IACd,WAAW;CACZ,CAAC;AAEF,iFAAiF;AACjF,MAAM,oBAAoB,GAAG;IAC3B,oBAAoB;IACpB,mBAAmB;IACnB,qBAAqB;IACrB,iBAAiB;IACjB,oBAAoB;IACpB,gBAAgB;IAChB,oBAAoB;IACpB,mBAAmB;IACnB,uBAAuB;IACvB,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAa;IACpD,GAAG,IAAI,GAAG,CAAC;QACT,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;aAC/B,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;aAClC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,GAAG,uBAAuB;KAC3B,CAAC;CACH,CAAC,IAAI,EAAE,CAAC;AAET,8EAA8E;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAa,CAAC,GAAG,oBAAoB,CAAC,CAAC;AAEnF;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAc;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,GAAG,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAa,mBAAmB,CAAC;IAChE,GAAG,4BAA4B;IAC/B,GAAG,oBAAoB;IACvB,GAAG,2BAA2B;CAC/B,CAAC,CAAC,IAAI,EAAE,CAAC;AAEV;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,MAAM,IAAI,GAAsB,EAAE,GAAG,GAAG,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,oBAAoB;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/config/paths.d.ts

@@ -27,6 +27,24 @@ export declare function resolveNuviraHome(): string;
  * persists (env, routing failures, audit logs, …) must resolve through here.
  */
 export declare function resolveNuviraDataPath(...segments: string[]): string;
+/**
+ * Resolve the directory that holds MCP server configs.
+ *
+ * Precedence: an explicit directory, `$NUVIRA_MCP_DIR` / `$BUFF_MCP_DIR`, then
+ * `<config dir>/mcp` — so `$NUVIRA_CONFIG_DIR` isolates this too — then
+ * `~/.nuvira/mcp`.
+ *
+ * WHY THIS EXISTS. Both call sites used to be a bare
+ * `join(homedir(), '.nuvira', 'mcp')`, which is the reach the note on
+ * {@link resolveNuviraHome} warns about. The cost was measured rather than
+ * assumed: the orchestrator calls `discoverConfigs()` on every run, so the test
+ * suite found the developer's REAL `github` / `exa` / `firecrawl` configs and
+ * spawned those servers mid-run. That is outbound network traffic from a test
+ * process, MCP responses arriving for clients the test had already torn down
+ * (`Received a response for an unknown message ID`), and a fully mocked test
+ * timing out at 15s. A test run must not be able to reach a live MCP server.
+ */
+export declare function resolveMcpConfigDir(explicitDir?: string): string;
 /**
  * Resolve the `.env` file that supplies provider credentials.
  *

package/dist/config/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAwBA,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,+BAAyB,CAAC;AAE3D,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,6BAA6B;AAC7B,eAAO,MAAM,qBAAqB,gCAA0B,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAwBA,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,+BAAyB,CAAC;AAE3D,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,6BAA6B;AAC7B,eAAO,MAAM,qBAAqB,gCAA0B,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD"}

package/dist/config/paths.js

@@ -70,6 +70,31 @@ export function resolveNuviraHome() {
 export function resolveNuviraDataPath(...segments) {
     return join(resolveNuviraConfigDir(), ...segments);
 }
+/**
+ * Resolve the directory that holds MCP server configs.
+ *
+ * Precedence: an explicit directory, `$NUVIRA_MCP_DIR` / `$BUFF_MCP_DIR`, then
+ * `<config dir>/mcp` — so `$NUVIRA_CONFIG_DIR` isolates this too — then
+ * `~/.nuvira/mcp`.
+ *
+ * WHY THIS EXISTS. Both call sites used to be a bare
+ * `join(homedir(), '.nuvira', 'mcp')`, which is the reach the note on
+ * {@link resolveNuviraHome} warns about. The cost was measured rather than
+ * assumed: the orchestrator calls `discoverConfigs()` on every run, so the test
+ * suite found the developer's REAL `github` / `exa` / `firecrawl` configs and
+ * spawned those servers mid-run. That is outbound network traffic from a test
+ * process, MCP responses arriving for clients the test had already torn down
+ * (`Received a response for an unknown message ID`), and a fully mocked test
+ * timing out at 15s. A test run must not be able to reach a live MCP server.
+ */
+export function resolveMcpConfigDir(explicitDir) {
+    if (explicitDir)
+        return explicitDir;
+    const override = envBuff('MCP_DIR');
+    if (override)
+        return override;
+    return join(resolveNuviraConfigDir(), 'mcp');
+}
 /**
  * Resolve the `.env` file that supplies provider credentials.
  *

package/dist/config/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,yFAAyF;AACzF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD,MAAM,UAAU,sBAAsB,CAAC,WAAoB;IACzD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,6BAA6B;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACxE,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,0DAA0D;IAC1D,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,MAAM,GAAG,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAG,QAAkB;IACzD,OAAO,IAAI,CAAC,sBAAsB,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAkB;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC1F,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,yFAAyF;AACzF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD,MAAM,UAAU,sBAAsB,CAAC,WAAoB;IACzD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,6BAA6B;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACxE,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,0DAA0D;IAC1D,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,MAAM,GAAG,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAG,QAAkB;IACzD,OAAO,IAAI,CAAC,sBAAsB,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACtD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,sBAAsB,EAAE,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAkB;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC1F,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/federation/a2a-types.js

@@ -58,7 +58,7 @@ export function createDefaultAgentCard(baseUrl, nodeName) {
         url: baseUrl,
         identity: {
             organization: 'Agent-Nuvira',
-            documentationUrl: 'https://github.com/imdheerajKube/agent-nuvira',
+            documentationUrl: 'https://github.com/imdheerajKube/agent-nuvira-documentation',
         },
         capabilities: [
             { id: 'code-generation', name: 'Code Generation', description: 'Generate new source code files and projects' },

package/dist/federation/a2a-types.js.map

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

package/dist/forwarded.d.ts

@@ -0,0 +1,2 @@
+export declare const ok = true;
+//# sourceMappingURL=forwarded.d.ts.map

package/dist/forwarded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarded.d.ts","sourceRoot":"","sources":["../src/forwarded.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,OAAO,CAAC"}

package/dist/forwarded.js

@@ -0,0 +1,2 @@
+export const ok = true;
+//# sourceMappingURL=forwarded.js.map

package/dist/forwarded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarded.js","sourceRoot":"","sources":["../src/forwarded.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC"}

package/dist/inference/model-validator.d.ts

@@ -36,7 +36,12 @@ export declare function clearModelListCache(): void;
  * @param provider      The inference provider instance (for listModels()).
  * @param providerType  Provider id (e.g. 'gemini', 'groq') for curated defaults.
  * @param desiredModel  The model Auto routing resolved (may be stale/'default').
+ * @param announce      Also print the repair here. DEFAULT `false`: every caller
+ *   now goes through `resolveRoute()`, which owns the reporting (print + routing
+ *   history + run trace). Announcing in both places produced TWO lines for one
+ *   substitution, and in strict mode it announced a swap that then threw
+ *   instead of happening — worse than silence.
  * @returns A model id guaranteed (best-effort) to exist on the provider.
  */
-export declare function resolveWorkingModel(provider: InferenceProvider, providerType: string, desiredModel?: string): Promise<string>;
+export declare function resolveWorkingModel(provider: InferenceProvider, providerType: string, desiredModel?: string, announce?: boolean): Promise<string>;
 //# sourceMappingURL=model-validator.d.ts.map

package/dist/inference/model-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-validator.d.ts","sourceRoot":"","sources":["../../src/inference/model-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,gBAAgB,CAAC;AAuBzE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAyCD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CA+GjB"}
+{"version":3,"file":"model-validator.d.ts","sourceRoot":"","sources":["../../src/inference/model-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,gBAAgB,CAAC;AAuBzE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAyCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,UAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CA+GjB"}

package/dist/inference/model-validator.js

@@ -94,9 +94,14 @@ function modelFallbackScore(m) {
  * @param provider      The inference provider instance (for listModels()).
  * @param providerType  Provider id (e.g. 'gemini', 'groq') for curated defaults.
  * @param desiredModel  The model Auto routing resolved (may be stale/'default').
+ * @param announce      Also print the repair here. DEFAULT `false`: every caller
+ *   now goes through `resolveRoute()`, which owns the reporting (print + routing
+ *   history + run trace). Announcing in both places produced TWO lines for one
+ *   substitution, and in strict mode it announced a swap that then threw
+ *   instead of happening — worse than silence.
  * @returns A model id guaranteed (best-effort) to exist on the provider.
  */
-export async function resolveWorkingModel(provider, providerType, desiredModel) {
+export async function resolveWorkingModel(provider, providerType, desiredModel, announce = false) {
     const explicit = desiredModel && desiredModel !== 'default' ? desiredModel : undefined;
     // ── 0. FAST PATH — the Model Availability Registry (sub-ms, no network) ─
     // When the registry has already verified this model works (via a prior
@@ -184,7 +189,7 @@ export async function resolveWorkingModel(provider, providerType, desiredModel)
             return !!m && modelFallbackScore(m) < 100 && !registryBlocks(id);
         });
         if (chosen) {
-            if (explicit) {
+            if (explicit && announce) {
                 const fromVerified = preferredModelsFor(providerType).includes(chosen);
                 logger.warn(`♻️  Auto routing: model '${explicit}' is not available on '${providerType}' — using '${chosen}'${fromVerified ? ' (verified working)' : ''}.`);
             }

package/dist/inference/model-validator.js.map

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

package/dist/inference/route-resolver.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Route resolution — the ONE place a provider and its model are validated as a
+ * PAIR, against the very adapter that will serve the call.
+ *
+ * WHY THIS EXISTS (issue #9). A live release run failed its first model call
+ * with `Groq API error (404): The model 'gemini-3.1-flash-lite' does not exist`
+ * — a Gemini id sent to Groq, on a machine whose `nuviraconfig.json` pins
+ * `providers.groq.model = openai/gpt-oss-120b` and `providers.gemini.model =
+ * gemini-flash-latest`. Neither pin was stale, so the foreign id came from a
+ * RESOLUTION: provider and model were decided in different places (provider
+ * ranking, the auto-router's per-task decision, and a site-local
+ * `config.model || inferenceOptions?.model` fallback), and nothing checked that
+ * the three agreed.
+ *
+ * The same class had already been found twice and patched at one call site each
+ * time — chat's failover path (`src/cli/chat.ts`) and catalog-provider
+ * substitution (`src/cli/router.ts`) — which is why `publish` still walked into
+ * it: the fix never reached a SHARED path. This module is that shared path.
+ *
+ * INVARIANTS
+ * 1. The model is validated against `provider` — the instance the caller is
+ *    about to call — never against a provider looked up separately.
+ * 2. A substitution is NEVER silent: it is printed, and it is recorded (the
+ *    routing history the dashboard reads, plus the active run trace when one
+ *    exists). A broken pair that looks healthy is worse than no report at all.
+ * 3. `strict` (or `NUVIRA_STRICT_MODEL=1`) refuses to substitute at all, so a
+ *    pinned model that is dead fails with a sentence naming the pair instead of
+ *    quietly running on a different model.
+ *
+ * It is deliberately thin: `resolveWorkingModel()` already owns the repair
+ * policy (registry fast path → live list → catalog default) and is the only
+ * place a model list is fetched. This wrapper adds the PAIR guarantee, the
+ * audit, and the reporting — it must never grow a second repair policy.
+ */
+import type { InferenceProvider } from './interface.js';
+/** Who is asking — used only for the audit record's wording. */
+export type RouteSource = 'orchestrator' | 'chat' | 'publish' | 'failover' | 'cli' | (string & {});
+export interface RouteRequest {
+    /** Provider id (`groq`, `gemini`, …) — must describe `provider`. */
+    providerType: string;
+    /** The adapter that will serve the call. The model is validated against THIS. */
+    provider: InferenceProvider;
+    /** Requested model. `undefined` or `'default'` means "let the provider decide". */
+    model?: string;
+    source?: RouteSource;
+    agentType?: string;
+    task?: string;
+    /** Refuse to substitute; throw instead. Defaults to `NUVIRA_STRICT_MODEL=1`. */
+    strict?: boolean;
+}
+export interface ResolvedRoute {
+    providerType: string;
+    provider: InferenceProvider;
+    /** The model to send. Always a real model id when one could be resolved. */
+    model: string;
+    /** What was asked for, when anything was. */
+    requested?: string;
+    /** True when `model` differs from `requested`. */
+    substituted: boolean;
+}
+/**
+ * The same fact WITHOUT the adapter — the shape that can be fed to a model (see
+ * `src/tools/loop-route-feed.ts`). A provider instance is not serializable and
+ * must never leak into prompt text.
+ */
+export interface ServedRoute {
+    providerType: string;
+    /** The adapter's own display name (`Groq`, `Local (llama.cpp)`). */
+    providerName?: string;
+    model: string;
+    requested?: string;
+    substituted?: boolean;
+    /** Earlier serving pairs this turn, oldest first — a failover history. */
+    previous?: string[];
+}
+/** Strip a {@link ResolvedRoute} down to the feedable fact. */
+export declare function servedRouteFrom(route: ResolvedRoute): ServedRoute;
+/**
+ * Strict model mode — a dead pin FAILS instead of being substituted.
+ *
+ * Off by default: a release or a long agent run must not stop dead because one
+ * provider retired a model. On for a caller who would rather know than proceed
+ * (`NUVIRA_STRICT_MODEL=1`), because "it ran on something else" is exactly the
+ * outcome that is invisible until much later.
+ */
+export declare function strictModelMode(): boolean;
+/** Test hook: forget what has already been announced. */
+export declare function resetSubstitutionReporting(): void;
+/** One line naming the pair that was substituted, for the console and the trace. */
+export declare function substitutionLine(input: {
+    providerType: string;
+    requested: string;
+    served: string;
+}): string;
+/**
+ * Report a substitution: print it, audit it, and attach it to the active run
+ * trace when there is one. Best-effort throughout — reporting must never break
+ * the call it is reporting on.
+ */
+export declare function reportSubstitution(input: {
+    providerType: string;
+    requested: string;
+    served: string;
+    source?: RouteSource;
+    agentType?: string;
+    task?: string;
+}): void;
+/**
+ * Resolve `{providerType, provider, model}` as ONE validated pair.
+ *
+ * Never throws for a missing/unreachable model (it resolves one); it throws ONLY
+ * when strict mode is on and a requested model could not be honoured, which is
+ * the one case where proceeding would be a lie about what ran.
+ */
+export declare function resolveRoute(request: RouteRequest): Promise<ResolvedRoute>;
+//# sourceMappingURL=route-resolver.d.ts.map

package/dist/inference/route-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-resolver.d.ts","sourceRoot":"","sources":["../../src/inference/route-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOxD,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnG,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAQjE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAcD,yDAAyD;AACzD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAKT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAiCP;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAsChF"}