@12ui/design 0.2.74 → 0.2.75

package/dist/codex-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-binary.d.ts","sourceRoot":"","sources":["../src/codex-binary.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,6FAA6F,CAAC;AAEnI,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,MAAM,GAAG,aAAa,CAAC;AAClG,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAWxE,eAAO,MAAM,iBAAiB,GAC5B,MAAK,MAAM,CAAC,UAAwB,EACpC,aAAY,CAAC,IAAI,EAAE,MAAM,KAAK,OAAsB,KACnD,WAAW,GAAG,IAWhB,CAAC;AAEF,eAAO,MAAM,sBAAsB,4IAA4I,CAAC;AAEhL,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,GAC7B,MAAK,MAAM,CAAC,UAAwB,EACpC,aAAY,CAAC,IAAI,EAAE,MAAM,KAAK,OAAsB,KACnD,MAIF,CAAC"}

package/dist/codex-binary.js

@@ -0,0 +1,46 @@
+import { accessSync, constants } from 'node:fs';
+import path from 'node:path';
+/**
+ * Which `codex` executable 12ui runs, in one place: the design workspace's local runner, the readiness probe and
+ * the engine selector of `12ui workspace draw` all resolve it here.
+ *
+ * Order: `TWELVE_UI_CODEX_BIN` (taken as given, so an explicit choice is never second-guessed), then
+ * `CODEX_CLI_PATH` (the desktop app sets it in its shells), then `codex` on `PATH`, then the CLI the ChatGPT
+ * desktop app ships inside its bundle. Nothing else: a machine with none of these has no Codex.
+ */
+/** The Codex CLI inside the ChatGPT desktop app's bundle; the last place looked. */
+export const CHATGPT_APP_CODEX_BINARY = '/Applications/ChatGPT.app/Contents/Resources/codex-cli/CodexCLI.app/Contents/MacOS/codex';
+const isExecutable = (file) => {
+    try {
+        accessSync(file, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+export const locateCodexBinary = (env = process.env, executable = isExecutable) => {
+    const explicit = env.TWELVE_UI_CODEX_BIN?.trim();
+    if (explicit)
+        return { binary: explicit, source: 'TWELVE_UI_CODEX_BIN' };
+    const desktop = env.CODEX_CLI_PATH?.trim();
+    if (desktop && executable(desktop))
+        return { binary: desktop, source: 'CODEX_CLI_PATH' };
+    for (const directory of (env.PATH ?? '').split(path.delimiter)) {
+        if (directory === '')
+            continue;
+        const candidate = path.join(directory, 'codex');
+        if (executable(candidate))
+            return { binary: candidate, source: 'PATH' };
+    }
+    return executable(CHATGPT_APP_CODEX_BINARY) ? { binary: CHATGPT_APP_CODEX_BINARY, source: 'ChatGPT.app' } : null;
+};
+export const NO_CODEX_BINARY_REASON = 'No Codex CLI was found: TWELVE_UI_CODEX_BIN and CODEX_CLI_PATH are not set, codex is not on PATH, and the ChatGPT app is not installed.';
+/** The executable to run; throws when this machine has none, so nothing ever spawns a guessed name. */
+export const resolveCodexBinary = (env = process.env, executable = isExecutable) => {
+    const located = locateCodexBinary(env, executable);
+    if (!located)
+        throw Object.assign(new Error(NO_CODEX_BINARY_REASON), { code: 'CODEX_BINARY_MISSING' });
+    return located.binary;
+};
+//# sourceMappingURL=codex-binary.js.map

package/dist/codex-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-binary.js","sourceRoot":"","sources":["../src/codex-binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,0FAA0F,CAAC;AAKnI,MAAM,YAAY,GAAG,CAAC,IAAY,EAAW,EAAE;IAC7C,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAyB,OAAO,CAAC,GAAG,EACpC,aAAwC,YAAY,EAChC,EAAE;IACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACzE,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACzF,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,IAAI,SAAS,KAAK,EAAE;YAAE,SAAS;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,yIAAyI,CAAC;AAEhL,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAyB,OAAO,CAAC,GAAG,EACpC,aAAwC,YAAY,EAC5C,EAAE;IACV,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACvG,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC,CAAC"}

package/dist/slate-image-executor.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { resolveCodexBinary } from './slate-local-image.js';
+import { resolveCodexBinary } from './codex-binary.js';
 /** One image call may run this long before it is stopped. */
 export const IMAGE_CALL_TIMEOUT_MS = 15 * 60_000;
 const importRuntime = async () => {

package/dist/slate-image-executor.js.map

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

package/dist/slate-local-image.d.ts

@@ -2,17 +2,14 @@ import type { LocalImageState } from './slate-view.js';
 /**
  * Whether Design and Edit can run on this Mac: the local Codex CLI, signed in
  * with ChatGPT, with the image model available. It reads only the readiness
- * probe (`codex --version`, `codex login status`, `codex exec --help` and the
- * model cache), which runs no inference, and is asked at most once a minute
+ * probe (`codex --version`, `codex login status`, `codex exec --help`, the
+ * model cache and `codex features list`), which runs no inference, and is asked at most once a minute
  * per server. The workspace never buys an alternative: when this says not
  * ready, the dialogs show the reason and stay disabled.
  */
 export type SlateImageProbe = () => Promise<LocalImageState>;
 export declare const LOCAL_IMAGE_PROBE_TTL_MS = 60000;
-/** The Codex desktop app ships its own CLI; it is the last place looked. */
-export declare const CODEX_APP_BINARY = "/Applications/Codex.app/Contents/Resources/codex";
-/** `TWELVE_UI_CODEX_BIN`, then `codex` on `PATH`, then the Codex app bundle if it is installed. */
-export declare const resolveCodexBinary: (env?: NodeJS.ProcessEnv, exists?: (file: string) => boolean) => string;
+/** The shared probe, with the binary resolved from `env` (`codex-binary.ts`) and `env.CODEX_HOME` as the home. */
 export declare const codexReadinessProbe: (env?: NodeJS.ProcessEnv) => SlateImageProbe;
 /** The probe's answer, kept for a minute. A not-ready reason is passed through verbatim. */
 export declare const cachedImageProbe: (probe: SlateImageProbe, now: () => Date) => SlateImageProbe;

package/dist/slate-local-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slate-local-image.d.ts","sourceRoot":"","sources":["../src/slate-local-image.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,qDAAqD,CAAC;AAEnF,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,GAC7B,MAAK,MAAM,CAAC,UAAwB,EACpC,SAAQ,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,KAC7C,MAMF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,eAM1E,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,GAAI,OAAO,eAAe,EAAE,KAAK,MAAM,IAAI,KAAG,eAS1E,CAAC"}
+{"version":3,"file":"slate-local-image.d.ts","sourceRoot":"","sources":["../src/slate-local-image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,eAG1E,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,GAAI,OAAO,eAAe,EAAE,KAAK,MAAM,IAAI,KAAG,eAS1E,CAAC"}

package/dist/slate-local-image.js

@@ -1,24 +1,8 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
 import { probeCodexReadiness } from './cli-codex-readiness.js';
 export const LOCAL_IMAGE_PROBE_TTL_MS = 60_000;
-/** The Codex desktop app ships its own CLI; it is the last place looked. */
-export const CODEX_APP_BINARY = '/Applications/Codex.app/Contents/Resources/codex';
-/** `TWELVE_UI_CODEX_BIN`, then `codex` on `PATH`, then the Codex app bundle if it is installed. */
-export const resolveCodexBinary = (env = process.env, exists = existsSync) => {
-    const explicit = env.TWELVE_UI_CODEX_BIN?.trim();
-    if (explicit)
-        return explicit;
-    const onPath = (env.PATH ?? '').split(path.delimiter).some((directory) => directory !== '' && exists(path.join(directory, 'codex')));
-    if (onPath)
-        return 'codex';
-    return exists(CODEX_APP_BINARY) ? CODEX_APP_BINARY : 'codex';
-};
+/** The shared probe, with the binary resolved from `env` (`codex-binary.ts`) and `env.CODEX_HOME` as the home. */
 export const codexReadinessProbe = (env = process.env) => async () => {
-    const result = await probeCodexReadiness({
-        codexBin: resolveCodexBinary(env),
-        ...(env.CODEX_HOME?.trim() ? { codexHome: env.CODEX_HOME.trim() } : {}),
-    });
+    const result = await probeCodexReadiness({ env });
     return { ready: result.ready, reason: result.ready ? null : result.reason };
 };
 /** The probe's answer, kept for a minute. A not-ready reason is passed through verbatim. */

package/dist/slate-local-image.js.map

@@ -1 +1 @@
-{"version":3,"file":"slate-local-image.js","sourceRoot":"","sources":["../src/slate-local-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAc/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,kDAAkD,CAAC;AAEnF,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAyB,OAAO,CAAC,GAAG,EACpC,SAAoC,UAAU,EACtC,EAAE;IACV,MAAM,QAAQ,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrI,IAAI,MAAM;QAAE,OAAO,OAAO,CAAC;IAC3B,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAmB,EAAE,CAAC,KAAK,IAAI,EAAE;IACvG,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC;QACjC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAE,GAAe,EAAmB,EAAE;IAC3F,IAAI,MAA0D,CAAC;IAC/D,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,IAAI,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,wBAAwB,IAAI,EAAE,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;QAChG,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;QAC5B,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"slate-local-image.js","sourceRoot":"","sources":["../src/slate-local-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAc/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,kHAAkH;AAClH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAmB,EAAE,CAAC,KAAK,IAAI,EAAE;IACvG,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAE,GAAe,EAAmB,EAAE;IAC3F,IAAI,MAA0D,CAAC;IAC/D,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,IAAI,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,wBAAwB,IAAI,EAAE,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;QAChG,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;QAC5B,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/workspace-draw-client.d.ts

@@ -0,0 +1,69 @@
+import { type PlanImageName, type SlateDrawPlan } from './workspace-draw-types.js';
+/**
+ * The CLI's side of interface I1: the three `/api/v1/slate/` routes `12ui workspace draw` calls on
+ * design.12ui.com, authenticated by the push token alone. Every route is idempotent, so a `429` (and a retryable
+ * `503`) is retried after the seconds the server gives, up to three times per request.
+ */
+export declare const PUSH_HEADER = "X-12ui-Push";
+export declare const CLI_HEADER = "X-12ui-Cli";
+export declare const MAX_RETRIES = 3;
+/** How long a plan may stay `plan_pending` (its direction call in flight) before the run gives up on it. */
+export declare const PLAN_PENDING_LIMIT_MS = 180000;
+/** The server answered with an error (`{ok:false,error:{code,...}}`, or the flat `{error:"code"}` form). */
+export declare class DrawHttpError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly retryAfterSeconds: number | null;
+    readonly body: unknown;
+    constructor(status: number, code: string, retryAfterSeconds: number | null, body: unknown);
+}
+/**
+ * The server could not be reached (`unreachable`), bytes arrived other than declared (`corrupt`), or its answer was
+ * not what I1 says (`malformed`: a server this CLI is too old to read).
+ */
+export declare class DrawTransportError extends Error {
+    readonly kind: 'unreachable' | 'corrupt' | 'malformed';
+    constructor(kind: 'unreachable' | 'corrupt' | 'malformed', message: string, options?: {
+        cause?: unknown;
+    });
+}
+export type DrawFetch = (url: string, init: RequestInit) => Promise<Response>;
+export type PlanImage = {
+    bytes: Buffer;
+    mimeType: string;
+    sha256: string;
+    referenceId: string | null;
+};
+export type PushOutcome = {
+    state: 'filled' | 'failed';
+    label: string | null;
+    versionId: string | null;
+    replayed: boolean;
+    opState: string | null;
+};
+/** The error code in either error shape the server uses. */
+export declare const errorCodeOf: (body: unknown) => string | null;
+/** Check the plan against I1 before anything is drawn from it; a plan this CLI cannot read is never guessed at. */
+export declare const validatePlan: (value: unknown, opId: string) => SlateDrawPlan;
+export declare const createDrawClient: (args: {
+    origin: string;
+    token: string;
+    opId: string;
+    cliVersion: string;
+    fetch?: DrawFetch;
+    sleep?: (milliseconds: number) => Promise<void>;
+    now?: () => number;
+}) => {
+    /** The frozen plan (2.1), waiting out `plan_pending` while the round's direction call finishes. */
+    plan: () => Promise<SlateDrawPlan>;
+    /** The exact bytes every engine attaches (2.2), checked against the server's sha256. */
+    image: (name: PlanImageName) => Promise<PlanImage>;
+    /** One option's image or failure reason (2.3). */
+    push: (key: string, part: {
+        png: Buffer;
+    } | {
+        reason: string;
+    }) => Promise<PushOutcome>;
+};
+export type DrawClient = ReturnType<typeof createDrawClient>;
+//# sourceMappingURL=workspace-draw-client.d.ts.map

package/dist/workspace-draw-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-draw-client.d.ts","sourceRoot":"","sources":["../src/workspace-draw-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEhG;;;;GAIG;AAEH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,4GAA4G;AAC5G,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAE7C,4GAA4G;AAC5G,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBACX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO;CAO1F;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;gBAC3C,IAAI,EAAE,aAAa,GAAG,SAAS,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1G;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE9E,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAExG,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAOF,4DAA4D;AAC5D,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,MAAM,GAAG,IAKpD,CAAC;AAkBF,mHAAmH;AACnH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,EAAE,MAAM,MAAM,KAAG,aA0B3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;IAmCG,mGAAmG;gBACnF,OAAO,CAAC,aAAa,CAAC;IAYtC,wFAAwF;kBACpE,aAAa,KAAG,OAAO,CAAC,SAAS,CAAC;IActD,kDAAkD;gBAChC,MAAM,QAAQ;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,WAAW,CAAC;CAgB9F,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/workspace-draw-client.js

@@ -0,0 +1,193 @@
+import { createHash } from 'node:crypto';
+import { PLAN_SCHEMA } from './workspace-draw-types.js';
+/**
+ * The CLI's side of interface I1: the three `/api/v1/slate/` routes `12ui workspace draw` calls on
+ * design.12ui.com, authenticated by the push token alone. Every route is idempotent, so a `429` (and a retryable
+ * `503`) is retried after the seconds the server gives, up to three times per request.
+ */
+export const PUSH_HEADER = 'X-12ui-Push';
+export const CLI_HEADER = 'X-12ui-Cli';
+export const MAX_RETRIES = 3;
+/** How long a plan may stay `plan_pending` (its direction call in flight) before the run gives up on it. */
+export const PLAN_PENDING_LIMIT_MS = 180_000;
+/** The server answered with an error (`{ok:false,error:{code,...}}`, or the flat `{error:"code"}` form). */
+export class DrawHttpError extends Error {
+    status;
+    code;
+    retryAfterSeconds;
+    body;
+    constructor(status, code, retryAfterSeconds, body) {
+        super(`design.12ui.com answered ${status} ${code}`);
+        this.status = status;
+        this.code = code;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.body = body;
+    }
+}
+/**
+ * The server could not be reached (`unreachable`), bytes arrived other than declared (`corrupt`), or its answer was
+ * not what I1 says (`malformed`: a server this CLI is too old to read).
+ */
+export class DrawTransportError extends Error {
+    kind;
+    constructor(kind, message, options) {
+        super(message, options);
+        this.kind = kind;
+    }
+}
+const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const stringOrNull = (value) => (typeof value === 'string' ? value : null);
+/** The error code in either error shape the server uses. */
+export const errorCodeOf = (body) => {
+    if (!isRecord(body))
+        return null;
+    if (typeof body.error === 'string')
+        return body.error;
+    if (isRecord(body.error) && typeof body.error.code === 'string')
+        return body.error.code;
+    return null;
+};
+const retryAfterOf = (response, body) => {
+    const fromBody = isRecord(body) ? (body.retryAfterSeconds ?? (isRecord(body.error) ? body.error.retryAfterSeconds : undefined)) : undefined;
+    if (typeof fromBody === 'number' && Number.isFinite(fromBody) && fromBody >= 0)
+        return fromBody;
+    const header = Number(response.headers.get('retry-after'));
+    return Number.isFinite(header) && header >= 0 && response.headers.get('retry-after') !== null ? header : null;
+};
+const readBody = async (response) => {
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+};
+/** Check the plan against I1 before anything is drawn from it; a plan this CLI cannot read is never guessed at. */
+export const validatePlan = (value, opId) => {
+    const fail = (what) => { throw new DrawTransportError('malformed', `The plan for ${opId} is not one this command can read: ${what}.`); };
+    if (!isRecord(value))
+        return fail('not an object');
+    if (value.schema !== PLAN_SCHEMA)
+        return fail(`schema ${JSON.stringify(value.schema)}`);
+    if (value.opId !== opId)
+        return fail('it names another request');
+    if (!Array.isArray(value.options))
+        return fail('no options');
+    for (const field of ['workspace', 'kind', 'mode', 'promptRevision', 'planDigest', 'state']) {
+        if (typeof value[field] !== 'string')
+            fail(`no ${field}`);
+    }
+    const keys = new Set();
+    for (const option of value.options) {
+        if (!isRecord(option))
+            return fail('an option is not an object');
+        const key = option.key;
+        if (typeof key !== 'string' || key === '' || keys.has(key))
+            return fail('an option key is missing or repeated');
+        keys.add(key);
+        if (typeof option.callId !== 'string' || typeof option.prompt !== 'string' || typeof option.promptSha256 !== 'string')
+            fail(`option ${key} has no call id or prompt`);
+        if (sha256(option.prompt) !== option.promptSha256)
+            fail(`option ${key}'s prompt does not match its sha256`);
+        if (!['pending', 'filled', 'failed'].includes(option.state))
+            fail(`option ${key} has state ${JSON.stringify(option.state)}`);
+        const frame = option.frame;
+        if (!isRecord(frame) || !Number.isSafeInteger(frame.width) || !Number.isSafeInteger(frame.height) || frame.width < 1 || frame.height < 1)
+            fail(`option ${key} has no frame`);
+        if (!Array.isArray(option.images))
+            return fail(`option ${key} has no image list`);
+        for (const image of option.images) {
+            if (!isRecord(image) || typeof image.name !== 'string' || !/^(parent|annotated|ref-[1-9]\d*)$/u.test(image.name))
+                fail(`option ${key} names an unknown image`);
+        }
+    }
+    return value;
+};
+export const createDrawClient = (args) => {
+    const fetcher = args.fetch ?? ((url, init) => fetch(url, init));
+    const sleep = args.sleep ?? ((milliseconds) => new Promise((resolve) => { setTimeout(resolve, milliseconds); }));
+    const now = args.now ?? Date.now;
+    const opPath = `${args.origin}/api/v1/slate/ops/${encodeURIComponent(args.opId)}`;
+    /** One request, with the 429/503 retry policy; resolves only on a 2xx. */
+    const request = async (url, init = {}) => {
+        for (let attempt = 0;; attempt += 1) {
+            let response;
+            try {
+                response = await fetcher(url, { ...init, headers: { [PUSH_HEADER]: args.token, [CLI_HEADER]: args.cliVersion, ...init.headers } });
+            }
+            catch (cause) {
+                throw new DrawTransportError('unreachable', `${new URL(url).host} could not be reached`, { cause });
+            }
+            if (response.ok)
+                return response;
+            const body = await readBody(response);
+            const code = errorCodeOf(body) ?? `http_${response.status}`;
+            const retryAfter = retryAfterOf(response, body);
+            const retryable = response.status === 429 || (response.status === 503 && code === 'service_unavailable');
+            if (retryable && attempt < MAX_RETRIES) {
+                await sleep((retryAfter ?? 5) * 1000);
+                continue;
+            }
+            throw new DrawHttpError(response.status, code, retryAfter, body);
+        }
+    };
+    const json = async (response) => {
+        const body = await readBody(response);
+        if (!isRecord(body))
+            throw new DrawTransportError('malformed', `${new URL(response.url || args.origin).pathname} did not answer JSON`);
+        return body;
+    };
+    return {
+        /** The frozen plan (2.1), waiting out `plan_pending` while the round's direction call finishes. */
+        plan: async () => {
+            const started = now();
+            for (;;) {
+                try {
+                    return validatePlan(await json(await request(`${opPath}/plan`)), args.opId);
+                }
+                catch (error) {
+                    if (!(error instanceof DrawHttpError) || error.code !== 'plan_pending' || now() - started >= PLAN_PENDING_LIMIT_MS)
+                        throw error;
+                    await sleep(Math.max(1, error.retryAfterSeconds ?? 2) * 1000);
+                }
+            }
+        },
+        /** The exact bytes every engine attaches (2.2), checked against the server's sha256. */
+        image: async (name) => {
+            const response = await request(`${opPath}/images/${encodeURIComponent(name)}`);
+            const bytes = Buffer.from(await response.arrayBuffer());
+            const declared = response.headers.get('x-12ui-sha256');
+            const actual = sha256(bytes);
+            if (declared !== actual)
+                throw new DrawTransportError('corrupt', `Image ${name} arrived with sha256 ${actual}, not the ${declared ?? 'missing'} the server declared`);
+            return {
+                bytes,
+                mimeType: (response.headers.get('content-type') ?? 'application/octet-stream').split(';')[0].trim(),
+                sha256: actual,
+                referenceId: response.headers.get('x-12ui-reference-id'),
+            };
+        },
+        /** One option's image or failure reason (2.3). */
+        push: async (key, part) => {
+            const form = new FormData();
+            if ('png' in part)
+                form.append('file', new Blob([new Uint8Array(part.png)], { type: 'image/png' }), `${key}.png`);
+            else
+                form.append('reason', part.reason);
+            const url = `${args.origin}/api/v1/slate/push?op=${encodeURIComponent(args.opId)}&option=${encodeURIComponent(key)}`;
+            const body = await json(await request(url, { method: 'POST', body: form }));
+            if (body.state !== 'filled' && body.state !== 'failed')
+                throw new DrawTransportError('malformed', `The push of ${key} answered state ${JSON.stringify(body.state)}`);
+            return {
+                state: body.state,
+                label: stringOrNull(body.label),
+                versionId: stringOrNull(body.versionId),
+                replayed: body.replayed === true,
+                opState: stringOrNull(body.opState),
+            };
+        },
+    };
+};
+//# sourceMappingURL=workspace-draw-client.js.map

package/dist/workspace-draw-client.js.map

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

package/dist/workspace-draw-codex.d.ts

@@ -0,0 +1,49 @@
+import { type SlateImageExecutor } from './slate-image-executor.js';
+import type { DrawOptionCodex, SlatePlanOption } from './workspace-draw-types.js';
+/**
+ * The codex engine for one option (design section 6): one native `codex exec` image call through the repo's own
+ * executor, in its own temp `CODEX_HOME` linked to the agent's `auth.json`, under the call id the plan names. The
+ * executor's call store makes that id durable: a rerun returns a drawn image without a second call, and an id
+ * whose call ended without an image answers the same way again, never re-dispatched.
+ *
+ * After the call this reads the call directory back for the run record: the temp home (and whether it is gone),
+ * the rollouts kept in `native-custody/`, how many image calls the nested driver made, and whether the prompt it
+ * sent was the plan's prompt byte for byte.
+ */
+export type CodexOptionResult = {
+    kind: 'drawn';
+    png: Buffer;
+    reused: boolean;
+    details: DrawOptionCodex;
+}
+/** A model-class failure: pushed to the screen with this fixed sentence. */
+ | {
+    kind: 'failed';
+    failure: string;
+    details: DrawOptionCodex;
+}
+/** An environment-class failure (signed out, binary gone, store locked): not pushed, so a rerun can fix it. */
+ | {
+    kind: 'environment';
+    error: string;
+    details: DrawOptionCodex;
+};
+export type ExecutorFactory = (args: {
+    root: string;
+    env: NodeJS.ProcessEnv;
+}) => SlateImageExecutor;
+/** The executor's call store keeps one folder per call id at `<root>/calls/<sha256(id)>`. */
+export declare const callDirectoryOf: (root: string, callId: string) => string;
+/** What the call directory says about the call, for the record. */
+export declare const readCallDetails: (callDir: string, prompt: string) => Promise<DrawOptionCodex & {
+    receiptState: string | null;
+    timedOut: boolean;
+}>;
+export declare const drawOptionWithCodex: (args: {
+    root: string;
+    env: NodeJS.ProcessEnv;
+    option: SlatePlanOption;
+    images: Buffer[];
+    executorFactory?: ExecutorFactory;
+}) => Promise<CodexOptionResult>;
+//# sourceMappingURL=workspace-draw-codex.d.ts.map

package/dist/workspace-draw-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-draw-codex.d.ts","sourceRoot":"","sources":["../src/workspace-draw-codex.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/F,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;;;;;;;GASG;AAEH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE;AAC3E,4EAA4E;GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE;AAC/D,+GAA+G;GAC7G;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAAK,kBAAkB,CAAC;AAIrG,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAkD,CAAC;AAWlH,mEAAmE;AACnE,eAAO,MAAM,eAAe,GAAU,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,eAAe,GAAG;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAgCnJ,CAAC;AAQF,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,KAAG,OAAO,CAAC,iBAAiB,CAsB5B,CAAC"}

package/dist/workspace-draw-codex.js

@@ -0,0 +1,89 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createNativeImageExecutor } from './slate-image-executor.js';
+import { OPTION_FAILURES } from './workspace-draw-messages.js';
+const sha256 = (value) => createHash('sha256').update(value).digest('hex');
+/** The executor's call store keeps one folder per call id at `<root>/calls/<sha256(id)>`. */
+export const callDirectoryOf = (root, callId) => path.join(root, 'calls', sha256(callId));
+const readJson = async (file) => {
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+};
+/** What the call directory says about the call, for the record. */
+export const readCallDetails = async (callDir, prompt) => {
+    const [state, receipt, completion] = await Promise.all([
+        readJson(path.join(callDir, 'state.json')),
+        readJson(path.join(callDir, 'native-custody', 'receipt.json')),
+        readJson(path.join(callDir, 'completion.json')),
+    ]);
+    const tempHome = typeof state?.metadata?.home === 'string' ? state.metadata.home : '';
+    let rollouts = [];
+    try {
+        rollouts = (await readdir(path.join(callDir, 'native-custody')))
+            .filter((name) => /^rollout-.*\.jsonl$/u.test(name))
+            .sort()
+            .map((name) => path.join(callDir, 'native-custody', name));
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const calls = Array.isArray(receipt?.calls) ? receipt.calls : [];
+    const literals = calls.flatMap((call) => call.prompts ?? [null]);
+    const generations = Array.isArray(receipt?.generations) ? receipt.generations : [];
+    const revised = generations[0]?.revisedPrompt;
+    return {
+        callDir,
+        tempHome,
+        tempHomeRemoved: tempHome !== '' && !existsSync(tempHome),
+        rollouts,
+        imageGenCalls: typeof receipt?.invocationCount === 'number' ? receipt.invocationCount : 0,
+        // Measured, never assumed: true only when exactly one call's literal is the plan prompt byte for byte.
+        promptVerbatim: literals.length === 1 && literals[0] !== null && literals[0] !== undefined ? literals[0] === prompt : null,
+        revisedPrompt: typeof revised === 'string' ? revised : null,
+        receiptState: typeof receipt?.state === 'string' ? receipt.state : null,
+        timedOut: completion?.timedOut === true,
+    };
+};
+const failureSentence = (details) => {
+    if (details.timedOut)
+        return OPTION_FAILURES.timeout;
+    if (details.receiptState === 'protocol-violation-multiple-calls')
+        return OPTION_FAILURES.protocol;
+    return OPTION_FAILURES.noImage;
+};
+export const drawOptionWithCodex = async (args) => {
+    const executor = (args.executorFactory ?? createNativeImageExecutor)({ root: args.root, env: args.env });
+    const callDir = callDirectoryOf(args.root, args.option.callId);
+    const details = async () => {
+        const { receiptState, timedOut, ...record } = await readCallDetails(callDir, args.option.prompt);
+        return { record, receiptState, timedOut };
+    };
+    try {
+        const result = await executor.generate({
+            callId: args.option.callId,
+            prompt: args.option.prompt,
+            images: args.images,
+            expected: args.option.frame,
+        });
+        return { kind: 'drawn', png: result.png, reused: result.reused, details: (await details()).record };
+    }
+    catch (error) {
+        const code = error.code;
+        const read = await details();
+        if (code === 'NEEDS_RECONCILIATION')
+            return { kind: 'failed', failure: failureSentence(read), details: read.record };
+        if (code === 'REQUEST_CHANGED')
+            return { kind: 'failed', failure: OPTION_FAILURES.changed, details: read.record };
+        return { kind: 'environment', error: error instanceof Error ? error.message : String(error), details: read.record };
+    }
+};
+//# sourceMappingURL=workspace-draw-codex.js.map

package/dist/workspace-draw-codex.js.map

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

package/dist/workspace-draw-engine.d.ts

@@ -0,0 +1,39 @@
+import { type CodexReadiness, type CodexReadinessCheck } from './cli-codex-readiness.js';
+import type { DrawEngine, DrawRecordCodex } from './workspace-draw-types.js';
+/**
+ * Whether Codex can draw a request, decided once per op and recorded with its reason (design section 3, step 4):
+ * Codex when the readiness probe passes in the agent's own Codex home. There is no other engine in this release
+ * (decision D2-B: drawing on 12ui needs a 12ui sign-in), so a probe that fails is a reason, never a fallback.
+ */
+export type RequestedEngine = 'auto' | DrawEngine;
+export type EngineChoice = {
+    ok: true;
+    engine: DrawEngine;
+    reason: string;
+    codex: DrawRecordCodex;
+} | {
+    ok: false;
+    reason: string;
+    check: Exclude<CodexReadinessCheck, 'ready'>;
+};
+export type ReadinessProbe = (options: {
+    env: NodeJS.ProcessEnv;
+}) => Promise<CodexReadiness>;
+/** "The same home": the calling agent's `CODEX_HOME`, else `~/.codex`. */
+export declare const codexHomeOf: (env: NodeJS.ProcessEnv) => string;
+/**
+ * `<home>/sessions/**\/rollout-*-<threadId>.jsonl`: the calling agent's own rollout, cheap proof that the drawing
+ * account is the caller's. Null when the thread id is unset or no such file exists.
+ */
+export declare const findSameHomeRollout: (home: string, threadId: string | null) => Promise<string | null>;
+/**
+ * `--engine` is strict: anything but auto or codex is a usage error. `TWELVE_UI_ENGINE` is shared with conversion,
+ * where `api` is a valid choice, so for this verb it counts only when it names auto or codex; any other value
+ * leaves the default, and a conversion setting never stops a workspace request from drawing.
+ */
+export declare const parseRequestedEngine: (flag: string | undefined, env: NodeJS.ProcessEnv) => RequestedEngine | null;
+export declare const chooseEngine: (args: {
+    env: NodeJS.ProcessEnv;
+    probe?: ReadinessProbe;
+}) => Promise<EngineChoice>;
+//# sourceMappingURL=workspace-draw-engine.d.ts.map