@skrr-ai/cli 0.1.14 → 0.1.15

package/dist/commands/agents/instructions/preview.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+class AgentsInstructionsPreview extends base_command_1.BaseCommand {
+    static description = 'Revalidate and preview the exact custom instructions an Agent composition renders';
+    static examples = [
+        '<%= config.bin %> agents instructions preview <agent-id>',
+        '<%= config.bin %> agents instructions preview --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output preview metadata and text as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsPreview);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let preview;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            preview = await data_provider_1.dataService.previewInstructionComposition(composition);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify({ agentId, ...preview }, null, 2));
+        this.log(`Agent: ${agentId}`);
+        this.log(`Compiled: ${preview.bytes} bytes · ~${preview.estimatedTokens} tokens · ${preview.composition.entries.length} block(s)`);
+        this.log('');
+        this.log(preview.instructions || '(No enabled custom instruction blocks.)');
+        this.log('');
+        this.log('This is behavior guidance only; it does not grant tools, integrations, scope, or approval authority.');
+    }
+}
+exports.default = AgentsInstructionsPreview;

package/dist/commands/agents/instructions/remove.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class AgentsInstructionsRemove extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        instance: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/remove.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const instruction_blocks_1 = require("../../../lib/instruction-blocks");
+class AgentsInstructionsRemove extends base_command_1.BaseCommand {
+    static description = 'Remove one instruction block from an Agent (the library source remains intact)';
+    static examples = [
+        '<%= config.bin %> agents instructions remove library_… --agent <agent-id>',
+    ];
+    static args = {
+        instance: core_1.Args.string({ description: 'Block instance ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsRemove);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(undefined, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let updated;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, (0, instruction_blocks_1.removeEntry)(composition, args.instance));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Removed ${args.instance} from ${agentId}. The reusable library block, if any, was not changed.`);
+    }
+}
+exports.default = AgentsInstructionsRemove;

package/dist/commands/agents/instructions/set.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../../base-command';
+/** Replace a composition atomically — the automation-friendly escape hatch. */
+export default class AgentsInstructionsSet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        empty: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/set.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const prompt_1 = require("../../../lib/prompt");
+/** Replace a composition atomically — the automation-friendly escape hatch. */
+class AgentsInstructionsSet extends base_command_1.BaseCommand {
+    static description = 'Replace an Agent’s instruction composition from JSON (the server validates and compiles it atomically)';
+    static examples = [
+        '<%= config.bin %> agents instructions set <agent-id> --file composition.json',
+        'cat composition.json | <%= config.bin %> agents instructions set --file -',
+        '<%= config.bin %> agents instructions set <agent-id> --empty --yes',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        file: core_1.Flags.string({ description: 'Composition JSON file, or - for stdin' }),
+        empty: core_1.Flags.boolean({ description: 'Remove every custom instruction block' }),
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Required with --empty' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsSet);
+        if (Boolean(flags.file) === Boolean(flags.empty)) {
+            this.error('Provide exactly one of --file or --empty.', { exit: 2 });
+        }
+        if (flags.empty && !flags.yes) {
+            this.error('Refusing to remove all custom instructions without --yes.', { exit: 2 });
+        }
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let composition;
+        try {
+            composition = flags.empty
+                ? { schemaVersion: 1, entries: [] }
+                : (await (0, prompt_1.readJsonBody)(flags.file));
+            if (!composition ||
+                typeof composition !== 'object' ||
+                composition.schemaVersion !== 1 ||
+                !Array.isArray(composition.entries)) {
+                throw new Error('Composition JSON must contain { "schemaVersion": 1, "entries": [...] }.');
+            }
+        }
+        catch (error) {
+            this.error(error.message, { exit: 2 });
+        }
+        let updated;
+        try {
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, composition);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Replaced custom instructions for ${agentId}; the server compiled and saved the new composition.`);
+    }
+}
+exports.default = AgentsInstructionsSet;

package/dist/commands/agents/instructions/show.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../base-command';
+/** Inspect the editable composition, not merely its legacy rendered string. */
+export default class AgentsInstructionsShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        rendered: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/show.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+/** Inspect the editable composition, not merely its legacy rendered string. */
+class AgentsInstructionsShow extends base_command_1.BaseCommand {
+    static description = 'Show an Agent’s custom-instruction composition, ordering, versions, and instance IDs';
+    static examples = [
+        '<%= config.bin %> agents instructions show <agent-id>',
+        '<%= config.bin %> agents instructions show --rendered',
+        '<%= config.bin %> agents instructions show <agent-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        rendered: core_1.Flags.boolean({ description: 'Also print the exact compiled custom instructions' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsShow);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+                details: { suggestion: failure.suggestion, context: failure.details },
+            });
+        }
+        let loaded;
+        try {
+            loaded = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        const { agent, composition } = loaded;
+        if (flags.json) {
+            this.log(JSON.stringify({
+                agentId,
+                composition,
+                instructions: agent.instructions ?? '',
+            }, null, 2));
+            return;
+        }
+        this.log(`Agent: ${agent.name ?? agentId} (${agentId})`);
+        this.log(`Revision: ${composition.revisionId ?? 'legacy/unsaved'} · ${composition.entries.length} block(s)`);
+        this.log('');
+        for (const line of (0, agent_instructions_1.renderCompositionLines)(composition))
+            this.log(line);
+        if (flags.rendered) {
+            this.log('');
+            this.log('Compiled instructions:');
+            this.log(agent.instructions || '(No enabled custom instruction blocks.)');
+        }
+        else {
+            this.log('');
+            this.log('Use --rendered to inspect the exact compiled text, or `preview` to revalidate it.');
+        }
+    }
+}
+exports.default = AgentsInstructionsShow;

package/dist/commands/agents/instructions/upgrade.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base-command';
+/** Explicit is intentional: no library editor can silently change a live Agent. */
+export default class AgentsInstructionsUpgrade extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        instance: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        latest: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/upgrade.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const instruction_blocks_1 = require("../../../lib/instruction-blocks");
+/** Explicit is intentional: no library editor can silently change a live Agent. */
+class AgentsInstructionsUpgrade extends base_command_1.BaseCommand {
+    static description = 'Move one attached library block to a reviewed version explicitly';
+    static examples = [
+        '<%= config.bin %> agents instructions upgrade library_… --agent <agent-id> --version 2',
+        '<%= config.bin %> agents instructions upgrade library_… --agent <agent-id> --latest',
+    ];
+    static args = {
+        instance: core_1.Args.string({
+            description: 'Library block instance ID',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        version: core_1.Flags.integer({ description: 'Exact version to pin' }),
+        latest: core_1.Flags.boolean({ description: 'Pin the source’s current version' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsUpgrade);
+        if (Boolean(flags.version) === Boolean(flags.latest)) {
+            this.error('Choose exactly one of --version <n> or --latest.', { exit: 2 });
+        }
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(undefined, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let updated;
+        let selectedVersion;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            const entry = (0, instruction_blocks_1.entryByInstance)(composition, args.instance);
+            if (entry.source.kind !== 'library') {
+                throw new Error(`${args.instance} is an inline block and has no library version to upgrade.`);
+            }
+            const block = await data_provider_1.dataService.getInstructionBlock(entry.source.blockId);
+            selectedVersion = flags.latest ? block.currentVersion : flags.version;
+            if (!block.versions.some((candidate) => candidate.version === selectedVersion)) {
+                throw new Error(`${block.id} has no v${selectedVersion}. Run \`skrr instruction-blocks show ${block.id}\`.`);
+            }
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, (0, instruction_blocks_1.replaceEntry)(composition, args.instance, {
+                ...entry,
+                source: { kind: 'library', blockId: entry.source.blockId, version: selectedVersion },
+                // The controller resolves the selected source server-side and writes
+                // a new immutable snapshot.  Never carry the old snapshot forward.
+                resolved: undefined,
+            }));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Upgraded ${args.instance} on ${agentId} to v${selectedVersion}.`);
+    }
+}
+exports.default = AgentsInstructionsUpgrade;

package/dist/commands/agents/show.js

@@ -112,6 +112,11 @@ class AgentsShow extends base_command_1.BaseCommand {
         this.log(`Tone:        ${agentToneLine(a)}`);
         this.log(`Category:    ${a.category ?? '-'}`);
         this.log(`Author:      ${a.author ?? '-'}`);
+        // A cap the user cannot see is a cap they cannot diagnose: a saturated
+        // agent makes its assigned tasks wait, which reads as "the board is stuck".
+        this.log(`Task limit:  ${typeof a.maxConcurrentTaskExecutions === 'number' && a.maxConcurrentTaskExecutions > 0
+            ? `${a.maxConcurrentTaskExecutions} concurrent across all spaces`
+            : 'unlimited'}`);
         for (const line of agentExecutionOrderLines(a))
             this.log(line);
         if (a.harnessName || a.harnessProvider || a.harnessStatus) {

package/dist/commands/agents/triggers/policy.js

@@ -4,7 +4,10 @@ const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const prompt_1 = require("../../../lib/prompt");
 const triggers_1 = require("../../../lib/triggers");
-const POLICY_MODES = ['off', 'suggestions_only', 'ask_first', 'auto_run_limited'];
+// The server validates `mode` against the full autonomy ladder. This command
+// used to carry its own copy that stopped one rung short, so `auto_run` was
+// accepted by the API and unreachable from the CLI.
+const data_provider_1 = require("@skrr-ai/data-provider");
 class AgentsTriggersPolicy extends base_command_1.BaseCommand {
     static description = "Show or update an agent's initiative policy for agent-scoped triggers";
     static examples = [
@@ -23,7 +26,10 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
         'audit-limit': core_1.Flags.integer({
             description: 'Recent fire rows to include when showing policy',
         }),
-        mode: core_1.Flags.string({ description: 'Initiative policy mode', options: [...POLICY_MODES] }),
+        mode: core_1.Flags.string({
+            description: 'Initiative policy mode',
+            options: [...data_provider_1.AGENT_INITIATIVE_POLICY_MODES],
+        }),
         'allowed-kind': core_1.Flags.string({
             description: 'Allowed trigger kind under auto_run_limited (repeatable or comma-separated)',
             multiple: true,

package/dist/commands/agents/update.d.ts

@@ -29,6 +29,7 @@ export default class AgentsUpdate extends BaseCommand {
         'tone-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tone-notes': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-concurrent-task-executions': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         skills: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'agent-actions': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tool-policy': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/agents/update.js

@@ -11,7 +11,7 @@ class AgentsUpdate extends base_command_1.BaseCommand {
     static description = 'Update an existing agent (partial patch)';
     static examples = [
         '<%= config.bin %> agents update <agent-id> --name "New name"',
-        '<%= config.bin %> agents update <agent-id> --instructions "You are a helpful..."',
+        '<%= config.bin %> agents instructions add <agent-id> --inline --title "Working preferences" --body "Lead with the answer."',
         '<%= config.bin %> agents update <agent-id> --model claude-sonnet-5',
         '<%= config.bin %> agents update <agent-id> --target sbs_123',
         '<%= config.bin %> agents update <agent-id> --target rt_local --next-target hosted-machine',
@@ -27,7 +27,9 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         }),
         name: core_1.Flags.string({ description: 'New name' }),
         description: core_1.Flags.string({ description: 'New description' }),
-        instructions: core_1.Flags.string({ description: 'New system instructions' }),
+        instructions: core_1.Flags.string({
+            description: 'Replace all custom instructions with one raw legacy block. For block-aware edits use `agents instructions`.',
+        }),
         provider: core_1.Flags.string({ description: 'New provider' }),
         model: core_1.Flags.string({ description: 'New model' }),
         category: core_1.Flags.string({ description: 'New category' }),
@@ -56,6 +58,10 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         'tone-mode': core_1.Flags.string({ description: 'Tone mode' }),
         'tone-id': core_1.Flags.string({ description: 'Tone ID' }),
         'tone-notes': core_1.Flags.string({ description: 'Per-agent tone notes' }),
+        'max-concurrent-task-executions': core_1.Flags.integer({
+            description: 'Max Task executions this agent may run at once ACROSS every space (0 = unlimited). ' +
+                'Ready tasks assigned to a saturated agent wait instead of starting.',
+        }),
         skills: core_1.Flags.string({ description: 'Skills JSON array' }),
         'agent-actions': core_1.Flags.string({ description: 'Embedded actions JSON array' }),
         'tool-policy': core_1.Flags.string({ description: 'Tool policy JSON object' }),

package/dist/commands/daemon/index.js

@@ -20,6 +20,7 @@ class Daemon extends core_1.Command {
         '<%= config.bin %> daemon start',
         '<%= config.bin %> daemon stop',
         '<%= config.bin %> daemon logs',
+        '<%= config.bin %> daemon recover-offline-queue --apply',
         '<%= config.bin %> daemon usage --refresh',
         '<%= config.bin %> daemon byok status',
     ];
@@ -38,6 +39,7 @@ class Daemon extends core_1.Command {
         this.log('  skrr daemon stop       — stop the daemon');
         this.log('  skrr daemon status     — show running state and config');
         this.log('  skrr daemon logs       — tail recent daemon logs');
+        this.log('  skrr daemon recover-offline-queue — restore recoverable offline WALs');
         this.log('  skrr daemon usage      — show local Claude Code and Codex usage limits');
         this.log('  skrr daemon byok       — manage local BYOK Keychain credentials');
         this.log('');

package/dist/commands/daemon/recover-offline-queue.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+/** Restore explicitly selected offline-queue forensic WALs through the runtime. */
+export default class DaemonRecoverOfflineQueue extends Command {
+    static aliases: string[];
+    static summary: string;
+    static description: string;
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/commands/daemon/recover-offline-queue.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const exec_runtime_binary_1 = require("../../lib/exec-runtime-binary");
+/** Restore explicitly selected offline-queue forensic WALs through the runtime. */
+class DaemonRecoverOfflineQueue extends core_1.Command {
+    static aliases = ['daemons:recover-offline-queue'];
+    static summary = 'Restore recoverable offline-queue dead letters after a replay fix';
+    static description = (0, exec_runtime_binary_1.forwardedFlagsNote)('recover-offline-queue');
+    static strict = false;
+    async run() {
+        try {
+            this.exit(await (0, exec_runtime_binary_1.execRuntimeBinary)(['recover-offline-queue', ...this.argv]));
+        }
+        catch (err) {
+            if (err.message === 'runtime-binary-not-installed') {
+                this.log((0, exec_runtime_binary_1.notInstalledMessage)());
+                this.exit(127);
+            }
+            throw err;
+        }
+    }
+}
+exports.default = DaemonRecoverOfflineQueue;

package/dist/commands/daemon/start.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const exec_runtime_binary_1 = require("../../lib/exec-runtime-binary");
+const runtime_start_verification_1 = require("../../lib/runtime-start-verification");
 class DaemonStart extends core_1.Command {
     // `skrr daemons <sub>` — the plural is advertised as an alias for the
     // whole topic, and without a per-command alias only the bare topic
@@ -23,7 +24,34 @@ class DaemonStart extends core_1.Command {
         const argv = this.argv;
         try {
             const code = await (0, exec_runtime_binary_1.execRuntimeBinary)(['start', ...argv]);
-            this.exit(code);
+            if (code !== 0)
+                this.exit(code);
+            // A supervisor's successful `kickstart` means only that it accepted the
+            // request. Older installed skrrd builds then write TOKEN_MISSING and exit
+            // cleanly, leaving the CLI that invoked them to report success. Query the
+            // same profile after every zero exit so the public command never claims a
+            // stopped service is running while users move through a staggered release.
+            const status = await (0, exec_runtime_binary_1.execRuntimeBinaryCapture)((0, runtime_start_verification_1.statusArgsForStart)(argv));
+            const verification = (0, runtime_start_verification_1.verifyRuntimeStart)(status.stdout, status.code, argv);
+            if (verification.status === 'reauth_required') {
+                this.logToStderr(`Local runtime did not start: profile '${verification.profile}' requires ` +
+                    `re-authentication (reason: ${verification.reason ?? 'UNKNOWN'}). Run ` +
+                    `\`${verification.recoveryCommand}\`, then retry \`skrr daemon start\`.`);
+                this.exit(runtime_start_verification_1.DAEMON_START_REAUTH_EXIT);
+            }
+            if (verification.status === 'not_running') {
+                this.logToStderr(`Local runtime did not remain running after skrrd exited successfully ` +
+                    `(profile '${verification.profile}', service status: ` +
+                    `${verification.runtimeStatus ?? 'unknown'}). Run \`skrr daemon logs\` for the reason.`);
+                this.exit(runtime_start_verification_1.DAEMON_START_UNVERIFIED_EXIT);
+            }
+            if (verification.status === 'unreadable_status') {
+                this.logToStderr(`skrrd start exited successfully, but skrr could not verify a running local runtime ` +
+                    `for profile '${verification.profile}'; refusing to report success. ` +
+                    'Run `skrr daemon status` and `skrr daemon logs` for the reason.');
+                this.exit(runtime_start_verification_1.DAEMON_START_UNVERIFIED_EXIT);
+            }
+            this.exit(0);
         }
         catch (err) {
             if (err.message === 'runtime-binary-not-installed') {

package/dist/commands/instruction-blocks/create.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command';
+export default class InstructionBlocksCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        summary: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        tag: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        visibility: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'parameter-schema': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        requirements: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        changelog: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}