@trydreamstate/cli 1.3.2 → 1.3.3

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,EAAE,MAA2C,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC;IAC7C,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAYD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAahF,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oGAAoG;IACpG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;KACb;CAaT;AASD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB1E;AAqED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACrF,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,wBAAwB,CAAC,CAKnC;AAkDD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAA4B;gBAElD,OAAO,EAAE,uBAAuB;IAQ5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAG7B,4FAA4F;IAC5F,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAGnC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAG7B,SAAS,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGhE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG9E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGzC,UAAU,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGjE,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAGtE,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAGjC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGhF,SAAS,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGhE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpF,aAAa,CACX,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,iBAAiB,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC;IAYnB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGpC,QAAQ,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG/D,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/F,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG/E,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YASjF,OAAO;CAwHtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,15 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DreamstateClient = exports.CliError = exports.TOOL_AND_RUN_REQUEST_TIMEOUT_MS = exports.DEFAULT_REQUEST_TIMEOUT_MS = exports.CLI_VERSION = void 0;
+exports.DreamstateClient = exports.CliError = exports.TOOL_AND_RUN_REQUEST_TIMEOUT_MS = exports.DEFAULT_REQUEST_TIMEOUT_MS = exports.CLI_UPDATE_COMMAND = exports.CLI_VERSION = void 0;
+exports.readServerReleaseInfo = readServerReleaseInfo;
+exports.describeVersionSkew = describeVersionSkew;
 exports.readToolEnvelopeTraceId = readToolEnvelopeTraceId;
 exports.requestDeviceAuthorization = requestDeviceAuthorization;
 exports.claimDeviceAuthorization = claimDeviceAuthorization;
-const node_crypto_1 = require("node:crypto");
+const idempotency_1 = require("./idempotency");
+const errors_1 = require("./errors");
 exports.CLI_VERSION = require('../package.json').version;
+/** Command that updates the CLI. One constant so every surface prints the same one. */
+exports.CLI_UPDATE_COMMAND = 'npm install -g @trydreamstate/cli@latest';
 exports.DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
 exports.TOOL_AND_RUN_REQUEST_TIMEOUT_MS = 60_000;
-/** Server workspace refusals rewritten so the message says what to run next. */
-const WORKSPACE_ERROR_MESSAGES = {
+/**
+ * Next steps for server workspace refusals. The server's message is forwarded
+ * unchanged; the CLI's own guidance travels beside it as details.cli_hint, so
+ * an agent reading either surface sees the same message and a script can tell
+ * what the server said from what the CLI added.
+ */
+const WORKSPACE_ERROR_HINTS = {
     workspace_required: 'No workspace is selected. Run dreamstate workspaces list, then dreamstate workspaces use <workspace> (or pass --workspace <id|slug>).',
     workspace_forbidden: 'You are not a member of that workspace. Run dreamstate workspaces list to see the workspaces you can use, then dreamstate workspaces use <workspace>.',
     workspace_scoped_credential: 'This key is bound to one workspace. Run dreamstate login for a user session that can switch, or remove --workspace and DREAMSTATE_WORKSPACE.',
@@ -24,6 +34,8 @@ class CliError extends Error {
     /** The server's retry decision and repair, forwarded unchanged so the CLI never re-derives them. */
     retryable;
     repair;
+    /** The server's own envelope meta (trace_id, server_version, ...), kept whole so a refusal prints what the server said. */
+    meta;
     constructor(message, code, status, options = {}) {
         super(message);
         this.name = 'CliError';
@@ -41,9 +53,48 @@ class CliError extends Error {
             this.retryable = options.retryable;
         if (options.repair !== undefined)
             this.repair = options.repair;
+        else if (code in errors_1.CLI_LOCAL_ERROR_REPAIRS)
+            this.repair = errors_1.CLI_LOCAL_ERROR_REPAIRS[code];
+        if (options.meta !== undefined)
+            this.meta = options.meta;
     }
 }
 exports.CliError = CliError;
+function metaRecord(payload) {
+    const meta = payload && typeof payload === 'object' ? payload.meta : undefined;
+    return meta && typeof meta === 'object' && !Array.isArray(meta) ? meta : undefined;
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+/**
+ * Release identity from one response, preferring the JSON envelope and falling
+ * back to the X-Dreamstate-* headers. Success and error envelopes carry it
+ * alike (contract C2), so this runs on both.
+ */
+function readServerReleaseInfo(payload, headers) {
+    const meta = metaRecord(payload);
+    const header = (name) => nonEmptyString(typeof headers?.get === 'function' ? headers.get(name) : null);
+    return {
+        server_version: nonEmptyString(meta?.server_version) ?? header('X-Dreamstate-Server-Version'),
+        minimum_cli_version: nonEmptyString(meta?.minimum_cli_version) ?? header('X-Dreamstate-Minimum-Cli-Version'),
+        release_sha: nonEmptyString(meta?.release_sha) ?? header('X-Dreamstate-Release-Sha'),
+    };
+}
+function describeVersionSkew(info, cliVersion = exports.CLI_VERSION) {
+    if (info.minimum_cli_version && isVersionGreater(info.minimum_cli_version, cliVersion))
+        return 'cli_below_minimum';
+    if (info.server_version && isVersionGreater(info.server_version, cliVersion))
+        return 'cli_behind_server';
+    return info.server_version || info.minimum_cli_version ? 'compatible' : 'unknown';
+}
+function updateRequiredError(minimum, cliVersion, status, details, meta) {
+    return new CliError(`CLI ${minimum} or newer is required (this is ${cliVersion}). Run: ${exports.CLI_UPDATE_COMMAND}`, 'cli_update_required', status, {
+        details: { ...details, minimum_cli_version: minimum, cli_version: cliVersion, update_command: exports.CLI_UPDATE_COMMAND },
+        retryable: false,
+        ...(meta ? { meta } : {}),
+    });
+}
 function isApiErrorBody(value) {
     const error = value && typeof value === 'object' ? value.error : null;
     if (!error || typeof error !== 'object')
@@ -182,6 +233,11 @@ class DreamstateClient {
     workspace;
     requestTimeoutMs;
     onVersionWarning;
+    releaseInfo = { server_version: null, minimum_cli_version: null, release_sha: null };
+    /** Release identity from the most recent response, success or error. */
+    get serverInfo() {
+        return { ...this.releaseInfo };
+    }
     constructor(options) {
         this.apiKey = options.apiKey;
         this.baseUrl = options.baseUrl.replace(/\/+$/, '');
@@ -240,25 +296,26 @@ class DreamstateClient {
     listRuns(query = {}) {
         return this.request(`/runs${queryString(query)}`, {}, exports.TOOL_AND_RUN_REQUEST_TIMEOUT_MS);
     }
-    resumeRun(id, body, idempotencyKey) {
-        const key = idempotencyKey ?? (0, node_crypto_1.randomUUID)();
-        return this.request(`/runs/${encodeURIComponent(id)}/resume`, {
-            method: 'POST',
-            body: JSON.stringify(body),
-            headers: { 'Idempotency-Key': key },
-        }, exports.TOOL_AND_RUN_REQUEST_TIMEOUT_MS);
-    }
     getRunEvents(id, query = {}) {
         return this.request(`/runs/${encodeURIComponent(id)}/events${queryString(query)}`);
     }
     cancelRun(id, body, idempotencyKey) {
-        const key = idempotencyKey ?? (0, node_crypto_1.randomUUID)();
+        // A re-run of the same cancel presents the same key, so a cancel whose reply was
+        // lost replays instead of racing the run's own state version.
+        const key = idempotencyKey ?? (0, idempotency_1.deterministicIdempotencyKey)({ scope: 'runs.cancel', workspace: this.workspace, body: { run_id: id, ...body } });
         return this.request(`/runs/${encodeURIComponent(id)}/cancel`, {
             method: 'POST',
             body: JSON.stringify(body),
-            ...(key ? { headers: { 'Idempotency-Key': key } } : {}),
+            headers: { 'Idempotency-Key': key },
         });
     }
+    noteServerInfo(info) {
+        this.releaseInfo = {
+            server_version: info.server_version ?? this.releaseInfo.server_version,
+            minimum_cli_version: info.minimum_cli_version ?? this.releaseInfo.minimum_cli_version,
+            release_sha: info.release_sha ?? this.releaseInfo.release_sha,
+        };
+    }
     async request(path, init = {}, defaultTimeoutMs = exports.DEFAULT_REQUEST_TIMEOUT_MS, allowIncompatibleCli = false) {
         const requestTimeoutMs = this.requestTimeoutMs ?? defaultTimeoutMs;
         let response;
@@ -283,9 +340,9 @@ class DreamstateClient {
             }
             catch (error) {
                 if (controller.signal.aborted) {
-                    throw new CliError(`Request timed out after ${requestTimeoutMs}ms`, 'request_timeout', 0, { idempotencyKey });
+                    throw new CliError(errors_1.CLI_LOCAL_ERROR_CODES.request_timeout, 'request_timeout', 0, { idempotencyKey, repair: errors_1.CLI_LOCAL_ERROR_REPAIRS.request_timeout });
                 }
-                throw new CliError(`Request failed: ${error instanceof Error ? error.message : String(error)}`, 'network_error', 0);
+                throw new CliError(`Request failed: ${error instanceof Error ? error.message : String(error)}`, 'network_error', 0, { repair: errors_1.CLI_LOCAL_ERROR_REPAIRS.network_error });
             }
             finally {
                 clearTimeout(timeout);
@@ -295,8 +352,12 @@ class DreamstateClient {
                 payload = await response.json();
             }
             catch {
-                throw new CliError(`Dreamstate API returned invalid JSON (HTTP ${response.status})`, 'invalid_response', response.status);
+                this.noteServerInfo(readServerReleaseInfo(undefined, response.headers));
+                throw new CliError(`Dreamstate API returned invalid JSON (HTTP ${response.status})`, 'invalid_response', response.status, { idempotencyKey, repair: errors_1.CLI_LOCAL_ERROR_REPAIRS.invalid_response });
             }
+            const info = readServerReleaseInfo(payload, response.headers);
+            this.noteServerInfo(info);
+            const meta = metaRecord(payload);
             if (isApiErrorBody(payload)) {
                 const retryAfterValue = retryAfter(response, payload);
                 if (!retriedRateLimit &&
@@ -307,8 +368,31 @@ class DreamstateClient {
                     await waitForRetryAfter(retryAfterValue);
                     continue;
                 }
-                throw new CliError(WORKSPACE_ERROR_MESSAGES[payload.error.code] ?? payload.error.message, payload.error.code, response.status, {
-                    details: payload.error.details,
+                if (payload.error.code === 'cli_update_required') {
+                    // The server refused before executing anything (contract C3). Its own
+                    // message is kept; the update command rides beside it.
+                    const minimum = info.minimum_cli_version ?? '';
+                    throw new CliError(payload.error.message, 'cli_update_required', response.status, {
+                        details: {
+                            ...(payload.error.details && typeof payload.error.details === 'object' ? payload.error.details : {}),
+                            ...(minimum ? { minimum_cli_version: minimum } : {}),
+                            cli_version: exports.CLI_VERSION,
+                            update_command: exports.CLI_UPDATE_COMMAND,
+                        },
+                        retryAfter: retryAfterValue,
+                        traceId: readToolEnvelopeTraceId(payload),
+                        idempotencyKey,
+                        retryable: false,
+                        ...(payload.error.repair && typeof payload.error.repair === 'object' ? { repair: payload.error.repair } : {}),
+                        ...(meta ? { meta } : {}),
+                    });
+                }
+                const hint = WORKSPACE_ERROR_HINTS[payload.error.code];
+                const serverDetails = payload.error.details;
+                throw new CliError(payload.error.message, payload.error.code, response.status, {
+                    ...(hint
+                        ? { details: { ...(serverDetails && typeof serverDetails === 'object' && !Array.isArray(serverDetails) ? serverDetails : {}), cli_hint: hint } }
+                        : { details: serverDetails }),
                     retryAfter: retryAfterValue,
                     traceId: readToolEnvelopeTraceId(payload),
                     idempotencyKey,
@@ -318,25 +402,23 @@ class DreamstateClient {
                     ...(payload.error.repair && typeof payload.error.repair === 'object'
                         ? { repair: payload.error.repair }
                         : {}),
+                    ...(meta ? { meta } : {}),
                 });
             }
             if (!response.ok)
-                throw new CliError(`Dreamstate API request failed (HTTP ${response.status})`, 'request_failed', response.status);
-            const minimum = payload && typeof payload === 'object'
-                ? payload.meta?.minimum_cli_version
-                : undefined;
-            if (!allowIncompatibleCli &&
-                typeof minimum === 'string' &&
-                isVersionGreater(minimum, exports.CLI_VERSION)) {
-                throw new CliError(`CLI ${minimum} or newer is required. Run: npm install -g @trydreamstate/cli@latest`, 'cli_update_required', 0);
+                throw new CliError(`Dreamstate API request failed (HTTP ${response.status})`, 'request_failed', response.status, { idempotencyKey, ...(meta ? { meta } : {}) });
+            const minimum = info.minimum_cli_version;
+            if (!allowIncompatibleCli && minimum && isVersionGreater(minimum, exports.CLI_VERSION)) {
+                // A conforming server refuses first (C3), so reaching here means the
+                // request may already have executed. The body is kept in the error so a
+                // write's receipt is not lost behind the update notice.
+                throw updateRequiredError(minimum, exports.CLI_VERSION, 0, init.method && init.method !== 'GET' ? { response: payload } : undefined, meta);
             }
-            const server = payload && typeof payload === 'object'
-                ? payload.meta?.server_version
-                : undefined;
-            if (typeof server === 'string' &&
+            const server = info.server_version;
+            if (server &&
                 isVersionGreater(server, exports.CLI_VERSION) &&
-                (typeof minimum !== 'string' || versionAtMost(minimum, exports.CLI_VERSION))) {
-                this.onVersionWarning?.(`Warning: CLI ${exports.CLI_VERSION} is behind server ${server}. Proceeding; server minimum is ${minimum ?? 'not declared'}.`);
+                (!minimum || versionAtMost(minimum, exports.CLI_VERSION))) {
+                this.onVersionWarning?.(`Warning: CLI ${exports.CLI_VERSION} is behind server ${server}. Proceeding; server minimum is ${minimum ?? 'not declared'}. Update: ${exports.CLI_UPDATE_COMMAND}`);
             }
             return payload;
         }

package/dist/commandTable.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The CLI's own command table, for `dreamstate commands search`.
+ *
+ * `commands search` used to be an alias of `tools search`: it returned capability
+ * records, never a command a person could type. The table here is built from
+ * what the CLI really parses, with no second hand-kept list:
+ *
+ * - every `dreamstate ...` usage line the CLI prints (USAGE in index.ts), and
+ * - every sequences / workflows verb (the verb tables in commands/), with the
+ *   capability each one runs.
+ *
+ * A capability with no verb is reached through `tools run`, which stays a
+ * catalog search (`tools search`); `commands search` reports those separately.
+ */
+export interface CliCommandEntry {
+    /** What to type, with the verb filled in: `dreamstate sequences publish`. */
+    command: string;
+    /** The full usage line or verb signature. */
+    usage: string;
+    summary: string;
+    /** The capability a verb runs, when it runs exactly one. */
+    capability_id?: string;
+}
+export declare function cliCommandTable(usage: string): CliCommandEntry[];
+export declare function searchCliCommands(term: string, usage: string, limit?: number): CliCommandEntry[];
+//# sourceMappingURL=commandTable.d.ts.map

package/dist/commandTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandTable.d.ts","sourceRoot":"","sources":["../src/commandTable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAWhE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,eAAe,EAAE,CAc5F"}

package/dist/commandTable.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliCommandTable = cliCommandTable;
+exports.searchCliCommands = searchCliCommands;
+function verbUsage(pack, spec) {
+    const positionals = (spec.positional ?? []).map(({ name, optional }) => (optional ? `[${name}]` : `<${name}>`)).join(' ');
+    return ['dreamstate', pack, spec.verb, positionals, '[--canonical-field value]'].filter(Boolean).join(' ');
+}
+/** Usage lines of the form `  dreamstate <group> ...` printed by `dreamstate --help`. */
+function usageEntries(usage) {
+    return usage.split('\n')
+        .filter((line) => line.startsWith('  dreamstate '))
+        .map((line) => line.trim())
+        .filter((line) => !/^dreamstate (sequences|workflows) <verb>/.test(line))
+        .map((line) => {
+        const words = line.split(/\s+/);
+        // `dreamstate tools run <capability_id> ...`: the typed command is the leading words
+        // before the first argument placeholder or flag.
+        const stop = words.findIndex((word, index) => index > 0 && /^[<\[-]/.test(word));
+        const command = (stop === -1 ? words : words.slice(0, stop)).join(' ');
+        return { command, usage: line, summary: '' };
+    });
+}
+function cliCommandTable(usage) {
+    // Required lazily: the verb tables import the CLI entry point's helpers.
+    const { SEQUENCE_VERBS } = require('./commands/sequences');
+    const { WORKFLOW_VERBS } = require('./commands/workflows');
+    const verbs = (pack, specs) => specs.map((spec) => ({
+        command: `dreamstate ${pack} ${spec.verb}`,
+        usage: verbUsage(pack, spec),
+        summary: '',
+        capability_id: spec.capabilityId,
+    }));
+    return [...usageEntries(usage), ...verbs('sequences', SEQUENCE_VERBS), ...verbs('workflows', WORKFLOW_VERBS)];
+}
+function terms(value) {
+    return value.toLowerCase().split(/[^a-z0-9_]+/).filter((word) => word.length > 1);
+}
+function searchCliCommands(term, usage, limit = 20) {
+    const wanted = terms(term);
+    if (wanted.length === 0)
+        return [];
+    return cliCommandTable(usage)
+        .map((entry) => {
+        const haystack = new Set(terms(`${entry.command} ${entry.usage} ${entry.summary} ${entry.capability_id ?? ''}`));
+        const commandWords = new Set(terms(entry.command));
+        const score = wanted.reduce((total, word) => total + (commandWords.has(word) ? 3 : haystack.has(word) ? 1 : 0), 0);
+        return { entry, score };
+    })
+        .filter(({ score }) => score > 0)
+        .sort((left, right) => right.score - left.score || left.entry.command.localeCompare(right.entry.command))
+        .slice(0, limit)
+        .map(({ entry }) => entry);
+}

package/dist/commands/sequences.d.ts

@@ -3,5 +3,5 @@ import type { CliCommand } from '../index';
 export declare const SEQUENCE_VERBS: PackVerbSpec[];
 export declare const SEQUENCES_USAGE: string;
 export declare const parseSequencesCommand: (argv: string[]) => CliCommand;
-export declare function runSequencesCommand(client: Parameters<typeof runPackCommand>[0], command: CliCommand, stdout: NodeJS.WritableStream, sleep?: Parameters<typeof runPackCommand>[3]): Promise<void>;
+export declare function runSequencesCommand(context: Parameters<typeof runPackCommand>[0], command: CliCommand, stdout: NodeJS.WritableStream): Promise<void>;
 //# sourceMappingURL=sequences.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../src/commands/sequences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,cAAc,EAAe,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,cAAc,EAAE,YAAY,EA+BxC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAqD,CAAC;AACpF,eAAO,MAAM,qBAAqB,gCAA4E,CAAC;AAC/G,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,EAC5C,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,CAAC,cAAc,EAC7B,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../src/commands/sequences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,cAAc,EAAe,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAO3C,eAAO,MAAM,cAAc,EAAE,YAAY,EA8BxC,CAAC;AAEF,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,qBAAqB,gCAA4E,CAAC;AAC/G,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1J"}

package/dist/commands/sequences.js

@@ -3,44 +3,45 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSequencesCommand = exports.SEQUENCES_USAGE = exports.SEQUENCE_VERBS = void 0;
 exports.runSequencesCommand = runSequencesCommand;
 const shared_1 = require("./shared");
+const automation = [{ name: 'id', into: 'automation_id' }];
+const sequence = [{ name: 'id', into: 'sequence_id' }];
+// Route map only. `tools get` owns every remote parameter, type, requirement and
+// description. Positionals are documented CLI aliases for canonical input fields.
 exports.SEQUENCE_VERBS = [
-    { verb: 'create-from-worksheet', capabilityId: 'sequence.sequences.create_from_worksheet', summary: 'Create draft sequence from worksheet and enroll rows. Never publishes or sends.', flags: { worksheet: { type: 'string', into: 'worksheet_id' }, view: { type: 'string', into: 'view_id' }, name: { type: 'string', into: 'name' }, steps: { type: 'string', into: 'steps', json: true }, description: { type: 'string', into: 'description' }, timezone: { type: 'string', into: 'timezone' }, 'daily-cap': { type: 'string', into: 'daily_cap', number: true }, senders: { type: 'string', into: 'senders', json: true }, 'enrollment-filter': { type: 'string', into: 'enrollment_filter', json: true }, 'max-new-enrollments-per-day': { type: 'string', into: 'max_new_enrollments_per_day', number: true } }, mutating: true },
-    { verb: 'list', capabilityId: 'workflow.automations.list', summary: 'List sequences in workspace.', flags: { limit: { type: 'string', into: 'limit' }, cursor: { type: 'string', into: 'cursor' }, lifecycle: { type: 'string', into: 'lifecycle' }, 'include-archived': { type: 'boolean', into: 'include_archived' }, search: { type: 'string', into: 'search' } }, mutating: false },
-    // Local only: writes a starter document to disk and calls no API, so authoring can
-    // begin from a file. capabilityId names the verb this scaffold is meant to feed.
-    { verb: 'init', capabilityId: 'workflow.automations.lint', summary: 'Write a starter sequence document to a local file. Calls no API and changes nothing.', flags: { name: { type: 'string', into: 'name' }, file: { type: 'string', into: 'file' } }, mutating: false },
-    { verb: 'get', capabilityId: 'workflow.automations.get', summary: 'Get one sequence.', positional: [{ name: 'id', into: 'automation_id' }], mutating: false },
-    { verb: 'create', capabilityId: 'workflow.automations.compose', summary: 'Create draft sequence. Does not publish or send.', flags: { name: { type: 'string', into: 'name' }, description: { type: 'string', into: 'description' }, timezone: { type: 'string', into: 'timezone' }, enrollment: { type: 'string', into: 'enrollment', json: true }, 'daily-cap': { type: 'string', into: 'daily_cap' }, 'max-new-enrollments-per-day': { type: 'string', into: 'max_new_enrollments_per_day' }, senders: { type: 'string', into: 'senders', json: true }, steps: { type: 'string', into: 'steps', json: true }, 'on-duplicate-name': { type: 'string', into: 'on_duplicate_name' } }, mutating: true },
-    { verb: 'update', capabilityId: 'workflow.automations.update', summary: 'Update sequence draft settings. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { patch: { type: 'string', into: 'patch', json: true }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'lint', capabilityId: 'workflow.automations.lint', summary: 'Lint sequence draft. Makes no changes.', positional: [{ name: 'id', into: 'automation_id' }], flags: { document: { type: 'string', into: 'document', json: true, document: true } }, mutating: false },
-    { verb: 'preview', capabilityId: 'workflow.automations.preview', summary: 'Preview saved sequence. Creates no run and sends nothing.', positional: [{ name: 'id', into: 'automation_id' }], mutating: false },
-    { verb: 'variables', capabilityId: 'workflow.automations.variables_list', summary: 'List template variables available in sequence.', positional: [{ name: 'id', into: 'automation_id' }], flags: { document: { type: 'string', into: 'document', json: true, document: true }, node: { type: 'string', into: 'node_id' }, query: { type: 'string', into: 'query' }, limit: { type: 'string', into: 'limit' } }, mutating: false },
-    { verb: 'node-catalog', capabilityId: 'workflow.automations.node_catalog', summary: 'List available sequence node types.', flags: { query: { type: 'string', into: 'query' }, family: { type: 'string', into: 'family' }, 'include-blocked': { type: 'boolean', into: 'include_blocked' } }, mutating: false },
-    { verb: 'node-inspect', capabilityId: 'workflow.automations.node_inspect', summary: 'Inspect sequence node type or saved node.', positional: [{ name: 'id', into: 'automation_id', optional: true }], flags: { node: { type: 'string', into: 'node_id' }, 'node-kind': { type: 'string', into: 'node_kind' }, subtype: { type: 'string', into: 'subtype' }, config: { type: 'string', into: 'config', json: true } }, mutating: false },
-    { verb: 'node-add', capabilityId: 'workflow.automations.node_add', summary: 'Add node to sequence draft. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { node: { type: 'string', into: 'node', json: true }, 'after-node': { type: 'string', into: 'after_node_id' }, branch: { type: 'string', into: 'branch' }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'node-patch', capabilityId: 'workflow.automations.node_patch', summary: 'Patch sequence node. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { node: { type: 'string', into: 'node_id' }, fields: { type: 'string', into: 'fields', json: true }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'node-remove', capabilityId: 'workflow.automations.node_remove', summary: 'Remove node from sequence draft. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { node: { type: 'string', into: 'node_id' }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'node-move', capabilityId: 'workflow.automations.node_move', summary: 'Move sequence node. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { node: { type: 'string', into: 'node_id' }, 'after-node': { type: 'string', into: 'after_node_id' }, branch: { type: 'string', into: 'branch' }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'field-options', capabilityId: 'workflow.automations.field_options', summary: 'List options for sequence node fields.', positional: [{ name: 'id', into: 'automation_id', optional: true }], flags: { node: { type: 'string', into: 'node_id' }, 'node-kind': { type: 'string', into: 'node_kind' }, subtype: { type: 'string', into: 'subtype' }, 'field-key': { type: 'string', into: 'field_key' }, 'field-keys': { type: 'string', into: 'field_keys', json: true }, query: { type: 'string', into: 'query' }, limit: { type: 'string', into: 'limit' }, cursor: { type: 'string', into: 'cursor' }, 'field-context': { type: 'string', into: 'field_context', json: true } }, mutating: false },
-    { verb: 'publish', capabilityId: 'sequence.sequences.publish', summary: 'Publish sequence draft. Does not enroll or send.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { 'sequence-version-id': { type: 'string', into: 'sequence_version_id' }, 'latest-draft-version-id': { type: 'string', into: 'latest_draft_version_id' } }, mutating: true },
-    { verb: 'enroll', capabilityId: 'sequence.sequences.enroll_selection', summary: 'Enroll rows into sequence. Spends no credits and sends nothing; dispatch only happens at launch.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { worksheet: { type: 'string', into: 'worksheet_id' }, view: { type: 'string', into: 'view_id' }, 'enrollment-filter': { type: 'string', into: 'enrollment_filter', json: true }, 'enrollment-priority': { type: 'string', into: 'enrollment_priority', json: true }, 'enrollment-sort': { type: 'string', into: 'enrollment_sort', json: true }, 'max-live-sends': { type: 'string', into: 'max_live_sends' }, 'max-new-enrollments-per-day': { type: 'string', into: 'max_new_enrollments_per_day' } }, mutating: true },
-    { verb: 'enrollments', capabilityId: 'sequence.sequences.contacts_list', summary: 'List people enrolled in sequence.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { limit: { type: 'string', into: 'limit' }, cursor: { type: 'string', into: 'cursor' } }, mutating: false },
-    { verb: 'launch', capabilityId: 'sequence.sequences.launch', summary: 'Launch published sequence dispatch.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { 'max-live-sends': { type: 'string', into: 'max_live_sends' } }, mutating: true },
-    { verb: 'pause', capabilityId: 'sequence.sequences.pause', summary: 'Pause sequence dispatch. Sends no new messages.', positional: [{ name: 'id', into: 'sequence_id' }], mutating: true },
-    { verb: 'resume', capabilityId: 'sequence.sequences.resume', summary: 'Resume sequence dispatch.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { 'max-live-sends': { type: 'string', into: 'max_live_sends' } }, mutating: true },
-    { verb: 'stats', capabilityId: 'sequence.sequences.step_counts_get', summary: 'Get sequence step counts.', positional: [{ name: 'id', into: 'sequence_id' }], mutating: false },
-    { verb: 'analytics', capabilityId: 'sequence.sequences.analytics_get', summary: 'Get sequence analytics.', positional: [{ name: 'id', into: 'sequence_id' }], flags: { 'window-days': { type: 'string', into: 'window_days', number: true } }, mutating: false },
-    { verb: 'duplicate', capabilityId: 'workflow.automations.duplicate', summary: 'Duplicate sequence as draft. Does not publish or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { name: { type: 'string', into: 'name' }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'archive', capabilityId: 'workflow.automations.archive', summary: 'Archive sequence. Does not delete records or send.', positional: [{ name: 'id', into: 'automation_id' }], flags: { reason: { type: 'string', into: 'reason' }, 'expected-version': { type: 'string', into: 'expected_version', number: true } }, mutating: true },
-    { verb: 'export', capabilityId: 'workflow.automations.export', summary: 'Export sequence definition. Makes no changes.', positional: [{ name: 'id', into: 'automation_id' }], mutating: false },
-    { verb: 'import', capabilityId: 'workflow.automations.import', summary: 'Import sequence as draft. Does not publish or send.', flags: { name: { type: 'string', into: 'name' }, document: { type: 'string', into: 'document', json: true, document: true } }, mutating: true },
+    { verb: 'create-from-worksheet', capabilityId: 'sequence.sequences.create_from_worksheet' },
+    { verb: 'list', capabilityId: 'workflow.automations.list' },
+    { verb: 'init', capabilityId: 'workflow.automations.lint', local: 'init' },
+    { verb: 'get', capabilityId: 'workflow.automations.get', positional: automation },
+    { verb: 'create', capabilityId: 'workflow.automations.compose' },
+    { verb: 'update', capabilityId: 'workflow.automations.update', positional: automation },
+    { verb: 'lint', capabilityId: 'workflow.automations.lint', positional: automation },
+    { verb: 'preview', capabilityId: 'workflow.automations.preview', positional: automation },
+    { verb: 'variables', capabilityId: 'workflow.automations.variables_list', positional: automation },
+    { verb: 'node-catalog', capabilityId: 'workflow.automations.node_catalog' },
+    { verb: 'node-inspect', capabilityId: 'workflow.automations.node_inspect', positional: [{ name: 'id', into: 'automation_id', optional: true }] },
+    { verb: 'node-add', capabilityId: 'workflow.automations.node_add', positional: automation },
+    { verb: 'node-patch', capabilityId: 'workflow.automations.node_patch', positional: automation },
+    { verb: 'node-remove', capabilityId: 'workflow.automations.node_remove', positional: automation },
+    { verb: 'node-move', capabilityId: 'workflow.automations.node_move', positional: automation },
+    { verb: 'field-options', capabilityId: 'workflow.automations.field_options', positional: [{ name: 'id', into: 'automation_id', optional: true }] },
+    { verb: 'publish', capabilityId: 'sequence.sequences.publish', positional: sequence },
+    { verb: 'enroll', capabilityId: 'sequence.sequences.enroll_selection', positional: sequence },
+    { verb: 'enrollments', capabilityId: 'sequence.sequences.contacts_list', positional: sequence },
+    { verb: 'launch', capabilityId: 'sequence.sequences.launch', positional: sequence },
+    { verb: 'start', capabilityId: 'sequence.sequences.start', positional: sequence },
+    { verb: 'pause', capabilityId: 'sequence.sequences.pause', positional: sequence },
+    { verb: 'resume', capabilityId: 'sequence.sequences.resume', positional: sequence },
+    { verb: 'stats', capabilityId: 'sequence.sequences.step_counts_get', positional: sequence },
+    { verb: 'analytics', capabilityId: 'sequence.sequences.analytics_get', positional: sequence },
+    { verb: 'duplicate', capabilityId: 'workflow.automations.duplicate', positional: automation },
+    { verb: 'archive', capabilityId: 'workflow.automations.archive', positional: automation },
+    { verb: 'export', capabilityId: 'workflow.automations.export', positional: automation },
+    { verb: 'import', capabilityId: 'workflow.automations.import' },
 ];
 exports.SEQUENCES_USAGE = (0, shared_1.renderPackUsage)('sequences', exports.SEQUENCE_VERBS);
 exports.parseSequencesCommand = (0, shared_1.buildPackParser)('sequences', 'sequence', exports.SEQUENCE_VERBS, exports.SEQUENCES_USAGE);
-async function runSequencesCommand(client, command, stdout, sleep) {
-    if (command.command === 'pack' && command.verb === 'init') {
-        (0, shared_1.runPackInit)('sequence', command, stdout);
-        return;
-    }
-    await (0, shared_1.runPackCommand)(client, command, stdout, sleep);
+async function runSequencesCommand(context, command, stdout) {
+    if (command.command === 'pack' && command.verb === 'init')
+        return (0, shared_1.runPackInit)('sequence', command, stdout);
+    await (0, shared_1.runPackCommand)(context, command, stdout);
 }

package/dist/commands/shared.d.ts

@@ -1,9 +1,8 @@
-import type { DreamstateClient } from '../client';
 import { type CliCommand } from '../index';
+import { type GatedRunContext } from '../gatedRun';
 export interface PackVerbSpec {
     verb: string;
     capabilityId: string;
-    summary: string;
     /**
      * `optional: true` marks a positional the verb can do without. node-inspect and
      * field-options answer two different questions: the contract for a node TYPE, which
@@ -16,29 +15,8 @@ export interface PackVerbSpec {
         into: string;
         optional?: boolean;
     }[];
-    /**
-     * `document: true` marks the ONE flag that carries a whole authored document, so
-     * --file knows where to put a file's contents. Without it --file bound to whichever
-     * json flag happened to be declared first, which on `sequences create` was
-     * `enrollment`: a whole sequence document arrived as the enrollment binding and the
-     * server refused it field by field. Flag order is not a contract, so the document
-     * flag has to say so itself.
-     */
-    /**
-     * `number: true` marks a flag whose capability param is numeric. Every flag arrives
-     * from the shell as a string, so `--expected-version 1` was sent as "1" and refused
-     * with `params.expected_version: expected number; received string`: the optimistic
-     * concurrency check could not be satisfied from the CLI at all.
-     */
-    flags?: Record<string, {
-        type: 'string' | 'boolean';
-        into: string;
-        json?: boolean;
-        document?: boolean;
-        number?: boolean;
-        required?: boolean;
-    }>;
-    mutating: boolean;
+    /** Local-only route; `init` accepts --name and --file without an API schema. */
+    local?: 'init';
 }
 export declare function buildPackParser(pack: 'sequences' | 'workflows', kind: 'sequence' | 'workflow', specs: PackVerbSpec[], usage: string): (argv: string[]) => CliCommand;
 /**
@@ -49,6 +27,6 @@ export declare function buildPackParser(pack: 'sequences' | 'workflows', kind: '
  */
 export declare function packScaffold(kind: 'sequence' | 'workflow', name: string): Record<string, unknown>;
 export declare function runPackInit(kind: 'sequence' | 'workflow', command: CliCommand, stdout: NodeJS.WritableStream): void;
-export declare function runPackCommand(client: DreamstateClient, command: CliCommand, stdout: NodeJS.WritableStream, sleep?: (milliseconds: number) => Promise<void>): Promise<void>;
+export declare function runPackCommand(context: GatedRunContext, command: CliCommand, stdout: NodeJS.WritableStream): Promise<void>;
 export declare function renderPackUsage(pack: string, specs: PackVerbSpec[]): string;
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAKlD,OAAO,EAA6B,KAAK,UAAU,EAAiC,MAAM,UAAU,CAAC;AAOrG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACpD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAClE;;;;;;;OAOG;IACH;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAC,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7I,QAAQ,EAAE,OAAO,CAAC;CACnB;AAsBD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAC,WAAW,EAAE,IAAI,EAAE,UAAU,GAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAC/F,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAU,CAmHhC;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BjG;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,IAAI,CAuBN;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,GAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAiF,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhQ;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAM3E"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,UAAU,EAAiC,MAAM,UAAU,CAAC;AAEtF,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAO7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAClE,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4CD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAC,WAAW,EAAE,IAAI,EAAE,UAAU,GAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAC/F,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAU,CA8EhC;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BjG;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,IAAI,CAuBN;AAYD,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAK3E"}