@assemblyline-agents/openui 3.0.0

package/dist/standard-pack.js

@@ -0,0 +1,10 @@
+import { assemblyLineOpenUiLibrary } from "./report-library.js";
+import { renderOpenUiArtifact } from "./render.js";
+export const OPENUI_COMPONENT_NAMES = Object.freeze(Object.keys(assemblyLineOpenUiLibrary.components));
+export const openUiStandardComponentPack = Object.freeze({
+    id: "@openuidev/react-ui",
+    version: "0.13.6",
+    library: assemblyLineOpenUiLibrary,
+    render: renderOpenUiArtifact
+});
+//# sourceMappingURL=standard-pack.js.map

package/dist/standard-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-pack.js","sourceRoot":"","sources":["../src/standard-pack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAC;AAEvG,MAAM,CAAC,MAAM,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,EAAE,EAAE,qBAAqB;IACzB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,yBAAyB;IAClC,MAAM,EAAE,oBAAoB;CAC7B,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,33 @@
+import { type ToolDefinition } from "@assemblyline-agents/core";
+import { type OpenUiConfig, type OpenUiConfigInput } from "./config.js";
+interface CreateInput {
+    title: string;
+    document: string;
+}
+interface UpdateInput extends CreateInput {
+    artifactId: string;
+    revision: string;
+}
+interface PublishInput {
+    artifactId: string;
+    revision: string;
+}
+interface RevisionOutput {
+    artifactId: string;
+    revision: string;
+    parentRevision?: string;
+    title: string;
+    status: "draft";
+}
+interface PublishOutput {
+    artifactId: string;
+    revision: string;
+    title: string;
+    url: string;
+    visibility: "unlisted";
+}
+export declare function defineOpenUiCreateTool(configInput?: OpenUiConfigInput | OpenUiConfig): ToolDefinition<CreateInput, RevisionOutput>;
+export declare function defineOpenUiUpdateTool(configInput?: OpenUiConfigInput | OpenUiConfig): ToolDefinition<UpdateInput, RevisionOutput>;
+export declare function defineOpenUiPublishTool(configInput?: OpenUiConfigInput | OpenUiConfig): ToolDefinition<PublishInput, PublishOutput>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,cAAc,EAEpB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAGrB,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAY,SAAQ,WAAW;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,UAAU,CAAC;CACxB;AAoCD,wBAAgB,sBAAsB,CACpC,WAAW,GAAE,iBAAiB,GAAG,YAAiB,GACjD,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,CA6B7C;AAED,wBAAgB,sBAAsB,CACpC,WAAW,GAAE,iBAAiB,GAAG,YAAiB,GACjD,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,CAmC7C;AAED,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,iBAAiB,GAAG,YAAiB,GACjD,cAAc,CAAC,YAAY,EAAE,aAAa,CAAC,CAqE7C"}

package/dist/tools.js

@@ -0,0 +1,350 @@
+import { createHash } from "node:crypto";
+import { isRecoverableToolError, RecoverableToolError } from "@assemblyline-agents/core";
+import { artifactPublicationKey, artifactRevisionKey, createArtifactRevision, parseArtifactRevision, validArtifactId, validRevision } from "./artifact.js";
+import { defineOpenUiConfig, hydrateOpenUiConfig, snapshotOpenUiConfig } from "./config.js";
+import { openUiGenerationPrompt, parseOpenUiDocument } from "./library.js";
+const PUBLISH_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        artifactId: { type: "string", pattern: "^oui_[a-f0-9]{24}$" },
+        revision: { type: "string", pattern: "^[a-f0-9]{64}$" }
+    },
+    required: ["artifactId", "revision"],
+    additionalProperties: false
+};
+const REVISION_OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        artifactId: { type: "string" },
+        revision: { type: "string" },
+        parentRevision: { type: "string" },
+        title: { type: "string" },
+        status: { type: "string", enum: ["draft"] }
+    },
+    required: ["artifactId", "revision", "title", "status"]
+};
+const PUBLISH_OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        artifactId: { type: "string" },
+        revision: { type: "string" },
+        title: { type: "string" },
+        url: { type: "string", format: "uri" },
+        visibility: { type: "string", enum: ["unlisted"] }
+    },
+    required: ["artifactId", "revision", "title", "url", "visibility"]
+};
+export function defineOpenUiCreateTool(configInput = {}) {
+    const config = defineOpenUiConfig(configInput);
+    return {
+        description: "Create an immutable branded artifact revision from configured OpenUI component packs. Raw HTML is not accepted.",
+        inputSchema: createInputSchema(config),
+        outputSchema: REVISION_OUTPUT_SCHEMA,
+        needsApproval: false,
+        sideEffect: "idempotent",
+        capability: {
+            visibility: "always",
+            execution: "direct",
+            namespace: "openui",
+            tags: ["artifacts", "ui"]
+        },
+        async execute(input, ctx) {
+            const title = requiredTitle(input);
+            const document = parseToolInputDocument(input, config);
+            const record = createArtifactRevision({
+                document,
+                title,
+                config: snapshotOpenUiConfig(config),
+                runId: ctx.runId,
+                agentRevision: ctx.agentRevision
+            });
+            await storeRevision(ctx, record);
+            await ctx.emit("openui.artifact_created", revisionEvent(record));
+            return revisionOutput(record);
+        }
+    };
+}
+export function defineOpenUiUpdateTool(configInput = {}) {
+    const config = defineOpenUiConfig(configInput);
+    return {
+        description: "Create a new immutable revision of an existing OpenUI artifact. Raw HTML is not accepted.",
+        inputSchema: updateInputSchema(config),
+        outputSchema: REVISION_OUTPUT_SCHEMA,
+        needsApproval: false,
+        sideEffect: "idempotent",
+        capability: {
+            visibility: "always",
+            execution: "direct",
+            namespace: "openui",
+            tags: ["artifacts", "ui"]
+        },
+        async execute(input, ctx) {
+            const artifactId = requiredArtifactId(input.artifactId);
+            const parentRevision = requiredRevision(input.revision);
+            const parent = await loadRevision(requiredBlob(ctx), artifactId, parentRevision);
+            validateStoredRevision(parent, config);
+            const title = requiredTitle(input);
+            const document = parseToolInputDocument(input, config);
+            const record = createArtifactRevision({
+                document,
+                title,
+                config: snapshotOpenUiConfig(config),
+                runId: ctx.runId,
+                agentRevision: ctx.agentRevision,
+                artifactId,
+                parentRevision
+            });
+            await storeRevision(ctx, record);
+            await ctx.emit("openui.artifact_updated", revisionEvent(record));
+            return revisionOutput(record);
+        }
+    };
+}
+export function defineOpenUiPublishTool(configInput = {}) {
+    const currentConfig = defineOpenUiConfig(configInput);
+    return {
+        description: "Publish one OpenUI artifact revision to an unlisted, storage-issued HTTPS link.",
+        inputSchema: PUBLISH_INPUT_SCHEMA,
+        outputSchema: PUBLISH_OUTPUT_SCHEMA,
+        needsApproval: false,
+        sideEffect: "external",
+        capability: {
+            visibility: "always",
+            execution: "direct",
+            namespace: "openui",
+            tags: ["artifacts", "ui", "publish"]
+        },
+        toModelOutput(output) {
+            return {
+                artifactId: output.artifactId,
+                revision: output.revision,
+                title: output.title,
+                visibility: output.visibility,
+                selectedForDelivery: true
+            };
+        },
+        async execute(input, ctx) {
+            const artifactId = requiredArtifactId(input.artifactId);
+            const revision = requiredRevision(input.revision);
+            const blob = requiredBlob(ctx);
+            const record = await loadRevision(blob, artifactId, revision);
+            const validated = validateStoredRevision(record, currentConfig);
+            const html = validated.config.componentPack.render({
+                source: validated.document.source,
+                title: record.title,
+                config: record.config
+            });
+            if (typeof html !== "string" || html.length === 0 || Buffer.byteLength(html) > 10_000_000) {
+                throw new Error("OpenUI component pack renderer returned an invalid or oversized publication.");
+            }
+            const published = await blob.put(artifactPublicationKey(record), html, { contentType: "text/html; charset=utf-8", visibility: "public" });
+            const url = publicHttpsUrl(published.uri);
+            await verifyPublishedUrl(url, published.sha256, ctx);
+            const output = {
+                artifactId,
+                revision,
+                title: record.title,
+                url,
+                visibility: "unlisted"
+            };
+            await ctx.emit("openui.artifact_published", {
+                ...output,
+                componentPack: { ...record.config.componentPack },
+                contentType: "text/html; charset=utf-8",
+                sha256: published.sha256,
+                sizeBytes: published.size
+            });
+            await ctx.emit("artifact.link_delivery_selected", {
+                kind: "openui",
+                artifactId,
+                revision,
+                title: record.title,
+                url,
+                visibility: "unlisted"
+            });
+            return output;
+        }
+    };
+}
+function createInputSchema(config) {
+    return {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                minLength: 1,
+                maxLength: 240,
+                description: "The artifact title. Lifecycle metadata is separate from the component library root."
+            },
+            document: {
+                type: "string",
+                description: openUiGenerationPrompt(config)
+            }
+        },
+        required: ["title", "document"],
+        additionalProperties: false
+    };
+}
+function updateInputSchema(config) {
+    const create = createInputSchema(config);
+    return {
+        type: "object",
+        properties: {
+            artifactId: { type: "string", pattern: "^oui_[a-f0-9]{24}$" },
+            revision: {
+                type: "string",
+                pattern: "^[a-f0-9]{64}$",
+                description: "The immutable parent revision to update."
+            },
+            ...create.properties
+        },
+        required: ["artifactId", "revision", "title", "document"],
+        additionalProperties: false
+    };
+}
+function parseToolInputDocument(input, config) {
+    try {
+        return parseOpenUiDocument(requiredDocument(input), config);
+    }
+    catch (error) {
+        if (isRecoverableToolError(error))
+            throw error;
+        throw new RecoverableToolError(error instanceof Error ? error.message : String(error));
+    }
+}
+async function storeRevision(ctx, record) {
+    const blob = requiredBlob(ctx);
+    await blob.put(artifactRevisionKey(record.artifactId, record.revision), JSON.stringify(record), { contentType: "application/vnd.assembly-line.openui+json", visibility: "private" });
+}
+async function loadRevision(blob, artifactId, revision) {
+    const bytes = await blob.get(artifactRevisionKey(artifactId, revision));
+    if (!bytes)
+        throw new Error("OpenUI artifact revision " + artifactId + "@" + revision + " was not found.");
+    const record = parseArtifactRevision(bytes);
+    if (record.artifactId !== artifactId || record.revision !== revision) {
+        throw new Error("Stored OpenUI revision identifiers do not match its blob key.");
+    }
+    return record;
+}
+function validateStoredRevision(record, currentConfig) {
+    const config = hydrateOpenUiConfig(record.config, currentConfig.componentPack);
+    const forbidden = record.config.allowedComponents.filter((component) => !currentConfig.allowedComponents.includes(component));
+    if (forbidden.length > 0) {
+        throw new Error("Stored OpenUI artifact uses components disabled by current developer policy: "
+            + forbidden.join(", ")
+            + ".");
+    }
+    if (record.config.allowLocalInteractivity && !currentConfig.allowLocalInteractivity) {
+        throw new Error("Stored OpenUI artifact uses local interactivity disabled by current developer policy.");
+    }
+    if (record.source.length > currentConfig.maxDocumentChars) {
+        throw new Error("Stored OpenUI artifact exceeds the current document size policy.");
+    }
+    const document = parseOpenUiDocument(record.source, config);
+    const expected = createArtifactRevision({
+        document,
+        title: record.title,
+        config: record.config,
+        runId: record.provenance.runId,
+        agentRevision: record.provenance.agentRevision,
+        artifactId: record.artifactId,
+        ...(record.parentRevision ? { parentRevision: record.parentRevision } : {})
+    });
+    if (expected.revision !== record.revision) {
+        throw new Error("Stored OpenUI artifact revision failed its integrity check.");
+    }
+    return { config, document };
+}
+function requiredBlob(ctx) {
+    if (!ctx.blob)
+        throw new Error("OpenUI artifact tools require a configured blob adapter.");
+    return ctx.blob;
+}
+function requiredTitle(input) {
+    if (!input || typeof input.title !== "string")
+        throw new Error("OpenUI title must be a string.");
+    const title = input.title.trim();
+    if (!title)
+        throw new Error("OpenUI title cannot be empty.");
+    if (title.length > 240)
+        throw new Error("OpenUI title exceeds 240 characters.");
+    return title;
+}
+function requiredDocument(input) {
+    if (!input || typeof input.document !== "string")
+        throw new Error("OpenUI document must be a string.");
+    return input.document;
+}
+function requiredArtifactId(value) {
+    if (!validArtifactId(value))
+        throw new Error("OpenUI artifactId is invalid.");
+    return value;
+}
+function requiredRevision(value) {
+    if (!validRevision(value))
+        throw new Error("OpenUI revision is invalid.");
+    return value;
+}
+async function verifyPublishedUrl(url, expectedSha256, ctx) {
+    const fetchImpl = ctx.channel?.fetch ?? globalThis.fetch;
+    let lastError;
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            const response = await fetchImpl(url, {
+                method: "GET",
+                redirect: "error",
+                headers: { "cache-control": "no-cache" },
+                signal: AbortSignal.timeout(10_000)
+            });
+            if (!response.ok)
+                throw new Error("HTTP " + response.status);
+            const bytes = Buffer.from(await response.arrayBuffer());
+            const actualSha256 = createHash("sha256").update(bytes).digest("hex");
+            if (actualSha256 !== expectedSha256) {
+                throw new Error("served bytes do not match the stored publication");
+            }
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < 2) {
+                await new Promise((resolve) => setTimeout(resolve, 250 * (attempt + 1)));
+            }
+        }
+    }
+    const detail = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error("OpenUI publication URL could not be verified: " + detail);
+}
+function publicHttpsUrl(uri) {
+    let url;
+    try {
+        url = new URL(uri);
+    }
+    catch {
+        throw new Error("The blob adapter did not return a valid publication URL.");
+    }
+    if (url.protocol !== "https:") {
+        throw new Error("OpenUI publish requires a blob adapter with an HTTPS public base URL. Configure R2_PUBLIC_BASE_URL or S3_PUBLIC_BASE_URL.");
+    }
+    return url.toString();
+}
+function revisionOutput(record) {
+    return {
+        artifactId: record.artifactId,
+        revision: record.revision,
+        ...(record.parentRevision ? { parentRevision: record.parentRevision } : {}),
+        title: record.title,
+        status: "draft"
+    };
+}
+function revisionEvent(record) {
+    return {
+        artifactId: record.artifactId,
+        revision: record.revision,
+        ...(record.parentRevision ? { parentRevision: record.parentRevision } : {}),
+        title: record.title,
+        brand: record.config.brand.name,
+        componentPack: { ...record.config.componentPack }
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@assemblyline-agents/openui",
+  "version": "3.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@openuidev/lang-core": "0.2.11",
+    "@openuidev/react-lang": "0.2.11",
+    "@openuidev/react-ui": "0.13.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "zod": "^4.0.0",
+    "@assemblyline-agents/core": "3.0.0"
+  },
+  "description": "Full OpenUI component runtime and branded artifact lifecycle tools for Assembly Line agents.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/assembly-line.git",
+    "directory": "packages/openui"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/assembly-line/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/assembly-line#readme",
+  "author": "Assembly Line contributors",
+  "keywords": [
+    "assembly-line",
+    "ai",
+    "agents",
+    "openui",
+    "artifacts",
+    "generative-ui",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "esbuild": "0.25.12"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-browser.mjs",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/openui-artifacts/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: openui-artifacts
+description: Build, revise, and publish branded web pages, lightweight local apps, reports, dashboards, forms, calculators, data explorers, and visual analyses with developer-approved OpenUI component packs. Use when a user asks for a web-native or shareable browser artifact.
+allowed-tools: [openui_create, openui_update, openui_publish]
+---
+
+# Build OpenUI Artifacts
+
+Use OpenUI for a web page, report, dashboard, form, calculator, visualization, or lightweight interactive app. Use `deliver_artifact` for ordinary files.
+
+## Workflow
+
+1. Read the `openui_create.document` schema. It defines the current root, component signatures, allowlist, bindings, actions, and interactivity policy.
+2. Set the information hierarchy and interaction model.
+3. Build one complete OpenUI Lang document from approved components.
+4. Call `openui_create` with a separate `title` and `document`. Keep the exact `artifactId` and `revision`.
+5. Call `openui_update` for each change. Pass both identifiers, the title, and the complete replacement document.
+6. Check component reachability, data shape, labels, units, states, and sources.
+7. Call `openui_publish` for the chosen revision. Publishing verifies the hosted bytes and selects the canonical link for delivery.
+8. State that the artifact is ready. Do not type, copy, shorten, rewrite, or guess a URL. The runtime delivers the tool-issued link.
+
+Gather external data before composing. Published artifacts cannot use `Query`, `Mutation`, scripts, or browser network access. Use local `State`, bindings, and `Action` only when the live tool schema permits them.
+
+## Compose freely within the pack
+
+Use primitives and higher-level components in combinations that fit the task. The component pack controls fonts, spacing, colors, radii, and responsive behavior. Do not simulate styling in content strings or force every artifact into one layout.
+
+The official pack uses `Stack` as its root. This small example is illustrative only:
+
+```text
+root = Stack([headline, metric, chart], "column", "l")
+headline = TextContent("Revenue grew 18% with margin expansion.", "large-heavy")
+metric = Card([label, value], "card")
+label = TextContent("Revenue", "small")
+value = TextContent("$42.0M", "large-heavy")
+chart = BarChart(["2025", "2026"], [series], "grouped", "Year", "Revenue ($M)")
+series = Series("Revenue", [35, 42])
+```
+
+Do not assume these components are allowed or that a custom pack uses `Stack`. Never send HTML, CSS, JavaScript, or Markdown fences as the tool document.