@skrr-ai/cli 0.1.22 → 0.1.23

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+const memory_sync_1 = require("../../../lib/memory-sync");
+class MemorySyncResolve extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Resolve one local sync conflict explicitly';
+    static args = { conflict: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.mutationFlags,
+        dir: core_1.Flags.string({ required: true }),
+        strategy: core_1.Flags.string({ required: true, options: ['keep-local', 'keep-remote', 'manual'] }),
+        content: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemorySyncResolve);
+        if (flags.strategy === 'manual' && !flags.content)
+            this.error('--content is required with --strategy manual.', { exit: 2 });
+        if (flags['dry-run']) {
+            return this.print({ dryRun: true, conflictId: args.conflict, strategy: flags.strategy }, flags.json, `Would resolve ${args.conflict} with ${flags.strategy}.`);
+        }
+        const result = await (0, memory_sync_1.resolveConflict)(flags.dir, args.conflict, flags.strategy, flags.content);
+        this.print(result, flags.json, `Resolved sync conflict ${args.conflict} with ${flags.strategy}.`);
+    }
+}
+exports.default = MemorySyncResolve;

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

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

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

@@ -0,0 +1,22 @@
+"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");
+class MemorySyncStatus extends base_command_1.BaseCommand {
+    static description = 'Show local materialized-mount sync status';
+    static flags = { dir: core_1.Flags.string({ required: true }), json: core_1.Flags.boolean() };
+    async run() {
+        const { flags } = await this.parse(MemorySyncStatus);
+        const result = await (0, memory_sync_1.syncStatus)(flags.dir);
+        if (flags.json)
+            this.log(JSON.stringify(result, null, 2));
+        else {
+            this.log(`Sync ${result.status || 'unknown'} at cursor ${result.cursor || '0'}; ${result.changed || 0} local change(s), ${result.conflicts || 0} conflict(s).`);
+            const nextActions = Array.isArray(result.nextActions) ? result.nextActions : [];
+            for (const action of nextActions)
+                this.log(`Next: ${action}`);
+        }
+    }
+}
+exports.default = MemorySyncStatus;

package/dist/commands/memory/topics/archive.d.ts

@@ -0,0 +1,20 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsArchive extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | 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/topics/archive.js

@@ -0,0 +1,29 @@
+"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 MemoryTopicsArchive extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Archive a Memory topic without suppression';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = scoped_memory_command_1.versionedMutationFlags;
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsArchive);
+        const result = (await this.mutation('archive', flags, { memoryId: args.id }));
+        const selector = flags.store ? `--store ${flags.store}` : `--scope ${flags.scope}`;
+        const context = [
+            `--agent ${flags.agent}`,
+            selector,
+            ...(flags.space ? [`--space ${flags.space}`] : []),
+        ].join(' ');
+        const archivedHead = result?.node?.headVersionId || result?.version?.version?.id || 'CURRENT_ARCHIVED_HEAD';
+        this.print(result, flags.json, flags['dry-run']
+            ? 'Dry run: no topic archived.'
+            : [
+                `Archived Memory topic ${args.id}.`,
+                `List restorable history: skrr memory versions list ${args.id} ${context}`,
+                `Restore a chosen historical version: skrr memory versions restore VERSION_ID ${context} --expected-version ${archivedHead}`,
+            ].join('\n'));
+    }
+}
+exports.default = MemoryTopicsArchive;

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

@@ -0,0 +1,23 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsCreate extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        content: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        kind: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        confidence: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        source: 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>;
+}

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+const MEMORY_KINDS = [
+    'profile',
+    'preference',
+    'entity',
+    'event',
+    'belief',
+    'experience',
+    'procedure',
+    'relationship',
+    'observation',
+    'custom',
+];
+class MemoryTopicsCreate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Create a versioned semantic Memory topic';
+    static flags = {
+        ...scoped_memory_command_1.mutationFlags,
+        path: core_1.Flags.string({ required: true }),
+        content: core_1.Flags.string({ required: true }),
+        title: core_1.Flags.string(),
+        kind: core_1.Flags.string({
+            description: 'Canonical Memory kind',
+            options: [...MEMORY_KINDS],
+        }),
+        confidence: core_1.Flags.string(),
+        source: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryTopicsCreate);
+        const result = await this.mutation('encode', flags, {
+            path: flags.path,
+            content: flags.content,
+            title: flags.title,
+            memoryKind: flags.kind,
+            confidence: flags.confidence === undefined ? undefined : Number(flags.confidence),
+            source: flags.source,
+            episode: null,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no topic created.' : 'Memory topic created.');
+    }
+}
+exports.default = MemoryTopicsCreate;

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

@@ -0,0 +1,22 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsDelete extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: 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>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | 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/topics/delete.js

@@ -0,0 +1,30 @@
+"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 MemoryTopicsDelete extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Permanently delete topic content while retaining redacted audit metadata';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.versionedMutationFlags,
+        reason: core_1.Flags.string(),
+        yes: core_1.Flags.boolean({ char: 'y' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsDelete);
+        if (!flags['dry-run']) {
+            const ok = await (0, prompt_1.confirmDestructive)(`Permanently redact and delete Memory topic ${args.id}?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+            if (!ok)
+                return this.log('Cancelled.');
+        }
+        const result = await this.mutation('delete', flags, {
+            memoryId: args.id,
+            confirmMemoryId: args.id,
+            reason: flags.reason,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no topic deleted.' : `Deleted Memory topic ${args.id}.`);
+    }
+}
+exports.default = MemoryTopicsDelete;

package/dist/commands/memory/topics/forget.d.ts

@@ -0,0 +1,22 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsForget extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: 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>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | 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/topics/forget.js

@@ -0,0 +1,29 @@
+"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 MemoryTopicsForget extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Forget a topic and suppress implicit resurrection';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.versionedMutationFlags,
+        reason: core_1.Flags.string(),
+        yes: core_1.Flags.boolean({ char: 'y' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsForget);
+        if (!flags['dry-run']) {
+            const ok = await (0, prompt_1.confirmDestructive)(`Forget Memory topic ${args.id} and suppress its content?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+            if (!ok)
+                return this.log('Cancelled.');
+        }
+        const result = await this.mutation('forget', flags, {
+            memoryId: args.id,
+            reason: flags.reason,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no topic forgotten.' : `Forgot Memory topic ${args.id}.`);
+    }
+}
+exports.default = MemoryTopicsForget;

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

@@ -0,0 +1,13 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsList extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        archived: 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/topics/list.js

@@ -0,0 +1,22 @@
+"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 MemoryTopicsList extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'List semantic Memory topics in one mounted Store';
+    static flags = { ...scoped_memory_command_1.scopedMemoryFlags, archived: core_1.Flags.boolean() };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryTopicsList);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/tree${this.query(flags, { includeArchived: flags.archived })}`);
+        const topics = result.nodes.filter((node) => node.nodeKind === 'memory');
+        if (flags.json)
+            return this.log(JSON.stringify({ storeId: store.id, topics }, null, 2));
+        for (const topic of topics)
+            this.log(`${topic.id}  ${topic.path}  ${topic.title}  r${topic.revision}`);
+        if (!topics.length)
+            this.log('No Memory topics.');
+    }
+}
+exports.default = MemoryTopicsList;

package/dist/commands/memory/topics/move.d.ts

@@ -0,0 +1,22 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsMove extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | 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/topics/move.js

@@ -0,0 +1,26 @@
+"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 MemoryTopicsMove extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Move a Memory topic or subtree to a new semantic path';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.versionedMutationFlags,
+        path: core_1.Flags.string({ required: true }),
+        title: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsMove);
+        const result = await this.mutation('move', flags, {
+            memoryId: args.id,
+            path: flags.path,
+            title: flags.title,
+        });
+        this.print(result, flags.json, flags['dry-run']
+            ? 'Dry run: no topic moved.'
+            : `Moved Memory topic ${args.id} to ${flags.path}.`);
+    }
+}
+exports.default = MemoryTopicsMove;

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

@@ -0,0 +1,17 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsShow extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        level: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        facts: 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/topics/show.js

@@ -0,0 +1,21 @@
+"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 MemoryTopicsShow extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Show one semantic Memory topic';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        level: core_1.Flags.string({ options: ['L0', 'L1', 'L2'], default: 'L1' }),
+        facts: core_1.Flags.boolean(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsShow);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/topics/${encodeURIComponent(args.id)}${this.query(flags, { level: flags.level, includeFacts: flags.facts })}`);
+        this.print(result, flags.json, `${result.node.path}\n${result.representation?.content || '(no projection)'}`);
+    }
+}
+exports.default = MemoryTopicsShow;

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

@@ -0,0 +1,23 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsUpdate extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        content: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        confidence: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        source: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | 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/topics/update.js

@@ -0,0 +1,27 @@
+"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 MemoryTopicsUpdate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Reconsolidate a Memory topic using optimistic version CAS';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.versionedMutationFlags,
+        content: core_1.Flags.string({ required: true }),
+        confidence: core_1.Flags.string(),
+        source: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsUpdate);
+        const result = await this.mutation('reconsolidate', flags, {
+            memoryId: args.id,
+            content: flags.content,
+            confidence: flags.confidence === undefined ? undefined : Number(flags.confidence),
+            source: flags.source,
+            episode: null,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no topic updated.' : `Updated Memory topic ${args.id}.`);
+    }
+}
+exports.default = MemoryTopicsUpdate;

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

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

package/dist/commands/memory/tree.js

@@ -2,17 +2,33 @@
 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");
-class MemoryTree extends base_command_1.BaseCommand {
+const scoped_memory_command_1 = require("../../lib/scoped-memory-command");
+class MemoryTree extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Browse an agent-maintained semantic memory tree and its L0 summaries';
     static flags = {
         agent: core_1.Flags.string({ description: 'Agent ID', required: true }),
         archived: core_1.Flags.boolean({ description: 'Include archived nodes', default: false }),
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        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: core_1.Flags.string({ description: 'Current Space context' }),
     };
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(MemoryTree);
+        if (flags.store || flags.scope) {
+            const store = await this.resolveStore(flags);
+            const result = await this.memoryApi(flags.agent, `/stores/${store.id}/tree${this.query(flags, { includeArchived: flags.archived })}`);
+            if (flags.json)
+                return this.log(JSON.stringify({ storeId: store.id, ...result }, null, 2));
+            for (const node of result.nodes) {
+                const depth = node.path === '/' ? 0 : node.path.split('/').filter(Boolean).length;
+                this.log(`${'  '.repeat(depth)}${node.nodeKind === 'folder' ? '▸' : '•'} ${node.title}  ${node.path}`);
+            }
+            if (!result.nodes.length)
+                this.log('No Memory nodes.');
+            return;
+        }
         let response;
         try {
             response = await data_provider_1.dataService.getAgentMemoryWorkspaceTree(flags.agent, {
@@ -34,6 +50,8 @@ class MemoryTree extends base_command_1.BaseCommand {
             if (abstract)
                 this.log(`${'  '.repeat(depth + 1)}${abstract}`);
         }
+        if (!response.nodes.length)
+            this.log('No Memory nodes.');
         this.printAgentUrl(flags.agent);
     }
 }

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

@@ -8,7 +8,7 @@ export default class MemoryUpdate 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>;
         value: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         rename: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

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

@@ -0,0 +1,16 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsList extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        memory: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, 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/versions/list.js

@@ -0,0 +1,22 @@
+"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 MemoryVersionsList extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'List immutable versions for one Memory topic';
+    static args = { memory: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = { ...scoped_memory_command_1.scopedMemoryFlags, limit: core_1.Flags.integer({ default: 100 }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryVersionsList);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/versions${this.query(flags, { memoryId: args.memory, limit: flags.limit })}`);
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        for (const version of result.versions)
+            this.log(`${version.id}  ${version.operation}  ${version.createdAt}  ${version.contentHash || '[redacted]'}`);
+        if (!result.versions.length)
+            this.log('No Memory versions.');
+    }
+}
+exports.default = MemoryVersionsList;

package/dist/commands/memory/versions/redact.d.ts

@@ -0,0 +1,21 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsRedact extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        '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>;
+}