@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/surfaces/tui/input.mjs

@@ -2,7 +2,11 @@ import { useInput } from "ink";
 import { useRef } from "react";
 //#region src/surfaces/tui/input.tsx
 const MAX_SNAPSHOT_NAME_LENGTH = 128;
-const printableSnapshotNameInput = (input) => input.replace(/[\u0000-\u001f\u007f]/g, "").slice(0, MAX_SNAPSHOT_NAME_LENGTH);
+const isPrintableSnapshotNameCharacter = (character) => {
+	const codePoint = character.codePointAt(0);
+	return codePoint !== void 0 && codePoint >= 32 && codePoint !== 127;
+};
+const printableSnapshotNameInput = (input) => Array.from(input).filter(isPrintableSnapshotNameCharacter).join("").slice(0, MAX_SNAPSHOT_NAME_LENGTH);
 /**
 * Renderless component — mounts `useInput` at the dashboard root.
 * Returns `null` so it composes inside layout boxes without taking

package/dist/surfaces/tui/input.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"input.mjs","names":[],"sources":["../../../src/surfaces/tui/input.tsx"],"sourcesContent":["// Keyboard input handler.\n//\n// HARD INVARIANT (distilled/21-tui § Learnings #3): keypress handlers\n// MUST NOT call engine methods directly. They publish typed\n// `EngineCommand` values onto a `CommandPublisher` callback the\n// surface receives at mount time. The engine consumes the channel on\n// the other end; the renderer has no awareness of supervisor\n// internals like Deferred / Queue / scope structure.\n//\n// Key map (architecture §11 + distilled/21-tui §Responsibilities):\n//\n//   q | Q                  -> 'shutdown.requested'\n//   r | R                  -> 'stack.restart'\n//   ctrl-c                 -> first press 'shutdown.requested'; repeat\n//                             press escalates to\n//                             'shutdown.hardKillRequested'. Ink handles\n//                             Ctrl-C in-process when `exitOnCtrlC:\n//                             false`, so this mirrors the process-level\n//                             signal handler for TTY users.\n//   s | S                  -> open snapshot-name prompt\n//\n// Defensive: useInput is mounted at the dashboard root level, NOT in\n// per-row components, so a re-rendered row never re-registers a\n// handler.\n\nimport { useInput } from 'ink';\nimport { useRef } from 'react';\n\nimport type { EngineCommand } from '../../substrate/events.ts';\n\n/**\n * Command publisher. A pure callback the renderer invokes with a\n * typed `EngineCommand`. The surface layer wires this to whatever\n * channel the engine is consuming on (Effect Queue, EventEmitter,\n * etc.); the renderer doesn't care.\n */\nexport type CommandPublisher = (command: EngineCommand) => void;\n\nexport interface InputHandlerProps {\n\t/** Publish a typed EngineCommand. */\n\treadonly publish: CommandPublisher;\n\t/** `null` means normal keymap mode; string means snapshot-name prompt mode. */\n\treadonly snapshotPromptValue: string | null;\n\t/** Update the snapshot prompt. Pass `null` to close it. */\n\treadonly onSnapshotPromptChange: (value: string | null) => void;\n\t/** Disable input handling (e.g. shutting-down state); defaults\n\t *  to false. */\n\treadonly disabled?: boolean;\n}\n\nexport interface CommandForKeyOptions {\n\treadonly shutdownAlreadyRequested?: boolean;\n\treadonly now?: () => number;\n}\n\nexport interface InputActionForKeyOptions extends CommandForKeyOptions {\n\treadonly snapshotPromptValue?: string | null;\n}\n\ninterface KeyFlags {\n\treadonly ctrl?: boolean;\n\treadonly return?: boolean;\n\treadonly escape?: boolean;\n\treadonly backspace?: boolean;\n\treadonly delete?: boolean;\n}\n\nexport type InputAction =\n\t| { readonly tag: 'publish'; readonly command: EngineCommand }\n\t| { readonly tag: 'snapshotPrompt.open' }\n\t| { readonly tag: 'snapshotPrompt.update'; readonly value: string }\n\t| { readonly tag: 'snapshotPrompt.cancel' };\n\nconst MAX_SNAPSHOT_NAME_LENGTH = 128;\n\nconst printableSnapshotNameInput = (input: string): string =>\n\tinput.replace(/[\\u0000-\\u001f\\u007f]/g, '').slice(0, MAX_SNAPSHOT_NAME_LENGTH);\n\n/**\n * Renderless component — mounts `useInput` at the dashboard root.\n * Returns `null` so it composes inside layout boxes without taking\n * up space.\n */\nexport const commandForKey = (\n\tinput: string,\n\tctrl: boolean,\n\toptions: CommandForKeyOptions = {},\n): EngineCommand | null => {\n\tif (ctrl && input === 'c') {\n\t\tif (options.shutdownAlreadyRequested === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'shutdown.hardKillRequested',\n\t\t\t\tsignal: 'SIGINT',\n\t\t\t\texitCode: 130,\n\t\t\t\tat: options.now?.() ?? Date.now(),\n\t\t\t};\n\t\t}\n\t\treturn { tag: 'shutdown.requested' };\n\t}\n\tswitch (input) {\n\t\tcase 'q':\n\t\tcase 'Q':\n\t\t\treturn { tag: 'shutdown.requested' };\n\t\tcase 'r':\n\t\tcase 'R':\n\t\t\treturn { tag: 'stack.restart' };\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nexport const inputActionForKey = (\n\tinput: string,\n\tkey: KeyFlags,\n\toptions: InputActionForKeyOptions = {},\n): InputAction | null => {\n\tif (options.snapshotPromptValue !== null && options.snapshotPromptValue !== undefined) {\n\t\tif (key.ctrl === true && input === 'c') {\n\t\t\tconst command = commandForKey(input, true, options);\n\t\t\treturn command === null ? null : { tag: 'publish', command };\n\t\t}\n\t\tif (key.escape === true) return { tag: 'snapshotPrompt.cancel' };\n\t\tif (key.return === true) {\n\t\t\tconst name = options.snapshotPromptValue.trim();\n\t\t\treturn {\n\t\t\t\ttag: 'publish',\n\t\t\t\tcommand:\n\t\t\t\t\tname.length === 0 ? { tag: 'snapshot.capture' } : { tag: 'snapshot.capture', name },\n\t\t\t};\n\t\t}\n\t\tif (key.backspace === true || key.delete === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'snapshotPrompt.update',\n\t\t\t\tvalue: options.snapshotPromptValue.slice(0, -1),\n\t\t\t};\n\t\t}\n\t\tif (key.ctrl === true) return null;\n\t\tconst printable = printableSnapshotNameInput(input);\n\t\tif (printable.length === 0) return null;\n\t\treturn {\n\t\t\ttag: 'snapshotPrompt.update',\n\t\t\tvalue: `${options.snapshotPromptValue}${printable}`.slice(0, MAX_SNAPSHOT_NAME_LENGTH),\n\t\t};\n\t}\n\n\tif (input === 's' || input === 'S') return { tag: 'snapshotPrompt.open' };\n\tconst command = commandForKey(input, key.ctrl === true, options);\n\treturn command === null ? null : { tag: 'publish', command };\n};\n\nexport const InputHandler = ({\n\tpublish,\n\tsnapshotPromptValue,\n\tonSnapshotPromptChange,\n\tdisabled = false,\n}: InputHandlerProps): null => {\n\tconst shutdownRequested = useRef(false);\n\tuseInput(\n\t\t(input, key) => {\n\t\t\tif (disabled) return;\n\t\t\tconst action = inputActionForKey(input, key, {\n\t\t\t\tsnapshotPromptValue,\n\t\t\t\tshutdownAlreadyRequested: shutdownRequested.current,\n\t\t\t});\n\t\t\tswitch (action?.tag) {\n\t\t\t\tcase 'publish': {\n\t\t\t\t\tconst { command } = action;\n\t\t\t\t\tif (\n\t\t\t\t\t\tcommand.tag === 'shutdown.requested' ||\n\t\t\t\t\t\tcommand.tag === 'shutdown.hardKillRequested'\n\t\t\t\t\t) {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t\tshutdownRequested.current = true;\n\t\t\t\t\t}\n\t\t\t\t\tif (command.tag === 'snapshot.capture') {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t}\n\t\t\t\t\tpublish(command);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase 'snapshotPrompt.open':\n\t\t\t\t\tonSnapshotPromptChange('');\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.update':\n\t\t\t\t\tonSnapshotPromptChange(action.value);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.cancel':\n\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t},\n\t\t{ isActive: !disabled },\n\t);\n\treturn null;\n};\n"],"mappings":";;;AAyEA,MAAM,2BAA2B;AAEjC,MAAM,8BAA8B,UACnC,MAAM,QAAQ,0BAA0B,GAAG,CAAC,MAAM,GAAG,yBAAyB;;;;;;AAO/E,MAAa,iBACZ,OACA,MACA,UAAgC,EAAE,KACR;AAC1B,KAAI,QAAQ,UAAU,KAAK;AAC1B,MAAI,QAAQ,6BAA6B,KACxC,QAAO;GACN,KAAK;GACL,QAAQ;GACR,UAAU;GACV,IAAI,QAAQ,OAAO,IAAI,KAAK,KAAK;GACjC;AAEF,SAAO,EAAE,KAAK,sBAAsB;;AAErC,SAAQ,OAAR;EACC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,sBAAsB;EACrC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,iBAAiB;EAChC,QACC,QAAO;;;AAIV,MAAa,qBACZ,OACA,KACA,UAAoC,EAAE,KACd;AACxB,KAAI,QAAQ,wBAAwB,QAAQ,QAAQ,wBAAwB,KAAA,GAAW;AACtF,MAAI,IAAI,SAAS,QAAQ,UAAU,KAAK;GACvC,MAAM,UAAU,cAAc,OAAO,MAAM,QAAQ;AACnD,UAAO,YAAY,OAAO,OAAO;IAAE,KAAK;IAAW;IAAS;;AAE7D,MAAI,IAAI,WAAW,KAAM,QAAO,EAAE,KAAK,yBAAyB;AAChE,MAAI,IAAI,WAAW,MAAM;GACxB,MAAM,OAAO,QAAQ,oBAAoB,MAAM;AAC/C,UAAO;IACN,KAAK;IACL,SACC,KAAK,WAAW,IAAI,EAAE,KAAK,oBAAoB,GAAG;KAAE,KAAK;KAAoB;KAAM;IACpF;;AAEF,MAAI,IAAI,cAAc,QAAQ,IAAI,WAAW,KAC5C,QAAO;GACN,KAAK;GACL,OAAO,QAAQ,oBAAoB,MAAM,GAAG,GAAG;GAC/C;AAEF,MAAI,IAAI,SAAS,KAAM,QAAO;EAC9B,MAAM,YAAY,2BAA2B,MAAM;AACnD,MAAI,UAAU,WAAW,EAAG,QAAO;AACnC,SAAO;GACN,KAAK;GACL,OAAO,GAAG,QAAQ,sBAAsB,YAAY,MAAM,GAAG,yBAAyB;GACtF;;AAGF,KAAI,UAAU,OAAO,UAAU,IAAK,QAAO,EAAE,KAAK,uBAAuB;CACzE,MAAM,UAAU,cAAc,OAAO,IAAI,SAAS,MAAM,QAAQ;AAChE,QAAO,YAAY,OAAO,OAAO;EAAE,KAAK;EAAW;EAAS;;AAG7D,MAAa,gBAAgB,EAC5B,SACA,qBACA,wBACA,WAAW,YACmB;CAC9B,MAAM,oBAAoB,OAAO,MAAM;AACvC,WACE,OAAO,QAAQ;AACf,MAAI,SAAU;EACd,MAAM,SAAS,kBAAkB,OAAO,KAAK;GAC5C;GACA,0BAA0B,kBAAkB;GAC5C,CAAC;AACF,UAAQ,QAAQ,KAAhB;GACC,KAAK,WAAW;IACf,MAAM,EAAE,YAAY;AACpB,QACC,QAAQ,QAAQ,wBAChB,QAAQ,QAAQ,8BACf;AACD,4BAAuB,KAAK;AAC5B,uBAAkB,UAAU;;AAE7B,QAAI,QAAQ,QAAQ,mBACnB,wBAAuB,KAAK;AAE7B,YAAQ,QAAQ;AAChB;;GAED,KAAK;AACJ,2BAAuB,GAAG;AAC1B;GACD,KAAK;AACJ,2BAAuB,OAAO,MAAM;AACpC;GACD,KAAK;AACJ,2BAAuB,KAAK;AAC5B;GACD,QACC;;IAGH,EAAE,UAAU,CAAC,UAAU,CACvB;AACD,QAAO"}
+{"version":3,"file":"input.mjs","names":[],"sources":["../../../src/surfaces/tui/input.tsx"],"sourcesContent":["// Keyboard input handler.\n//\n// HARD INVARIANT (distilled/21-tui § Learnings #3): keypress handlers\n// MUST NOT call engine methods directly. They publish typed\n// `EngineCommand` values onto a `CommandPublisher` callback the\n// surface receives at mount time. The engine consumes the channel on\n// the other end; the renderer has no awareness of supervisor\n// internals like Deferred / Queue / scope structure.\n//\n// Key map (architecture §11 + distilled/21-tui §Responsibilities):\n//\n//   q | Q                  -> 'shutdown.requested'\n//   r | R                  -> 'stack.restart'\n//   ctrl-c                 -> first press 'shutdown.requested'; repeat\n//                             press escalates to\n//                             'shutdown.hardKillRequested'. Ink handles\n//                             Ctrl-C in-process when `exitOnCtrlC:\n//                             false`, so this mirrors the process-level\n//                             signal handler for TTY users.\n//   s | S                  -> open snapshot-name prompt\n//\n// Defensive: useInput is mounted at the dashboard root level, NOT in\n// per-row components, so a re-rendered row never re-registers a\n// handler.\n\nimport { useInput } from 'ink';\nimport { useRef } from 'react';\n\nimport type { EngineCommand } from '../../substrate/events.ts';\n\n/**\n * Command publisher. A pure callback the renderer invokes with a\n * typed `EngineCommand`. The surface layer wires this to whatever\n * channel the engine is consuming on (Effect Queue, EventEmitter,\n * etc.); the renderer doesn't care.\n */\nexport type CommandPublisher = (command: EngineCommand) => void;\n\nexport interface InputHandlerProps {\n\t/** Publish a typed EngineCommand. */\n\treadonly publish: CommandPublisher;\n\t/** `null` means normal keymap mode; string means snapshot-name prompt mode. */\n\treadonly snapshotPromptValue: string | null;\n\t/** Update the snapshot prompt. Pass `null` to close it. */\n\treadonly onSnapshotPromptChange: (value: string | null) => void;\n\t/** Disable input handling (e.g. shutting-down state); defaults\n\t *  to false. */\n\treadonly disabled?: boolean;\n}\n\nexport interface CommandForKeyOptions {\n\treadonly shutdownAlreadyRequested?: boolean;\n\treadonly now?: () => number;\n}\n\nexport interface InputActionForKeyOptions extends CommandForKeyOptions {\n\treadonly snapshotPromptValue?: string | null;\n}\n\ninterface KeyFlags {\n\treadonly ctrl?: boolean;\n\treadonly return?: boolean;\n\treadonly escape?: boolean;\n\treadonly backspace?: boolean;\n\treadonly delete?: boolean;\n}\n\nexport type InputAction =\n\t| { readonly tag: 'publish'; readonly command: EngineCommand }\n\t| { readonly tag: 'snapshotPrompt.open' }\n\t| { readonly tag: 'snapshotPrompt.update'; readonly value: string }\n\t| { readonly tag: 'snapshotPrompt.cancel' };\n\nconst MAX_SNAPSHOT_NAME_LENGTH = 128;\n\nconst isPrintableSnapshotNameCharacter = (character: string): boolean => {\n\tconst codePoint = character.codePointAt(0);\n\treturn codePoint !== undefined && codePoint >= 0x20 && codePoint !== 0x7f;\n};\n\nconst printableSnapshotNameInput = (input: string): string =>\n\tArray.from(input)\n\t\t.filter(isPrintableSnapshotNameCharacter)\n\t\t.join('')\n\t\t.slice(0, MAX_SNAPSHOT_NAME_LENGTH);\n\n/**\n * Renderless component — mounts `useInput` at the dashboard root.\n * Returns `null` so it composes inside layout boxes without taking\n * up space.\n */\nexport const commandForKey = (\n\tinput: string,\n\tctrl: boolean,\n\toptions: CommandForKeyOptions = {},\n): EngineCommand | null => {\n\tif (ctrl && input === 'c') {\n\t\tif (options.shutdownAlreadyRequested === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'shutdown.hardKillRequested',\n\t\t\t\tsignal: 'SIGINT',\n\t\t\t\texitCode: 130,\n\t\t\t\tat: options.now?.() ?? Date.now(),\n\t\t\t};\n\t\t}\n\t\treturn { tag: 'shutdown.requested' };\n\t}\n\tswitch (input) {\n\t\tcase 'q':\n\t\tcase 'Q':\n\t\t\treturn { tag: 'shutdown.requested' };\n\t\tcase 'r':\n\t\tcase 'R':\n\t\t\treturn { tag: 'stack.restart' };\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nexport const inputActionForKey = (\n\tinput: string,\n\tkey: KeyFlags,\n\toptions: InputActionForKeyOptions = {},\n): InputAction | null => {\n\tif (options.snapshotPromptValue !== null && options.snapshotPromptValue !== undefined) {\n\t\tif (key.ctrl === true && input === 'c') {\n\t\t\tconst command = commandForKey(input, true, options);\n\t\t\treturn command === null ? null : { tag: 'publish', command };\n\t\t}\n\t\tif (key.escape === true) return { tag: 'snapshotPrompt.cancel' };\n\t\tif (key.return === true) {\n\t\t\tconst name = options.snapshotPromptValue.trim();\n\t\t\treturn {\n\t\t\t\ttag: 'publish',\n\t\t\t\tcommand:\n\t\t\t\t\tname.length === 0 ? { tag: 'snapshot.capture' } : { tag: 'snapshot.capture', name },\n\t\t\t};\n\t\t}\n\t\tif (key.backspace === true || key.delete === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'snapshotPrompt.update',\n\t\t\t\tvalue: options.snapshotPromptValue.slice(0, -1),\n\t\t\t};\n\t\t}\n\t\tif (key.ctrl === true) return null;\n\t\tconst printable = printableSnapshotNameInput(input);\n\t\tif (printable.length === 0) return null;\n\t\treturn {\n\t\t\ttag: 'snapshotPrompt.update',\n\t\t\tvalue: `${options.snapshotPromptValue}${printable}`.slice(0, MAX_SNAPSHOT_NAME_LENGTH),\n\t\t};\n\t}\n\n\tif (input === 's' || input === 'S') return { tag: 'snapshotPrompt.open' };\n\tconst command = commandForKey(input, key.ctrl === true, options);\n\treturn command === null ? null : { tag: 'publish', command };\n};\n\nexport const InputHandler = ({\n\tpublish,\n\tsnapshotPromptValue,\n\tonSnapshotPromptChange,\n\tdisabled = false,\n}: InputHandlerProps): null => {\n\tconst shutdownRequested = useRef(false);\n\tuseInput(\n\t\t(input, key) => {\n\t\t\tif (disabled) return;\n\t\t\tconst action = inputActionForKey(input, key, {\n\t\t\t\tsnapshotPromptValue,\n\t\t\t\tshutdownAlreadyRequested: shutdownRequested.current,\n\t\t\t});\n\t\t\tswitch (action?.tag) {\n\t\t\t\tcase 'publish': {\n\t\t\t\t\tconst { command } = action;\n\t\t\t\t\tif (\n\t\t\t\t\t\tcommand.tag === 'shutdown.requested' ||\n\t\t\t\t\t\tcommand.tag === 'shutdown.hardKillRequested'\n\t\t\t\t\t) {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t\tshutdownRequested.current = true;\n\t\t\t\t\t}\n\t\t\t\t\tif (command.tag === 'snapshot.capture') {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t}\n\t\t\t\t\tpublish(command);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase 'snapshotPrompt.open':\n\t\t\t\t\tonSnapshotPromptChange('');\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.update':\n\t\t\t\t\tonSnapshotPromptChange(action.value);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.cancel':\n\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t},\n\t\t{ isActive: !disabled },\n\t);\n\treturn null;\n};\n"],"mappings":";;;AAyEA,MAAM,2BAA2B;AAEjC,MAAM,oCAAoC,cAA+B;CACxE,MAAM,YAAY,UAAU,YAAY,EAAE;AAC1C,QAAO,cAAc,KAAA,KAAa,aAAa,MAAQ,cAAc;;AAGtE,MAAM,8BAA8B,UACnC,MAAM,KAAK,MAAM,CACf,OAAO,iCAAiC,CACxC,KAAK,GAAG,CACR,MAAM,GAAG,yBAAyB;;;;;;AAOrC,MAAa,iBACZ,OACA,MACA,UAAgC,EAAE,KACR;AAC1B,KAAI,QAAQ,UAAU,KAAK;AAC1B,MAAI,QAAQ,6BAA6B,KACxC,QAAO;GACN,KAAK;GACL,QAAQ;GACR,UAAU;GACV,IAAI,QAAQ,OAAO,IAAI,KAAK,KAAK;GACjC;AAEF,SAAO,EAAE,KAAK,sBAAsB;;AAErC,SAAQ,OAAR;EACC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,sBAAsB;EACrC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,iBAAiB;EAChC,QACC,QAAO;;;AAIV,MAAa,qBACZ,OACA,KACA,UAAoC,EAAE,KACd;AACxB,KAAI,QAAQ,wBAAwB,QAAQ,QAAQ,wBAAwB,KAAA,GAAW;AACtF,MAAI,IAAI,SAAS,QAAQ,UAAU,KAAK;GACvC,MAAM,UAAU,cAAc,OAAO,MAAM,QAAQ;AACnD,UAAO,YAAY,OAAO,OAAO;IAAE,KAAK;IAAW;IAAS;;AAE7D,MAAI,IAAI,WAAW,KAAM,QAAO,EAAE,KAAK,yBAAyB;AAChE,MAAI,IAAI,WAAW,MAAM;GACxB,MAAM,OAAO,QAAQ,oBAAoB,MAAM;AAC/C,UAAO;IACN,KAAK;IACL,SACC,KAAK,WAAW,IAAI,EAAE,KAAK,oBAAoB,GAAG;KAAE,KAAK;KAAoB;KAAM;IACpF;;AAEF,MAAI,IAAI,cAAc,QAAQ,IAAI,WAAW,KAC5C,QAAO;GACN,KAAK;GACL,OAAO,QAAQ,oBAAoB,MAAM,GAAG,GAAG;GAC/C;AAEF,MAAI,IAAI,SAAS,KAAM,QAAO;EAC9B,MAAM,YAAY,2BAA2B,MAAM;AACnD,MAAI,UAAU,WAAW,EAAG,QAAO;AACnC,SAAO;GACN,KAAK;GACL,OAAO,GAAG,QAAQ,sBAAsB,YAAY,MAAM,GAAG,yBAAyB;GACtF;;AAGF,KAAI,UAAU,OAAO,UAAU,IAAK,QAAO,EAAE,KAAK,uBAAuB;CACzE,MAAM,UAAU,cAAc,OAAO,IAAI,SAAS,MAAM,QAAQ;AAChE,QAAO,YAAY,OAAO,OAAO;EAAE,KAAK;EAAW;EAAS;;AAG7D,MAAa,gBAAgB,EAC5B,SACA,qBACA,wBACA,WAAW,YACmB;CAC9B,MAAM,oBAAoB,OAAO,MAAM;AACvC,WACE,OAAO,QAAQ;AACf,MAAI,SAAU;EACd,MAAM,SAAS,kBAAkB,OAAO,KAAK;GAC5C;GACA,0BAA0B,kBAAkB;GAC5C,CAAC;AACF,UAAQ,QAAQ,KAAhB;GACC,KAAK,WAAW;IACf,MAAM,EAAE,YAAY;AACpB,QACC,QAAQ,QAAQ,wBAChB,QAAQ,QAAQ,8BACf;AACD,4BAAuB,KAAK;AAC5B,uBAAkB,UAAU;;AAE7B,QAAI,QAAQ,QAAQ,mBACnB,wBAAuB,KAAK;AAE7B,YAAQ,QAAQ;AAChB;;GAED,KAAK;AACJ,2BAAuB,GAAG;AAC1B;GACD,KAAK;AACJ,2BAAuB,OAAO,MAAM;AACpC;GACD,KAAK;AACJ,2BAAuB,KAAK;AAC5B;GACD,QACC;;IAGH,EAAE,UAAU,CAAC,UAAU,CACvB;AACD,QAAO"}

package/dist/surfaces/tui/plain-renderer.mjs

@@ -1,6 +1,8 @@
+import { AccountProjectionSchema, PackageProjectionSchema } from "../../substrate/runtime/projection/persisted.mjs";
+import { eventAt } from "../../substrate/event-time.mjs";
 import { mountFailed } from "./errors.mjs";
 import { accountLine, endpointLine, labelForRow, packageLine, roleLabel, statusLabel } from "./display-derivation.mjs";
-import { Effect, Stream, SubscriptionRef } from "effect";
+import { Effect, Schema, Stream, SubscriptionRef } from "effect";
 //#region src/surfaces/tui/plain-renderer.ts
 /**
 * Plain-renderer line shape (each call returns exactly one line, no
@@ -35,19 +37,11 @@ const makePlainRenderer = () => ({
 	flush: Effect.void.pipe(Effect.catch(() => Effect.fail(mountFailed("flush"))))
 });
 const isoTimestamp = (at) => new Date(at || Date.now()).toISOString();
-const eventAt = (event) => {
-	if ("at" in event && typeof event.at === "number") return event.at;
-	switch (event.tag) {
-		case "endpoint.registered": return event.endpoint.registeredAt;
-		case "error.reported": return event.error.at;
-		case "build.statusChanged": return event.entry.startedAt;
-		default: return Date.now();
-	}
-};
 const levelForEvent = (event) => {
 	switch (event.tag) {
 		case "log.appended": return event.level === "error" ? "ERROR" : event.level === "warn" ? "WARN" : "INFO";
 		case "error.reported": return event.error.severity === "fatal" || event.error.severity === "error" ? "ERROR" : "WARN";
+		case "engine.orchestrator.dispatchFailed": return "WARN";
 		default: return "INFO";
 	}
 };
@@ -73,27 +67,46 @@ const payloadFor = (event) => {
 			url: event.endpoint.url,
 			wire: event.endpoint.wireProtocol
 		});
-		case "account.updated": return kv({
-			key: event.account.key,
-			row: event.account.rowKey ?? "",
-			name: event.account.name,
-			address: event.account.address ?? "",
-			scheme: event.account.scheme ?? "",
-			source: event.account.source ?? "",
-			funding: event.account.funding.status,
-			fundingEntries: (event.account.funding.entries ?? []).map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`).join(","),
-			requestedMist: event.account.funding.requestedMist ?? "",
-			balanceMist: event.account.funding.balanceMist ?? ""
-		});
-		case "package.updated": return kv({
-			key: event.package.key,
-			row: event.package.rowKey ?? "",
-			name: event.package.name,
-			kind: event.package.kind,
-			packageId: event.package.packageId,
-			upgradeCapId: event.package.upgradeCapId ?? "",
-			mvr: event.package.mvrPlaceholder
-		});
+		case "projection.updated":
+			if (event.kind === "account") {
+				const account = tryDecodeProjection(AccountProjectionSchema, event.payload);
+				if (account === null) return kv({
+					kind: event.kind,
+					key: event.key
+				});
+				return kv({
+					key: account.key,
+					row: account.rowKey ?? "",
+					name: account.name,
+					address: account.address ?? "",
+					scheme: account.scheme ?? "",
+					source: account.source ?? "",
+					funding: account.funding.status,
+					fundingEntries: (account.funding.entries ?? []).map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`).join(","),
+					requestedMist: account.funding.requestedMist ?? "",
+					balanceMist: account.funding.balanceMist ?? ""
+				});
+			}
+			if (event.kind === "package") {
+				const pkg = tryDecodeProjection(PackageProjectionSchema, event.payload);
+				if (pkg === null) return kv({
+					kind: event.kind,
+					key: event.key
+				});
+				return kv({
+					key: pkg.key,
+					row: pkg.rowKey ?? "",
+					name: pkg.name,
+					kind: pkg.kind,
+					packageId: pkg.packageId,
+					upgradeCapId: pkg.upgradeCapId ?? "",
+					mvr: pkg.mvrPlaceholder
+				});
+			}
+			return kv({
+				kind: event.kind,
+				key: event.key
+			});
 		case "endpoint.released": return kv({ key: event.endpointKey });
 		case "strategy.registered": return kv({
 			capability: event.capabilityKey,
@@ -102,6 +115,12 @@ const payloadFor = (event) => {
 		case "strategy.unregistered": return kv({ capability: event.capabilityKey });
 		case "manifest.flushed": return kv({ version: event.manifestVersion });
 		case "codegen.emitted": return kv({ files: event.files.length });
+		case "engine.orchestrator.dispatchFailed": return kv({
+			key: event.pluginKey,
+			kind: event.kind,
+			causeType: event.causeType ?? "",
+			summary: event.message
+		});
 		case "error.reported": return kv({
 			key: event.error.pluginKey ?? "",
 			tag: event.error.tag,
@@ -145,8 +164,25 @@ const payloadFor = (event) => {
 	}
 };
 const kv = (record) => Object.entries(record).filter(([, v]) => v !== "" && v !== null && v !== void 0).map(([k, v]) => `${k}=${quoteIfNeeded(String(v))}`).join(" ");
-const quoteIfNeeded = (s) => /[\s"]/.test(s) ? quote(s) : s;
+const quoteIfNeeded = (s) => /[\s"\x00-\x1f]/.test(s) ? quote(s) : s;
 const quote = (s) => `"${s.replace(/"/g, "\\\"")}"`;
+/**
+* Structural validate-then-narrow for `projection.updated` payloads
+* before they are formatted as text. Mirrors
+* `tryDecodeProjectionPayload` in the substrate reducer — returns
+* `null` on schema-decode failure so the renderer drops the slice
+* rather than printing fields off a malformed object. The substrate
+* reducer emits the `Effect.logWarning` for the same payload (the
+* decode is deterministic), so we stay silent here to avoid double
+* logging.
+*/
+const tryDecodeProjection = (schema, payload) => {
+	try {
+		return Schema.decodeUnknownSync(schema)(payload);
+	} catch {
+		return null;
+	}
+};
 const emitInitialSweep = (state) => Effect.gen(function* () {
 	yield* writeStderrLine(`${isoTimestamp(state.cycle.startedAt || Date.now())} INFO stack.identity app=${state.identity.app} stack=${state.identity.stack} network=${state.identity.network} cycle=${state.cycle.id}`);
 	for (const row of state.rows) yield* writeStderrLine(`${isoTimestamp(Date.now())} INFO row.declared ${kv({
@@ -156,8 +192,8 @@ const emitInitialSweep = (state) => Effect.gen(function* () {
 		status: statusLabel(row.status)
 	})}`);
 	for (const endpoint of state.endpoints) yield* writeStderrLine(`${isoTimestamp(endpoint.registeredAt)} INFO endpoint.registered ${endpointLine(endpoint)}`);
-	for (const account of state.accounts) yield* writeStderrLine(`${isoTimestamp(account.updatedAt)} INFO account.updated ${accountLine(account)}`);
-	for (const pkg of state.packages) yield* writeStderrLine(`${isoTimestamp(pkg.updatedAt)} INFO package.updated ${packageLine(pkg)}`);
+	for (const account of state.accounts) yield* writeStderrLine(`${isoTimestamp(account.updatedAt)} INFO projection.updated[account] ${accountLine(account)}`);
+	for (const pkg of state.packages) yield* writeStderrLine(`${isoTimestamp(pkg.updatedAt)} INFO projection.updated[package] ${packageLine(pkg)}`);
 });
 const writeStderrLine = (line) => Effect.sync(() => {
 	try {

package/dist/surfaces/tui/plain-renderer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plain-renderer.mjs","names":[],"sources":["../../../src/surfaces/tui/plain-renderer.ts"],"sourcesContent":["// Plain (non-TTY) renderer.\n//\n// Architecture §11 + distilled/21-tui §Renderers: when stdout is not\n// a TTY (CI, pipe, log file), the live ink dashboard is replaced by\n// a structured line stream. One line per event; periodic heartbeat\n// per internally-acquiring row, surfaced to operators as \"starting\".\n//\n// Discipline:\n//   - One line per EngineEvent — no batching, no aggregation, no\n//     diffing. Each event maps to exactly one structured line.\n//   - Writes to stderr (architecture invariant: plain renderer goes\n//     to stderr so stdout stays clean for whatever consumes the\n//     pipe).\n//   - EPIPE swallowed (pipe-safety invariant).\n//   - Pure formatting helpers exposed for tests; the Effect-shaped\n//     side is the `mount` function.\n//   - Heartbeat formatting is pure here; scheduling belongs to the\n//     renderer mount path. The architecture says it\n//     \"anchors on first sighting in the internal acquiring state; phase\n//     changes do NOT reset the clock; a late tick emits exactly one\n//     heartbeat (no backlog catch-up)\". The seam is exposed via\n//     `formatHeartbeat`.\n\nimport { Effect, Stream, SubscriptionRef } from 'effect';\n\nimport type { Renderer } from '../../contracts/renderer.ts';\nimport type { EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport {\n\taccountLine,\n\tendpointLine,\n\tlabelForRow,\n\tnarrationFor,\n\tpackageLine,\n\troleLabel,\n\tstatusLabel,\n} from './display-derivation.ts';\nimport { mountFailed } from './errors.ts';\n\n// -----------------------------------------------------------------------------\n// Line shape — pure formatters\n// -----------------------------------------------------------------------------\n\n/**\n * Plain-renderer line shape (each call returns exactly one line, no\n * trailing newline).\n *\n *   <iso-timestamp> <level> <event-tag> <key>=<value> ...\n *\n * Example:\n *   2026-05-19T20:11:32.001Z INFO lifecycle.statusChanged key=sui from=starting to=ready\n *   2026-05-19T20:11:32.500Z WARN log.appended key=walrus line=\"failed to bind port 9000\"\n *   2026-05-19T20:11:33.000Z INFO endpoint.registered name=aggregator url=http://localhost:9000\n */\nexport const formatEventLine = (event: EngineEvent): string => {\n\tconst ts = isoTimestamp(eventAt(event));\n\tconst level = levelForEvent(event);\n\tconst payload = payloadFor(event);\n\treturn `${ts} ${level} ${event.tag} ${payload}`;\n};\n\n/**\n * Heartbeat line for an in-flight internal acquiring row. Emitted by the\n * scheduler at architecture-blessed intervals; this function is the\n * pure formatter only.\n */\nexport const formatHeartbeat = (\n\tnow: number,\n\tkey: string,\n\tphase: string | null,\n\troleToken: string,\n): string => {\n\tconst ts = isoTimestamp(now);\n\tconst narration = narrationFor(phase, 'acquiring');\n\treturn `${ts} INFO heartbeat key=${key} role=${roleToken} narration=${quote(narration)}`;\n};\n\n// -----------------------------------------------------------------------------\n// Renderer implementation\n// -----------------------------------------------------------------------------\n\n/**\n * Build a plain renderer satisfying the `Renderer` contract.\n *\n * Mount subscribes to the live event stream, writes one line per\n * event to stderr. The state-ref is sampled for the initial sweep\n * (one line per declared row) so a renderer attached after boot\n * still sees a coherent baseline.\n */\nexport const makePlainRenderer = (): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst initial = yield* SubscriptionRef.get(stateRef);\n\t\t\tyield* emitInitialSweep(initial);\n\t\t\tyield* events.pipe(Stream.runForEach((event) => writeStderrLine(formatEventLine(event))));\n\t\t}).pipe(\n\t\t\tEffect.catch((cause: unknown) =>\n\t\t\t\tEffect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))),\n\t\t\t),\n\t\t),\n\tflush: Effect.void.pipe(Effect.catch(() => Effect.fail(mountFailed('flush')))),\n});\n\n// -----------------------------------------------------------------------------\n// Internals — formatting\n// -----------------------------------------------------------------------------\n\nconst isoTimestamp = (at: number): string => new Date(at || Date.now()).toISOString();\n\nconst eventAt = (event: EngineEvent): number => {\n\tif ('at' in event && typeof event.at === 'number') return event.at;\n\tswitch (event.tag) {\n\t\tcase 'endpoint.registered':\n\t\t\treturn event.endpoint.registeredAt;\n\t\tcase 'error.reported':\n\t\t\treturn event.error.at;\n\t\tcase 'build.statusChanged':\n\t\t\treturn event.entry.startedAt;\n\t\tdefault:\n\t\t\treturn Date.now();\n\t}\n};\n\nconst levelForEvent = (event: EngineEvent): 'INFO' | 'WARN' | 'ERROR' => {\n\tswitch (event.tag) {\n\t\tcase 'log.appended':\n\t\t\treturn event.level === 'error' ? 'ERROR' : event.level === 'warn' ? 'WARN' : 'INFO';\n\t\tcase 'error.reported':\n\t\t\treturn event.error.severity === 'fatal' || event.error.severity === 'error'\n\t\t\t\t? 'ERROR'\n\t\t\t\t: 'WARN';\n\t\tdefault:\n\t\t\treturn 'INFO';\n\t}\n};\n\nconst payloadFor = (event: EngineEvent): string => {\n\tswitch (event.tag) {\n\t\tcase 'lifecycle.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tfrom: statusLabel(event.from),\n\t\t\t\tto: statusLabel(event.to),\n\t\t\t});\n\t\tcase 'lifecycle.phaseSet':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tphase: event.phase ?? '',\n\t\t\t});\n\t\tcase 'log.appended':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tline: event.line,\n\t\t\t});\n\t\tcase 'endpoint.registered':\n\t\t\treturn kv({\n\t\t\t\tkey: event.endpoint.endpointKey,\n\t\t\t\tname: event.endpoint.name,\n\t\t\t\tdisplayUrl: event.endpoint.displayUrl ?? event.endpoint.url,\n\t\t\t\turl: event.endpoint.url,\n\t\t\t\twire: event.endpoint.wireProtocol,\n\t\t\t});\n\t\tcase 'account.updated':\n\t\t\treturn kv({\n\t\t\t\tkey: event.account.key,\n\t\t\t\trow: event.account.rowKey ?? '',\n\t\t\t\tname: event.account.name,\n\t\t\t\taddress: event.account.address ?? '',\n\t\t\t\tscheme: event.account.scheme ?? '',\n\t\t\t\tsource: event.account.source ?? '',\n\t\t\t\tfunding: event.account.funding.status,\n\t\t\t\tfundingEntries: (event.account.funding.entries ?? [])\n\t\t\t\t\t.map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`)\n\t\t\t\t\t.join(','),\n\t\t\t\trequestedMist: event.account.funding.requestedMist ?? '',\n\t\t\t\tbalanceMist: event.account.funding.balanceMist ?? '',\n\t\t\t});\n\t\tcase 'package.updated':\n\t\t\treturn kv({\n\t\t\t\tkey: event.package.key,\n\t\t\t\trow: event.package.rowKey ?? '',\n\t\t\t\tname: event.package.name,\n\t\t\t\tkind: event.package.kind,\n\t\t\t\tpackageId: event.package.packageId,\n\t\t\t\tupgradeCapId: event.package.upgradeCapId ?? '',\n\t\t\t\tmvr: event.package.mvrPlaceholder,\n\t\t\t});\n\t\tcase 'endpoint.released':\n\t\t\treturn kv({ key: event.endpointKey });\n\t\tcase 'strategy.registered':\n\t\t\treturn kv({\n\t\t\t\tcapability: event.capabilityKey,\n\t\t\t\tautoMounted: event.autoMounted,\n\t\t\t});\n\t\tcase 'strategy.unregistered':\n\t\t\treturn kv({ capability: event.capabilityKey });\n\t\tcase 'manifest.flushed':\n\t\t\treturn kv({ version: event.manifestVersion });\n\t\tcase 'codegen.emitted':\n\t\t\treturn kv({ files: event.files.length });\n\t\tcase 'error.reported':\n\t\t\treturn kv({\n\t\t\t\tkey: event.error.pluginKey ?? '',\n\t\t\t\ttag: event.error.tag,\n\t\t\t\tsummary: event.error.summary,\n\t\t\t\tcause: event.error.chain.join(' | '),\n\t\t\t\tseverity: event.error.severity,\n\t\t\t});\n\t\tcase 'build.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.entry.pluginKey ?? '',\n\t\t\t\tphase: event.entry.phase,\n\t\t\t\tprogress: event.entry.progress,\n\t\t\t});\n\t\tcase 'restart.requested':\n\t\tcase 'restart.completed':\n\t\t\treturn kv({\n\t\t\t\ttarget: event.target === 'stack' ? 'stack' : event.target.pluginKey,\n\t\t\t});\n\t\tcase 'shutdown.escalated':\n\t\t\treturn kv({\n\t\t\t\tmode: 'hard-kill',\n\t\t\t\tsignal: event.signal,\n\t\t\t\texitCode: event.exitCode,\n\t\t\t});\n\t\tcase 'snapshot.captureStarted':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name });\n\t\tcase 'snapshot.captureProgress':\n\t\t\treturn kv({\n\t\t\t\tsnapshotId: event.snapshotId,\n\t\t\t\tname: event.name,\n\t\t\t\tphase: event.phase,\n\t\t\t\tdetail: event.detail,\n\t\t\t\tpaused: event.pausedContainers,\n\t\t\t\ttotal: event.totalContainers,\n\t\t\t});\n\t\tcase 'snapshot.captureSkipped':\n\t\t\treturn kv({ reason: event.reason });\n\t\tcase 'snapshot.captureFailed':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name, summary: event.summary });\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\t\treturn kv({ snapshotId: event.snapshotId });\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nconst kv = (record: Readonly<Record<string, unknown>>): string =>\n\tObject.entries(record)\n\t\t.filter(([, v]) => v !== '' && v !== null && v !== undefined)\n\t\t.map(([k, v]) => `${k}=${quoteIfNeeded(String(v))}`)\n\t\t.join(' ');\n\nconst quoteIfNeeded = (s: string): string => (/[\\s\"]/.test(s) ? quote(s) : s);\n\nconst quote = (s: string): string => `\"${s.replace(/\"/g, '\\\\\"')}\"`;\n\n// -----------------------------------------------------------------------------\n// Internals — initial sweep\n// -----------------------------------------------------------------------------\n\nconst emitInitialSweep = (state: SubscribableState): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeStderrLine(\n\t\t\t`${isoTimestamp(state.cycle.startedAt || Date.now())} INFO stack.identity app=${state.identity.app} stack=${state.identity.stack} network=${state.identity.network} cycle=${state.cycle.id}`,\n\t\t);\n\t\tfor (const row of state.rows) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(Date.now())} INFO row.declared ${kv({\n\t\t\t\t\tkey: row.key,\n\t\t\t\t\tlabel: labelForRow(row.key),\n\t\t\t\t\trole: roleLabel(row.role),\n\t\t\t\t\tstatus: statusLabel(row.status),\n\t\t\t\t})}`,\n\t\t\t);\n\t\t}\n\t\tfor (const endpoint of state.endpoints) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(endpoint.registeredAt)} INFO endpoint.registered ${endpointLine(endpoint)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const account of state.accounts) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(account.updatedAt)} INFO account.updated ${accountLine(account)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const pkg of state.packages) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(pkg.updatedAt)} INFO package.updated ${packageLine(pkg)}`,\n\t\t\t);\n\t\t}\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals — IO (pipe-safe)\n// -----------------------------------------------------------------------------\n\nconst writeStderrLine = (line: string): Effect.Effect<void> =>\n\tEffect.sync(() => {\n\t\ttry {\n\t\t\tprocess.stderr.write(`${line}\\n`);\n\t\t} catch (err) {\n\t\t\t// EPIPE swallowed (pipe-safety invariant); other errors\n\t\t\t// likewise swallowed because \"rendering never crashes the\n\t\t\t// stack\" (distilled/21-tui § Invariants).\n\t\t\tvoid err;\n\t\t}\n\t});\n"],"mappings":"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"}
+{"version":3,"file":"plain-renderer.mjs","names":[],"sources":["../../../src/surfaces/tui/plain-renderer.ts"],"sourcesContent":["// Plain (non-TTY) renderer.\n//\n// Architecture §11 + distilled/21-tui §Renderers: when stdout is not\n// a TTY (CI, pipe, log file), the live ink dashboard is replaced by\n// a structured line stream. One line per event; periodic heartbeat\n// per internally-acquiring row, surfaced to operators as \"starting\".\n//\n// Discipline:\n//   - One line per EngineEvent — no batching, no aggregation, no\n//     diffing. Each event maps to exactly one structured line.\n//   - Writes to stderr (architecture invariant: plain renderer goes\n//     to stderr so stdout stays clean for whatever consumes the\n//     pipe).\n//   - EPIPE swallowed (pipe-safety invariant).\n//   - Pure formatting helpers exposed for tests; the Effect-shaped\n//     side is the `mount` function.\n//   - Heartbeat formatting is pure here; scheduling belongs to the\n//     renderer mount path. The architecture says it\n//     \"anchors on first sighting in the internal acquiring state; phase\n//     changes do NOT reset the clock; a late tick emits exactly one\n//     heartbeat (no backlog catch-up)\". The seam is exposed via\n//     `formatHeartbeat`.\n\nimport { Effect, Schema, Stream, SubscriptionRef } from 'effect';\n\nimport type { Renderer } from '../../contracts/renderer.ts';\nimport type { EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport {\n\tAccountProjectionSchema,\n\tPackageProjectionSchema,\n} from '../../substrate/runtime/projection/persisted.ts';\nimport {\n\taccountLine,\n\tendpointLine,\n\tlabelForRow,\n\tnarrationFor,\n\tpackageLine,\n\troleLabel,\n\tstatusLabel,\n} from './display-derivation.ts';\nimport { mountFailed } from './errors.ts';\nimport { eventAt } from '../../substrate/event-time.ts';\n\n// -----------------------------------------------------------------------------\n// Line shape — pure formatters\n// -----------------------------------------------------------------------------\n\n/**\n * Plain-renderer line shape (each call returns exactly one line, no\n * trailing newline).\n *\n *   <iso-timestamp> <level> <event-tag> <key>=<value> ...\n *\n * Example:\n *   2026-05-19T20:11:32.001Z INFO lifecycle.statusChanged key=sui from=starting to=ready\n *   2026-05-19T20:11:32.500Z WARN log.appended key=walrus line=\"failed to bind port 9000\"\n *   2026-05-19T20:11:33.000Z INFO endpoint.registered name=aggregator url=http://localhost:9000\n */\nexport const formatEventLine = (event: EngineEvent): string => {\n\tconst ts = isoTimestamp(eventAt(event));\n\tconst level = levelForEvent(event);\n\tconst payload = payloadFor(event);\n\treturn `${ts} ${level} ${event.tag} ${payload}`;\n};\n\n/**\n * Heartbeat line for an in-flight internal acquiring row. Emitted by the\n * scheduler at architecture-blessed intervals; this function is the\n * pure formatter only.\n */\nexport const formatHeartbeat = (\n\tnow: number,\n\tkey: string,\n\tphase: string | null,\n\troleToken: string,\n): string => {\n\tconst ts = isoTimestamp(now);\n\tconst narration = narrationFor(phase, 'acquiring');\n\treturn `${ts} INFO heartbeat key=${key} role=${roleToken} narration=${quote(narration)}`;\n};\n\n// -----------------------------------------------------------------------------\n// Renderer implementation\n// -----------------------------------------------------------------------------\n\n/**\n * Build a plain renderer satisfying the `Renderer` contract.\n *\n * Mount subscribes to the live event stream, writes one line per\n * event to stderr. The state-ref is sampled for the initial sweep\n * (one line per declared row) so a renderer attached after boot\n * still sees a coherent baseline.\n */\nexport const makePlainRenderer = (): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst initial = yield* SubscriptionRef.get(stateRef);\n\t\t\tyield* emitInitialSweep(initial);\n\t\t\tyield* events.pipe(Stream.runForEach((event) => writeStderrLine(formatEventLine(event))));\n\t\t}).pipe(\n\t\t\tEffect.catch((cause: unknown) =>\n\t\t\t\tEffect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))),\n\t\t\t),\n\t\t),\n\tflush: Effect.void.pipe(Effect.catch(() => Effect.fail(mountFailed('flush')))),\n});\n\n// -----------------------------------------------------------------------------\n// Internals — formatting\n// -----------------------------------------------------------------------------\n\nconst isoTimestamp = (at: number): string => new Date(at || Date.now()).toISOString();\n\nconst levelForEvent = (event: EngineEvent): 'INFO' | 'WARN' | 'ERROR' => {\n\tswitch (event.tag) {\n\t\tcase 'log.appended':\n\t\t\treturn event.level === 'error' ? 'ERROR' : event.level === 'warn' ? 'WARN' : 'INFO';\n\t\tcase 'error.reported':\n\t\t\treturn event.error.severity === 'fatal' || event.error.severity === 'error'\n\t\t\t\t? 'ERROR'\n\t\t\t\t: 'WARN';\n\t\t// A broken orchestrator capability sink leaves the plugin `ready`\n\t\t// (non-fatal by design — see dispatch-contributions.ts), so this\n\t\t// is the operator's ONLY signal that e.g. RPC/wallet routing is\n\t\t// dead. It must not render as a routine INFO line.\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\treturn 'WARN';\n\t\tdefault:\n\t\t\treturn 'INFO';\n\t}\n};\n\nconst payloadFor = (event: EngineEvent): string => {\n\tswitch (event.tag) {\n\t\tcase 'lifecycle.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tfrom: statusLabel(event.from),\n\t\t\t\tto: statusLabel(event.to),\n\t\t\t});\n\t\tcase 'lifecycle.phaseSet':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tphase: event.phase ?? '',\n\t\t\t});\n\t\tcase 'log.appended':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tline: event.line,\n\t\t\t});\n\t\tcase 'endpoint.registered':\n\t\t\treturn kv({\n\t\t\t\tkey: event.endpoint.endpointKey,\n\t\t\t\tname: event.endpoint.name,\n\t\t\t\tdisplayUrl: event.endpoint.displayUrl ?? event.endpoint.url,\n\t\t\t\turl: event.endpoint.url,\n\t\t\t\twire: event.endpoint.wireProtocol,\n\t\t\t});\n\t\tcase 'projection.updated':\n\t\t\tif (event.kind === 'account') {\n\t\t\t\t// STYLE_GUIDE §19 — substrate-side `decodeUnknownSync` so a\n\t\t\t\t// malformed payload skips the line rather than rendering\n\t\t\t\t// garbage (`Schema.decodeUnknownSync(...) as A` bare-cast\n\t\t\t\t// is banned). The reducer at\n\t\t\t\t// `substrate/runtime/projection/update.ts` performs the\n\t\t\t\t// same decode; we repeat it here because the renderer\n\t\t\t\t// reads the raw event stream, not the reduced state slice.\n\t\t\t\tconst account = tryDecodeProjection(AccountProjectionSchema, event.payload);\n\t\t\t\tif (account === null) return kv({ kind: event.kind, key: event.key });\n\t\t\t\treturn kv({\n\t\t\t\t\tkey: account.key,\n\t\t\t\t\trow: account.rowKey ?? '',\n\t\t\t\t\tname: account.name,\n\t\t\t\t\taddress: account.address ?? '',\n\t\t\t\t\tscheme: account.scheme ?? '',\n\t\t\t\t\tsource: account.source ?? '',\n\t\t\t\t\tfunding: account.funding.status,\n\t\t\t\t\tfundingEntries: (account.funding.entries ?? [])\n\t\t\t\t\t\t.map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`)\n\t\t\t\t\t\t.join(','),\n\t\t\t\t\trequestedMist: account.funding.requestedMist ?? '',\n\t\t\t\t\tbalanceMist: account.funding.balanceMist ?? '',\n\t\t\t\t});\n\t\t\t}\n\t\t\tif (event.kind === 'package') {\n\t\t\t\tconst pkg = tryDecodeProjection(PackageProjectionSchema, event.payload);\n\t\t\t\tif (pkg === null) return kv({ kind: event.kind, key: event.key });\n\t\t\t\treturn kv({\n\t\t\t\t\tkey: pkg.key,\n\t\t\t\t\trow: pkg.rowKey ?? '',\n\t\t\t\t\tname: pkg.name,\n\t\t\t\t\tkind: pkg.kind,\n\t\t\t\t\tpackageId: pkg.packageId,\n\t\t\t\t\tupgradeCapId: pkg.upgradeCapId ?? '',\n\t\t\t\t\tmvr: pkg.mvrPlaceholder,\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn kv({ kind: event.kind, key: event.key });\n\t\tcase 'endpoint.released':\n\t\t\treturn kv({ key: event.endpointKey });\n\t\tcase 'strategy.registered':\n\t\t\treturn kv({\n\t\t\t\tcapability: event.capabilityKey,\n\t\t\t\tautoMounted: event.autoMounted,\n\t\t\t});\n\t\tcase 'strategy.unregistered':\n\t\t\treturn kv({ capability: event.capabilityKey });\n\t\tcase 'manifest.flushed':\n\t\t\treturn kv({ version: event.manifestVersion });\n\t\tcase 'codegen.emitted':\n\t\t\treturn kv({ files: event.files.length });\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tkind: event.kind,\n\t\t\t\t// `causeType` (the failing sink error's `_tag`, e.g.\n\t\t\t\t// `RouterBootFailed`) is the discriminator an operator scans\n\t\t\t\t// for to tell dead RPC routing from a codegen collision. `kv`\n\t\t\t\t// drops it when undefined, so untagged causes stay clean.\n\t\t\t\tcauseType: event.causeType ?? '',\n\t\t\t\tsummary: event.message,\n\t\t\t});\n\t\tcase 'error.reported':\n\t\t\treturn kv({\n\t\t\t\tkey: event.error.pluginKey ?? '',\n\t\t\t\ttag: event.error.tag,\n\t\t\t\tsummary: event.error.summary,\n\t\t\t\tcause: event.error.chain.join(' | '),\n\t\t\t\tseverity: event.error.severity,\n\t\t\t});\n\t\tcase 'build.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.entry.pluginKey ?? '',\n\t\t\t\tphase: event.entry.phase,\n\t\t\t\tprogress: event.entry.progress,\n\t\t\t});\n\t\tcase 'restart.requested':\n\t\tcase 'restart.completed':\n\t\t\treturn kv({\n\t\t\t\ttarget: event.target === 'stack' ? 'stack' : event.target.pluginKey,\n\t\t\t});\n\t\tcase 'shutdown.escalated':\n\t\t\treturn kv({\n\t\t\t\tmode: 'hard-kill',\n\t\t\t\tsignal: event.signal,\n\t\t\t\texitCode: event.exitCode,\n\t\t\t});\n\t\tcase 'snapshot.captureStarted':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name });\n\t\tcase 'snapshot.captureProgress':\n\t\t\treturn kv({\n\t\t\t\tsnapshotId: event.snapshotId,\n\t\t\t\tname: event.name,\n\t\t\t\tphase: event.phase,\n\t\t\t\tdetail: event.detail,\n\t\t\t\tpaused: event.pausedContainers,\n\t\t\t\ttotal: event.totalContainers,\n\t\t\t});\n\t\tcase 'snapshot.captureSkipped':\n\t\t\treturn kv({ reason: event.reason });\n\t\tcase 'snapshot.captureFailed':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name, summary: event.summary });\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\t\treturn kv({ snapshotId: event.snapshotId });\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nconst kv = (record: Readonly<Record<string, unknown>>): string =>\n\tObject.entries(record)\n\t\t.filter(([, v]) => v !== '' && v !== null && v !== undefined)\n\t\t.map(([k, v]) => `${k}=${quoteIfNeeded(String(v))}`)\n\t\t.join(' ');\n\n// Quote anything that contains whitespace, a `\"`, or an ASCII control\n// byte (`\\x00-\\x1f`). Control bytes are the load-bearing case: a\n// projection payload field that contains a stray `\\x1b` (ESC) would\n// otherwise inject an ANSI escape sequence into the plain-renderer's\n// stdout, corrupting subsequent terminal state for callers tailing\n// `--format plain` output.\nconst quoteIfNeeded = (s: string): string => (/[\\s\"\\x00-\\x1f]/.test(s) ? quote(s) : s);\n\nconst quote = (s: string): string => `\"${s.replace(/\"/g, '\\\\\"')}\"`;\n\n/**\n * Structural validate-then-narrow for `projection.updated` payloads\n * before they are formatted as text. Mirrors\n * `tryDecodeProjectionPayload` in the substrate reducer — returns\n * `null` on schema-decode failure so the renderer drops the slice\n * rather than printing fields off a malformed object. The substrate\n * reducer emits the `Effect.logWarning` for the same payload (the\n * decode is deterministic), so we stay silent here to avoid double\n * logging.\n */\nconst tryDecodeProjection = <S extends Schema.Decoder<unknown>>(\n\tschema: S,\n\tpayload: unknown,\n): S['Type'] | null => {\n\ttry {\n\t\treturn Schema.decodeUnknownSync(schema)(payload);\n\t} catch {\n\t\treturn null;\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Internals — initial sweep\n// -----------------------------------------------------------------------------\n\nconst emitInitialSweep = (state: SubscribableState): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeStderrLine(\n\t\t\t`${isoTimestamp(state.cycle.startedAt || Date.now())} INFO stack.identity app=${state.identity.app} stack=${state.identity.stack} network=${state.identity.network} cycle=${state.cycle.id}`,\n\t\t);\n\t\tfor (const row of state.rows) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(Date.now())} INFO row.declared ${kv({\n\t\t\t\t\tkey: row.key,\n\t\t\t\t\tlabel: labelForRow(row.key),\n\t\t\t\t\trole: roleLabel(row.role),\n\t\t\t\t\tstatus: statusLabel(row.status),\n\t\t\t\t})}`,\n\t\t\t);\n\t\t}\n\t\tfor (const endpoint of state.endpoints) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(endpoint.registeredAt)} INFO endpoint.registered ${endpointLine(endpoint)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const account of state.accounts) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(account.updatedAt)} INFO projection.updated[account] ${accountLine(account)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const pkg of state.packages) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(pkg.updatedAt)} INFO projection.updated[package] ${packageLine(pkg)}`,\n\t\t\t);\n\t\t}\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals — IO (pipe-safe)\n// -----------------------------------------------------------------------------\n\nconst writeStderrLine = (line: string): Effect.Effect<void> =>\n\tEffect.sync(() => {\n\t\ttry {\n\t\t\tprocess.stderr.write(`${line}\\n`);\n\t\t} catch (err) {\n\t\t\t// EPIPE swallowed (pipe-safety invariant); other errors\n\t\t\t// likewise swallowed because \"rendering never crashes the\n\t\t\t// stack\" (distilled/21-tui § Invariants).\n\t\t\tvoid err;\n\t\t}\n\t});\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten-incubation/devstack",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Next-generation Sui devstack package.",
   "keywords": [
     "sui",
@@ -11,7 +11,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/MystenLabs/ts-sdks-incubation.git",
+    "url": "https://github.com/MystenLabs/ts-sdks-incubation",
     "directory": "packages/devstack"
   },
   "homepage": "https://github.com/MystenLabs/ts-sdks-incubation/tree/main/packages/devstack#readme",
@@ -41,15 +41,25 @@
       "types": "./dist/build-integrations/playwright/index.d.mts",
       "import": "./dist/build-integrations/playwright/index.mjs"
     },
+    "./vite": {
+      "types": "./dist/build-integrations/vite/index.d.mts",
+      "import": "./dist/build-integrations/vite/index.mjs"
+    },
+    "./playwright/global-setup": {
+      "types": "./dist/build-integrations/playwright/global-setup.d.mts",
+      "import": "./dist/build-integrations/playwright/global-setup.mjs",
+      "default": "./dist/build-integrations/playwright/global-setup.mjs"
+    },
     "./runtime": {
       "types": "./dist/build-integrations/runtime/index.d.mts",
       "import": "./dist/build-integrations/runtime/index.mjs"
     }
   },
-  "sideEffects": false,
+  "sideEffects": true,
   "files": [
     "dist",
     "images",
+    "dashboard-ui",
     "!dist/samples",
     "!dist/node_modules"
   ],
@@ -61,13 +71,22 @@
     "@mysten/codegen": "^0.10.4",
     "@mysten/deepbook-v3": "^1.3.3",
     "@mysten/sui": "^2.17.0",
+    "@pothos/core": "^4.3.0",
+    "@pothos/plugin-relay": "^4.4.0",
+    "@pothos/plugin-simple-objects": "^4.1.0",
+    "@pothos/plugin-with-input": "^4.1.0",
     "@stricli/core": "^1.2.7",
     "effect": "4.0.0-beta.65",
+    "graphql": "^16.11.0",
+    "graphql-yoga": "^5.10.4",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },
   "devDependencies": {
     "@effect/vitest": "4.0.0-beta.65",
+    "@mysten/seal": "^1.1.1",
+    "@mysten/walrus": "^1.1.7",
+    "@mysten/walrus-wasm": "^0.2.0",
     "@types/node": "^24.12.2",
     "@types/react": "^19.2.14",
     "ink-testing-library": "^4.0.0",
@@ -85,7 +104,8 @@
     }
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "pnpm run build:dashboard-ui && tsdown",
+    "build:dashboard-ui": "node scripts/build-dashboard-ui.mjs",
     "smoke:pack-consumer": "node scripts/packed-consumer-typecheck.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/dist/contracts/liveness-classifier.d.mts

@@ -1,19 +0,0 @@
-import { Effect } from "effect";
-
-//#region src/contracts/liveness-classifier.d.ts
-type LivenessClassification = 'alive' | 'dormant' | 'stale' | 'abandoned';
-/** Per-entry hints persisted in `~/.devstack/registry.json`. The L3
- *  orchestrator passes them to the plugin's classifier. */
-interface LivenessHints {
-  readonly heartbeatAt: number | null;
-  readonly claimPid: number | null;
-  readonly claimStartTime: number | null;
-  readonly pluginHints: Readonly<Record<string, unknown>>;
-}
-interface LivenessClassifierDecl {
-  readonly kind: 'liveness-classifier';
-  readonly classify: (hints: LivenessHints) => Effect.Effect<LivenessClassification>;
-}
-//#endregion
-export { LivenessClassification, LivenessClassifierDecl, LivenessHints };
-//# sourceMappingURL=liveness-classifier.d.mts.map

package/dist/contracts/network-resolver.d.mts

@@ -1,15 +0,0 @@
-import { Effect } from "effect";
-
-//#region src/contracts/network-resolver.d.ts
-/** The funds-ready strategy shape. A trivially-succeeding default
- *  is registered when no contributor is present (e.g. live mode). */
-interface FundsReadyStrategy {
-  readonly waitFundsReady: Effect.Effect<void, FundsReadyError>;
-}
-interface FundsReadyError {
-  readonly _tag: 'FundsReadyError';
-  readonly reason: string;
-}
-//#endregion
-export { FundsReadyError, FundsReadyStrategy };
-//# sourceMappingURL=network-resolver.d.mts.map

package/dist/contracts/network-resolver.mjs

@@ -1,7 +0,0 @@
-//#region src/contracts/network-resolver.ts
-/** Capability-key constant for the funds-ready gate strategy. */
-const FUNDS_READY_GATE_KEY = "gate:funds-ready";
-//#endregion
-export { FUNDS_READY_GATE_KEY };
-
-//# sourceMappingURL=network-resolver.mjs.map

package/dist/contracts/network-resolver.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-resolver.mjs","names":[],"sources":["../../src/contracts/network-resolver.ts"],"sourcesContent":["// NetworkResolver capability contract (architecture §5).\n//\n// Provides one consistent answer to \"what network am I on?\" for\n// every plugin. The resolver is consulted once per acquire; the\n// answer is threaded as Context.\n//\n// Funds-ready is NOT engine-generic. It's a typed StrategyContributor\n// capability key (`gate:funds-ready`); plugins that need to wait on\n// funds read from the strategy registry. Architecture explicitly\n// removed the previous \"L0 exposes awaitFunds\" wording.\n\nimport type { Effect } from 'effect';\n\nimport type { NetworkConfig } from '../substrate/network.ts';\n\n/** Capability-key constant for the funds-ready gate strategy. */\nexport const FUNDS_READY_GATE_KEY = 'gate:funds-ready' as const;\n\n/** The funds-ready strategy shape. A trivially-succeeding default\n *  is registered when no contributor is present (e.g. live mode). */\nexport interface FundsReadyStrategy {\n\treadonly waitFundsReady: Effect.Effect<void, FundsReadyError>;\n}\n\nexport interface FundsReadyError {\n\treadonly _tag: 'FundsReadyError';\n\treadonly reason: string;\n}\n\n/**\n * The substrate-facing resolver service. One resolution per\n * acquire; CLI > env > config > default precedence.\n */\nexport interface NetworkResolver {\n\treadonly resolve: Effect.Effect<NetworkConfig, NetworkResolutionError>;\n}\n\nexport interface NetworkResolutionError {\n\treadonly _tag: 'NetworkResolutionError';\n\treadonly reason: 'invalid-mode' | 'unknown-chain' | 'rpc-unreachable';\n\treadonly detail: string;\n}\n"],"mappings":";;AAgBA,MAAa,uBAAuB"}

package/dist/orchestrators/codegen/extras.mjs

@@ -1,16 +0,0 @@
-import { Effect } from "effect";
-//#region src/orchestrators/codegen/extras.ts
-const makeExtrasCodegenable = (extras) => ({
-	kind: "codegenable",
-	emitterName: "app-extras",
-	outputPath: "extras.ts",
-	sensitive: true,
-	emit: (ctx) => Effect.sync(() => {
-		ctx.exportConst("extras", extras);
-		return ctx.done();
-	})
-});
-//#endregion
-export { makeExtrasCodegenable };
-
-//# sourceMappingURL=extras.mjs.map

package/dist/orchestrators/codegen/extras.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"extras.mjs","names":[],"sources":["../../../src/orchestrators/codegen/extras.ts"],"sourcesContent":["import { Effect } from 'effect';\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { ManifestExtras } from '../../substrate/manifest.ts';\n\nexport const makeExtrasCodegenable = (extras: ManifestExtras): CodegenableDecl<'app-extras'> => ({\n\tkind: 'codegenable',\n\temitterName: 'app-extras',\n\toutputPath: 'extras.ts',\n\tsensitive: true,\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\tctx.exportConst('extras', extras);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n"],"mappings":";;AAKA,MAAa,yBAAyB,YAA2D;CAChG,MAAM;CACN,aAAa;CACb,YAAY;CACZ,WAAW;CACX,OAAO,QACN,OAAO,WAAW;AACjB,MAAI,YAAY,UAAU,OAAO;AACjC,SAAO,IAAI,MAAM;GAChB;CACH"}

package/dist/plugins/deepbook/routable.mjs

@@ -1,21 +0,0 @@
-const DEEPBOOK_ENTRYPOINTS = [
-	{
-		name: "deepbook-server",
-		port: 9008,
-		protocol: "http"
-	},
-	{
-		name: "deepbook-server-metrics",
-		port: 9186,
-		protocol: "http"
-	},
-	{
-		name: "deepbook-indexer-metrics",
-		port: 9184,
-		protocol: "http"
-	}
-];
-//#endregion
-export { DEEPBOOK_ENTRYPOINTS };
-
-//# sourceMappingURL=routable.mjs.map

package/dist/plugins/deepbook/routable.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/deepbook/routable.ts"],"sourcesContent":["// Deepbook plugin — Routable contributions.\n//\n// Two optional endpoints in local mode:\n//\n//   - `deepbook-server`  — Rust REST server (port 9008). HTTP, CORS.\n//   - `deepbook-indexer` — Postgres-writing indexer (no HTTP), only\n//                          the Prometheus scrape endpoint surfaces;\n//                          we don't route it through Traefik today.\n//\n// Substrate's router mints hostnames from `(app, stack, dispatch-id)`\n// — no service hostnames hardcoded in router code.\n\nimport type { DispatchId, EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\n\nexport const DEEPBOOK_SERVER_ENDPOINT_NAME = 'deepbook-server' as const;\nexport const DEEPBOOK_SERVER_METRICS_ENDPOINT_NAME = 'deepbook-server-metrics' as const;\nexport const DEEPBOOK_INDEXER_METRICS_ENDPOINT_NAME = 'deepbook-indexer-metrics' as const;\nexport const DEEPBOOK_SERVER_ENTRYPOINT_PORT = 9008;\nexport const DEEPBOOK_SERVER_METRICS_ENTRYPOINT_PORT = 9186;\nexport const DEEPBOOK_INDEXER_METRICS_ENTRYPOINT_PORT = 9184;\n\nexport const DEEPBOOK_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t{ name: DEEPBOOK_SERVER_ENDPOINT_NAME, port: DEEPBOOK_SERVER_ENTRYPOINT_PORT, protocol: 'http' },\n\t{\n\t\tname: DEEPBOOK_SERVER_METRICS_ENDPOINT_NAME,\n\t\tport: DEEPBOOK_SERVER_METRICS_ENTRYPOINT_PORT,\n\t\tprotocol: 'http',\n\t},\n\t{\n\t\tname: DEEPBOOK_INDEXER_METRICS_ENDPOINT_NAME,\n\t\tport: DEEPBOOK_INDEXER_METRICS_ENTRYPOINT_PORT,\n\t\tprotocol: 'http',\n\t},\n];\n\nexport const buildServerDispatchId = (name: string): DispatchId => ({\n\tserviceKey: `deepbook:${name}`,\n\trole: 'server',\n});\n\nexport const makeServerRoutable = (inputs: {\n\treadonly name: string;\n\treadonly containerName: string;\n}): RoutableDecl => ({\n\tkind: 'routable',\n\tendpointName: DEEPBOOK_SERVER_ENDPOINT_NAME,\n\tdispatchId: buildServerDispatchId(inputs.name),\n\tupstream: {\n\t\ttype: 'container',\n\t\tcontainerName: inputs.containerName,\n\t\tcontainerPort: DEEPBOOK_SERVER_ENTRYPOINT_PORT,\n\t},\n\tcors: true,\n\twireProtocol: 'http',\n});\n"],"mappings":"AAqBA,MAAa,uBAAsD;CAClE;EAAE,MAAM;EAA+B,MAAM;EAAiC,UAAU;EAAQ;CAChG;EACC,MAAM;EACN,MAAM;EACN,UAAU;EACV;CACD;EACC,MAAM;EACN,MAAM;EACN,UAAU;EACV;CACD"}

package/dist/plugins/faucet/service.d.mts

@@ -1,20 +0,0 @@
-import { FaucetStrategy } from "./strategies/sui-local.mjs";
-import { Effect } from "effect";
-
-//#region src/plugins/faucet/service.d.ts
-/** A registered strategy contribution. The faucet plugin accepts
- *  these from the factory's options so callers can add per-chain
- *  faucets (custom fork admins, alt-network strategies) without
- *  authoring a sibling plugin. */
-interface FaucetStrategyContribution {
-  /** Capability-key chain id (`'sui:localnet'`, `'sui:testnet'`, etc.). */
-  readonly chainId: string;
-  /** The strategy value — closes over its own dependencies. */
-  readonly strategy: FaucetStrategy;
-  /** Optional priority. Defaults to `1` so user strategies win
-   *  over the built-in's `0`. */
-  readonly priority?: number;
-}
-//#endregion
-export { FaucetStrategyContribution };
-//# sourceMappingURL=service.d.mts.map

package/dist/plugins/faucet/strategies/sui-local.d.mts

@@ -1,23 +0,0 @@
-import { FaucetBodyError, FaucetExhausted, FaucetUnreachable } from "../errors.mjs";
-import { Effect } from "effect";
-
-//#region src/plugins/faucet/strategies/sui-local.d.ts
-/**
- * Faucet strategy value. The dispatch surface is uniform across
- * strategies — the dispatcher doesn't know how a strategy delivers
- * coins, only how to invoke it.
- *
- * `amount` is in MIST (1 SUI = 10^9 MIST), the chain's smallest unit.
- * The local faucet binary itself ignores this and grants a fixed
- * amount per request; the parameter is here for type uniformity and
- * to land correctly-denominated values in `FaucetExhausted`.
- */
-interface FaucetStrategy {
-  readonly request: (req: {
-    readonly address: string;
-    readonly amount: bigint;
-  }) => Effect.Effect<void, FaucetExhausted | FaucetUnreachable | FaucetBodyError>;
-}
-//#endregion
-export { FaucetStrategy };
-//# sourceMappingURL=sui-local.d.mts.map

package/dist/plugins/faucet/strategies/sui-local.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sui-local.mjs","names":[],"sources":["../../../../src/plugins/faucet/strategies/sui-local.ts"],"sourcesContent":["// SUI local-faucet HTTP strategy.\n//\n// Wraps the in-stack `sui-faucet` HTTP server hosted by the local\n// (or external) Sui container. The faucet URL comes from Sui's\n// resolver (`ResolvedSuiNetwork.faucet`) at acquire time; the\n// strategy CLOSES OVER the URL at construction, so the dispatch\n// site never sees Sui context.\n//\n// Amount semantics: the local faucet returns a fixed-amount grant\n// per request (the binary doesn't honor a variable amount today).\n// We carry `amount` through to error payloads so exhaustion errors\n// match the strategy-native unit (MIST), but the wire request\n// itself does not include it.\n//\n// Distilled-doc opportunity #1 (`Generalize the strategy-registry\n// pattern`): this file is the canonical small example. The whole\n// strategy is 30-ish lines because everything wire-level lives in\n// the shared `http.ts` helper.\n\nimport { Effect } from 'effect';\n\nimport { leaseKey, type LeaseBroker } from '../../../substrate/runtime/lease-broker/index.ts';\nimport { requestFundsWithRetry, type RetryOptions } from '../http.ts';\nimport type { FaucetBodyError, FaucetExhausted, FaucetUnreachable } from '../errors.ts';\n\n/** Optional serialization for faucet backends that spend a shared funding coin. */\nexport interface SuiLocalFaucetSerialization {\n\t/** Stack-local broker; callers choose the resource key shape. */\n\treadonly broker: LeaseBroker;\n\t/** Opaque lease key, typically scoped by chain id. */\n\treadonly key: string;\n\t/** Diagnostic owner reported by the lease broker. */\n\treadonly owner: string;\n}\n\n/** Per-strategy options. */\nexport interface SuiLocalStrategyOptions {\n\t/** Faucet base URL — e.g. `http://localhost:9123`. The strategy\n\t *  appends `/v2/gas` internally. */\n\treadonly faucetUrl: string;\n\t/** Wall-clock budget; forwarded to `requestFundsWithRetry`. */\n\treadonly timeoutMs?: number;\n\t/** Max retry attempts; forwarded to `requestFundsWithRetry`. */\n\treadonly maxAttempts?: number;\n\t/** Serialize requests when the faucet backend shares one funding coin. */\n\treadonly serialization?: SuiLocalFaucetSerialization;\n}\n\n/**\n * Faucet strategy value. The dispatch surface is uniform across\n * strategies — the dispatcher doesn't know how a strategy delivers\n * coins, only how to invoke it.\n *\n * `amount` is in MIST (1 SUI = 10^9 MIST), the chain's smallest unit.\n * The local faucet binary itself ignores this and grants a fixed\n * amount per request; the parameter is here for type uniformity and\n * to land correctly-denominated values in `FaucetExhausted`.\n */\nexport interface FaucetStrategy {\n\treadonly request: (req: {\n\t\treadonly address: string;\n\t\treadonly amount: bigint;\n\t}) => Effect.Effect<void, FaucetExhausted | FaucetUnreachable | FaucetBodyError>;\n}\n\nconst withSerialization = <E>(\n\tserialization: SuiLocalFaucetSerialization | undefined,\n\teffect: Effect.Effect<void, E>,\n): Effect.Effect<void, E> => {\n\tif (serialization === undefined) {\n\t\treturn effect;\n\t}\n\treturn Effect.scoped(\n\t\tEffect.gen(function* () {\n\t\t\tyield* serialization.broker.acquire(leaseKey(serialization.key), serialization.owner);\n\t\t\tyield* effect;\n\t\t}),\n\t).pipe(\n\t\tEffect.withSpan('faucet.suiLocal.serializedRequest', {\n\t\t\tattributes: {\n\t\t\t\t'faucet.lease.key': serialization.key,\n\t\t\t\t'faucet.lease.owner': serialization.owner,\n\t\t\t},\n\t\t}),\n\t);\n};\n\n/** Build a SUI local-faucet HTTP strategy. */\nexport const suiLocalStrategy = (opts: SuiLocalStrategyOptions): FaucetStrategy => ({\n\trequest: ({ address, amount }) => {\n\t\tconst retryOpts: RetryOptions = {\n\t\t\tfaucetUrl: opts.faucetUrl,\n\t\t\taddress,\n\t\t\tamount,\n\t\t\t...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),\n\t\t\t...(opts.maxAttempts !== undefined ? { maxAttempts: opts.maxAttempts } : {}),\n\t\t};\n\t\treturn withSerialization(opts.serialization, requestFundsWithRetry(retryOpts));\n\t},\n});\n"],"mappings":";;;;AAiEA,MAAM,qBACL,eACA,WAC4B;AAC5B,KAAI,kBAAkB,KAAA,EACrB,QAAO;AAER,QAAO,OAAO,OACb,OAAO,IAAI,aAAa;AACvB,SAAO,cAAc,OAAO,QAAQ,SAAS,cAAc,IAAI,EAAE,cAAc,MAAM;AACrF,SAAO;GACN,CACF,CAAC,KACD,OAAO,SAAS,qCAAqC,EACpD,YAAY;EACX,oBAAoB,cAAc;EAClC,sBAAsB,cAAc;EACpC,EACD,CAAC,CACF;;;AAIF,MAAa,oBAAoB,UAAmD,EACnF,UAAU,EAAE,SAAS,aAAa;CACjC,MAAM,YAA0B;EAC/B,WAAW,KAAK;EAChB;EACA;EACA,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,WAAW,GAAG,EAAE;EACrE,GAAI,KAAK,gBAAgB,KAAA,IAAY,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;EAC3E;AACD,QAAO,kBAAkB,KAAK,eAAe,sBAAsB,UAAU,CAAC;GAE/E"}

package/dist/plugins/sui/seed-objects.d.mts

@@ -1,18 +0,0 @@
-import { Effect } from "effect";
-
-//#region src/plugins/sui/seed-objects.d.ts
-/** Plugin-instance-scoped accumulator. Constructed inside the
- *  Sui plugin's `acquire` body; the lifetime is the plugin's scope. */
-interface SeedObjectsAccumulator {
-  /** Merge a set of seed object ids. KnownPackage declarations
-   *  call this during their own acquire — Sui's fork builder
-   *  reads the accumulated set AFTER scheduler ordering puts
-   *  KnownPackage upstream of the fork container. */
-  readonly contribute: (objects: ReadonlyArray<string>) => Effect.Effect<void>;
-  /** Snapshot the accumulated set. Called by fork's acquire when
-   *  composing the `--object` seed flags. */
-  readonly snapshot: Effect.Effect<ReadonlyArray<string>>;
-}
-//#endregion
-export { SeedObjectsAccumulator };
-//# sourceMappingURL=seed-objects.d.mts.map

package/dist/plugins/sui/seed-objects.mjs

@@ -1,25 +0,0 @@
-import { Effect, Ref } from "effect";
-//#region src/plugins/sui/seed-objects.ts
-/** Capability key the StrategyContributor registry dispatches on.
-*  KnownPackage declarations look this up; Sui's fork mode
-*  contributes it from inside acquire. */
-const SEED_OBJECTS_CAPABILITY_KEY = "sui:seed-objects";
-/** Construct a fresh accumulator. Each Sui plugin instance gets
-*  one — the substrate's scope-boundary handles isolation across
-*  parallel stacks. */
-const makeSeedObjectsAccumulator = () => Effect.gen(function* () {
-	const ref = yield* Ref.make([]);
-	const contribute = (objects) => Ref.update(ref, (prev) => {
-		const set = new Set(prev);
-		for (const o of objects) set.add(o.toLowerCase());
-		return Array.from(set).sort();
-	});
-	return {
-		contribute,
-		snapshot: Ref.get(ref)
-	};
-});
-//#endregion
-export { SEED_OBJECTS_CAPABILITY_KEY, makeSeedObjectsAccumulator };
-
-//# sourceMappingURL=seed-objects.mjs.map

package/dist/plugins/sui/seed-objects.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"seed-objects.mjs","names":[],"sources":["../../../src/plugins/sui/seed-objects.ts"],"sourcesContent":["// Fork-mode seed-objects accumulator.\n//\n// Distilled-doc finding (5-sui § Opportunities): today's code uses\n// a module-scope `Set<string>` with an explicit\n// `clearKnownPackageSeedObjects()` contract between composes. That\n// is a foot-gun — tests that compose more than once must remember\n// to clear; the responsibility sits with the user, not the\n// framework.\n//\n// Fix: confine the accumulator to plugin-instance state. Each\n// `sui()` factory call constructs a fresh `SeedObjectsAccumulator`\n// inside its acquire body's scope; KnownPackage declarations\n// elsewhere in the stack discover it via the StrategyContributor\n// registry (`sui:seed-objects`).\n//\n// The substrate-redesign substrate-violations document already\n// flags module-scope mutable state as forbidden; this file is the\n// implementation of the cure.\n\nimport { Effect, Ref } from 'effect';\n\n/** Plugin-instance-scoped accumulator. Constructed inside the\n *  Sui plugin's `acquire` body; the lifetime is the plugin's scope. */\nexport interface SeedObjectsAccumulator {\n\t/** Merge a set of seed object ids. KnownPackage declarations\n\t *  call this during their own acquire — Sui's fork builder\n\t *  reads the accumulated set AFTER scheduler ordering puts\n\t *  KnownPackage upstream of the fork container. */\n\treadonly contribute: (objects: ReadonlyArray<string>) => Effect.Effect<void>;\n\t/** Snapshot the accumulated set. Called by fork's acquire when\n\t *  composing the `--object` seed flags. */\n\treadonly snapshot: Effect.Effect<ReadonlyArray<string>>;\n}\n\n/** Capability key the StrategyContributor registry dispatches on.\n *  KnownPackage declarations look this up; Sui's fork mode\n *  contributes it from inside acquire. */\nexport const SEED_OBJECTS_CAPABILITY_KEY = 'sui:seed-objects' as const;\n\n/** Construct a fresh accumulator. Each Sui plugin instance gets\n *  one — the substrate's scope-boundary handles isolation across\n *  parallel stacks. */\nexport const makeSeedObjectsAccumulator = (): Effect.Effect<SeedObjectsAccumulator> =>\n\tEffect.gen(function* () {\n\t\tconst ref = yield* Ref.make<ReadonlyArray<string>>([]);\n\n\t\tconst contribute = (objects: ReadonlyArray<string>): Effect.Effect<void> =>\n\t\t\tRef.update(ref, (prev) => {\n\t\t\t\t// Stable union — sorted + lowercased so the configHash\n\t\t\t\t// is invariant under contribution order (architecture\n\t\t\t\t// § sui § Invariants).\n\t\t\t\tconst set = new Set(prev);\n\t\t\t\tfor (const o of objects) set.add(o.toLowerCase());\n\t\t\t\treturn Array.from(set).sort();\n\t\t\t});\n\n\t\tconst snapshot = Ref.get(ref);\n\n\t\treturn { contribute, snapshot };\n\t});\n"],"mappings":";;;;;AAqCA,MAAa,8BAA8B;;;;AAK3C,MAAa,mCACZ,OAAO,IAAI,aAAa;CACvB,MAAM,MAAM,OAAO,IAAI,KAA4B,EAAE,CAAC;CAEtD,MAAM,cAAc,YACnB,IAAI,OAAO,MAAM,SAAS;EAIzB,MAAM,MAAM,IAAI,IAAI,KAAK;AACzB,OAAK,MAAM,KAAK,QAAS,KAAI,IAAI,EAAE,aAAa,CAAC;AACjD,SAAO,MAAM,KAAK,IAAI,CAAC,MAAM;GAC5B;AAIH,QAAO;EAAE;EAAY,UAFJ,IAAI,IAAI,IAEI;EAAE;EAC9B"}

package/dist/runtime/built-in-plugin-layers.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"built-in-plugin-layers.mjs","names":[],"sources":["../../src/runtime/built-in-plugin-layers.ts"],"sourcesContent":["// Built-in plugin runtime composition.\n//\n// L0 substrate builds only name-blind services. This module is the higher-level\n// composition point for built-in plugin services and built-in capability sinks.\n\nimport { Context, Effect, Layer } from 'effect';\n\nimport { discoverCoinsFromPublish } from '../plugins/coin/discovery.ts';\nimport {\n\tCoinRegistryService,\n\tcoinRegistryLayer,\n\ttype CoinRecord,\n} from '../plugins/coin/registry.ts';\nimport {\n\tLOCAL_PACKAGE_PUBLISHED_KIND,\n\ttype LocalPackagePublishedDecl,\n} from '../plugins/package/publish-output.ts';\nimport { PackageRegistryService, layerPackageRegistry } from '../plugins/package/registry.ts';\nimport {\n\tCapabilitySinksService,\n\tlayerCapabilitySinksDefault,\n\ttype CapabilitySink,\n\ttype OrchestratorSinks,\n} from '../substrate/runtime/capability-sinks/index.ts';\n\nexport const layerBuiltInPluginServices: Layer.Layer<CoinRegistryService | PackageRegistryService> =\n\tLayer.mergeAll(coinRegistryLayer, layerPackageRegistry);\n\nconst publishResultSink = (\n\tcoinRegistry: typeof CoinRegistryService.Service,\n): CapabilitySink<typeof LOCAL_PACKAGE_PUBLISHED_KIND, LocalPackagePublishedDecl> => ({\n\tkind: LOCAL_PACKAGE_PUBLISHED_KIND,\n\taccept: (decl) =>\n\t\tEffect.gen(function* () {\n\t\t\tfor (const discovered of discoverCoinsFromPublish(decl.output)) {\n\t\t\t\tconst record: CoinRecord = {\n\t\t\t\t\tkey: (discovered.symbol ?? discovered.witness).toLowerCase(),\n\t\t\t\t\ttype: discovered.fullCoinType,\n\t\t\t\t\twitness: discovered.witness,\n\t\t\t\t\tmoduleName: discovered.moduleName,\n\t\t\t\t\tdecimals: discovered.decimals ?? 0,\n\t\t\t\t\t...(discovered.symbol === undefined ? {} : { symbol: discovered.symbol }),\n\t\t\t\t\t...(discovered.displayName === undefined ? {} : { displayName: discovered.displayName }),\n\t\t\t\t\t...(discovered.iconUrl === undefined ? {} : { iconUrl: discovered.iconUrl }),\n\t\t\t\t\t...(!discovered.publisherOwnsCap || discovered.treasuryCapId === undefined\n\t\t\t\t\t\t? {}\n\t\t\t\t\t\t: { treasuryCapId: discovered.treasuryCapId }),\n\t\t\t\t\t...(discovered.metadataId === undefined ? {} : { metadataId: discovered.metadataId }),\n\t\t\t\t\tpackageId: decl.packageId,\n\t\t\t\t\tpublishingPackageName: decl.packageName,\n\t\t\t\t};\n\t\t\t\tyield* coinRegistry.register(record);\n\t\t\t}\n\t\t}),\n});\n\nexport const layerBuiltInCapabilitySinks = (\n\torchestrator: OrchestratorSinks,\n): Layer.Layer<CapabilitySinksService, never, CoinRegistryService | PackageRegistryService> => {\n\tconst registerBuiltInPluginSinks = Layer.effectDiscard(\n\t\tEffect.gen(function* () {\n\t\t\tconst sinks = yield* CapabilitySinksService;\n\t\t\tconst coinRegistry = yield* CoinRegistryService;\n\t\t\tyield* sinks.registerSink(publishResultSink(coinRegistry));\n\t\t}),\n\t);\n\treturn registerBuiltInPluginSinks.pipe(\n\t\tLayer.provideMerge(layerCapabilitySinksDefault(orchestrator)),\n\t);\n};\n\nexport const layerBuiltInPluginRuntime = (\n\torchestrator: OrchestratorSinks,\n): Layer.Layer<CoinRegistryService | PackageRegistryService | CapabilitySinksService> =>\n\tlayerBuiltInCapabilitySinks(orchestrator).pipe(Layer.provideMerge(layerBuiltInPluginServices));\n\nexport const extendBuiltInPluginContext = (\n\tctx: Context.Context<never>,\n): Effect.Effect<\n\tContext.Context<never>,\n\tnever,\n\tCoinRegistryService | PackageRegistryService | CapabilitySinksService\n> =>\n\tEffect.gen(function* () {\n\t\tconst coinRegistry = yield* CoinRegistryService;\n\t\tconst packageRegistry = yield* PackageRegistryService;\n\t\tconst capabilitySinks = yield* CapabilitySinksService;\n\t\treturn ctx.pipe(\n\t\t\tContext.add(CoinRegistryService, coinRegistry),\n\t\t\tContext.add(PackageRegistryService, packageRegistry),\n\t\t\tContext.add(CapabilitySinksService, capabilitySinks),\n\t\t) as Context.Context<never>;\n\t});\n"],"mappings":";;;;;;;;AAyBA,MAAa,6BACZ,MAAM,SAAS,mBAAmB,qBAAqB;AAExD,MAAM,qBACL,kBACqF;CACrF,MAAM;CACN,SAAS,SACR,OAAO,IAAI,aAAa;AACvB,OAAK,MAAM,cAAc,yBAAyB,KAAK,OAAO,EAAE;GAC/D,MAAM,SAAqB;IAC1B,MAAM,WAAW,UAAU,WAAW,SAAS,aAAa;IAC5D,MAAM,WAAW;IACjB,SAAS,WAAW;IACpB,YAAY,WAAW;IACvB,UAAU,WAAW,YAAY;IACjC,GAAI,WAAW,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,WAAW,QAAQ;IACxE,GAAI,WAAW,gBAAgB,KAAA,IAAY,EAAE,GAAG,EAAE,aAAa,WAAW,aAAa;IACvF,GAAI,WAAW,YAAY,KAAA,IAAY,EAAE,GAAG,EAAE,SAAS,WAAW,SAAS;IAC3E,GAAI,CAAC,WAAW,oBAAoB,WAAW,kBAAkB,KAAA,IAC9D,EAAE,GACF,EAAE,eAAe,WAAW,eAAe;IAC9C,GAAI,WAAW,eAAe,KAAA,IAAY,EAAE,GAAG,EAAE,YAAY,WAAW,YAAY;IACpF,WAAW,KAAK;IAChB,uBAAuB,KAAK;IAC5B;AACD,UAAO,aAAa,SAAS,OAAO;;GAEpC;CACH;AAED,MAAa,+BACZ,iBAC8F;AAQ9F,QAPmC,MAAM,cACxC,OAAO,IAAI,aAAa;EACvB,MAAM,QAAQ,OAAO;EACrB,MAAM,eAAe,OAAO;AAC5B,SAAO,MAAM,aAAa,kBAAkB,aAAa,CAAC;GACzD,CAE8B,CAAC,KACjC,MAAM,aAAa,4BAA4B,aAAa,CAAC,CAC7D;;AAGF,MAAa,6BACZ,iBAEA,4BAA4B,aAAa,CAAC,KAAK,MAAM,aAAa,2BAA2B,CAAC;AAE/F,MAAa,8BACZ,QAMA,OAAO,IAAI,aAAa;CACvB,MAAM,eAAe,OAAO;CAC5B,MAAM,kBAAkB,OAAO;CAC/B,MAAM,kBAAkB,OAAO;AAC/B,QAAO,IAAI,KACV,QAAQ,IAAI,qBAAqB,aAAa,EAC9C,QAAQ,IAAI,wBAAwB,gBAAgB,EACpD,QAAQ,IAAI,wBAAwB,gBAAgB,CACpD;EACA"}