@skrr-ai/cli 0.1.22 → 0.1.24

package/dist/commands/memory/proposals/promote.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryProposalsPromote extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Consume a one-time approval and promote an Agent topic into the current Space Store';
+    static flags = {
+        ...scoped_memory_command_1.mutationFlags,
+        'source-store': core_1.Flags.string({ required: true, description: 'Mounted Agent Store ID' }),
+        'source-memory': core_1.Flags.string({ required: true, description: 'Agent Memory topic ID' }),
+        'source-version': core_1.Flags.string({
+            required: true,
+            description: 'Current Agent topic version ID',
+        }),
+        'consent-approval': core_1.Flags.string({
+            required: true,
+            description: 'One-time space_promotion approval ID from memory approvals issue',
+        }),
+        path: core_1.Flags.string({ description: 'Optional destination path in the Space Store' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryProposalsPromote);
+        const result = await this.mutation('promote', flags, {
+            sourceStoreId: flags['source-store'],
+            sourceMemoryId: flags['source-memory'],
+            sourceExpectedVersionId: flags['source-version'],
+            path: flags.path,
+        });
+        this.print(result, flags.json, `Promoted Agent topic ${flags['source-memory']} to Space Memory.`);
+    }
+}
+exports.default = MemoryProposalsPromote;

package/dist/commands/memory/proposals/reject.d.ts

@@ -0,0 +1,16 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryProposalsReject extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        proposalId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/proposals/reject.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryProposalsReject extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Reject a Store-scoped Memory proposal';
+    static args = {
+        proposalId: core_1.Args.string({ description: 'Proposal ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        reason: core_1.Flags.string({ description: 'Decision reason recorded on the proposal' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryProposalsReject);
+        const store = await this.resolveStore(flags, { write: true });
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/proposals/${encodeURIComponent(args.proposalId)}/reject`, {
+            method: 'POST',
+            body: {
+                ...(flags.space ? { spaceId: flags.space } : {}),
+                ...(flags.reason ? { reason: flags.reason } : {}),
+            },
+        });
+        this.print(result, flags.json, `Rejected Memory proposal ${args.proposalId}.`);
+    }
+}
+exports.default = MemoryProposalsReject;

package/dist/commands/memory/rebuild-index.d.ts

@@ -0,0 +1,20 @@
+import { ScopedMemoryCommand } from '../../lib/scoped-memory-command';
+export default class MemoryRebuildIndex extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        ref: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'privacy-approval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/rebuild-index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../lib/scoped-memory-command");
+class MemoryRebuildIndex extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Rebuild generated Memory projections and MEMORY.md indexes';
+    static args = { ref: core_1.Args.string({ required: false, default: '/', ignoreStdin: true }) };
+    static flags = scoped_memory_command_1.mutationFlags;
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryRebuildIndex);
+        const store = await this.resolveStore(flags, { write: true });
+        const body = /^[0-9a-f-]{36}$/i.test(args.ref)
+            ? { memoryId: args.ref, spaceId: flags.space }
+            : { path: args.ref, spaceId: flags.space };
+        const result = flags['dry-run']
+            ? { dryRun: true, request: body }
+            : await this.memoryApi(flags.agent, `/stores/${store.id}/rebuild-index`, {
+                method: 'POST',
+                body,
+            });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no index rebuilt.' : `Rebuilt Memory index for ${args.ref}.`);
+    }
+}
+exports.default = MemoryRebuildIndex;

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

@@ -5,7 +5,7 @@ export default class MemorySave extends BaseCommand {
     static flags: {
         agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         tier: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pool-workspace': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         key: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/memory/save.js

@@ -12,7 +12,7 @@ class MemorySave extends base_command_1.BaseCommand {
         '<%= 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 --workspace ws_123',
+        '<%= 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',
     ];
     static flags = {

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

@@ -1,14 +1,17 @@
-import { BaseCommand } from '../../base-command';
-export default class MemorySearch extends BaseCommand {
+import { ScopedMemoryCommand } from '../../lib/scoped-memory-command';
+export default class MemorySearch extends ScopedMemoryCommand {
     static description: string;
     static examples: string[];
     static args: {
         query: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'space-context': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         tier: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pool-workspace': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'max-results': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         'min-score': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/memory/search.js

@@ -2,15 +2,15 @@
 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 scoped_memory_command_1 = require("../../lib/scoped-memory-command");
 const format_1 = require("../../lib/format");
 const memory_scope_1 = require("../../lib/memory-scope");
-class MemorySearch extends base_command_1.BaseCommand {
+class MemorySearch extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Semantic (hybrid vector + text) search over a memory pool — the same ranking the agent sees';
     static examples = [
         '<%= config.bin %> memory search "dark mode preference"',
         '<%= config.bin %> memory search "billing" --agent agent_abc123',
-        '<%= config.bin %> memory search "team norms" --tier workspace --workspace ws_123',
+        '<%= config.bin %> memory search "team norms" --tier workspace --pool-workspace ws_123',
         '<%= config.bin %> memory search "onboarding" --max-results 10 --json',
     ];
     static args = {
@@ -21,10 +21,34 @@ class MemorySearch extends base_command_1.BaseCommand {
         'max-results': core_1.Flags.integer({ description: 'Maximum results (1-50)', default: 6 }),
         'min-score': core_1.Flags.string({ description: 'Minimum score 0-1 (default: 0.35)' }),
         ...memory_scope_1.memoryScopeFlags,
+        store: core_1.Flags.string({ description: 'Canonical Memory Store ID' }),
+        scope: core_1.Flags.string({ description: 'Canonical owner scope: agent:<id> or space:<id>' }),
+        'space-context': core_1.Flags.string({ description: 'Current Space context for canonical mounts' }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(MemorySearch);
+        if (flags.store || flags.scope) {
+            if (!flags.agent)
+                this.error('--agent is required with --store or --scope.', { exit: 2 });
+            const canonicalFlags = {
+                agent: flags.agent,
+                store: flags.store,
+                scope: flags.scope,
+                space: flags['space-context'],
+                json: flags.json,
+            };
+            const store = await this.resolveStore(canonicalFlags);
+            const response = await this.memoryApi(flags.agent, `/stores/${store.id}/search${this.query(canonicalFlags, { q: args.query, limit: flags['max-results'] })}`);
+            if (flags.json)
+                this.log(JSON.stringify(response, null, 2));
+            else if (!response.results?.length)
+                this.log(`No memories matched "${args.query}".`);
+            else
+                for (const result of response.results)
+                    this.log(`${Number(result.score || 0).toFixed(2)}  ${result.node.path}  ${result.content}`);
+            return;
+        }
         const scope = (0, memory_scope_1.resolveMemoryScopeOrFail)(flags, (m) => this.error(m, { exit: 1 }));
         let minScore;
         if (flags['min-score'] !== undefined) {

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

@@ -8,7 +8,7 @@ export default class MemoryShow extends BaseCommand {
     static flags: {
         agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         tier: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pool-workspace': 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/memory/stores/archive.d.ts

@@ -0,0 +1,14 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresArchive extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/stores/archive.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresArchive extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Archive a Memory Store before deletion';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without archiving the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresArchive);
+        const store = await this.resolveStore(flags, { write: true });
+        const body = {
+            status: 'archived',
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'PATCH',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store changed.' : `Archived Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresArchive;

package/dist/commands/memory/stores/create.d.ts

@@ -0,0 +1,12 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresCreate extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        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>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresCreate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Ensure the authorized Agent or current Space Memory Store exists';
+    static flags = {
+        agent: core_1.Flags.string({ required: true }),
+        space: core_1.Flags.string(),
+        scope: core_1.Flags.string({ required: true, description: 'agent:<id> or space:<id>' }),
+        json: core_1.Flags.boolean(),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without creating the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresCreate);
+        const body = {
+            scope: flags.scope,
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, '/stores', { method: 'POST', body });
+        this.print(result, flags.json, flags['dry-run']
+            ? 'Dry run: Store ensure request passed server validation.'
+            : `Memory Store ${result.id} is ready.`);
+    }
+}
+exports.default = MemoryStoresCreate;

package/dist/commands/memory/stores/delete.d.ts

@@ -0,0 +1,15 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresDelete extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/stores/delete.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const prompt_1 = require("../../../lib/prompt");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresDelete extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Permanently delete an already-archived Memory Store';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        yes: core_1.Flags.boolean({ char: 'y' }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without deleting the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresDelete);
+        const store = await this.resolveStore(flags, { write: true });
+        if (!flags['dry-run']) {
+            const ok = await (0, prompt_1.confirmDestructive)(`Permanently delete archived Memory Store ${store.id}?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+            if (!ok)
+                return this.log('Cancelled.');
+        }
+        const body = {
+            confirmStoreId: store.id,
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'DELETE',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store deleted.' : `Deleted Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresDelete;

package/dist/commands/memory/stores/list.d.ts

@@ -0,0 +1,10 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresList extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        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>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,29 @@
+"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';
+    static flags = {
+        agent: core_1.Flags.string({ required: true }),
+        space: core_1.Flags.string({ description: 'Current Space context' }),
+        json: core_1.Flags.boolean({ description: 'Output stable JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        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)),
+        };
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        for (const store of result.stores) {
+            this.log(`${store.id}  ${store.owner.kind}:${store.owner.id}  ${store.mount.access}  r${store.revision}`);
+        }
+        if (!result.stores.length)
+            this.log('No mounted Memory Stores.');
+    }
+}
+exports.default = MemoryStoresList;

package/dist/commands/memory/stores/show.d.ts

@@ -0,0 +1,12 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresShow extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/stores/show.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresShow extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Show one mounted Memory Store';
+    static flags = scoped_memory_command_1.scopedMemoryFlags;
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresShow);
+        const store = await this.resolveStore(flags);
+        this.print(store, flags.json, `${store.id}  ${store.owner.kind}:${store.owner.id}  ${store.status}  r${store.revision}`);
+    }
+}
+exports.default = MemoryStoresShow;

package/dist/commands/memory/stores/update.d.ts

@@ -0,0 +1,15 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresUpdate extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        attributes: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/stores/update.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresUpdate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Update Memory Store metadata with revision CAS';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        attributes: core_1.Flags.string({ description: 'Complete attributes JSON object', required: true }),
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without updating the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresUpdate);
+        const store = await this.resolveStore(flags, { write: true });
+        let attributes;
+        try {
+            attributes = JSON.parse(flags.attributes);
+        }
+        catch {
+            this.error('--attributes must be valid JSON.', { exit: 2 });
+        }
+        const body = {
+            attributes,
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'PATCH',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store changed.' : `Updated Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresUpdate;

package/dist/commands/memory/sync/delete.d.ts

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

package/dist/commands/memory/sync/delete.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const memory_sync_1 = require("../../../lib/memory-sync");
+const prompt_1 = require("../../../lib/prompt");
+class MemorySyncDelete extends base_command_1.BaseCommand {
+    static description = 'Delete a local topic file and stage its version-bound tombstone for the next sync push';
+    static args = {
+        memoryId: core_1.Args.string({
+            description: 'Materialized Memory topic ID',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Materialized Memory directory', required: true }),
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Confirm local deletion without prompting' }),
+        json: core_1.Flags.boolean({ description: 'Output stable JSON' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MemorySyncDelete);
+        const ok = await (0, prompt_1.confirmDestructive)(`Delete the local file for Memory topic ${args.memoryId} and stage its permanent deletion?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+        if (!ok)
+            return this.log('Cancelled.');
+        const result = await (0, memory_sync_1.stageLocalDelete)(flags.dir, args.memoryId);
+        if (flags.json)
+            this.log(JSON.stringify(result, null, 2));
+        else {
+            this.log(`Staged deletion of ${result.file}.`);
+            this.log('Run `skrr memory sync push` with the same Store context to commit it.');
+        }
+    }
+}
+exports.default = MemorySyncDelete;

package/dist/commands/memory/sync/pull.d.ts

@@ -0,0 +1,19 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemorySyncPull extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'privacy-approval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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>;
+}