@skrr-ai/cli 0.1.60 → 0.1.62

package/dist/base-command.js

@@ -51,6 +51,7 @@ const auth_storage_1 = require("./lib/auth-storage");
 const update_check_1 = require("./lib/update-check");
 const web_url_1 = require("./lib/web-url");
 const edge_error_page_1 = require("./lib/edge-error-page");
+const step_up_1 = require("./lib/step-up");
 const delegated_cli_1 = require("./lib/delegated-cli");
 const dedicated_guest_1 = require("./lib/dedicated-guest");
 const tasks_1 = require("./lib/tasks");
@@ -1074,6 +1075,21 @@ class BaseCommand extends core_1.Command {
                     retryable: false,
                 });
             }
+            else if (bodyCode && bodyCode === data_provider_1.STEP_UP_REQUIRED_CODE) {
+                // Publishing a Store release, or moving the one buyers are served,
+                // needs a recent step-up from THIS login (OSK-12275). A 403 read by
+                // the generic branch would say "forbidden" and leave the publisher to
+                // guess whether they lack permission, 2FA, or a fresh verification —
+                // each of which has a different remedy, named by the body's reason.
+                this.failWithCliError({
+                    message: say((0, step_up_1.describeStepUpRequired)((0, data_provider_1.stepUpChallengeFromBody)(body), this.config.bin)),
+                    code: bodyCode,
+                    status: e.status,
+                    exit: 2,
+                    retryable: false,
+                    details: body ?? undefined,
+                });
+            }
             else if (bodyCode === 'AGENT_RUNTIME_UNAVAILABLE') {
                 // A specific agent's runtime is offline — not a platform outage, even
                 // though the server returns 503. Intercept before the 503→outage

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

@@ -94,6 +94,7 @@ export default class AgentsCreate extends BaseCommand {
         'agent-ids': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'network-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'network-agent-ids': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'network-shell-write-agent-ids': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'network-include-public': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'character-3d-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'scene-background': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/agents/create.js

@@ -214,6 +214,11 @@ class AgentsCreate extends base_command_1.BaseCommand {
         'agent-ids': core_1.Flags.string({ description: 'Delegated agent IDs JSON array' }),
         'network-mode': core_1.Flags.string({ description: 'Agent network mode' }),
         'network-agent-ids': core_1.Flags.string({ description: 'Network agent IDs JSON array' }),
+        'network-shell-write-agent-ids': core_1.Flags.string({
+            description: 'JSON array of agents in the Specific network that may run commands and create or edit ' +
+                "files when delegated to. Agents someone else wrote, and Store installs, can't unless " +
+                'listed here. Author only; [] clears.',
+        }),
         'network-include-public': core_1.Flags.boolean({ description: 'Include public agents in network' }),
         'character-3d-id': core_1.Flags.string({ description: '3D character ID' }),
         'scene-background': core_1.Flags.string({ description: agent_visual_refs_1.SCENE_BACKGROUND_FLAG_HELP }),
@@ -227,7 +232,9 @@ class AgentsCreate extends base_command_1.BaseCommand {
         'agent-actions': core_1.Flags.string({ description: 'Embedded actions JSON array' }),
         'tool-policy': core_1.Flags.string({ description: 'Tool policy JSON object' }),
         artifacts: core_1.Flags.string({ description: 'Artifacts JSON value' }),
-        'support-contact': core_1.Flags.string({ description: 'Support contact JSON object' }),
+        'support-contact': core_1.Flags.string({
+            description: 'Support contact JSON object: {"name","email","security_email"}. The Store listing shows the email and security_email of the published release.',
+        }),
         'install-first-contact': core_1.Flags.string({ description: 'First-contact config JSON value' }),
         'end-after-tools': core_1.Flags.boolean({ description: 'End turn after tools' }),
         'hide-sequential-outputs': core_1.Flags.boolean({ description: 'Hide sequential outputs' }),

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

@@ -1,4 +1,13 @@
+import type { AgentRemovalKind, DeleteAgentResponse } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../base-command';
+/**
+ * The confirmation question. Deleting an agent installed from the store only
+ * uninstalls it, and this used to call that irreversible (OSK-12246). `null`
+ * means the agent could not be read first, so the question covers both cases.
+ */
+export declare function agentRemovalQuestion(agentId: string, kind: AgentRemovalKind | null): string;
+/** What happened, read from the server's response rather than predicted. */
+export declare function agentRemovalReport(agentId: string, response: DeleteAgentResponse | undefined): string;
 export default class AgentsDelete extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -8,5 +17,10 @@ export default class AgentsDelete extends BaseCommand {
     static flags: {
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
+    /**
+     * Which of the two the request is about to do, so the prompt can say so. A
+     * failed read is not a reason to refuse: the delete reports its own error.
+     */
+    private predictRemoval;
     run(): Promise<void>;
 }

package/dist/commands/agents/delete.js

@@ -1,11 +1,45 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentRemovalQuestion = agentRemovalQuestion;
+exports.agentRemovalReport = agentRemovalReport;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const prompt_1 = require("../../lib/prompt");
+/**
+ * The confirmation question. Deleting an agent installed from the store only
+ * uninstalls it, and this used to call that irreversible (OSK-12246). `null`
+ * means the agent could not be read first, so the question covers both cases.
+ */
+function agentRemovalQuestion(agentId, kind) {
+    switch (kind) {
+        case 'deleted':
+            return `Delete agent ${agentId}? This cannot be undone.`;
+        case 'uninstalled':
+            return `Uninstall agent ${agentId}? It was installed from the store, so it is uninstalled, not deleted. Reinstalling it restores it.`;
+        case 'team_uninstalled':
+            return `Uninstall agent ${agentId}? It was installed as part of a team, so the whole team is uninstalled, not deleted. Reinstalling the team restores it.`;
+        default:
+            return `Delete agent ${agentId}? If you created it, this cannot be undone. If you installed it from the store, it is uninstalled instead, and reinstalling restores it.`;
+    }
+}
+/** What happened, read from the server's response rather than predicted. */
+function agentRemovalReport(agentId, response) {
+    switch ((0, data_provider_1.agentRemovalKind)(response)) {
+        case 'uninstalled':
+            return `Uninstalled agent ${agentId}. It was not deleted: reinstall it from the store to restore it.`;
+        case 'team_uninstalled': {
+            const result = response?.result;
+            const ids = result?.entityType === 'team' ? (result.installedAgentIds ?? []) : [];
+            const scope = ids.length > 0 ? ` (${ids.length} agents)` : '';
+            return `Uninstalled the team agent ${agentId} was installed with${scope}. Nothing was deleted: reinstall the team from the store to restore it.`;
+        }
+        default:
+            return `Deleted agent ${agentId}`;
+    }
+}
 class AgentsDelete extends base_command_1.BaseCommand {
-    static description = 'Delete an agent (irreversible)';
+    static description = 'Delete an agent you created (irreversible), or uninstall one installed from the store (reinstalling restores it)';
     static examples = [
         '<%= config.bin %> agents delete <agent-id>',
         '<%= config.bin %> agents delete <agent-id> --yes',
@@ -16,12 +50,25 @@ class AgentsDelete extends base_command_1.BaseCommand {
     static flags = {
         yes: core_1.Flags.boolean({ char: 'y', description: 'Skip confirmation prompt' }),
     };
+    /**
+     * Which of the two the request is about to do, so the prompt can say so. A
+     * failed read is not a reason to refuse: the delete reports its own error.
+     */
+    async predictRemoval(agentId) {
+        try {
+            return (0, data_provider_1.agentRemovalKindForAgent)(await data_provider_1.dataService.getExpandedAgentById({ agent_id: agentId }));
+        }
+        catch {
+            return null;
+        }
+    }
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(AgentsDelete);
         let ok;
         try {
-            ok = await (0, prompt_1.confirmDestructive)(`Delete agent ${args.id}? This cannot be undone.`, flags.yes);
+            const predicted = flags.yes ? null : await this.predictRemoval(args.id);
+            ok = await (0, prompt_1.confirmDestructive)(agentRemovalQuestion(args.id, predicted), flags.yes);
         }
         catch (err) {
             const e = err;
@@ -34,13 +81,14 @@ class AgentsDelete extends base_command_1.BaseCommand {
             this.log('Cancelled.');
             return;
         }
+        let response;
         try {
-            await data_provider_1.dataService.deleteAgent({ agent_id: args.id });
+            response = await data_provider_1.dataService.deleteAgent({ agent_id: args.id });
         }
         catch (err) {
             this.handleApiError(err);
         }
-        this.log(`Deleted agent ${args.id}`);
+        this.log(agentRemovalReport(args.id, response));
     }
 }
 exports.default = AgentsDelete;

package/dist/commands/agents/eval/index.d.ts

@@ -0,0 +1,38 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr agents eval <agent-id>` — evaluate one release against a baseline
+ * (OSK-12303).
+ *
+ * The platform runs every case several times against the release and against
+ * the baseline (no agent, or the previous release), grades each trial with the
+ * deterministic assertions in your case file, and prices it from the tokens it
+ * used. Every trial runs from the release configuration alone — none of your
+ * account's memory, persona or tone — and the no-agent baseline is the
+ * platform's default assistant. Trials run on the platform and are billed to
+ * your account; this command only decides which planned trial runs next,
+ * starts it, and waits for its result in short reads (a trial can outlast any
+ * one HTTP request), so an interrupted run continues with `--resume`.
+ *
+ * An evaluation is evidence, never a publish gate. `--list` puts it on the
+ * store listing — decided now, before any trial runs, and it cannot be taken
+ * back. The listing shows its progress at once and a result once every trial
+ * is graded, beside how many evaluations were listed and how many never
+ * finished.
+ */
+export default class AgentsEval extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        cases: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        release: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        baseline: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        trials: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        list: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        resume: 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/agents/eval/index.js

@@ -0,0 +1,157 @@
+"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_evals_1 = require("../../../lib/agent-evals");
+/**
+ * `skrr agents eval <agent-id>` — evaluate one release against a baseline
+ * (OSK-12303).
+ *
+ * The platform runs every case several times against the release and against
+ * the baseline (no agent, or the previous release), grades each trial with the
+ * deterministic assertions in your case file, and prices it from the tokens it
+ * used. Every trial runs from the release configuration alone — none of your
+ * account's memory, persona or tone — and the no-agent baseline is the
+ * platform's default assistant. Trials run on the platform and are billed to
+ * your account; this command only decides which planned trial runs next,
+ * starts it, and waits for its result in short reads (a trial can outlast any
+ * one HTTP request), so an interrupted run continues with `--resume`.
+ *
+ * An evaluation is evidence, never a publish gate. `--list` puts it on the
+ * store listing — decided now, before any trial runs, and it cannot be taken
+ * back. The listing shows its progress at once and a result once every trial
+ * is graded, beside how many evaluations were listed and how many never
+ * finished.
+ */
+class AgentsEval extends base_command_1.BaseCommand {
+    static description = 'Run your cases against a release and a baseline on the platform; report pass rates and cost';
+    static examples = [
+        '<%= config.bin %> agents eval agent_abc --cases cases.json',
+        '<%= config.bin %> agents eval agent_abc --cases ./cases --release 1.2 --baseline previous-release --trials 5',
+        '<%= config.bin %> agents eval agent_abc --cases cases.json --list',
+        '<%= config.bin %> agents eval agent_abc --resume 6f1c…',
+    ];
+    static args = {
+        agentId: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Agent ID' }),
+    };
+    static flags = {
+        cases: core_1.Flags.string({
+            description: 'Case file (JSON list, {"cases": [...]}, or one case) or a directory of JSON case files',
+            exclusive: ['resume'],
+        }),
+        release: core_1.Flags.string({
+            description: 'Release id or version label (default: the newest release)',
+            exclusive: ['resume'],
+        }),
+        baseline: core_1.Flags.string({
+            description: 'What the release is compared against',
+            options: Object.keys(agent_evals_1.EVAL_BASELINE_FLAG_VALUES),
+            default: 'no-agent',
+        }),
+        trials: core_1.Flags.integer({
+            description: `Trials per case on each side (default ${data_provider_1.RELEASE_EVAL_LIMITS.defaultTrialsPerCase})`,
+            min: 1,
+            max: data_provider_1.RELEASE_EVAL_LIMITS.maxTrialsPerCase,
+        }),
+        list: core_1.Flags.boolean({
+            description: 'Show this evaluation on the store listing now, with a result once every trial is graded (fixed before any trial runs)',
+            default: false,
+        }),
+        resume: core_1.Flags.string({ description: 'Continue (or show) an existing evaluation by id' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsEval);
+        const agentId = args.agentId;
+        if (!flags.cases && !flags.resume) {
+            this.error('Pass --cases <file|dir> to start an evaluation, or --resume <eval-id>.', {
+                exit: 2,
+            });
+        }
+        let evaluation;
+        try {
+            if (flags.resume) {
+                evaluation = await data_provider_1.dataService.getAgentReleaseEval(agentId, flags.resume);
+            }
+            else {
+                let cases;
+                try {
+                    cases = (0, agent_evals_1.readEvalCases)(flags.cases);
+                }
+                catch (error) {
+                    this.error(error.message, { exit: 2 });
+                }
+                const releases = await data_provider_1.dataService.getAgentReleases(agentId);
+                const release = (0, agent_evals_1.pickRelease)(releases.data ?? [], flags.release);
+                if (!release) {
+                    this.error(flags.release
+                        ? `No release "${flags.release}" on agent ${agentId}. See: skrr agents releases list ${agentId}`
+                        : `Agent ${agentId} has no release yet. Create one with: skrr agents releases create ${agentId}`, { exit: 2 });
+                }
+                evaluation = await data_provider_1.dataService.createAgentReleaseEval({
+                    agentId,
+                    releaseId: release.id,
+                    cases,
+                    baseline: agent_evals_1.EVAL_BASELINE_FLAG_VALUES[flags.baseline],
+                    trialsPerCase: flags.trials,
+                    listed: flags.list,
+                });
+            }
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: `agent ${agentId}` });
+        }
+        const pending = (0, agent_evals_1.pendingTrials)(evaluation);
+        const total = evaluation.summary.expectedTrials;
+        if (!flags.json) {
+            for (const line of (0, agent_evals_1.describeEvalHeader)(evaluation))
+                this.log(line);
+            if (pending.length > 0) {
+                this.log(`\nRunning ${pending.length} trial(s) on the platform, billed to your account. Interrupted? Continue with:\n  skrr agents eval ${agentId} --resume ${evaluation.id}\n`);
+            }
+        }
+        const evalId = evaluation.id;
+        const client = {
+            start: (entry) => data_provider_1.dataService.runAgentReleaseEvalTrial({
+                agentId,
+                evalId,
+                arm: entry.arm,
+                caseId: entry.caseId,
+                trialIndex: entry.trialIndex,
+            }),
+            observe: (options) => data_provider_1.dataService.getAgentReleaseEval(agentId, evalId, options),
+        };
+        let position = total - pending.length;
+        for (const entry of pending) {
+            position += 1;
+            try {
+                const result = await (0, agent_evals_1.runEvalTrial)(client, entry);
+                evaluation = result.evaluation;
+                if (!flags.json) {
+                    this.log((0, agent_evals_1.describeTrialLine)(evaluation, result.trial, position, total, result.replayed));
+                }
+            }
+            catch (error) {
+                const resumeHint = `Graded trials are kept; continue with:\n  skrr agents eval ${agentId} --resume ${evalId}`;
+                if (error instanceof agent_evals_1.EvalTrialFailedError) {
+                    this.error(`${error.message}\n${resumeHint}`, { exit: 1 });
+                }
+                if (!flags.json) {
+                    this.logToStderr(`\nStopped at ${entry.key}. ${resumeHint}`);
+                }
+                this.handleApiError(error, { subject: `evaluation ${evalId}` });
+            }
+        }
+        if (flags.json) {
+            this.log(this.agentJson(agentId, evaluation));
+            return;
+        }
+        this.log('');
+        for (const line of (0, agent_evals_1.describeEvalReport)(evaluation))
+            this.log(line);
+        this.printAgentUrl(agentId);
+    }
+}
+exports.default = AgentsEval;

package/dist/commands/agents/eval/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+/** `skrr agents eval list <agent-id>` — this agent's evaluations, newest first. */
+export default class AgentsEvalList extends BaseCommand {
+    static description: string;
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        release: 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/agents/eval/list.js

@@ -0,0 +1,53 @@
+"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");
+/** `skrr agents eval list <agent-id>` — this agent's evaluations, newest first. */
+class AgentsEvalList extends base_command_1.BaseCommand {
+    static description = "List an agent's release evaluations";
+    static args = {
+        agentId: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Agent ID' }),
+    };
+    static flags = {
+        release: core_1.Flags.string({ description: 'Only evaluations of this release id' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsEvalList);
+        let result;
+        try {
+            result = flags.release
+                ? await data_provider_1.dataService.listAgentReleaseEvals(args.agentId, flags.release)
+                : await data_provider_1.dataService.listAgentEvals(args.agentId);
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: `agent ${args.agentId}` });
+        }
+        if (flags.json) {
+            this.log(this.agentJson(args.agentId, result));
+            return;
+        }
+        const rows = result.data ?? [];
+        if (rows.length === 0) {
+            this.log(`No evaluations yet. Start one with: skrr agents eval ${args.agentId} --cases <file>`);
+            return;
+        }
+        for (const evaluation of rows) {
+            const { summary } = evaluation;
+            this.log([
+                evaluation.id,
+                `v${evaluation.versionLabel ?? '?'} vs ${(0, data_provider_1.describeReleaseEvalBaseline)(evaluation.baseline)}`,
+                evaluation.status === 'running'
+                    ? `running (${summary.recordedTrials}/${summary.expectedTrials} trials)`
+                    : 'completed',
+                `${(0, data_provider_1.formatReleaseEvalPassRate)(summary.candidate.passRate)} vs ${(0, data_provider_1.formatReleaseEvalPassRate)(summary.baseline.passRate)}`,
+                `${(0, data_provider_1.formatReleaseEvalCostMicros)(summary.candidate.meanCostMicros)}/run`,
+                evaluation.listed ? 'listed' : 'private',
+            ].join('  '));
+        }
+        this.printAgentUrl(args.agentId);
+    }
+}
+exports.default = AgentsEvalList;

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

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+/** `skrr agents eval show <agent-id> <eval-id>` — one evaluation's comparison and cost. */
+export default class AgentsEvalShow extends BaseCommand {
+    static description: string;
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        evalId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,36 @@
+"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_evals_1 = require("../../../lib/agent-evals");
+/** `skrr agents eval show <agent-id> <eval-id>` — one evaluation's comparison and cost. */
+class AgentsEvalShow extends base_command_1.BaseCommand {
+    static description = 'Show one release evaluation: pass rates, baseline, per-case results and cost';
+    static args = {
+        agentId: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Agent ID' }),
+        evalId: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Evaluation ID' }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsEvalShow);
+        let evaluation;
+        try {
+            evaluation = await data_provider_1.dataService.getAgentReleaseEval(args.agentId, args.evalId);
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: `evaluation ${args.evalId}` });
+        }
+        if (flags.json) {
+            this.log(this.agentJson(args.agentId, evaluation));
+            return;
+        }
+        for (const line of (0, agent_evals_1.describeEvalReport)(evaluation))
+            this.log(line);
+        this.printAgentUrl(args.agentId);
+    }
+}
+exports.default = AgentsEvalShow;

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

@@ -0,0 +1,37 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Bring a Claude Code asset in: a subagent (`.claude/agents/<name>.md`) or a
+ * skill (`SKILL.md`, or the directory holding one).
+ *
+ * A subagent becomes an agent spec document — printed or written with
+ * `--output`, or pushed onto an existing agent with `--agent` (the same push
+ * as `agents push`). A skill becomes a skill in your library, attached to
+ * `--agent` when given.
+ *
+ * Either way, `hooks` and MCP server commands are NEVER carried: they run on
+ * the machine that loads the file, and a portable spec is read on machines
+ * that are not yours. What was left out is printed, one line per key, so the
+ * import says what it did not do.
+ */
+export default class AgentsImport extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        path: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: 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>;
+    private convert;
+    private printDropped;
+    /**
+     * @param sourceLabel - how messages name the source
+     * @param filePath - the file, when there is one; its name is the fallback
+     *   agent name. stdin has none, so its frontmatter must carry `name`.
+     */
+    private importAgent;
+    private importSkill;
+}