@skrr-ai/cli 0.1.65 → 0.1.66

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

@@ -10,6 +10,14 @@ export declare function parseCapabilityRationales(entries: readonly string[] | u
     rationales?: Record<string, string>;
     error?: string;
 };
+export declare function parseReleaseDependencies(entries: readonly string[] | undefined): {
+    dependencies?: Array<{
+        entityType: 'skill' | 'action';
+        entityId: string;
+        artifactVersionId: string;
+    }>;
+    error?: string;
+};
 export default class AgentsVisibility extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -27,6 +35,7 @@ export default class AgentsVisibility extends BaseCommand {
         'version-minor': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'capability-rationale': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         language: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        dependency: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/visibility.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCapabilityRationales = parseCapabilityRationales;
+exports.parseReleaseDependencies = parseReleaseDependencies;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -28,6 +29,23 @@ function parseCapabilityRationales(entries) {
     }
     return { rationales };
 }
+function parseReleaseDependencies(entries) {
+    if (!entries?.length)
+        return {};
+    const dependencies = [];
+    for (const entry of entries) {
+        const match = /^(skill|action):([^@]+)@(store_release_[A-Za-z0-9_-]+)$/.exec(entry);
+        if (!match) {
+            return { error: `--dependency expects skill:<id>@<store-release-id> or action:<id>@<store-release-id>, got "${entry}".` };
+        }
+        dependencies.push({
+            entityType: match[1],
+            entityId: match[2],
+            artifactVersionId: match[3],
+        });
+    }
+    return { dependencies };
+}
 class AgentsVisibility extends base_command_1.BaseCommand {
     static description = 'Set the visibility of an agent (accounts with 2FA need recent step-up for public publishing)';
     static examples = [
@@ -37,6 +55,7 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         '<%= config.bin %> agents visibility <agent-id> --public --json',
         '<%= config.bin %> agents visibility <agent-id> --public --capability-rationale "network:*=Looks up flight prices on the web"',
         '<%= config.bin %> agents visibility <agent-id> --public --language en --language zh-Hans',
+        '<%= config.bin %> agents visibility <agent-id> --public --dependency skill:<skill-id>@<store-release-id>',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Agent ID', required: true, ignoreStdin: true }),
@@ -72,6 +91,10 @@ class AgentsVisibility extends base_command_1.BaseCommand {
             description: 'A language the release works in, as a BCP 47 tag such as en or zh-Hans (repeatable). Shown on the listing as declared by you; the platform does not check it.',
             multiple: true,
         }),
+        dependency: core_1.Flags.string({
+            description: 'Pin an attached Skill or Action to its immutable Store release: skill:<id>@<store-release-id> (repeatable)',
+            multiple: true,
+        }),
     };
     async run() {
         this.requireAuth();
@@ -84,6 +107,12 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         if (rationaleError) {
             this.error(rationaleError, { exit: 1 });
         }
+        const { dependencies, error: dependencyError } = parseReleaseDependencies(flags.dependency);
+        if (dependencyError)
+            this.error(dependencyError, { exit: 1 });
+        if (dependencies && !isPublic) {
+            this.error('--dependency declares pins on a public release; pass it with --public.', { exit: 1 });
+        }
         if (capabilityRationales && !isPublic) {
             this.error('--capability-rationale applies only when publishing with --public.', {
                 exit: 1,
@@ -131,6 +160,7 @@ class AgentsVisibility extends base_command_1.BaseCommand {
                 versionMinor: flags['version-minor'],
                 capabilityRationales,
                 supportedLanguages: flags.language,
+                dependencies,
             });
         }
         catch (err) {

package/dist/commands/memory/mounts/resolve.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const data_schemas_1 = require("@skrr-ai/data-schemas");
 const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
 class MemoryMountsResolve extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Resolve the ACL-aware Memory mounts for an Agent session';
@@ -14,7 +13,7 @@ class MemoryMountsResolve extends scoped_memory_command_1.ScopedMemoryCommand {
         this.requireAuth();
         const { flags } = await this.parse(MemoryMountsResolve);
         const response = await this.memoryApi(flags.agent, `/mounts${this.query(flags)}`);
-        const result = { mounts: response.mounts.map((mount) => data_schemas_1.MemoryMountSchema.parse(mount)) };
+        const result = { mounts: response.mounts.map(scoped_memory_command_1.parseMemoryMount) };
         if (flags.json)
             return this.log(JSON.stringify(result, null, 2));
         for (const mount of result.mounts) {

package/dist/commands/memory/save.d.ts

@@ -1,4 +1,5 @@
 import { BaseCommand } from '../../base-command';
+/** Compatibility entry point for a write API removed by canonical Memory Stores. */
 export default class MemorySave extends BaseCommand {
     static description: string;
     static examples: string[];

package/dist/commands/memory/save.js

@@ -1,72 +1,33 @@
 "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 prompt_1 = require("../../lib/prompt");
 const memory_scope_1 = require("../../lib/memory-scope");
-const memory_workspace_guidance_1 = require("../../lib/memory-workspace-guidance");
+/** Compatibility entry point for a write API removed by canonical Memory Stores. */
 class MemorySave extends base_command_1.BaseCommand {
-    static description = 'Create a flat key/value memory in a pool (owner, an agent, user, or workspace)';
+    static description = 'Retired flat memory write; use memory maintain remember or memory topics create';
     static examples = [
-        '<%= config.bin %> memory save --key "user-preference" --value "dark mode"',
-        '<%= config.bin %> memory save --from-json memory.json',
-        '<%= config.bin %> memory save --key "note" --value "remember this" --json',
-        '<%= config.bin %> memory save --key "team-norm" --value "ship on fridays" --tier workspace --pool-workspace ws_123',
-        '<%= config.bin %> memory maintain remember \'{"path":"/notes","claim":"remember this"}\' --agent agent_abc123',
+        '<%= config.bin %> memory maintain remember \'{"path":"/notes","claim":"Remember this."}\' --agent agent_abc123',
+        '<%= config.bin %> memory topics create --help',
     ];
     static flags = {
-        json: core_1.Flags.boolean({ description: 'Output the created memory as JSON' }),
-        'from-json': core_1.Flags.string({
-            description: 'Path to a JSON file (or "-" for stdin) to use as the request body',
-        }),
-        key: core_1.Flags.string({ description: 'Memory key (required unless set via --from-json)' }),
-        value: core_1.Flags.string({ description: 'Memory value (required unless set via --from-json)' }),
+        json: core_1.Flags.boolean({ description: 'Output errors as JSON' }),
+        'from-json': core_1.Flags.string({ description: 'Retired flat memory input' }),
+        key: core_1.Flags.string({ description: 'Retired flat memory key' }),
+        value: core_1.Flags.string({ description: 'Retired flat memory value' }),
         ...memory_scope_1.memoryScopeFlags,
     };
     async run() {
-        this.requireAuth();
         const { flags } = await this.parse(MemorySave);
-        const scope = (0, memory_scope_1.resolveMemoryScopeOrFail)(flags, (m) => this.error(m, { exit: 1 }));
-        let body = {};
-        try {
-            body = await (0, prompt_1.readJsonBody)(flags['from-json']);
-        }
-        catch (err) {
-            this.error(err.message, { exit: 1 });
-        }
-        const payload = (0, prompt_1.mergeDefined)(body, {
-            key: flags.key,
-            value: flags.value,
+        const next = flags.agent
+            ? `skrr memory maintain remember '{"path":"/notes","claim":"your memory"}' --agent ${flags.agent}`
+            : 'skrr memory topics create --help (choose an Agent or Space Store)';
+        this.failWithCliError({
+            code: 'LEGACY_MEMORY_WRITE_REMOVED',
+            message: `Flat memory writes have been retired. Use canonical Memory Stores. Run: ${next}`,
+            exit: 5,
+            retryable: false,
         });
-        if (!payload.key || typeof payload.key !== 'string') {
-            this.error('A key is required. Pass --key "..." or include it in --from-json.', { exit: 1 });
-        }
-        if (!payload.value || typeof payload.value !== 'string') {
-            this.error('A value is required. Pass --value "..." or include it in --from-json.', {
-                exit: 1,
-            });
-        }
-        let result;
-        try {
-            result = await data_provider_1.dataService.createMemory({
-                key: payload.key,
-                value: payload.value,
-            }, scope);
-        }
-        catch (err) {
-            this.handleApiError(err);
-        }
-        const guidance = scope.agentId ? (0, memory_workspace_guidance_1.semanticWorkspaceGuidance)(scope.agentId) : undefined;
-        if (flags.json) {
-            this.log(JSON.stringify(guidance ? { ...result, semanticWorkspace: guidance } : result, null, 2));
-            return;
-        }
-        this.log(`Saved memory ${result.memory.key}`);
-        if (guidance) {
-            this.log(`\n${guidance.message}`);
-            this.log(`To include a fact in that context, run:\n${guidance.nextCommand}`);
-        }
     }
 }
 exports.default = MemorySave;

package/dist/commands/memory/stores/list.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const data_schemas_1 = require("@skrr-ai/data-schemas");
 const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
 class MemoryStoresList extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'List Memory Stores mounted for an Agent session';
@@ -15,7 +14,7 @@ class MemoryStoresList extends scoped_memory_command_1.ScopedMemoryCommand {
         const { flags } = await this.parse(MemoryStoresList);
         const response = await this.memoryApi(flags.agent, `/stores${this.query(flags)}`);
         const result = {
-            stores: response.stores.map((store) => data_schemas_1.MountedMemoryStoreSchema.parse(store)),
+            stores: response.stores.map(scoped_memory_command_1.parseMountedMemoryStore),
         };
         if (flags.json)
             return this.log(JSON.stringify(result, null, 2));

package/dist/commands/store/update.js

@@ -51,7 +51,7 @@ class StoreUpdate extends base_command_1.BaseCommand {
         if (!status?.purchased) {
             this.error(`${args.agentId} is not installed from the Store. Install it first: skrr store install ${args.agentId}`, { exit: 1 });
         }
-        if (status.pendingUpdate && !flags.decline) {
+        if (status.pendingUpdate && !flags.decline && !flags.json) {
             this.log(`A ${status.pendingUpdate.versionLabel ?? 'new'} release is waiting for review ` +
                 `(${status.pendingUpdate.reason}).`);
         }
@@ -71,6 +71,10 @@ class StoreUpdate extends base_command_1.BaseCommand {
             // hands back the body as TEXT, so reading `err.body` as an object never
             // saw a code at all and both answers below fell through to a bare error.
             const body = (0, http_error_1.httpBodyOf)(err);
+            // The shared error renderer keeps the server's typed refusal in one JSON
+            // envelope. Human guidance below would corrupt stdout in --json mode.
+            if (flags.json)
+                this.handleApiError(err);
             // Not an update: a new major is a separate purchase. Say which version
             // keeps its free updates, and offer no command — none sells a second
             // major of a listing yet, and `store install` refuses one you own.

package/dist/commands/store/updates.d.ts

@@ -9,7 +9,7 @@ import { BaseCommand } from '../../base-command';
  *
  * Three states, kept apart because they ask for three different things:
  *
- *   ready    a same-major release that will apply cleanly
+ *   ready    a same-major release is available; eligibility is checked on apply
  *   review   one that could not be applied on its own — you and the publisher
  *            both changed the same field, the release widened capabilities, or
  *            the version your copy came from is unknown

package/dist/commands/store/updates.js

@@ -14,7 +14,7 @@ const format_1 = require("../../lib/format");
  *
  * Three states, kept apart because they ask for three different things:
  *
- *   ready    a same-major release that will apply cleanly
+ *   ready    a same-major release is available; eligibility is checked on apply
  *   review   one that could not be applied on its own — you and the publisher
  *            both changed the same field, the release widened capabilities, or
  *            the version your copy came from is unknown
@@ -82,7 +82,7 @@ class StoreUpdates extends base_command_1.BaseCommand {
                     channel: install.updatePolicy ?? 'manual',
                     have,
                     waiting: update.versionLabel ?? '-',
-                    detail: 'available; changes and capabilities are checked when you update',
+                    detail: 'available; checked on apply',
                 });
             }
             if (install.stopReason) {
@@ -122,7 +122,7 @@ class StoreUpdates extends base_command_1.BaseCommand {
             { key: 'detail', header: 'WHY', maxWidth: 46 },
         ], (line) => this.log(line));
         this.log('');
-        this.log('ready  → skrr store update <agent>');
+        this.log('ready  → available; checks run on apply: skrr store update <agent>');
         this.log('review → skrr store update <agent> --strategy replace   (takes the publisher version)');
         this.log('widened → skrr store update <agent> --accept-capabilities   (or --decline to keep yours)');
         // No command: `store install` refuses a listing you already own, and

package/dist/lib/scoped-memory-command.d.ts

@@ -1,10 +1,12 @@
-import { type MemoryMount as SharedMemoryMount, type MemoryStore as SharedMemoryStore } from '@skrr-ai/data-schemas';
+import type { MemoryMount as SharedMemoryMount, MemoryStore as SharedMemoryStore } from '@skrr-ai/data-schemas';
 import { BaseCommand } from '../base-command';
 import { ApiFetchError, type ApiFetchOptions } from './api-fetch';
 export type MemoryMount = SharedMemoryMount;
 export type MemoryStore = SharedMemoryStore & {
-    mount?: SharedMemoryMount;
+    mount: SharedMemoryMount;
 };
+export declare function parseMemoryMount(value: unknown): MemoryMount;
+export declare function parseMountedMemoryStore(value: unknown): MemoryStore;
 export declare const scopedMemoryFlags: {
     agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/lib/scoped-memory-command.js

@@ -1,12 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScopedMemoryCommand = exports.versionedMutationFlags = exports.mutationFlags = exports.scopedMemoryFlags = void 0;
+exports.parseMemoryMount = parseMemoryMount;
+exports.parseMountedMemoryStore = parseMountedMemoryStore;
 exports.parseMemoryApiError = parseMemoryApiError;
 const core_1 = require("@oclif/core");
-const data_schemas_1 = require("@skrr-ai/data-schemas");
 const node_crypto_1 = require("node:crypto");
 const base_command_1 = require("../base-command");
 const api_fetch_1 = require("./api-fetch");
+// The public CLI must not load the private data-schemas package at runtime.
+// The API validates the full wire contract; check the fields used by CLI commands
+// before treating a response as a mounted Store or mount.
+function parseMemoryMount(value) {
+    const mount = value;
+    if (!mount || typeof mount !== 'object' || typeof mount.storeId !== 'string' ||
+        typeof mount.uri !== 'string' || typeof mount.authorizationGeneration !== 'number' ||
+        !['read_only', 'read_write'].includes(String(mount.access)) ||
+        !['agent', 'current_space', 'ancestor_space'].includes(String(mount.source))) {
+        throw new Error('Invalid Memory mount response from server');
+    }
+    return mount;
+}
+function parseMountedMemoryStore(value) {
+    const store = value;
+    if (!store || typeof store !== 'object' || typeof store.id !== 'string' ||
+        typeof store.revision !== 'number' || typeof store.authorizationGeneration !== 'number' ||
+        !store.owner || !['agent', 'space'].includes(String(store.owner.kind)) ||
+        typeof store.owner.id !== 'string') {
+        throw new Error('Invalid Memory Store response from server');
+    }
+    return { ...store, mount: parseMemoryMount(store.mount) };
+}
 exports.scopedMemoryFlags = {
     agent: core_1.Flags.string({ description: 'Act through this Agent', required: true }),
     space: core_1.Flags.string({ description: 'Current Space context (required for Space scopes)' }),
@@ -126,7 +150,7 @@ class ScopedMemoryCommand extends base_command_1.BaseCommand {
     async resolveStore(flags, { write = false } = {}) {
         if (flags.store) {
             const rawStore = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(flags.store)}${this.query(flags)}`);
-            const store = data_schemas_1.MountedMemoryStoreSchema.parse(rawStore);
+            const store = parseMountedMemoryStore(rawStore);
             if (write && store.mount?.access !== 'read_write') {
                 this.error('MEMORY_STORE_READ_ONLY: selected Store is read-only', { exit: 5 });
             }
@@ -143,7 +167,7 @@ class ScopedMemoryCommand extends base_command_1.BaseCommand {
             this.error(`MEMORY_SPACE_CONTEXT_REQUIRED: --space ${id} is required when selecting ${flags.scope}.`, { exit: 2, code: 'MEMORY_SPACE_CONTEXT_REQUIRED' });
         }
         const response = await this.memoryApi(flags.agent, `/stores${this.query(flags)}`);
-        const stores = response.stores.map((store) => data_schemas_1.MountedMemoryStoreSchema.parse(store));
+        const stores = response.stores.map(parseMountedMemoryStore);
         const store = stores.find((candidate) => candidate.owner.kind === kind && candidate.owner.id === id);
         if (!store)
             this.error(`MEMORY_NOT_MOUNTED: ${flags.scope}`, { exit: 5 });

package/dist/node_modules/@skrr-ai/data-provider/index.js

@@ -46542,10 +46542,10 @@ var gR = Object.freeze({ __proto__: null, acceptAgentIntuition: function(e2, t2,
 }, setAgentUsageCap: function(e2, t2) {
   return oR.put(Nn(e2), t2);
 }, setAgentVisibility: function(e2) {
-  var t2 = e2.agentId, n2 = e2.isPublic, o2 = e2.price, r2 = e2.shareMode, a2 = e2.changelog, i2 = e2.versionMajor, s2 = e2.versionMinor, c2 = e2.capabilityRationales, l2 = e2.supportedLanguages, u2 = e2.license, d2 = e2.sourceVisibility, p2 = { isPublic: n2 };
-  return void 0 !== o2 && (p2.price = o2), void 0 !== r2 && (p2.shareMode = r2), void 0 !== a2 && (p2.changelog = a2), void 0 !== i2 && (p2.versionMajor = i2), void 0 !== s2 && (p2.versionMinor = s2), void 0 !== c2 && (p2.capabilityRationales = c2), void 0 !== l2 && (p2.supportedLanguages = l2), void 0 !== u2 && (p2.license = u2), void 0 !== d2 && (p2.sourceVisibility = d2), oR.post((function(e3) {
+  var t2 = e2.agentId, n2 = e2.isPublic, o2 = e2.price, r2 = e2.shareMode, a2 = e2.changelog, i2 = e2.versionMajor, s2 = e2.versionMinor, c2 = e2.capabilityRationales, l2 = e2.supportedLanguages, u2 = e2.dependencies, d2 = e2.license, p2 = e2.sourceVisibility, m2 = { isPublic: n2 };
+  return void 0 !== o2 && (m2.price = o2), void 0 !== r2 && (m2.shareMode = r2), void 0 !== a2 && (m2.changelog = a2), void 0 !== i2 && (m2.versionMajor = i2), void 0 !== s2 && (m2.versionMinor = s2), void 0 !== c2 && (m2.capabilityRationales = c2), void 0 !== l2 && (m2.supportedLanguages = l2), void 0 !== u2 && (m2.dependencies = u2), void 0 !== d2 && (m2.license = d2), void 0 !== p2 && (m2.sourceVisibility = p2), oR.post((function(e3) {
     return "".concat(en, "/api/agents/").concat(e3, "/visibility");
-  })(t2), p2);
+  })(t2), m2);
 }, setAlwaysOnDesired: function(e2, t2) {
   return oR.put((n2 = e2, "".concat(en, "/api/agents/").concat(encodeURIComponent(n2), "/always-on")), t2);
   var n2;