@aui.io/apollo 0.1.43 → 0.1.47

package/README.md

@@ -40,7 +40,7 @@ apollo upgrade --check    # show the available version only
 ## Quick start
 
 ```bash
-apollo login                          # browser flow; picks environment (staging | production)
+apollo login                          # browser flow
 apollo agent import <agent-id>        # or: apollo agent create <name>
 cd <the printed checkout directory>   # defaults to ~/apollo/<profile>/<env>/<name>-<id>
 
@@ -59,7 +59,6 @@ selects the agent you are working on. `apollo status` always tells you where you
 | Layer | What it is | Commands |
 |---|---|---|
 | **Profile** | Named credential slot (e.g. `default`, `work`) | `profile *` |
-| **Environment** | `staging` or `production` | `env *` |
 | **Checkout** | Local directory holding one agent (`.apollorc` + `bundle/src/`) | `agent use / import / create` |
 | **Organization** | Identity / billing org (on the access token) | `org *` |
 | **Project** | Container for agents | `project *` |
@@ -71,10 +70,8 @@ selects the agent you are working on. `apollo status` always tells you where you
 ```text
 status     [--check]                         # active context (+ service connectivity)
 doctor     [--offline]                       # diagnose setup; exit 2 on problems
-curl       [--failed] [--last <n>] [--method <verb>] [--search <text>]
 upgrade    [version] [--check] [--force]
 login | logout
-env        current | list | use <name>
 profile    current | list | use <name>
 org        list | use <id>
 project    list | use <id> | create <name>
@@ -118,7 +115,7 @@ resources, scenarios) and **Talk** (converse with the running agent).
 |---|---|
 | `Ctrl+1` / `Ctrl+2` (or `Tab`) | Author / Talk |
 | `Ctrl+K` | Action palette — every operation, with CLI equivalents |
-| `Ctrl+G` | Context switcher — env / profile / agent / project / org |
+| `Ctrl+G` | Context switcher — profile / agent / project / org |
 | `Ctrl+J` | Activity drawer — operations, retry, output, live API-request tail |
 | `Esc` | Close overlay / cancel |
 
@@ -132,8 +129,6 @@ everything to the agent verbatim.
 ```bash
 apollo doctor             # diagnose the setup end to end; exit 2 on problems
 apollo status --check     # context + per-service reachability/auth
-apollo curl               # recent API requests replayed as curl commands
-apollo curl --failed      # only status ≥ 400 or no-response entries
 apollo --verbose <cmd>    # stream each API call live to stderr
 ```
 
@@ -143,11 +138,9 @@ permissions, token expiry, the current checkout, and service reachability —
 read-only, with the fix attached to every finding. Share its output when
 reporting issues.
 
-Every command records its HTTP requests — **redacted** (auth/token/key/secret values
-never reach disk) — to `~/.apollo/last-requests.json`. `apollo curl` prints them back
-as runnable curl commands (metadata in `#` comments, so output is shell-paste-safe);
-redacted auth headers are emitted as `$APOLLO_TOKEN` placeholders. The TUI shows the
-same stream live in its activity drawer.
+`--verbose` streams one **redacted** line per API request (auth/token/key/secret
+values never appear) to stderr; the TUI shows the same stream live in its
+activity drawer.
 
 ## Files and environment variables
 
@@ -157,13 +150,12 @@ same stream live in its activity drawer.
   credentials.json     # tokens (mode 0600 — the only secret-bearing file)
   checkouts.json       # known-checkouts registry
   baselines/…          # sync hashes for diff/push
-  last-requests.json   # redacted recent HTTP captures
 
 <checkout>/.apollorc   # org / project / agent / version_tag binding
 <checkout>/bundle/src/ # the editable program source
 ```
 
-`APOLLO_ENV`, `APOLLO_PROFILE`, `APOLLO_TOKEN` (CI auth), `APOLLO_ORG_ID`,
+`APOLLO_PROFILE`, `APOLLO_TOKEN` (CI auth), `APOLLO_ORG_ID`,
 `APOLLO_PROJECT_ID`, `APOLLO_TIMEOUT_MS`, and per-service `APOLLO_*_URL` overrides are
 honored everywhere; see the User Guide for the full table.
 

package/node_modules/@aui.io/apollo-cli/dist/src/commands/auth.js

@@ -1,10 +1,9 @@
 import { homedir } from "node:os";
-import { readCredentials, resolveContext, writeCredentials, } from "@aui.io/apollo-core/config/index.js";
+import { environmentDefinition, readCredentials, writeCredentials, } from "@aui.io/apollo-core/config/index.js";
 import { ConfigError } from "@aui.io/apollo-core/errors/index.js";
 import { loginWithBrowser, loginWithOtp, loginWithToken, logout, requestOtp, } from "@aui.io/apollo-core/services/auth.js";
 import { createClients } from "@aui.io/apollo-core/services/clients.js";
 import { prompt } from "./prompts.js";
-const PLAYGROUND_URL = "https://apollo.aui.io";
 export function registerAuth(program, runtime) {
     program
         .command("login")
@@ -16,15 +15,9 @@ export function registerAuth(program, runtime) {
         .option("--url <url>", "override the playground login URL")
         .action(async (options) => {
         const current = runtime();
-        // The public CLI signs in to production only — no environment flag.
-        const context = await resolveContext({
-            flags: {
-                env: "production",
-                profile: current.context.profile,
-                timeout: String(current.context.timeoutMs),
-            },
-        });
-        const { output } = current;
+        // Login lands on the active environment — which for this build can
+        // only be one the environment registry knows.
+        const { context, output } = current;
         const clients = createClients(context);
         let stored;
         if (options.token) {
@@ -47,7 +40,7 @@ export function registerAuth(program, runtime) {
         }
         else {
             output.progress("Opening browser login...");
-            const result = await loginWithBrowser(context, options.url ?? PLAYGROUND_URL);
+            const result = await loginWithBrowser(context, options.url ?? environmentDefinition(context.environment).playgroundUrl);
             stored = result.credential;
         }
         output.result({

package/node_modules/@aui.io/apollo-cli/dist/src/commands/auth.js.map

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

package/node_modules/@aui.io/apollo-cli/dist/src/commands/shell.d.ts

@@ -3,12 +3,18 @@ import type { Command } from "commander";
  * Shell wrapper sourced via `eval "$(apollo shell-init)"` (installed into the
  * user's rc file by the @aui.io/apollo postinstall). A child process cannot
  * change the parent shell's cwd, so auto-cd after `agent use/import/create`
- * has to live in the shell itself. Account commands (`env use`, `profile
- * use`) never cd — your position binds context, so moving is always an
- * explicit agent action. APOLLO_SHELL_WRAPPED lets the CLI drop the
+ * has to live in the shell itself. Account commands (`profile use`) never
+ * cd — your position binds context, so moving is always an explicit agent
+ * action. APOLLO_SHELL_WRAPPED lets the CLI drop the
  * "cd <path>" tip when the wrapper is about to do it anyway.
+ *
+ * Parameterized on the bin name so distributions with their own bin
+ * (`apollo-internal`) wrap their own command instead of shadowing this one.
+ * zsh/bash both accept hyphens in `name() {}` function names; the local
+ * variables keep a fixed spelling because hyphens are not legal there.
  */
-export declare const SHELL_INIT_SCRIPT = "# apollo shell integration (zsh/bash)\napollo() {\n  APOLLO_SHELL_WRAPPED=1 command apollo \"$@\"\n  local apollo_exit=$?\n  if [ \"$apollo_exit\" -eq 0 ] && [ \"$1\" = \"agent\" ]; then\n    case \"$2\" in\n      use|import|create)\n        # The command just touched the registry; resolve the checkout so\n        # name arguments and the interactive picker land in the right place.\n        local apollo_target\n        apollo_target=\"$(APOLLO_SHELL_WRAPPED=1 command apollo agent path 2>/dev/null)\"\n        if [ -n \"$apollo_target\" ] && [ -d \"$apollo_target\" ]; then\n          cd \"$apollo_target\" || return\n        fi\n        ;;\n    esac\n  fi\n  return \"$apollo_exit\"\n}\n";
+export declare function shellInitScript(bin: string): string;
+export declare const SHELL_INIT_SCRIPT: string;
 /**
  * Reaching this point means the auto-cd wrapper is not active in this shell
  * session. npm hides postinstall output, so this is the user's only signal.

package/node_modules/@aui.io/apollo-cli/dist/src/commands/shell.js

@@ -5,14 +5,20 @@ import path from "node:path";
  * Shell wrapper sourced via `eval "$(apollo shell-init)"` (installed into the
  * user's rc file by the @aui.io/apollo postinstall). A child process cannot
  * change the parent shell's cwd, so auto-cd after `agent use/import/create`
- * has to live in the shell itself. Account commands (`env use`, `profile
- * use`) never cd — your position binds context, so moving is always an
- * explicit agent action. APOLLO_SHELL_WRAPPED lets the CLI drop the
+ * has to live in the shell itself. Account commands (`profile use`) never
+ * cd — your position binds context, so moving is always an explicit agent
+ * action. APOLLO_SHELL_WRAPPED lets the CLI drop the
  * "cd <path>" tip when the wrapper is about to do it anyway.
+ *
+ * Parameterized on the bin name so distributions with their own bin
+ * (`apollo-internal`) wrap their own command instead of shadowing this one.
+ * zsh/bash both accept hyphens in `name() {}` function names; the local
+ * variables keep a fixed spelling because hyphens are not legal there.
  */
-export const SHELL_INIT_SCRIPT = `# apollo shell integration (zsh/bash)
-apollo() {
-  APOLLO_SHELL_WRAPPED=1 command apollo "$@"
+export function shellInitScript(bin) {
+    return `# ${bin} shell integration (zsh/bash)
+${bin}() {
+  APOLLO_SHELL_WRAPPED=1 command ${bin} "$@"
   local apollo_exit=$?
   if [ "$apollo_exit" -eq 0 ] && [ "$1" = "agent" ]; then
     case "$2" in
@@ -20,7 +26,7 @@ apollo() {
         # The command just touched the registry; resolve the checkout so
         # name arguments and the interactive picker land in the right place.
         local apollo_target
-        apollo_target="$(APOLLO_SHELL_WRAPPED=1 command apollo agent path 2>/dev/null)"
+        apollo_target="$(APOLLO_SHELL_WRAPPED=1 command ${bin} agent path 2>/dev/null)"
         if [ -n "$apollo_target" ] && [ -d "$apollo_target" ]; then
           cd "$apollo_target" || return
         fi
@@ -30,6 +36,8 @@ apollo() {
   return "$apollo_exit"
 }
 `;
+}
+export const SHELL_INIT_SCRIPT = shellInitScript("apollo");
 /**
  * Reaching this point means the auto-cd wrapper is not active in this shell
  * session. npm hides postinstall output, so this is the user's only signal.

package/node_modules/@aui.io/apollo-cli/dist/src/commands/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/commands/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;CAmBhC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACrE,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS;QACd,CAAC,CAAC,kIAAkI;QACpI,CAAC,CAAC,wGAAwG,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/commands/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,KAAK,GAAG;EACf,GAAG;mCAC8B,GAAG;;;;;;;;0DAQoB,GAAG;;;;;;;;;CAS5D,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACrE,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS;QACd,CAAC,CAAC,kIAAkI;QACpI,CAAC,CAAC,wGAAwG,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/node_modules/@aui.io/apollo-cli/dist/src/index.d.ts

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import type { CommandRuntime } from "./commands/runtime.js";
 import { type Context } from "@aui.io/apollo-core/config/index.js";
 import { Output } from "@aui.io/apollo-core/output/index.js";
 interface ProgramState {
@@ -6,6 +7,8 @@ interface ProgramState {
     output?: Output;
     captureUnsubscribe?: () => void;
 }
-export declare function createProgram(state?: ProgramState): Command;
-export declare function main(argv?: string[]): Promise<number>;
+/** A distribution's extra command modules, registered after the stock set. */
+export type CommandExtension = (program: Command, runtime: () => CommandRuntime) => void;
+export declare function createProgram(state?: ProgramState, extensions?: readonly CommandExtension[]): Command;
+export declare function main(argv?: string[], extensions?: readonly CommandExtension[]): Promise<number>;
 export {};

package/node_modules/@aui.io/apollo-cli/dist/src/index.js

@@ -1,10 +1,8 @@
 import { Command, CommanderError, Option } from "commander";
 import { normalizeArgv } from "@aui.io/apollo-core/argv.js";
 import { captureLog } from "@aui.io/apollo-core/api/capture.js";
-import { registerEnv } from "./commands/env.js";
 import { registerAuth } from "./commands/auth.js";
 import { registerBundles } from "./commands/bundles.js";
-import { registerCurl } from "./commands/curl.js";
 import { registerDoctor } from "./commands/doctor.js";
 import { registerHierarchy } from "./commands/hierarchy.js";
 import { registerOperate } from "./commands/operate.js";
@@ -21,7 +19,7 @@ import { ConfigError, toCliError } from "@aui.io/apollo-core/errors/index.js";
 import { CLI_VERSION } from "./meta.js";
 import { Output } from "@aui.io/apollo-core/output/index.js";
 import { renderWelcome, welcomeData } from "./output/welcome.js";
-export function createProgram(state = {}) {
+export function createProgram(state = {}, extensions = []) {
     const program = new Command()
         .name("apollo")
         .description("Manage and operate Apollo agents")
@@ -82,9 +80,7 @@ export function createProgram(state = {}) {
     };
     registerStatus(program, runtime);
     registerDoctor(program, runtime);
-    registerCurl(program, runtime);
     registerUpgrade(program, runtime);
-    registerEnv(program, runtime);
     registerProfile(program, runtime);
     registerAuth(program, runtime);
     registerHierarchy(program, runtime);
@@ -95,11 +91,13 @@ export function createProgram(state = {}) {
     registerVault(program, runtime);
     registerKb(program, runtime);
     registerShellInit(program);
+    for (const extension of extensions)
+        extension(program, runtime);
     return program;
 }
-export async function main(argv = process.argv) {
+export async function main(argv = process.argv, extensions = []) {
     const state = {};
-    const program = createProgram(state);
+    const program = createProgram(state, extensions);
     try {
         await program.parseAsync(normalizeArgv(argv));
         // Commands may set a non-zero exit code without aborting (doctor's

package/node_modules/@aui.io/apollo-cli/dist/src/index.js.map

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

package/node_modules/@aui.io/apollo-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aui.io/apollo-cli",
-  "version": "0.1.43",
+  "version": "0.1.47",
   "description": "Command-line client for the Apollo runtime",
   "type": "module",
   "engines": {
@@ -10,7 +10,12 @@
     "apollo": "./bin/apollo.js"
   },
   "exports": {
-    "./bin/apollo.js": "./bin/apollo.js"
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./bin/apollo.js": "./bin/apollo.js",
+    "./dist/*": "./dist/*"
   },
   "files": [
     "bin",
@@ -28,12 +33,12 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@aui.io/apollo-core": "0.1.43",
+    "@aui.io/apollo-core": "0.1.47",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1"
   },
   "optionalDependencies": {
-    "@aui.io/apollo-tui": "0.1.43"
+    "@aui.io/apollo-tui": "0.1.47"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",

package/node_modules/@aui.io/apollo-core/dist/src/api/capture.d.ts

@@ -5,18 +5,28 @@ export interface CaptureSink {
 }
 export declare function defaultCapturePath(): string;
 export declare class CaptureLog implements CaptureSink {
-    private readonly filePath?;
     private entries;
     private readonly listeners;
     /** Per-write suffix — see `persist`. */
     private writeSeq;
-    /** No path = default file with the test-env guard; a string pins it. */
-    constructor(filePath?: string | undefined);
+    /** Where flushes land — unset means in-memory only (the default). */
+    private target?;
+    /** No path = in-memory only; a string turns persistence on from birth. */
+    constructor(filePath?: string);
+    /**
+     * Turn on file persistence — the replay lane. A distribution that wants
+     * requests to survive the process calls this once at startup; no
+     * argument means the default path.
+     */
+    persistTo(filePath?: string): void;
     /** Stable reference between mutations — safe for useSyncExternalStore. */
     snapshot: () => readonly RequestCapture[];
     subscribe: (listener: () => void) => (() => void);
     add(entry: RequestCapture): Promise<void>;
     private persist;
 }
-/** The one log — module-level so the CLI process and TUI session share it. */
+/**
+ * The one log — module-level so the CLI process and TUI session share it.
+ * In-memory only until a distribution opts into persistence at startup.
+ */
 export declare const captureLog: CaptureLog;

package/node_modules/@aui.io/apollo-core/dist/src/api/capture.js

@@ -11,10 +11,10 @@
  *   - the TUI activity drawer subscribes for its live "api requests" tail
  *
  * Entries arrive already redacted (transport.ts) — nothing here may ever
- * see a raw secret. Persistence mirrors the old per-transport behavior:
- * atomic tmp+rename, dir 0700 / file 0600, best-effort (a failed write can
- * never fail an API request), and disabled under NODE_ENV=test unless a
- * path is pinned explicitly.
+ * see a raw secret. The log is in-memory by default; file persistence is
+ * opt-in (`persistTo`), so the stock build leaves nothing in `~/.apollo`.
+ * When enabled, writes are atomic tmp+rename, dir 0700 / file 0600, and
+ * best-effort (a failed write can never fail an API request).
  */
 import { mkdir, rename, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
@@ -25,14 +25,23 @@ export function defaultCapturePath() {
     return path.join(homedir(), ".apollo", "last-requests.json");
 }
 export class CaptureLog {
-    filePath;
     entries = [];
     listeners = new Set();
     /** Per-write suffix — see `persist`. */
     writeSeq = 0;
-    /** No path = default file with the test-env guard; a string pins it. */
+    /** Where flushes land — unset means in-memory only (the default). */
+    target;
+    /** No path = in-memory only; a string turns persistence on from birth. */
     constructor(filePath) {
-        this.filePath = filePath;
+        this.target = filePath;
+    }
+    /**
+     * Turn on file persistence — the replay lane. A distribution that wants
+     * requests to survive the process calls this once at startup; no
+     * argument means the default path.
+     */
+    persistTo(filePath = defaultCapturePath()) {
+        this.target = filePath;
     }
     /** Stable reference between mutations — safe for useSyncExternalStore. */
     snapshot = () => this.entries;
@@ -47,8 +56,7 @@ export class CaptureLog {
         await this.persist();
     }
     async persist() {
-        const target = this.filePath ??
-            (process.env.NODE_ENV === "test" ? undefined : defaultCapturePath());
+        const target = this.target;
         if (target === undefined)
             return;
         try {
@@ -70,6 +78,9 @@ export class CaptureLog {
         }
     }
 }
-/** The one log — module-level so the CLI process and TUI session share it. */
+/**
+ * The one log — module-level so the CLI process and TUI session share it.
+ * In-memory only until a distribution opts into persistence at startup.
+ */
 export const captureLog = new CaptureLog();
 //# sourceMappingURL=capture.js.map

package/node_modules/@aui.io/apollo-core/dist/src/api/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/api/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,+EAA+E;AAC/E,MAAM,WAAW,GAAG,GAAG,CAAC;AAOxB,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,OAAO,UAAU;IAOQ;IANrB,OAAO,GAA8B,EAAE,CAAC;IAC/B,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACnD,wCAAwC;IAChC,QAAQ,GAAG,CAAC,CAAC;IAErB,wEAAwE;IACxE,YAA6B,QAAiB;QAAjB,aAAQ,GAAR,QAAQ,CAAS;IAAG,CAAC;IAElD,0EAA0E;IAC1E,QAAQ,GAAG,GAA8B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;IAEzD,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ;YACb,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACvE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,oEAAoE;YACpE,oEAAoE;YACpE,qEAAqE;YACrE,sEAAsE;YACtE,iEAAiE;YACjE,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,QAAQ,MAAM,CAAC;YACpE,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBACvE,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,KAAK;aACZ,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/api/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,+EAA+E;AAC/E,MAAM,WAAW,GAAG,GAAG,CAAC;AAOxB,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,OAAO,UAAU;IACb,OAAO,GAA8B,EAAE,CAAC;IAC/B,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACnD,wCAAwC;IAChC,QAAQ,GAAG,CAAC,CAAC;IACrB,qEAAqE;IAC7D,MAAM,CAAU;IAExB,0EAA0E;IAC1E,YAAY,QAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAQ,GAAG,kBAAkB,EAAE;QACvC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,0EAA0E;IAC1E,QAAQ,GAAG,GAA8B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;IAEzD,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,oEAAoE;YACpE,oEAAoE;YACpE,qEAAqE;YACrE,sEAAsE;YACtE,iEAAiE;YACjE,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,QAAQ,MAAM,CAAC;YACpE,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBACvE,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,KAAK;aACZ,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/node_modules/@aui.io/apollo-core/dist/src/api/lane.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The engine-page lane — which flavor of the runtime's authoring surface
+ * (the AGENTS page and the skills index) this process asks for.
+ *
+ * The stock build sends no query parameters at all and relies on the
+ * server's defaults; the only client-side rule is the echo check — a page
+ * whose echoed audience is not one this build accepts is refused rather
+ * than written into a checkout (that is how an older engine that defaults
+ * to a different page gets caught). A distribution can pin its own lane at
+ * startup, before the first pull, and every fetch after that carries it.
+ */
+export interface PageLane {
+    /** Extra query parameters for `/agents-md` and `/skills` reads. */
+    query: Readonly<Record<string, string>>;
+    /** The audience echoes this build accepts on the AGENTS page. */
+    acceptedEchoes: readonly string[];
+}
+export declare function setPageLane(next: PageLane): void;
+export declare function pageLane(): PageLane;

package/node_modules/@aui.io/apollo-core/dist/src/api/lane.js

@@ -0,0 +1,26 @@
+/**
+ * The engine-page lane — which flavor of the runtime's authoring surface
+ * (the AGENTS page and the skills index) this process asks for.
+ *
+ * The stock build sends no query parameters at all and relies on the
+ * server's defaults; the only client-side rule is the echo check — a page
+ * whose echoed audience is not one this build accepts is refused rather
+ * than written into a checkout (that is how an older engine that defaults
+ * to a different page gets caught). A distribution can pin its own lane at
+ * startup, before the first pull, and every fetch after that carries it.
+ */
+let lane = {
+    query: {},
+    // `headless` is the pre-rename spelling of the same page on older engines.
+    acceptedEchoes: ["public", "headless"],
+};
+export function setPageLane(next) {
+    lane = {
+        query: Object.freeze({ ...next.query }),
+        acceptedEchoes: [...next.acceptedEchoes],
+    };
+}
+export function pageLane() {
+    return lane;
+}
+//# sourceMappingURL=lane.js.map

package/node_modules/@aui.io/apollo-core/dist/src/api/lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane.js","sourceRoot":"","sources":["../../../src/api/lane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,IAAI,IAAI,GAAa;IACnB,KAAK,EAAE,EAAE;IACT,2EAA2E;IAC3E,cAAc,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;CACvC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,IAAI,GAAG;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACvC,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/node_modules/@aui.io/apollo-core/dist/src/api/runtime-api.d.ts

@@ -62,11 +62,10 @@ export interface SkillFile {
 export interface AgentsMd {
     content: string;
     /**
-     * Which page this is — echoed by engines that ship per-audience pages, in
-     * the spelling the caller asked with (`public`, or `headless` on engines
-     * that predate the rename). Absent on older engines, which ignore the
-     * query and always serve the internal page; a public caller MUST check
-     * this before trusting the content.
+     * Which page this is — echoed by engines that ship per-audience pages
+     * (`public`, or `headless` on engines that predate the rename). Absent on
+     * older engines that serve a single page; a caller MUST check this
+     * against the lane's accepted echoes before trusting the content.
      */
     audience?: string;
 }
@@ -116,25 +115,20 @@ export declare class RuntimeApiClient {
     listMessages(threadId: string): Promise<Message[]>;
     threadTrace(threadId: string): Promise<RuntimeTrace[]>;
     interactionTrace(interactionId: string): Promise<RuntimeTrace>;
-    interactionDebug(interactionId: string): Promise<Record<string, unknown>>;
     listSkills(): Promise<SkillIndexItem[]>;
     getSkill(skillId: string, file?: string): Promise<SkillFile>;
     /**
-     * The checkout's standing brief — the self-contained public page, which is
-     * the only page this wire serves (the public floor,
-     * docs/authoring-modes-design.md §3.3; the internal page ships inside the
-     * runtime package and never rides this endpoint). Not a skill: it belongs
-     * at the checkout root, so it has its own endpoint rather than a slot in
-     * the skills index.
+     * The checkout's standing brief. Not a skill: it belongs at the checkout
+     * root, so it has its own endpoint rather than a slot in the skills index.
      *
-     * Compatibility, oldest engine first: engines older than the endpoint
-     * answer 404; engines older than the public page ignore the query and
-     * serve their internal page — see `AgentsMd.audience`, the echo that
-     * unmasks them; engines older than the RENAME validate the audience
-     * against the legacy spellings and refuse `public` with a 422 — those get
-     * one retry as `headless`, the same page under its pre-rename name.
+     * The stock build sends no query and takes the server's default page;
+     * which pages this build accepts is the lane's echo check, applied by the
+     * caller (skills/agents-page.ts) — a page whose echoed audience is not
+     * accepted is refused rather than written into a checkout, which is how
+     * an engine that defaults to a different page gets caught. Engines older
+     * than the endpoint answer 404.
      */
-    getAgentsMd(audience?: "public"): Promise<AgentsMd>;
+    getAgentsMd(): Promise<AgentsMd>;
     getProgramSchemas(file?: string): Promise<Record<string, unknown>>;
     validateProgram(bundle: Record<string, unknown>): Promise<{
         valid: boolean;

package/node_modules/@aui.io/apollo-core/dist/src/api/runtime-api.js

@@ -1,4 +1,4 @@
-import { ApiError } from "../errors/index.js";
+import { pageLane } from "./lane.js";
 /**
  * A send is synchronous on the wire — the response IS the agent's turn, and
  * normal turn latency can exceed the 60s transport default (REPORTS-27).
@@ -81,11 +81,10 @@ export class RuntimeApiClient {
     interactionTrace(interactionId) {
         return this.http.request(`/messaging/v1/interactions/${interactionId}/trace`);
     }
-    interactionDebug(interactionId) {
-        return this.http.request(`/api/v1/interactions/${interactionId}/debug`);
-    }
     listSkills() {
-        return this.http.request("/api/v1/skills");
+        return this.http.request("/api/v1/skills", {
+            query: { ...pageLane().query },
+        });
     }
     getSkill(skillId, file) {
         return this.http.request(`/api/v1/skills/${encodeURIComponent(skillId)}`, {
@@ -93,34 +92,20 @@ export class RuntimeApiClient {
         });
     }
     /**
-     * The checkout's standing brief — the self-contained public page, which is
-     * the only page this wire serves (the public floor,
-     * docs/authoring-modes-design.md §3.3; the internal page ships inside the
-     * runtime package and never rides this endpoint). Not a skill: it belongs
-     * at the checkout root, so it has its own endpoint rather than a slot in
-     * the skills index.
+     * The checkout's standing brief. Not a skill: it belongs at the checkout
+     * root, so it has its own endpoint rather than a slot in the skills index.
      *
-     * Compatibility, oldest engine first: engines older than the endpoint
-     * answer 404; engines older than the public page ignore the query and
-     * serve their internal page — see `AgentsMd.audience`, the echo that
-     * unmasks them; engines older than the RENAME validate the audience
-     * against the legacy spellings and refuse `public` with a 422 — those get
-     * one retry as `headless`, the same page under its pre-rename name.
+     * The stock build sends no query and takes the server's default page;
+     * which pages this build accepts is the lane's echo check, applied by the
+     * caller (skills/agents-page.ts) — a page whose echoed audience is not
+     * accepted is refused rather than written into a checkout, which is how
+     * an engine that defaults to a different page gets caught. Engines older
+     * than the endpoint answer 404.
      */
-    async getAgentsMd(audience) {
-        try {
-            return await this.http.request("/api/v1/agents-md", {
-                query: { audience },
-            });
-        }
-        catch (error) {
-            if (audience && error instanceof ApiError && error.status === 422) {
-                return this.http.request("/api/v1/agents-md", {
-                    query: { audience: "headless" },
-                });
-            }
-            throw error;
-        }
+    getAgentsMd() {
+        return this.http.request("/api/v1/agents-md", {
+            query: { ...pageLane().query },
+        });
     }
     getProgramSchemas(file) {
         return this.http.request("/api/v1/programs/schema", {