@trydreamstate/cli 1.3.2 → 1.3.4

package/dist/generated/packVerbs.generated.json

@@ -0,0 +1,492 @@
+{
+    "generated_by": "packages/cli/scripts/generate-pack-verbs.mjs from apps/backend/src/services/v1/capabilityRegistry/catalog.snapshot.json; do not edit by hand",
+    "registry_hash": "a92deba405d5474a601c4781448cfead03ca6320d45744c0dcea4a723f9fee23",
+    "verbs": [
+        {
+            "command": "sequences analytics",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.analytics_get"
+        },
+        {
+            "command": "sequences enrollments",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.contacts_list"
+        },
+        {
+            "command": "sequences create-from-worksheet",
+            "capabilityId": "sequence.sequences.create_from_worksheet"
+        },
+        {
+            "command": "sequences enroll",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.enroll_selection"
+        },
+        {
+            "command": "sequences launch",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.launch"
+        },
+        {
+            "command": "sequences pause",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.pause"
+        },
+        {
+            "command": "sequences publish",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.publish"
+        },
+        {
+            "command": "sequences resume",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.resume"
+        },
+        {
+            "command": "sequences start",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.start"
+        },
+        {
+            "command": "sequences stats",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "sequence_id"
+                }
+            ],
+            "capabilityId": "sequence.sequences.step_counts_get"
+        },
+        {
+            "command": "sequences archive",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.archive"
+        },
+        {
+            "command": "workflows archive",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.archive"
+        },
+        {
+            "command": "sequences create",
+            "capabilityId": "workflow.automations.compose"
+        },
+        {
+            "command": "workflows create",
+            "capabilityId": "workflow.automations.compose"
+        },
+        {
+            "command": "sequences duplicate",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.duplicate"
+        },
+        {
+            "command": "workflows duplicate",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.duplicate"
+        },
+        {
+            "command": "sequences export",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.export"
+        },
+        {
+            "command": "workflows export",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.export"
+        },
+        {
+            "command": "sequences field-options",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id",
+                    "optional": true
+                }
+            ],
+            "capabilityId": "workflow.automations.field_options"
+        },
+        {
+            "command": "workflows field-options",
+            "capabilityId": "workflow.automations.field_options"
+        },
+        {
+            "command": "sequences get",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.get"
+        },
+        {
+            "command": "workflows get",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.get"
+        },
+        {
+            "command": "sequences import",
+            "capabilityId": "workflow.automations.import"
+        },
+        {
+            "command": "workflows import",
+            "capabilityId": "workflow.automations.import"
+        },
+        {
+            "command": "sequences init",
+            "local": "init",
+            "capabilityId": "workflow.automations.lint"
+        },
+        {
+            "command": "workflows init",
+            "local": "init",
+            "capabilityId": "workflow.automations.lint"
+        },
+        {
+            "command": "sequences lint",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.lint"
+        },
+        {
+            "command": "workflows lint",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.lint"
+        },
+        {
+            "command": "sequences list",
+            "capabilityId": "workflow.automations.list"
+        },
+        {
+            "command": "workflows list",
+            "capabilityId": "workflow.automations.list"
+        },
+        {
+            "command": "sequences node-add",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_add"
+        },
+        {
+            "command": "workflows node-add",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_add"
+        },
+        {
+            "command": "sequences node-catalog",
+            "capabilityId": "workflow.automations.node_catalog"
+        },
+        {
+            "command": "workflows node-catalog",
+            "capabilityId": "workflow.automations.node_catalog"
+        },
+        {
+            "command": "sequences node-inspect",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id",
+                    "optional": true
+                }
+            ],
+            "capabilityId": "workflow.automations.node_inspect"
+        },
+        {
+            "command": "workflows node-inspect",
+            "capabilityId": "workflow.automations.node_inspect"
+        },
+        {
+            "command": "sequences node-move",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_move"
+        },
+        {
+            "command": "workflows node-move",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_move"
+        },
+        {
+            "command": "sequences node-patch",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_patch"
+        },
+        {
+            "command": "workflows node-patch",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_patch"
+        },
+        {
+            "command": "sequences node-remove",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_remove"
+        },
+        {
+            "command": "workflows node-remove",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.node_remove"
+        },
+        {
+            "command": "sequences preview",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.preview"
+        },
+        {
+            "command": "workflows preview",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.preview"
+        },
+        {
+            "command": "sequences update",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.update"
+        },
+        {
+            "command": "workflows update",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.update"
+        },
+        {
+            "command": "sequences variables",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.variables_list"
+        },
+        {
+            "command": "workflows variables",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "automation_id"
+                }
+            ],
+            "capabilityId": "workflow.automations.variables_list"
+        },
+        {
+            "command": "workflows activate",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.activate"
+        },
+        {
+            "command": "workflows deactivate",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.deactivate"
+        },
+        {
+            "command": "workflows publish",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.draft_publish"
+        },
+        {
+            "command": "workflows draft-save",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.draft_save"
+        },
+        {
+            "command": "workflows enroll",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.enroll_selection"
+        },
+        {
+            "command": "workflows retry",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.run_retry"
+        },
+        {
+            "command": "workflows run",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.run_trace_get"
+        },
+        {
+            "command": "workflows runs",
+            "positional": [
+                {
+                    "name": "id",
+                    "into": "workflow_id"
+                }
+            ],
+            "capabilityId": "workflow.workflows.runs_list"
+        }
+    ]
+}

package/dist/generated/runContract.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const RUN_MODES: readonly ["smoke_test", "dry_run", "live"];
+export declare const QUOTE_HASH_PATTERN: RegExp;
+export declare const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
+//# sourceMappingURL=runContract.generated.d.ts.map

package/dist/generated/runContract.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runContract.generated.d.ts","sourceRoot":"","sources":["../../src/generated/runContract.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,4CAA6C,CAAC;AACpE,eAAO,MAAM,kBAAkB,QAA0B,CAAC;AAC1D,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

package/dist/generated/runContract.generated.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDEMPOTENCY_KEY_MAX_LENGTH = exports.QUOTE_HASH_PATTERN = exports.RUN_MODES = void 0;
+// Generated by packages/cli/scripts/generate-run-contract.mjs from packages/types/src/agentSurface.ts. Do not edit.
+exports.RUN_MODES = ['smoke_test', 'dry_run', 'live'];
+exports.QUOTE_HASH_PATTERN = /^sha256:[a-f0-9]{64}$/;
+exports.IDEMPOTENCY_KEY_MAX_LENGTH = 255;

package/dist/idempotency.d.ts

@@ -0,0 +1,38 @@
+/** A key-sorted JSON string, so two spellings of one input fingerprint alike. */
+export declare function stableJson(value: unknown): string;
+export interface IdempotencyIdentity {
+    /** What the key is for: a capability id, or a control such as runs.cancel. */
+    scope: string;
+    /** Workspace the command acts in; the same body in another workspace is another command. */
+    workspace?: string | null;
+    /** The request body that will be sent (params, mode, max_credits, quote_hash, approved ...). */
+    body: unknown;
+}
+export declare function pendingIdempotencyPath(credentialsPath: string): string;
+/**
+ * Deterministic idempotency key for one logical command.
+ *
+ * A random key per invocation made a re-run after a timeout a brand new
+ * operation: the server could not replay the first attempt, so a write whose
+ * response was lost ran twice. The key is now a digest of the capability, the
+ * canonical request body and the workspace, so running the same command again
+ * presents the same key and the server replays. A key the caller names with
+ * --idempotency-key is used as given and never reaches this function.
+ *
+ * Because the whole body is hashed, a changed input, ceiling, mode, quote or
+ * approval flag is a different command with a different key. That is the same
+ * rule the server applies when it refuses a reused key with a different body
+ * (idempotency_key_reuse), so a deliberate change can never collide with an
+ * earlier attempt.
+ */
+export declare function idempotencyDigest(identity: IdempotencyIdentity): string;
+/**
+ * Request digest, not a durable command key. A terminal attempt removes its
+ * entry; only an interrupted or transient attempt is resumed with this key.
+ */
+export declare function deterministicIdempotencyKey(identity: IdempotencyIdentity): string;
+/** Gets a fresh attempt key, or resumes only a pending attempt for this digest. */
+export declare function pendingIdempotencyKey(path: string, identity: IdempotencyIdentity): Promise<string>;
+/** A success or definitive refusal finishes an attempt; a transient outcome keeps it resumable. */
+export declare function finishIdempotencyAttempt(path: string, identity: IdempotencyIdentity): Promise<void>;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOjD;AASD,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gGAAgG;IAChG,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAavE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAEjF;AAqBD,mFAAmF;AACnF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CASxG;AAED,mGAAmG;AACnG,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzG"}

package/dist/idempotency.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stableJson = stableJson;
+exports.pendingIdempotencyPath = pendingIdempotencyPath;
+exports.idempotencyDigest = idempotencyDigest;
+exports.deterministicIdempotencyKey = deterministicIdempotencyKey;
+exports.pendingIdempotencyKey = pendingIdempotencyKey;
+exports.finishIdempotencyAttempt = finishIdempotencyAttempt;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+/** A key-sorted JSON string, so two spellings of one input fingerprint alike. */
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record).sort().filter((key) => record[key] !== undefined).map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+/**
+ * Keys that say how one HTTP attempt is made, not what the command does. They
+ * change between a command and its re-run (a fresh tool_turn_token from a new
+ * tools get), so they must not decide the idempotency key.
+ */
+const TRANSPORT_ONLY_BODY_KEYS = new Set(['tool_turn_token', 'idempotency_key']);
+function pendingIdempotencyPath(credentialsPath) {
+    return (0, node_path_1.join)((0, node_path_1.dirname)(credentialsPath), 'idempotency-attempts.json');
+}
+/**
+ * Deterministic idempotency key for one logical command.
+ *
+ * A random key per invocation made a re-run after a timeout a brand new
+ * operation: the server could not replay the first attempt, so a write whose
+ * response was lost ran twice. The key is now a digest of the capability, the
+ * canonical request body and the workspace, so running the same command again
+ * presents the same key and the server replays. A key the caller names with
+ * --idempotency-key is used as given and never reaches this function.
+ *
+ * Because the whole body is hashed, a changed input, ceiling, mode, quote or
+ * approval flag is a different command with a different key. That is the same
+ * rule the server applies when it refuses a reused key with a different body
+ * (idempotency_key_reuse), so a deliberate change can never collide with an
+ * earlier attempt.
+ */
+function idempotencyDigest(identity) {
+    const body = identity.body && typeof identity.body === 'object' && !Array.isArray(identity.body)
+        ? Object.fromEntries(Object.entries(identity.body)
+            .filter(([key]) => !TRANSPORT_ONLY_BODY_KEYS.has(key)))
+        : identity.body;
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(stableJson({
+        scope: identity.scope,
+        workspace: identity.workspace ?? null,
+        body,
+    }))
+        .digest('hex')
+        .slice(0, 40);
+}
+/**
+ * Request digest, not a durable command key. A terminal attempt removes its
+ * entry; only an interrupted or transient attempt is resumed with this key.
+ */
+function deterministicIdempotencyKey(identity) {
+    return `dscli-${idempotencyDigest(identity)}`;
+}
+async function loadPending(path) {
+    try {
+        const value = JSON.parse(await (0, promises_1.readFile)(path, 'utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return {};
+        return Object.fromEntries(Object.entries(value)
+            .filter((entry) => typeof entry[1] === 'string' && entry[1].length > 0));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return {};
+        throw error;
+    }
+}
+async function savePending(path, attempts) {
+    await (0, promises_1.mkdir)((0, node_path_1.dirname)(path), { recursive: true, mode: 0o700 });
+    await (0, promises_1.writeFile)(path, JSON.stringify(attempts), { mode: 0o600 });
+}
+/** Gets a fresh attempt key, or resumes only a pending attempt for this digest. */
+async function pendingIdempotencyKey(path, identity) {
+    const attempts = await loadPending(path);
+    const digest = idempotencyDigest(identity);
+    const existing = attempts[digest];
+    if (existing)
+        return existing;
+    const key = `dscli-${(0, node_crypto_1.randomBytes)(20).toString('hex')}`;
+    attempts[digest] = key;
+    await savePending(path, attempts);
+    return key;
+}
+/** A success or definitive refusal finishes an attempt; a transient outcome keeps it resumable. */
+async function finishIdempotencyAttempt(path, identity) {
+    const attempts = await loadPending(path);
+    const digest = idempotencyDigest(identity);
+    if (!(digest in attempts))
+        return;
+    delete attempts[digest];
+    await savePending(path, attempts);
+}