@tiangong-ai/cli 0.0.50 → 0.0.55

package/dist/data/catalog.js

@@ -0,0 +1,305 @@
+import { isIP } from "node:net";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { DATA_CATALOG_SCHEMA_VERSION, DATA_DISCOVERY_SCHEMA_VERSION, DATA_MANIFEST_SCHEMA_VERSION, } from "./contracts.js";
+import { sha256CanonicalJson } from "./runtime/canonical-json.js";
+import { DataRuntimeError } from "./runtime/errors.js";
+import { validateDataPublicContract } from "./schemas.js";
+export class DataRegistry {
+    #connectors;
+    constructor(definitions) {
+        this.#connectors = new Map();
+        for (const definition of [...definitions].sort((left, right) => codePointOrder(left.capabilityId, right.capabilityId))) {
+            if (this.#connectors.has(definition.capabilityId)) {
+                throw new DataRuntimeError("internal-error", `Duplicate data capability ID: ${definition.capabilityId}.`);
+            }
+            const connector = registerConnector(definition);
+            this.#connectors.set(definition.capabilityId, connector);
+        }
+    }
+    catalog() {
+        const capabilities = [...this.#connectors.values()].map(toCatalogCapability);
+        const stable = { schemaVersion: DATA_CATALOG_SCHEMA_VERSION, capabilities };
+        const result = {
+            ...stable,
+            catalogDigest: sha256CanonicalJson(stable),
+        };
+        validateDataPublicContract("catalog", result);
+        return structuredClone(result);
+    }
+    describe(capabilityId) {
+        const manifest = this.#connectors.get(capabilityId)?.manifest;
+        return manifest ? structuredClone(manifest) : undefined;
+    }
+    discovery(capabilityId) {
+        const discovery = this.#connectors.get(capabilityId)?.discovery;
+        return discovery ? structuredClone(discovery) : undefined;
+    }
+    schemas(capabilityId) {
+        const schemas = this.#connectors.get(capabilityId)?.schemas;
+        return schemas ? structuredClone(schemas) : undefined;
+    }
+    registered(capabilityId) {
+        return this.#connectors.get(capabilityId);
+    }
+}
+export function createDataRegistry(definitions = []) {
+    return new DataRegistry(definitions);
+}
+function registerConnector(source) {
+    const definition = cloneAndFreezeConnector(source);
+    assertConnectorDefinition(definition);
+    const operations = new Map();
+    const schemaDocuments = {};
+    const operationManifests = [];
+    const operationDiscoveries = [];
+    for (const operation of [...definition.operations].sort((left, right) => codePointOrder(left.operationId, right.operationId))) {
+        if (operations.has(operation.operationId)) {
+            throw new DataRuntimeError("internal-error", `Duplicate operation ID in ${definition.capabilityId}: ${operation.operationId}.`);
+        }
+        const inputSchemaId = schemaId(operation.inputSchema, "input", operation.operationId);
+        const outputSchemaId = schemaId(operation.outputSchema, "output", operation.operationId);
+        if (schemaDocuments[inputSchemaId] || schemaDocuments[outputSchemaId]) {
+            throw new DataRuntimeError("internal-error", `Duplicate operation schema ID in ${definition.capabilityId}.`);
+        }
+        const limits = mergeLimits(definition.limits, operation.limits);
+        const manifest = {
+            operationId: operation.operationId,
+            operationVersion: operation.operationVersion,
+            inputSchema: {
+                schemaId: inputSchemaId,
+                digest: sha256CanonicalJson(operation.inputSchema),
+            },
+            outputSchema: {
+                schemaId: outputSchemaId,
+                digest: sha256CanonicalJson(operation.outputSchema),
+            },
+            limits,
+            ...(operation.artifactOutput === undefined
+                ? {}
+                : { artifactOutput: structuredClone(operation.artifactOutput) }),
+        };
+        const inputAjv = operationAjv();
+        const outputAjv = operationAjv();
+        const validateInput = inputAjv.compile(operation.inputSchema);
+        const validateOutput = outputAjv.compile(operation.outputSchema);
+        operations.set(operation.operationId, {
+            definition: operation,
+            manifest,
+            validateInput,
+            validateOutput,
+        });
+        schemaDocuments[inputSchemaId] = structuredClone(operation.inputSchema);
+        schemaDocuments[outputSchemaId] = structuredClone(operation.outputSchema);
+        operationManifests.push(manifest);
+        operationDiscoveries.push({
+            operationId: operation.operationId,
+            summary: operation.summary,
+            description: operation.description,
+        });
+    }
+    const stableManifest = {
+        schemaVersion: DATA_MANIFEST_SCHEMA_VERSION,
+        capabilityId: definition.capabilityId,
+        capabilityVersion: definition.capabilityVersion,
+        minimumCliVersion: definition.minimumCliVersion,
+        providerId: definition.provider.providerId,
+        endpoints: [...definition.endpoints]
+            .sort((left, right) => codePointOrder(left.endpointId, right.endpointId))
+            .map((endpoint) => ({
+            ...structuredClone(endpoint),
+            pathPrefixes: [...endpoint.pathPrefixes].sort(codePointOrder),
+            allowedMethods: [...endpoint.allowedMethods].sort(codePointOrder),
+            allowedContentTypes: [...endpoint.allowedContentTypes].sort(codePointOrder),
+        })),
+        credentials: [...definition.credentials]
+            .sort((left, right) => codePointOrder(left.credentialId, right.credentialId))
+            .map((credential) => ({
+            ...structuredClone(credential),
+            endpointIds: [...credential.endpointIds].sort(codePointOrder),
+        })),
+        limits: structuredClone(definition.limits),
+        diagnostics: structuredClone(definition.diagnostics),
+        operations: operationManifests,
+    };
+    const published = {
+        ...stableManifest,
+        manifestDigest: sha256CanonicalJson(stableManifest),
+    };
+    validateDataPublicContract("manifest", published);
+    const stableDiscovery = {
+        schemaVersion: DATA_DISCOVERY_SCHEMA_VERSION,
+        capabilityId: definition.capabilityId,
+        capabilityVersion: definition.capabilityVersion,
+        source: {
+            providerId: definition.provider.providerId,
+            name: definition.provider.name,
+            maintainedBy: definition.discovery.source.maintainedBy,
+            sourceCategory: definition.sourceCategory,
+            summary: definition.discovery.source.summary,
+            description: definition.discovery.source.description,
+            coverage: structuredClone(definition.discovery.source.coverage),
+        },
+        summary: definition.discovery.summary,
+        description: definition.discovery.description,
+        provides: [...definition.discovery.provides].sort(codePointOrder),
+        doesNotProvide: [...definition.discovery.doesNotProvide].sort(codePointOrder),
+        selectionHints: [...definition.discovery.selectionHints].sort(codePointOrder),
+        typicalUseCases: [...definition.discovery.typicalUseCases].sort(codePointOrder),
+        sourceDocumentation: [...definition.discovery.sourceDocumentation]
+            .sort((left, right) => codePointOrder(left.url, right.url) || codePointOrder(left.title, right.title))
+            .map((document) => structuredClone(document)),
+        license: {
+            ...structuredClone(definition.license),
+            restrictions: [...definition.license.restrictions].sort(codePointOrder),
+        },
+        freshness: structuredClone(definition.freshness),
+        limitations: [...definition.limitations].sort(codePointOrder),
+        operations: operationDiscoveries,
+    };
+    const discovery = {
+        ...stableDiscovery,
+        discoveryDigest: sha256CanonicalJson(stableDiscovery),
+    };
+    validateDataPublicContract("discovery", discovery);
+    return {
+        definition,
+        manifest: published,
+        discovery,
+        operations,
+        schemas: schemaDocuments,
+    };
+}
+function cloneAndFreezeConnector(source) {
+    const clone = {
+        ...source,
+        provider: structuredClone(source.provider),
+        endpoints: source.endpoints.map((endpoint) => structuredClone(endpoint)),
+        license: structuredClone(source.license),
+        credentials: source.credentials.map((credential) => structuredClone(credential)),
+        limits: structuredClone(source.limits),
+        diagnostics: structuredClone(source.diagnostics),
+        freshness: structuredClone(source.freshness),
+        limitations: [...source.limitations],
+        discovery: structuredClone(source.discovery),
+        operations: source.operations.map((operation) => ({
+            ...operation,
+            inputSchema: structuredClone(operation.inputSchema),
+            outputSchema: structuredClone(operation.outputSchema),
+            ...(operation.limits === undefined ? {} : { limits: structuredClone(operation.limits) }),
+            ...(operation.artifactOutput === undefined
+                ? {}
+                : { artifactOutput: structuredClone(operation.artifactOutput) }),
+        })),
+    };
+    return deepFreeze(clone);
+}
+function deepFreeze(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    for (const item of Object.values(value))
+        deepFreeze(item);
+    return Object.freeze(value);
+}
+function assertConnectorDefinition(definition) {
+    if (definition.schemaVersion !== DATA_MANIFEST_SCHEMA_VERSION) {
+        throw new DataRuntimeError("incompatible-contract", "Unsupported data manifest version.");
+    }
+    if (definition.operations.length === 0) {
+        throw new DataRuntimeError("internal-error", "A data connector must define an operation.");
+    }
+    assertLimits(definition.limits);
+    const endpointIds = new Set();
+    for (const endpoint of definition.endpoints) {
+        if (endpointIds.has(endpoint.endpointId)) {
+            throw new DataRuntimeError("internal-error", "Data endpoint IDs must be unique.");
+        }
+        endpointIds.add(endpoint.endpointId);
+        const base = new URL(endpoint.baseUrl);
+        if (base.protocol !== "https:" ||
+            base.username ||
+            base.password ||
+            base.search ||
+            base.hash ||
+            (base.pathname !== "/" && base.pathname !== "") ||
+            isIP(base.hostname) !== 0) {
+            throw new DataRuntimeError("endpoint-policy-blocked", "Data endpoint base URLs must be credential-free HTTPS origins with DNS hostnames.");
+        }
+        if (endpoint.pathPrefixes.length === 0 ||
+            endpoint.pathPrefixes.some((prefix) => !prefix.startsWith("/") || !prefix.endsWith("/") || prefix.includes("\\"))) {
+            throw new DataRuntimeError("endpoint-policy-blocked", "Data endpoint path prefixes must be absolute slash-delimited directory prefixes.");
+        }
+    }
+    for (const credential of definition.credentials) {
+        if (credential.endpointIds.some((endpointId) => !endpointIds.has(endpointId))) {
+            throw new DataRuntimeError("endpoint-policy-blocked", "A logical credential references an undeclared endpoint.");
+        }
+    }
+    if (definition.diagnostics.live !== Boolean(definition.liveDoctor)) {
+        throw new DataRuntimeError("internal-error", "Live doctor support must match the connector diagnostics declaration.");
+    }
+}
+function assertLimits(limits) {
+    const positive = [
+        limits.timeoutMs,
+        limits.maxRequestBytes,
+        limits.maxResponseBytes,
+        limits.maxPages,
+        limits.maxRecords,
+    ];
+    const nonNegative = [limits.maxRetries, limits.maxRetryDelayMs, limits.maxRedirects];
+    if (positive.some((value) => !Number.isInteger(value) || value < 1) ||
+        nonNegative.some((value) => !Number.isInteger(value) || value < 0)) {
+        throw new DataRuntimeError("internal-error", "Data connector limits are invalid.");
+    }
+}
+function mergeLimits(base, override) {
+    const merged = { ...base, ...override };
+    assertLimits(merged);
+    for (const key of Object.keys(base)) {
+        if (merged[key] > base[key]) {
+            throw new DataRuntimeError("internal-error", `Operation limit ${key} cannot exceed its capability limit.`);
+        }
+    }
+    return merged;
+}
+function schemaId(schema, direction, operationId) {
+    const id = schema.$id;
+    if (typeof id !== "string" || !id.trim()) {
+        throw new DataRuntimeError("internal-error", `The ${operationId} ${direction} schema must declare a stable $id.`);
+    }
+    if (schema.$schema !== "https://json-schema.org/draft/2020-12/schema") {
+        throw new DataRuntimeError("incompatible-contract", `The ${operationId} ${direction} schema must use JSON Schema 2020-12.`);
+    }
+    return id;
+}
+function operationAjv() {
+    return new Ajv2020({ allErrors: true, strict: true, validateFormats: false });
+}
+function toCatalogCapability(connector) {
+    const manifest = connector.manifest;
+    const discovery = connector.discovery;
+    return {
+        capabilityId: manifest.capabilityId,
+        capabilityVersion: manifest.capabilityVersion,
+        minimumCliVersion: manifest.minimumCliVersion,
+        providerId: manifest.providerId,
+        sourceCategory: discovery.source.sourceCategory,
+        summary: discovery.summary,
+        provides: [...discovery.provides],
+        doesNotProvide: [...discovery.doesNotProvide],
+        manifestDigest: manifest.manifestDigest,
+        discoveryDigest: discovery.discoveryDigest,
+        operations: manifest.operations.map((operation) => ({
+            operationId: operation.operationId,
+            operationVersion: operation.operationVersion,
+            summary: discovery.operations.find((item) => item.operationId === operation.operationId)?.summary ??
+                operation.operationId,
+            inputSchemaDigest: operation.inputSchema.digest,
+            outputSchemaDigest: operation.outputSchema.digest,
+        })),
+    };
+}
+function codePointOrder(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/data/catalog.js.map

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

package/dist/data/commands.d.ts

@@ -0,0 +1,9 @@
+import type { CliIO } from "../io.js";
+import type { DataRegistry } from "./catalog.js";
+export interface RunDataCommandOptions {
+    registry?: DataRegistry | undefined;
+    fetchImpl?: typeof fetch | undefined;
+    clock?: (() => Date) | undefined;
+}
+export declare function runDataCommand(argv: string[], io: CliIO, options?: RunDataCommandOptions): Promise<number>;
+export declare function dataHelp(): string;

package/dist/data/commands.js

@@ -0,0 +1,307 @@
+import { readFile } from "node:fs/promises";
+import { CliError } from "../errors.js";
+import { stringifyJson, write } from "../io.js";
+import { parseStrictArgs, strictBoolean, strictString } from "../strict-args.js";
+import { builtInDataRegistry } from "./builtins.js";
+import { DATA_DESCRIBE_SCHEMA_VERSION, DATA_DOCTOR_SCHEMA_VERSION, DATA_ERROR_SCHEMA_VERSION, } from "./contracts.js";
+import { createBoundedHttpClient } from "./runtime/bounded-http.js";
+import { resolveDataCredentials } from "./runtime/credentials.js";
+import { dataErrorExitCode, DataRuntimeError, toDataMachineError } from "./runtime/errors.js";
+import { executeDataRun } from "./runtime/execute.js";
+import { validateDataPublicContract } from "./schemas.js";
+const MAX_DATA_INPUT_BYTES = 1024 * 1024;
+export async function runDataCommand(argv, io, options = {}) {
+    const json = argv.includes("--json");
+    const registry = options.registry ?? builtInDataRegistry;
+    try {
+        const [subcommand, ...rest] = argv;
+        if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+            write(io.stdout, dataHelp());
+            return 0;
+        }
+        if (subcommand === "catalog")
+            return runCatalog(rest, io, registry);
+        if (subcommand === "describe")
+            return runDescribe(rest, io, registry);
+        if (subcommand === "doctor")
+            return runDoctor(rest, io, registry, options);
+        if (subcommand === "run")
+            return runOperation(rest, io, registry, options);
+        throw new DataRuntimeError("unsupported-operation", "Unknown data command. Use tiangong-ai data --help.", { details: { subcommand } });
+    }
+    catch (error) {
+        const normalized = error instanceof CliError
+            ? new DataRuntimeError("invalid-request", error.message, { exitCode: 2 })
+            : error;
+        const machine = toDataMachineError(normalized);
+        if (json) {
+            const envelope = {
+                schemaVersion: DATA_ERROR_SCHEMA_VERSION,
+                status: "blocked",
+                errors: [machine],
+            };
+            validateDataPublicContract("error", envelope);
+            write(io.stdout, stringifyJson(envelope, true));
+        }
+        else {
+            write(io.stderr, `${machine.message}\n`);
+        }
+        return normalized instanceof DataRuntimeError
+            ? normalized.exitCode
+            : dataErrorExitCode(machine.code);
+    }
+}
+export function dataHelp() {
+    return `Tiangong atomic data commands
+
+Usage:
+  tiangong-ai data catalog [--json]
+  tiangong-ai data describe <capability-id> [--json]
+  tiangong-ai data doctor <capability-id> [--live] [--json]
+  tiangong-ai data run <capability-id> <operation-id> --input <path|-> [--artifact-dir <absolute-existing-directory>] [--json]
+
+Data commands use closed, versioned machine contracts. catalog, describe, and
+static doctor are offline. Only an explicit doctor --live or data run may use
+the network. Credentials are resolved from manifest-declared environment
+variables and must never be placed in argv or input JSON.
+`;
+}
+function runCatalog(argv, io, registry) {
+    const args = parseStrictArgs(argv, { help: "boolean", json: "boolean" }, "data catalog");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, dataHelp());
+        return 0;
+    }
+    assertPositionals(args.positionals, 0, "data catalog");
+    const result = registry.catalog();
+    if (strictBoolean(args, "json")) {
+        write(io.stdout, stringifyJson(result, true));
+    }
+    else if (result.capabilities.length === 0) {
+        write(io.stdout, "No built-in data capabilities are registered.\n");
+    }
+    else {
+        for (const capability of result.capabilities) {
+            write(io.stdout, `${capability.capabilityId}\t${capability.capabilityVersion}\t${capability.providerId}\t${capability.summary}\n`);
+        }
+    }
+    return 0;
+}
+function runDescribe(argv, io, registry) {
+    const args = parseStrictArgs(argv, { help: "boolean", json: "boolean" }, "data describe");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, dataHelp());
+        return 0;
+    }
+    assertPositionals(args.positionals, 1, "data describe");
+    const capabilityId = args.positionals[0];
+    const manifest = registry.describe(capabilityId);
+    const discovery = registry.discovery(capabilityId);
+    const schemas = registry.schemas(capabilityId);
+    if (!manifest || !discovery || !schemas) {
+        throw new DataRuntimeError("invalid-request", "The requested data capability is not registered.", {
+            details: { capabilityId },
+        });
+    }
+    const result = {
+        schemaVersion: DATA_DESCRIBE_SCHEMA_VERSION,
+        manifest,
+        discovery,
+        schemas,
+    };
+    validateDataPublicContract("describe", result);
+    if (strictBoolean(args, "json")) {
+        write(io.stdout, stringifyJson(result, true));
+    }
+    else {
+        write(io.stdout, `${manifest.capabilityId} ${manifest.capabilityVersion}\n`);
+        write(io.stdout, `${discovery.summary}\n`);
+        write(io.stdout, `source ${discovery.source.name}\n`);
+        write(io.stdout, `manifest ${manifest.manifestDigest}\n`);
+        write(io.stdout, `discovery ${discovery.discoveryDigest}\n`);
+        for (const item of discovery.provides)
+            write(io.stdout, `provides ${item}\n`);
+        for (const item of discovery.doesNotProvide) {
+            write(io.stdout, `does-not-provide ${item}\n`);
+        }
+        for (const operation of manifest.operations) {
+            const operationDiscovery = discovery.operations.find((item) => item.operationId === operation.operationId);
+            write(io.stdout, `${operation.operationId} ${operation.operationVersion}\t${operationDiscovery?.summary ?? ""}\n`);
+        }
+    }
+    return 0;
+}
+async function runDoctor(argv, io, registry, options) {
+    const args = parseStrictArgs(argv, { help: "boolean", json: "boolean", live: "boolean" }, "data doctor");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, dataHelp());
+        return 0;
+    }
+    assertPositionals(args.positionals, 1, "data doctor");
+    const capabilityId = args.positionals[0];
+    const connector = registry.registered(capabilityId);
+    if (!connector) {
+        throw new DataRuntimeError("invalid-request", "The requested data capability is not registered.", {
+            details: { capabilityId },
+        });
+    }
+    const live = strictBoolean(args, "live");
+    const resolved = resolveDataCredentials(connector.definition.credentials, io.env);
+    let checks = [
+        {
+            checkId: "manifest",
+            status: "pass",
+            message: "The built-in manifest and operation schemas are valid.",
+        },
+        ...resolved.checks,
+    ];
+    let networkAttempted = false;
+    if (live) {
+        if (!connector.definition.diagnostics.live || !connector.definition.liveDoctor) {
+            throw new DataRuntimeError("unsupported-operation", "This data capability does not provide a live doctor probe.");
+        }
+        if (!checks.some((check) => check.status === "fail")) {
+            const http = createBoundedHttpClient({
+                capabilityId: connector.manifest.capabilityId,
+                endpoints: connector.definition.endpoints,
+                credentials: connector.definition.credentials,
+                environment: io.env,
+                limits: connector.definition.limits,
+                ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+            });
+            const liveResult = await connector.definition.liveDoctor({ http });
+            checks = [...checks, ...liveResult.checks];
+            networkAttempted = liveResult.networkAttempted ?? true;
+        }
+    }
+    const status = checks.some((check) => check.status === "fail")
+        ? "blocked"
+        : checks.some((check) => check.status === "warn")
+            ? "degraded"
+            : "ready";
+    const result = {
+        schemaVersion: DATA_DOCTOR_SCHEMA_VERSION,
+        capabilityId: connector.manifest.capabilityId,
+        capabilityVersion: connector.manifest.capabilityVersion,
+        manifestDigest: connector.manifest.manifestDigest,
+        mode: live ? "live" : "static",
+        status,
+        networkAttempted,
+        checks,
+    };
+    validateDataPublicContract("doctor", result);
+    if (strictBoolean(args, "json")) {
+        write(io.stdout, stringifyJson(result, true));
+    }
+    else {
+        write(io.stdout, `${result.capabilityId}\t${result.mode}\t${result.status}\n`);
+        for (const check of checks)
+            write(io.stdout, `${check.status}\t${check.message}\n`);
+    }
+    return status === "blocked" ? 3 : 0;
+}
+async function runOperation(argv, io, registry, options) {
+    const args = parseStrictArgs(argv, { "artifact-dir": "string", help: "boolean", input: "string", json: "boolean" }, "data run");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, dataHelp());
+        return 0;
+    }
+    assertPositionals(args.positionals, 2, "data run");
+    const inputSource = strictString(args, "input");
+    if (!inputSource) {
+        throw new DataRuntimeError("invalid-request", "data run requires --input <path|->.", {
+            exitCode: 2,
+        });
+    }
+    const rawRequest = await readDataInput(inputSource, io);
+    assertCommandBinding(rawRequest, args.positionals[0], args.positionals[1]);
+    const artifactOutputDirectory = strictString(args, "artifact-dir");
+    const result = await executeDataRun(rawRequest, {
+        registry,
+        environment: io.env,
+        ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        ...(options.clock === undefined ? {} : { clock: options.clock }),
+        ...(artifactOutputDirectory === undefined ? {} : { artifactOutputDirectory }),
+    });
+    if (strictBoolean(args, "json")) {
+        write(io.stdout, stringifyJson(result, true));
+    }
+    else {
+        writeHumanRunResult(io, result);
+    }
+    if (result.status === "success")
+        return 0;
+    if (result.status === "partial")
+        return 4;
+    return dataErrorExitCode(result.errors[0]?.code ?? "internal-error");
+}
+async function readDataInput(source, io) {
+    let bytes;
+    if (source === "-") {
+        if (!io.stdin) {
+            throw new DataRuntimeError("invalid-request", "Standard input is unavailable.", {
+                exitCode: 2,
+            });
+        }
+        const chunks = [];
+        let total = 0;
+        for await (const chunk of io.stdin) {
+            const bytesChunk = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            total += bytesChunk.byteLength;
+            if (total > MAX_DATA_INPUT_BYTES) {
+                throw new DataRuntimeError("invalid-request", "The data run input exceeds 1 MiB.", {
+                    exitCode: 2,
+                });
+            }
+            chunks.push(bytesChunk);
+        }
+        bytes = Buffer.concat(chunks);
+    }
+    else {
+        try {
+            bytes = await readFile(source);
+        }
+        catch {
+            throw new DataRuntimeError("invalid-request", "The data run input file could not be read.", {
+                exitCode: 2,
+            });
+        }
+        if (bytes.byteLength > MAX_DATA_INPUT_BYTES) {
+            throw new DataRuntimeError("invalid-request", "The data run input exceeds 1 MiB.", {
+                exitCode: 2,
+            });
+        }
+    }
+    try {
+        return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    }
+    catch {
+        throw new DataRuntimeError("invalid-request", "The data run input is not valid UTF-8 JSON.", {
+            exitCode: 2,
+        });
+    }
+}
+function assertCommandBinding(value, capabilityId, operationId) {
+    const request = value;
+    if (!request ||
+        typeof request !== "object" ||
+        request.capabilityId !== capabilityId ||
+        request.operationId !== operationId) {
+        throw new DataRuntimeError("invalid-request", "The command capability and operation must match the input request contract.", { exitCode: 2 });
+    }
+}
+function assertPositionals(positionals, count, command) {
+    if (positionals.length !== count) {
+        throw new DataRuntimeError("invalid-request", `${command} expects exactly ${count} positional argument${count === 1 ? "" : "s"}.`, { exitCode: 2 });
+    }
+}
+function writeHumanRunResult(io, result) {
+    write(io.stdout, `${result.status}\t${result.contract.capabilityId}/${result.contract.operationId}\n`);
+    write(io.stdout, `records\t${result.summary.recordCount}\n`);
+    write(io.stdout, `receipt\t${result.receipt.receiptDigest}\n`);
+    for (const warning of result.warnings)
+        write(io.stdout, `warning\t${warning}\n`);
+    for (const error of result.errors)
+        write(io.stdout, `error\t${error.code}\t${error.message}\n`);
+}
+//# sourceMappingURL=commands.js.map