@12ui/design 0.2.72 → 0.2.74

package/dist/slate-actions.js

@@ -0,0 +1,108 @@
+import { SlateError } from './slate-errors.js';
+import { VERSION_ID_PATTERN } from './slate-ids.js';
+/**
+ * The actions a click can commit, validated and normalized. The same function
+ * runs at `run`, so the intent digest is over exactly what the runner gets.
+ */
+/** How many options a round can draw, and how many it draws when the click does not say. */
+export const ROUND_OPTION_COUNTS = [1, 2, 4, 8, 12];
+export const DEFAULT_ROUND_OPTION_COUNT = 4;
+export const NOTE_MAX_CHARACTERS = 600;
+export const EDIT_PROMPT_MAX_BYTES = 6_000;
+/**
+ * The stored instruction of an edit that carries marks and no words: what the agent and the drawing model are told the
+ * marks mean. One constant, used only when the trimmed text is empty (the Worker keeps an equal copy, pinned by a test).
+ */
+export const EDIT_MARKS_ONLY_PROMPT = 'Infer the change from the marks: an X or a cross-out means remove that element, a circle or a scribble means adjust it, and any words written there are the instruction.';
+export const STROKE_LIMITS = { strokes: 24, pointsPerStroke: 400, pointsTotal: 3_000 };
+const isRecord = (value) => (!!value && typeof value === 'object' && !Array.isArray(value));
+const invalid = (message) => { throw new SlateError('invalid_input', message); };
+/** Control characters are stripped except tab and newline; the rest is the user's text. */
+export const cleanUserText = (value) => (
+// eslint-disable-next-line no-control-regex
+value.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/gu, '').trim());
+/** Freehand strokes as integer permille points; anything outside the limits is refused, never trimmed. */
+export const normalizeStrokes = (value) => {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value))
+        return invalid('strokes must be a list of strokes');
+    if (value.length > STROKE_LIMITS.strokes)
+        return invalid(`At most ${STROKE_LIMITS.strokes} strokes can be sent.`);
+    let total = 0;
+    return value.map((stroke, strokeIndex) => {
+        if (!Array.isArray(stroke) || stroke.length === 0)
+            return invalid(`stroke ${strokeIndex + 1} must hold at least one point`);
+        if (stroke.length > STROKE_LIMITS.pointsPerStroke)
+            return invalid(`A stroke can hold at most ${STROKE_LIMITS.pointsPerStroke} points.`);
+        total += stroke.length;
+        if (total > STROKE_LIMITS.pointsTotal)
+            return invalid(`Strokes can hold at most ${STROKE_LIMITS.pointsTotal} points in all.`);
+        return stroke.map((point, pointIndex) => {
+            if (!Array.isArray(point) || point.length !== 2)
+                return invalid(`stroke ${strokeIndex + 1} point ${pointIndex + 1} must be [x, y]`);
+            const [x, y] = point;
+            if (typeof x !== 'number' || typeof y !== 'number' || !Number.isFinite(x) || !Number.isFinite(y)) {
+                return invalid(`stroke ${strokeIndex + 1} point ${pointIndex + 1} must be numbers`);
+            }
+            const px = Math.round(x);
+            const py = Math.round(y);
+            if (px < 0 || px > 1000 || py < 0 || py > 1000)
+                return invalid('stroke points are thousandths of the image, 0 to 1000');
+            return [px, py];
+        });
+    });
+};
+/** A missing count is the default; anything but 1, 2, 4, 8 or 12 is refused, never rounded. */
+export const normalizeRoundCount = (value) => {
+    if (value === undefined || value === null)
+        return DEFAULT_ROUND_OPTION_COUNT;
+    const allowed = ROUND_OPTION_COUNTS.find((count) => count === value);
+    if (allowed === undefined)
+        return invalid(`count must be one of ${ROUND_OPTION_COUNTS.join(', ')}`);
+    return allowed;
+};
+export const normalizeAction = (input) => {
+    if (!isRecord(input))
+        return invalid('action must be an object');
+    if (input.kind === 'round') {
+        if (input.mode !== 'new' && input.mode !== 'like')
+            return invalid('mode must be new or like');
+        let note = null;
+        if (input.note !== undefined && input.note !== null) {
+            if (typeof input.note !== 'string')
+                return invalid('note must be text');
+            const cleaned = cleanUserText(input.note).replace(/\s+/gu, ' ');
+            if ([...cleaned].length > NOTE_MAX_CHARACTERS)
+                return invalid(`A steer note can be at most ${NOTE_MAX_CHARACTERS} characters.`);
+            note = cleaned || null;
+        }
+        let fromVersionId = null;
+        if (input.fromVersionId !== undefined && input.fromVersionId !== null) {
+            if (typeof input.fromVersionId !== 'string' || !VERSION_ID_PATTERN.test(input.fromVersionId))
+                return invalid('fromVersionId is not a version id');
+            fromVersionId = input.fromVersionId;
+        }
+        if (input.mode === 'like' && fromVersionId === null)
+            return invalid('More like this needs the version to stay close to (fromVersionId).');
+        if (input.mode === 'new' && fromVersionId !== null)
+            return invalid('New options do not start from a version.');
+        return { kind: 'round', mode: input.mode, note, fromVersionId, count: normalizeRoundCount(input.count) };
+    }
+    if (input.kind === 'edit') {
+        const versionId = input.versionId;
+        if (typeof versionId !== 'string' || !VERSION_ID_PATTERN.test(versionId))
+            return invalid('versionId is not a version id');
+        if (input.prompt !== undefined && input.prompt !== null && typeof input.prompt !== 'string')
+            return invalid('prompt must be text');
+        const strokes = normalizeStrokes(input.strokes);
+        const words = cleanUserText(input.prompt ?? '');
+        if (!words && strokes.length === 0)
+            return invalid('Draw on the image or say what should change.');
+        if (Buffer.byteLength(words) > EDIT_PROMPT_MAX_BYTES)
+            return invalid(`An edit instruction can be at most ${EDIT_PROMPT_MAX_BYTES} bytes.`);
+        return { kind: 'edit', versionId, prompt: words || EDIT_MARKS_ONLY_PROMPT, strokes };
+    }
+    return invalid('action.kind must be round or edit');
+};
+//# sourceMappingURL=slate-actions.js.map

package/dist/slate-actions.js.map

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

package/dist/slate-annotate.d.ts

@@ -0,0 +1,36 @@
+import type { SlateRegion, SlateStroke } from './slate-view-contract.js';
+/**
+ * The annotated copy of an edit's parent: the parent's own pixels with the
+ * user's freehand strokes drawn on it. No image path takes a mask, so this
+ * second image is the only spatial signal an edit can carry. Deterministic:
+ * the same parent and strokes always produce the same bytes, and the stroke
+ * colour is chosen from four candidates by distance from the parent's mean
+ * colour, so the marks stay visible on a dark or a bright design.
+ */
+export declare const STROKE_COLORS: readonly [{
+    readonly name: "magenta";
+    readonly hex: "#ff00ff";
+}, {
+    readonly name: "cyan";
+    readonly hex: "#00e5ff";
+}, {
+    readonly name: "red";
+    readonly hex: "#ff3b30";
+}, {
+    readonly name: "yellow";
+    readonly hex: "#ffee00";
+}];
+export type StrokeColor = typeof STROKE_COLORS[number];
+/** The colour with the largest RGB distance from the parent's mean colour; the first listed wins a tie. */
+export declare const chooseStrokeColor: (mean: readonly [number, number, number]) => StrokeColor;
+/** The strokes' bounding box in permille; null when there are no strokes. */
+export declare const strokesRegion: (strokes: readonly SlateStroke[]) => SlateRegion | null;
+export type AnnotatedImage = {
+    png: Buffer;
+    color: StrokeColor;
+    region: SlateRegion;
+    width: number;
+    height: number;
+};
+export declare const renderAnnotated: (parent: Buffer, strokes: readonly SlateStroke[]) => Promise<AnnotatedImage>;
+//# sourceMappingURL=slate-annotate.d.ts.map

package/dist/slate-annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-annotate.d.ts","sourceRoot":"","sources":["../src/slate-annotate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEzE;;;;;;;GAOG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAKhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAYvD,2GAA2G;AAC3G,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAG,WAI3E,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,WAAW,EAAE,KAAG,WAAW,GAAG,IAa7E,CAAC;AAiBF,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErH,eAAO,MAAM,eAAe,GAAU,QAAQ,MAAM,EAAE,SAAS,SAAS,WAAW,EAAE,KAAG,OAAO,CAAC,cAAc,CAe7G,CAAC"}

package/dist/slate-annotate.js

@@ -0,0 +1,71 @@
+import sharp from 'sharp';
+/**
+ * The annotated copy of an edit's parent: the parent's own pixels with the
+ * user's freehand strokes drawn on it. No image path takes a mask, so this
+ * second image is the only spatial signal an edit can carry. Deterministic:
+ * the same parent and strokes always produce the same bytes, and the stroke
+ * colour is chosen from four candidates by distance from the parent's mean
+ * colour, so the marks stay visible on a dark or a bright design.
+ */
+export const STROKE_COLORS = [
+    { name: 'magenta', hex: '#ff00ff' },
+    { name: 'cyan', hex: '#00e5ff' },
+    { name: 'red', hex: '#ff3b30' },
+    { name: 'yellow', hex: '#ffee00' },
+];
+const rgbOf = (hex) => [
+    Number.parseInt(hex.slice(1, 3), 16),
+    Number.parseInt(hex.slice(3, 5), 16),
+    Number.parseInt(hex.slice(5, 7), 16),
+];
+const distance = (left, right) => (Math.hypot(left[0] - right[0], left[1] - right[1], left[2] - right[2]));
+/** The colour with the largest RGB distance from the parent's mean colour; the first listed wins a tie. */
+export const chooseStrokeColor = (mean) => (STROKE_COLORS.reduce((best, candidate) => (distance(rgbOf(candidate.hex), mean) > distance(rgbOf(best.hex), mean) ? candidate : best)));
+/** The strokes' bounding box in permille; null when there are no strokes. */
+export const strokesRegion = (strokes) => {
+    const points = strokes.flat();
+    if (points.length === 0)
+        return null;
+    const xs = points.map((point) => point[0]);
+    const ys = points.map((point) => point[1]);
+    const left = Math.min(...xs);
+    const top = Math.min(...ys);
+    const width = Math.max(1, Math.max(...xs) - left);
+    const height = Math.max(1, Math.max(...ys) - top);
+    // A dot on the far edge still needs one permille of room inside the image.
+    const x = Math.min(left, 999);
+    const y = Math.min(top, 999);
+    return { x, y, w: Math.min(width, 1000 - x), h: Math.min(height, 1000 - y) };
+};
+const coordinate = (permille, size) => ((permille * size) / 1000).toFixed(2);
+const strokesSvg = (args) => {
+    const line = Math.max(3, 0.008 * Math.min(args.width, args.height));
+    const shapes = args.strokes.map((stroke) => {
+        if (stroke.length === 1) {
+            const [x, y] = stroke[0];
+            return `<circle cx="${coordinate(x, args.width)}" cy="${coordinate(y, args.height)}" r="${(line / 2).toFixed(2)}" fill="${args.color}"/>`;
+        }
+        const points = stroke.map(([x, y]) => `${coordinate(x, args.width)},${coordinate(y, args.height)}`).join(' ');
+        return `<polyline points="${points}" fill="none" stroke="${args.color}" stroke-width="${line.toFixed(2)}" stroke-linecap="round" stroke-linejoin="round"/>`;
+    });
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${args.width}" height="${args.height}" viewBox="0 0 ${args.width} ${args.height}">${shapes.join('')}</svg>`;
+};
+export const renderAnnotated = async (parent, strokes) => {
+    const region = strokesRegion(strokes);
+    if (!region)
+        throw new Error('renderAnnotated needs at least one stroke');
+    const source = sharp(parent, { animated: false, failOn: 'warning' });
+    const { width, height } = await source.metadata();
+    if (!width || !height)
+        throw new Error('The parent image has no readable size.');
+    const stats = await sharp(parent, { animated: false, failOn: 'warning' }).flatten({ background: '#ffffff' }).stats();
+    const mean = [stats.channels[0].mean, stats.channels[1].mean, stats.channels[2].mean];
+    const color = chooseStrokeColor(mean);
+    const svg = Buffer.from(strokesSvg({ width, height, strokes, color: color.hex }));
+    const png = await sharp(parent, { animated: false, failOn: 'warning' })
+        .composite([{ input: svg, top: 0, left: 0 }])
+        .png()
+        .toBuffer();
+    return { png, color, region, width, height };
+};
+//# sourceMappingURL=slate-annotate.js.map

package/dist/slate-annotate.js.map

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

package/dist/slate-approvals.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The approval store: one user-level file OUTSIDE every run directory.
+ *
+ * A click on Design or Edit writes an entry here before any work starts. It is
+ * the "no work without a click" record: `resume` and the runner refuse to act
+ * without an entry whose digest matches the op they were asked to run. The
+ * runner starts `codex exec` with full access to its own scratch folder, so a
+ * planted `workspace.json` must never be able to make it execute. The record
+ * cannot live in `workspace.json` or `ledger.jsonl`, because a run directory is
+ * a place any process can plant a file, and a consent record inside the thing
+ * being adopted is not consent. It holds no money: the workspace costs none.
+ */
+export declare const APPROVALS_SCHEMA = "12ui.slate.approvals/2";
+export type ApprovalEntry = {
+    opId: string;
+    workspaceId: string;
+    rootRealpath: string;
+    kind: 'round' | 'edit';
+    paramsDigest: string;
+    approvedAt: string;
+    settledAt: string | null;
+};
+export declare const slateStateRoot: (env?: NodeJS.ProcessEnv) => string;
+export declare const slateApprovalsFile: (stateRoot: string) => string;
+export declare const slatePicksDirectory: (stateRoot: string, workspaceId: string) => string;
+export declare const slateHandoffsDirectory: (stateRoot: string, workspaceId: string) => string;
+export declare const approvalKey: (workspaceId: string, opId: string) => string;
+export declare const getApproval: (stateRoot: string, workspaceId: string, opId: string) => Promise<ApprovalEntry | undefined>;
+/**
+ * Record a click's consent. Entries are keyed by workspace and op id, so an
+ * adopted or resumed op is never recorded twice.
+ */
+export declare const recordApproval: (args: {
+    stateRoot: string;
+    entry: ApprovalEntry;
+    now: number;
+}) => Promise<{
+    created: boolean;
+}>;
+export declare const settleApproval: (args: {
+    stateRoot: string;
+    workspaceId: string;
+    opId: string;
+    at: string;
+}) => Promise<void>;
+/** The checks `resume` and the runner make before they read any field of `op.params`. */
+export declare const approvalMatches: (args: {
+    entry: ApprovalEntry | undefined;
+    rootRealpath: string;
+    kind: ApprovalEntry["kind"];
+    paramsDigest: string;
+}) => "ok" | "approval_missing" | "approval_mismatch";
+/** A resumed op is being worked on again: its settlement no longer holds. */
+export declare const reopenApproval: (args: {
+    stateRoot: string;
+    workspaceId: string;
+    opId: string;
+}) => Promise<void>;
+/** The keys present in the store, for the view's `resumable` flag, in one read. */
+export declare const listApprovalKeys: (stateRoot: string) => Promise<Set<string>>;
+//# sourceMappingURL=slate-approvals.d.ts.map

package/dist/slate-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-approvals.d.ts","sourceRoot":"","sources":["../src/slate-approvals.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAKzD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAIF,eAAO,MAAM,cAAc,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,MAGrE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,KAAG,MAAyD,CAAC;AAEjH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,MAE5E,CAAC;AACF,eAAO,MAAM,sBAAsB,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,MAE/E,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,MAAM,MAAM,KAAG,MAAkC,CAAC;AAsDnG,eAAO,MAAM,WAAW,GAAU,WAAW,MAAM,EAAE,aAAa,MAAM,EAAE,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAEzH,CAAC;AAqBF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAc9B,CAAC;AAEH,eAAO,MAAM,cAAc,GAAU,MAAM;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,KAAG,OAAO,CAAC,IAAI,CAGd,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,IAAI,GAAG,kBAAkB,GAAG,mBAQ/B,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,cAAc,GAAU,MAAM;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,KAAG,OAAO,CAAC,IAAI,CAGd,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAE7E,CAAC"}

package/dist/slate-approvals.js

@@ -0,0 +1,153 @@
+import { mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { replaceFileAtomically } from './atomic-file-replace.js';
+import { resolveCliInstallLayout } from './cli-persistence.js';
+import { SlateError, SlateStateInvalidError } from './slate-errors.js';
+import { OP_ID_PATTERN, SHA256_PATTERN, WORKSPACE_ID_PATTERN } from './slate-ids.js';
+import { staleWhenProcessGone, withLock } from './slate-lock.js';
+/**
+ * The approval store: one user-level file OUTSIDE every run directory.
+ *
+ * A click on Design or Edit writes an entry here before any work starts. It is
+ * the "no work without a click" record: `resume` and the runner refuse to act
+ * without an entry whose digest matches the op they were asked to run. The
+ * runner starts `codex exec` with full access to its own scratch folder, so a
+ * planted `workspace.json` must never be able to make it execute. The record
+ * cannot live in `workspace.json` or `ledger.jsonl`, because a run directory is
+ * a place any process can plant a file, and a consent record inside the thing
+ * being adopted is not consent. It holds no money: the workspace costs none.
+ */
+export const APPROVALS_SCHEMA = '12ui.slate.approvals/2';
+/** The checkpoint build's store: read once, its priced fields dropped, its redraw entries dropped, and rewritten as /2. */
+const PRE_V3_SCHEMA = '12ui.slate.approvals/1';
+const PRUNE_AFTER_MS = 30 * 24 * 60 * 60 * 1000;
+export const slateStateRoot = (env = process.env) => {
+    const override = env.TWELVE_UI_SLATE_STATE_DIR?.trim();
+    return override ? path.resolve(override) : resolveCliInstallLayout(env).dataRoot;
+};
+export const slateApprovalsFile = (stateRoot) => path.join(stateRoot, 'slate', 'approvals.json');
+const approvalsLockFile = (stateRoot) => path.join(stateRoot, 'slate', 'approvals.lock');
+export const slatePicksDirectory = (stateRoot, workspaceId) => (path.join(stateRoot, 'slate', 'picks', workspaceId));
+export const slateHandoffsDirectory = (stateRoot, workspaceId) => (path.join(stateRoot, 'slate', 'handoffs', workspaceId));
+export const approvalKey = (workspaceId, opId) => `${workspaceId}/${opId}`;
+const parseEntry = (file, key, value) => {
+    const fail = (detail) => { throw new SlateStateInvalidError(file, `entry ${key}: ${detail}`); };
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return fail('expected an object');
+    const r = value;
+    const text = (name, pattern) => {
+        const field = r[name];
+        if (typeof field !== 'string' || field.length > 4096 || (pattern && !pattern.test(field)))
+            fail(`bad ${name}`);
+        return field;
+    };
+    const kind = r.kind;
+    if (kind !== 'round' && kind !== 'edit')
+        fail('bad kind');
+    if (r.settledAt !== null && typeof r.settledAt !== 'string')
+        fail('bad settledAt');
+    return {
+        opId: text('opId', OP_ID_PATTERN),
+        workspaceId: text('workspaceId', WORKSPACE_ID_PATTERN),
+        rootRealpath: text('rootRealpath'),
+        kind: kind,
+        paramsDigest: text('paramsDigest', SHA256_PATTERN),
+        approvedAt: text('approvedAt'),
+        settledAt: r.settledAt,
+    };
+};
+const readStore = async (stateRoot) => {
+    const file = slateApprovalsFile(stateRoot);
+    let raw;
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { schema: APPROVALS_SCHEMA, entries: {} };
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new SlateStateInvalidError(file, 'not valid JSON');
+    }
+    const record = parsed;
+    const earlier = record?.schema === PRE_V3_SCHEMA;
+    if (!record || (record.schema !== APPROVALS_SCHEMA && !earlier) || !record.entries || typeof record.entries !== 'object') {
+        throw new SlateStateInvalidError(file, `expected schema ${APPROVALS_SCHEMA}`);
+    }
+    const entries = {};
+    for (const [key, value] of Object.entries(record.entries)) {
+        // A redraw was a paid op that no longer exists; nothing can resume it.
+        if (earlier && value?.kind === 'redraw')
+            continue;
+        entries[key] = parseEntry(file, key, value);
+    }
+    return { schema: APPROVALS_SCHEMA, entries };
+};
+export const getApproval = async (stateRoot, workspaceId, opId) => ((await readStore(stateRoot)).entries[approvalKey(workspaceId, opId)]);
+const mutateStore = async (stateRoot, run) => {
+    await mkdir(path.join(stateRoot, 'slate'), { recursive: true, mode: 0o700 });
+    return withLock({
+        file: approvalsLockFile(stateRoot),
+        policy: staleWhenProcessGone,
+        busyMessage: 'The approval store is busy; try again in a moment.',
+        run: async () => {
+            const store = await readStore(stateRoot);
+            const result = run(store);
+            await replaceFileAtomically({
+                file: slateApprovalsFile(stateRoot),
+                contents: `${JSON.stringify(store, null, 2)}\n`,
+                mode: 0o600,
+            });
+            return result;
+        },
+    });
+};
+/**
+ * Record a click's consent. Entries are keyed by workspace and op id, so an
+ * adopted or resumed op is never recorded twice.
+ */
+export const recordApproval = async (args) => mutateStore(args.stateRoot, (store) => {
+    const key = approvalKey(args.entry.workspaceId, args.entry.opId);
+    const existing = store.entries[key];
+    if (existing) {
+        if (existing.paramsDigest !== args.entry.paramsDigest) {
+            throw new SlateError('intent_conflict', 'This op id already has a different approved plan.');
+        }
+        return { created: false };
+    }
+    store.entries[key] = args.entry;
+    for (const [entryKey, entry] of Object.entries(store.entries)) {
+        if (entry.settledAt && args.now - Date.parse(entry.settledAt) > PRUNE_AFTER_MS)
+            delete store.entries[entryKey];
+    }
+    return { created: true };
+});
+export const settleApproval = async (args) => mutateStore(args.stateRoot, (store) => {
+    const entry = store.entries[approvalKey(args.workspaceId, args.opId)];
+    if (entry)
+        entry.settledAt = args.at;
+});
+/** The checks `resume` and the runner make before they read any field of `op.params`. */
+export const approvalMatches = (args) => {
+    if (!args.entry)
+        return 'approval_missing';
+    if (args.entry.rootRealpath !== args.rootRealpath
+        || args.entry.kind !== args.kind
+        || args.entry.paramsDigest !== args.paramsDigest)
+        return 'approval_mismatch';
+    return 'ok';
+};
+/** A resumed op is being worked on again: its settlement no longer holds. */
+export const reopenApproval = async (args) => mutateStore(args.stateRoot, (store) => {
+    const entry = store.entries[approvalKey(args.workspaceId, args.opId)];
+    if (entry)
+        entry.settledAt = null;
+});
+/** The keys present in the store, for the view's `resumable` flag, in one read. */
+export const listApprovalKeys = async (stateRoot) => (new Set(Object.keys((await readStore(stateRoot)).entries)));
+//# sourceMappingURL=slate-approvals.js.map

package/dist/slate-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-approvals.js","sourceRoot":"","sources":["../src/slate-approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACzD,2HAA2H;AAC3H,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAchD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAU,EAAE;IAC7E,MAAM,QAAQ,GAAG,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACjH,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACzG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAE,WAAmB,EAAU,EAAE,CAAC,CACrF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CACpD,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAE,WAAmB,EAAU,EAAE,CAAC,CACxF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,IAAY,EAAU,EAAE,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC;AAEnG,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,KAAc,EAAiB,EAAE;IAC9E,MAAM,IAAI,GAAG,CAAC,MAAc,EAAS,EAAE,GAAG,MAAM,IAAI,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnG,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,OAAgB,EAAU,EAAE;QACtD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/G,OAAO,KAAe,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM;QAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACnF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;QACjC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC;QACtD,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,IAAI,EAAE,IAA6B;QACnC,YAAY,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC;QAClD,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,SAA0B;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,EAAE,SAAiB,EAA0B,EAAE;IACpE,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzG,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,MAAwD,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC;IACjD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,gBAAgB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzH,MAAM,IAAI,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,gBAAgB,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,OAAO,GAAkC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,uEAAuE;QACvE,IAAI,OAAO,IAAK,KAAmC,EAAE,IAAI,KAAK,QAAQ;YAAE,SAAS;QACjF,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,SAAiB,EAAE,WAAmB,EAAE,IAAY,EAAsC,EAAE,CAAC,CAC7H,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CACrE,CAAC;AAEF,MAAM,WAAW,GAAG,KAAK,EAAK,SAAiB,EAAE,GAAgC,EAAc,EAAE;IAC/F,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;QAClC,MAAM,EAAE,oBAAoB;QAC5B,WAAW,EAAE,oDAAoD;QACjE,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,qBAAqB,CAAC;gBAC1B,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC;gBACnC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;gBAC/C,IAAI,EAAE,KAAK;aACZ,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAIpC,EAAiC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IACzE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,mDAAmD,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,cAAc;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAKpC,EAAiB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK;QAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAK/B,EAAmD,EAAE;IACpD,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,kBAAkB,CAAC;IAC3C,IACE,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY;WAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;WAC7B,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY;QAChD,OAAO,mBAAmB,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAIpC,EAAiB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK;QAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,SAAiB,EAAwB,EAAE,CAAC,CACjF,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAC3D,CAAC"}

package/dist/slate-browser-decision.d.ts

@@ -0,0 +1,30 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { SlateWorkspaceView } from './slate-view-types.js';
+/**
+ * What a person decided in the browser workspace, as the command that opened it prints it.
+ *
+ * A decision is Select, or a Branch or Convert request that was sent: the three things the workspace records and then
+ * tells the agent about. The server derives it from the tool call that recorded it (the pick or the hand-off tool
+ * returning without an error), never from a message the page says it sent, so a page that lost its message still
+ * reports what is in `workspace.json`. The messages the screen would have sent to an agent ride along in `messages`.
+ */
+export type SlateBrowserDecisionKind = 'select' | 'branch' | 'convert';
+export type SlateBrowserDecision = {
+    decision: SlateBrowserDecisionKind;
+    runDir: string;
+    /** The workspace's selection now (also set when the decision was a hand-off: the pick is not cleared). */
+    pick: SlateWorkspaceView['pick'];
+    /** The Branch or Convert request that was sent, or null for a Select. */
+    handoff: SlateWorkspaceView['handoffs'][number] | null;
+    /** The words the screen would have sent its host, in order. */
+    messages: string[];
+    /** What `design.slate.data` says about this workspace, and the command that continues from the decision. */
+    text: string;
+    /** The workspace as `design.slate.data` returns it. */
+    view: SlateWorkspaceView;
+};
+export type SlateBrowserDecided = Omit<SlateBrowserDecision, 'messages' | 'text'>;
+/** The decision one successful tool call made, or undefined when it made none. */
+export declare const decidedBy: (name: string, result: CallToolResult) => SlateBrowserDecided | undefined;
+export declare const finishDecision: (decided: SlateBrowserDecided, messages: string[]) => Promise<SlateBrowserDecision>;
+//# sourceMappingURL=slate-browser-decision.d.ts.map

package/dist/slate-browser-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-decision.d.ts","sourceRoot":"","sources":["../src/slate-browser-decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;GAOG;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,yEAAyE;IACzE,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvD,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,kBAAkB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAMlF,kFAAkF;AAClF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,QAAQ,cAAc,KAAG,mBAAmB,GAAG,SAStF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,SAAS,mBAAmB,EAAE,UAAU,MAAM,EAAE,KAAG,OAAO,CAAC,oBAAoB,CAIlH,CAAC"}

package/dist/slate-browser-decision.js

@@ -0,0 +1,24 @@
+import { SLATE_HANDOFF_TOOL, SLATE_PICK_TOOL } from './mcp-slate-names.js';
+import { slateFallbackText } from './mcp-slate-command.js';
+const isView = (value) => (!!value && typeof value === 'object' && Array.isArray(value.candidates));
+/** The decision one successful tool call made, or undefined when it made none. */
+export const decidedBy = (name, result) => {
+    if (result.isError)
+        return undefined;
+    const content = result.structuredContent;
+    if (!content || !isView(content.view) || content.view.runDir === null)
+        return undefined;
+    const { view } = content;
+    const base = { runDir: view.runDir, pick: view.pick, view };
+    if (name === SLATE_PICK_TOOL)
+        return { decision: 'select', handoff: null, ...base };
+    if (name === SLATE_HANDOFF_TOOL && content.handoff)
+        return { decision: content.handoff.kind, handoff: content.handoff, ...base };
+    return undefined;
+};
+export const finishDecision = async (decided, messages) => ({
+    ...decided,
+    messages,
+    text: await slateFallbackText(decided.view, { browser: true }),
+});
+//# sourceMappingURL=slate-browser-decision.js.map

package/dist/slate-browser-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-decision.js","sourceRoot":"","sources":["../src/slate-browser-decision.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA+B3D,MAAM,MAAM,GAAG,CAAC,KAAc,EAA+B,EAAE,CAAC,CAC9D,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,KAA4B,CAAC,UAAU,CAAC,CAChG,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,MAAsB,EAAmC,EAAE;IACjG,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,iBAA4G,CAAC;IACpI,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACxF,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7D,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IACpF,IAAI,IAAI,KAAK,kBAAkB,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACjI,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAA4B,EAAE,QAAkB,EAAiC,EAAE,CAAC,CAAC;IACxH,GAAG,OAAO;IACV,QAAQ;IACR,IAAI,EAAE,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;CAC/D,CAAC,CAAC"}

package/dist/slate-browser-host-script.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The host shim of the browser workspace: the half of the MCP Apps bridge the screen expects to find on the other side
+ * of `postMessage`, implemented by the page that frames it.
+ *
+ * It answers `ui/initialize` with a host context (the theme from `prefers-color-scheme`, the display mode), delivers the
+ * workspace as the `ui/notifications/tool-result` the screen waits for (so a reload restores the workspace from disk,
+ * as the MCP host's re-render does), turns `tools/call` into `POST /api/call` and `ui/message` into `POST /api/message`,
+ * and lays the frame out: the whole window in `fullscreen`, its reported height in `inline` (`?mode=inline`). The
+ * session token is the one in this page's own URL; the frame never sees it.
+ *
+ * String.raw so escapes reach the browser unchanged: no backtick and no dollar-brace inside.
+ */
+export declare const SLATE_BROWSER_HOST_SCRIPT: string;
+//# sourceMappingURL=slate-browser-host-script.d.ts.map

package/dist/slate-browser-host-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-host-script.d.ts","sourceRoot":"","sources":["../src/slate-browser-host-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,QA+GrC,CAAC"}