@trydreamstate/cli 1.3.3 → 1.3.5

package/dist/registryManifest.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupPosture = lookupPosture;
+exports.rememberPosture = rememberPosture;
+exports.noteRegistryHash = noteRegistryHash;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+function manifestPath(home = (0, node_os_1.homedir)()) {
+    return (0, node_path_1.join)(home, '.dreamstate', 'registry-manifest.json');
+}
+function empty() {
+    return { registry_hash: null, postures: {} };
+}
+function readManifest() {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(manifestPath(), 'utf8'));
+        const root = parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
+        if (!root)
+            return empty();
+        const postures = {};
+        const raw = root.postures && typeof root.postures === 'object' && !Array.isArray(root.postures)
+            ? root.postures
+            : {};
+        for (const [id, value] of Object.entries(raw)) {
+            if (!value || typeof value !== 'object' || Array.isArray(value))
+                continue;
+            const posture = value;
+            postures[id] = { inlineRead: posture.inlineRead === true, returnsRunId: posture.returnsRunId === true };
+        }
+        return {
+            registry_hash: typeof root.registry_hash === 'string' && root.registry_hash ? root.registry_hash : null,
+            postures,
+        };
+    }
+    catch {
+        return empty();
+    }
+}
+function writeManifest(manifest) {
+    try {
+        const path = manifestPath();
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+        (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(manifest)}\n`, 'utf8');
+    }
+    catch {
+        // Cache only. A request still runs when the home directory is not writable.
+    }
+}
+function lookupPosture(capabilityId) {
+    return readManifest().postures[capabilityId] ?? null;
+}
+function rememberPosture(capabilityId, posture) {
+    const manifest = readManifest();
+    manifest.postures[capabilityId] = posture;
+    writeManifest(manifest);
+}
+/** Records the hash from a response. A change clears cached postures. */
+function noteRegistryHash(hash) {
+    if (!hash)
+        return;
+    const manifest = readManifest();
+    if (manifest.registry_hash === hash)
+        return;
+    writeManifest({ registry_hash: hash, postures: manifest.registry_hash ? {} : manifest.postures });
+}

package/dist/runContract.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Run-door constants. Frozen names are RUN_MODES, QUOTE_HASH_PATTERN and
+ * IDEMPOTENCY_KEY_MAX_LENGTH. The source is packages/types/src/agentSurface.ts.
+ * The published CLI cannot depend on the unpublished types package, so the
+ * values are generated into src/generated/runContract.generated.ts.
+ */
+import { IDEMPOTENCY_KEY_MAX_LENGTH, QUOTE_HASH_PATTERN, RUN_MODES } from './generated/runContract.generated';
+export { IDEMPOTENCY_KEY_MAX_LENGTH, QUOTE_HASH_PATTERN, RUN_MODES };
+export type RunMode = (typeof RUN_MODES)[number];
+//# sourceMappingURL=runContract.d.ts.map

package/dist/runContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runContract.d.ts","sourceRoot":"","sources":["../src/runContract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,SAAS,EACV,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC;AACrE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/runContract.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUN_MODES = exports.QUOTE_HASH_PATTERN = exports.IDEMPOTENCY_KEY_MAX_LENGTH = void 0;
+/**
+ * Run-door constants. Frozen names are RUN_MODES, QUOTE_HASH_PATTERN and
+ * IDEMPOTENCY_KEY_MAX_LENGTH. The source is packages/types/src/agentSurface.ts.
+ * The published CLI cannot depend on the unpublished types package, so the
+ * values are generated into src/generated/runContract.generated.ts.
+ */
+const runContract_generated_1 = require("./generated/runContract.generated");
+Object.defineProperty(exports, "IDEMPOTENCY_KEY_MAX_LENGTH", { enumerable: true, get: function () { return runContract_generated_1.IDEMPOTENCY_KEY_MAX_LENGTH; } });
+Object.defineProperty(exports, "QUOTE_HASH_PATTERN", { enumerable: true, get: function () { return runContract_generated_1.QUOTE_HASH_PATTERN; } });
+Object.defineProperty(exports, "RUN_MODES", { enumerable: true, get: function () { return runContract_generated_1.RUN_MODES; } });

package/dist/runWait.d.ts

@@ -1,7 +1,6 @@
 import type { DreamstateClient } from './client';
 /** The wait ran out with the run still active; the latest run envelope is printed. */
 export declare const RUN_WAIT_TIMEOUT_EXIT_CODE: number;
-export declare function columnRunReturnsRunId(capabilityId: string): boolean;
 export interface RunWaitResult {
     value: unknown;
     timedOut: boolean;

package/dist/runWait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runWait.d.ts","sourceRoot":"","sources":["../src/runWait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAQjD,sFAAsF;AACtF,eAAO,MAAM,0BAA0B,EAAE,MAAyB,CAAC;AAYnE,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AA+BD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,aAAa,CAAC,CAmBxB"}
+{"version":3,"file":"runWait.d.ts","sourceRoot":"","sources":["../src/runWait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAUjD,sFAAsF;AACtF,eAAO,MAAM,0BAA0B,EAAE,MAAyB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AA+BD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,aAAa,CAAC,CAmBxB"}

package/dist/runWait.js

@@ -1,27 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RUN_WAIT_TIMEOUT_EXIT_CODE = void 0;
-exports.columnRunReturnsRunId = columnRunReturnsRunId;
 exports.waitForRun = waitForRun;
 const errors_1 = require("./errors");
 const TERMINAL_STATUSES = new Set([
     'succeeded', 'completed', 'completed_with_errors', 'failed', 'cancelled', 'canceled', 'partially_completed',
     'timed_out', 'rejected', 'awaiting_approval', 'awaiting_input', 'waiting', 'waiting_approval', 'approval_required',
+    // A rehearsal already finished. Polling it as if it were still running times the command out.
+    'dry_run_rehearsed', 'smoke_test_passed',
 ]);
 /** The wait ran out with the run still active; the latest run envelope is printed. */
 exports.RUN_WAIT_TIMEOUT_EXIT_CODE = errors_1.CLI_EXIT.TIMEOUT;
-const COLUMN_RUN_HAND_OFF = new Set([
-    'tables.columns.run',
-    'tables.columns.run_all',
-    'tables.columns.run_remaining',
-]);
-// timing:async column runs. The tools response is the durable run id. Waiting
-// folds every provider row into the command. Progress and final cells are
-// runs_get and rows.query. Other mutations still wait so the next command can
-// read steps[0].outputs.
-function columnRunReturnsRunId(capabilityId) {
-    return COLUMN_RUN_HAND_OFF.has(capabilityId);
-}
 function runFromEnvelope(value) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
         return null;

package/dist/turnCache.d.ts

@@ -1,8 +1,9 @@
 export declare const TURN_REUSE_MS: number;
-/** The quote a dry run returned, and the exact input it priced. */
+/** The quote a dry run returned, and the exact input it priced. maximum_credits is absent on entries written before the field existed: treat that as unknown, not free. */
 export type CachedQuote = {
     quote_hash: string;
     fingerprint: string;
+    maximum_credits?: number | null;
 };
 type CacheWarning = (error: NodeJS.ErrnoException) => void;
 export declare function turnCachePath(credentialsPath: string): string;
@@ -14,6 +15,7 @@ export declare function reusableTurnToken(path: string, baseUrl: string, apiKey:
 export declare function reusableTurn(path: string, baseUrl: string, apiKey: string, capabilityId: string, fingerprint: string, now?: number, onWarning?: CacheWarning): Promise<{
     token: string;
     quote_hash: string | null;
+    maximum_credits: number | null;
 } | null>;
 export declare function rememberTurnToken(path: string, baseUrl: string, apiKey: string, capabilityId: string, token: string, now?: number, onWarning?: CacheWarning, quote?: CachedQuote): Promise<void>;
 export declare function forgetTurnToken(path: string, baseUrl: string, apiKey: string, capabilityId: string, onWarning?: CacheWarning): Promise<void>;

package/dist/turnCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turnCache.d.ts","sourceRoot":"","sources":["../src/turnCache.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,aAAa,QAAa,CAAC;AAExC,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAGtE,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC;AAE3D,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAE7D;AA2BD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,GAC9G,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,GACnI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAO9D;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,EAC9H,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAC5F,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"turnCache.d.ts","sourceRoot":"","sources":["../src/turnCache.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,aAAa,QAAa,CAAC;AAExC,2KAA2K;AAC3K,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAGvG,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC;AAE3D,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAE7D;AA2BD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,GAC9G,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,GACnI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAW9F;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,SAAS,CAAC,EAAE,YAAY,EAC9H,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAC5F,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/turnCache.js

@@ -62,9 +62,13 @@ async function reusableTurn(path, baseUrl, apiKey, capabilityId, fingerprint, no
     if (!entry || typeof entry.token !== 'string' || now - entry.at >= exports.TURN_REUSE_MS)
         return null;
     const quote = entry.quote && entry.quote.fingerprint === fingerprint && typeof entry.quote.quote_hash === 'string'
-        ? entry.quote.quote_hash
+        ? entry.quote
         : null;
-    return { token: entry.token, quote_hash: quote };
+    return {
+        token: entry.token,
+        quote_hash: quote ? quote.quote_hash : null,
+        maximum_credits: quote && typeof quote.maximum_credits === 'number' ? quote.maximum_credits : null,
+    };
 }
 async function rememberTurnToken(path, baseUrl, apiKey, capabilityId, token, now = Date.now(), onWarning, quote) {
     const entries = await load(path, onWarning);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trydreamstate/cli",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Live command-line client for the Dreamstate v1 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,13 +19,15 @@
     "README.md"
   ],
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node scripts/build-agent-plugin.mjs",
+    "build": "node scripts/generate-pack-verbs.mjs --check && node scripts/generate-run-contract.mjs --check && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node scripts/build-agent-plugin.mjs",
     "test": "node scripts/build-agent-plugin.mjs --check && npm run build && jest --config jest.config.cjs --runInBand",
     "type-check": "tsc --noEmit",
     "pack:check": "npm pack --dry-run",
     "pack:smoke": "npm run build && node scripts/pack-smoke.mjs",
     "prepublishOnly": "npm run build && npm run type-check && npm test",
     "verify:guidance": "node scripts/build-agent-plugin.mjs --check",
+    "verify:pack-verbs": "node scripts/generate-pack-verbs.mjs --check",
+    "verify:run-contract": "node scripts/generate-run-contract.mjs --check",
     "verify:test-collection": "jest --config jest.config.cjs --runInBand --testNamePattern='^(?!)'",
     "plugin:publish": "bash scripts/publish-plugin-repo.sh"
   },