@kindgi/cli 0.1.4 → 0.1.5

package/dist/commands/judge-classes.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (C) 2026 Kindgi Inc.
+import { UsageError } from '../errors.js';
 import { integerFlag, listFlag, requiredPositional, runSdk, stringFlag } from './helpers.js';
 const SCOPE_FLAGS = {
     tenant: { type: 'boolean', description: 'The whole tenant.' },
@@ -15,19 +16,19 @@ function scopeFromFlags(ctx, required) {
     const projectId = stringFlag(ctx, 'project');
     const agentId = stringFlag(ctx, 'agent');
     if (tenant && (projectId !== undefined || agentId !== undefined)) {
-        throw new Error('--tenant cannot be combined with --project or --agent');
+        throw new UsageError('--tenant cannot be combined with --project or --agent');
     }
     if (tenant)
         return { kind: 'tenant' };
     if (agentId !== undefined) {
         if (projectId === undefined)
-            throw new Error('--agent needs --project');
+            throw new UsageError('--agent needs --project');
         return { kind: 'agent', projectId, agentId };
     }
     if (projectId !== undefined)
         return { kind: 'project', projectId };
     if (required)
-        throw new Error('Give a scope: --tenant, --project=<id>, or --agent=<id> --project=<id>');
+        throw new UsageError('Give a scope: --tenant, --project=<id>, or --agent=<id> --project=<id>');
     return undefined;
 }
 const REVIEWER_ROLES = ['standard', 'senior', 'admin'];
@@ -53,12 +54,12 @@ const ASSERTABLE_USAGE = '[--min-reviewer-role=standard|senior|admin] [--princip
 function assertableByFromFlags(ctx) {
     const role = stringFlag(ctx, 'min-reviewer-role');
     if (role !== undefined && !REVIEWER_ROLES.includes(role)) {
-        throw new Error(`--min-reviewer-role must be one of ${REVIEWER_ROLES.join(', ')}, got "${role}"`);
+        throw new UsageError(`--min-reviewer-role must be one of ${REVIEWER_ROLES.join(', ')}, got "${role}"`);
     }
     const kinds = listFlag(ctx, 'principal-kind');
     for (const kind of kinds) {
         if (!PRINCIPAL_KINDS.includes(kind)) {
-            throw new Error(`--principal-kind must be user or service, got "${kind}"`);
+            throw new UsageError(`--principal-kind must be user or service, got "${kind}"`);
         }
     }
     const ids = listFlag(ctx, 'principal-id');
@@ -78,7 +79,7 @@ function weightFlag(ctx) {
         return undefined;
     const n = Number(raw);
     if (!Number.isFinite(n) || n < 0)
-        throw new Error(`--weight must be a number of 0 or more, got '${raw}'`);
+        throw new UsageError(`--weight must be a number of 0 or more, got '${raw}'`);
     return n;
 }
 const list = {
@@ -123,10 +124,10 @@ const add = {
     run: (ctx) => runSdk(ctx, 'judge-classes add', async () => {
         const name = stringFlag(ctx, 'name');
         if (name === undefined)
-            throw new Error('--name=<name> is required');
+            throw new UsageError('--name=<name> is required');
         const weight = weightFlag(ctx);
         if (weight === undefined)
-            throw new Error('--weight=<w> is required');
+            throw new UsageError('--weight=<w> is required');
         const scope = scopeFromFlags(ctx, true);
         const description = stringFlag(ctx, 'description');
         const assertableBy = assertableByFromFlags(ctx);
@@ -160,11 +161,11 @@ const set = {
         const restricted = assertableByFromFlags(ctx);
         const unrestricted = ctx.options.unrestricted === true;
         if (restricted !== undefined && unrestricted) {
-            throw new Error('--unrestricted cannot be combined with the restriction flags');
+            throw new UsageError('--unrestricted cannot be combined with the restriction flags');
         }
         const assertableBy = unrestricted ? null : restricted;
         if (weight === undefined && description === undefined && assertableBy === undefined) {
-            throw new Error('Give --weight, --description, a restriction flag, or --unrestricted');
+            throw new UsageError('Give --weight, --description, a restriction flag, or --unrestricted');
         }
         return await ctx.client().judgeClasses.update(id, {
             ...(weight !== undefined && { weight }),

package/dist/commands/judge-classes.js.map

@@ -1 +1 @@
-{"version":3,"file":"judge-classes.js","sourceRoot":"","sources":["../../src/commands/judge-classes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"judge-classes.js","sourceRoot":"","sources":["../../src/commands/judge-classes.ts"],"names":[],"mappings":"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"}

package/dist/commands/judgments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"judgments.d.ts","sourceRoot":"","sources":["../../src/commands/judgments.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAuKvD,eAAO,MAAM,gBAAgB,EAAE,OAK9B,CAAC"}
+{"version":3,"file":"judgments.d.ts","sourceRoot":"","sources":["../../src/commands/judgments.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAuKvD,eAAO,MAAM,gBAAgB,EAAE,OAK9B,CAAC"}

package/dist/commands/judgments.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (C) 2026 Kindgi Inc.
+import { UsageError } from '../errors.js';
 import { integerFlag, requiredPositional, runSdk, stringFlag } from './helpers.js';
 const VERDICTS = ['yes', 'no'];
 /** The string flags given, under their request field names (`{ class: 'judgeClassId' }`). */
@@ -43,17 +44,17 @@ const add = {
     run: (ctx) => runSdk(ctx, 'judgments add', async () => {
         const runId = stringFlag(ctx, 'run');
         if (runId === undefined)
-            throw new Error('--run=<run-id> is required');
+            throw new UsageError('--run=<run-id> is required');
         const key = stringFlag(ctx, 'item');
         if (key === undefined)
-            throw new Error('--item=<key> is required');
+            throw new UsageError('--item=<key> is required');
         const yes = ctx.options.yes === true;
         const no = ctx.options.no === true;
         if (yes === no)
-            throw new Error('Give exactly one of --yes or --no');
+            throw new UsageError('Give exactly one of --yes or --no');
         const rank = integerFlag(ctx, 'rank');
         if (rank !== undefined && rank < 0)
-            throw new Error('--rank must be 0 or more');
+            throw new UsageError('--rank must be 0 or more');
         const pointer = ctx.options.pointer;
         return await ctx.client().judgments.create({
             runId,
@@ -104,11 +105,11 @@ const list = {
     run: (ctx) => runSdk(ctx, 'judgments list', async () => {
         if (stringFlag(ctx, 'agent-version') !== undefined &&
             stringFlag(ctx, 'agent') === undefined) {
-            throw new Error('--agent-version needs --agent');
+            throw new UsageError('--agent-version needs --agent');
         }
         const verdict = stringFlag(ctx, 'verdict');
         if (verdict !== undefined && !VERDICTS.includes(verdict)) {
-            throw new Error(`--verdict must be one of ${VERDICTS.join(', ')}, got "${verdict}"`);
+            throw new UsageError(`--verdict must be one of ${VERDICTS.join(', ')}, got "${verdict}"`);
         }
         const projectId = stringFlag(ctx, 'project');
         const limit = integerFlag(ctx, 'limit');

package/dist/commands/judgments.js.map

@@ -1 +1 @@
-{"version":3,"file":"judgments.js","sourceRoot":"","sources":["../../src/commands/judgments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"judgments.js","sourceRoot":"","sources":["../../src/commands/judgments.ts"],"names":[],"mappings":"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"}

package/dist/commands/key.js

@@ -78,7 +78,7 @@ const createCmd = {
     run: async (ctx) => {
         const idCheck = validateKeyId(ctx.positionals[0]);
         if (!idCheck.ok) {
-            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 1 };
+            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 2 };
         }
         const keyId = idCheck.id;
         const runnersOutcome = pickRunners(ctx);
@@ -168,7 +168,7 @@ const exportCmd = {
     run: async (ctx) => {
         const idCheck = validateKeyId(ctx.positionals[0]);
         if (!idCheck.ok) {
-            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 1 };
+            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 2 };
         }
         const keyId = idCheck.id;
         const formatFlag = ctx.options.format;
@@ -177,7 +177,7 @@ const exportCmd = {
             return {
                 kind: 'error',
                 stderr: `Unknown --format: ${formatInput}. Available: ${AVAILABLE_FORMATS.join(', ')}.\n`,
-                exitCode: 1,
+                exitCode: 2,
             };
         }
         const format = formatInput;
@@ -332,7 +332,7 @@ const trustCmd = {
     run: async (ctx) => {
         const idCheck = validateKeyId(ctx.positionals[0]);
         if (!idCheck.ok) {
-            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 1 };
+            return { kind: 'error', stderr: `${idCheck.error}\n`, exitCode: 2 };
         }
         const keyId = idCheck.id;
         const runnersOutcome = pickRunners(ctx);

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/commands/memory.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAqKvD,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/commands/memory.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAmevD,eAAO,MAAM,aAAa,EAAE,OAM3B,CAAC"}

package/dist/commands/memory.js

@@ -1,6 +1,9 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (C) 2026 Kindgi Inc.
-import { integerFlag, readJsonInput, requiredPositional, runSdk, stringFlag, throwUnwired, truncateCell, } from './helpers.js';
+import { writeFile } from 'node:fs/promises';
+import { UsageError } from '../errors.js';
+import { integerFlag, readJsonInput, requiredPositional, runSdk, stringFlag, truncateCell, } from './helpers.js';
+const contentCell = (f) => f.content !== undefined ? truncateCell(JSON.stringify(f.content), 60) : '';
 /** `memory facts list --table`. */
 const FACTS_TABLE = {
     rows: (page) => page.data,
@@ -8,32 +11,55 @@ const FACTS_TABLE = {
         { header: 'ID', get: (f) => String(f.id) },
         { header: 'TYPE', get: (f) => f.type },
         { header: 'VERSION', get: (f) => String(f.version) },
+        { header: 'TRUST', get: (f) => f.trust ?? 'asserted' },
+        { header: 'CREATED', get: (f) => String(f.createdAt) },
+        { header: 'CONTENT', get: contentCell },
+    ],
+};
+/** `memory facts revisions --table`: newest first, with why each one stopped being current. */
+const REVISIONS_TABLE = {
+    rows: (revisions) => revisions,
+    columns: [
+        { header: 'VERSION', get: (f) => String(f.version) },
+        { header: 'TRUST', get: (f) => f.trust ?? 'asserted' },
         { header: 'CREATED', get: (f) => String(f.createdAt) },
         {
-            header: 'CONTENT',
-            get: (f) => (f.content !== undefined ? truncateCell(JSON.stringify(f.content), 60) : ''),
+            header: 'ENDED',
+            get: (f) => f.invalidatedAt === undefined
+                ? 'current'
+                : `${f.invalidationReason ?? 'ended'} ${String(f.invalidatedAt)} by ${f.invalidatedBy ?? '?'}`,
         },
+        { header: 'CONTENT', get: contentCell },
     ],
 };
+const AS_OF_OPTION = {
+    type: 'string',
+    description: 'Memory as it stood at this time (ISO 8601), deleted and superseded facts included.',
+};
+const EXPECT_VERSION_OPTION = {
+    type: 'string',
+    description: 'Only if the fact is still at this revision (its `version`); if someone changed it first, nothing changes and the command fails with `fact-changed`.',
+};
 /** A JSON object from inline JSON or `@<file>`, or an error naming the flag. */
 async function jsonObjectFlag(text, flag) {
     const value = await readJsonInput(text);
     if (value === null || typeof value !== 'object' || Array.isArray(value)) {
-        throw new Error(`--${flag} must be a JSON object`);
+        throw new UsageError(`--${flag} must be a JSON object`);
     }
     return value;
 }
 const factsList = {
     kind: 'leaf',
     name: 'list',
-    description: 'List memory facts, the latest version of each.',
-    usage: 'kindgi memory facts list [--type=<type>] [--scope=<json-or-@file>] [--limit=<n>] [--cursor=<c>]',
+    description: 'List the memory facts you may see, the current revision of each.',
+    usage: 'kindgi memory facts list [--type=<type>] [--scope=<json-or-@file>] [--as-of=<time>] [--limit=<n>] [--cursor=<c>]',
     optionSpec: {
         type: { type: 'string', description: 'Only the facts of this type.' },
         scope: {
             type: 'string',
-            description: 'Only the facts in this scope, as inline JSON or `@<file>`: any of `userId`, `orgId`, `projectId`, `threadId`, `sessionId`; every key given must match.',
+            description: 'Only the facts in this scope, as inline JSON or `@<file>`: any of `userId`, `orgId`, `projectId`, `threadId`, `sessionId`, `participantId`; every key given must match.',
         },
+        'as-of': AS_OF_OPTION,
         limit: { type: 'string', description: 'The most facts to return (default 25, at most 100).' },
         cursor: {
             type: 'string',
@@ -46,9 +72,11 @@ const factsList = {
         const scope = scopeText === undefined ? undefined : await jsonObjectFlag(scopeText, 'scope');
         const limit = integerFlag(ctx, 'limit');
         const cursor = stringFlag(ctx, 'cursor');
+        const asOf = stringFlag(ctx, 'as-of');
         return await ctx.client().memory.facts.list({
             ...(type !== undefined && { type }),
             ...(scope !== undefined && { scope }),
+            ...(asOf !== undefined && { asOf }),
             ...(limit !== undefined && { limit }),
             ...(cursor !== undefined && { cursor: cursor }),
         });
@@ -57,13 +85,35 @@ const factsList = {
 const factsGet = {
     kind: 'leaf',
     name: 'get',
-    description: 'A memory fact by id, its latest version.',
-    usage: 'kindgi memory facts get <fact-id>',
+    description: 'A memory fact by id: its current revision, one revision, or as it stood then.',
+    usage: 'kindgi memory facts get <fact-id> [--revision=<n>] [--as-of=<time>]',
+    optionSpec: {
+        revision: { type: 'string', description: 'This revision (its `version`), current or not.' },
+        'as-of': AS_OF_OPTION,
+    },
     run: (ctx) => runSdk(ctx, 'memory facts get', async () => {
         const id = requiredPositional(ctx, 0, 'fact-id');
-        return await ctx.client().memory.facts.read(id);
+        const version = integerFlag(ctx, 'revision');
+        const asOf = stringFlag(ctx, 'as-of');
+        const options = {
+            ...(version !== undefined && { version }),
+            ...(asOf !== undefined && { asOf }),
+        };
+        return Object.keys(options).length === 0
+            ? await ctx.client().memory.facts.read(id)
+            : await ctx.client().memory.facts.read(id, options);
     }),
 };
+const factsRevisions = {
+    kind: 'leaf',
+    name: 'revisions',
+    description: "A memory fact's revisions, newest first: who changed or deleted it, when and why.",
+    usage: 'kindgi memory facts revisions <fact-id>',
+    run: (ctx) => runSdk(ctx, 'memory facts revisions', async () => {
+        const id = requiredPositional(ctx, 0, 'fact-id');
+        return await ctx.client().memory.facts.revisions(id);
+    }, REVISIONS_TABLE),
+};
 const factsWrite = {
     kind: 'leaf',
     name: 'write',
@@ -72,17 +122,17 @@ const factsWrite = {
     optionSpec: {
         input: {
             type: 'string',
-            description: 'The fact as inline JSON or `@<file>`: its `type` and `content`, and optionally `scope` (default: your tenant; narrow it with `userId`, `orgId`, `projectId`, `threadId`, `sessionId`) and `retention` (`keepDays`, `keepUntil`, `legalHold`). Required.',
+            description: 'The fact as inline JSON or `@<file>`: its `type` and `content`, and optionally `scope` (default: your tenant; narrow it with `userId`, `orgId`, `projectId`, `threadId`, `sessionId`, or an app\'s end user with `projectId` and `participantId`), `retention` (`keepDays`, `keepUntil`, `legalHold`), `subjects` (whom it is about: `[{"kind":"participant","id":"…"}]`) and `validFrom`/`validUntil`/`observedAt`. Required.',
         },
     },
     run: (ctx) => runSdk(ctx, 'memory facts write', async () => {
         const inputText = stringFlag(ctx, 'input');
         if (inputText === undefined)
-            throw new Error('--input=<json-or-@file> is required');
+            throw new UsageError('--input=<json-or-@file> is required');
         const input = (await jsonObjectFlag(inputText, 'input'));
         const scope = input.scope ?? {};
         if (scope === null || typeof scope !== 'object' || Array.isArray(scope)) {
-            throw new Error('--input `scope` must be a JSON object');
+            throw new UsageError('--input `scope` must be a JSON object');
         }
         const client = ctx.client();
         // The API asks for the scope's tenant, which can only be the caller's.
@@ -99,42 +149,244 @@ const factsWrite = {
 const factsSupersede = {
     kind: 'leaf',
     name: 'supersede',
-    description: 'Supersede an existing memory fact.',
-    usage: 'kindgi memory facts supersede <fact-id> --input=<json-or-@file>',
+    description: "Change a memory fact's content: writes its next revision (same id). Prints the new revision.",
+    usage: 'kindgi memory facts supersede <fact-id> --input=<json-or-@file> [--expect-version=<n>]',
     optionSpec: {
         input: {
             type: 'string',
-            description: 'Inline JSON or `@<file>`. Currently unused: superseding a fact takes only its id.',
+            description: 'The next revision as inline JSON or `@<file>`: its `content`, and optionally `retention`, `subjects` and `validFrom`/`validUntil`/`observedAt` (absent ones keep their current values). Its type and scope stay. Required.',
         },
+        'expect-version': EXPECT_VERSION_OPTION,
     },
     run: (ctx) => runSdk(ctx, 'memory facts supersede', async () => {
-        requiredPositional(ctx, 0, 'fact-id');
-        throwUnwired('memory.facts.supersede');
+        const id = requiredPositional(ctx, 0, 'fact-id');
+        const inputText = stringFlag(ctx, 'input');
+        if (inputText === undefined)
+            throw new UsageError('--input=<json-or-@file> is required');
+        const input = (await jsonObjectFlag(inputText, 'input'));
+        if (!('content' in input))
+            throw new UsageError('--input needs `content`: the next revision');
+        const expectVersion = integerFlag(ctx, 'expect-version');
+        // The rest is the server's to check.
+        return await ctx.client().memory.facts.supersede(id, {
+            ...input,
+            content: input.content,
+            ...(expectVersion !== undefined && { expectVersion }),
+        });
     }),
 };
+const factsDelete = {
+    kind: 'leaf',
+    name: 'delete',
+    description: 'Delete a memory fact: agents and reads no longer see it; its history stays until retention removes it. Prints the closed revision.',
+    usage: 'kindgi memory facts delete <fact-id> [--expect-version=<n>]',
+    optionSpec: { 'expect-version': EXPECT_VERSION_OPTION },
+    run: (ctx) => runSdk(ctx, 'memory facts delete', async () => {
+        const id = requiredPositional(ctx, 0, 'fact-id');
+        const expectVersion = integerFlag(ctx, 'expect-version');
+        return expectVersion === undefined
+            ? await ctx.client().memory.facts.delete(id)
+            : await ctx.client().memory.facts.delete(id, { expectVersion });
+    }),
+};
+const factsVerify = {
+    kind: 'leaf',
+    name: 'verify',
+    description: 'Mark a memory fact verified: you checked it. Prints the new revision (`trust: verified`).',
+    usage: 'kindgi memory facts verify <fact-id> [--expect-version=<n>]',
+    optionSpec: { 'expect-version': EXPECT_VERSION_OPTION },
+    run: (ctx) => runSdk(ctx, 'memory facts verify', async () => {
+        const id = requiredPositional(ctx, 0, 'fact-id');
+        const expectVersion = integerFlag(ctx, 'expect-version');
+        return expectVersion === undefined
+            ? await ctx.client().memory.facts.verify(id)
+            : await ctx.client().memory.facts.verify(id, { expectVersion });
+    }),
+};
+/** `memory facts retrieve --table`: best first. */
+const HITS_TABLE = {
+    rows: (hits) => hits,
+    columns: [
+        { header: 'ID', get: (h) => String(h.fact.id) },
+        { header: 'TYPE', get: (h) => h.fact.type },
+        { header: 'TRUST', get: (h) => h.fact.trust ?? 'asserted' },
+        { header: 'SCORE', get: (h) => (h.score === undefined ? '' : h.score.toFixed(4)) },
+        { header: 'CONTENT', get: (h) => contentCell(h.fact) },
+    ],
+};
 const factsRetrieve = {
     kind: 'leaf',
     name: 'retrieve',
-    description: 'Retrieve memory facts by query.',
+    description: 'Search the memory facts you may see: newest first, by keyword, by meaning, or both fused by rank.',
     usage: 'kindgi memory facts retrieve --query=<json-or-@file>',
     optionSpec: {
         query: {
             type: 'string',
-            description: 'The retrieval as inline JSON or `@<file>`: a `mode` (`list`, `keyword`, `semantic` or `both`), and optionally `query`, `type`, `scope` and `limit`.',
+            description: 'The retrieval as inline JSON or `@<file>`: a `mode` (`list`, `keyword`, `semantic` or `both`), and optionally `query` (required for a search), `type`, `scope` and `limit`. `semantic` and `both` need embeddings on the runtime (`KINDGI_MEMORY_EMBEDDINGS`). Required.',
         },
     },
-    run: (ctx) => runSdk(ctx, 'memory facts retrieve', async () => throwUnwired('memory.retrieve')),
+    run: (ctx) => runSdk(ctx, 'memory facts retrieve', async () => {
+        const text = stringFlag(ctx, 'query');
+        if (text === undefined)
+            throw new UsageError('--query=<json-or-@file> is required');
+        const input = (await jsonObjectFlag(text, 'query'));
+        // The mode and the rest are the server's to check.
+        return await ctx
+            .client()
+            .memory.search({ ...input, mode: input.mode });
+    }, HITS_TABLE),
 };
 const factsGroup = {
     kind: 'group',
     name: 'facts',
-    description: 'Memory facts: list, get, write.',
-    subcommands: [factsList, factsGet, factsWrite, factsSupersede, factsRetrieve],
+    description: 'Memory facts: list, get, write, supersede, delete, verify, revisions.',
+    subcommands: [
+        factsList,
+        factsGet,
+        factsRevisions,
+        factsWrite,
+        factsSupersede,
+        factsDelete,
+        factsVerify,
+        factsRetrieve,
+    ],
+};
+/** `memory erasures list --table`. */
+const ERASURES_TABLE = {
+    rows: (page) => page.data,
+    columns: [
+        { header: 'ID', get: (e) => e.id },
+        { header: 'KIND', get: (e) => e.selectorKind },
+        { header: 'STATUS', get: (e) => (e.status === 'running' ? `running (${e.phase})` : e.status) },
+        { header: 'CREATED', get: (e) => e.createdAt },
+        { header: 'COMPLETED', get: (e) => e.completedAt ?? '' },
+        { header: 'REPLAYABLE', get: (e) => (e.matchable ? 'yes' : 'no') },
+        { header: 'BY', get: (e) => e.requestedBy },
+    ],
+};
+const SELECTOR_FLAGS = ['participant', 'external', 'fact', 'conversation'];
+const erasuresCreate = {
+    kind: 'leaf',
+    name: 'create',
+    description: "Erase a person's words: their facts, conversations, the runs that served them, and what those left in provenance. Runs in the background; a tenant admin only.",
+    usage: 'kindgi memory erasures create (--participant=<id> | --external=<id> | --fact=<fact-id> | --conversation=<conversation-id>)',
+    optionSpec: {
+        participant: {
+            type: 'string',
+            description: "An app's end user (the `participantId` it gave).",
+        },
+        external: { type: 'string', description: 'A person facts name as an `external` subject.' },
+        fact: { type: 'string', description: 'One fact, every revision.' },
+        conversation: { type: 'string', description: 'One conversation.' },
+    },
+    run: (ctx) => runSdk(ctx, 'memory erasures create', async () => {
+        const given = SELECTOR_FLAGS.filter((f) => stringFlag(ctx, f) !== undefined);
+        if (given.length !== 1) {
+            throw new Error('Name exactly one of --participant, --external, --fact or --conversation');
+        }
+        const flag = given[0];
+        const id = stringFlag(ctx, flag);
+        return await ctx
+            .client()
+            .memory.erasures.create(flag === 'fact'
+            ? { factId: id }
+            : flag === 'conversation'
+                ? { conversationId: id }
+                : { subject: { kind: flag, id } });
+    }),
+};
+const erasuresGet = {
+    kind: 'leaf',
+    name: 'get',
+    description: 'An erasure: its status, phase, and what each store cleared.',
+    usage: 'kindgi memory erasures get <erasure-id>',
+    run: (ctx) => runSdk(ctx, 'memory erasures get', async () => ctx.client().memory.erasures.get(requiredPositional(ctx, 0, '<erasure-id>'))),
+};
+const erasuresList = {
+    kind: 'leaf',
+    name: 'list',
+    description: 'Erasures, newest first.',
+    usage: 'kindgi memory erasures list [--limit=<n>] [--cursor=<c>]',
+    optionSpec: {
+        limit: { type: 'string', description: 'The most to return (default 25, at most 100).' },
+        cursor: {
+            type: 'string',
+            description: "Resume after this cursor (the previous page's `nextCursor`).",
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'memory erasures list', async () => {
+        const limit = integerFlag(ctx, 'limit');
+        const cursor = stringFlag(ctx, 'cursor');
+        return await ctx.client().memory.erasures.list({
+            ...(limit !== undefined && { limit }),
+            ...(cursor !== undefined && { cursor }),
+        });
+    }, ERASURES_TABLE),
+};
+const erasuresExport = {
+    kind: 'leaf',
+    name: 'export',
+    description: 'The erasure ledger, content-free, to keep off-box: restoring a backup rolls it back too, and `replay` takes it.',
+    usage: 'kindgi memory erasures export [--out=<file>]',
+    optionSpec: {
+        out: { type: 'string', description: 'Write it to this file (else, to stdout).' },
+    },
+    run: (ctx) => runSdk(ctx, 'memory erasures export', async () => {
+        const erasures = await ctx.client().memory.erasures.export();
+        const out = stringFlag(ctx, 'out');
+        if (out === undefined)
+            return { erasures };
+        await writeFile(out, `${JSON.stringify({ erasures }, null, 2)}\n`, 'utf8');
+        return { wrote: out, erasures: erasures.length };
+    }),
+};
+const erasuresReplay = {
+    kind: 'leaf',
+    name: 'replay',
+    description: 'After restoring a backup: put the exported ledger back, and erase again whoever the tenant holds again.',
+    usage: 'kindgi memory erasures replay <export-file>',
+    run: (ctx) => runSdk(ctx, 'memory erasures replay', async () => {
+        const file = requiredPositional(ctx, 0, '<export-file>');
+        const read = (await readJsonInput(`@${file}`));
+        const erasures = Array.isArray(read) ? read : (read.erasures ?? read.data);
+        if (!Array.isArray(erasures)) {
+            throw new Error(`${file} isn't an export: expected {"erasures": [...]}`);
+        }
+        return await ctx.client().memory.erasures.replay(erasures);
+    }),
+};
+const erasuresResume = {
+    kind: 'leaf',
+    name: 'resume',
+    description: 'Try an erasure again now; --force stops one waiting on a run in a flow that serves other people (that run is cancelled).',
+    usage: 'kindgi memory erasures resume <erasure-id> [--force]',
+    optionSpec: {
+        force: {
+            type: 'boolean',
+            description: "Don't wait for the shared flow's run: cancel it and go on (it would otherwise wait until its deadline).",
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'memory erasures resume', async () => ctx.client().memory.erasures.resume(requiredPositional(ctx, 0, '<erasure-id>'), {
+        ...(ctx.options.force === true && { force: true }),
+    })),
+};
+const erasuresGroup = {
+    kind: 'group',
+    name: 'erasures',
+    description: "Erasing a person's words: create, get, list, resume, export, replay (a tenant admin only).",
+    subcommands: [
+        erasuresCreate,
+        erasuresGet,
+        erasuresList,
+        erasuresResume,
+        erasuresExport,
+        erasuresReplay,
+    ],
 };
 export const memoryCommand = {
     kind: 'group',
     name: 'memory',
-    description: 'Memory: the facts agents remember, by type and scope.',
-    subcommands: [factsGroup],
+    description: "Memory: the facts agents remember, by type and scope, and erasing a person's words.",
+    subcommands: [factsGroup, erasuresGroup],
 };
 //# sourceMappingURL=memory.js.map