@skrr-ai/cli 0.1.31 → 0.1.33

package/dist/commands/code/oversky-agent.js

@@ -1,16 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const auth_core_1 = require("@skrr-ai/auth-core");
 const auth_core_init_1 = require("../../lib/auth-core-init");
 const config_1 = require("../../lib/config");
-const sky_code_agent_1 = require("../../lib/sky-code-agent");
-const sky_code_managed_1 = require("../../lib/sky-code-managed");
+const first_party_harness_agent_1 = require("../../lib/first-party-harness-agent");
+const first_party_harness_managed_1 = require("../../lib/first-party-harness-managed");
 /**
  * `skrr code skrr-agent` — read and write the agent a managed session runs as.
  *
  * ── Why the name carries the `oversky-` prefix ─────────────────────────────
  *
- * The engine owns `agent`: `sky-code agent` is its own agent-management command.
+ * The engine owns `agent`: the engine binary's `agent` is its own agent-management command.
  * `skrr code` forwards argv VERBATIM, and oclif's spaced-topic dispatch collates
  * `code agent …` into a command id BEFORE the forwarding command ever runs — so
  * naming this `code:agent` would have silently taken that name away from the
@@ -23,7 +24,8 @@ const sky_code_managed_1 = require("../../lib/sky-code-managed");
  *
  * ── Why the setting needed a command at all ────────────────────────────────
  *
- * `skyCodeAgentId` predates this and had no way to be written: nothing in
+ * The setting (`AGENT_CONFIG_KEY`, then under an older product-named key)
+ * predates this and had no way to be written: nothing in
  * `cli/src` called `saveConfig` with it, so the refusal that told users to set it
  * was pointing at a file it expected them to hand-edit — and `skrr logout` then
  * rebuilt the config without the key and dropped it silently.
@@ -38,7 +40,7 @@ class CodeOverskyAgent extends core_1.Command {
     // path this file has and stays reachable, because it is in scripts and in
     // muscle memory.
     static aliases = ['code:skrr-agent'];
-    static description = 'Show or set the skrr agent a managed skrr Code session is attributed to';
+    static description = `Show or set the skrr agent a managed ${auth_core_1.FIRST_PARTY_HARNESS.displayName} session is attributed to`;
     static examples = [
         '<%= config.bin %> code skrr-agent',
         '<%= config.bin %> code skrr-agent --set Engineer',
@@ -56,7 +58,7 @@ class CodeOverskyAgent extends core_1.Command {
             exclusive: ['clear', 'show'],
         }),
         clear: core_1.Flags.boolean({
-            description: `Remove the stored "${sky_code_managed_1.AGENT_CONFIG_KEY}" setting`,
+            description: `Remove the stored "${first_party_harness_managed_1.AGENT_CONFIG_KEY}" setting`,
             exclusive: ['set', 'show'],
         }),
         create: core_1.Flags.boolean({
@@ -73,7 +75,7 @@ class CodeOverskyAgent extends core_1.Command {
         // 401 reported as `agent-lookup-failed`, which reads like a server problem
         // and sends them to re-login when they are already logged in.
         //
-        // `sky-code-broker.ts` does the same thing for the same reason before its
+        // `first-party-harness-broker.ts` does the same thing for the same reason before its
         // own first API call; this command is simply the second caller on that path.
         if (!flags.clear) {
             await (0, auth_core_init_1.prefetchCliAuth)();
@@ -93,7 +95,7 @@ class CodeOverskyAgent extends core_1.Command {
         }
         let agent;
         try {
-            agent = await (0, sky_code_agent_1.setConfiguredAgentId)(trimmed);
+            agent = await (0, first_party_harness_agent_1.setConfiguredAgentId)(trimmed);
         }
         catch (err) {
             this.fail(err);
@@ -102,18 +104,18 @@ class CodeOverskyAgent extends core_1.Command {
             this.logJson({ action: 'set', agent: summarize(agent), configPath: (0, config_1.getConfigPath)() });
             return;
         }
-        this.log(`skrr Code will run as ${describe(agent)}.`);
+        this.log(`${auth_core_1.FIRST_PARTY_HARNESS.displayName} will run as ${describe(agent)}.`);
         this.log(`Saved to ${(0, config_1.getConfigPath)()}.`);
     }
     runClear(json) {
-        const previous = (0, sky_code_agent_1.clearConfiguredAgentId)();
+        const previous = (0, first_party_harness_agent_1.clearConfiguredAgentId)();
         if (json) {
             this.logJson({ action: 'clear', cleared: previous ?? null, configPath: (0, config_1.getConfigPath)() });
             return;
         }
         this.log(previous
-            ? `Cleared "${sky_code_managed_1.AGENT_CONFIG_KEY}" (was ${previous}).`
-            : `No "${sky_code_managed_1.AGENT_CONFIG_KEY}" was set; nothing to clear.`);
+            ? `Cleared "${first_party_harness_managed_1.AGENT_CONFIG_KEY}" (was ${previous}).`
+            : `No "${first_party_harness_managed_1.AGENT_CONFIG_KEY}" was set; nothing to clear.`);
     }
     /**
      * Report what a session WOULD resolve to.
@@ -121,18 +123,18 @@ class CodeOverskyAgent extends core_1.Command {
      * `allowCreate` is off by default, and that is the whole design of this branch:
      * a command whose job is to answer a question must not create a server-side
      * agent as a side effect of being asked. Without the guard, `skrr code
-     * oversky-agent` — the bare, most likely invocation, and the one a user runs to
+     * skrr-agent` — the bare, most likely invocation, and the one a user runs to
      * find out what is going on — would mint the default agent it then reported,
      * making the answer true only because the question was asked.
      */
     async runShow(json, allowCreate) {
-        const stored = (0, sky_code_agent_1.readConfiguredAgentId)();
+        const stored = (0, first_party_harness_agent_1.readConfiguredAgentId)();
         let agent;
         try {
-            agent = await (0, sky_code_agent_1.resolveSkyCodeAgent)(undefined, {}, { createDefault: allowCreate });
+            agent = await (0, first_party_harness_agent_1.resolveFirstPartyHarnessAgent)(undefined, {}, { createDefault: allowCreate });
         }
         catch (err) {
-            if (json && err instanceof sky_code_agent_1.SkyCodeAgentError) {
+            if (json && err instanceof first_party_harness_agent_1.FirstPartyHarnessAgentError) {
                 this.logJson({
                     action: 'show',
                     agent: null,
@@ -164,19 +166,19 @@ class CodeOverskyAgent extends core_1.Command {
         // people to pin it would be noise on every run.
         if (agent.source === 'sole-agent' && !stored) {
             this.log(`\nThis changes if you create another agent. To pin it: ` +
-                `skrr code skrr-agent --set ${agent.id}`);
+                `${auth_core_1.FIRST_PARTY_HARNESS.command} skrr-agent --set ${agent.id}`);
         }
     }
     /**
      * Report a resolution failure as the refusal it is.
      *
-     * `SkyCodeAgentError` messages are already written to be actionable — they name
+     * `FirstPartyHarnessAgentError` messages are already written to be actionable — they name
      * the flag, the config key, and the candidates — so this prints the message
      * rather than wrapping it in a second sentence that would push the useful part
      * off the first line.
      */
     fail(err) {
-        if (err instanceof sky_code_agent_1.SkyCodeAgentError) {
+        if (err instanceof first_party_harness_agent_1.FirstPartyHarnessAgentError) {
             this.error(err.message, { exit: 1, code: err.code });
         }
         throw err;
@@ -192,13 +194,13 @@ function describe(agent) {
 function explainSource(agent) {
     switch (agent.source) {
         case 'flag':
-            return `${sky_code_managed_1.SKRR_AGENT_FLAG} on the command line`;
+            return `${first_party_harness_managed_1.SKRR_AGENT_FLAG} on the command line`;
         case 'config':
-            return `"${sky_code_managed_1.AGENT_CONFIG_KEY}" in ${(0, config_1.getConfigPath)()}`;
+            return `"${first_party_harness_managed_1.AGENT_CONFIG_KEY}" in ${(0, config_1.getConfigPath)()}`;
         case 'sole-agent':
             return 'the only agent you own — not pinned, so this changes if you create another';
         case 'default-agent':
-            return 'your skrr Code default, used automatically because nothing above was set';
+            return `your ${auth_core_1.FIRST_PARTY_HARNESS.displayName} default, used automatically because nothing above was set`;
         default:
             return agent.source;
     }

package/dist/commands/code/run.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const auth_core_1 = require("@skrr-ai/auth-core");
 const index_1 = require("./index");
 /**
  * `skrr code run` — headless execution.
@@ -9,7 +10,7 @@ const index_1 = require("./index");
  * engine's own code so CI can branch on it.
  */
 class CodeRun extends core_1.Command {
-    static description = 'Run skrr Code headlessly on a single prompt';
+    static description = `Run ${auth_core_1.FIRST_PARTY_HARNESS.displayName} headlessly on a single prompt`;
     static strict = false;
     static examples = [
         '<%= config.bin %> code run "add a regression test for the parser"',

package/dist/commands/harnesses/list.d.ts

@@ -133,11 +133,19 @@ export type HarnessesJson = {
  * it is deliberate, so `.harnesses[0]` is the row you almost always want.
  */
 export declare function buildHarnessesJson(selection: HarnessSelection, filters: HarnessesFilters): HarnessesJson;
+/**
+ * Rows with the provider in its CANONICAL spelling.
+ *
+ * A row registered by a daemon on either side of a rename may carry either
+ * spelling of the first-party harness, and output — the table and `--json` alike —
+ * prints one, so a script grouping by provider never sees one harness as two.
+ */
+export declare function canonicalHarnessRows(rows: readonly HarnessRow[]): HarnessRow[];
 /** `YYYY-MM-DD HH:MM` — the staleness of an offline row is the whole reason to show it. */
 /**
  * `skrr harnesses list`
  *
- * List the harnesses (claude/codex/opencode/openclaw/sky-code) registered by
+ * List the harnesses (claude/codex/opencode/openclaw/the first-party harness) registered by
  * the caller's connected daemon(s) — one row per (daemon, provider) — and
  * surface the `_id` that `agents attach-harness` pins.
  *

package/dist/commands/harnesses/list.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalHarnessRow = isLocalHarnessRow;
 exports.selectHarnessRows = selectHarnessRows;
 exports.buildHarnessesJson = buildHarnessesJson;
+exports.canonicalHarnessRows = canonicalHarnessRows;
 const core_1 = require("@oclif/core");
+const auth_core_1 = require("@skrr-ai/auth-core");
 const base_command_1 = require("../../base-command");
 const api_fetch_1 = require("../../lib/api-fetch");
 const format_1 = require("../../lib/format");
+const harness_provider_input_1 = require("../../lib/harness-provider-input");
 /**
  * Products skrr provisions and owns. A row that says it is one of these is
  * cloud, whatever `harnessLocation` reads.
@@ -124,6 +127,21 @@ function buildHarnessesJson(selection, filters) {
         },
     };
 }
+/**
+ * Rows with the provider in its CANONICAL spelling.
+ *
+ * A row registered by a daemon on either side of a rename may carry either
+ * spelling of the first-party harness, and output — the table and `--json` alike —
+ * prints one, so a script grouping by provider never sees one harness as two.
+ */
+function canonicalHarnessRows(rows) {
+    return rows.map((row) => {
+        if (typeof row.provider !== 'string')
+            return row;
+        const provider = (0, harness_provider_input_1.canonicalHarnessInput)(row.provider);
+        return provider === row.provider ? row : { ...row, provider };
+    });
+}
 /** Online first, then most-recently-seen first — the row you want is row 1. */
 function compareHarnessRows(a, b) {
     const aOffline = a.status === 'online' ? 0 : 1;
@@ -140,7 +158,7 @@ function lastSeenMs(row) {
 /**
  * `skrr harnesses list`
  *
- * List the harnesses (claude/codex/opencode/openclaw/sky-code) registered by
+ * List the harnesses (claude/codex/opencode/openclaw/the first-party harness) registered by
  * the caller's connected daemon(s) — one row per (daemon, provider) — and
  * surface the `_id` that `agents attach-harness` pins.
  *
@@ -149,7 +167,7 @@ function lastSeenMs(row) {
  * previously undiscoverable.
  */
 class HarnessesList extends base_command_1.BaseCommand {
-    static description = 'List your harnesses — your local Claude Code, Codex, skrr Code, one row per (machine, provider). The id here is what `agents attach-harness` pins. Online only unless --all.';
+    static description = `List your harnesses — your local Claude Code, Codex, ${auth_core_1.FIRST_PARTY_HARNESS.displayName}, one row per (machine, provider). The id here is what \`agents attach-harness\` pins. Online only unless --all.`;
     static examples = [
         '<%= config.bin %> harnesses list',
         '<%= config.bin %> harnesses list --provider claude',
@@ -172,7 +190,7 @@ class HarnessesList extends base_command_1.BaseCommand {
             exclusive: ['status', 'online'],
         }),
         provider: core_1.Flags.string({
-            description: 'Filter by provider (e.g. claude, codex, opencode, openclaw).',
+            description: `Filter by provider (e.g. claude, codex, opencode, openclaw, ${auth_core_1.FIRST_PARTY_HARNESS.provider}).`,
         }),
         daemon: core_1.Flags.string({
             description: 'Filter by daemon id, matching any substring — e.g. the machine hash in daemon_<hash>_<source>_<profile>.',
@@ -193,11 +211,14 @@ class HarnessesList extends base_command_1.BaseCommand {
         // mode. Materialize that default before the request so JSON cannot quietly
         // return every historical offline row while the table shows seven live ones.
         const status = flags.online ? 'online' : (flags.status ?? (flags.all ? undefined : 'online'));
+        // Any spelling of the first-party harness filters the same rows; the server is
+        // asked for the canonical one, which it matches against every stored spelling.
+        const provider = flags.provider ? (0, harness_provider_input_1.canonicalHarnessInput)(flags.provider) : undefined;
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
-        if (flags.provider)
-            params.set('provider', flags.provider);
+        if (provider)
+            params.set('provider', provider);
         const query = params.toString() ? `?${params.toString()}` : '';
         let res;
         try {
@@ -208,7 +229,7 @@ class HarnessesList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
-        const selection = selectHarnessRows(res.harnesses ?? [], {
+        const selection = selectHarnessRows(canonicalHarnessRows(res.harnesses ?? []), {
             local: flags.local,
             daemon: flags.daemon,
             limit: flags.limit,
@@ -218,7 +239,7 @@ class HarnessesList extends base_command_1.BaseCommand {
             const payload = buildHarnessesJson(selection, {
                 local: flags.local,
                 status: status ?? null,
-                provider: flags.provider ?? null,
+                provider: provider ?? null,
                 daemon: flags.daemon ?? null,
                 limit: flags.limit ?? null,
             });

package/dist/commands/harnesses/show.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
+const harness_provider_input_1 = require("../../lib/harness-provider-input");
 const harnesses_1 = require("../../lib/harnesses");
 const api_fetch_1 = require("../../lib/api-fetch");
 class HarnessesShow extends base_command_1.BaseCommand {
@@ -42,7 +43,11 @@ class HarnessesShow extends base_command_1.BaseCommand {
             this.handleApiError(err);
             return;
         }
-        const harness = response?.harness;
+        const stored = response?.harness;
+        // Canonical spelling in every output, whichever spelling the row was stored under.
+        const harness = stored && typeof stored.provider === 'string'
+            ? { ...stored, provider: (0, harness_provider_input_1.canonicalHarnessInput)(stored.provider) }
+            : stored;
         if (!harness) {
             this.error(`No harness ${args.harness}.`, { exit: 1 });
             return;
@@ -60,7 +65,7 @@ class HarnessesShow extends base_command_1.BaseCommand {
         this.log(`  status      ${harness.status ?? 'unknown'}`);
         // Only for the claude provider. The daemon stamps `claudeEngine` on every
         // harness it registers, so printing it whenever it is set labels a
-        // `sky-code` or `codex` row with how CLAUDE Code would run — a fact about a
+        // first-party harness or `codex` row with how CLAUDE Code would run — a fact about a
         // different harness on the same machine.
         if (harness.provider === 'claude' && harness.claudeEngine) {
             this.log(`  driven as   ${harness.claudeEngine}  (how Claude Code runs here)`);

package/dist/commands/instructions/install.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const auth_core_1 = require("@skrr-ai/auth-core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const daemon_target_1 = require("../../lib/daemon-target");
+const harness_provider_input_1 = require("../../lib/harness-provider-input");
 const prompt_1 = require("../../lib/prompt");
+/** The providers a managed instruction can target, canonical spellings. */
+const MANAGED_INSTRUCTION_PROVIDERS = ['claude', 'codex', auth_core_1.FIRST_PARTY_HARNESS.provider];
 class InstructionsInstall extends base_command_1.BaseCommand {
     static description = 'Opt in a daemon target to ongoing managed instruction reconciliation';
     static flags = {
@@ -19,10 +23,13 @@ class InstructionsInstall extends base_command_1.BaseCommand {
             description: 'Daemon ID; defaults to this machine on a Dedicated Runtime, otherwise inferred when exactly one daemon is online',
         }),
         provider: core_1.Flags.string({
+            // Every accepted spelling of the first-party harness is a valid option, so a
+            // script written against either spelling still parses; the command
+            // normalises to canonical before anything leaves the CLI.
             description: 'Provider to manage (repeatable)',
-            options: ['claude', 'codex', 'sky-code'],
+            options: (0, harness_provider_input_1.harnessFlagOptions)(MANAGED_INSTRUCTION_PROVIDERS),
             multiple: true,
-            default: ['claude', 'codex', 'sky-code'],
+            default: MANAGED_INSTRUCTION_PROVIDERS,
         }),
         scope: core_1.Flags.string({ description: 'global or project', options: ['global', 'project'] }),
         project: core_1.Flags.string({ description: 'Absolute project path on the daemon machine' }),
@@ -42,6 +49,9 @@ class InstructionsInstall extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(InstructionsInstall);
+        // Canonical, deduplicated: `--provider <alias> --provider <canonical>` is one
+        // target, not two, and the server stores the canonical spelling.
+        const providers = (0, harness_provider_input_1.canonicalHarnessInputs)(flags.provider);
         const scope = (flags.scope || (flags.project ? 'project' : 'global'));
         if (scope === 'project' && !flags.project) {
             this.error('--project is required for project scope', { exit: 2 });
@@ -74,7 +84,7 @@ class InstructionsInstall extends base_command_1.BaseCommand {
         catch (error) {
             this.handleApiError(error);
         }
-        if (flags.provider.includes('codex') && Buffer.byteLength(previewBody, 'utf8') > 30 * 1024) {
+        if (providers.includes('codex') && Buffer.byteLength(previewBody, 'utf8') > 30 * 1024) {
             this.error('Codex managed instruction bodies are limited to 30 KiB; no targets were created', { exit: 2 });
         }
         if (!flags.json) {
@@ -86,13 +96,13 @@ class InstructionsInstall extends base_command_1.BaseCommand {
         const teamWarning = scope === 'project' && flags.mode === 'team'
             ? ' Team mode writes to repository files and may affect every contributor.'
             : '';
-        const confirmed = await (0, prompt_1.confirmDestructive)(`Authorize continuous ${flags.provider.join(', ')} reconciliation on this target?${teamWarning}`, flags.yes);
+        const confirmed = await (0, prompt_1.confirmDestructive)(`Authorize continuous ${providers.join(', ')} reconciliation on this target?${teamWarning}`, flags.yes);
         if (!confirmed)
             return this.log('Aborted.');
         const daemonId = await this.resolveDaemon(flags.daemon);
         const results = [];
         try {
-            for (const provider of flags.provider) {
+            for (const provider of providers) {
                 results.push(await data_provider_1.dataService.createManagedInstructionTarget({
                     daemonId,
                     bundleId: flags.bundle,
@@ -112,7 +122,7 @@ class InstructionsInstall extends base_command_1.BaseCommand {
         if (flags.json)
             return this.log(JSON.stringify(results, null, 2));
         for (const result of results) {
-            this.log(`Install queued: ${result.target.provider} ${result.target.scope}${result.target.projectPath ? ` ${result.target.projectPath}` : ''} (${result.target.id})`);
+            this.log(`Install queued: ${(0, harness_provider_input_1.canonicalHarnessInput)(result.target.provider)} ${result.target.scope}${result.target.projectPath ? ` ${result.target.projectPath}` : ''} (${result.target.id})`);
         }
     }
     /**

package/dist/commands/learning/delete.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base-command';
+export default class LearningDelete extends BaseCommand {
+    static description: string;
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/learning/delete.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const api_fetch_1 = require("../../lib/api-fetch");
+class LearningDelete extends base_command_1.BaseCommand {
+    static description = 'Delete your governed adaptive-learning data and disable both consents';
+    static flags = {
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Confirm deletion without prompting' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LearningDelete);
+        if (!flags.yes &&
+            !(await this.confirm('Delete all adaptive-learning state, episodes, and outcomes? [y/N] '))) {
+            return;
+        }
+        let result;
+        try {
+            result = await (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/data', {
+                method: 'DELETE',
+                body: { confirm: 'DELETE' },
+                credential: this.resolvedCredential,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json)
+            this.log(JSON.stringify(result, null, 2));
+        else {
+            this.log(`Deletion complete (${result.receiptId}): states=${result.removedStates}, ` +
+                `episodes=${result.removedEpisodes}, observations=${result.removedObservations}, ` +
+                `legacy mirrors=${result.removedLegacyMirrors}.`);
+        }
+    }
+}
+exports.default = LearningDelete;

package/dist/commands/learning/export.d.ts

@@ -0,0 +1,5 @@
+import { BaseCommand } from '../../base-command';
+export default class LearningExport extends BaseCommand {
+    static description: string;
+    run(): Promise<void>;
+}

package/dist/commands/learning/export.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_command_1 = require("../../base-command");
+const api_fetch_1 = require("../../lib/api-fetch");
+class LearningExport extends base_command_1.BaseCommand {
+    static description = 'Export your adaptive-learning consent, state, episodes, and outcomes as JSON';
+    async run() {
+        this.requireAuth();
+        await this.parse(LearningExport);
+        let result;
+        try {
+            result = await (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/export', {
+                credential: this.resolvedCredential,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = LearningExport;

package/dist/commands/learning/reset.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base-command';
+export default class LearningReset extends BaseCommand {
+    static description: string;
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/learning/reset.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const api_fetch_1 = require("../../lib/api-fetch");
+class LearningReset extends base_command_1.BaseCommand {
+    static description = 'Reset learned serving state while retaining governed evidence';
+    static flags = {
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Confirm reset without prompting' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LearningReset);
+        if (!flags.yes && !(await this.confirm('Reset all learned serving state? [y/N] ')))
+            return;
+        let result;
+        try {
+            result = await (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/reset', {
+                method: 'POST',
+                credential: this.resolvedCredential,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json)
+            this.log(JSON.stringify(result, null, 2));
+        else {
+            this.log(`Reset complete: removed ${result.removedStates} state(s); generation ${result.stateGeneration}.`);
+        }
+    }
+}
+exports.default = LearningReset;

package/dist/commands/learning/set.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base-command';
+export default class LearningSet extends BaseCommand {
+    static description: string;
+    static flags: {
+        personalization: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'shared-training': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/learning/set.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const api_fetch_1 = require("../../lib/api-fetch");
+const adaptive_learning_1 = require("../../lib/adaptive-learning");
+class LearningSet extends base_command_1.BaseCommand {
+    static description = 'Change personal and shared adaptive-learning consent independently';
+    static flags = {
+        personalization: core_1.Flags.string({
+            description: 'Allow learned preferences for your own agents',
+            options: ['on', 'off'],
+        }),
+        'shared-training': core_1.Flags.string({
+            description: 'Allow permitted content-free evidence to improve shared models',
+            options: ['on', 'off'],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LearningSet);
+        const patch = (0, adaptive_learning_1.consentPatch)({
+            personalization: flags.personalization,
+            sharedTraining: flags['shared-training'],
+        });
+        if (!Object.keys(patch).length) {
+            this.error('Set --personalization, --shared-training, or both.', { exit: 2 });
+        }
+        let result;
+        try {
+            result = await (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/preferences', {
+                method: 'PUT',
+                body: patch,
+                credential: this.resolvedCredential,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log(`Personalization ${result.consent.personalizationAllowed ? 'on' : 'off'}; ` +
+            `shared model training ${result.consent.sharedTrainingAllowed ? 'on' : 'off'}; ` +
+            `generation ${result.consent.stateGeneration}.`);
+        if (result.removedStates > 0)
+            this.log(`Removed ${result.removedStates} stale learned state(s).`);
+    }
+}
+exports.default = LearningSet;

package/dist/commands/learning/status.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from '../../base-command';
+export default class LearningStatus extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/learning/status.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const api_fetch_1 = require("../../lib/api-fetch");
+const adaptive_learning_1 = require("../../lib/adaptive-learning");
+class LearningStatus extends base_command_1.BaseCommand {
+    static description = 'Show adaptive-learning consent, state, and serving fallback';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LearningStatus);
+        let consent;
+        let state;
+        try {
+            [consent, state] = await Promise.all([
+                (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/preferences', {
+                    credential: this.resolvedCredential,
+                }),
+                (0, api_fetch_1.apiFetch)('/api/user/adaptive-learning/state', {
+                    credential: this.resolvedCredential,
+                }),
+            ]);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ consent, state }, null, 2));
+            return;
+        }
+        this.log((0, adaptive_learning_1.formatLearningStatus)(consent, state));
+    }
+}
+exports.default = LearningStatus;