@skrr-ai/cli 0.1.13 → 0.1.15

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

@@ -0,0 +1,61 @@
+"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 AgentsInstructionsMove extends base_command_1.BaseCommand {
+    static description = 'Reorder one instruction block; later enabled blocks can supplement or narrow earlier ones';
+    static examples = [
+        '<%= config.bin %> agents instructions move library_… --agent <agent-id> --before inline_…',
+        '<%= config.bin %> agents instructions move inline_… --agent <agent-id> --after library_…',
+    ];
+    static args = {
+        instance: core_1.Args.string({
+            description: 'Block instance to move',
+            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)' }),
+        before: core_1.Flags.string({ description: 'Move immediately before this instance ID' }),
+        after: core_1.Flags.string({ description: 'Move immediately after this instance ID' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsMove);
+        if (Boolean(flags.before) === Boolean(flags.after)) {
+            this.error('Choose exactly one placement: --before <instance> or --after <instance>.', {
+                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;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, (0, instruction_blocks_1.moveEntry)(composition, args.instance, (flags.before ?? flags.after), flags.before ? 'before' : 'after'));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Moved ${args.instance} ${flags.before ? 'before' : 'after'} ${flags.before ?? flags.after}.`);
+    }
+}
+exports.default = AgentsInstructionsMove;

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

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class AgentsInstructionsPreview 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>;
+    };
+    run(): Promise<void>;
+}

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/list.d.ts

@@ -12,6 +12,16 @@ export declare function agentRow(a: Record<string, unknown>): {
     name: string;
     description: string;
 };
+/**
+ * What the zero-row case is allowed to say. The account-is-new empty state
+ * showed a bare `No agents.` and named no next step, which is what the
+ * `commitments/list.ts` empty state was fixed to stop doing. Point at the
+ * shortest path a new user actually wants (`skrr code`, which lazily creates
+ * a `Sky Code` agent), and at `agents create` for the explicit path.
+ *
+ * Exported and pure so the wording is testable without an oclif runtime.
+ */
+export declare function noAgentsEmptyMessage(bin?: string): string;
 export default class AgentsList extends BaseCommand {
     static description: string;
     static examples: string[];

package/dist/commands/agents/list.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.agentRow = agentRow;
+exports.noAgentsEmptyMessage = noAgentsEmptyMessage;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -21,6 +22,20 @@ function agentRow(a) {
         description: (0, format_1.formatCell)(a.description, ''),
     };
 }
+/**
+ * What the zero-row case is allowed to say. The account-is-new empty state
+ * showed a bare `No agents.` and named no next step, which is what the
+ * `commitments/list.ts` empty state was fixed to stop doing. Point at the
+ * shortest path a new user actually wants (`skrr code`, which lazily creates
+ * a `Sky Code` agent), and at `agents create` for the explicit path.
+ *
+ * Exported and pure so the wording is testable without an oclif runtime.
+ */
+function noAgentsEmptyMessage(bin = 'skrr') {
+    return ('No agents yet.\n' +
+        `  → Start a coding session and one will be created for you: \`${bin} code\`\n` +
+        `  → Or create one explicitly: \`${bin} agents create --name "..." --provider anthropic --model claude-sonnet-4-5 --target hosted-machine\``);
+}
 class AgentsList extends base_command_1.BaseCommand {
     static description = 'List agents available to you';
     static examples = [
@@ -57,7 +72,7 @@ class AgentsList extends base_command_1.BaseCommand {
             ? r
             : (r?.data ?? r?.agents ?? []);
         if (items.length === 0) {
-            this.log('No agents.');
+            this.log(noAgentsEmptyMessage(this.config.bin));
             return;
         }
         const rows = items.map((item) => ({

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/browser.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildBrowserArgs = buildBrowserArgs;
 exports.forwardBrowserCommand = forwardBrowserCommand;
 const core_1 = require("@oclif/core");
-const exec_oversky_1 = require("../lib/exec-oversky");
+const exec_runtime_binary_1 = require("../lib/exec-runtime-binary");
 function buildBrowserArgs(passthrough) {
     return ['browser', ...passthrough];
 }
@@ -17,14 +17,14 @@ async function forwardBrowserCommand(command, passthrough) {
         // Older daemons treated unknown subcommands as a daemon startup in some
         // releases. Probe the command list before forwarding so an install command
         // cannot turn into a surprising service mutation.
-        if ((await (0, exec_oversky_1.overskySupportsSubcommand)('browser')) === false) {
+        if ((await (0, exec_runtime_binary_1.runtimeBinarySupportsSubcommand)('browser')) === false) {
             command.error('The local `oversky` daemon does not support skrr Browser yet. Update or reinstall the daemon, then retry `skrr browser`.', { exit: 2 });
         }
-        command.exit(await (0, exec_oversky_1.execOversky)(buildBrowserArgs(passthrough)));
+        command.exit(await (0, exec_runtime_binary_1.execRuntimeBinary)(buildBrowserArgs(passthrough)));
     }
     catch (error) {
-        if (error.message === 'oversky-not-installed') {
-            command.log((0, exec_oversky_1.notInstalledMessage)());
+        if (error.message === 'runtime-binary-not-installed') {
+            command.log((0, exec_runtime_binary_1.notInstalledMessage)());
             command.exit(127);
         }
         throw error;