@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/api/command-runtime.js

@@ -0,0 +1,67 @@
+import { readFile } from 'node:fs/promises';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { resolveCommandRuntime } from '../credential/command-runtime.js';
+import { createAuthenticatedClient } from '../credential/runtime.js';
+import { loadOpenApi } from '../openapi/loader.js';
+export async function loadApiCommandRuntime(profile, team, forceRefresh = false) {
+    const runtime = await resolveCommandRuntime(profile, team);
+    const client = await createAuthenticatedClient(runtime.context, runtime.secrets);
+    const openapi = await loadOpenApi(runtime.context, client, { forceRefresh });
+    return { ...runtime, client, openapi };
+}
+export function parseJsonObject(value, label) {
+    if (value === undefined)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw new Error('not an object');
+        return parsed;
+    }
+    catch (cause) {
+        throw new CliError(`${label} 必须是 JSON Object。`, { cause, code: 'INVALID_JSON_ARGUMENT', exitCode: EXIT_CODES.validation });
+    }
+}
+export function parseJsonValue(value, label) {
+    try {
+        return JSON.parse(value);
+    }
+    catch (cause) {
+        throw new CliError(`${label} 不是有效 JSON。`, { cause, code: 'INVALID_JSON_ARGUMENT', exitCode: EXIT_CODES.validation });
+    }
+}
+export async function readJsonFile(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch (cause) {
+        throw new CliError(`无法读取 JSON 文件：${path}`, { cause, code: 'JSON_FILE_UNREADABLE', exitCode: EXIT_CODES.validation });
+    }
+    if (Buffer.byteLength(text) > 10 * 1024 * 1024) {
+        throw new CliError('JSON 文件超过 10 MB 上限。', { code: 'JSON_FILE_TOO_LARGE', exitCode: EXIT_CODES.validation });
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (cause) {
+        throw new CliError(`JSON 文件内容无效：${path}`, { cause, code: 'INVALID_JSON_FILE', exitCode: EXIT_CODES.validation });
+    }
+}
+export function parseHeaders(values) {
+    if (!values?.length)
+        return undefined;
+    const headers = {};
+    for (const value of values) {
+        const separator = value.indexOf('=');
+        if (separator <= 0) {
+            throw new CliError('Header 必须使用 name=value 格式。', { code: 'INVALID_HEADER_ARGUMENT', exitCode: EXIT_CODES.validation });
+        }
+        const name = value.slice(0, separator).trim();
+        if (!name)
+            throw new CliError('Header 名称不能为空。', { code: 'INVALID_HEADER_ARGUMENT', exitCode: EXIT_CODES.validation });
+        headers[name] = value.slice(separator + 1);
+    }
+    return headers;
+}
+//# sourceMappingURL=command-runtime.js.map

package/dist/api/command-runtime.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from './command-runtime.js';
+export * from './raw-api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,3 @@
+export * from './command-runtime.js';
+export * from './raw-api.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/api/operation-policy.d.ts

@@ -0,0 +1,11 @@
+import type { OpenApiOperation } from '../openapi/types.js';
+import { type RiskLevel } from '../policy/risk.js';
+export interface RawOperationPolicy {
+    mutation: boolean;
+    risk: RiskLevel;
+}
+export declare function assertRawOperationPublished(operation: OpenApiOperation, includeLegacy?: boolean): void;
+export declare function resolveRawOperationPolicy(operation: OpenApiOperation, authSurface: 'kernel' | 'workspace', schemaFresh: boolean, options?: {
+    includeLegacy?: boolean;
+}): RawOperationPolicy;
+//# sourceMappingURL=operation-policy.d.ts.map

package/dist/api/operation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-policy.d.ts","sourceRoot":"","sources":["../../src/api/operation-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,UAAQ,GAAG,IAAI,CAQpG;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,QAAQ,GAAG,WAAW,EACnC,WAAW,EAAE,OAAO,EACpB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,kBAAkB,CAuBpB"}

package/dist/api/operation-policy.js

@@ -0,0 +1,35 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { maxRisk, methodRiskFloor } from '../policy/risk.js';
+export function assertRawOperationPublished(operation, includeLegacy = false) {
+    if (operation.published === true || includeLegacy)
+        return;
+    throw new CliError('该 Operation 未进入受治理的 Platform API 发布集合。', {
+        code: 'API_OPERATION_UNPUBLISHED',
+        exitCode: EXIT_CODES.compatibility,
+        recovery: ['优先使用已发布 Operation。', '仅在确认目标是 legacy 兼容接口时显式使用 --include-legacy。'],
+        safeDetails: { operationId: operation.operationId, pathTemplate: operation.pathTemplate },
+    });
+}
+export function resolveRawOperationPolicy(operation, authSurface, schemaFresh, options = {}) {
+    assertRawOperationPublished(operation, options.includeLegacy);
+    if (operation.authSurfaces?.length && !operation.authSurfaces.includes(authSurface)) {
+        throw new CliError(`当前 Profile 的认证 Surface（${authSurface}）不能调用该 Operation。`, {
+            code: 'API_AUTH_SURFACE_MISMATCH',
+            exitCode: EXIT_CODES.authentication,
+            safeDetails: { actual: authSurface, required: operation.authSurfaces },
+        });
+    }
+    const mutation = !['GET', 'HEAD', 'OPTIONS'].includes(operation.method);
+    if (mutation && !schemaFresh) {
+        throw new CliError('写入 Operation 不能使用过期的 OpenAPI Schema。请先成功刷新文档。', {
+            code: 'OPENAPI_STALE_WRITE_FORBIDDEN',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { operationId: operation.operationId, pathTemplate: operation.pathTemplate },
+        });
+    }
+    return {
+        mutation,
+        risk: maxRisk(methodRiskFloor(operation.method), operation.risk),
+    };
+}
+//# sourceMappingURL=operation-policy.js.map

package/dist/api/operation-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-policy.js","sourceRoot":"","sources":["../../src/api/operation-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAO7E,MAAM,UAAU,2BAA2B,CAAC,SAA2B,EAAE,aAAa,GAAG,KAAK;IAC5F,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI,IAAI,aAAa;QAAE,OAAO;IAC1D,MAAM,IAAI,QAAQ,CAAC,wCAAwC,EAAE;QAC3D,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,UAAU,CAAC,aAAa;QAClC,QAAQ,EAAE,CAAC,oBAAoB,EAAE,4CAA4C,CAAC;QAC9E,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE;KAC1F,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAA2B,EAC3B,WAAmC,EACnC,WAAoB,EACpB,OAAO,GAAgC,EAAE;IAEzC,2BAA2B,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,SAAS,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,QAAQ,CAAC,0BAA0B,WAAW,mBAAmB,EAAE;YAC3E,IAAI,EAAE,2BAA2B;YACjC,QAAQ,EAAE,UAAU,CAAC,cAAc;YACnC,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,YAAY,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,QAAQ,CAAC,+CAA+C,EAAE;YAClE,IAAI,EAAE,+BAA+B;YACrC,QAAQ,EAAE,UAAU,CAAC,aAAa;YAClC,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE;SAC1F,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/api/raw-api.d.ts

@@ -0,0 +1,25 @@
+import type { OpenApiDocument, OpenApiIndex, OpenApiOperation } from '../openapi/types.js';
+import type { HttpClient } from '../transport/http-client.js';
+import type { HttpResponse } from '../transport/types.js';
+export interface OperationSelector {
+    method?: string;
+    operationId?: string;
+    pathTemplate?: string;
+}
+export interface RawApiCall {
+    beforeSend?: () => Promise<void>;
+    body?: unknown;
+    headers?: Record<string, string>;
+    pathParameters?: Record<string, boolean | number | string>;
+    query?: Record<string, boolean | number | string | Array<boolean | number | string>>;
+    requireSchemaValidation?: boolean;
+    selector: OperationSelector;
+}
+export interface RawApiCallResult<T = unknown> {
+    operation: OpenApiOperation;
+    response: HttpResponse<T>;
+    schemaValidated: boolean;
+}
+export declare function resolveRawOperation(index: OpenApiIndex, selector: OperationSelector): OpenApiOperation;
+export declare function callRawApi<T = unknown>(client: HttpClient, document: OpenApiDocument, index: OpenApiIndex, input: RawApiCall): Promise<RawApiCallResult<T>>;
+//# sourceMappingURL=raw-api.d.ts.map

package/dist/api/raw-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-api.d.ts","sourceRoot":"","sources":["../../src/api/raw-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACrF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAUD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CA0BtG;AAuGD,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAqB9B"}

package/dist/api/raw-api.js

@@ -0,0 +1,157 @@
+import { Ajv } from 'ajv';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { digestOpenApi } from '../openapi/digest.js';
+function schemaError(message, errors) {
+    return new CliError(message, {
+        code: 'API_SCHEMA_VALIDATION_FAILED',
+        exitCode: EXIT_CODES.validation,
+        safeDetails: { errors: errors?.map((error) => ({ instancePath: error.instancePath, keyword: error.keyword, message: error.message })) },
+    });
+}
+export function resolveRawOperation(index, selector) {
+    if (selector.operationId) {
+        if (selector.method || selector.pathTemplate) {
+            throw new CliError('operationId 不能与 Method/Path 选择器混用。', { code: 'API_SELECTOR_CONFLICT', exitCode: EXIT_CODES.validation });
+        }
+        const operation = index.byOperationId[selector.operationId];
+        if (!operation) {
+            throw new CliError(`OpenAPI 中不存在 operationId：${selector.operationId}`, {
+                code: 'API_OPERATION_NOT_FOUND',
+                exitCode: EXIT_CODES.compatibility,
+            });
+        }
+        return operation;
+    }
+    if (!selector.method || !selector.pathTemplate) {
+        throw new CliError('必须提供 operationId，或同时提供 Method 与 Path Template。', {
+            code: 'API_SELECTOR_REQUIRED',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    const key = `${selector.method.toUpperCase()} ${selector.pathTemplate}`;
+    const operation = index.byMethodPath[key];
+    if (!operation) {
+        throw new CliError(`OpenAPI 中不存在 Operation：${key}`, { code: 'API_OPERATION_NOT_FOUND', exitCode: EXIT_CODES.compatibility });
+    }
+    return operation;
+}
+function resolveRef(document, value) {
+    if (!value || typeof value !== 'object' || !('$ref' in value))
+        return value;
+    const ref = value.$ref;
+    if (typeof ref !== 'string' || !ref.startsWith('#/'))
+        return value;
+    let current = document;
+    for (const part of ref.slice(2).split('/')) {
+        const key = part.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (!current || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+function compile(document, schema) {
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    const components = document.components;
+    const root = schema && typeof schema === 'object' ? { ...schema, ...(components ? { components } : {}) } : schema;
+    return ajv.compile(root);
+}
+function assertSchema(document, schema, value, label) {
+    const validate = compile(document, schema);
+    if (!validate(value))
+        throw schemaError(`${label} 不符合 OpenAPI Schema。`, validate.errors);
+}
+function buildRequest(operation, document, input) {
+    let path = operation.pathTemplate;
+    let schemaValidated = false;
+    const pathValues = input.pathParameters ?? {};
+    const queryValues = input.query ?? {};
+    const parameters = Array.isArray(operation.parameters) ? operation.parameters : [];
+    for (const unresolved of parameters) {
+        const parameter = resolveRef(document, unresolved);
+        if (!parameter || typeof parameter !== 'object')
+            continue;
+        const record = parameter;
+        const name = typeof record.name === 'string' ? record.name : undefined;
+        const location = record.in;
+        if (!name || (location !== 'path' && location !== 'query'))
+            continue;
+        const source = location === 'path' ? pathValues : queryValues;
+        const value = source[name];
+        if (record.required === true && value === undefined) {
+            throw schemaError(`缺少必填 ${location} 参数：${name}`);
+        }
+        if (value !== undefined && record.schema !== undefined) {
+            assertSchema(document, record.schema, value, `${location} 参数 ${name}`);
+            schemaValidated = true;
+        }
+    }
+    path = path.replace(/\{([^}]+)\}/g, (_match, name) => {
+        const value = pathValues[name];
+        if (value === undefined)
+            throw schemaError(`缺少 Path 参数：${name}`);
+        return encodeURIComponent(String(value));
+    });
+    const requestBody = operation.requestBody && typeof operation.requestBody === 'object'
+        ? resolveRef(document, operation.requestBody)
+        : undefined;
+    if (requestBody?.required === true && input.body === undefined)
+        throw schemaError('请求 Body 为必填。');
+    const content = requestBody?.content;
+    const bodySchema = content?.['application/json']?.schema;
+    const trustedExplicitNoBody = document['x-monkeys-document-kind'] === 'platform-api' &&
+        document['x-monkeys-contract-revision'] === 2 &&
+        document['x-monkeys-schema-digest'] === digestOpenApi(document) &&
+        operation.published === true &&
+        operation.requestBodyMode === 'none';
+    if (trustedExplicitNoBody && input.body !== undefined) {
+        throw schemaError('该 Operation 明确声明不接受请求 Body。');
+    }
+    if (input.body !== undefined && bodySchema !== undefined) {
+        assertSchema(document, bodySchema, input.body, '请求 Body');
+        schemaValidated = true;
+    }
+    if (trustedExplicitNoBody && input.body === undefined)
+        schemaValidated = true;
+    return {
+        ...(input.body === undefined ? {} : { body: input.body }),
+        path,
+        ...(Object.keys(queryValues).length ? { query: queryValues } : {}),
+        schemaValidated,
+    };
+}
+function responseSchema(operation, document, status) {
+    if (!operation.responses || typeof operation.responses !== 'object')
+        return undefined;
+    const responses = operation.responses;
+    const unresolved = responses[String(status)] ?? responses[`${Math.floor(status / 100)}XX`] ?? responses.default;
+    const response = resolveRef(document, unresolved);
+    if (!response || typeof response !== 'object')
+        return undefined;
+    const content = response.content;
+    return content?.['application/json']?.schema;
+}
+export async function callRawApi(client, document, index, input) {
+    const operation = resolveRawOperation(index, input.selector);
+    const request = buildRequest(operation, document, input);
+    if (input.requireSchemaValidation && !request.schemaValidated) {
+        throw new CliError('写入 Operation 缺少可用于校验本次请求的 OpenAPI Schema。', {
+            code: 'API_WRITE_SCHEMA_REQUIRED',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { operationId: operation.operationId, pathTemplate: operation.pathTemplate },
+        });
+    }
+    await input.beforeSend?.();
+    const response = await client.request({
+        ...(request.body === undefined ? {} : { body: request.body }),
+        ...(input.headers ? { headers: input.headers } : {}),
+        method: operation.method,
+        path: request.path,
+        ...(request.query ? { query: request.query } : {}),
+    });
+    const schema = responseSchema(operation, document, response.status);
+    if (schema !== undefined)
+        assertSchema(document, schema, response.data, '响应');
+    return { operation, response, schemaValidated: request.schemaValidated || schema !== undefined };
+}
+//# sourceMappingURL=raw-api.js.map

package/dist/api/raw-api.js.map

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

package/dist/api-operation/index.d.ts

@@ -0,0 +1,3 @@
+export * from './resolver.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api-operation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-operation/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/api-operation/index.js

@@ -0,0 +1,3 @@
+export * from './resolver.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/api-operation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api-operation/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/api-operation/resolver.d.ts

@@ -0,0 +1,4 @@
+import type { OpenApiIndex } from '../openapi/types.js';
+import type { ResolvedApiOperation, SemanticCommandDefinition } from './types.js';
+export declare function resolveApiOperation(definition: SemanticCommandDefinition, index: OpenApiIndex): ResolvedApiOperation;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/api-operation/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/api-operation/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAuB,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAYvG,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,yBAAyB,EAAE,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAyCpH"}

package/dist/api-operation/resolver.js

@@ -0,0 +1,55 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+function fromBinding(binding, method, pathTemplate, operationId) {
+    return {
+        adapter: binding.adapter,
+        method,
+        pathTemplate,
+        schemaSource: 'openapi',
+        ...(operationId ? { operationId } : {}),
+    };
+}
+export function resolveApiOperation(definition, index) {
+    const matches = [];
+    const builtins = [];
+    for (const binding of definition.apiBindings) {
+        if (binding.apiOperationId) {
+            const operation = index.byOperationId[binding.apiOperationId];
+            if (operation)
+                matches.push(fromBinding(binding, operation.method, operation.pathTemplate, operation.operationId));
+        }
+        if (binding.method && binding.pathTemplate) {
+            const method = binding.method.toUpperCase();
+            const operation = index.byMethodPath[`${method} ${binding.pathTemplate}`];
+            if (operation)
+                matches.push(fromBinding(binding, operation.method, operation.pathTemplate, operation.operationId));
+            else if (binding.legacyBuiltinContract) {
+                builtins.push({ adapter: binding.adapter, method, pathTemplate: binding.pathTemplate, schemaSource: 'builtin' });
+            }
+        }
+    }
+    const unique = [...new Map(matches.map((match) => [`${match.method} ${match.pathTemplate} ${match.adapter}`, match])).values()];
+    if (unique.length === 1)
+        return unique[0];
+    if (unique.length > 1) {
+        throw new CliError(`语义命令 ${definition.id} 匹配到多个 API Operation。`, {
+            code: 'API_BINDING_AMBIGUOUS',
+            exitCode: EXIT_CODES.compatibility,
+            fallbackEligible: true,
+            safeDetails: { candidates: unique.map((item) => ({ method: item.method, pathTemplate: item.pathTemplate })) },
+        });
+    }
+    if (builtins.length === 1)
+        return builtins[0];
+    if (builtins.length > 1) {
+        throw new CliError(`语义命令 ${definition.id} 存在多个未验证的内置合同。`, {
+            code: 'BUILTIN_BINDING_AMBIGUOUS',
+            exitCode: EXIT_CODES.compatibility,
+        });
+    }
+    throw new CliError(`当前部署没有与语义命令 ${definition.id} 兼容的 API Operation。`, {
+        code: 'API_BINDING_NOT_FOUND',
+        exitCode: EXIT_CODES.compatibility,
+        fallbackEligible: true,
+    });
+}
+//# sourceMappingURL=resolver.js.map

package/dist/api-operation/resolver.js.map

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

package/dist/api-operation/types.d.ts

@@ -0,0 +1,22 @@
+import type { RiskLevel } from '../policy/risk.js';
+export interface ApiOperationBinding {
+    adapter: string;
+    apiOperationId?: string;
+    legacyBuiltinContract?: boolean;
+    method?: string;
+    pathTemplate?: string;
+}
+export interface SemanticCommandDefinition {
+    apiBindings: ApiOperationBinding[];
+    command: string[];
+    id: string;
+    risk: RiskLevel;
+}
+export interface ResolvedApiOperation {
+    adapter: string;
+    method: string;
+    operationId?: string;
+    pathTemplate: string;
+    schemaSource: 'builtin' | 'openapi';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api-operation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api-operation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;CACrC"}

package/dist/api-operation/types.js

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

package/dist/api-operation/types.js.map

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

package/dist/client/execution.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { type SemanticRuntime } from '../semantic/runtime.js';
+declare const executionSchema: z.ZodObject<{
+    createdTimestamp: z.ZodOptional<z.ZodNumber>;
+    output: z.ZodOptional<z.ZodUnknown>;
+    status: z.ZodString;
+    takes: z.ZodOptional<z.ZodNumber>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        outputData: z.ZodOptional<z.ZodUnknown>;
+        reasonForIncompletion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        referenceTaskName: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        taskDefName: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        workflowInstanceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>>;
+    teamId: z.ZodOptional<z.ZodString>;
+    updatedTimestamp: z.ZodOptional<z.ZodNumber>;
+    workflowId: z.ZodString;
+    workflowInstanceId: z.ZodString;
+    workflowVersion: z.ZodNumber;
+}, z.core.$loose>;
+export type Execution = z.infer<typeof executionSchema>;
+export type ExecutionContractVariant = 'db-search-summary-v1' | 'legacy-list-v1';
+export type ExecutionSummary = Pick<Execution, 'status' | 'workflowId' | 'workflowInstanceId'> & Partial<Pick<Execution, 'createdTimestamp' | 'teamId' | 'updatedTimestamp' | 'workflowVersion'>> & {
+    endTime?: number;
+    startBy?: string;
+    startTime?: number;
+    triggerType?: string;
+};
+export interface ExecutionListResult {
+    contractVariant: ExecutionContractVariant;
+    limit: number;
+    list: ExecutionSummary[];
+    page: number;
+    totalCount: number;
+}
+export declare const EXECUTION_DEFINITIONS: {
+    get: {
+        apiBindings: ({
+            adapter: string;
+            apiOperationId: string;
+            legacyBuiltinContract?: never;
+            method?: never;
+            pathTemplate?: never;
+        } | {
+            apiOperationId?: never;
+            adapter: string;
+            legacyBuiltinContract: true;
+            method: string;
+            pathTemplate: string;
+        })[];
+        command: string[];
+        id: string;
+        risk: "read";
+    };
+    list: {
+        apiBindings: ({
+            legacyBuiltinContract?: never;
+            method?: never;
+            pathTemplate?: never;
+            adapter: string;
+            apiOperationId: string;
+        } | {
+            apiOperationId?: never;
+            adapter: string;
+            legacyBuiltinContract: true;
+            method: string;
+            pathTemplate: string;
+        })[];
+        command: string[];
+        id: string;
+        risk: "read";
+    };
+};
+export declare function adaptExecutionDetailResponse(value: unknown): Execution;
+export declare function adaptExecutionListResponse(value: unknown, pagination: {
+    limit: number;
+    page: number;
+}): ExecutionListResult;
+export declare class ExecutionClient {
+    private readonly runtime;
+    constructor(runtime: SemanticRuntime);
+    get(executionId: string): Promise<Execution>;
+    list(options?: {
+        limit?: number;
+        page?: number;
+        status?: string[];
+        workflowId?: string;
+    }): Promise<ExecutionListResult>;
+    wait(executionId: string, options: {
+        intervalMs?: number;
+        onUpdate?: (execution: Execution) => void;
+        signal?: AbortSignal;
+        timeoutMs: number;
+    }): Promise<Execution>;
+    watch(executionId: string, options: {
+        intervalMs?: number;
+        signal?: AbortSignal;
+        timeoutMs: number;
+    }): AsyncGenerator<Execution>;
+}
+export {};
+//# sourceMappingURL=execution.d.ts.map

package/dist/client/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/client/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAA4D,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAcxH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;iBAaL,CAAC;AAgEjB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAAG,gBAAgB,CAAC;AACjF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,GAAG,oBAAoB,CAAC,GAC5F,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,GAAG,QAAQ,GAAG,kBAAkB,GAAG,iBAAiB,CAAC,CAAC,GAAG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEJ,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBmB,CAAC;AAwBtD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAwBtE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA2C3H;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,eAAe,EAAI;IAEnD,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CASjD;IAEK,IAAI,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,gCAiBjG;IAEK,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACnH,OAAO,CAAC,SAAS,CAAC,CAmBpB;IAEM,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,SAAS,CAAC,CAmBtI;CACF"}