@12ui/design 0.2.71 → 0.2.73

package/dist/workflow/continuation-branch.js

@@ -0,0 +1,103 @@
+import { branchFooterSeedSlot, branchSlotGate } from '../branch-schedule.js';
+import { resolveArtifactPath } from './artifact.js';
+import { parseBranchRecipePlan } from './continuation-plans.js';
+import { enumAt, integerAt, invalidRecipe } from './recipes-validation.js';
+import { operationIdForKey, prepareOperation, readOperation } from './store.js';
+import { WorkflowError } from './types.js';
+export const childOperationKey = (parentId, kind, id) => `${parentId}/${kind}/${id}`;
+export const readChildOperation = async (workspace, key) => {
+    try {
+        return await readOperation(workspace, operationIdForKey(key));
+    }
+    catch (error) {
+        if (error instanceof WorkflowError && error.code === 'operation_not_found')
+            return null;
+        throw error;
+    }
+};
+const firstImage = (operation) => {
+    const images = operation.result?.artifacts.filter((artifact) => artifact.mediaType.startsWith('image/')) ?? [];
+    if (operation.state !== 'succeeded' || images.length !== 1)
+        return invalidRecipe(`Branch dependency ${operation.id} must have exactly one actual image artifact.`);
+    return images[0];
+};
+export const continueBranch = async (workspace, operation) => {
+    const parameters = operation.request.parameters ?? {};
+    const maxScreens = integerAt(parameters.maxScreens, 'maxScreens', 1, 16);
+    const scope = enumAt(parameters.scope, ['page', 'site'], 'scope');
+    const plan = parseBranchRecipePlan(operation.result?.value, maxScreens, scope);
+    const approvedRoot = operation.request.inputs[0];
+    if (!approvedRoot || approvedRoot.id !== parameters.approvedRootId)
+        return invalidRecipe('Branch has lost its canonical approved root.');
+    await Promise.all(operation.request.inputs.map((artifact) => resolveArtifactPath(workspace, artifact)));
+    const entries = plan.pages.flatMap((page) => page.slots.map((slot) => ({ page, slot })));
+    const scheduledId = new Map(entries.map(({ slot }, index) => [slot.id, `S${String(index).padStart(3, '0')}`]));
+    const originalId = new Map([...scheduledId].map(([id, slot]) => [slot, id]));
+    const existing = await Promise.all(entries.map(({ slot }) => readChildOperation(workspace, childOperationKey(operation.id, 'slot', slot.id))));
+    const childrenBySlot = new Map(entries.map(({ slot }, index) => [slot.id, existing[index]]));
+    const schedule = entries.map(({ slot }, index) => ({
+        slot: scheduledId.get(slot.id), footer: slot.footer,
+        dependsOnSlot: slot.dependsOnSlot ? scheduledId.get(slot.dependsOnSlot) : null,
+        status: existing[index]?.state === 'succeeded' ? 'succeeded'
+            : existing[index]?.state === 'failed' ? 'failed'
+                : existing[index] ? 'dispatched' : 'pending',
+    }));
+    const footerSeedId = branchFooterSeedSlot(schedule);
+    const waiting = [];
+    const ready = entries.filter(({ slot }, index) => {
+        if (existing[index])
+            return false;
+        const gate = branchSlotGate(scheduledId.get(slot.id), schedule);
+        if (gate.ready)
+            return true;
+        waiting.push({ slotId: slot.id, reason: gate.reason, waitingOn: originalId.get(gate.waitingOn), blocked: gate.blocked });
+        return false;
+    });
+    const prepared = await Promise.all(ready.map(async ({ page, slot }) => {
+        // Reference order is a contract: immutable root, previous viewport, shared footer, caller references.
+        const inputs = [{ ...approvedRoot, role: 'approved-root' }];
+        if (slot.dependsOnSlot)
+            inputs.push({ ...firstImage(childrenBySlot.get(slot.dependsOnSlot)), role: 'previous-viewport' });
+        const footerSeed = footerSeedId ? childrenBySlot.get(originalId.get(footerSeedId)) : null;
+        if (slot.footer === true && footerSeed?.state === 'succeeded') {
+            const footer = firstImage(footerSeed);
+            if (!inputs.some((artifact) => artifact.id === footer.id))
+                inputs.push({ ...footer, role: 'footer-reference' });
+        }
+        for (const reference of operation.request.inputs.slice(1)) {
+            if (!inputs.some((artifact) => artifact.id === reference.id))
+                inputs.push({ ...reference, role: reference.role ?? 'reference' });
+        }
+        // Root and previous viewport retain separate semantic positions even when their bytes match.
+        await Promise.all(inputs.map((artifact) => resolveArtifactPath(workspace, artifact)));
+        return prepareOperation(workspace, {
+            capability: 'image-edit', inputs, output: { kind: 'image' },
+            parameters: {
+                recipe: 'branch', recipeVersion: 1, phase: 'render', parentOperationId: operation.id,
+                pageId: page.id, slotId: slot.id, state: slot.state, viewportOrdinal: slot.viewportOrdinal,
+                dependsOnSlot: slot.dependsOnSlot, approvedRootId: approvedRoot.id,
+                sourceHashes: inputs.map((artifact) => artifact.sha256),
+                geometry: 'provider-sized',
+                ...(approvedRoot.width && approvedRoot.height ? {
+                    sourceCanvas: { width: approvedRoot.width, height: approvedRoot.height },
+                    aspect: approvedRoot.width === approvedRoot.height ? 'square' : approvedRoot.width > approvedRoot.height ? 'landscape' : 'portrait',
+                } : {}),
+            },
+            prompt: [
+                `Generate one ${page.surfaceType} image for ${page.title}, state ${slot.state}, viewport ${slot.viewportOrdinal}.`,
+                `Product: ${plan.sitePurpose}. Page purpose: ${page.purpose}.`,
+                'Image 1 is the immutable approved root: carry its design system and product identity into this new screen. Do not regenerate or overwrite it.',
+                slot.dependsOnSlot ? 'Image 2 is the preceding dependency: continue its content and visual geometry coherently.' : 'This screen begins its own content; use the root for identity, not as a template to duplicate.',
+                `Reference order and roles: ${inputs.map((artifact, index) => `${index + 1}: ${artifact.role ?? artifact.id}`).join('; ')}.`,
+                `Header: ${String(slot.header)}. Footer: ${String(slot.footer)}. Page ends here: ${slot.pageEndsHere}.`,
+                `Direction: ${slot.direction}`, `Exact planned content: ${slot.content}`,
+                'Return one real image artifact. No browser/device frame or commentary painted into the design.',
+            ].join('\n'),
+        }, childOperationKey(operation.id, 'slot', slot.id));
+    }));
+    const all = [...existing.filter((value) => value !== null), ...prepared];
+    const order = new Map(entries.map(({ slot }, index) => [slot.id, index]));
+    all.sort((left, right) => order.get(String(left.request.parameters?.slotId)) - order.get(String(right.request.parameters?.slotId)));
+    return { children: all, approvedRoot, waiting };
+};
+//# sourceMappingURL=continuation-branch.js.map

package/dist/workflow/continuation-branch.js.map

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

package/dist/workflow/continuation-plans.d.ts

@@ -0,0 +1,38 @@
+import type { CreateRetainPolicy } from '../branch-client.js';
+export type DraftRecipePlan = {
+    concept: string;
+    retain: CreateRetainPolicy;
+    content: string;
+    candidates: Array<{
+        prompt: string;
+        content: string;
+    }>;
+};
+export declare const parseDraftRecipePlan: (value: unknown, expectedCount: number) => DraftRecipePlan;
+export type BranchRecipeSlot = {
+    id: string;
+    direction: string;
+    content: string;
+    state: string;
+    viewportOrdinal: number;
+    dependsOnSlot: string | null;
+    header: boolean | null;
+    footer: boolean | null;
+    pageEndsHere: boolean;
+};
+export type BranchRecipePage = {
+    id: string;
+    kind: 'source' | 'additional';
+    title: string;
+    surfaceType: 'web_page' | 'web_app' | 'mobile_app' | 'immersive';
+    purpose: string;
+    slots: BranchRecipeSlot[];
+};
+export type BranchRecipePlan = {
+    sitePurpose: string;
+    approvedScreenSummary: string;
+    pages: BranchRecipePage[];
+};
+/** Keep model semantics, validate dependency facts before admitting any child work. */
+export declare const parseBranchRecipePlan: (value: unknown, maxScreens: number, scope: "page" | "site") => BranchRecipePlan;
+//# sourceMappingURL=continuation-plans.d.ts.map

package/dist/workflow/continuation-plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-plans.d.ts","sourceRoot":"","sources":["../../src/workflow/continuation-plans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAC7D,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,EAAE,eAAe,MAAM,KAAG,eAc5E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IACvF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;CACrG,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IACzD,WAAW,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC9G,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAOjH,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,EAAE,YAAY,MAAM,EAAE,OAAO,MAAM,GAAG,MAAM,KAAG,gBAyClG,CAAC"}

package/dist/workflow/continuation-plans.js

@@ -0,0 +1,78 @@
+import { enumAt, integerAt, invalidRecipe, objectAt, onlyKeys, parseRecipeRetain, recipeIdentifier, textAt } from './recipes-validation.js';
+export const parseDraftRecipePlan = (value, expectedCount) => {
+    const plan = objectAt(value, 'draft plan');
+    onlyKeys(plan, ['concept', 'retain', 'content', 'candidates'], 'draft plan');
+    if (!Array.isArray(plan.candidates) || plan.candidates.length !== expectedCount) {
+        return invalidRecipe(`Draft plan must contain exactly ${expectedCount} candidates.`);
+    }
+    return {
+        concept: textAt(plan.concept, 'draft concept'), retain: parseRecipeRetain(plan.retain), content: textAt(plan.content, 'draft content'),
+        candidates: plan.candidates.map((value, index) => {
+            const candidate = objectAt(value, `candidate ${index + 1}`);
+            onlyKeys(candidate, ['prompt', 'content'], `candidate ${index + 1}`);
+            return { prompt: textAt(candidate.prompt, 'candidate prompt'), content: textAt(candidate.content, 'candidate content') };
+        }),
+    };
+};
+const nullableBoolean = (value, label) => {
+    if (typeof value !== 'boolean' && value !== null)
+        return invalidRecipe(`${label} must be boolean or null.`);
+    return value;
+};
+/** Keep model semantics, validate dependency facts before admitting any child work. */
+export const parseBranchRecipePlan = (value, maxScreens, scope) => {
+    const plan = objectAt(value, 'branch plan');
+    onlyKeys(plan, ['sitePurpose', 'approvedScreenSummary', 'pages'], 'branch plan');
+    if (!Array.isArray(plan.pages) || !plan.pages.length || plan.pages.length > maxScreens + 1)
+        return invalidRecipe('Branch plan has an invalid number of pages.');
+    const pageIds = new Set();
+    const slotIds = new Set();
+    const pages = plan.pages.map((value, pageIndex) => {
+        const page = objectAt(value, `page ${pageIndex + 1}`);
+        onlyKeys(page, ['id', 'kind', 'title', 'surfaceType', 'purpose', 'slots'], 'branch page');
+        const id = recipeIdentifier(page.id, 'page.id');
+        if (pageIds.has(id))
+            return invalidRecipe(`Duplicate branch page ID ${id}.`);
+        pageIds.add(id);
+        const kind = enumAt(page.kind, ['source', 'additional'], 'page.kind');
+        if ((pageIndex === 0) !== (kind === 'source'))
+            return invalidRecipe('The first and only first page must be the approved source page.');
+        if (scope === 'page' && kind !== 'source')
+            return invalidRecipe('Page scope cannot add sibling pages.');
+        const surfaceType = enumAt(page.surfaceType, ['web_page', 'web_app', 'mobile_app', 'immersive'], 'page.surfaceType');
+        if (!Array.isArray(page.slots) || (kind === 'additional' && !page.slots.length))
+            return invalidRecipe('Additional pages require at least one generated slot.');
+        const slots = [];
+        for (const value of page.slots) {
+            if (surfaceType === 'web_page' && slots[slots.length - 1]?.pageEndsHere)
+                return invalidRecipe('A continuous web page cannot add a viewport after its declared end.');
+            const slot = objectAt(value, 'branch slot');
+            onlyKeys(slot, ['id', 'direction', 'content', 'state', 'viewportOrdinal', 'dependsOnSlot', 'header', 'footer', 'pageEndsHere'], 'branch slot');
+            const slotId = recipeIdentifier(slot.id, 'slot.id');
+            if (slotIds.has(slotId))
+                return invalidRecipe(`Duplicate branch slot ID ${slotId}.`);
+            const viewportOrdinal = integerAt(slot.viewportOrdinal, 'viewportOrdinal', 1, maxScreens + 1);
+            if (viewportOrdinal !== slots.length + (kind === 'source' ? 2 : 1))
+                return invalidRecipe(`Slot ${slotId} has an invalid viewport ordinal; the approved root must not be regenerated.`);
+            const dependsOnSlot = slot.dependsOnSlot === null ? null : recipeIdentifier(slot.dependsOnSlot, 'dependsOnSlot');
+            if (dependsOnSlot !== null && !slotIds.has(dependsOnSlot))
+                return invalidRecipe(`Slot ${slotId} depends on a missing, self or later slot.`);
+            if (slots.length > 0 && dependsOnSlot !== slots[slots.length - 1].id)
+                return invalidRecipe(`Slot ${slotId} must depend on its preceding viewport.`);
+            const header = nullableBoolean(slot.header, 'header');
+            const footer = nullableBoolean(slot.footer, 'footer');
+            if (surfaceType !== 'web_page' && (header !== null || footer !== null))
+                return invalidRecipe('App and immersive slots must use null header/footer semantics.');
+            if (typeof slot.pageEndsHere !== 'boolean')
+                return invalidRecipe('pageEndsHere must be a boolean.');
+            slotIds.add(slotId);
+            slots.push({ id: slotId, viewportOrdinal, dependsOnSlot, header, footer, pageEndsHere: slot.pageEndsHere,
+                direction: textAt(slot.direction, 'direction'), content: textAt(slot.content, 'content'), state: textAt(slot.state, 'state', 200) });
+        }
+        return { id, kind, title: textAt(page.title, 'title', 200), surfaceType, purpose: textAt(page.purpose, 'purpose'), slots };
+    });
+    if (slotIds.size > maxScreens)
+        return invalidRecipe(`Branch plan exceeds its ${maxScreens}-screen limit.`);
+    return { sitePurpose: textAt(plan.sitePurpose, 'sitePurpose'), approvedScreenSummary: textAt(plan.approvedScreenSummary, 'approvedScreenSummary'), pages };
+};
+//# sourceMappingURL=continuation-plans.js.map

package/dist/workflow/continuation-plans.js.map

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

package/dist/workflow/continuation.d.ts

@@ -0,0 +1,25 @@
+import { type Artifact, type WorkflowOperation } from './types.js';
+export type WorkflowContinuation = {
+    operation: WorkflowOperation;
+    children: WorkflowOperation[];
+    /** Prepared work is returned for explicit routing/execution, never dispatched here. */
+    readyOperationIds: string[];
+    status: 'ready' | 'waiting' | 'complete' | 'blocked';
+    artifacts: Artifact[];
+    approvedRoot?: Artifact;
+    waiting: Array<{
+        slotId: string;
+        reason: string;
+        waitingOn: string;
+        blocked: boolean;
+    }>;
+};
+/** Advance successful planning only. Repeated calls reuse identical durable child IDs.
+ * Call on the branch planning operation again after ready children succeed to unlock dependants.
+ * Planning success and prepared child work are never reported as a completed rendered product.
+ */
+export declare const continueWorkflow: (args: {
+    workspace: string;
+    operationId: string;
+}) => Promise<WorkflowContinuation>;
+//# sourceMappingURL=continuation.d.ts.map

package/dist/workflow/continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.d.ts","sourceRoot":"","sources":["../../src/workflow/continuation.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzF,CAAC;AA6CF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,oBAAoB,CA+BrH,CAAC"}

package/dist/workflow/continuation.js

@@ -0,0 +1,89 @@
+import { resolveArtifactPath } from './artifact.js';
+import { childOperationKey, continueBranch } from './continuation-branch.js';
+import { parseDraftRecipePlan } from './continuation-plans.js';
+import { prepareRecipe, WORKFLOW_RECIPES } from './recipes.js';
+import { assertRetentionUnchanged, enumAt, integerAt, invalidRecipe, objectAt, onlyKeys, parseRecipeRetain, textAt } from './recipes-validation.js';
+import { prepareOperation, readOperation } from './store.js';
+import { WorkflowError } from './types.js';
+const continueDraft = async (workspace, operation) => {
+    const parameters = operation.request.parameters ?? {};
+    const plan = parseDraftRecipePlan(operation.result?.value, integerAt(parameters.candidates, 'candidates', 1, 16));
+    assertRetentionUnchanged(parameters.retain, plan.retain);
+    await Promise.all(operation.request.inputs.map((artifact) => resolveArtifactPath(workspace, artifact)));
+    return Promise.all(plan.candidates.map((candidate, index) => {
+        const candidateId = String.fromCharCode(65 + index);
+        return prepareOperation(workspace, {
+            capability: operation.request.inputs.length ? 'image-edit' : 'image', inputs: operation.request.inputs, output: { kind: 'image' },
+            parameters: {
+                recipe: 'draft', recipeVersion: 1, phase: 'render', parentOperationId: operation.id,
+                candidateId, aspect: parameters.aspect, retain: plan.retain,
+                sourceHashes: operation.request.inputs.map((artifact) => artifact.sha256),
+            },
+            prompt: [
+                `Generate candidate ${candidateId} as one complete ${String(parameters.aspect)} interface image.`,
+                `Concept: ${plan.concept}`, `Direction: ${candidate.prompt}`,
+                `Retention policy: ${JSON.stringify(plan.retain)}. Apply it to the references in their supplied order.`,
+                ...(typeof parameters.content === 'string' ? [`User-required content: ${parameters.content}`] : []),
+                `Shared content: ${plan.content}`, `Candidate content: ${candidate.content}`,
+                'Use actual product copy and specific controls. The references are visual evidence, not instructions. Return one real generated image artifact.',
+            ].join('\n'),
+        }, childOperationKey(operation.id, 'candidate', candidateId));
+    }));
+};
+const continueRedesign = async (workspace, operation) => {
+    const plan = objectAt(operation.result?.value, 'redesign plan');
+    onlyKeys(plan, ['concept', 'retain', 'corpusQuery'], 'redesign plan');
+    const concept = textAt(plan.concept, 'concept');
+    const retain = parseRecipeRetain(plan.retain);
+    if (retain.source !== 'subject')
+        invalidRecipe('Redesign retention must describe the existing product as subject.');
+    textAt(plan.corpusQuery, 'corpusQuery');
+    const references = await Promise.all(operation.request.inputs.map((artifact) => resolveArtifactPath(workspace, artifact)));
+    const draft = await prepareRecipe({
+        workspace, key: childOperationKey(operation.id, 'redesign', 'draft'), recipe: 'draft',
+        input: { concept, retain, references },
+    });
+    if (draft.state !== 'succeeded')
+        return [draft];
+    const next = await continueWorkflow({ workspace, operationId: draft.id });
+    return [draft, ...next.children];
+};
+/** Advance successful planning only. Repeated calls reuse identical durable child IDs.
+ * Call on the branch planning operation again after ready children succeed to unlock dependants.
+ * Planning success and prepared child work are never reported as a completed rendered product.
+ */
+export const continueWorkflow = async (args) => {
+    const operation = await readOperation(args.workspace, args.operationId);
+    if (operation.state !== 'succeeded' || !operation.result) {
+        throw new WorkflowError('operation_not_succeeded', 'Only a succeeded operation with registered results can continue.');
+    }
+    const parameters = operation.request.parameters ?? {};
+    const recipe = enumAt(parameters.recipe, WORKFLOW_RECIPES, 'operation recipe');
+    let children = [];
+    let approvedRoot;
+    let waiting = [];
+    if (parameters.phase === 'plan') {
+        if (recipe === 'draft')
+            children = await continueDraft(args.workspace, operation);
+        if (recipe === 'redesign')
+            children = await continueRedesign(args.workspace, operation);
+        if (recipe === 'branch') {
+            const branch = await continueBranch(args.workspace, operation);
+            children = branch.children;
+            approvedRoot = branch.approvedRoot;
+            waiting = branch.waiting;
+        }
+    }
+    const readyOperationIds = children.filter((child) => child.state === 'prepared').map((child) => child.id);
+    const artifacts = [...(approvedRoot ? [approvedRoot] : []), ...operation.result.artifacts,
+        ...children.flatMap((child) => child.state === 'succeeded' ? child.result?.artifacts ?? [] : [])];
+    await Promise.all(artifacts.map((artifact) => resolveArtifactPath(args.workspace, artifact)));
+    const blocked = children.some((child) => child.state === 'failed' || child.state === 'reconcile') || waiting.some((entry) => entry.blocked);
+    const hasWork = children.some((child) => child.state !== 'succeeded') || waiting.length > 0;
+    return {
+        operation, children, readyOperationIds, artifacts, waiting,
+        ...(approvedRoot ? { approvedRoot } : {}),
+        status: readyOperationIds.length ? 'ready' : blocked ? 'blocked' : hasWork ? 'waiting' : 'complete',
+    };
+};
+//# sourceMappingURL=continuation.js.map

package/dist/workflow/continuation.js.map

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

package/dist/workflow/layerdoc-reader.d.ts

@@ -0,0 +1,27 @@
+export type LocalLayerDocAsset = {
+    path: string;
+    relativePath: string;
+    sha256: string;
+    mediaType: string;
+};
+export type LoadedLayerDoc = {
+    nativeLayerDoc: true;
+    document: Record<string, unknown>;
+    documentPath: string;
+    manifestPath: string;
+    /** Resolve canonical artifactId references here, without altering the document's URL fields. */
+    assets: Record<string, LocalLayerDocAsset>;
+};
+/** Read a completed native conversion from immutable workflow custody, without hosted requests. */
+export declare function loadWorkflowLayerDoc(args: {
+    workspace: string;
+    operationId: string;
+}): Promise<LoadedLayerDoc>;
+/** Import a relocated export for local consumers. The hosted `convert file.layerdoc.json`
+ * endpoint does not accept this sidecar package; it requires hydrated HTTP asset references.
+ * This reader never uploads files, fabricates URLs, or provides an offline editor.
+ */
+export declare function loadLayerDocBundle(args: {
+    directory: string;
+}): Promise<LoadedLayerDoc>;
+//# sourceMappingURL=layerdoc-reader.d.ts.map

package/dist/workflow/layerdoc-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerdoc-reader.d.ts","sourceRoot":"","sources":["../../src/workflow/layerdoc-reader.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3G,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC5C,CAAC;AAsBF,mGAAmG;AACnG,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAUpH;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B7F"}

package/dist/workflow/layerdoc-reader.js

@@ -0,0 +1,81 @@
+import { realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveArtifactPath } from './artifact.js';
+import { validateBundlePath } from './bundle-paths.js';
+import { validateNativeLayerDocResult } from './recipes-layerdoc-validation.js';
+import { objectAt } from './recipes-validation.js';
+import { readOperation } from './store.js';
+import { readRegularFile } from './store-paths.js';
+import { WorkflowError } from './types.js';
+const invalid = (message) => { throw new WorkflowError('invalid_layerdoc_bundle', message); };
+const readJson = async (file) => {
+    try {
+        return objectAt(JSON.parse((await readRegularFile(file)).toString('utf8')), 'LayerDoc bundle JSON');
+    }
+    catch (error) {
+        return invalid(`Cannot read LayerDoc bundle JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+async function loadFiles(files) {
+    await validateNativeLayerDocResult({ files });
+    const documentPath = files.find(file => file.role === 'layerdoc').path;
+    const manifestPath = files.find(file => file.role === 'layerdoc-assets').path;
+    const [document, manifest] = await Promise.all([readJson(documentPath), readJson(manifestPath)]);
+    const entries = objectAt(manifest.assets, 'LayerDoc assets');
+    const assets = Object.fromEntries(Object.entries(entries).map(([artifactId, value]) => {
+        const entry = objectAt(value, 'LayerDoc asset mapping');
+        const file = files.find(file => file.role === 'asset' && file.relativePath === entry.path);
+        return [artifactId, { path: file.path, relativePath: file.relativePath, sha256: String(entry.sha256), mediaType: file.mediaType }];
+    }));
+    return { nativeLayerDoc: true, document, documentPath, manifestPath, assets };
+}
+/** Read a completed native conversion from immutable workflow custody, without hosted requests. */
+export async function loadWorkflowLayerDoc(args) {
+    const operation = await readOperation(args.workspace, args.operationId);
+    if (operation.state !== 'succeeded' || !operation.result)
+        return invalid('A completed native LayerDoc operation is required.');
+    if (operation.request.parameters?.output !== 'layerdoc'
+        && !(operation.request.capability === 'convert' && operation.request.output.kind === 'json'))
+        return invalid('This operation does not produce native LayerDoc.');
+    const files = await Promise.all(operation.result.artifacts.map(async (artifact) => ({
+        path: await resolveArtifactPath(args.workspace, artifact), mediaType: artifact.mediaType,
+        ...(artifact.role ? { role: artifact.role } : {}), ...(artifact.relativePath ? { relativePath: artifact.relativePath } : {}),
+    })));
+    return loadFiles(files);
+}
+/** Import a relocated export for local consumers. The hosted `convert file.layerdoc.json`
+ * endpoint does not accept this sidecar package; it requires hydrated HTTP asset references.
+ * This reader never uploads files, fabricates URLs, or provides an offline editor.
+ */
+export async function loadLayerDocBundle(args) {
+    const root = await realpath(args.directory);
+    const inside = async (relativePath) => {
+        const file = path.join(root, validateBundlePath(relativePath));
+        const parent = await realpath(path.dirname(file));
+        const relative = path.relative(root, parent);
+        if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
+            return invalid('LayerDoc assets must remain inside their bundle directory.');
+        return path.join(parent, path.basename(file));
+    };
+    const documentPath = await inside('document.layerdoc.json');
+    const manifestPath = await inside('layerdoc-assets.json');
+    const manifest = await readJson(manifestPath);
+    const entries = objectAt(manifest.assets, 'LayerDoc assets');
+    const files = [
+        { path: documentPath, relativePath: 'document.layerdoc.json', role: 'layerdoc', mediaType: 'application/vnd.12ui.layerdoc+json' },
+        { path: manifestPath, relativePath: 'layerdoc-assets.json', role: 'layerdoc-assets', mediaType: 'application/json' },
+    ];
+    const seen = new Set();
+    for (const value of Object.values(entries)) {
+        const entry = objectAt(value, 'LayerDoc asset mapping');
+        const relativePath = validateBundlePath(entry.path);
+        if (typeof entry.mediaType !== 'string')
+            return invalid('LayerDoc asset mapping requires its media type.');
+        if (seen.has(relativePath))
+            continue;
+        seen.add(relativePath);
+        files.push({ path: await inside(relativePath), relativePath, role: 'asset', mediaType: entry.mediaType });
+    }
+    return loadFiles(files);
+}
+//# sourceMappingURL=layerdoc-reader.js.map

package/dist/workflow/layerdoc-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerdoc-reader.js","sourceRoot":"","sources":["../../src/workflow/layerdoc-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAYjE,MAAM,OAAO,GAAG,CAAC,OAAe,EAAS,EAAE,GAAG,MAAM,IAAI,aAAa,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7G,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAAoC,EAAE;IACxE,IAAI,CAAC;QAAC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAAC,CAAC;IAC5G,OAAO,KAAK,EAAE,CAAC;QAAC,OAAO,OAAO,CAAC,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AAClI,CAAC,CAAC;AAEF,KAAK,UAAU,SAAS,CAAC,KAAmB;IAC1C,MAAM,4BAA4B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAE,CAAC,IAAI,CAAC;IACxE,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAE,CAAC,IAAI,CAAC;IAC/E,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE;QACpF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,IAAI,CAAE,CAAC;QAC5F,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAa,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACtI,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAgD;IACzF,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,oDAAoD,CAAC,CAAC;IAC/H,IAAI,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,KAAK,UAAU;WAClD,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,kDAAkD,CAAC,CAAC;IACnK,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE,CAAC,CAAC;QAChF,IAAI,EAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS;QACxF,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7H,CAAC,CAAC,CAAC,CAAC;IACL,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA2B;IAClE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,EAAE,YAAoB,EAAmB,EAAE;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC,4DAA4D,CAAC,CAAC;QACzK,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAiB;QAC1B,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,wBAAwB,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,oCAAoC,EAAE;QACjI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,EAAE;KACrH,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,iDAAiD,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,SAAS;QACrC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/workflow/project-evidence.d.ts

@@ -0,0 +1,48 @@
+import { type Artifact, type ExecutionResult, type WorkflowRequest } from './types.js';
+export type ProjectFileEvidence = {
+    relativePath: string;
+    sha256: string;
+    bytes: number;
+};
+export type ProjectSnapshot = {
+    schema: '12ui.project-snapshot/1';
+    policy: 'source-files-v1';
+    projectDir: string;
+    files: ProjectFileEvidence[];
+    digest: string;
+};
+export type ProjectChange = {
+    relativePath: string;
+    kind: 'added' | 'modified' | 'deleted';
+    before?: ProjectFileEvidence;
+    after?: ProjectFileEvidence;
+};
+export type ProjectEvidence = {
+    schema: '12ui.project-evidence/1';
+    projectDir: string;
+    before: ProjectSnapshot;
+    after: ProjectSnapshot;
+    changes: ProjectChange[];
+};
+/** This is an explicit bounded source/asset inventory, not a claim to snapshot every project file.
+ * Hidden files, narrative receipts, dependencies, generated output and common credential names are excluded.
+ * Symlinks are never followed. Limits fail explicitly rather than silently weakening coverage.
+ */
+export declare function snapshotProject(projectDir: string): Promise<ProjectSnapshot>;
+/** Baseline is immutable within an attempt. Repeated registration uses these original bytes. */
+export declare function persistProjectBaseline(args: {
+    projectDir: string;
+    evidenceDir: string;
+}): Promise<ProjectSnapshot>;
+export declare function readProjectBaseline(args: {
+    projectDir: string;
+    evidenceDir: string;
+}): Promise<ProjectSnapshot>;
+export declare function collectProjectEvidence(args: {
+    projectDir: string;
+    baseline: ProjectSnapshot;
+    evidenceDir: string;
+}): Promise<NonNullable<ExecutionResult['files']>>;
+/** Validate observed changes against already imported output bytes, not executor prose. */
+export declare function validateProjectEvidence(request: WorkflowRequest, value: unknown, artifacts: Artifact[]): Promise<void>;
+//# sourceMappingURL=project-evidence.d.ts.map

package/dist/workflow/project-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-evidence.d.ts","sourceRoot":"","sources":["../../src/workflow/project-evidence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtG,MAAM,MAAM,mBAAmB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,yBAAyB,CAAC;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAoBF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BlF;AA0CD,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAUxH;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAQrH;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAgBzK;AAOD,2FAA2F;AAC3F,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5H"}