@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/transport/multipart-upload.js

@@ -0,0 +1,106 @@
+import { randomBytes } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { open, stat } from 'node:fs/promises';
+import { basename, extname, resolve } from 'node:path';
+import { Readable } from 'node:stream';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export const MAX_REFERENCE_IMAGE_BYTES = 10 * 1024 * 1024;
+export const MAX_REFERENCE_IMAGES = 3;
+const MIME_BY_EXTENSION = {
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.png': 'image/png',
+    '.webp': 'image/webp',
+};
+function validationError(code, message, safeDetails) {
+    return new CliError(message, { code, exitCode: EXIT_CODES.validation, ...(safeDetails === undefined ? {} : { safeDetails }) });
+}
+async function detectImageMime(path) {
+    const handle = await open(path, 'r');
+    try {
+        const buffer = Buffer.alloc(12);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        const bytes = buffer.subarray(0, bytesRead);
+        if (bytes.length >= 8 && bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])))
+            return 'image/png';
+        if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+            return 'image/jpeg';
+        if (bytes.length >= 12 && bytes.subarray(0, 4).toString('ascii') === 'RIFF' && bytes.subarray(8, 12).toString('ascii') === 'WEBP') {
+            return 'image/webp';
+        }
+        return undefined;
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function validateReferenceImages(paths) {
+    if (paths.length > MAX_REFERENCE_IMAGES) {
+        throw validationError('AGENT_WORK_REFERENCE_IMAGE_LIMIT', `引用图片最多允许 ${MAX_REFERENCE_IMAGES} 张。`, {
+            count: paths.length,
+            max: MAX_REFERENCE_IMAGES,
+        });
+    }
+    return Promise.all(paths.map(async (input, index) => {
+        const path = resolve(input);
+        const filename = basename(path);
+        const expectedMime = MIME_BY_EXTENSION[extname(filename).toLowerCase()];
+        if (!expectedMime) {
+            throw validationError('AGENT_WORK_REFERENCE_IMAGE_TYPE_INVALID', '引用图片只支持 PNG、JPEG 或 WebP。', { filename, index });
+        }
+        const details = await stat(path).catch((cause) => {
+            throw new CliError('无法读取引用图片。', {
+                cause,
+                code: 'AGENT_WORK_REFERENCE_IMAGE_UNREADABLE',
+                exitCode: EXIT_CODES.validation,
+                safeDetails: { filename, index },
+            });
+        });
+        if (!details.isFile()) {
+            throw validationError('AGENT_WORK_REFERENCE_IMAGE_NOT_FILE', '引用图片必须是普通文件。', { filename, index });
+        }
+        if (details.size <= 0 || details.size > MAX_REFERENCE_IMAGE_BYTES) {
+            throw validationError('AGENT_WORK_REFERENCE_IMAGE_SIZE_INVALID', '引用图片必须非空且不超过 10 MiB。', {
+                filename,
+                index,
+                maxBytes: MAX_REFERENCE_IMAGE_BYTES,
+                size: details.size,
+            });
+        }
+        const detectedMime = await detectImageMime(path).catch((cause) => {
+            throw new CliError('无法读取引用图片文件头。', {
+                cause,
+                code: 'AGENT_WORK_REFERENCE_IMAGE_UNREADABLE',
+                exitCode: EXIT_CODES.validation,
+                safeDetails: { filename, index },
+            });
+        });
+        if (detectedMime !== expectedMime) {
+            throw validationError('AGENT_WORK_REFERENCE_IMAGE_CONTENT_INVALID', '引用图片扩展名与实际内容不一致或内容无效。', {
+                filename,
+                index,
+            });
+        }
+        return { filename, mimeType: detectedMime, path, size: details.size };
+    }));
+}
+function safeQuotedFilename(value) {
+    return value.replace(/["\r\n]/g, '_').replace(/[^\x20-\x7e]/g, '_');
+}
+export function createMultipartFileBody(file) {
+    const boundary = `monkeys-${randomBytes(18).toString('hex')}`;
+    const header = Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${safeQuotedFilename(file.filename)}"; filename*=UTF-8''${encodeURIComponent(file.filename)}\r\nContent-Type: ${file.mimeType}\r\n\r\n`);
+    const trailer = Buffer.from(`\r\n--${boundary}--\r\n`);
+    async function* parts() {
+        yield header;
+        for await (const chunk of createReadStream(file.path))
+            yield chunk;
+        yield trailer;
+    }
+    return {
+        contentLength: header.length + file.size + trailer.length,
+        contentType: `multipart/form-data; boundary=${boundary}`,
+        stream: Readable.from(parts()),
+    };
+}
+//# sourceMappingURL=multipart-upload.js.map

package/dist/transport/multipart-upload.js.map

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

package/dist/transport/types.d.ts

@@ -0,0 +1,44 @@
+import type { Dispatcher } from 'undici';
+import type { Readable } from 'node:stream';
+export type HttpMethod = 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT';
+export interface TransportContext {
+    authSurface: 'kernel' | 'workspace';
+    baseUrl: string;
+    caPath?: string;
+    proxyUrl?: string;
+    teamId?: string;
+    tenant?: string;
+    token?: string;
+}
+export interface HttpRequest {
+    acceptStatuses?: number[];
+    body?: unknown;
+    headers?: Record<string, string>;
+    idempotencyKey?: string;
+    maxResponseBytes?: number;
+    method: HttpMethod;
+    path: string;
+    query?: Record<string, boolean | number | string | Array<boolean | number | string> | undefined>;
+    rawBody?: Readable | Uint8Array | string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface HttpStreamResponse {
+    body: AsyncIterable<Uint8Array> & {
+        destroy(error?: Error): void;
+    };
+    headers: Record<string, string>;
+    requestId?: string;
+    status: number;
+}
+export interface HttpResponse<T = unknown> {
+    data: T;
+    headers: Record<string, string>;
+    requestId?: string;
+    status: number;
+}
+export interface TransportOptions {
+    dispatcher?: Dispatcher;
+    maxAttempts?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IACjG,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG;QAAE,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;KAAE,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":""}

package/dist/workflow/command.d.ts

@@ -0,0 +1,201 @@
+import { WorkflowClient, type WorkflowResource } from '../client/workflow.js';
+import type { SemanticRuntime } from '../semantic/runtime.js';
+interface MutationInput {
+    dryRun: boolean;
+    file: string;
+    runtime: SemanticRuntime;
+    yes: boolean;
+}
+export declare function findWorkflow(client: WorkflowClient, workflowId: string, version?: number): Promise<WorkflowResource | undefined>;
+export declare function executeWorkflowCreate(input: MutationInput & {
+    packageFile?: boolean;
+}): Promise<{
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    source: {
+        bytes: number;
+        path: string;
+        sha256: string;
+    };
+    workflowId: string;
+    action: string;
+    dryRun: boolean;
+    writeRequestSent: boolean;
+} | {
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    source: {
+        bytes: number;
+        path: string;
+        sha256: string;
+    };
+    workflowId: string;
+    action: string;
+    dryRun: boolean;
+    requestId: string | undefined;
+    verification: {
+        matches: true;
+        sha256: string;
+    };
+    workflow: {
+        [x: string]: unknown;
+        definition: {
+            [x: string]: unknown;
+            metadata: {
+                [x: string]: unknown;
+                id: string;
+                name: string | Record<string, string>;
+                version: number;
+            };
+        };
+        record: {
+            [x: string]: unknown;
+            createdTimestamp: number;
+            isBuiltin?: boolean | undefined;
+            teamId: string;
+            updatedTimestamp: number;
+            workflowId: string;
+            workflowVersion: number;
+        };
+    };
+    writeRequestSent: boolean;
+}>;
+export declare function executeWorkflowUpdate(input: MutationInput & {
+    snapshot?: string;
+    workflowId: string;
+}): Promise<{
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    beforeSha256: string;
+    source: {
+        bytes: number;
+        path: string;
+        sha256: string;
+    };
+    workflowId: string;
+    action: string;
+    dryRun: boolean;
+    writeRequestSent: boolean;
+} | {
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    beforeSha256: string;
+    source: {
+        bytes: number;
+        path: string;
+        sha256: string;
+    };
+    workflowId: string;
+    action: string;
+    dryRun: boolean;
+    requestId: string | undefined;
+    snapshot: {
+        path: string;
+        sha256: string;
+    };
+    verification: {
+        matches: true;
+        sha256: string;
+    };
+    workflow: {
+        [x: string]: unknown;
+        definition: {
+            [x: string]: unknown;
+            metadata: {
+                [x: string]: unknown;
+                id: string;
+                name: string | Record<string, string>;
+                version: number;
+            };
+        };
+        record: {
+            [x: string]: unknown;
+            createdTimestamp: number;
+            isBuiltin?: boolean | undefined;
+            teamId: string;
+            updatedTimestamp: number;
+            workflowId: string;
+            workflowVersion: number;
+        };
+    };
+    writeRequestSent: boolean;
+}>;
+export declare function executeWorkflowDelete(input: {
+    dryRun: boolean;
+    runtime: SemanticRuntime;
+    snapshot?: string;
+    workflowId: string;
+    yes: boolean;
+}): Promise<{
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    beforeSha256: string;
+    workflowId: string;
+    action: string;
+    dryRun: boolean;
+    writeRequestSent: boolean;
+} | {
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+    beforeSha256: string;
+    workflowId: string;
+    action: string;
+    deleted: {
+        deleted: true;
+        workflowId: string;
+    };
+    dryRun: boolean;
+    requestId: string | undefined;
+    snapshot: {
+        path: string;
+        sha256: string;
+    };
+    verification: {
+        absent: boolean;
+    };
+    writeRequestSent: boolean;
+}>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/workflow/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/workflow/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAW9D,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;CACd;AAcD,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAOtI;AAgDD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;QAW9E,KAAK;QAAc,IAAI;QAAa,MAAM;;;;;;;;;;;;;;;;;QAA1C,KAAK;QAAc,IAAI;QAAa,MAAM;;;;;;;iBAvC2C,IAAI;gBAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;GAuDtH;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;QAkB9F,KAAK;QAAc,IAAI;QAAa,MAAM;;;;;;;;;;;;;;;;;;QAA1C,KAAK;QAAc,IAAI;QAAa,MAAM;;;;;;;;;;;iBA3E2C,IAAI;gBAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;GA6FtH;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;CACd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAuDmB,MAAM;;;GAGzB"}

package/dist/workflow/command.js

@@ -0,0 +1,195 @@
+import { resolveApiOperation } from '../api-operation/resolver.js';
+import { WORKFLOW_DEFINITIONS, WorkflowClient } from '../client/workflow.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { assertWorkflowIdentityMatches, digestWorkflowDefinition, loadWorkflowFile, loadWorkflowPackage, workflowMutationMeta, writeWorkflowSnapshot, } from './mutation.js';
+function requireWriteConfirmation(dryRun, yes) {
+    if (dryRun || yes)
+        return;
+    throw new CliError('真实 Workflow 写入需要显式传入 --yes；建议先运行 --dry-run。', {
+        code: 'CONFIRMATION_REQUIRED',
+        exitCode: EXIT_CODES.confirmation,
+    });
+}
+function definitionOf(resource) {
+    return resource.definition;
+}
+export async function findWorkflow(client, workflowId, version) {
+    try {
+        return (await client.get(workflowId, version)).workflow;
+    }
+    catch (error) {
+        if (error instanceof CliError && error.code === 'HTTP_404')
+            return undefined;
+        throw error;
+    }
+}
+function assertAbsent(existing, workflowId) {
+    if (!existing)
+        return;
+    throw new CliError(`Workflow ${workflowId} 已存在；create/import 不会覆盖现有资源。`, {
+        code: 'WORKFLOW_ALREADY_EXISTS',
+        exitCode: EXIT_CODES.validation,
+    });
+}
+function assertOwned(resource, runtime) {
+    if (!runtime.context.team || resource.record.teamId !== runtime.context.team) {
+        throw new CliError('当前有效 Team 不是该 Workflow 的所有者，拒绝写入。', {
+            code: 'WORKFLOW_NOT_TEAM_OWNED',
+            exitCode: EXIT_CODES.authorization,
+            safeDetails: { effectiveTeamId: runtime.context.team, ownerTeamId: resource.record.teamId },
+        });
+    }
+}
+function assertReadBackMatches(expected, actual, workflowId) {
+    const expectedSha256 = digestWorkflowDefinition(expected);
+    const sha256 = digestWorkflowDefinition(actual);
+    if (sha256 !== expectedSha256) {
+        throw new CliError(`Workflow ${workflowId} 写后回读与写响应不一致。`, {
+            code: 'WORKFLOW_READBACK_MISMATCH',
+            exitCode: EXIT_CODES.partial,
+            recovery: ['停止后续变更，使用 workflow get 检查当前定义，并根据写前快照决定是否恢复。'],
+            safeDetails: { expectedSha256, sha256, workflowId },
+        });
+    }
+    return { matches: true, sha256 };
+}
+async function readBackAfterWrite(client, workflowId, version) {
+    try {
+        return (await client.get(workflowId, version)).workflow;
+    }
+    catch (cause) {
+        throw new CliError(`Workflow ${workflowId} 写请求已发送，但写后回读失败。`, {
+            cause,
+            code: 'WORKFLOW_READBACK_FAILED',
+            exitCode: EXIT_CODES.partial,
+            recovery: ['不要重放写请求；先运行 workflow get 检查服务端当前状态。'],
+            safeDetails: { workflowId, ...(version === undefined ? {} : { version }) },
+        });
+    }
+}
+export async function executeWorkflowCreate(input) {
+    requireWriteConfirmation(input.dryRun, input.yes);
+    const operation = WORKFLOW_DEFINITIONS.create;
+    const file = input.packageFile
+        ? await loadWorkflowPackage(input.file, input.runtime, operation)
+        : await loadWorkflowFile(input.file, input.runtime, operation);
+    const binding = resolveApiOperation(operation, input.runtime.index);
+    const client = new WorkflowClient(input.runtime);
+    assertAbsent(await findWorkflow(client, file.definition.metadata.id), file.definition.metadata.id);
+    const common = {
+        ...workflowMutationMeta(input.runtime, binding),
+        source: { bytes: file.bytes, path: file.path, sha256: file.sha256 },
+        workflowId: file.definition.metadata.id,
+    };
+    if (input.dryRun)
+        return { ...common, action: 'create', dryRun: true, writeRequestSent: false };
+    const created = await client.create(file.definition);
+    const readBack = await readBackAfterWrite(client, file.definition.metadata.id);
+    return {
+        ...common,
+        action: 'create',
+        dryRun: false,
+        requestId: created.requestId,
+        verification: assertReadBackMatches(created.workflow.definition, readBack.definition, file.definition.metadata.id),
+        workflow: readBack,
+        writeRequestSent: true,
+    };
+}
+export async function executeWorkflowUpdate(input) {
+    requireWriteConfirmation(input.dryRun, input.yes);
+    const operation = WORKFLOW_DEFINITIONS.update;
+    const file = await loadWorkflowFile(input.file, input.runtime, operation);
+    const binding = resolveApiOperation(operation, input.runtime.index);
+    const client = new WorkflowClient(input.runtime);
+    const current = await findWorkflow(client, input.workflowId, file.definition.revision.recordVersion);
+    if (!current) {
+        throw new CliError(`Workflow ${input.workflowId} 不存在。`, {
+            code: 'WORKFLOW_NOT_FOUND',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    assertOwned(current, input.runtime);
+    assertWorkflowIdentityMatches(input.workflowId, file.definition, definitionOf(current));
+    const common = {
+        ...workflowMutationMeta(input.runtime, binding),
+        beforeSha256: digestWorkflowDefinition(current.definition),
+        source: { bytes: file.bytes, path: file.path, sha256: file.sha256 },
+        workflowId: input.workflowId,
+    };
+    if (input.dryRun)
+        return { ...common, action: 'update', dryRun: true, writeRequestSent: false };
+    const snapshot = await writeWorkflowSnapshot(input.workflowId, 'update', current.definition, input.snapshot);
+    const updated = await client.update(input.workflowId, file.definition);
+    const readBack = await readBackAfterWrite(client, input.workflowId, file.definition.revision.recordVersion);
+    return {
+        ...common,
+        action: 'update',
+        dryRun: false,
+        requestId: updated.requestId,
+        snapshot,
+        verification: assertReadBackMatches(updated.workflow.definition, readBack.definition, input.workflowId),
+        workflow: readBack,
+        writeRequestSent: true,
+    };
+}
+export async function executeWorkflowDelete(input) {
+    requireWriteConfirmation(input.dryRun, input.yes);
+    const operation = WORKFLOW_DEFINITIONS.delete;
+    const binding = resolveApiOperation(operation, input.runtime.index);
+    if (!input.runtime.schemaFresh || !input.runtime.document || !input.runtime.digest || binding.schemaSource !== 'openapi') {
+        throw new CliError('Workflow delete 需要当前部署的最新 OpenAPI 合同。', {
+            code: 'WORKFLOW_WRITE_REQUIRES_FRESH_OPENAPI',
+            exitCode: EXIT_CODES.compatibility,
+        });
+    }
+    const client = new WorkflowClient(input.runtime);
+    const current = await findWorkflow(client, input.workflowId);
+    if (!current) {
+        throw new CliError(`Workflow ${input.workflowId} 不存在。`, {
+            code: 'WORKFLOW_NOT_FOUND',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    assertOwned(current, input.runtime);
+    const common = {
+        ...workflowMutationMeta(input.runtime, binding),
+        beforeSha256: digestWorkflowDefinition(current.definition),
+        workflowId: input.workflowId,
+    };
+    if (input.dryRun)
+        return { ...common, action: 'delete', dryRun: true, writeRequestSent: false };
+    const snapshot = await writeWorkflowSnapshot(input.workflowId, 'delete', current.definition, input.snapshot);
+    const deleted = await client.delete(input.workflowId);
+    let remaining;
+    try {
+        remaining = await findWorkflow(client, input.workflowId);
+    }
+    catch (cause) {
+        throw new CliError(`Workflow ${input.workflowId} 删除请求已发送，但删除后回读失败。`, {
+            cause,
+            code: 'WORKFLOW_DELETE_READBACK_UNKNOWN',
+            exitCode: EXIT_CODES.partial,
+            recovery: ['不要重放删除请求；先运行 workflow get 检查服务端当前状态。'],
+            safeDetails: { snapshot, workflowId: input.workflowId },
+        });
+    }
+    if (remaining) {
+        throw new CliError(`Workflow ${input.workflowId} 删除后仍可读取。`, {
+            code: 'WORKFLOW_DELETE_READBACK_FAILED',
+            exitCode: EXIT_CODES.partial,
+            recovery: ['停止后续操作并检查 Server 删除状态；写前定义保存在 snapshot。'],
+            safeDetails: { snapshot, workflowId: input.workflowId },
+        });
+    }
+    return {
+        ...common,
+        action: 'delete',
+        deleted: deleted.deletion,
+        dryRun: false,
+        requestId: deleted.requestId,
+        snapshot,
+        verification: { absent: true },
+        writeRequestSent: true,
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/workflow/command.js.map

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

package/dist/workflow/mutation.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import type { SemanticCommandDefinition } from '../api-operation/types.js';
+import type { SemanticRuntime } from '../semantic/runtime.js';
+declare const workflowIdentitySchema: z.ZodObject<{
+    contract: z.ZodLiteral<"WorkflowDefinition">;
+    metadata: z.ZodObject<{
+        creatorRef: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+        }, z.core.$loose>;
+        id: z.ZodString;
+        role: z.ZodLiteral<"workflow">;
+        teamId: z.ZodString;
+    }, z.core.$loose>;
+    revision: z.ZodObject<{
+        kind: z.ZodLiteral<"release">;
+        recordVersion: z.ZodNumber;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export type CanonicalWorkflowDefinition = z.infer<typeof workflowIdentitySchema> & Record<string, unknown>;
+export interface WorkflowFile {
+    bytes: number;
+    definition: CanonicalWorkflowDefinition;
+    path: string;
+    sha256: string;
+}
+export declare function validateWorkflowDefinition(runtime: SemanticRuntime, operation: SemanticCommandDefinition, input: unknown): CanonicalWorkflowDefinition;
+export declare function loadWorkflowFile(path: string, runtime: SemanticRuntime, operation: SemanticCommandDefinition): Promise<WorkflowFile>;
+export declare function loadWorkflowPackage(path: string, runtime: SemanticRuntime, operation: SemanticCommandDefinition): Promise<WorkflowFile>;
+export declare function digestWorkflowDefinition(value: unknown): string;
+export declare function assertWorkflowIdentityMatches(routeId: string, candidate: CanonicalWorkflowDefinition, current?: CanonicalWorkflowDefinition): void;
+export declare function writeWorkflowSnapshot(workflowId: string, action: 'delete' | 'update', definition: unknown, requestedPath?: string): Promise<{
+    path: string;
+    sha256: string;
+}>;
+export declare function workflowMutationMeta(runtime: SemanticRuntime, binding: {
+    adapter: string;
+    operationId?: string;
+    schemaSource: string;
+}): {
+    binding: {
+        adapter: string;
+        operationId?: string;
+        schemaSource: string;
+    };
+    contextFingerprint: string;
+    effectiveTeamId: string | undefined;
+    schemaDigest: string | undefined;
+    schemaFresh: boolean;
+};
+export {};
+//# sourceMappingURL=mutation.d.ts.map

package/dist/workflow/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/workflow/mutation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAaZ,CAAC;AASjB,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3G,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,2BAA2B,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAmFD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,yBAAyB,EACpC,KAAK,EAAE,OAAO,GACb,2BAA2B,CAoB7B;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,yBAAyB,GACnC,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,yBAAyB,GACnC,OAAO,CAAC,YAAY,CAAC,CAcvB;AAYD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/D;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,2BAA2B,EACtC,OAAO,CAAC,EAAE,2BAA2B,GACpC,IAAI,CAcN;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,UAAU,EAAE,OAAO,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;EAYtI"}