@enterpriseai/cli 3.19.4 → 3.20.0

package/README.md

@@ -118,8 +118,8 @@ eai workspace select
 #    attempts first-admin bootstrap for the current login, and only marks
 #    the workspace usable after workspace-admin membership is confirmed
 #    (platform role ID `tenant-admin`).
-#    The child home region defaults to the parent region; pass
-#    `--home-region au|ca|eu` when the child must use another region.
+#    A child workspace always inherits its parent's home region;
+#    `--home-region` applies only to root workspaces (`--allow-root`).
 
 # 4. Sync project environment if your app needs local configuration
 eai env pull --include-secrets
@@ -508,26 +508,55 @@ role definitions, Entra configuration, databases, or cloud portals.
 
 ## Support reports
 
-Run `eai support` after an unresolved CLI failure. It shows a locally redacted
-report and asks before sending. The report includes the last failing command,
-catalog error code and reason, CLI version, OS, and known workspace/app context.
-Credentials and unrelated environment settings are excluded.
-Saved failure context contains command and catalog metadata only. Raw error text
-is never saved for a later report; recognized errors use the catalog's title.
+Run `eai support` when you want help with a CLI failure. It shows a locally
+redacted report and asks before sending. The report includes the last failing
+command, catalog error code and reason, CLI version, OS, and known workspace/app
+context. Credentials and unrelated environment settings are excluded. Saved
+failure context contains command and catalog metadata only, is left out of the
+report after 24 hours (the CLI shows its time), and `--no-last-error` skips it.
 
-For an AI harness, preview first:
+Every failing command ends with the same offer: "Need help? Run eai support, or
+ask your AI assistant to get help. Nothing is sent without your approval." Text mode
+prints this on every nonzero exit. JSON error keys stay unchanged; `error.suggestion`
+contains only the catalog suggestion.
+
+Re-run `eai init --tool <tool>` to refresh instructions in projects created with older CLI versions.
+`eai gofer refresh` preserves their CLAUDE.md and AGENTS.md.
+
+An AI harness starts a report only when you ask for EAI Support ("get help" or
+`eai support`). Generic coding help, command failures, failed fixes and error hints do not authorize any eai support call, including allocation, preview, sending or decline.
+Write a short summary of the chat problem, attempts and results, without raw transcripts, environment values or file contents.
+It passes its bounded session summary (what you asked, the goal,
+steps, commands, errors, attempted fixes and project-relative files) through `--context-file`.
+For a file, run `eai support --create-context-file --format json`, then write the summary into the returned `contextFile` without replacing it. The CLI allocates it in `~/.eai/support/context/` (directory 0700, file 0600) and records its identity. Preview keeps it; an approved send deletes it. On a declined preview, run `eai support --decline --context-file <path> --format json` to clean it up without sending. Marked files older than 24 hours are removed on the next support run. Untracked files and files elsewhere are never deleted.
+
+`--context-file`, which reads a JSON file or stdin (`-`), accepts at most 64 KiB,
+redacts credentials, hides your home directory and project root, and drops the
+oldest steps, commands and errors to stay within the website's 32 KiB cap:
 
 ```bash
-eai support --source harness --tool codex --format json
+eai support --source harness --tool codex --context-file - --format json
 ```
 
-Show the person the returned bundle. After they explicitly approve that report,
-rerun the same command with `--yes`. JSON runs without `--yes` never send a report.
-The returned link contains only a draft id and one-time token in its fragment.
-Open it to review and submit the report before the draft expires.
+The JSON preview returns `previewText`, the whole redacted report as plain text
+ending with its digest, and `bundleDigest`. The harness shows `previewText`
+unchanged and asks you. After you approve, it reruns with
+`--yes --approved-digest <bundleDigest>`; any other digest answers
+`consent_stale` and sends nothing. JSON runs without `--yes` never send a report,
+and `--yes` always needs the digest, including interactive text runs.
 
-A missing or expired `eai login` session, or a website 401, returns the plain
-Support link and creates no draft. `--no-open` prints the link without opening a
+When the saved session has no active workspace, the report needs to know where
+your organisation is based so it is stored in that region. A terminal asks you;
+JSON runs answer `consent_required` with `questions: ["organisationLocation"]`
+until `--organisation-location apac|emea|americas` is supplied. If the website
+still cannot place the report it answers `region_required`, and the CLI returns
+the Support chat link instead.
+
+The returned link contains only a draft id and one-time token in its fragment.
+Open it to review and submit the report before the draft expires. A missing or
+expired `eai login` session, a website 401, a declined report or `region_required`
+returns `<website>/support?chat=open`, which opens the Support chat without
+prefill and creates no draft. `--no-open` prints the link without opening a
 browser. Reports never go in URL parameters.
 
 Existing projects can preview updated harness instructions with
@@ -872,3 +901,5 @@ Full documentation: https://eai-support.github.io/eai/
 - [ ] `eai dev --offline` — local mock gateway for offline development
 - [ ] `eai tunnel` — Cloudflare tunnel for webhook testing
 - [x] npmjs install alias (`npm install -g eai-cli`) with static registry fallback
+
+Bundled Gofer assets stay pinned to v3.14.3 and include the support-only patch from eai-gofer#433 until its release. Regenerated entrypoints include the existing Gofer 3.12.7 to 3.14.3 generator drift.

package/dist/commands/agent.js

@@ -60,7 +60,9 @@ Examples:
 Notes:
   - Use this before improvising eai commands.
   - Prefer read-only diagnostics before commands marked [changes state].
-  - On failure, run eai errors explain <code-or-reason> --format json.
+  - If advertised, query eai errors explain <code-or-reason> --format json at most once for the original failure.
+  - Never retry or explain a failed eai errors explain command; report unavailable guidance, then stop and wait.
+  - Follow read-only diagnostics automatically; ask before changes, stop at the retry limit, then stop and wait.
   `)
     .action((options) => {
     const jsonOutput = options.json || options.format === 'json';

package/dist/commands/agent.js.map

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

package/dist/commands/content-understanding.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+interface CuOptions {
+    file?: string;
+    tenantId?: string;
+    plan?: string;
+    operationId?: string;
+    format?: string;
+    wait?: boolean;
+    timeout?: string;
+}
+/** Validate the caller's identity before index-level profile activation can exit. */
+export declare function contentUnderstandingPreflightOperationId(options: CuOptions): string | undefined;
+export declare const contentUnderstandingCommand: Command;
+export {};
+//# sourceMappingURL=content-understanding.d.ts.map

package/dist/commands/content-understanding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-understanding.d.ts","sourceRoot":"","sources":["../../src/commands/content-understanding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAgB5C,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwDD,qFAAqF;AACrF,wBAAgB,wCAAwC,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAG/F;AAuED,eAAO,MAAM,2BAA2B,SAoBtC,CAAC"}

package/dist/commands/content-understanding.js

@@ -0,0 +1,277 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { Command, Option } from 'commander';
+import { resolveCommandContext } from '../lib/context.js';
+import { requireManagedPublicApiUrl } from '../lib/managed-public-api.js';
+import { isRecord } from '../lib/utils.js';
+import * as out from '../lib/output.js';
+import { errorCatalog } from '../lib/error-codes.js';
+import { CANONICAL_TENANT_ID, ContentUnderstandingError, parseContentUnderstandingManifest, } from '../lib/content-understanding-manifest.js';
+import { parseContentUnderstandingCapabilities, parseContentUnderstandingOperation, parseContentUnderstandingPlan, readContentUnderstandingResponse, requireContentUnderstandingOperationId, requireWaitTimeout, requireContentUnderstandingManifestCapabilities, } from '../lib/content-understanding-client.js';
+async function readLocalJson(path, code, label) {
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        throw new ContentUnderstandingError(code, `${label} file could not be read.`);
+    }
+    if (bytes.length > 1024 * 1024)
+        throw new ContentUnderstandingError(code, `${label} file exceeds the input size budget.`);
+    try {
+        // Preserve a BOM so JSON parsing retains the existing refusal, while fatal decoding
+        // prevents changing malformed input bytes before binding or submitting the plan.
+        return { bytes, value: JSON.parse(new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes)) };
+    }
+    catch {
+        throw new ContentUnderstandingError(code, `${label} file must contain valid UTF-8 JSON.`);
+    }
+}
+async function readManifest(path) {
+    if (!path)
+        throw new ContentUnderstandingError('CU_INVALID_MANIFEST', '--file is required.');
+    const { bytes, value } = await readLocalJson(path, 'CU_INVALID_MANIFEST', 'Manifest');
+    return { manifest: parseContentUnderstandingManifest(value), manifestSha256: createHash('sha256').update(bytes).digest('hex') };
+}
+function tenantId(options, manifest) {
+    if (typeof options.tenantId !== 'string' || !CANONICAL_TENANT_ID.test(options.tenantId) || options.tenantId === '00000000-0000-0000-0000-000000000000'
+        || (manifest && manifest.tenantId !== options.tenantId)) {
+        throw new ContentUnderstandingError('CU_TENANT_MISMATCH', '--tenant-id must be a canonical workspace UUID matching the manifest.');
+    }
+    return options.tenantId;
+}
+async function contextFor(id) {
+    const context = await resolveCommandContext({ tenantId: id, interactive: false, forceRefresh: true,
+        validatePublicApiUrl: requireManagedPublicApiUrl, pinPublicApiUrl: true,
+        onError: (code, message) => { throw new ContentUnderstandingError(code, message ?? errorCatalog[code].message); } });
+    if (context.tenantId !== id)
+        throw new ContentUnderstandingError('CU_TENANT_MISMATCH', 'Resolved workspace differs from the requested workspace.');
+    return context;
+}
+function print(options, value) {
+    if (options.format === 'json')
+        out.json(value);
+    else if (!value.ok) {
+        out.error(('error' in value ? value.error?.message : undefined) || 'Content Understanding request failed.');
+        if ('error' in value && value.error?.operationId)
+            out.info(`Operation ID: ${value.error.operationId}`);
+    }
+    else if ('body' in value && isRecord(value.body)) {
+        const body = value.body;
+        if (body.$schema) {
+            process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+            return;
+        }
+        out.success(typeof body.status === 'string' ? `Content Understanding ${body.status}${typeof body.operationId === 'string' ? ` (${body.operationId})` : ''}`
+            : 'ready' in body ? `Content Understanding ${body.ready === true ? 'ready' : 'not ready'}` : 'Content Understanding configuration valid');
+    }
+    else
+        out.success('Content Understanding configuration valid');
+    if (!value.ok)
+        process.exitCode = 1;
+}
+function failure(error) {
+    const known = error instanceof ContentUnderstandingError;
+    return { ok: false, ...(known && error.status ? { status: error.status } : {}),
+        error: { code: known ? error.code : 'CU_REQUEST_FAILED', message: error instanceof Error ? error.message : 'Content Understanding request failed.',
+            ...(known && error.operationId ? { operationId: error.operationId } : {}) } };
+}
+/** Validate the caller's identity before index-level profile activation can exit. */
+export function contentUnderstandingPreflightOperationId(options) {
+    try {
+        return options.operationId === undefined ? undefined : requireContentUnderstandingOperationId(options.operationId);
+    }
+    catch (error) {
+        print(options, failure(error));
+        process.exit(1);
+    }
+}
+function action(handler, retainRequestedOperation = false) {
+    return async (options) => {
+        let requestedOperation;
+        try {
+            if (retainRequestedOperation && options.operationId !== undefined)
+                requestedOperation = requireContentUnderstandingOperationId(options.operationId);
+            print(options, await handler(options));
+        }
+        catch (error) {
+            const result = failure(error);
+            // This is the valid identity supplied by the caller, not a server
+            // acknowledgment. Preflight failure never creates an operation receipt.
+            if (requestedOperation && result.error)
+                result.error.operationId = requestedOperation;
+            print(options, result);
+        }
+    };
+}
+async function capabilities(context, timeoutMs) {
+    return parseContentUnderstandingCapabilities(await readContentUnderstandingResponse(await context.client.getContentUnderstandingCapabilities(timeoutMs)), context.tenantId);
+}
+async function parsePlanFile(options, input) {
+    if (!options.plan)
+        throw new ContentUnderstandingError('CU_PLAN_MISMATCH', '--plan must name the unchanged saved JSON plan.');
+    const { value } = await readLocalJson(options.plan, 'CU_PLAN_MISMATCH', 'Plan');
+    if (!isRecord(value) || value.ok !== true || value.kind !== 'eai.content-understanding.plan' || value.schemaVersion !== 1 || !isRecord(value.binding)
+        || value.binding.tenantId !== input.manifest.tenantId || value.binding.bundleKey !== input.manifest.bundleKey
+        || value.binding.manifestSha256 !== input.manifestSha256 || typeof value.binding.publicApiUrl !== 'string') {
+        throw new ContentUnderstandingError('CU_PLAN_MISMATCH', 'Saved plan does not match the unchanged manifest file and workspace/bundle.');
+    }
+    const body = parseContentUnderstandingPlan(value.body, input.manifest.tenantId, input.manifest.bundleKey);
+    return { ok: true, kind: 'eai.content-understanding.plan', schemaVersion: 1,
+        binding: { tenantId: input.manifest.tenantId, bundleKey: input.manifest.bundleKey,
+            publicApiUrl: value.binding.publicApiUrl, manifestSha256: input.manifestSha256 }, body };
+}
+function operationReadError(error, operationId) {
+    return error instanceof ContentUnderstandingError
+        ? new ContentUnderstandingError(error.code, error.message, operationId, error.status)
+        : new ContentUnderstandingError('CU_OPERATION_READ_FAILED', 'Reading this operation failed. Keep its ID and inspect the original operation before resuming.', operationId);
+}
+async function waitForOperation(context, initial, options, deadline, resume) {
+    let operation = initial;
+    try {
+        while (options.wait && ['pending', 'running'].includes(operation.status) && Date.now() < deadline) {
+            if (operation.nextAction === 'apply') {
+                if (!resume)
+                    return { ok: false, body: operation, error: { code: 'CU_REQUIRES_APPLY',
+                            message: 'Provider work is ready; resume apply with the unchanged manifest, saved plan and this operation ID to publish or activate. Status remains read-only.', operationId: operation.operationId } };
+                operation = await resume(initial.operationId, Math.max(1, deadline - Date.now()));
+                if (!['pending', 'running'].includes(operation.status))
+                    break;
+            }
+            await new Promise(resolve => setTimeout(resolve, Math.min(2000, Math.max(0, deadline - Date.now()))));
+            if (Date.now() >= deadline)
+                break;
+            operation = parseContentUnderstandingOperation(await readContentUnderstandingResponse(await context.client.getContentUnderstandingOperation(initial.operationId, Math.max(1, deadline - Date.now()))), context.tenantId, initial);
+        }
+    }
+    catch (error) {
+        const retained = operationReadError(error, initial.operationId);
+        return { ...failure(retained), body: operation };
+    }
+    if (['failed', 'unknown', 'partial'].includes(operation.status))
+        return { ok: false, body: operation,
+            error: { code: `CU_OPERATION_${operation.status.toUpperCase()}`, message: `Content Understanding operation is ${operation.status}; retain its ID and inspect its steps before resuming.`, operationId: operation.operationId } };
+    if (operation.status === 'succeeded' && operation.currentReady !== true)
+        return { ok: false, body: operation,
+            error: { code: 'CU_CURRENT_READINESS_UNVERIFIED', message: 'Historical completion does not verify current workspace and provider readiness. Retain this operation ID and inspect current readback blockers before processing documents.', operationId: operation.operationId } };
+    if (options.wait && operation.status !== 'succeeded')
+        return { ok: false, body: operation,
+            error: { code: 'CU_OPERATION_PENDING', message: 'Wait deadline reached. Use status for this operation; no replacement operation was submitted.', operationId: operation.operationId } };
+    return { ok: true, status: operation.status === 'succeeded' ? 200 : 202, body: operation };
+}
+export const contentUnderstandingCommand = new Command('content-understanding')
+    .description('Validate, plan and materialize bounded document analyzers through the selected workspace PublicAPI')
+    .addHelpText('after', `
+Harness workflow:
+  eai content-understanding schema --format json
+  eai content-understanding validate --file cu.json --format json
+  eai content-understanding capabilities --tenant-id <workspace-id> --format json
+  eai content-understanding plan --file cu.json --tenant-id <workspace-id> --format json > cu-plan.json
+  eai content-understanding apply --file cu.json --plan cu-plan.json --tenant-id <workspace-id> --format json
+  eai content-understanding status --operation-id <operation-id> --tenant-id <workspace-id> --format json
+
+Your harness authors the manifest. The platform owns Azure credentials, approved models,
+provider ownership and readiness. Typed mode must be enabled and qualified on that workspace.
+Only document fields and flat classification are available. Graphs and segmentation are refused.
+Formula, figure and output-format settings require features.advancedDocumentConfig exactly true.
+Before planning, prepare the existing app/workflow binding and matching tenant-owned
+classifier draft with the existing setup and eai classifier save commands.
+Keep the original manifest and plan for deliberate recovery after an unknown acknowledgement.
+Status only reads existing operations; acceptance and pending work are not completion.
+Succeeded historical work requires currentReady exactly true before document processing.
+`);
+function outputOptions(command) {
+    return command.addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'));
+}
+function workspaceOptions(command) {
+    return outputOptions(command.requiredOption('--tenant-id <id>', 'Exact owning workspace UUID'));
+}
+function waitOptions(command) {
+    return command.option('--wait', command.name() === 'apply' ? 'Wait for this exact operation; resume acknowledged remaining steps when requested' : 'Poll this exact operation without any mutation', false)
+        .option('--timeout <seconds>', 'Wait deadline, 1 to 1800 seconds', '300');
+}
+outputOptions(contentUnderstandingCommand.command('schema').description('Print the local manifest JSON schema and semantic bounds'))
+    .action(action(async () => {
+    const schema = JSON.parse(await readFile(new URL('../../resources/content-understanding/manifest.schema.json', import.meta.url), 'utf8'));
+    return { ok: true, body: schema };
+}));
+outputOptions(contentUnderstandingCommand.command('validate').description('Validate the complete manifest locally with no authentication or network access')
+    .requiredOption('--file <path>', 'Declarative document configuration JSON'))
+    .action(action(async (options) => {
+    const input = await readManifest(options.file);
+    return { ok: true, body: { valid: true, kind: input.manifest.kind,
+            schemaVersion: input.manifest.schemaVersion, bundleKey: input.manifest.bundleKey, manifestSha256: input.manifestSha256,
+            documentTypes: input.manifest.documentTypes.map(doc => doc.code) } };
+}));
+workspaceOptions(contentUnderstandingCommand.command('capabilities').description('Read actual selected-workspace typed mode, prerequisites and readiness'))
+    .action(action(async (options) => ({ ok: true, body: await capabilities(await contextFor(tenantId(options))) })));
+workspaceOptions(contentUnderstandingCommand.command('plan').description('Read prerequisites and return a scope-bound configuration plan; writes nothing')
+    .requiredOption('--file <path>', 'Declarative document configuration JSON'))
+    .action(action(async (options) => {
+    const input = await readManifest(options.file), context = await contextFor(tenantId(options, input.manifest));
+    const body = parseContentUnderstandingPlan(await readContentUnderstandingResponse(await context.client.planContentUnderstandingConfiguration(input.manifest)), context.tenantId, input.manifest.bundleKey);
+    return { ok: true, kind: 'eai.content-understanding.plan', schemaVersion: 1,
+        binding: { tenantId: context.tenantId, bundleKey: input.manifest.bundleKey,
+            publicApiUrl: context.publicApiUrl, manifestSha256: input.manifestSha256 }, body };
+}));
+waitOptions(workspaceOptions(contentUnderstandingCommand.command('apply').description('Apply or explicitly resume the unchanged saved plan after current capability checks')
+    .requiredOption('--file <path>', 'Original declarative document configuration JSON')
+    .requiredOption('--plan <path>', 'Original JSON output from the plan command')
+    .option('--operation-id <id>', 'Resume this exact acknowledged canonical operation UUID')))
+    .action(action(async (options) => {
+    const timeout = requireWaitTimeout(options.timeout), input = await readManifest(options.file), id = tenantId(options, input.manifest);
+    const plan = await parsePlanFile(options, input), requestedOperation = options.operationId === undefined ? undefined : requireContentUnderstandingOperationId(options.operationId);
+    if (plan.body.ready !== true || plan.body.blockers.length > 0)
+        throw new ContentUnderstandingError('CU_NOT_READY', 'Saved plan has unresolved prerequisites. Obtain a ready plan before applying.');
+    const context = await contextFor(id);
+    if (plan.binding.publicApiUrl !== context.publicApiUrl)
+        throw new ContentUnderstandingError('CU_PLAN_MISMATCH', 'Selected PublicAPI gateway differs from the saved plan.');
+    const available = await capabilities(context);
+    if (available.enabled !== true || available.ready !== true)
+        throw new ContentUnderstandingError('CU_NOT_READY', 'Typed configuration is not enabled and ready on this workspace.');
+    requireContentUnderstandingManifestCapabilities(input.manifest, available);
+    // The backend checks actual versions/model bindings, or recovers the original durable operation before checking changed activation state.
+    const deadline = Date.now() + timeout;
+    let raw;
+    try {
+        raw = await readContentUnderstandingResponse(await context.client.applyContentUnderstandingConfiguration(input.manifest, plan.body.planDigest, plan.body.expectedVersions, requestedOperation, Math.max(1, deadline - Date.now())));
+    }
+    catch (error) {
+        if (error instanceof ContentUnderstandingError && error.status !== undefined)
+            throw requestedOperation ? operationReadError(error, requestedOperation) : error;
+        return { ok: false, binding: plan.binding, planDigest: plan.body.planDigest,
+            error: { code: 'CU_APPLY_ACK_UNKNOWN', message: 'Apply acknowledgement is unknown. Keep the original manifest and plan; deliberately rerun that original apply to recover its durable operation. Do not create a replacement plan.',
+                ...(requestedOperation ? { operationId: requestedOperation } : {}) } };
+    }
+    const operation = parseContentUnderstandingOperation(raw, id, { operationId: requestedOperation, bundleKey: input.manifest.bundleKey,
+        definitionDigest: plan.body.definitionDigest });
+    return waitForOperation(context, operation, options, deadline, async (operationId, timeoutMs) => {
+        const current = await capabilities(context, timeoutMs);
+        if (current.enabled !== true || current.ready !== true)
+            throw new ContentUnderstandingError('CU_NOT_READY', 'Typed configuration is no longer enabled and ready; retain the existing operation.', operationId);
+        requireContentUnderstandingManifestCapabilities(input.manifest, current);
+        try {
+            return parseContentUnderstandingOperation(await readContentUnderstandingResponse(await context.client.applyContentUnderstandingConfiguration(input.manifest, plan.body.planDigest, plan.body.expectedVersions, operationId, Math.max(1, deadline - Date.now()))), id, { operationId, bundleKey: input.manifest.bundleKey, definitionDigest: plan.body.definitionDigest });
+        }
+        catch (error) {
+            if (error instanceof ContentUnderstandingError && (error.status !== undefined || ['CU_OPERATION_MISMATCH', 'CU_OPERATION_INVALID'].includes(error.code)))
+                throw error;
+            throw new ContentUnderstandingError('CU_APPLY_ACK_UNKNOWN', 'Resume acknowledgement is unknown. Inspect this original operation before deliberately repeating the unchanged apply.', operationId);
+        }
+    });
+}, true));
+waitOptions(workspaceOptions(contentUnderstandingCommand.command('status').description('Read or wait for an existing operation; dispatches no provider mutation')
+    .requiredOption('--operation-id <id>', 'Exact acknowledged canonical operation UUID')))
+    .action(action(async (options) => {
+    const timeout = requireWaitTimeout(options.timeout), operationId = requireContentUnderstandingOperationId(options.operationId), context = await contextFor(tenantId(options));
+    const deadline = Date.now() + timeout;
+    let operation;
+    try {
+        operation = parseContentUnderstandingOperation(await readContentUnderstandingResponse(await context.client.getContentUnderstandingOperation(operationId, Math.max(1, deadline - Date.now()))), context.tenantId, { operationId });
+    }
+    catch (error) {
+        throw operationReadError(error, operationId);
+    }
+    return waitForOperation(context, operation, options, deadline);
+}, true));
+//# sourceMappingURL=content-understanding.js.map

package/dist/commands/content-understanding.js.map

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

package/dist/commands/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmDpC,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3E;AAED,eAAO,MAAM,WAAW,SAoBpB,CAAC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAsD5C,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3E;AAED,eAAO,MAAM,WAAW,SAsBpB,CAAC"}

package/dist/commands/docs.js

@@ -1,12 +1,15 @@
 /**
  * eai docs — document management (upload, classify, index).
  */
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import ora from 'ora';
 import chalk from 'chalk';
 import { parseApiError, validateDocumentUploadContext } from '../lib/api.js';
 import { makeSpinner, resolveCommandContext } from '../lib/context.js';
 import * as out from '../lib/output.js';
+import { isRecord } from '../lib/utils.js';
+import { ContentUnderstandingError } from '../lib/content-understanding-manifest.js';
+import { readContentUnderstandingResponse, requireWaitTimeout } from '../lib/content-understanding-client.js';
 function addUploadOptions(command) {
     return command
         .option('--tenant-id <id>', 'Use a specific workspace with the current user login')
@@ -35,6 +38,8 @@ Typical workflow:
   1. Configure and publish the app's document schemas and workflow classifier
   2. Run classify once to upload and queue analysis, or upload for full processing
   3. Poll the returned job ID and read the saved results; acceptance is not completion
+     eai docs job <job-id> --tenant-id <workspace-id> --wait --format json
+     eai docs get <document-id> --job-id <job-id> --tenant-id <workspace-id> --format json
 
 Standalone documents require a business document lifecycle enabled on the
 app/workflow binding. PublicAPI checks readiness and permissions before writing.
@@ -44,6 +49,129 @@ Use docs commands when the file is the subject of document processing or AI
 context. Use "eai resources file" when the file is an attachment to a typed
 resource object.
   `);
+function readIdentifier(value, label) {
+    if (!value || value === '.' || value === '..' || value.trim() !== value || value.length > 256 || /[\uD800-\uDFFF]/u.test(value) || [...value].some(character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127)) {
+        throw new ContentUnderstandingError('DOC_IDENTIFIER_INVALID', `${label} must be a nonempty bounded identifier.`);
+    }
+    return value;
+}
+function readFailure(error) {
+    return { ok: false, ...(error instanceof ContentUnderstandingError && error.status ? { status: error.status } : {}),
+        error: { code: error instanceof ContentUnderstandingError ? error.code : 'DOC_REQUEST_FAILED',
+            message: error instanceof Error ? error.message : 'Document read failed.' } };
+}
+function printRead(options, result) {
+    if (options.format === 'json')
+        out.json(result);
+    else if (result.ok !== true)
+        out.error(isRecord(result.error) && typeof result.error.message === 'string' ? result.error.message : 'Document read failed.');
+    else if (isRecord(result.body))
+        out.info(`Document ${String(result.body.status || result.body.processingStatus || 'record retrieved')}`);
+    if (result.ok !== true)
+        process.exitCode = 1;
+}
+/** Return the exact observed spelling only when all supplied aliases agree. */
+function aliasedIdentifier(value, camel, snake) {
+    const supplied = [camel, snake].filter(key => Object.hasOwn(value, key)).map(key => value[key]);
+    if (supplied.length === 0)
+        return undefined;
+    if (supplied.some(identifier => typeof identifier !== 'string' || identifier.length === 0)
+        || supplied.some(identifier => identifier !== supplied[0]))
+        return null;
+    return supplied[0];
+}
+function parseJob(value, jobId, tenantId) {
+    const observedTenant = aliasedIdentifier(value, 'tenantId', 'tenant_id');
+    if (aliasedIdentifier(value, 'jobId', 'job_id') !== jobId || (observedTenant !== undefined && observedTenant !== tenantId) || typeof value.status !== 'string'
+        || !['queued', 'processing', 'completed', 'completed_with_errors', 'failed'].includes(value.status)
+        || !Array.isArray(value.documents) || value.documents.some(doc => !isRecord(doc) || typeof aliasedIdentifier(doc, 'documentId', 'document_id') !== 'string')) {
+        throw new ContentUnderstandingError('DOC_JOB_MISMATCH', 'Document job does not match the requested job and workspace.');
+    }
+    return value;
+}
+docsCommand.command('job <jobId>').description('Read an accepted document job; optionally wait without repeating upload')
+    .option('--tenant-id <id>', 'Exact owning workspace')
+    .option('--wait', 'Poll this exact job only', false)
+    .option('--timeout <seconds>', 'Wait deadline, 1 to 1800 seconds', '300')
+    .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+    .action(async (jobId, options) => {
+    try {
+        readIdentifier(jobId, 'Job ID');
+        const timeout = requireWaitTimeout(options.timeout);
+        const context = await resolveCommandContext({ tenantId: options.tenantId, interactive: false });
+        const path = `/v4/data/documents/jobs/${encodeURIComponent(jobId)}`, deadline = Date.now() + timeout;
+        let response = await context.client.getDocumentJob(jobId, Math.max(1, deadline - Date.now()));
+        let job = parseJob(await readContentUnderstandingResponse(response), jobId, context.tenantId);
+        const failedJob = () => ['failed', 'completed_with_errors'].includes(String(job.status))
+            || job.documents.some(doc => ['storage', 'classification', 'rag']
+                .some(key => isRecord(doc[key]) && doc[key].status === 'failed'));
+        const pendingStages = () => {
+            const documents = job.documents;
+            return documents.length === 0 || documents.some(doc => ['storage', 'classification', 'rag'].some(key => {
+                if (!Object.hasOwn(doc, key))
+                    return false;
+                const stage = doc[key];
+                return !isRecord(stage) || (stage.status !== 'completed' && stage.status !== 'skipped');
+            }));
+        };
+        while (options.wait && !failedJob() && (job.status !== 'completed' || pendingStages()) && Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, Math.min(2000, Math.max(0, deadline - Date.now()))));
+            if (Date.now() >= deadline)
+                break;
+            response = await context.client.getDocumentJob(jobId, Math.max(1, deadline - Date.now()));
+            job = parseJob(await readContentUnderstandingResponse(response), jobId, context.tenantId);
+        }
+        const failed = failedJob();
+        const pending = !failed && ((options.wait && job.status !== 'completed') || (job.status === 'completed' && pendingStages()));
+        printRead(options, { ok: !failed && !pending, status: response.status, request: { method: 'GET', path,
+                ...context.client.getRequestScope() }, body: job,
+            ...(failed || pending ? { error: { code: failed ? 'DOC_JOB_FAILED' : 'DOC_JOB_PENDING',
+                    message: failed ? 'Document job failed or completed with errors; inspect its pipeline results.'
+                        : options.wait ? 'Wait deadline reached. Poll this job again; do not re-upload.'
+                            : 'Document job has incomplete pipeline results. Poll this job again; do not re-upload.', jobId } } : {}) });
+    }
+    catch (error) {
+        printRead(options, { ...readFailure(error), jobId });
+    }
+});
+docsCommand.command('get <documentId>').description('Read the persisted document and analysis result through PublicAPI')
+    .option('--tenant-id <id>', 'Exact owning workspace')
+    .option('--job-id <id>', 'Original accepted job ID for the document')
+    .addOption(new Option('--storage-target <target>', 'Document storage target').choices(['resourceapi']).default('resourceapi'))
+    .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+    .action(async (documentId, options) => {
+    try {
+        readIdentifier(documentId, 'Document ID');
+        if (options.jobId !== undefined)
+            readIdentifier(options.jobId, 'Job ID');
+        const context = await resolveCommandContext({ tenantId: options.tenantId, interactive: false });
+        const params = new URLSearchParams({ storage_target: 'resourceapi', ...(options.jobId ? { job_id: options.jobId } : {}) });
+        const path = `/v4/data/documents/records/${encodeURIComponent(documentId)}?${params}`;
+        const response = await context.client.getDocumentRecord(documentId, options.jobId);
+        const body = await readContentUnderstandingResponse(response);
+        const observedTenant = aliasedIdentifier(body, 'tenantId', 'tenant_id'), observedJob = aliasedIdentifier(body, 'jobId', 'job_id');
+        const untrackedJob = !options.jobId && ['jobId', 'job_id'].every(key => body[key] === undefined || body[key] === null);
+        if (aliasedIdentifier(body, 'documentId', 'document_id') !== documentId || aliasedIdentifier(body, 'storageTarget', 'storage_target') !== 'resourceapi'
+            || (observedTenant !== undefined && observedTenant !== context.tenantId)
+            || (body.tenant !== undefined && body.tenant !== context.tenantId)
+            || (observedJob === null && !untrackedJob) || (options.jobId && observedJob !== options.jobId)) {
+            throw new ContentUnderstandingError('DOC_RECORD_MISMATCH', 'Document result does not match the requested document, job and workspace.');
+        }
+        const processingStatuses = [body.processingStatus,
+            ...(body.machineAnalysis !== undefined ? [isRecord(body.machineAnalysis) ? body.machineAnalysis.processingStatus : undefined] : [])];
+        const failed = processingStatuses.some(status => typeof status === 'string' && ['failed', 'completed_with_errors', 'partial_failure'].includes(status));
+        const pending = !failed && processingStatuses.some(status => status !== 'complete' && status !== 'completed');
+        printRead(options, { ok: !failed && !pending, status: response.status, request: { method: 'GET', path,
+                ...context.client.getRequestScope() }, body,
+            ...(failed || pending ? { error: { code: failed ? 'DOC_RECORD_FAILED' : 'DOC_RECORD_PENDING',
+                    message: failed ? 'Persisted document processing failed; inspect its analysis results.'
+                        : 'Persisted document processing is incomplete. Poll the original job and read this document again; do not re-upload.',
+                    documentId, ...(options.jobId ? { jobId: options.jobId } : {}) } } : {}) });
+    }
+    catch (error) {
+        printRead(options, { ...readFailure(error), documentId, ...(options.jobId ? { jobId: options.jobId } : {}) });
+    }
+});
 // ─── eai docs upload ─────────────────────────────────────────────────────
 addUploadOptions(docsCommand
     .command('upload <file>')