@sebastianwessel/isostate 0.4.0 → 0.6.0

package/dist/animation/animation-engine.d.ts

@@ -1,5 +1,6 @@
 import type { AmbientAnimation, PrimitiveContent, RuntimeConnectorState, RuntimeConnectorStyle, RuntimeElementState, TextContent } from "../types/node.ts";
 import type { RuntimeBundle } from "../types/runtime-bundle.ts";
+/** Lifecycle transition key used to look up entry/exit animation keyframes. */
 export type LifecycleKey = "entering" | "present" | "exiting" | "removed";
 /** Interpolation result for a frame update. */
 export interface FrameUpdate {
@@ -14,6 +15,7 @@ export interface FrameUpdate {
     exit?: string;
     text?: TextContent;
     primitive?: PrimitiveContent;
+    activity?: RuntimeElementState["activity"];
 }
 /** Interpolation result for a connector frame update. */
 export interface ConnectorFrameUpdate {
@@ -25,6 +27,7 @@ export interface ConnectorFrameUpdate {
     start: RuntimeConnectorState["start"];
     end: RuntimeConnectorState["end"];
     direction: RuntimeConnectorState["direction"];
+    message?: RuntimeConnectorState["message"];
     ambient: AmbientAnimation[];
     entry?: string;
     exit?: string;

package/dist/animation/animation-engine.d.ts.map

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

package/dist/animation/controller.d.ts

@@ -2,11 +2,17 @@ import { type ViewBoxRect } from "../rendering/rendering-engine.ts";
 import type { CameraGridArea, CameraZoomOptions, RuntimeCameraTarget } from "../types/node.ts";
 import type { RuntimeBundle } from "../types/runtime-bundle.ts";
 import { AnimationEngine } from "./animation-engine.ts";
+/** Events emitted by `AnimationController.on()`. */
 export interface ControllerEvents {
+    /** Fired whenever resolved scroll/scene progress changes. */
     "progress-change": (progress: number) => void;
+    /** Fired when the active scene index changes. */
     "scene-change": (index: number) => void;
+    /** Fired after the camera viewBox or zoom target changes. */
     "camera-change": (state: CameraState) => void;
+    /** Fired when scroll-driven progress tracking is paused. */
     paused: () => void;
+    /** Fired when scroll-driven progress tracking resumes. */
     resumed: () => void;
 }
 type EventKey = keyof ControllerEvents;
@@ -15,25 +21,38 @@ export interface ControllerConfig {
     container?: HTMLElement;
     /** SVG scene updated by this controller. Defaults to the first SVG in `container` for direct controller usage. */
     sceneElement?: SVGSVGElement;
+    /** Scroll axis used to derive progress. Defaults to `vertical`. */
     scrollDirection?: "vertical" | "horizontal";
+    /** Extra scroll offsets, in pixels, applied when deriving progress from `container`. */
     scrollOffset?: {
         top?: number;
         bottom?: number;
         left?: number;
         right?: number;
     };
+    /** Minimum resolved progress. Defaults to `0`. */
     minProgress?: number;
+    /** Maximum resolved progress. Defaults to `1`. */
     maxProgress?: number;
+    /** Enable arrow-key scene navigation. Defaults to `false`. */
     keyboardControls?: boolean;
+    /** Enable touch swipe scene navigation. Defaults to `false`. */
     touchControls?: boolean;
+    /** Multiplier applied to wheel/touch scroll deltas. Defaults to `1.0`. */
     scrollSensitivity?: number;
+    /** Scene navigation and camera transition duration in milliseconds. Defaults to `600`. */
     transitionDuration?: number;
+    /** Scene navigation and camera transition easing curve. Defaults to `ease-in-out`. */
     transitionEasing?: "linear" | "ease-in-out" | "ease-out";
 }
 export type { CameraGridArea, CameraZoomOptions };
+/** Current camera viewBox and zoom target, as reported by `AnimationController.getCameraState()`. */
 export interface CameraState {
+    /** Current SVG viewBox. */
     viewBox: ViewBoxRect;
+    /** Focus target that produced the current viewBox, if any. */
     target?: RuntimeCameraTarget;
+    /** Whether the camera differs from the compiled full scene view. */
     isZoomed: boolean;
 }
 interface ControllerRuntime {
@@ -62,10 +81,11 @@ export declare class AnimationController {
     private _cameraState;
     private _minScroll;
     private _maxScroll;
-    private _touchStartY;
-    private _touchStartX;
+    private _lastTouchY;
+    private _lastTouchX;
     private _isDragging;
     private _transitionAnim;
+    private _backward;
     get engine(): AnimationEngine;
     get progress(): number;
     getProgress(): number;
@@ -82,6 +102,7 @@ export declare class AnimationController {
      * Set scroll progress (0–1, clamped) and trigger frame update.
      */
     setProgress(progress: number): void;
+    private _setProgress;
     /**
      * Navigate to next scene (wraps to 0 if at end).
      */
@@ -123,6 +144,19 @@ export declare class AnimationController {
     private _applyCameraForProgress;
     private _effectiveCameraAt;
     private _resolveCameraViewBox;
+    /**
+     * Resolve element bounds for scroll/setProgress camera interpolation.
+     *
+     * Unlike `getCurrentElementBounds()`, this tolerates an element whose
+     * resolved presence is transiently "removed" because progress has not yet
+     * reached the stop that introduces it (the engine still carries valid
+     * authored geometry for it via nearest-geometry fallback). It falls back to
+     * that geometry instead of reporting the target as missing so a scene that
+     * both adds an element and focuses the camera on it in the same stop can be
+     * interpolated into smoothly. A genuinely unknown element id still resolves
+     * to `undefined` so callers can throw `CAMERA_TARGET_NOT_FOUND`.
+     */
+    private _resolveElementBoundsForInterpolation;
     private _applyCameraDestination;
     private _setCameraViewBox;
     private _getSceneSvg;

package/dist/animation/controller.d.ts.map

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

package/dist/assets/software-architecture/IMAGEGEN-PROMPTS.md

@@ -0,0 +1,66 @@
+# Generation prompts
+
+Generated with the built-in ImageGen tool, using real transparent backgrounds.
+The original PNG bytes are preserved; sprite rectangles select each object.
+
+## Workflow and process sheet
+
+Use case: stylized-concept. Asset type: one production transparent PNG sprite-sheet for an isometric software architecture visualization library.
+Create ONE precisely aligned 4-column by 2-row sprite sheet, ideally 2048x1024 pixels, containing exactly eight separate high-end photorealistic 3D miniature objects, each centered inside its own equal SQUARE tile. Real transparent alpha background. All objects share the same orthographic isometric camera (30-degree elevation, view from front right), believable finely textured ceramic, anodized aluminium, dark graphite metal, smoked glass, polished translucent teal, small amber details, soft studio key light upper left, crisp optical rendering, realistic ambient occlusion and restrained tight contact shadow. Beautiful professional product render quality, physically modeled curves, bevels, material depth, precise details. Each fills roughly 75-85% of its tile without crossing any cell boundary. Common grounded footprint center lies at tile x50%, y85%, tiny elegant diamond-shaped graphite plinth. No scenery, no text, no numbers, no logos, no labels, no background plane or checkerboard, no borders, no long connection arrows. Must look richly three-dimensional and material-rich, not flat pictograms, simple blocks, SVG icons or cartoon illustrations.
+Exact row-major subjects:
+Top row col1 WORKFLOW START: polished teal illuminated circular activation device embedded in a finely machined metal console with tactile start button, luminous translucent rim.
+Top row col2 WORKFLOW END: matching graphite termination console with elegant amber status beacon and realistic brushed metal finish.
+Top row col3 WORKFLOW TASK: miniature mechanical processing station, stacked machined gears inside smoked-glass housing with teal indicators, credible tiny industrial mechanism.
+Top row col4 WORKFLOW DECISION: gorgeous optical routing device with tall faceted translucent teal diamond prism in metallic cradle, physical branching channels sculpted into base, no floating arrows.
+Bottom row col1 WORKFLOW EVENT: sophisticated small signal beacon, translucent amber pulse ring on black ceramic receiver, intricate metallic electronics.
+Bottom row col2 PROCESS APPROVAL: upright frosted-glass verification panel with one embossed teal check mark, elegant brass mechanical stamp mounted beside it on compact workstation.
+Bottom row col3 PROCESS DOCUMENT: realistic sculpted stack of cream paper sheets in a slim teal document tray, one folded-corner sheet rising, delicate page texture and brushed-metal clips.
+Bottom row col4 PROCESS SCHEDULER: finely machined analogue clock with ivory dial and amber hands mounted in compact graphite scheduling console, layered rounded metal housings, no readable typography.
+Keep every tile isolated and precisely aligned with identical composition scale. Export real transparency; transparent gaps around every object. Premium nearly photographic isometric renders for software workflows and business process diagrams.
+## Architecture sprite sheet
+
+Generated using the built-in image generation tool with `transparent_background: true`.
+The original PNG bytes are preserved. Dimensions: 1448 × 1086 pixels, RGBA.
+Each logical asset uses an explicit 350 × 350 source rectangle and a checked
+ground-contact anchor; generated row spacing is not assumed to be exact.
+
+```text
+Use case: stylized-concept.
+Asset type: reusable transparent PNG sprite sheet for professional software architecture diagrams.
+Create ONE image containing exactly twelve separate premium, nearly photorealistic miniature 3D objects arranged in a strict 4-column by 3-row grid. Prefer landscape 2048 by 1536 pixels so each cell is square. Equal cell sizes and consistent object scale, no cell borders, generous transparent gaps. Every object centered in its own cell, fully visible, no overlaps. Ground contact centered horizontally around 82 percent down its cell. Same orthographic isometric camera, 30-degree diamond ground axes, view from above, identical lighting from upper left.
+Art direction: extremely refined product visualization, machined satin graphite aluminum, porcelain white ceramic, translucent cyan glass, teal anodized accents, tiny warm amber status LEDs, bevels, realistic layered mechanical detail, physically believable reflections, soft ambient occlusion. Dimensional objects with volume and high material quality. Crisp silhouettes suitable for 128 pixel UI thumbnails. Calm elegant enterprise aesthetic. Soft tight contact shadow only, no background, no large platform.
+Exact row-major subjects:
+Row 1 col 1 browser client: premium freestanding thin workstation monitor with glossy glass browser window and subtle content blocks, no words.
+Row 1 col 2 API gateway: sculptural dimensional network gateway portal with graphite frame and cyan glass routing core.
+Row 1 col 3 application service: compact sophisticated compute appliance with layered modules, ventilation fins, cyan luminous internal core.
+Row 1 col 4 database: three stacked cylindrical brushed-metal data disks with translucent cyan inset rings, grounded heavy volume.
+Row 2 col 1 memory cache: square premium microchip with fine gold pins, dark ceramic body and raised cyan translucent crystal center.
+Row 2 col 2 message queue: three upright translucent cyan message-envelope plates arranged in a machined sequential channel, one amber envelope.
+Row 2 col 3 background worker: elegant small graphite-and-porcelain industrial robotic arm on base holding one cyan data cube.
+Row 2 col 4 load balancer: network routing appliance with one central port and three neatly symmetric short branch ports, cyan conduits and amber indicator.
+Row 3 col 1 object storage: open brushed-metal storage vault containing three glass data blocks, sturdy cyan lid trim.
+Row 3 col 2 cloud platform: thick beautifully rounded frosted white glass cloud object with subtle cyan translucency and graphite footing.
+Row 3 col 3 container: detailed miniature graphite modular shipping-style container with ribbed sides, cyan access door and tiny amber light.
+Row 3 col 4 observability: premium monitor showing a single cyan line chart, glass display and graphite instrument housing, no text.
+Transparent background with real alpha, no white backdrop and no checkerboard painted into the pixels. No labels, letters, numbers, logos, watermarks, connecting lines between cells, flat illustration, vector outlines, thick ink strokes, flat SVG appearance, emoji, toy plastic, people, repeated subjects.
+```
+
+
+## Agentic workflow extension
+
+Nine additional original RGBA PNG sheets cover 72 AI, human, channel, workflow,
+ServiceNow, provider, and infrastructure objects. Their exact built-in ImageGen
+prompts and inspected crop/anchor notes are preserved separately:
+
+- [Agent, capability, human, channel, and provider sheets](./agentic/AGENT-VISUAL-PROMPTS.md)
+- [Orchestration, lifecycle, ServiceNow, and infrastructure sheets](./agentic/PROCESS-VISUAL-PROMPTS.md)
+
+All outputs retain generated source bytes; scene and gallery crops are metadata,
+not edited image files. Provider identities are illustrated with original
+material/product metaphors and displayed labels rather than official logo assets.
+
+## Directional handoffs
+
+Two additional original RGBA PNGs distinguish human-to-AI delegation and
+AI-to-human escalation from the existing human-to-human handoff. Exact prompts
+and measured source dimensions are in [Directional handoff prompts](./agentic/HANDOFF-PROMPTS.md).

package/dist/assets/software-architecture/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sebastian Wessel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/assets/software-architecture/NOTICE.md

@@ -0,0 +1,17 @@
+# AI-generated asset notice
+
+The PNG illustrations in this catalog were generated using OpenAI
+image-generation models through the Codex Image Gen tool. Project prompts,
+source images, crop rectangles, anchors, and metadata record their provenance.
+
+The project distributes this catalog under the included [MIT licence](./LICENSE).
+The licence terms and required redistribution notice are in that file. This
+file records the artwork's AI origin.
+
+OpenAI's [Terms of Use](https://openai.com/policies/terms-of-use/) and
+[Europe Terms of Use](https://openai.com/policies/eu-terms-of-use/) describe
+ownership of generated output as between the user and OpenAI, subject to
+applicable law. Refer to the terms applicable to your use of their services.
+
+Generation prompts are included in [IMAGEGEN-PROMPTS.md](./IMAGEGEN-PROMPTS.md)
+and the `agentic/` prompt records.

package/dist/assets/software-architecture/README.md

@@ -0,0 +1,105 @@
+# Software architecture assets
+
+Ninety-four photorealistic isometric objects for software architecture, AI agents,
+human-to-agent workflow migration, and business processes. Brushed graphite metal, translucent cyan glass, teal
+accents, and warm amber lights give the objects a consistent dimensional style.
+The illustrations were AI-generated using OpenAI image-generation models.
+The catalog is distributed under the included MIT license; see
+[NOTICE.md](./NOTICE.md) for generation provenance and OpenAI terms links.
+
+## Catalog
+
+| Group | Logical identifier suffixes |
+| --- | --- |
+| `architecture-` | `browser`, `api-gateway`, `service`, `database`, `cache`, `queue`, `worker`, `load-balancer`, `storage`, `cloud`, `container`, `observability` |
+| `workflow-` | `start`, `end`, `task`, `decision`, `event` |
+| `process-` | `approval`, `document`, `scheduler` |
+| `ai-` | `agent`, `orchestrator`, `planner`, `researcher`, `tool-runner`, `reviewer`, `memory`, `knowledge`, `rag`, `embedding`, `vector-search`, `context`, `prompt`, `evaluation`, `guardrail`, `model-router` |
+| `human-` | `requester`, `operator`, `approver`, `expert`, `team`, `handoff`, `escalation`, `feedback` |
+| Directional handoffs | `human-to-ai-handoff`, `ai-to-human-handoff` |
+| `channel-` | `email`, `phone`, `teams`, `webform`, `chat`, `issue`, `document`, `webhook` |
+| `agent-` | `workflow`, `parallel`, `router`, `condition`, `loop`, `retry`, `timeout`, `error`, `trigger`, `schedule`, `await-human`, `approval`, `rejection`, `escalation`, `audit`, `complete` |
+| `servicenow-` | `interaction`, `request`, `requested-item`, `request-task`, `catalog-item`, `incident`, `problem`, `change` |
+| `provider-` | `azure-foundry`, `aws-bedrock`, `anthropic`, `openai`, `google-vertex`, `google-gemini`, `local-model`, `hugging-face` |
+| `infra-` | `redis-cache`, `redis-stream`, `redis-pubsub`, `vector-database`, `object-storage`, `knowledge-base`, `api-tool`, `secret-vault` |
+
+`architecture/architecture-sprites.png` contains twelve architecture objects in
+1448 × 1086 pixels. `workflow/workflow-process-sprites.png` contains eight
+workflow/process objects in 1774 × 887 pixels. Nine additional eight-object sheets live in `agentic/`: agents, AI capabilities,
+humans, intake channels, orchestration, lifecycle, ServiceNow, providers, and
+infrastructure. Two additional 1254 × 1254 PNGs show `human-to-ai-handoff`
+and `ai-to-human-handoff`, each exposed as one full-image sprite with a checked
+anchor. The existing `human-handoff` depicts a human-to-human exchange.
+All thirteen source PNGs preserve original generated bytes and actual transparency. Generation prompts are recorded in
+[IMAGEGEN-PROMPTS.md](./IMAGEGEN-PROMPTS.md),
+[agent visuals](./agentic/AGENT-VISUAL-PROMPTS.md), and
+[process visuals](./agentic/PROCESS-VISUAL-PROMPTS.md), and
+[directional handoffs](./agentic/HANDOFF-PROMPTS.md).
+
+Provider and product objects are conceptual illustrations rather than official
+vendor logos. Names and search tags identify their intended use. A ServiceNow
+record is distinct from the person or agent handling it; use separate assets,
+labels, and connections to make responsibility explicit.
+
+`.isostate-assets.yaml` supplies the exact whole-pixel crop rectangles, checked
+anchors, labels, and search tags. `manifest.json` is generated from this metadata
+and the PNG bytes. Architecture rectangles are 350 × 350 pixels with individual
+ground anchors; new agentic crops and anchors are measured per source sheet; workflow/process rectangles follow the source grid with explicit
+`[0.5, 0.9]` anchors. Do not infer crops from an evenly divided architecture grid:
+its generated rows have slightly different vertical spacing.
+
+## Use in a scene
+
+Copy this directory into the site's public assets directory. Declare the sheet
+once, then place its logical sprite ids through the existing sprite-sheet DSL:
+
+```yaml
+header:
+  assetBaseUrl: ./assets/software-architecture
+  assets:
+    - id: architecture-architecture-sprites
+      type: sprite-sheet
+      path: architecture/architecture-sprites.png
+      sheetSize: [1448, 1086]
+      sprites:
+        architecture-service:
+          rect: [730, 0, 350, 350]
+          anchor: [0.507, 0.931]
+        architecture-database:
+          rect: [1092, 0, 350, 350]
+          anchor: [0.511, 0.909]
+```
+
+Place `asset: architecture-service` using whole grid coordinates and the default
+`size: 1`. Copy the manifest's exact rectangles and anchors when adding more
+sprites. The sheet namespace itself is not placeable. Labels remain generated
+`text` elements and routes remain scene `connections`.
+
+For editor discovery, point `assetManifestUrl` at this directory's
+`manifest.json`. Its `assetBaseUrl: ./` resolves relative to the manifest URL.
+For a scene saved elsewhere, set `header.assetBaseUrl` to the directory where
+the images are actually hosted. Host CSS variables cannot recolor these images.
+
+## Package distribution
+
+The core package ships these files at `dist/assets/software-architecture/`,
+with the static export path `@sebastianwessel/isostate/assets/software-architecture/*`.
+For example, a bundler that supports URL imports can load
+`@sebastianwessel/isostate/assets/software-architecture/architecture/architecture-sprites.png?url`.
+Static-site projects can copy the directory from the installed package into
+their public assets directory. The catalog is optional static content and is
+never imported by the browser engine.
+
+## Regenerate the manifest
+
+From the repository root:
+
+```bash
+bun packages/cli/src/bin.ts assets manifest assets/software-architecture \
+  --out assets/software-architecture/manifest.json \
+  --asset-base-url ./ --pretty
+```
+
+Keep source sheets, metadata, generated digests, and website copies together in
+one change. Inspect each cropped sprite on light and dark backgrounds after
+changing its rectangle or anchor. Preserve the source alpha channel.

package/dist/assets/software-architecture/agentic/AGENT-VISUAL-PROMPTS.md

@@ -0,0 +1,42 @@
+# Agentic workflow image-generation prompts
+
+Generated with the built-in image_gen tool on 2026-10-05. Each PNG is the unchanged RGBA output; transparent_background was true for every call. The architecture catalog was inspected as a visual style reference. No image post-processing, resampling, alpha replacement, or API/CLI fallback was used.
+
+Each atlas is 1774 × 887 pixels and contains eight row-major objects. The original request preferred a larger 2:1 image, and the tool returned this production resolution. The canonical source `../.isostate-assets.yaml` and distributed `../manifest.json` record individually checked whole-pixel crop rectangles and normalized ground-contact anchors. Use the exact rectangles rather than inferring equal rows: the human escalation silhouette rises above the midpoint. Provider objects are visual metaphors, not official product logos. Captions belong in scene text.
+
+Validation: all five files are RGBA with substantial alpha-zero background, and each is below 2 MiB. All 40 silhouettes and their crop boundaries were visually inspected. Anchors were visually measured at the center of the lower contact footprint, then normalized to the recorded rectangle; faint generated contact shadows are preserved.
+
+## agents-sprites.png
+
+```text
+Use case: product-mockup. Asset type: production PNG sprite atlas for a premium isometric software architecture diagram library. Create a new image, exactly eight separate miniature photorealistic 3D objects in a mathematically regular 4-column by 2-row grid, landscape 2:1 aspect ratio, preferably 2400x1200 or 2048x1024. Each object's entire silhouette must fit in the central 76% of its equal-sized square cell; leave very wide completely transparent gutters between all cells and transparent outer margins. No object touches another cell. All eight objects same scale and visual importance, each distinct and independently reusable. Orthographic 30-degree isometric camera, see top and two sides, consistent view direction and realistic studio key light from upper left. Actual fully transparent alpha background, no checkerboard, no backdrop, no floor, no long cast shadows; only very tight grounding contact shadow attached to object. Style like high-end macro product photography of beautifully engineered collectibles: brushed stainless steel, dark graphite anodized metal, frosted and transparent cyan glass, tiny amber indicator LEDs, believable screws/seams/vents, subtle fine machining microtexture and soft controlled highlights. Refined realistic materials, not flat vector and not cartoon, no oversized glow. Small individual diamond plinths only where structurally necessary, no shared platform. Avoid any text, letters, numbers, captions, watermark, decorative scenery, frame, grid lines or invented official logo. Logical names below are instructions only and MUST NOT be printed. Each position exactly one composite object:
+TOP ROW left to right: (1) AI agent: a compact sophisticated rounded humanoid desktop robot, graphite torso and stainless articulated arms, expressive simple cyan optical sensors, transparent chest containing a luminous neural core, standing upright on two realistic feet, clearly an autonomous assistant. (2) AI orchestrator: elegant central circular command hub with a cyan glass brain and four tiny separate satellite robotic heads around the hub on short radial brushed-metal supports, clearly one coordinated multi-agent cluster. (3) AI planner: an angled glass drafting board on a technical steel stand, with three tangible miniature cyan milestone blocks arranged as stairs and thin engraved lines, one small articulated stylus arm hovering over board. (4) AI researcher: a precision silver robotic microscope with cyan lens examining several translucent data tablets, a compact magnifying optical arm and stacked physical reference cards, compact coherent laboratory workstation. BOTTOM ROW left to right: (5) AI tool runner: detailed industrial robot manipulator with replaceable screwdriver and wrench tools mounted on its compact base, gripping a tiny cyan processor module; energetic precise engineering. (6) AI reviewer: compact optical inspection machine, two steel camera lenses aimed at a glass document panel with a large simple raised green check mark, physical inspection rail and amber status lamp. (7) AI memory: elegant open cylindrical memory vault with four concentric translucent cyan crystal storage rings, graphite archival chassis and amber latch, tangible stacked long-term memory. (8) AI knowledge: beautiful miniature library archive, several cyan frosted-glass upright books held in a brushed steel shelf, one open glass book on integrated angled stand with visible etched nodes and links, scholarly repository. Render every object sharply and with room around it. The grid is mandatory.
+```
+
+## ai-capabilities-sprites.png
+
+```text
+Use case: product-mockup. Asset type: production PNG sprite atlas for a premium isometric software architecture diagram library. Create a new image, exactly eight separate miniature photorealistic 3D objects in a mathematically regular 4-column by 2-row grid, landscape 2:1 aspect ratio, preferably 2400x1200 or 2048x1024. Each object's entire silhouette must fit in the central 76% of its equal-sized square cell; leave very wide completely transparent gutters between all cells and transparent outer margins. No object touches another cell. All eight objects same scale and visual importance, each distinct and independently reusable. Orthographic 30-degree isometric camera, see top and two sides, consistent view direction and realistic studio key light from upper left. Actual fully transparent alpha background, no checkerboard, no backdrop, no floor, no long cast shadows; only very tight grounding contact shadow attached to object. Style like high-end macro product photography of beautifully engineered collectibles: brushed stainless steel, dark graphite anodized metal, frosted and transparent cyan glass, tiny amber indicator LEDs, believable screws/seams/vents, subtle fine machining microtexture and soft controlled highlights. Refined realistic materials, not flat vector and not cartoon, no oversized glow. Small individual diamond plinths only where structurally necessary, no shared platform. Avoid any text, letters, numbers, captions, watermark, decorative scenery, frame, grid lines or invented official logo. Logical names below are instructions only and MUST NOT be printed. Each position exactly one composite object:
+TOP ROW left to right: (1) Retrieval augmented generation: compact precision steel assembly in which a upright rack of three frosted cyan document cards passes through a small glass funnel into a separate cyan crystalline neural core; visually one connected retrieval-to-intelligence device. (2) Embedding: precise stainless optical encoder with one translucent input document card at its left and a tangible ordered 3 by 3 array of nine cyan, violet and teal spheres held in a small clear cube at its right, vector encoding laboratory instrument. (3) Vector search: open faceted clear-glass globe containing a sparse constellation of turquoise vector points and connecting rods, a prominent physical silver magnifying glass focused on one amber selected point; all held on an elegant low base. (4) Context window: stainless horizontal holder cradling five thin upright cyan glass document panels, middle panel larger and illuminated, curved translucent protective partial cover around the selected cards, clear sequential context bank. BOTTOM ROW left to right: (5) Prompt: beautiful compact typewriter-like graphite console with a polished mechanical keyboard and a single frosted glass speech-bubble-shaped slab rising from it, abstract etched short lines only, amber enter key. (6) Evaluation: elegant technical laboratory beam balance made of brushed steel, one shallow pan holding a cyan neural crystal and the other holding calibrated amber weights, tiny integrated measurement screen with simple unlabeled rising bars. (7) Guardrail: robust polished silver shield with translucent teal center, physically protecting a small neural core behind it; two short gold safety barrier posts integrated in the low base, shield strongly dominant. (8) Model router: distinctive mechanical switch-track hub: one cyan input lightpipe entering a compact circular steel switch and branching into three short pipes terminating in three differently shaped miniature crystal modules, teal sphere, violet prism, amber cube; one route visibly illuminated. Exact regular grid and generous alpha gutters mandatory.
+```
+
+## humans-sprites.png
+
+```text
+Use case: product-mockup. Asset type: production PNG sprite atlas for a premium isometric software architecture diagram library. Create a new image, exactly eight separate miniature photorealistic 3D objects in a mathematically regular 4-column by 2-row grid, landscape 2:1 aspect ratio, preferably 2400x1200 or 2048x1024. Each object's entire silhouette must fit in the central 76% of its equal-sized square cell; leave very wide completely transparent gutters between all cells and transparent outer margins. No object touches another cell. All eight objects same scale and visual importance, each distinct and independently reusable. Orthographic 30-degree isometric camera, see top and two sides, consistent view direction and realistic studio key light from upper left. Actual fully transparent alpha background, no checkerboard, no backdrop, no floor, no long cast shadows; only very tight grounding contact shadow attached to object. Style like high-end macro product photography of beautifully engineered collectibles: brushed stainless steel, dark graphite anodized metal, frosted and transparent cyan glass, tiny amber indicator LEDs, believable screws/seams/vents, subtle fine machining microtexture and soft controlled highlights. Refined realistic materials, not flat vector and not cartoon, no oversized glow. Small individual diamond plinths only where structurally necessary, no shared platform. Avoid any text, letters, numbers, captions, watermark, decorative scenery, frame, grid lines or invented official logo. Logical names below are instructions only and MUST NOT be printed. Each position exactly one composite object:
+This sheet contains REALISTIC MINIATURE ADULT HUMAN FIGURES, like exceptionally detailed architectural scale models photographed with a macro lens. Natural human proportions, realistic tailored fabric, believable hands and anatomy, varied genders and skin tones, professional modern clothing; no cartoon toy faces, robots, or cubical placeholder people. Each human and accompanying compact desk make one independent sprite. Steel and frosted cyan-glass furniture matches the material language. Make distinct poses readable at thumbnail scale. TOP ROW left to right: (1) Human requester: an adult woman in a teal casual jacket, standing at a compact waist-high silver kiosk, holding a small cyan glass request card toward its screen, open engaged posture. (2) Human operator: an adult man with dark skin in a navy shirt seated naturally at a curved steel operations desk, two small angled translucent cyan monitors and a keyboard, wearing a fine headset. (3) Human approver: adult woman with short dark hair in a cream business jacket seated at a compact glass review desk, holding a substantial green approval stamp just above one paper document; a small green physical check token sits at desk corner. (4) Human expert: adult older man with silver hair and glasses, navy jacket over white shirt, standing next to a tilted cyan glass technical drawing board and pointing precisely at an abstract chart with a stylus. BOTTOM ROW left to right: (5) Human team: three adult colleagues, one seated and two standing, varied genders and skin tones, collaborating around one small round frosted cyan glass table with a single laptop and a data card, readable cohesive group. (6) Human handoff: two adults, woman in teal blazer and man in charcoal shirt, standing facing each other with their hands clearly holding opposite ends of one small cyan dossier as it is passed between them, no desk. (7) Human escalation: adult support operator at low compact console turning toward a standing senior specialist at a visibly taller raised supervisory podium with a small amber warning beacon, their conversational attention clearly connects them, professional and calm. (8) Human feedback: adult woman in mauve blouse seated at small steel desk with a cyan glass tablet, reaching with stylus to a physical panel of three simple feedback faces represented only as clean smile neutral frown symbols, small amber speech-bubble token on desk. Exact 4x2 grid, generous transparent separation and unclipped people mandatory.
+```
+
+## channels-sprites.png
+
+```text
+Use case: product-mockup. Asset type: production PNG sprite atlas for a premium isometric software architecture diagram library. Create a new image, exactly eight separate miniature photorealistic 3D objects in a mathematically regular 4-column by 2-row grid, landscape 2:1 aspect ratio, preferably 2400x1200 or 2048x1024. Each object's entire silhouette must fit in the central 76% of its equal-sized square cell; leave very wide completely transparent gutters between all cells and transparent outer margins. No object touches another cell. All eight objects same scale and visual importance, each distinct and independently reusable. Orthographic 30-degree isometric camera, see top and two sides, consistent view direction and realistic studio key light from upper left. Actual fully transparent alpha background, no checkerboard, no backdrop, no floor, no long cast shadows; only very tight grounding contact shadow attached to object. Style like high-end macro product photography of beautifully engineered collectibles: brushed stainless steel, dark graphite anodized metal, frosted and transparent cyan glass, tiny amber indicator LEDs, believable screws/seams/vents, subtle fine machining microtexture and soft controlled highlights. Refined realistic materials, not flat vector and not cartoon, no oversized glow. Small individual diamond plinths only where structurally necessary, no shared platform. Avoid any text, letters, numbers, captions, watermark, decorative scenery, frame, grid lines or invented official logo. Logical names below are instructions only and MUST NOT be printed. Each position exactly one composite object:
+TOP ROW left to right: (1) Email: polished stainless desktop mail inbox with one open frosted cyan glass envelope standing upright, small amber notification dot on its upper corner, layered envelope flap physically clear, no flying mail. (2) Phone: beautifully detailed modern charcoal business desk telephone with silver frame, realistic curved handset resting on cradle and short coiled cord, cyan display showing only abstract waveform, restrained amber status light. (3) Microsoft Teams collaboration channel: a premium purple glass video-meeting appliance with broad upright screen in brushed silver frame and built-in webcam; screen shows three small raised human silhouette bust tiles, one foreground purple physical speech bubble and a second violet bubble behind, familiar purple collaboration aesthetic with no printed brand letters or fake logo. (4) Web form: tall frosted cyan browser-window panel on low stainless support, three recessed input rows and two clean checkbox marks plus a solid amber rectangular submit button, subtle three round browser dots in top bar, no text. BOTTOM ROW left to right: (5) Chat: two elegant overlapping physical cyan and teal glass speech bubble objects mounted upright on a compact polished metal base; each bubble contains three small embossed silver dots, one taller than the other. (6) Issue tracker: graphite technical task board on steel stand, three vertical columns of small cyan ticket cards, one ticket in amber and a tiny realistic amber bug-shaped token attached to lower corner, no typography. (7) Document: three physical sheets of frosted glass clipped in a machined steel clipboard frame, front sheet has etched horizontal rules and one small abstract chart, realistic bent page corner, amber paperclip. (8) Webhook: compact silver network coupling with a large sculptural polished metal hook above the central cyan connector port, two short cyan fiber cables on either side and a small amber lightning symbol inset in housing, unmistakable event-trigger hardware. Every complete object in its own equal cell. No connections between cells.
+```
+
+## providers-sprites.png
+
+```text
+Use case: product-mockup. Asset type: production PNG sprite atlas for a premium isometric software architecture diagram library. Create a new image, exactly eight separate miniature photorealistic 3D objects in a mathematically regular 4-column by 2-row grid, landscape 2:1 aspect ratio, preferably 2400x1200 or 2048x1024. Each object's entire silhouette must fit in the central 76% of its equal-sized square cell; leave very wide completely transparent gutters between all cells and transparent outer margins. No object touches another cell. All eight objects same scale and visual importance, each distinct and independently reusable. Orthographic 30-degree isometric camera, see top and two sides, consistent view direction and realistic studio key light from upper left. Actual fully transparent alpha background, no checkerboard, no backdrop, no floor, no long cast shadows; only very tight grounding contact shadow attached to object. Style like high-end macro product photography of beautifully engineered collectibles: brushed stainless steel, dark graphite anodized metal, frosted and transparent cyan glass, tiny amber indicator LEDs, believable screws/seams/vents, subtle fine machining microtexture and soft controlled highlights. Refined realistic materials, not flat vector and not cartoon, no oversized glow. Small individual diamond plinths only where structurally necessary, no shared platform. Avoid any text, letters, numbers, captions, watermark, decorative scenery, frame, grid lines or invented official logo. Logical names below are instructions only and MUST NOT be printed. Each position exactly one composite object:
+Provider metaphor sculptures: these are diagram metaphors for named platforms, not official logos. Preserve the common steel/glass studio-render style while giving each provider a distinctive silhouette and recognizable palette. No brand text or invented logotype. TOP ROW left to right: (1) Azure AI Foundry: a miniature advanced blue-glass AI forge, substantial silver open-sided furnace with vivid azure-blue crystalline neural core hovering over a small polished anvil-like pedestal, two angular blue structural fins, precision manufactured. (2) AWS Bedrock: a beautiful orange and graphite compute sculpture made of three offset geological strata cut from smoked glass and dark stone, tiny warm-orange neural silicon wafer on top, a subtle silver cloud canopy held just above the layers by supports, evocative solid foundational bedrock. (3) Anthropic: warm amber and cream cognitive crystalline core, large honey-colored irregular faceted translucent intelligence crystal held within two elegant ivory ceramic curving protective fins, visible delicate branching filaments inside, compact dark metal base; calmer organic geometry. (4) OpenAI: a sculptural black-and-white interlocking toroidal neural core, six polished stainless and matte porcelain curved loops smoothly intertwined into a dimensional intricate knot-like intelligence mechanism, upright over a compact graphite precision pedestal; no printed emblem, physically plausible sculpture. BOTTOM ROW left to right: (5) Google Vertex AI: an elegant triangular stepped pyramidal compute sculpture with four differently colored translucent glass triangular tiers in blue red yellow and green, brushed silver supporting skeleton, tiny precise luminous neural point at apex, crisp architectural geometry. (6) Google Gemini: paired blue-violet crystalline four-point stars suspended inside a slim polished metal orbital ring above a low circular base, two visibly distinct twin-star cores catching iridescent purple and azure light, refined magical-but-physical scientific instrument. (7) Local model: a compact premium graphite desktop workstation tower with visible internal cyan neural compute chip through a clear side window, realistic cooling fans and vents, small matching flat monitor showing abstract cyan nodes and a keyboard on a shallow integrated steel tray; unmistakably local personal hardware. (8) Hugging Face: a cheerful tangible round golden-yellow enamel smile medallion with two small sculpted yellow hands extending as an open hug on either side, black inset eyes and smile, supported upright on a compact brushed-steel base; realistic glazed enamel collectible, no words. All objects equally detailed, no oversized halo, all eight entirely isolated in their own cell.
+```

package/dist/assets/software-architecture/agentic/HANDOFF-PROMPTS.md

@@ -0,0 +1,19 @@
+# Directional handoff assets
+
+Generated with the built-in ImageGen tool and `transparent_background: true`.
+Source PNG bytes and genuine alpha are preserved. Both images are 1254 × 1254 RGBA;
+full-image sprite rectangles and inspected ground anchors are in `../.isostate-assets.yaml`.
+The existing `human-handoff` remains human-to-human. These two assets make delegation
+and escalation visually distinct through the giver/receiver arrangement and an embossed pointer.
+
+## Human to AI
+
+```text
+Use case: stylized-concept. Asset type: one production transparent PNG isometric software workflow asset, square framing. Create a premium nearly photoreal miniature 3D scene of HUMAN TO AI HANDOFF: a realistic professional woman wearing a teal jacket stands on the LEFT, actively extending a glowing translucent cyan document/data tablet toward an unmistakably nonhuman AI compute appliance on the RIGHT. The AI appliance is sculptural graphite-and-brushed-silver machine with a luminous cyan glass cognition core, no robot human silhouette. Human's outstretched arm and a short physical illuminated receiving slot communicate direction from person to AI. A small cyan rightward triangular embossed pointer on the shared low plinth reinforces transfer without a long arrow. Same orthographic isometric camera, elevated front-right view, thirty-degree diamond axes, tight studio lighting upper-left, fine textiles, natural realistic skin/hair, machined silver, graphite metal, porcelain white, luminous teal/cyan glass; believable volume, precise bevels and reflections. Both subjects grounded on one compact elegant diamond footing, whole scene fully visible, centered with generous transparent padding all around and tight soft contact shadow. Ground contact near center x50%, y85%. Human and machine clearly distinct and readable at 96px thumbnail. Genuine RGBA alpha transparent background. No scenery, white backdrop, painted checkerboard, labels, letters, logos, watermark, flat vector appearance, simple rectangular pictogram, cartoon, big platform. Single coherent asset, not a sprite sheet.
+```
+
+## AI to human
+
+```text
+Use case: stylized-concept. Asset type: one production transparent PNG isometric software workflow asset with square framing. Create a premium nearly photoreal miniature 3D scene of AI TO HUMAN HANDOFF: unmistakably nonhuman sculptural graphite-and-brushed-silver AI compute appliance on the LEFT, with luminous cyan glass cognition core and a compact mechanical dispenser extending a translucent cyan document/data tablet toward a realistic professional man on the RIGHT. Human wears charcoal business casual clothes, has natural skin and hair, and reaches with both hands to RECEIVE the tablet from the machine. A restrained amber status beacon on the appliance signals a request for human attention. A small cyan rightward triangular embossed pointer on their shared low plinth reinforces direction machine-to-human without a long arrow. Same orthographic isometric camera, elevated front-right view, thirty-degree diamond axes, tight studio lighting upper-left, fine textiles, machined silver, graphite metal, porcelain white, luminous teal/cyan glass, tiny amber accents, believable volume, precise bevels and reflections. Both subjects grounded on one compact elegant diamond footing, whole scene fully visible and centered with generous transparent padding all around, tight soft contact shadow. Ground contact near x50%, y85%. Man is visibly receiving, AI appliance is visibly supplying, readable at 96px thumbnail. Genuine RGBA alpha transparent background. No scenery, white backdrop, painted checkerboard, labels, letters, logos, watermark, flat vector appearance, rectangular pictogram, cartoon, big platform, humanoid robot. Single coherent asset, not sprite sheet.
+```

package/dist/assets/software-architecture/agentic/PROCESS-VISUAL-PROMPTS.md

@@ -0,0 +1,109 @@
+# Process visual generation prompts
+
+Generated with the built-in ImageGen tool on 2026-10-05. All four final PNGs are unaltered generated outputs with actual RGBA transparency. Each sheet is 1774 × 887 pixels and contains eight logical sprites in row-major order. No CLI or external API generation was used.
+
+The canonical source `../.isostate-assets.yaml` and distributed `../manifest.json` record image paths relative to `assets/software-architecture`, pixel rectangles `[x, y, width, height]`, normalized anchors within each rectangle, labels, and tags. Anchors were visually checked at the lower ground contact of each sculpture. Independent crop partitions account for generated spacing; they are deliberately not assumed to be equal square cells.
+
+Visual review confirmed distinct subjects, no lettering, and no visible clipping or neighboring-object bleed. Alpha inspection confirmed 0–255 channels and that all pixels with alpha at least 16 lie inside their assigned crop boundaries. Extremely faint generation fringe pixels may remain outside visible object silhouettes; source bytes are preserved.
+
+## Orchestration
+
+File: `orchestration-sprites.png`
+
+Logical sprites: `agent-workflow`, `agent-parallel`, `agent-router`, `agent-condition`, `agent-loop`, `agent-retry`, `agent-timeout`, `agent-error`.
+
+Exact submitted prompt:
+
+```text
+Use case: stylized-concept.
+Asset type: production PNG sprite atlas for an isometric software architecture library.
+Create exactly EIGHT separate photorealistic miniature 3D product sculptures in a perfectly regular FOUR COLUMN by TWO ROW grid. Wide 2:1 canvas, ideally 2048x1024. Each grid cell contains exactly one freestanding compact sculpture, visually centered, same scale, fitting a one-cell diamond ground footprint. All eight objects have identical orthographic isometric camera (view down about 30 degrees, visible top and front/right), realistic bevels, brushed gunmetal and silver, frosted cyan glass, beautiful precise PBR studio lighting, restrained amber indicator lights. Actual transparent RGBA background, no floor, no backdrop, no fake checkerboard. Each sculpture is entirely contained within the central 75% of its grid cell: at least 12% clear transparent margin around every cell, no touching neighbors or canvas borders, no connecting elements between sprites, no cast shadows beyond its own compact contact shadow. Each is physically detailed and volumetric, like premium collectible industrial hardware, not a flat symbol or a simple rectangle. Do not include words, letters, digits, labels, typography, captions, watermarks, decorative background, frames or grid lines. Symbols described below are substantial sculptural parts, never printed labels. Exact row-major subjects follow:
+TOP ROW left to right:
+1. Workflow: three small cyan glass step podiums joined in sequence by short silver mechanical bridges, ascending slightly on one compact dark base.
+2. Parallel: one central silver inlet manifold dividing into three equally prominent cyan glass processing branches on a compact mechanical base, clearly parallel.
+3. Router: a hefty central rotary metal junction with three cyan glass pipe outlets in diverging directions and one amber selected outlet, a physical switching mechanism.
+4. Condition: a standing diamond-shaped cyan glass decision prism held inside a substantial metal pivot frame; two short exit channels, one green and one amber.
+BOTTOM ROW left to right:
+5. Loop: a thick circular cyan glass processing ring fitted into a horizontal metal turntable, clockwise sculptural arrow integrated into the ring.
+6. Retry: a silver flywheel with a prominent amber curved return arrow wrapping halfway around a small cyan processor; clearly an industrial return/restart mechanism.
+7. Timeout: a large realistic hourglass with luminous amber grains, thick brushed metal top and bottom collars, compact cyan timing control at foot.
+8. Error: a rugged diagnostic console with a substantial red translucent upright warning triangle containing a sculptural exclamation mark, no written screen text.
+Ensure all eight silhouettes are distinctive and separated by generous fully transparent gutters.
+```
+
+## Lifecycle
+
+File: `lifecycle-sprites.png`
+
+Logical sprites: `agent-trigger`, `agent-schedule`, `agent-await-human`, `agent-approval`, `agent-rejection`, `agent-escalation`, `agent-audit`, `agent-complete`.
+
+Exact submitted prompt:
+
+```text
+Use case: stylized-concept.
+Asset type: production PNG sprite atlas for an isometric software architecture library.
+Create exactly EIGHT separate photorealistic miniature 3D product sculptures in a perfectly regular FOUR COLUMN by TWO ROW grid. Wide 2:1 canvas, ideally 2048x1024. Each grid cell contains exactly one freestanding compact sculpture, visually centered, same scale, fitting a one-cell diamond ground footprint. All eight objects have identical orthographic isometric camera (view down about 30 degrees, visible top and front/right), realistic bevels, brushed gunmetal and silver, frosted cyan glass, beautiful precise PBR studio lighting, restrained amber indicator lights. Actual transparent RGBA background, no floor, no backdrop, no fake checkerboard. Each sculpture is entirely contained within the central 75% of its grid cell: at least 12% clear transparent margin around every cell, no touching neighbors or canvas borders, no connecting elements between sprites, no cast shadows beyond its own compact contact shadow. Each is physically detailed and volumetric, like premium collectible industrial hardware, not a flat symbol or a simple rectangle. Do not include words, letters, digits, labels, typography, captions, watermarks, decorative background, frames or grid lines. Symbols described below are substantial sculptural parts, never printed labels. Exact row-major subjects follow:
+TOP ROW left to right:
+1. Trigger: a spring-loaded industrial pushbutton mechanism, oversized amber tactile button on a small dark steel base, cyan spark-shaped glass actuator rising behind it.
+2. Schedule: a substantial upright analog clock with cyan glass face, simple hour and minute hands but no numerals, brushed silver frame, attached to a miniature calendar-like metal rack with blank tabs.
+3. Await human: a friendly realistic miniature silver human bust, shoulders and head, beside a small slanted cyan console with two substantial amber pause bars rising from it, both share one compact base.
+4. Approval: a large green translucent checkmark mounted as a thick physical seal inside a circular silver inspection-stamp frame, small cyan dock at foot.
+BOTTOM ROW left to right:
+5. Rejection: a substantial red horizontal barrier boom lowered across a small dark checkpoint gate, frosted red shield with a physical silver X behind it, compact base.
+6. Escalation: a stepped metal tower with three increasingly taller cyan glass sections and an amber upward arrow rail climbing its side; reads as raised priority.
+7. Audit: a beautiful thick open ledger with realistic ivory pages, cyan metal binding and a small magnifying glass over check-shaped indentations; no written words or glyphs.
+8. Complete: a finished silver trophy-like circular green glass medallion with raised silver checkmark, mounted over neatly stacked closed cyan document trays, celebratory but no confetti.
+Ensure all eight silhouettes are distinctive and separated by generous fully transparent gutters.
+```
+
+## Servicenow
+
+File: `servicenow-sprites.png`
+
+Logical sprites: `servicenow-interaction`, `servicenow-request`, `servicenow-requested-item`, `servicenow-request-task`, `servicenow-catalog-item`, `servicenow-incident`, `servicenow-problem`, `servicenow-change`.
+
+Exact submitted prompt:
+
+```text
+Use case: stylized-concept.
+Asset type: production PNG sprite atlas for an isometric software architecture library.
+Create exactly EIGHT separate photorealistic miniature 3D product sculptures in a perfectly regular FOUR COLUMN by TWO ROW grid. Wide 2:1 canvas, ideally 2048x1024. Each grid cell contains exactly one freestanding compact sculpture, visually centered, same scale, fitting a one-cell diamond ground footprint. All eight objects have identical orthographic isometric camera (view down about 30 degrees, visible top and front/right), realistic bevels, brushed gunmetal and silver, frosted cyan glass, beautiful precise PBR studio lighting, restrained amber indicator lights. Actual transparent RGBA background, no floor, no backdrop, no fake checkerboard. Each sculpture is entirely contained within the central 75% of its grid cell: at least 12% clear transparent margin around every cell, no touching neighbors or canvas borders, no connecting elements between sprites, no cast shadows beyond its own compact contact shadow. Each is physically detailed and volumetric, like premium collectible industrial hardware, not a flat symbol or a simple rectangle. Do not include words, letters, digits, labels, typography, captions, watermarks, decorative background, frames or grid lines. Symbols described below are substantial sculptural parts, never printed labels. Exact row-major subjects follow:
+This sheet is a ServiceNow business-workflow family. Use distinctive ServiceNow-inspired emerald green glass in place of cyan for the main record panels, with silver metal and restrained lime accents. The eight physical objects must be medium-small, occupying at most 65% of their allocated cell, with EXTRA generous margins including above tall objects.
+TOP ROW left to right:
+1. Interaction: a substantial emerald glass conversation bubble nested with a smaller clear reply bubble, mounted in a silver cradle; a compact sculptural conversation record.
+2. Request: a silver intake tray holding one upright green glass document envelope with a substantial plus-shaped silver seal, looks like an incoming business request.
+3. Requested item: a compact emerald glass product cube inside an open silver parcel cradle, with one dangling unlettered green ticket tag showing a circular recessed mark.
+4. Request task: a realistic freestanding green metal clipboard with an ivory inset panel, three substantial silver checkmarks and shallow horizontal engraved lines, no letters.
+BOTTOM ROW left to right:
+5. Catalog item: a single polished green glass package showcased on a miniature circular rotating product pedestal under a curved silver showcase arm, premium purchasable catalog product.
+6. Incident: a miniature rugged emerald service console with a red emergency beacon and a substantial silver warning triangle on front, no text.
+7. Problem: a realistic handheld silver magnifying glass leaning against an emerald glass mechanical gear with branching root-like silver traces underneath; physical root-cause investigation.
+8. Change: interlocking emerald and silver gears on a dark metal base with a realistic upright silver wrench crossing one gear; physical change management.
+Keep top and bottom rows fully separate. Do not show words or brand logos. Distinct tangible recognizable metaphors, not repeated generic ticket rectangles.
+```
+
+## Infrastructure
+
+File: `infrastructure-sprites.png`
+
+Logical sprites: `infra-redis-cache`, `infra-redis-stream`, `infra-redis-pubsub`, `infra-vector-database`, `infra-object-storage`, `infra-knowledge-base`, `infra-api-tool`, `infra-secret-vault`.
+
+Exact submitted prompt:
+
+```text
+Use case: stylized-concept.
+Asset type: production PNG sprite atlas for an isometric software architecture library.
+Create exactly EIGHT separate photorealistic miniature 3D product sculptures in a perfectly regular FOUR COLUMN by TWO ROW grid. Wide 2:1 canvas, ideally 2048x1024. Each grid cell contains exactly one freestanding compact sculpture, visually centered, same scale, fitting a one-cell diamond ground footprint. All eight objects have identical orthographic isometric camera (view down about 30 degrees, visible top and front/right), realistic bevels, brushed gunmetal and silver, frosted cyan glass, beautiful precise PBR studio lighting, restrained amber indicator lights. Actual transparent RGBA background, no floor, no backdrop, no fake checkerboard. Each sculpture is entirely contained within the central 75% of its grid cell: at least 12% clear transparent margin around every cell, no touching neighbors or canvas borders, no connecting elements between sprites, no cast shadows beyond its own compact contact shadow. Each is physically detailed and volumetric, like premium collectible industrial hardware, not a flat symbol or a simple rectangle. Do not include words, letters, digits, labels, typography, captions, watermarks, decorative background, frames or grid lines. Symbols described below are substantial sculptural parts, never printed labels. Exact row-major subjects follow:
+Objects occupy at most 70% of each grid cell. Redis-family first three objects share a recognizable stack of three red rounded square slabs, but their machinery and silhouettes differ unmistakably. No actual letters or logos.
+TOP ROW left to right:
+1. Redis cache: three red enamel rounded square cache slabs stacked as a compact low machine, one open front glass chamber reveals three cyan glowing stored data cubes; brushed silver enclosure.
+2. Redis stream: three red rounded square slabs forming a compact stack alongside a short horizontal transparent cyan glass conveyor tube carrying a visible orderly single file of four small glowing amber data beads; integrated machine on one base.
+3. Redis pub/sub: three small red rounded square slabs stacked as a central hub, from it three short cyan glass tubes branch radially into three tiny metal receiving pods; compact and self contained.
+4. Vector database: a substantial clear cyan cubic crystal chamber containing an orderly spatial lattice of floating metal points joined by fine cyan rods, sits over two brushed silver cylindrical database tiers.
+BOTTOM ROW left to right:
+5. Object storage: a rugged dark steel open storage crate holding three clearly separated luminous cyan glass cubes, visible lid hinges, realistic industrial details.
+6. Knowledge base: three thick upright technical books with pale pages and cyan glass covers, varied heights, held in a dark metal archival rack, tiny amber light at foot, no spine text.
+7. API tool: a realistic compact silver articulated robot tool arm with cyan joints, gripping a small gold wrench over a cyan input/output socket console, all one freestanding machine.
+8. Secret vault: a thick square brushed silver safe with a massive round vault door partially inset, realistic wheel lock and bolts, a cyan key-shaped glass sculptural insert on the door; dark pedestal base.
+Ensure eight detailed premium 3D product cutouts, generous empty transparent gutters and a consistent camera and lighting.
+```