weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/contract/host.js

@@ -1,7 +1,8 @@
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
 import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
-import { E10ApiError, createE10RequestRuntime, } from '../../internal/e10/request-runtime.js';
 import { ContractCliError, contractAuthError, contractNetworkError, contractValidationError, } from './errors.js';
 const DEFAULT_TIMEOUT_MS = 30_000;
 function assertPath(requestPath) {
@@ -15,6 +16,38 @@ function assertPath(requestPath) {
         throw contractValidationError('path_not_allowed', '今承达合同管理只能调用 /api/ 路径');
     }
 }
+function withQuery(baseUrl, requestPath, query = {}) {
+    const url = new URL(`${baseUrl}${requestPath}`);
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(key, String(item));
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url;
+}
+async function fetchWithTimeout(url, options, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...options, signal: controller.signal, redirect: 'manual' });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw contractNetworkError('timeout', `请求超时（${timeoutMs}ms）`, { retryable: false });
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw contractNetworkError('transport', `请求失败：${message}`, { retryable: true });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 function textOf(value, keys) {
     for (const key of keys) {
         const candidate = value?.[key];
@@ -44,6 +77,23 @@ export function contractBusinessStatus(path, value) {
         const ok = (code === 0 || code === '0' || code === 200 || code === '200') && root.status !== false && root.fail !== true;
         return { ok, code: code === undefined ? undefined : String(code), message: textOf(root, ['msg', 'message']) ?? textOf(messageNode, ['errmsg', 'msg']) };
     }
+    // 文件服务与文档检索接口没有 message.errcode，成功码只有 code=0/200 或 status=true，且以 data 是否落地为准。
+    if (path.startsWith('/api/file/') || path.startsWith('/api/doc/')) {
+        const code = root.code ?? messageNode.code ?? messageNode.errcode;
+        const flagOk = root.status !== false && root.fail !== true;
+        if (code === undefined) {
+            const ok = flagOk && (root.data !== undefined || root.status === true || Object.keys(root).length > 0);
+            return { ok, message: textOf(root, ['msg', 'message']) };
+        }
+        const ok = (code === 0 || code === '0' || code === 200 || code === '200') && flagOk;
+        return { ok, code: String(code), message: textOf(root, ['msg', 'message']) ?? textOf(messageNode, ['msg', 'errmsg']) };
+    }
+    // 助手列表 getListDatas：/api/ebuilder/form/list/**，成功码与 ebd 一致（code=0/200 且 status 非 false）。
+    if (path.startsWith('/api/ebuilder/form/list/')) {
+        const code = root.code ?? messageNode.errcode ?? messageNode.code;
+        const ok = (code === 0 || code === '0' || code === 200 || code === '200') && root.status !== false && root.fail !== true;
+        return { ok, code: code === undefined ? undefined : String(code), message: textOf(root, ['msg', 'message']) ?? textOf(messageNode, ['errmsg', 'msg']) };
+    }
     if (path === '/api/ebuilder/form/obj/getObjsByTag'
         || path === '/api/bs/ebuilder/app/tags/getAppIds'
         || path === '/api/ebuilder/common/ds/fields'
@@ -81,6 +131,15 @@ function inferProfile(ctx) {
     const options = ctx.getGlobalOptions();
     return options.profile || getActiveProfile();
 }
+function requestHeaders(session) {
+    return {
+        Accept: 'application/json, text/plain, */*',
+        Cookie: session.cookieHeader(),
+        eteamsid: session.eteamsId,
+        'User-Agent': session.uaHeader(),
+        Origin: session.getBaseUrl(),
+    };
+}
 export function createContractHost(ctx, dependencies = {}) {
     let e10Session = null;
     let sessionContext = null;
@@ -101,13 +160,14 @@ export function createContractHost(ctx, dependencies = {}) {
         return sessionContext;
     }
     async function contractRequest(request) {
-        const { method = 'POST', path, query = {}, body, form, userIdField, timeoutMs = DEFAULT_TIMEOUT_MS, } = request;
+        const { method = 'POST', path, query = {}, body, form, file, headers: extraHeaders, userIdField, timeoutMs = DEFAULT_TIMEOUT_MS, } = request;
         assertPath(path);
         const session = await ensureSession();
         const context = await getSession();
-        const finalQuery = Object.fromEntries(Object.entries(query).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+        const headers = { ...requestHeaders(session), ...(extraHeaders ?? {}) };
+        const finalQuery = { ...query };
         let finalBody = body;
-        let formData;
+        const init = { method, headers };
         if (userIdField) {
             if (!context.userId) {
                 throw contractAuthError('user_id_missing', '当前会话没有可用的用户 ID，请确认 E10 登录态');
@@ -117,42 +177,38 @@ export function createContractHost(ctx, dependencies = {}) {
             else
                 finalBody = { ...finalBody, [userIdField]: context.userId };
         }
-        if (form) {
-            formData = new FormData();
-            for (const [key, value] of Object.entries(form))
-                formData.append(key, value);
-        }
-        const runtime = createE10RequestRuntime(ctx, session, {
-            interceptors: dependencies.interceptors,
-            fetch: dependencies.fetch,
-        });
-        let response;
-        try {
-            response = await runtime.requestJson({
-                module: 'contract',
-                method,
-                path,
-                query: finalQuery,
-                body: formData ? undefined : finalBody,
-                formData,
-                timeoutMs,
-            });
-        }
-        catch (error) {
-            if (error instanceof E10ApiError && error.type === 'network') {
-                throw contractNetworkError(error.subtype, error.message, {
-                    retryable: error.retryable,
-                    details: error.details,
-                });
+        if (form || file) {
+            const data = new FormData();
+            for (const [key, value] of Object.entries(form ?? {}))
+                data.append(key, value);
+            if (file) {
+                let buffer;
+                try {
+                    buffer = await readFile(file.path);
+                }
+                catch {
+                    throw contractValidationError('file_unreadable', `无法读取文件：${file.path}`);
+                }
+                const filename = file.filename ?? basename(file.path);
+                data.append(file.field ?? 'file', new Blob([new Uint8Array(buffer)], { type: file.contentType ?? 'application/octet-stream' }), filename);
             }
-            throw error;
+            init.body = data;
+        }
+        else if (finalBody !== undefined) {
+            headers['Content-Type'] = 'application/json;charset=UTF-8';
+            init.body = JSON.stringify(finalBody);
         }
+        const url = withQuery(context.baseUrl, path, finalQuery);
+        const response = await fetchWithTimeout(url, init, timeoutMs);
         if (response.status === 401 || response.status === 302) {
             throw contractAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status, path });
         }
-        const text = response.text;
-        const value = response.value;
-        if (response.parseError) {
+        const text = await response.text();
+        let value = {};
+        try {
+            value = text ? JSON.parse(text) : {};
+        }
+        catch {
             throw contractNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, {
                 retryable: false,
                 details: { path, status: response.status },

package/dist/shortcuts/contract/index.js

@@ -197,6 +197,38 @@ export const contractShortcut = {
             { flag: '--page-num <n>', description: 'page number', key: 'pageNum', kind: 'int' },
             { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
         ]);
+        registerCommand(clause, 'permission', 'Check clause library permission (termComponent)', 'contract.clause.permission');
+        registerCommand(clause, 'types', 'List clause category types', 'contract.clause.types');
+        registerCommand(clause, 'check', 'Check whether a clause name already exists', 'contract.clause.check', [
+            { flag: '--clause-name <name>', description: 'clause name', key: 'clauseName' },
+            { flag: '--belong-id <id>', description: 'clause category id', key: 'belongId' },
+        ]);
+        registerCommand(clause, 'browser', 'Search clauses for their ids', 'contract.clause.browser', [
+            { flag: '--name <name>', description: 'clause name keyword', key: 'name' },
+        ]);
+        registerCommand(clause, 'subcompany', 'Search sub-companies for clause groups', 'contract.clause.subcompany', [
+            { flag: '--name <name>', description: 'sub-company name keyword', key: 'name' },
+        ]);
+        registerCommand(clause, 'create-prepare', 'Prepare clause creation', 'contract.clause.create.prepare');
+        registerCommand(clause, 'create-apply', 'Apply a prepared clause creation', 'contract.clause.create.apply', CONTINUATION_FLAGS);
+        registerCommand(clause, 'update-prepare', 'Prepare clause update', 'contract.clause.update.prepare');
+        registerCommand(clause, 'update-apply', 'Apply a prepared clause update', 'contract.clause.update.apply', CONTINUATION_FLAGS);
+        registerCommand(clause, 'delete-prepare', 'Prepare clause deletion', 'contract.clause.delete.prepare');
+        registerCommand(clause, 'delete-apply', 'Apply a prepared clause deletion', 'contract.clause.delete.apply', CONTINUATION_FLAGS);
+        const category = clause.command('category').description('Clause category write commands');
+        registerCommand(category, 'create-prepare', 'Prepare category creation', 'contract.clause.category.create.prepare');
+        registerCommand(category, 'create-apply', 'Apply a prepared category creation', 'contract.clause.category.create.apply', CONTINUATION_FLAGS);
+        registerCommand(category, 'update-prepare', 'Prepare category update', 'contract.clause.category.update.prepare');
+        registerCommand(category, 'update-apply', 'Apply a prepared category update', 'contract.clause.category.update.apply', CONTINUATION_FLAGS);
+        registerCommand(category, 'delete-prepare', 'Prepare category deletion (cascades clauses)', 'contract.clause.category.delete.prepare');
+        registerCommand(category, 'delete-apply', 'Apply a prepared category deletion', 'contract.clause.category.delete.apply', CONTINUATION_FLAGS);
+        const clauseGroup = clause.command('group').description('Clause group write commands');
+        registerCommand(clauseGroup, 'create-prepare', 'Prepare clause group creation', 'contract.clause.group.create.prepare');
+        registerCommand(clauseGroup, 'create-apply', 'Apply a prepared clause group creation', 'contract.clause.group.create.apply', CONTINUATION_FLAGS);
+        registerCommand(clauseGroup, 'update-prepare', 'Prepare clause group update', 'contract.clause.group.update.prepare');
+        registerCommand(clauseGroup, 'update-apply', 'Apply a prepared clause group update', 'contract.clause.group.update.apply', CONTINUATION_FLAGS);
+        registerCommand(clauseGroup, 'delete-prepare', 'Prepare clause group deletion', 'contract.clause.group.delete.prepare');
+        registerCommand(clauseGroup, 'delete-apply', 'Apply a prepared clause group deletion', 'contract.clause.group.delete.apply', CONTINUATION_FLAGS);
         const reference = clause.command('reference').description('Clause reference commands');
         registerCommand(reference, 'get', 'Query referenced clauses of a contract document', 'contract.clause.reference.get', [
             { flag: '--file-id <id>', description: 'contract file id', key: 'fileId' },
@@ -314,5 +346,186 @@ export const contractShortcut = {
             { flag: '--request-id <id>', description: 'request id', key: 'requestId' },
             { flag: '--other-params <json>', description: 'paging params JSON', key: 'otherParams' },
         ]);
+        const review = contract.command('review').description('Contract AI review commands');
+        // paths 是数组，子命令只提供 JSON 输入入口，避免把路径拆成多个位置参数。
+        registerCommand(review, 'upload', 'Upload contracts and get the AI review page url', 'contract.review.upload');
+        registerCommand(review, 'export', 'Export AI review records', 'contract.review.export', [
+            { flag: '--file-id <id>', description: 'contract file id', key: 'fileId' },
+            { flag: '--sclx <types>', description: '1 risk, 2 legal, 3 proofreading', key: 'sclx' },
+        ]);
+        const flow = contract.command('flow').description('Contract flow entry commands');
+        registerCommand(flow, 'page', 'Build the flow create page url', 'contract.flow.page', [
+            { flag: '--flow <name>', description: '契约锁 / 新客户 / 老客户增值 / 常规二次销售', key: 'flow' },
+        ]);
+        registerCommand(flow, 'launch', 'Upload a contract and build the flow url with auto fill', 'contract.flow.launch', [
+            { flag: '--flow <name>', description: '契约锁 / 新客户 / 老客户增值 / 常规二次销售', key: 'flow' },
+            { flag: '--path <file>', description: 'local doc/docx path', key: 'path' },
+        ]);
+        const recommend = contract.command('recommend').description('Contract template recommendation commands');
+        registerCommand(recommend, 'doc', 'Recommend templates from a plain description', 'contract.recommend.doc', [
+            { flag: '--content <text>', description: 'requirement description', key: 'content' },
+        ]);
+        const compare = contract.command('compare').description('Contract document comparison commands');
+        registerCommand(compare, 'upload', 'Upload files for comparison (module docCompared)', 'contract.compare.upload');
+        registerCommand(compare, 'search', 'Search documents by name', 'contract.compare.search', [
+            { flag: '--keyword <text>', description: 'file name keyword', key: 'keyword' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(compare, 'versions', 'List historical versions of a file', 'contract.compare.versions', [
+            { flag: '--file-id <id>', description: 'file id', key: 'fileId' },
+            { flag: '--doc-id <id>', description: 'document id', key: 'docId' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+        ]);
+        registerCommand(compare, 'page', 'Build the document comparison page url', 'contract.compare.page', [
+            { flag: '--base-file-id <id>', description: 'base file id', key: 'baseFileId' },
+            { flag: '--base-file-name <name>', description: 'base file name', key: 'baseFileName' },
+            { flag: '--compare-file-id <id>', description: 'compare file id', key: 'compareFileId' },
+            { flag: '--compare-file-name <name>', description: 'compare file name', key: 'compareFileName' },
+        ]);
+        registerCommand(compare, 'diff', 'Fetch the comparison diff result', 'contract.compare.diff', [
+            { flag: '--base-file-id <id>', description: 'base file id', key: 'baseFileId' },
+            { flag: '--compare-file-id <id>', description: 'compare file id', key: 'compareFileId' },
+        ]);
+        const credit = contract.command('credit').description('Enterprise credit commands');
+        registerCommand(credit, 'page', 'Build the enterprise credit page url', 'contract.credit.page');
+        const performance = contract.command('performance').description('Performance ledger commands (local links + read-only list queries)');
+        registerCommand(performance, 'link', 'Build a filtered performance menu link (local)', 'contract.performance.link', [
+            { flag: '--menu <name>', description: 'menu name or alias', key: 'menu' },
+            { flag: '--origin <url>', description: 'business baseUrl', key: 'origin' },
+            { flag: '--period <yyyy[-mm]>', description: 'performance period', key: 'period' },
+            { flag: '--time-field <name>', description: 'override time field', key: 'time-field' },
+            { flag: '--conditions <json>', description: 'conditions JSON array', key: 'conditions' },
+        ]);
+        registerCommand(performance, 'fields', 'List filter fields of a performance menu (local)', 'contract.performance.fields', [
+            { flag: '--menu <name>', description: 'menu name or alias', key: 'menu' },
+        ]);
+        registerCommand(performance, 'source-entry', 'List contract source ledger entries (local)', 'contract.performance.source.entry', [
+            { flag: '--source <name>', description: 'source name or alias', key: 'source' },
+            { flag: '--origin <url>', description: 'business baseUrl', key: 'origin' },
+        ]);
+        registerCommand(performance, 'menu-search', 'Search permitted EB menus', 'contract.performance.menu.search', [
+            { flag: '--keywords <json>', description: 'keywords JSON array', key: 'keywords' },
+        ]);
+        registerCommand(performance, 'list-init', 'Initialize an EB list and verify objId', 'contract.performance.list.init', [
+            { flag: '--api-prefix <p>', description: 'api prefix', key: 'apiPrefix' },
+            { flag: '--list-id <id>', description: 'list id', key: 'listId' },
+            { flag: '--expected-obj-id <id>', description: 'expected objId', key: 'expectedObjId' },
+        ]);
+        registerCommand(performance, 'list-filters', 'Read saved search filters and column mapping', 'contract.performance.list.filters', [
+            { flag: '--api-prefix <p>', description: 'api prefix', key: 'apiPrefix' },
+            { flag: '--list-id <id>', description: 'list id', key: 'listId' },
+            { flag: '--app-id <id>', description: 'app id', key: 'appId' },
+            { flag: '--obj-id <id>', description: 'obj id', key: 'objId' },
+            { flag: '--include-fields', description: 'also read column mapping', key: 'includeFields', kind: 'bool' },
+        ]);
+        registerCommand(performance, 'list-query', 'Query a source ledger by exact condition (all pages)', 'contract.performance.list.query', [
+            { flag: '--api-prefix <p>', description: 'api prefix', key: 'apiPrefix' },
+            { flag: '--list-id <id>', description: 'list id', key: 'listId' },
+            { flag: '--app-id <id>', description: 'app id', key: 'appId' },
+            { flag: '--obj-id <id>', description: 'obj id', key: 'objId' },
+            { flag: '--search-field-id <id>', description: 'contract number field id', key: 'searchFieldId' },
+            { flag: '--search-operator <op>', description: 'eq/like/startWith', key: 'searchOperator' },
+            { flag: '--search-value <value>', description: 'full contract number', key: 'searchValue' },
+            { flag: '--search-param-json <json>', description: 'full searchParamData JSON string', key: 'searchParamJson' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+            { flag: '--max-pages <n>', description: 'max pages', key: 'maxPages', kind: 'int' },
+        ]);
+        registerCommand(performance, 'receipt-query', 'Query the receipt ledger by contract numbers', 'contract.performance.receipt.query', [
+            { flag: '--origin <url>', description: 'business baseUrl', key: 'origin' },
+            { flag: '--list-id <id>', description: 'receipt list id', key: 'listId' },
+            { flag: '--api-prefix <p>', description: 'api prefix', key: 'apiPrefix' },
+            { flag: '--app-id <id>', description: 'app id', key: 'appId' },
+            { flag: '--obj-id <id>', description: 'obj id', key: 'objId' },
+            { flag: '--contract-numbers <json>', description: 'contract numbers JSON array', key: 'contractNumbers' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        const quote = contract.command('quote').description('Quote-to-contract commands (local xlsx/docx)');
+        registerCommand(quote, 'rmb', 'Convert a number to RMB uppercase (local)', 'contract.quote.rmb', [
+            { flag: '--num <value>', description: 'number', key: 'num' },
+        ]);
+        registerCommand(quote, 'sheets', 'List sheets of a quote xlsx', 'contract.quote.sheets', [
+            { flag: '--path <file>', description: 'quote xlsx path', key: 'path' },
+        ]);
+        registerCommand(quote, 'parse', 'Parse a quote xlsx into meta/totals/sections', 'contract.quote.parse', [
+            { flag: '--path <file>', description: 'quote xlsx path', key: 'path' },
+            { flag: '--sheet <name>', description: 'sheet name', key: 'sheet' },
+            { flag: '--keep-remark', description: 'keep remark column', key: 'keepRemark', kind: 'bool' },
+            { flag: '--include-zero', description: 'keep zero-qty/amount items', key: 'includeZero', kind: 'bool' },
+        ]);
+        registerCommand(quote, 'fill', 'Fill a real .docx contract template with data JSON', 'contract.quote.fill', [
+            { flag: '--template <file>', description: 'real contract template docx', key: 'template' },
+            { flag: '--data <file>', description: 'data JSON path', key: 'data' },
+            { flag: '--out <file>', description: 'output docx path', key: 'out' },
+            { flag: '--detail <mode>', description: 'append|none', key: 'detail' },
+            { flag: '--map-out <file>', description: 'mapping log path', key: 'mapOut' },
+        ]);
+        const assistant = contract.command('assistant').description('Contract AI assistant commands');
+        registerCommand(assistant, 'init', 'Initialize or refresh assistant configuration', 'contract.assistant.init');
+        registerCommand(assistant, 'meta', 'Read assistant list field metadata (ai_background_config)', 'contract.assistant.meta');
+        registerCommand(assistant, 'list', 'List AI assistants', 'contract.assistant.list', [
+            { flag: '--name <name>', description: 'assistant name filter', key: 'name' },
+        ]);
+        registerCommand(assistant, 'doc-query', 'Query storage dir and execute settings', 'contract.assistant.doc.query', [
+            { flag: '--ai-id <id>', description: 'assistant data id', key: 'ai_id' },
+        ]);
+        registerCommand(assistant, 'config-query', 'Query the 16 agents of an assistant', 'contract.assistant.config.query', [
+            { flag: '--ai-id <id>', description: 'assistant data id', key: 'ai_id' },
+            { flag: '--ai-mark <mark>', description: 'filter by ai_mark, e.g. Control', key: 'aiMark' },
+        ]);
+        registerCommand(assistant, 'tips-query', 'Query tips of an assistant', 'contract.assistant.tips.query', [
+            { flag: '--ai-id <id>', description: 'assistant data id', key: 'ai_id' },
+        ]);
+        registerCommand(assistant, 'doc-folder-search', 'Search doc folders for storage settings', 'contract.assistant.doc.folder.search', [
+            { flag: '--name <name>', description: 'folder name keyword', key: 'name' },
+        ]);
+        registerCommand(assistant, 'keygroup-search', 'Search keyword groups', 'contract.assistant.keygroup.search', [
+            { flag: '--name <name>', description: 'keyword group name', key: 'name' },
+        ]);
+        registerCommand(assistant, 'rule-classification-list', 'List control rule classifications', 'contract.assistant.rule.classification.list');
+        registerCommand(assistant, 'rule-list', 'List control rules', 'contract.assistant.rule.list', [
+            { flag: '--flid <id>', description: 'classification id', key: 'flid' },
+            { flag: '--page-no <n>', description: 'page number', key: 'pageNo', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        registerCommand(assistant, 'rule-group-query', 'Query control rule groups of the Control agent', 'contract.assistant.rule.group.query', [
+            { flag: '--config-id <id>', description: 'Control agent id', key: 'config_id' },
+        ]);
+        registerCommand(assistant, 'element-query', 'Query element extraction sets of the Extract agent', 'contract.assistant.element.query', [
+            { flag: '--config-id <id>', description: 'Extract agent id', key: 'config_id' },
+        ]);
+        registerCommand(assistant, 'flow-list', 'List assistant flow bindings', 'contract.assistant.flow.list', [
+            { flag: '--ai-id <id>', description: 'assistant data id', key: 'ai_id' },
+            { flag: '--rule-config-id <id>', description: 'Control agent id', key: 'rule_config_id' },
+            { flag: '--page-index <n>', description: 'page index', key: 'pageIndex', kind: 'int' },
+            { flag: '--page-size <n>', description: 'page size', key: 'pageSize', kind: 'int' },
+        ]);
+        // 写操作输入含嵌套对象，统一走 --input / --input-json。
+        const assistantWrites = [
+            ['create', 'assistant creation', 'contract.assistant.create'],
+            ['delete', 'assistant deletion', 'contract.assistant.delete'],
+            ['doc-save', 'storage dir / execute mode write', 'contract.assistant.doc.save'],
+            ['agent-update', 'agent config update', 'contract.assistant.agent.update'],
+            ['tips-create', 'tip creation', 'contract.assistant.tips.create'],
+            ['tips-delete', 'tip deletion', 'contract.assistant.tips.delete'],
+            ['rule-classification-create', 'control rule classification creation', 'contract.assistant.rule.classification.create'],
+            ['rule-classification-update', 'control rule classification update', 'contract.assistant.rule.classification.update'],
+            ['rule-classification-delete', 'control rule classification deletion', 'contract.assistant.rule.classification.delete'],
+            ['rule-create', 'control rule creation', 'contract.assistant.rule.create'],
+            ['rule-update', 'control rule update', 'contract.assistant.rule.update'],
+            ['rule-delete', 'control rule deletion', 'contract.assistant.rule.delete'],
+            ['rule-group-create', 'control rule group creation', 'contract.assistant.rule.group.create'],
+            ['rule-group-update', 'control rule group update', 'contract.assistant.rule.group.update'],
+            ['rule-group-delete', 'control rule group deletion', 'contract.assistant.rule.group.delete'],
+            ['element-create', 'element extraction set creation', 'contract.assistant.element.create'],
+            ['element-delete', 'element extraction set deletion', 'contract.assistant.element.delete'],
+            ['flow-save', 'assistant flow binding creation', 'contract.assistant.flow.save'],
+            ['flow-update', 'assistant flow binding update', 'contract.assistant.flow.update'],
+            ['flow-delete', 'assistant flow binding deletion', 'contract.assistant.flow.delete'],
+        ];
+        for (const [name, description, operation] of assistantWrites) {
+            registerCommand(assistant, `${name}-prepare`, `Prepare ${description}`, `${operation}.prepare`);
+            registerCommand(assistant, `${name}-apply`, `Apply a prepared ${description}`, `${operation}.apply`, CONTINUATION_FLAGS);
+        }
     },
 };