@skrr-ai/cli 0.1.22 → 0.1.24

package/dist/commands/machines/dedicated/start.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const dedicated_machines_1 = require("../../../lib/dedicated-machines");
+class DedicatedMachinesStart extends base_command_1.BaseCommand {
+    static description = 'Start a Dedicated Runtime lease';
+    static examples = [
+        '<%= config.bin %> machines dedicated start <lease-id>',
+        '<%= config.bin %> machines dedicated start <lease-id> --json',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: 'Dedicated Runtime lease id',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesStart);
+        let response;
+        try {
+            response = await (0, dedicated_machines_1.performDedicatedLeaseAction)(args.lease, 'start');
+        }
+        catch (err) {
+            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
+            if (message)
+                this.error(message, { exit: 1 });
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(response?.lease)} ${(0, dedicated_machines_1.dedicatedLeaseState)(response?.lease)}.`);
+    }
+}
+exports.default = DedicatedMachinesStart;

package/dist/commands/machines/dedicated/stop.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../base-command';
+export default class DedicatedMachinesStop extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/machines/dedicated/stop.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const dedicated_machines_1 = require("../../../lib/dedicated-machines");
+class DedicatedMachinesStop extends base_command_1.BaseCommand {
+    static description = 'Stop a Dedicated Runtime lease';
+    static examples = [
+        '<%= config.bin %> machines dedicated stop <lease-id>',
+        '<%= config.bin %> machines dedicated stop <lease-id> --json',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: 'Dedicated Runtime lease id',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesStop);
+        let response;
+        try {
+            response = await (0, dedicated_machines_1.performDedicatedLeaseAction)(args.lease, 'stop');
+        }
+        catch (err) {
+            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
+            if (message)
+                this.error(message, { exit: 1 });
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(response?.lease)} ${(0, dedicated_machines_1.dedicatedLeaseState)(response?.lease)}.`);
+    }
+}
+exports.default = DedicatedMachinesStop;

package/dist/commands/machines/hosted/index.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 class Machines extends core_1.Command {
-    static description = 'Manage skrr Hosted Machine workspaces';
+    // Paired with `machines dedicated`, and the pairing is the point: this one
+    // resumes, that one restarts. Stated here so the choice can be made without
+    // opening either topic.
+    static description = 'A managed workspace that resumes — files, memory and running processes survive pause';
     static examples = [
         '<%= config.bin %> machines hosted start --name scratch --wait',
         '<%= config.bin %> machines hosted list',

package/dist/commands/machines/list.d.ts

@@ -8,6 +8,7 @@ export default class MachinesList extends BaseCommand {
     static examples: string[];
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/machines/list.js

@@ -14,7 +14,19 @@ class MachinesList extends base_command_1.BaseCommand {
         '<%= config.bin %> machines list',
         '<%= config.bin %> machines list --json',
     ];
-    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        // `harnesses list` already learned this: "Offline rows accumulate forever,
+        // so they are hidden by default." The same reasoning was never applied
+        // here, and this listing returned 252 rows for one account — every
+        // ephemeral sandbox ever provisioned, months back, all rendered `offline`,
+        // with the one live machine at the top and a wall of dead ones after it
+        // (OSK-7639). A list exists so someone can pick a row.
+        all: core_1.Flags.boolean({
+            description: 'Include machines that are offline or terminated. Off by default — dead sandboxes ' +
+                'accumulate forever and bury the ones you can use.',
+        }),
+    };
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(MachinesList);
@@ -33,10 +45,21 @@ class MachinesList extends base_command_1.BaseCommand {
             this.log('No machines. Install a daemon with `skrr harnesses install-token`.');
             return;
         }
-        (0, format_1.renderTable)(machines.map((m) => ({
-            id: (0, format_1.formatCell)(m.id).slice(0, 20),
+        const all = machines;
+        const shown = flags.all ? all : all.filter((m) => (0, machines_1.isReachableMachine)(m));
+        if (shown.length === 0) {
+            this.log(`No machine is reachable right now. ${all.length} offline/terminated — see them with --all.`);
+            return;
+        }
+        (0, format_1.renderTable)(shown.map((m) => ({
+            // Printed in full. A hard 20-character slice with no ellipsis made
+            // `machine:03548116-d36` read like a complete id and it is not — and
+            // two different hosted machines rendered as byte-identical rows,
+            // so the one column a list exists to be picked from could not
+            // distinguish them (OSK-7621).
+            id: (0, format_1.formatCell)(m.id),
             name: (0, format_1.formatCell)(m.preferences?.name || m.name),
-            status: (0, format_1.formatCell)(m.status),
+            status: (0, format_1.formatCell)((0, machines_1.machineStateLabel)(m)),
             // Both numbers matter: "2/7" is a machine that is up with most of its
             // harnesses signed out, which reads nothing like "7/7". The
             // denominator counts LIVE rows, matching the population
@@ -48,13 +71,18 @@ class MachinesList extends base_command_1.BaseCommand {
                 ? new Date(m.lastSeenAt).toISOString().slice(0, 16).replace('T', ' ')
                 : '-',
         })), [
-            { key: 'id', header: 'ID' },
+            { key: 'id', header: 'ID', verbatim: true },
             { key: 'name', header: 'NAME', maxWidth: 28 },
             { key: 'status', header: 'STATUS' },
             { key: 'harnesses', header: 'ONLINE' },
             { key: 'platform', header: 'PLATFORM' },
             { key: 'seen', header: 'LAST SEEN' },
         ], (line) => this.log(line));
+        const hidden = all.length - shown.length;
+        if (hidden > 0) {
+            this.log('');
+            this.log(`${hidden} offline or terminated machine(s) hidden — pass --all to include them.`);
+        }
     }
 }
 exports.default = MachinesList;

package/dist/commands/memory/approvals/issue.d.ts

@@ -0,0 +1,18 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryApprovalsIssue extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        purpose: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        payload: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-store': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-memory': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        ttl: 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/approvals/issue.js

@@ -0,0 +1,63 @@
+"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 MemoryApprovalsIssue extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Issue a short-lived user approval for Space PII or Agent-to-Space promotion';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        purpose: core_1.Flags.string({
+            description: 'Approval purpose',
+            options: ['space_pii', 'space_promotion'],
+            required: true,
+        }),
+        payload: core_1.Flags.string({
+            description: 'Exact mutation-policy JSON payload for a space_pii approval',
+        }),
+        'source-store': core_1.Flags.string({ description: 'Agent Store ID for space_promotion' }),
+        'source-memory': core_1.Flags.string({ description: 'Agent Memory topic ID for space_promotion' }),
+        'source-version': core_1.Flags.string({ description: 'Current Agent Memory version for promotion' }),
+        ttl: core_1.Flags.integer({ description: 'Approval lifetime in seconds (30-900)', default: 300 }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryApprovalsIssue);
+        const store = await this.resolveStore(flags, { write: true });
+        if (store.owner.kind !== 'space' || store.mount?.source !== 'current_space') {
+            this.error('MEMORY_APPROVAL_TARGET_INVALID: approvals require the current Space Store.', {
+                exit: 5,
+                code: 'MEMORY_APPROVAL_TARGET_INVALID',
+            });
+        }
+        let payload;
+        if (flags.purpose === 'space_pii') {
+            if (!flags.payload) {
+                this.error('--payload JSON is required for --purpose space_pii.', { exit: 2 });
+            }
+            try {
+                payload = JSON.parse(flags.payload);
+            }
+            catch {
+                this.error('--payload must be valid JSON.', { exit: 2 });
+            }
+        }
+        else if (!flags['source-store'] || !flags['source-memory'] || !flags['source-version']) {
+            this.error('--source-store, --source-memory, and --source-version are required for space_promotion.', { exit: 2 });
+        }
+        const result = await this.memoryApi(flags.agent, '/approvals', {
+            method: 'POST',
+            body: {
+                spaceId: flags.space,
+                purpose: flags.purpose,
+                targetStoreId: store.id,
+                ttlSeconds: flags.ttl,
+                ...(payload ? { payload } : {}),
+                ...(flags['source-store'] ? { sourceStoreId: flags['source-store'] } : {}),
+                ...(flags['source-memory'] ? { sourceMemoryId: flags['source-memory'] } : {}),
+                ...(flags['source-version'] ? { sourceVersionId: flags['source-version'] } : {}),
+            },
+        });
+        this.print(result, flags.json, `Issued ${result.purpose} approval ${result.approvalId}; expires ${result.expiresAt}.`);
+    }
+}
+exports.default = MemoryApprovalsIssue;

package/dist/commands/memory/commit.js

@@ -28,8 +28,11 @@ class MemoryCommit extends base_command_1.BaseCommand {
         if (flags.json)
             this.log(this.agentJson(flags.agent, result));
         else {
-            this.log(`${result.outcome || 'committed'}: ${result.node.path}`);
-            this.log(result.fact.claim);
+            this.log(`${result.outcome || 'committed'}: ${result.node?.path || result.node?.id || args.proposal}`);
+            if (result.fact?.claim)
+                this.log(result.fact.claim);
+            else if (result.fact?.id)
+                this.log(`Fact: ${result.fact.id}`);
             this.printAgentUrl(flags.agent);
         }
     }

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

@@ -1,11 +1,12 @@
-import { BaseCommand } from '../../base-command';
-export default class MemoryContext extends BaseCommand {
+import { ScopedMemoryCommand } from '../../lib/scoped-memory-command';
+export default class MemoryContext extends ScopedMemoryCommand {
     static description: string;
     static args: {
         query: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     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>;
         tokens: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         level: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         nodes: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/memory/context.js

@@ -1,13 +1,13 @@
 "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");
-class MemoryContext extends base_command_1.BaseCommand {
+const scoped_memory_command_1 = require("../../lib/scoped-memory-command");
+class MemoryContext extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Preview the hierarchical memory context assembled for a query';
     static args = { query: core_1.Args.string({ required: true, ignoreStdin: true }) };
     static flags = {
         agent: core_1.Flags.string({ required: true }),
+        space: core_1.Flags.string({ description: 'Current Space context; includes its mounted Store' }),
         tokens: core_1.Flags.integer({ default: 2000 }),
         level: core_1.Flags.string({ options: ['L0', 'L1', 'L2'], default: 'L2' }),
         nodes: core_1.Flags.integer({ default: 12 }),
@@ -17,19 +17,17 @@ class MemoryContext extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(MemoryContext);
-        let result;
-        try {
-            result = await data_provider_1.dataService.assembleAgentMemoryContext(flags.agent, {
+        const result = await this.memoryApi(flags.agent, '/context', {
+            method: 'POST',
+            body: {
                 query: args.query,
                 maxTokens: flags.tokens,
                 maxLevel: flags.level,
                 maxNodes: flags.nodes,
                 cooldownMinutes: flags.cooldown,
-            });
-        }
-        catch (error) {
-            this.handleApiError(error);
-        }
+                ...(flags.space ? { spaceId: flags.space } : {}),
+            },
+        });
         if (flags.json) {
             this.log(this.agentJson(flags.agent, result));
             return;

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

@@ -8,7 +8,7 @@ export default class MemoryDelete 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>;
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

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

@@ -5,7 +5,7 @@ export default class MemoryList 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/list.js

@@ -12,7 +12,7 @@ class MemoryList extends base_command_1.BaseCommand {
         '<%= config.bin %> memory list --json',
         '<%= config.bin %> memory list --agent agent_abc123',
         '<%= config.bin %> memory list --tier user',
-        '<%= config.bin %> memory list --tier workspace --workspace ws_123',
+        '<%= config.bin %> memory list --tier workspace --pool-workspace ws_123',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),

package/dist/commands/memory/mounts/resolve.d.ts

@@ -0,0 +1,10 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryMountsResolve 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/mounts/resolve.js

@@ -0,0 +1,27 @@
+"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';
+    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(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)) };
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        for (const mount of result.mounts) {
+            this.log(`${mount.source}  ${mount.uri}  ${mount.access}  store=${mount.storeId}  r${mount.storeRevision}  cursor=${mount.cursor}`);
+        }
+        if (!result.mounts.length)
+            this.log('No Memory mounts.');
+    }
+}
+exports.default = MemoryMountsResolve;

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

@@ -0,0 +1,18 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryProposalsCommit 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>;
+        '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>;
+        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/commit.js

@@ -0,0 +1,32 @@
+"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 MemoryProposalsCommit extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Commit a reviewed 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' }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable retry key for the canonical mutation' }),
+        'privacy-approval': core_1.Flags.string({ description: 'One-time approval ID for Space PII' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryProposalsCommit);
+        const store = await this.resolveStore(flags, { write: true });
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/proposals/${encodeURIComponent(args.proposalId)}/commit`, {
+            method: 'POST',
+            body: {
+                ...(flags.space ? { spaceId: flags.space } : {}),
+                ...(flags.reason ? { reason: flags.reason } : {}),
+                ...(flags['idempotency-key'] ? { idempotencyKey: flags['idempotency-key'] } : {}),
+                ...(flags['privacy-approval'] ? { privacyApprovalId: flags['privacy-approval'] } : {}),
+            },
+        });
+        this.print(result, flags.json, `Committed Memory proposal ${args.proposalId}: ${result.mutation?.node?.path || result.proposal?.proposedPath || 'canonical Store updated'}.`);
+    }
+}
+exports.default = MemoryProposalsCommit;

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

@@ -0,0 +1,18 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryProposalsCreate 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>;
+        evidence: 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/create.js

@@ -0,0 +1,56 @@
+"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 MemoryProposalsCreate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Submit a proposal to a mounted Agent or Space Store without changing canonical Memory';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        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(),
+        evidence: core_1.Flags.string({
+            description: 'Attributable source reference (required for Space proposals)',
+            multiple: true,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryProposalsCreate);
+        const store = await this.resolveStore(flags, { write: true });
+        if (store.owner.kind === 'space' && !flags.evidence?.length) {
+            this.error('Space proposals require at least one --evidence <source-ref>.', { exit: 2 });
+        }
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}/proposals`, {
+            method: 'POST',
+            body: {
+                spaceId: flags.space,
+                path: flags.path,
+                claim: flags.content,
+                title: flags.title,
+                memoryKind: flags.kind,
+                confidence: flags.confidence === undefined ? undefined : Number(flags.confidence),
+                evidence: (flags.evidence || []).map((sourceRef) => ({
+                    sourceKind: 'observation',
+                    sourceRef,
+                })),
+            },
+        });
+        this.print(result, flags.json, `Submitted Memory proposal ${result.proposal.id} to ${store.owner.kind}:${store.owner.id}.`);
+    }
+}
+exports.default = MemoryProposalsCreate;

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

@@ -0,0 +1,13 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryProposalsList extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string, 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/list.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 MemoryProposalsList extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'List reviewable proposals in one mounted Memory Store';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        status: core_1.Flags.string({
+            description: 'Proposal status',
+            options: ['proposed', 'accepted', 'merged', 'rejected'],
+            default: 'proposed',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryProposalsList);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/proposals${this.query(flags, { status: flags.status })}`);
+        if (flags.json) {
+            this.log(JSON.stringify({ storeId: store.id, proposals: result.proposals }, null, 2));
+            return;
+        }
+        for (const proposal of result.proposals) {
+            this.log(`${proposal.id}  ${proposal.status}  ${proposal.proposedPath}  ${proposal.title || proposal.claim}`);
+        }
+        if (!result.proposals.length)
+            this.log(`No ${flags.status} Memory proposals.`);
+    }
+}
+exports.default = MemoryProposalsList;

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

@@ -0,0 +1,22 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryProposalsPromote extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        'source-store': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-memory': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'consent-approval': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        path: 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>;
+}