@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/data/attachments.js

@@ -0,0 +1,212 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { validateMediaMaxBytes } from '../transport/media-download.js';
+import { DataClient } from './client.js';
+import { batchGetFeatureValues, listViewFeatureColumns } from './feature-values.js';
+import { downloadMediaSource } from './media.js';
+import { requireExactId } from './policy.js';
+const MAX_ATTACHMENT_DEPTH = 5;
+const MAX_ATTACHMENTS = 100;
+const MAX_ATTACHMENT_VALUE_BYTES = 1024 * 1024;
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function stringValue(value) {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    return normalized || undefined;
+}
+function positiveInteger(value) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(numeric) && numeric > 0 ? Math.round(numeric) : undefined;
+}
+function safeUrl(value) {
+    const text = stringValue(value);
+    if (!text)
+        return undefined;
+    try {
+        const url = new URL(text);
+        return ['http:', 'https:'].includes(url.protocol) && !url.username && !url.password ? text : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function directAttachment(value) {
+    const record = objectValue(value);
+    const url = safeUrl(record?.url ?? value);
+    if (!url)
+        return undefined;
+    return {
+        ...(positiveInteger(record?.bytes ?? record?.size) ? { bytes: positiveInteger(record?.bytes ?? record?.size) } : {}),
+        ...(stringValue(record?.contentType ?? record?.content_type)
+            ? { contentType: stringValue(record?.contentType ?? record?.content_type) }
+            : {}),
+        ...(stringValue(record?.mediaType ?? record?.media_type) ? { mediaType: stringValue(record?.mediaType ?? record?.media_type) } : {}),
+        ...(stringValue(record?.name ?? record?.filename) ? { name: stringValue(record?.name ?? record?.filename) } : {}),
+        url,
+    };
+}
+function parseAttachmentValue(value, depth) {
+    if (depth > MAX_ATTACHMENT_DEPTH || value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'string') {
+        const text = value.trim();
+        if (!text)
+            return [];
+        if (Buffer.byteLength(text, 'utf8') > MAX_ATTACHMENT_VALUE_BYTES) {
+            throw new CliError('Feature Value 附件数据超过解析上限。', {
+                code: 'DATA_ATTACHMENT_VALUE_INVALID',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: { maxBytes: MAX_ATTACHMENT_VALUE_BYTES },
+            });
+        }
+        if (text.startsWith('[') || text.startsWith('{')) {
+            try {
+                return parseAttachmentValue(JSON.parse(text), depth + 1);
+            }
+            catch {
+                return directAttachment(text) ? [directAttachment(text)] : undefined;
+            }
+        }
+        const direct = directAttachment(text);
+        return direct ? [direct] : undefined;
+    }
+    if (Array.isArray(value)) {
+        if (value.length > MAX_ATTACHMENTS) {
+            throw new CliError(`Feature Value 中的附件超过 ${MAX_ATTACHMENTS} 个，拒绝静默截断。`, {
+                code: 'DATA_ATTACHMENT_VALUE_INVALID',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: { count: value.length, maxAttachments: MAX_ATTACHMENTS },
+            });
+        }
+        const items = value.flatMap((item) => {
+            const direct = directAttachment(item);
+            if (direct)
+                return [direct];
+            return parseAttachmentValue(item, depth + 1) ?? [];
+        });
+        return items;
+    }
+    const record = objectValue(value);
+    if (!record)
+        return undefined;
+    const direct = directAttachment(record);
+    if (direct)
+        return [direct];
+    for (const key of ['items', 'imgs', 'valueText', 'value']) {
+        if (record[key] !== undefined) {
+            const nested = parseAttachmentValue(record[key], depth + 1);
+            if (nested !== undefined)
+                return nested;
+        }
+    }
+    return undefined;
+}
+export function extractDataAttachments(value) {
+    const parsed = parseAttachmentValue(value, 0);
+    if (parsed === undefined)
+        return undefined;
+    const unique = [];
+    const seen = new Set();
+    for (const item of parsed) {
+        if (seen.has(item.url))
+            continue;
+        if (unique.length >= MAX_ATTACHMENTS) {
+            throw new CliError(`Feature Value 中的附件超过 ${MAX_ATTACHMENTS} 个，拒绝静默截断。`, {
+                code: 'DATA_ATTACHMENT_VALUE_INVALID',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: { maxAttachments: MAX_ATTACHMENTS },
+            });
+        }
+        seen.add(item.url);
+        unique.push(item);
+    }
+    return unique;
+}
+export function attachmentSummary(value) {
+    const attachments = extractDataAttachments(value);
+    if (attachments === undefined)
+        return undefined;
+    return {
+        count: attachments.length,
+        downloadable: attachments.length > 0,
+        items: attachments.map((item, index) => ({
+            index,
+            ...(item.bytes ? { bytes: item.bytes } : {}),
+            ...(item.contentType ? { contentType: item.contentType } : {}),
+            ...(item.mediaType ? { mediaType: item.mediaType } : {}),
+            ...(item.name ? { name: item.name } : {}),
+        })),
+        kind: 'attachment',
+    };
+}
+export function resolveAttachmentField(columns, selector) {
+    const normalized = selector.trim();
+    if (!normalized) {
+        throw new CliError('--field 必须是精确 Field ID 或唯一的精确名称。', {
+            code: 'DATA_ATTACHMENT_FIELD_INVALID',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    const byId = columns.find((column) => column.id === normalized);
+    if (byId)
+        return byId;
+    const byName = columns.filter((column) => column.name === normalized);
+    if (byName.length === 1)
+        return byName[0];
+    throw new CliError(byName.length > 1 ? 'Field 名称不唯一，请改用精确 Field ID。' : 'View 中不存在指定 Field。', {
+        code: byName.length > 1 ? 'DATA_ATTACHMENT_FIELD_AMBIGUOUS' : 'DATA_ATTACHMENT_FIELD_NOT_FOUND',
+        exitCode: byName.length > 1 ? EXIT_CODES.validation : EXIT_CODES.api,
+        safeDetails: { matches: byName.map((column) => column.id), selector: normalized },
+    });
+}
+export async function downloadFeatureAttachment(runtime, scope, input) {
+    validateMediaMaxBytes(input.maxBytes);
+    const assetId = requireExactId(input.assetId, 'Asset');
+    const viewId = requireExactId(input.viewId, 'View');
+    const index = input.attachmentIndex ?? 0;
+    if (!Number.isInteger(index) || index < 0 || index >= MAX_ATTACHMENTS) {
+        throw new CliError(`--attachment-index 必须在 0 到 ${MAX_ATTACHMENTS - 1} 之间。`, {
+            code: 'DATA_ATTACHMENT_INDEX_INVALID',
+            exitCode: EXIT_CODES.validation,
+            safeDetails: { index, maxExclusive: MAX_ATTACHMENTS },
+        });
+    }
+    const client = new DataClient(runtime, scope);
+    const fieldList = await listViewFeatureColumns(client, scope, viewId);
+    const field = resolveAttachmentField(fieldList.columns, input.field);
+    const batch = await batchGetFeatureValues(client, scope, viewId, [assetId], [field.id]);
+    const values = batch?.valuesByAssetId.get(assetId);
+    const rawValue = values?.[field.id] ?? values?.[field.name];
+    const attachments = extractDataAttachments(rawValue);
+    if (!attachments?.length) {
+        throw new CliError('指定 Asset/Field 没有可下载附件。', {
+            code: 'DATA_ATTACHMENT_NOT_FOUND',
+            exitCode: EXIT_CODES.api,
+            safeDetails: { assetId, fieldId: field.id, viewId },
+        });
+    }
+    const selected = attachments[index];
+    if (!selected) {
+        throw new CliError('附件序号超出当前 Feature Value 范围。', {
+            code: 'DATA_ATTACHMENT_INDEX_INVALID',
+            exitCode: EXIT_CODES.validation,
+            safeDetails: { available: attachments.length, index },
+        });
+    }
+    const downloaded = await downloadMediaSource(runtime, selected.url, input.outputPath, {
+        ...(input.maxBytes === undefined ? {} : { maxBytes: input.maxBytes }),
+        ...(input.overwrite === undefined ? {} : { overwrite: input.overwrite }),
+    });
+    return {
+        ...downloaded,
+        assetId,
+        attachmentIndex: index,
+        ...(selected.name ? { attachmentName: selected.name } : {}),
+        binding: batch?.binding ?? fieldList.binding,
+        fieldId: field.id,
+        fieldName: field.name,
+        ...(batch?.requestId ? { valueRequestId: batch.requestId } : {}),
+        viewId,
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/data/attachments.js.map

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

package/dist/data/client.d.ts

@@ -0,0 +1,45 @@
+import type { RiskLevel } from '../policy/risk.js';
+import type { HttpMethod } from '../transport/types.js';
+import type { DataRuntime } from './command.js';
+import { type DataScope } from './scope.js';
+import { type DataPerspective, type DataPerspectiveSource } from './perspective.js';
+export interface DataCallOptions {
+    body?: unknown;
+    idempotencyKey?: string;
+    legacyBinding?: {
+        apiOperationId?: string;
+        method?: HttpMethod;
+        pathTemplate: string;
+    };
+    pathParameters?: Record<string, string>;
+    query?: Record<string, boolean | number | string | Array<boolean | number | string> | undefined>;
+    scope?: DataScope;
+    scopeKeyAliases?: Array<'bucketId' | 'ontologyId'>;
+    scopeKeyOverride?: 'bucketId' | 'ontologyId';
+    scopeLocations?: Array<'body' | 'path' | 'query'>;
+}
+export interface DataCallResult<T = unknown> {
+    binding: {
+        adapter: string;
+        dataContractVariant: 'bucket-v1' | 'ontology-v1';
+        effectivePerspective?: DataPerspective;
+        perspectiveSource: DataPerspectiveSource;
+        schemaSource: 'builtin' | 'openapi';
+    };
+    data: T;
+    requestId?: string;
+}
+export interface DataPage<T = Record<string, unknown>> {
+    items: T[];
+    nextToken?: string;
+    total?: number;
+}
+export declare class DataClient {
+    private readonly runtime;
+    private readonly defaultScope?;
+    constructor(runtime: DataRuntime, defaultScope?: DataScope | undefined);
+    call<T = unknown>(id: string, method: HttpMethod, pathTemplate: string, risk: RiskLevel, options?: DataCallOptions): Promise<DataCallResult<T>>;
+    page(id: string, method: HttpMethod, pathTemplate: string, options?: DataCallOptions): Promise<DataCallResult<DataPage>>;
+    getAsset(assetId: string, scope: DataScope): Promise<DataCallResult<unknown>>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/data/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAsB1B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,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,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,eAAe,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,WAAW,GAAG,aAAa,CAAC;QACjD,oBAAoB,CAAC,EAAE,eAAe,CAAC;QACvC,iBAAiB,EAAE,qBAAqB,CAAC;QACzC,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;KACrC,CAAC;IACF,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyDD,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAFhC,YACmB,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,SAAS,YAAA,EACvC;IAEE,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAiH5B;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAajI;IAEK,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,oCAM/C;CACF"}

package/dist/data/client.js

@@ -0,0 +1,198 @@
+import { requestSemantic, semanticResponseError } from '../semantic/runtime.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { parseDataPage, parseDataResponse } from './contracts.js';
+import { requireExactId } from './policy.js';
+import { dataScopeKey } from './scope.js';
+import { resolveOperationDataPerspective, } from './perspective.js';
+import { dataResourceLocatorLocation } from './resource-locator-types.js';
+import { resolveKernelDataBinding } from './kernel-bindings.js';
+const KERNEL_ONLY_OPERATIONS = new Set([
+    'data.field.get',
+    'data.field.update',
+    'data.ontology.create',
+    'data.ontology.get',
+    'data.ontology.list',
+    'data.ontology.update',
+]);
+const STUDIO_ONLY_OPERATIONS = new Set(['data.ontology.listCreatable', 'data.ontology.listVisible']);
+function perspectiveRoute(operation) {
+    if (KERNEL_ONLY_OPERATIONS.has(operation) || operation === 'data.bucket.list.all')
+        return 'kernel';
+    if (STUDIO_ONLY_OPERATIONS.has(operation) || operation === 'data.bucket.list.creatable' || operation === 'data.bucket.list.visible') {
+        return 'studio';
+    }
+    return 'session';
+}
+function definition(id, operationId, method, pathTemplate, risk, variant, useOpenApiBinding = true) {
+    return {
+        apiBindings: [
+            ...(useOpenApiBinding ? [{ adapter: `${id}-${variant}`, apiOperationId: operationId }] : []),
+            { adapter: `${id}-${variant}`, legacyBuiltinContract: true, method, pathTemplate },
+        ],
+        command: id.split('.'),
+        id,
+        risk,
+    };
+}
+function unwrap(value) {
+    if (value && typeof value === 'object' && 'code' in value && 'data' in value)
+        return value.data;
+    return value;
+}
+function pageItems(value) {
+    const raw = unwrap(value);
+    if (Array.isArray(raw))
+        return { items: raw.filter((item) => Boolean(item && typeof item === 'object')) };
+    const record = raw && typeof raw === 'object' ? raw : {};
+    const candidate = record.items ?? record.assets ?? record.list ?? record.data ?? [];
+    const items = Array.isArray(candidate)
+        ? candidate.filter((item) => Boolean(item && typeof item === 'object'))
+        : [];
+    const nextToken = [record.nextPageToken, record.next_page_token, record.pageToken, record.nextToken].find((item) => typeof item === 'string' && item.length > 0);
+    const total = [record.total, record.totalCount].find((item) => typeof item === 'number');
+    return { items, ...(nextToken ? { nextToken } : {}), ...(total === undefined ? {} : { total }) };
+}
+function assertProtectedTeam(value, contextTeam, location) {
+    if (!value || !Object.hasOwn(value, 'teamId') || value.teamId === undefined)
+        return;
+    if (typeof value.teamId === 'string' && value.teamId === contextTeam)
+        return;
+    throw new CliError(`Data 请求${location === 'body' ? '体' : '参数'}中的 teamId 不能覆盖当前 Team 上下文。`, {
+        code: 'DATA_TEAM_OVERRIDE_NOT_ALLOWED',
+        exitCode: EXIT_CODES.validation,
+        safeDetails: { location },
+    });
+}
+export class DataClient {
+    runtime;
+    defaultScope;
+    constructor(runtime, defaultScope) {
+        this.runtime = runtime;
+        this.defaultScope = defaultScope;
+    }
+    async call(id, method, pathTemplate, risk, options = {}) {
+        const route = perspectiveRoute(id);
+        const perspective = resolveOperationDataPerspective(this.runtime.dataPerspective, this.runtime.sessionPerspective, id, route === 'kernel' ? ['kernel'] : route === 'studio' ? ['studio'] : ['kernel', 'studio'], route);
+        const variant = this.runtime.dataContract.variant;
+        const requestedBinding = variant === 'bucket-v1' && options.legacyBinding
+            ? {
+                method: options.legacyBinding.method ?? method,
+                operationId: options.legacyBinding.apiOperationId ?? id,
+                pathTemplate: options.legacyBinding.pathTemplate,
+            }
+            : { method, operationId: id, pathTemplate };
+        const kernelBinding = perspective.effectivePerspective === 'kernel' ? resolveKernelDataBinding(id, variant) : undefined;
+        const selected = kernelBinding ? { ...kernelBinding, operationId: requestedBinding.operationId } : requestedBinding;
+        const commandDefinition = definition(id, selected.operationId, selected.method, selected.pathTemplate, risk, variant, !kernelBinding);
+        const scope = options.scope ?? this.defaultScope;
+        const locatorLocation = risk === 'read' ? dataResourceLocatorLocation(id) : undefined;
+        const locatorTeam = this.runtime.context.team ? undefined : locatorLocation ? this.runtime.resourceLocator?.teamId : undefined;
+        if (locatorTeam && (!scope || this.runtime.resourceLocator?.ontologyId !== scope.id)) {
+            throw new CliError('Data 资源定位器与当前 Ontology 作用域不匹配。', {
+                code: 'DATA_RESOURCE_TEAM_SCOPE_MISMATCH',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: {
+                    actualOntologyId: this.runtime.resourceLocator?.ontologyId,
+                    expectedOntologyId: scope?.id,
+                    operation: id,
+                    requestState: 'not_sent',
+                },
+            });
+        }
+        const protectedTeam = this.runtime.context.team ?? locatorTeam;
+        const locations = options.scopeLocations ?? [];
+        const scopeKey = scope ? (options.scopeKeyOverride ?? dataScopeKey(scope)) : undefined;
+        const scopeKeys = scopeKey ? Array.from(new Set([scopeKey, ...(options.scopeKeyAliases ?? [])])) : [];
+        const rewriteScope = (value) => {
+            if (!scope)
+                return value;
+            const hasScope = Object.hasOwn(value, 'bucketId') || Object.hasOwn(value, 'ontologyId');
+            const { bindToBucket, bindToOntology, bucketId: _bucketId, ontologyId: _ontologyId, ...rest } = value;
+            return {
+                ...rest,
+                ...(hasScope ? Object.fromEntries(scopeKeys.map((key) => [key, scope.id])) : {}),
+                ...(bindToBucket === undefined && bindToOntology === undefined
+                    ? {}
+                    : { [scope.variant === 'ontology-v1' ? 'bindToOntology' : 'bindToBucket']: bindToOntology ?? bindToBucket }),
+            };
+        };
+        const bodyRecord = options.body && typeof options.body === 'object' && !Array.isArray(options.body)
+            ? options.body
+            : undefined;
+        assertProtectedTeam(bodyRecord, locatorLocation === 'body' ? protectedTeam : this.runtime.context.team, 'body');
+        assertProtectedTeam(options.query, locatorLocation === 'query' ? protectedTeam : this.runtime.context.team, 'query');
+        const scopedBody = scope && locations.includes('body')
+            ? {
+                ...(bodyRecord ?? {}),
+                ...Object.fromEntries(scopeKeys.map((key) => [key, scope.id])),
+            }
+            : bodyRecord
+                ? rewriteScope(bodyRecord)
+                : options.body;
+        if (locatorTeam && locatorLocation === 'body' && (!scopedBody || typeof scopedBody !== 'object' || Array.isArray(scopedBody))) {
+            throw new CliError('当前 Data 操作需要 Object 请求体才能应用资源定位 Team。', {
+                code: 'DATA_RESOURCE_TEAM_REQUIRED',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: { operation: id, requestState: 'not_sent' },
+            });
+        }
+        const body = locatorTeam && locatorLocation === 'body' ? { ...scopedBody, teamId: locatorTeam } : scopedBody;
+        const pathParameters = rewriteScope({
+            ...(options.pathParameters ?? {}),
+            ...(scope && locations.includes('path') ? Object.fromEntries(scopeKeys.map((key) => [key, scope.id])) : {}),
+        });
+        const query = rewriteScope({
+            ...(options.query ?? {}),
+            ...(this.runtime.context.team
+                ? { teamId: this.runtime.context.team }
+                : locatorTeam && locatorLocation === 'query'
+                    ? { teamId: locatorTeam }
+                    : {}),
+            ...(scope && locations.includes('query') ? Object.fromEntries(scopeKeys.map((key) => [key, scope.id])) : {}),
+        });
+        const result = await requestSemantic(this.runtime, commandDefinition, {
+            ...(body === undefined ? {} : { body }),
+            ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
+            ...(Object.keys(pathParameters).length > 0 ? { pathParameters } : {}),
+            query,
+        });
+        try {
+            const unwrapped = unwrap(result.response.data);
+            const normalized = method === 'DELETE' && unwrapped === undefined ? { success: true } : unwrapped;
+            const data = parseDataResponse(id, normalized, variant);
+            return {
+                binding: {
+                    adapter: result.binding.adapter,
+                    dataContractVariant: variant,
+                    ...(perspective.effectivePerspective ? { effectivePerspective: perspective.effectivePerspective } : {}),
+                    perspectiveSource: perspective.perspectiveSource,
+                    schemaSource: result.binding.schemaSource,
+                },
+                data,
+                ...(result.response.requestId ? { requestId: result.response.requestId } : {}),
+            };
+        }
+        catch (cause) {
+            throw semanticResponseError(this.runtime, commandDefinition, cause, risk === 'read' ? 'read_failed' : 'sent');
+        }
+    }
+    async page(id, method, pathTemplate, options = {}) {
+        const result = await this.call(id, method, pathTemplate, 'read', options);
+        const data = pageItems(parseDataPage(result.data, this.runtime.dataContract.variant));
+        const requestedLimit = [options.query?.limit, options.query?.pageSize].find((value) => typeof value === 'number' && Number.isInteger(value) && value > 0);
+        return {
+            ...result,
+            data: requestedLimit === undefined || data.items.length <= requestedLimit
+                ? data
+                : { ...data, items: data.items.slice(0, requestedLimit) },
+        };
+    }
+    async getAsset(assetId, scope) {
+        return this.call('data.asset.get', 'GET', '/api/v2/data/assets/{assetId}', 'read', {
+            pathParameters: { assetId: requireExactId(assetId, 'Asset') },
+            scope,
+            scopeLocations: ['query'],
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/data/client.js.map

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

package/dist/data/command.d.ts

@@ -0,0 +1,63 @@
+import { type DataScope } from './scope.js';
+import type { DataResourceLocator } from './resource-locator-types.js';
+export type DataTeamMode = 'context' | 'filter' | 'none';
+export declare function loadDataRuntime(profile?: string, team?: string, perspective?: string): Promise<{
+    attemptId: string;
+    client: Awaited<ReturnType<typeof import("../index.js").createAuthenticatedClient>>;
+    digest?: string;
+    document?: import("../index.js").OpenApiDocument;
+    fallbackKey: Uint8Array;
+    index: ReturnType<typeof import("../index.js").indexOpenApi>;
+    schemaFresh: boolean;
+    context: {
+        baseUrl: string;
+        caBundle?: string;
+        credential: Readonly<import("../index.js").ResolvedCredential>;
+        dataContract: import("../index.js").DataContractMode;
+        deployment: string;
+        expectedPrincipal?: string;
+        expectedSurfaces: readonly string[];
+        profile: string;
+        proxyRef?: string;
+        team?: string;
+        tenant: string;
+        fingerprint: string;
+    };
+    dataContract: import("./contract-variant.js").DataContractResolution;
+    dataPerspective: import("./perspective.js").DataPerspective | undefined;
+    sessionPerspective: import("./perspective.js").DataPerspective | undefined;
+    teamMode: DataTeamMode;
+}>;
+export type DataRuntime = Awaited<ReturnType<typeof loadDataRuntime>> & {
+    resourceLocator?: DataResourceLocator;
+};
+export declare function readOptionalJson(json?: string, file?: string): Promise<unknown>;
+export declare function dataMeta(runtime: DataRuntime, binding: {
+    effectivePerspective?: 'kernel' | 'studio';
+    perspectiveSource?: 'fixed-route' | 'legacy-unverified' | 'session-scope';
+    schemaSource: string;
+}, scope?: DataScope): {
+    dataScope?: {
+        id: string;
+        kind: "legacy-bucket" | "ontology";
+    };
+    deprecation?: {
+        flag: string;
+        replacement: string;
+        schemaMajor: number;
+    };
+    contextFingerprint: string;
+    dataContractSource: import("./contract-variant.js").DataContractResolutionSource;
+    dataContractVariant: import("./contract-variant.js").DataContractVariant;
+    effectiveTeamId?: string;
+    resourceLocator?: DataResourceLocator;
+    effectivePerspective?: "kernel" | "studio";
+    perspectiveSource: "fixed-route" | "legacy-unverified" | "session-scope";
+    requestedPerspective: string;
+    schemaFresh: boolean;
+    schemaSource: string;
+    teamMode: DataTeamMode;
+};
+export declare function requireJsonObject(value: unknown, label?: string): Record<string, unknown>;
+export declare function requireJsonArray(value: unknown, label?: string): unknown[];
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/data/command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;GAsB1F;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,GAAG;IAAE,eAAe,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIrF;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE;IACP,oBAAoB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3C,iBAAiB,CAAC,EAAE,aAAa,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC1E,YAAY,EAAE,MAAM,CAAC;CACtB,EACD,KAAK,CAAC,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;EAgBlB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK5F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAY,GAAG,OAAO,EAAE,CAK7E"}

package/dist/data/command.js

@@ -0,0 +1,64 @@
+import { parseJsonValue, readJsonFile } from '../api/command-runtime.js';
+import { loadSemanticRuntime } from '../semantic/runtime.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { resolveDataContract } from './contract-variant.js';
+import { dataScopeMeta } from './scope.js';
+import { dataPerspectiveFingerprint, parseDataPerspective, resolveSessionDataPerspective } from './perspective.js';
+export async function loadDataRuntime(profile, team, perspective) {
+    const dataPerspective = parseDataPerspective(perspective);
+    const runtime = await loadSemanticRuntime({
+        ...(dataPerspective === 'kernel' ? { inheritDefaultTeam: false } : {}),
+        ...(profile ? { profile } : {}),
+        ...(team ? { team } : {}),
+    });
+    const sessionPerspective = await resolveSessionDataPerspective(runtime.client, dataPerspective);
+    const dataContract = await resolveDataContract(runtime);
+    const teamMode = dataPerspective === 'kernel' ? (runtime.context.team ? 'filter' : 'none') : runtime.context.team ? 'context' : 'none';
+    return {
+        ...runtime,
+        context: {
+            ...runtime.context,
+            fingerprint: dataPerspectiveFingerprint(runtime.context.fingerprint, dataPerspective),
+        },
+        dataContract,
+        dataPerspective,
+        sessionPerspective,
+        teamMode,
+    };
+}
+export async function readOptionalJson(json, file) {
+    if (file)
+        return readJsonFile(file);
+    if (json)
+        return parseJsonValue(json, 'Data 输入');
+    return undefined;
+}
+export function dataMeta(runtime, binding, scope) {
+    return {
+        contextFingerprint: runtime.context.fingerprint,
+        dataContractSource: runtime.dataContract.source,
+        dataContractVariant: runtime.dataContract.variant,
+        ...(runtime.context.team ? { effectiveTeamId: runtime.context.team } : {}),
+        ...(runtime.resourceLocator ? { resourceLocator: runtime.resourceLocator } : {}),
+        ...(binding.effectivePerspective ? { effectivePerspective: binding.effectivePerspective } : {}),
+        perspectiveSource: binding.perspectiveSource ?? 'legacy-unverified',
+        requestedPerspective: runtime.dataPerspective ?? 'legacy',
+        ...(scope ? dataScopeMeta(scope) : {}),
+        schemaFresh: runtime.schemaFresh,
+        schemaSource: binding.schemaSource,
+        teamMode: runtime.teamMode,
+    };
+}
+export function requireJsonObject(value, label = 'Data 输入') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new CliError(`${label} 必须是 JSON Object。`, { code: 'DATA_INPUT_INVALID', exitCode: EXIT_CODES.validation });
+    }
+    return value;
+}
+export function requireJsonArray(value, label = 'Data 输入') {
+    if (!Array.isArray(value)) {
+        throw new CliError(`${label} 必须是 JSON Array。`, { code: 'DATA_INPUT_INVALID', exitCode: EXIT_CODES.validation });
+    }
+    return value;
+}
+//# sourceMappingURL=command.js.map

package/dist/data/command.js.map

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