use-agentz 0.1.0 → 0.1.1

package/dist/config/define.js

@@ -4,25 +4,43 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);

package/dist/ui/api.ts

@@ -0,0 +1,286 @@
+/**
+ * Shared API contract types for the AgentZ UI server and its React SPA.
+ *
+ * Browser-safe module: it imports only types from the wizard/core layer, so the
+ * browser bundle never pulls node/bun runtime code in. Both
+ * `src/commands/ui.ts` (server) and `src/ui/web/*` (SPA) import from here so the
+ * wire shapes stay in one place.
+ */
+import type { PreviewModel, WizardState } from "../wizard/shared.ts"
+import type { ReasoningEffort, TierThinking } from "../core/types.ts"
+import type { AgentOverride } from "../registry/config.ts"
+
+export type { PreviewModel, WizardState }
+
+/** Required non-simple header for POST /api/shutdown. */
+export const SHUTDOWN_TOKEN_HEADER = "x-agentz-shutdown-token"
+
+/** One selectable/installable catalog entry (preset, agent, skill, …). */
+export interface CatalogItem {
+  name: string
+  label: string
+  description: string
+}
+
+/** One tier's derived model@effort display for a pack (from pack tier defs). */
+export interface CatalogPackTier {
+  /** Tier name: cheap | normal | expert. */
+  tier: string
+  /** opencode model id, provider prefix stripped (e.g. "claude-opus-4.8"). */
+  model: string
+  /** Reasoning effort from the pack tier's thinking config, if any. */
+  effort?: string
+}
+
+/** A model pack with a human label + description + derived per-tier models. */
+export interface CatalogPack {
+  id: string
+  label: string
+  description: string
+  /**
+   * Per-tier model@effort, DERIVED from the pack's TS tier definitions (never
+   * from prose). Canonical tier order (cheap, normal, expert); tiers the pack
+   * does not define are omitted. Lets the UI render the model chips so the
+   * description can stay use-case focused and never go stale.
+   */
+  tiers: CatalogPackTier[]
+}
+
+/** An MCP entry plus any declarative launch options it exposes. */
+export interface CatalogMcp {
+  name: string
+  label: string
+  description: string
+  options: CatalogMcpOption[]
+}
+
+export interface CatalogMcpOption {
+  id: string
+  label: string
+  description?: string
+  default: boolean
+}
+
+/** GET /api/catalog — everything the UI can offer, with labels/descriptions. */
+export interface CatalogResponse {
+  presets: CatalogItem[]
+  packs: CatalogPack[]
+  agents: CatalogItem[]
+  skills: CatalogItem[]
+  tools: CatalogItem[]
+  plugins: CatalogItem[]
+  commands: CatalogItem[]
+  mcps: CatalogMcp[]
+  /**
+   * Selectable language servers (opencode-only). Dependency-backed and
+   * excludable like plugins/mcps; installs a nested `lsp.<server>` entry.
+   */
+  lsps: CatalogItem[]
+  /**
+   * Selectable rule items (instruction-placement only). The agents-md rule is
+   * excluded server-side — it is controlled by the AGENTS.md mode toggle.
+   */
+  rules: CatalogItem[]
+  targets: { id: string; label: string; detected: boolean }[]
+  reasoningEfforts: ReasoningEffort[]
+  agentsModes: { value: string; label: string }[]
+  defaultPreset: string
+  defaultPack: string
+}
+
+/** GET /api/state — the current on-disk install, if any. */
+export interface StateResponse {
+  /** True when an AgentZ config or lockfile already exists. */
+  installed: boolean
+  /** First recovered preset (back-compat; = presets[0] when preset-based). */
+  preset?: string | undefined
+  /**
+   * ALL presets recovered from the lock (multi-preset installs). Empty/absent
+   * when the install is not preset-based. The setup screen preselects these so
+   * the user can re-toggle any of them.
+   */
+  presets?: string[]
+  /**
+   * True when the install is preset-based (≥1 `preset:` ref is in the lock).
+   * When false the SPA shows a notice on the setup screen (no preset to
+   * preselect) but still lets the user pick presets for the existing project.
+   */
+  presetBased?: boolean
+  modelPack?: string
+  targets?: string[]
+  scope?: "project" | "user"
+  /**
+   * Template variable values from the on-disk AgentZ config's `vars`, carrying
+   * the per-tier model overrides (`model.cheap|normal|expert`)
+   * plus any non-model flags. Restored into the wizard so Modify/reinstall
+   * preserves tier overrides instead of silently dropping them.
+   */
+  vars?: Record<string, string | boolean>
+  /**
+   * Per-agent overrides from the on-disk AgentZ config (`agents`),
+   * keyed by agent id. Restored into the wizard so Modify/reinstall preserves
+   * existing per-agent model/effort overrides (the edge-case override path)
+   * instead of silently dropping them on round-trip.
+   */
+  agents?: Record<string, AgentOverride>
+  /**
+   * Per-tier thinking defaults from the on-disk AgentZ config's `tierThinking`.
+   * Restored into the wizard so Modify/reinstall preserves the
+   * per-tier reasoning-effort defaults instead of dropping them on round-trip.
+   */
+  tierThinking?: TierThinking
+  /** Count of locked items (for the current-install summary). */
+  lockedItems?: number
+  /** Refs currently in the lock (for display). */
+  lockedRefs?: string[]
+  /** Legacy-migration notes (e.g. a renamed/dropped model pack), if any. */
+  migrationNotes?: string[]
+  /**
+   * Lock refs (`type:name`) that are USER-ADDED extras — not covered by the
+   * recovered presets/pack closure. The setup screen restores these into the
+   * wizard's `extra` buckets so a subsequent sync-install does not delete them.
+   */
+  extras?: string[]
+}
+
+/**
+ * GET /api/state response while a UI server is running. `shutdownToken` exists
+ * only in this no-store response and the browser keeps it in memory only.
+ */
+export interface SessionStateResponse extends StateResponse {
+  shutdownToken: string
+}
+
+/** POST /api/preview — request body is a full WizardState. */
+export interface PreviewRequest {
+  state: WizardState
+}
+export interface PreviewResponse {
+  preview: PreviewModel
+  /**
+   * Rendered file previews for the opencode target, extracted from the planner
+   * dry-run: the merged `opencode.json` (always) and the AGENTS.md content
+   * (null when the AGENTS.md block is disabled). For the review <details> panels.
+   */
+  files: PreviewFiles
+  /**
+   * Projected file deletions if this selection is installed now: old lock items
+   * whose ref left the resolution closure (a deselection), refcount-safe against
+   * surviving items. Each entry is the owning lock `ref` + the project-relative
+   * `path`. Empty when the selection is unchanged (idempotence) — the review
+   * screen renders a "Deleted files" affordance only when this is non-empty.
+   */
+  deletions: { ref: string; path: string }[]
+}
+
+export interface PreviewFiles {
+  opencodeJson: string
+  agentsMd: string | null
+}
+
+/** One model offered by GET /api/models (the model-override picker). */
+export interface ModelInfo {
+  id: string
+  name: string
+  reasoning: boolean
+}
+
+/** GET /api/models — tool-capable models, or empty (free-text fallback). */
+export interface ModelsResponse {
+  models: ModelInfo[]
+  /** True when a model list is available (select); false = free-text only. */
+  available: boolean
+  /**
+   * True when the list was scoped to the opencode providers this install is
+   * connected to (auth.json + project provider config). False = showing the
+   * full models.dev catalog (no connected providers detected).
+   */
+  connected: boolean
+}
+
+/** One discovered project (monorepo support). */
+export interface ProjectInfo {
+  /** Root-relative path ("" = the root project itself). */
+  path: string
+  /** Display label (basename, or "(root)"). */
+  label: string
+}
+
+/** GET /api/projects — the root plus any nested AgentZ projects. */
+export interface ProjectsResponse {
+  projects: ProjectInfo[]
+}
+
+/** POST /api/install — request body is a full WizardState. */
+export interface InstallRequest {
+  state: WizardState
+}
+export interface InstallResponse {
+  ok: boolean
+  /** Items installed. */
+  installed: number
+  /** Planner + install notes surfaced to the user. */
+  notes: string[]
+  /** Project-relative file actions, for the result screen. */
+  files: { path: string; status: string }[]
+  /** Path the config was written to (project-relative). */
+  configPath: string
+}
+
+/** Any error response body. */
+export interface ApiError {
+  error: string
+}
+
+/** POST /api/shutdown — server acks, then stops itself shortly after. */
+export interface ShutdownResponse {
+  ok: boolean
+}
+
+/* ================================================================== */
+/* GET /api/graph — dependency graph (for a future designer viz)       */
+/* ================================================================== */
+
+/**
+ * A node in the catalog dependency graph. `id` is the canonical `type:name`
+ * (e.g. `agent:developer`, `skill:caveman`); `type` is the item kind and
+ * `label` its human title. One node per distinct catalog item.
+ */
+export interface GraphNode {
+  /** Canonical `type:name` identity (matches lock/dep refs). */
+  id: string
+  /** Item kind: preset | pack | group | agent | skill | tool | mcp | plugin | command | rule. */
+  type: string
+  /** Human title from the manifest. */
+  label: string
+}
+
+/**
+ * A directed edge `from → to` between two node ids, classified by why the
+ * relationship exists:
+ *  - `dependency` — a manifest `dependencies` link (skill→skill, a tool paired
+ *    with its skill, an agent's required skill, …). The resolver already walks
+ *    these for install; the graph reuses them, it does not re-derive them.
+ *  - `includes`   — a preset pulling in each of its member items.
+ *  - `extra`      — a model pack pulling in its `meta.extras` items (extra
+ *    reviewer agents + skills layered on top of a preset).
+ *  - `group`      — a skills group pulling in its member skills.
+ */
+export interface GraphEdge {
+  /** Source node id (`type:name`). */
+  from: string
+  /** Target node id (`type:name`). */
+  to: string
+  kind: "dependency" | "includes" | "extra" | "group"
+}
+
+/**
+ * GET /api/graph (respects `?project=`) — the full catalog dependency graph as
+ * nodes + edges, for a future designer visualization. Read-only; the SPA does
+ * not consume it yet. Built from the same resolved registry manifests the
+ * installer uses (no re-invented resolution).
+ */
+export interface GraphResponse {
+  nodes: GraphNode[]
+  edges: GraphEdge[]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-agentz",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AgentZ is a Bun-native AI agent setup builder.",
   "type": "module",
   "bin": {
@@ -34,21 +34,21 @@
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@opencode-ai/plugin": "^1.17.0",
+    "@opencode-ai/plugin": "^1.18.4",
     "@types/bun": "^1.3.14",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
     "pdf-lib": "^1.17.1",
     "pptxgenjs": "^4.0.1",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   },
   "dependencies": {
     "@base-ui-components/react": "^1.0.0-rc.0",
-    "@clack/prompts": "^1.5.1",
+    "@clack/prompts": "^1.7.0",
     "confbox": "^0.2.4",
     "picocolors": "^1.1.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "zod": "^4.4.3"
   }
 }