@vendoai/ui 0.4.0

package/dist/wire-types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Structural declarations of wire-response shapes owned by sibling block
+ * contracts (06-apps, 07-automations, 03-agent, 09-vendo §3).
+ *
+ * ui depends on core only (00-overview dependency rule), so shapes that the
+ * wire returns but core does not export are declared here, verbatim from the
+ * frozen contract text. The wire is the contract: both sides derive from the
+ * same frozen documents, so these cannot drift within the version train.
+ */
+import type { AppDocument, AppId, ApprovalRequest, IsoDateTime, RunId, ThreadId, TriggerSource, ToolOutcome, UIPayload } from "@vendoai/core";
+import type { UIMessage } from "ai";
+/** 06-apps §1 — what `GET /apps/:id/open` returns. */
+export type OpenSurface = {
+    kind: "tree";
+    payload: UIPayload;
+    components?: Record<string, string>;
+} | {
+    kind: "http";
+    url: string;
+} | {
+    kind: "resuming";
+    cover?: string;
+};
+/** Existing-agents polish — the flag-gated build-window answer: what
+ *  `GET /apps/:id/open?pending=1` returns while the app is not yet servable
+ *  (the record lands at build completion). Only flagged polls ever see it;
+ *  unflagged callers keep the contracted not-found. */
+export interface PendingSurface {
+    kind: "pending";
+}
+/**
+ * 06-apps §9 — the additive in-client venue verdict riding a tree payload
+ * (`payload.inClient`). SERVER-AUTHORITATIVE: only the runtime's hash-pin
+ * verification writes it. `granted: true` is the ONLY state that lets the
+ * renderer mount generated code in the host page; a missing field and every
+ * other state stay in the sandboxed iframe jail.
+ */
+export type InClientVenue = {
+    granted: true;
+    versionHash: string;
+    approvedBy: string;
+    at: IsoDateTime;
+} | {
+    granted: false;
+    versionHash: string;
+    reason: "version-changed";
+};
+/**
+ * 06-apps §8 — one drifted pin riding a tree payload (`payload.pinDrift`):
+ * the host updated (or removed) the captured component this fork was remixed
+ * from. SERVER-AUTHORITATIVE: only the runtime's baseline comparison writes
+ * it. Informational — the renderer says so loudly but never mutates content;
+ * a rebase is always user-invoked.
+ */
+export interface PinDrift {
+    slot: string;
+    component: string;
+    baseHash: string;
+    baselineHash?: string;
+    reason: "baseline-changed" | "baseline-missing";
+}
+/** 06-apps §8–§9 — what `GET /apps/:id/ship-diff` returns. */
+export interface ShipDiff {
+    appId: AppId;
+    versionHash: string;
+    pins: Array<{
+        slot: string;
+        component: string;
+        baseHash: string;
+        baselineHash?: string;
+        drifted: boolean;
+        diff: string;
+    }>;
+    generated: Array<{
+        component: string;
+        diff: string;
+    }>;
+}
+/** 06-apps §1 — what `POST /apps/:id/edit` returns. */
+export interface EditResult {
+    app: AppDocument;
+    version: VersionEntry;
+    issues?: string[];
+    /** Additive 06 §8 drift report: present when the edited app has drifted pins. */
+    driftedPins?: PinDrift[];
+}
+/**
+ * 06-apps §8 — what `POST /apps/:id/rebase-pin` returns. `failed` persisted
+ * NOTHING: the pre-rebase version stays live and the report lists which
+ * recorded intents replayed, which one failed, and which were never attempted.
+ */
+export type PinRebaseResult = {
+    status: "rebased";
+    app: AppDocument;
+    version: VersionEntry;
+    slot: string;
+    baseHash: string;
+    replayed: string[];
+} | {
+    status: "failed";
+    slot: string;
+    baseHash: string;
+    replayed: string[];
+    failed: {
+        intent: string;
+        issues: string[];
+    };
+    remaining: string[];
+};
+/**
+ * 06-apps §8 — what `POST /apps/fork-pin` and `POST /apps/:id/fork-pin`
+ * return: the gesture-owned DETERMINISTIC fork (engine copies the captured
+ * baseline and records the pin; no model call). `version` describes the fork
+ * itself; `edit` is present only when the gesture carried an instruction —
+ * the ordinary edit that ran afterwards, already scoped to the forked
+ * component. A failed `edit` never rolls the fork back, so `app` is always at
+ * least the faithful fork.
+ */
+export interface PinForkResult {
+    app: AppDocument;
+    version: VersionEntry;
+    slot: string;
+    componentName: string;
+    edit?: EditResult;
+}
+/** 06-apps §1 — one entry of `GET /apps/:id/history`. */
+export interface VersionEntry {
+    at: IsoDateTime;
+    intent: string;
+    rung: 1 | 2 | 3 | 4;
+}
+/** 04-actions §3 — one per-user connected account as `GET /connections` returns it. */
+export interface ConnectionAccount {
+    id: string;
+    connector: string;
+    toolkit: string;
+    status: "initiated" | "active" | "expired" | "failed";
+    createdAt?: IsoDateTime;
+}
+/** 04-actions §3 — what `POST /connections/initiate` returns. */
+export interface InitiatedConnection {
+    id: string;
+    connector: string;
+    redirectUrl: string;
+}
+/** One connectable toolkit as `GET /connections/catalog` advertises it — the
+    connect dock's auto catalog when the host passes no explicit list. */
+export interface ConnectableToolkit {
+    toolkit: string;
+    connector: string;
+    label?: string;
+    /** One-line capability blurb (provider metadata); surfaces may ignore it. */
+    description?: string;
+}
+/** 07-automations §5 */
+export type RunStatus = "running" | "ok" | "error" | "stopped" | "pending-approval";
+/** 07-automations §5 — what `/runs` routes return. */
+export interface RunRecord {
+    id: RunId;
+    appId: AppId;
+    trigger: {
+        kind: TriggerSource["kind"];
+        event?: string;
+    };
+    status: RunStatus;
+    startedAt: IsoDateTime;
+    finishedAt?: IsoDateTime;
+    steps: Array<{
+        id: string;
+        tool: string;
+        outcome: ToolOutcome["status"];
+        at: IsoDateTime;
+        detail?: string;
+    }>;
+    summary?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/** 07-automations §1 — what `POST /automations/:id/dry-run` returns. */
+export interface RunPlan {
+    steps: Array<{
+        id: string;
+        tool: string;
+        wouldAsk: boolean;
+    }>;
+    grantsMissing: string[];
+}
+/** 07-automations §1 — one entry of `GET /automations`. */
+export interface AutomationEntry {
+    app: AppDocument;
+    enabled: boolean;
+}
+/** 07-automations §1 — what `POST /automations/:id/enable` returns. */
+export interface EnableResult {
+    enabled: boolean;
+    missing: ApprovalRequest[];
+}
+/** Existing-agents — what `GET /approvals/:id` returns for a parked BYO
+ *  guarded call: the frozen `VendoApprovalEmbedState` vocabulary, carrying
+ *  the full request while pending (the consent card shows real inputs) and
+ *  the resumed call's outcome once executed (errors included — the embed
+ *  renders them with the existing failed vocabulary, never a blank).
+ *  Mirrors the umbrella's `ByoApprovalResolution`. */
+export type ApprovalResolution = {
+    state: "pending";
+    request: ApprovalRequest;
+} | {
+    state: "executed";
+    outcome: ToolOutcome;
+} | {
+    state: "declined";
+} | {
+    state: "expired";
+};
+/** 03-agent §5 — what `GET /threads/:id` returns. */
+export interface Thread {
+    id: ThreadId;
+    subject: string;
+    messages: UIMessage[];
+    createdAt: IsoDateTime;
+    updatedAt: IsoDateTime;
+}
+/** 03-agent §5 — one entry of `GET /threads`. */
+export interface ThreadSummary {
+    id: ThreadId;
+    title: string;
+    updatedAt: IsoDateTime;
+}
+/** 05-guard §1 `status()` / 09-vendo §3 — what `GET /status` returns. */
+export type GuardPosture = "unconfigured" | "rules" | "judge" | "rules+judge";
+export interface VendoStatus {
+    posture: GuardPosture;
+    version: string;
+    blocks: Record<string, unknown>;
+}
+//# sourceMappingURL=wire-types.d.ts.map

package/dist/wire-types.d.ts.map

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

package/dist/wire-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wire-types.js.map

package/dist/wire-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-types.js","sourceRoot":"","sources":["../src/wire-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@vendoai/ui",
+  "version": "0.4.0",
+  "description": "Headless hooks + optional chrome for Vendo: the client, every surface, the vendo-genui/v2 tree renderer, and the voice stage.",
+  "keywords": [
+    "ai",
+    "agent",
+    "genui",
+    "react",
+    "vendo"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runvendo/vendo.git",
+    "directory": "packages/ui"
+  },
+  "homepage": "https://vendo.run",
+  "bugs": "https://github.com/runvendo/vendo/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./chrome": {
+      "types": "./dist/chrome/index.d.ts",
+      "default": "./dist/chrome/index.js"
+    },
+    "./tree": {
+      "types": "./dist/tree/index.d.ts",
+      "default": "./dist/tree/index.js"
+    },
+    "./kit": {
+      "types": "./dist/kit/index.d.ts",
+      "default": "./dist/kit/index.js"
+    },
+    "./voice": {
+      "types": "./dist/voice/index.d.ts",
+      "default": "./dist/voice/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ai-sdk/react": "3.0.30",
+    "@tanstack/react-table": "^8.20.0",
+    "fluidkit": "^0.5.0",
+    "motion": "^11.11.0",
+    "react-markdown": "^9.0.1",
+    "recharts": "^3.2.0",
+    "remark-gfm": "^4.0.0",
+    "sucrase": "^3.35.0",
+    "zod": "^3.25.76",
+    "@vendoai/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "ai": "^6.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.10.0",
+    "@modelcontextprotocol/ext-apps": "^1.7.4",
+    "@playwright/test": "^1.49.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "ai": "6.0.28",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build:jail": "node scripts/build-jail-runtime.mjs",
+    "prebuild": "pnpm run build:jail",
+    "build": "tsc -p tsconfig.json",
+    "postbuild": "node scripts/build-eject-templates.mjs",
+    "pretest": "pnpm run build:jail",
+    "test": "vitest run",
+    "pretest:coverage": "pnpm run build:jail",
+    "pretypecheck": "pnpm run build:jail",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pretest:browser": "pnpm run build:jail",
+    "test:browser": "playwright test",
+    "test:mcp-shim": "playwright test --config e2e/mcp-shim.config.ts",
+    "build:mcp-shim": "node scripts/build-mcp-app-shim.mjs",
+    "build:onest-font": "node scripts/build-onest-font.mjs",
+    "test:coverage": "vitest run --coverage"
+  }
+}