@hanzo/build 0.2.52 → 0.2.54

package/lib/api/work.js

@@ -1,31 +1,33 @@
 /**
- * Projects and issues, as the forge holds them.
+ * The work an organization does: its projects, their issues, and its boards.
  *
- * A project is a board. A board is a repository that has work on it, so the
- * list is the forge's answer and not a second copy of it.
+ *   GET /v1/provider/github/repos?q=&owner=&limit=&after=   what the GitHub connection grants, most recently pushed first
+ *   GET /v1/provider/github/installations                    the GitHub accounts it grants them from
+ *   GET /v1/git/repos                                        the forge's repositories
+ *   GET /v1/task/board                                       every issue and pull request: the forge's, and the task index's
+ *   GET /v1/task/projects                                    the boards
+ *   GET /v1/task/projects/{key}/issues                       one board's
  *
- *   GET /v1/task/projects                     the boards
- *   GET /v1/task/board                        every board's issues
- *   GET /v1/task/projects/{key}/issues        one board's issues
+ * A project is a repository, so the list is those sources merged (merge.ts) and
+ * not a second copy of them. An issue row from the board is read for what it
+ * is: a forge issue names its forge repository and links to its page; a GitHub
+ * issue the index mirrors names its address only in `extRef`
+ * (`github:<owner>/<name>#<n>`), and its `number` there is the board's, not
+ * GitHub's; any other index row's `repo` is what its writer said — a run's
+ * repository, or a Linear team's key — and is resolved, never used raw.
  *
  * Creating, renaming and deleting a board are forge operations. This surface
  * reads the work and opens a run against it.
  */
-import { call, seg } from './call.js';
-/** The project an item is filed under: its repository, else its board. */
-export const projectOf = (w) => w.repo || w.project;
-/** Done and canceled are closed; every other column is open work. */
-export const closed = (w) => w.status === 'done' || w.status === 'canceled';
-/** Whether `w` belongs to the project `key` — by repository or by board, either case. */
-export function inProject(w, key) {
-    const k = key.toLowerCase();
-    return w.repo.toLowerCase() === k || w.project.toLowerCase() === k;
-}
+import { call } from './call.js';
+import { codebases } from './codebases.js';
+import { installations, repos as granted } from './github.js';
+import { assemble, canon, issues as merged, owners } from '../merge.js';
+import { links } from './links.js';
+import { projects as built } from './projects.js';
 const str = (v) => (typeof v === 'string' ? v : '');
-/** The platform states seconds; a value already in milliseconds is kept. */
-const when = (v) => (typeof v === 'number' && Number.isFinite(v) && v > 0 ? (v < 1e12 ? v * 1000 : v) : 0);
-const https = (v) => (typeof v === 'string' && /^https:\/\//.test(v) ? v : '');
-const obj = (v) => v && typeof v === 'object' ? v : {};
+const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
+const obj = (v) => (v && typeof v === 'object' ? v : {});
 function rows(raw) {
     if (Array.isArray(raw))
         return raw;
@@ -43,42 +45,128 @@ export function board(raw) {
         return null;
     return { id: str(o.id) || key, key, name: str(o.name) || key, description: str(o.description) };
 }
+/** Unix seconds as RFC 3339, or ''. */
+const instant = (s) => (s > 0 ? new Date(s * 1000).toISOString() : '');
+const FINISHED = new Set(['done', 'canceled']);
+const GITHUB = /^github:([A-Za-z0-9][A-Za-z0-9-]*)\/([A-Za-z0-9._-]+)#(\d+)$/;
+/** Where an index row came from, by the reference its writer keyed it with. */
+function origin(ext) {
+    if (ext.startsWith('github:'))
+        return 'github';
+    if (ext.startsWith('linear:'))
+        return 'linear';
+    if (ext.startsWith('agent:'))
+        return 'agent';
+    return 'board';
+}
+/** One board row as an issue: what it is, where it lives, and which repository it says it is for. */
 export function work(raw) {
     const o = obj(raw);
     const title = str(o.title);
-    const project = str(o.projectKey);
-    const number = typeof o.number === 'number' ? o.number : 0;
-    if (!title && !project)
+    const key = str(o.projectKey);
+    const n = num(o.number);
+    if (!title && !key)
         return null;
+    const ext = str(o.extRef);
+    const gh = ext.match(GITHUB);
+    const page = canon(str(o.url));
+    // A forge row links to its own page and carries no reference of another host's.
+    const forge = !ext && page ? str(o.repo) : '';
+    const url = gh ? `https://github.com/${gh[1]}/${gh[2]}/issues/${gh[3]}` : page;
+    const assignee = str(o.assignee);
     return {
-        id: str(o.id) || `${project}#${number}`,
-        identifier: str(o.identifier) || (project && number ? `${project}#${number}` : ''),
-        project,
-        number,
-        kind: str(o.kind) || 'issue',
+        key: canon(url) || (key && n ? `${key}#${n}`.toLowerCase() : '') || str(o.id),
+        repo: gh ? `${gh[1]}/${gh[2]}` : '',
+        forge,
+        // A run's repository, or what a writer of the index named; a Linear row's `repo` is its team's key and never one.
+        hint: gh || forge || origin(ext) === 'linear' ? '' : str(o.repo),
+        number: gh ? Number(gh[3]) : n,
         title: title || 'Untitled',
+        body: str(o.description),
+        state: FINISHED.has(str(o.status)) ? 'closed' : 'open',
+        labels: (Array.isArray(o.labels) ? o.labels : []).filter((l) => typeof l === 'string' && l.trim() !== ''),
+        assignees: assignee ? [assignee] : [],
+        url,
+        sources: [forge ? 'forge' : origin(ext)],
+        updated: instant(num(o.updatedAt)) || instant(num(o.createdAt)),
+        created: instant(num(o.createdAt)),
+        kind: str(o.kind) || 'issue',
         status: str(o.status) || 'backlog',
         priority: str(o.priority) || 'none',
-        assignee: str(o.assignee),
-        repo: str(o.repo),
-        source: str(o.source),
-        labels: Array.isArray(o.labels) ? o.labels.filter((l) => typeof l === 'string' && l !== '') : [],
-        url: https(o.url) || https(o.extRef),
-        created: when(o.createdAt),
-        updated: when(o.updatedAt),
+        pull: str(o.kind) === 'pr',
+        board: key,
     };
 }
-export async function boards(t) {
-    const raw = await call(t, 'GET', '/v1/task/projects');
+export async function boards(t, signal) {
+    const raw = await call(t, 'GET', '/v1/task/projects', undefined, { signal });
     return rows(raw)
         .map(board)
         .filter((b) => b !== null);
 }
-/** A board's issues, or every board's when `key` is empty. */
-export async function issues(t, key = '') {
-    const path = key ? `/v1/task/projects/${seg(key)}/issues` : '/v1/task/board';
-    const raw = await call(t, 'GET', path);
-    return rows(raw)
-        .map(work)
-        .filter((w) => w !== null);
+const issuesOf = (raw) => merged(rows(raw)
+    .map(work)
+    .filter((w) => w !== null));
+/** Every issue and pull request the org has, from the forge and the task index, each once. */
+export async function everything(t, signal) {
+    return issuesOf(await call(t, 'GET', '/v1/task/board', undefined, { signal }));
+}
+/**
+ * What the org's projects are made from, each read on its own: the links (GET
+ * /v1/sync), the forge's repositories, the org's projects, and GitHub's grants
+ * — searched and paged by GitHub, and empty for an operator with no GitHub of
+ * their own, which is why it is never the only source. One that fails leaves the
+ * others standing and is named in `missing`. A next page reads GitHub alone.
+ */
+export async function sources(t, p = {}, signal) {
+    const missing = [];
+    const soft = (what, read) => read.catch((e) => {
+        if (signal?.aborted)
+            throw e;
+        missing.push(what);
+        return null;
+    });
+    const first = !p.after;
+    const [hub, linked, forge, sites, accounts] = await Promise.all([
+        soft('GitHub', granted(t, { q: p.q, owner: p.owner, limit: 100, after: p.after }, signal)),
+        first ? soft('the linked repositories', links(t, signal)) : null,
+        first ? soft('the forge', codebases(t)) : null,
+        first ? soft('the projects', built(t)) : null,
+        first ? installations(t).catch(() => []) : [],
+    ]);
+    return {
+        hub: hub?.repos ?? [],
+        linked: linked ?? [],
+        held: (forge ?? []).map((c) => ({ org: c.org, name: c.name, description: c.description, branch: c.branch, public: c.public, updated: c.updated })),
+        sites: (sites ?? []).filter((x) => x.repo).map((x) => ({ slug: x.slug, repo: x.repo, branch: x.branch, updated: x.updated ? new Date(x.updated * 1000).toISOString() : '' })),
+        owners: owners(accounts.map((a) => a.login), (linked ?? []).map((l) => l.owner)),
+        next: hub?.next ?? '',
+        unread: hub?.unread ?? [],
+        missing,
+    };
+}
+/**
+ * Every repository on the forge a run can work on: the forge's own and every
+ * linked repository's copy (GET /v1/git/repos does not list an estate's copies;
+ * GET /v1/sync does). Throws only when neither answered.
+ */
+export async function homes(t, signal) {
+    const failed = [];
+    const soft = (read) => read.catch((e) => {
+        failed.push(e);
+        return null;
+    });
+    const [linked, forge] = await Promise.all([soft(links(t, signal)), soft(codebases(t))]);
+    if (!linked && !forge)
+        throw failed[0];
+    const list = assemble({
+        linked: linked ?? [],
+        held: (forge ?? []).map((c) => ({ org: c.org, name: c.name, description: c.description, branch: c.branch, public: c.public, updated: c.updated })),
+    });
+    return {
+        homes: list
+            .filter((p) => p.forge)
+            .map((p) => ({ name: p.forge, label: `${p.owner}/${p.name}`, branch: p.branch || 'main' }))
+            .sort((a, b) => a.label.localeCompare(b.label)),
+        whole: failed.length === 0,
+    };
 }

package/lib/builder.d.ts

@@ -1,14 +1,4 @@
-import { type RailLink } from '@hanzo/ui/chat';
 import { type Host } from './host.tsx';
-/**
- * The builder's places, as a rail draws them: four in view and the rest under
- * More. Every one moves the builder through `go`, so a host that draws its own
- * rail lists the same places, in the same words, as the builder's rail does.
- */
-export declare function nav(host: Host, go: (path: string) => void): {
-    links: RailLink[];
-    more: RailLink[];
-};
 /**
  * The builder. Mount it under a gui root (`<Hanzo>`), in a box with a height.
  *

package/lib/builder.js

@@ -14,8 +14,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *   /<org>/<repo> a repository's workspace, in this same window
  *   /<slug>      a deployed site's workspace
  *
- * The rail is the sessions rail every Hanzo surface shares: New, the builder's
- * places with the rest under More, the org's coding runs newest first with a
+ * The rail is the sessions rail every Hanzo surface shares: New, every one of
+ * the builder's places (nav.tsx), the org's coding runs newest first with a
  * live status dot, and at the foot the offer of Hanzo in Slack and the account,
  * whose menu opens Settings, Usage, the plans, help and logging out (foot.tsx).
  * Its collapse is an explicit toggle kept per browser.
@@ -24,23 +24,23 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * panes — and its mark leads back here.
  *
  * A host with a rail of its own mounts `<Builder rail={false}>` and draws the
- * builder's places (`nav`) and runs in that rail (`useSessions`, or `DevSection`,
- * section.tsx): one left column, never two.
+ * builder's places (`nav`, nav.tsx) and runs in that rail (`useSessions`, or
+ * `DevSection`, section.tsx): one left column, never two.
  */
 import { SizableText, XStack, YStack } from '@hanzo/gui';
-import { Blocks, BookOpen, CircleDot, Cpu, FolderGit2, LayoutTemplate, Menu, Search, SlidersHorizontal, Workflow } from '@hanzogui/lucide-icons-2';
+import { Menu, Search } from '@hanzogui/lucide-icons-2';
 import { Button } from '@hanzo/ui';
 import { SessionRail } from '@hanzo/ui/chat';
 import { HanzoMark } from '@hanzo/ui/product';
 import { useMemo, useState } from 'react';
 import { safe } from './api/projects.js';
-import { pinBoard } from './choice.js';
 import { Customize } from './customize/index.js';
 import { Editor } from './automations.js';
 import { useKept, useRecents } from './data.js';
 import { Forge } from './forge.js';
 import { HostProvider, useHost, useTarget } from './host.js';
 import { Landing } from './landing.js';
+import { nav, NEW } from './nav.js';
 import { PrefsProvider } from './prefs.js';
 import { Project } from './project.js';
 import { Plans } from './plans.js';
@@ -49,7 +49,7 @@ import { Run } from './run.js';
 import { DOTS } from './section.js';
 import { Artifacts, Templates } from './shelf.js';
 import { Find } from './find.js';
-import { DOCS, Slack, useWho, Who } from './foot.js';
+import { Slack, useWho, Who } from './foot.js';
 import { Settings } from './settings/index.js';
 function Shell() {
     const host = useHost();
@@ -77,8 +77,11 @@ function Shell() {
     // switched from the account menu at the foot. Beside the rail from md up, beside
     // the drawer's button below it — one place at a time.
     const name = _jsx(Name, { onPress: () => go('') });
-    const { links, more } = nav(host, go);
-    return (_jsxs(XStack, { flex: 1, minH: 0, minW: 0, bg: "$background", children: [_jsxs(YStack, { position: "relative", shrink: 0, children: [_jsx(SessionRail, { onNew: () => go(''), fresh: r.kind === 'new', links: links, more: more, recents: rows, active: r.kind === 'run' ? r.id : null, onOpen: (id) => go(id), onSort: () => setOrder(order === 'newest' ? 'running' : 'newest'), sortLabel: order === 'newest' ? 'Show running first' : 'Show newest first', empty: _jsx(SizableText, { size: "$1", color: "$soft", px: "$2", children: !host.person ? 'Sign in to see your runs.' : recents.error ? recents.error.message : recents.loading ? 'Reading…' : 'No runs yet.' }), notice: host.person && !slack ? (_jsx(Slack, { onOpen: () => go(path({ kind: 'settings', section: 'integrations' })), onDismiss: () => setSlack(true) })) : undefined, account: host.person
+    // Every place in view, none behind a More; the rail's own New starts a run.
+    const links = nav(host, go)
+        .flatMap((g) => g.links)
+        .filter((l) => l.id !== NEW);
+    return (_jsxs(XStack, { flex: 1, minH: 0, minW: 0, bg: "$background", children: [_jsxs(YStack, { position: "relative", shrink: 0, children: [_jsx(SessionRail, { onNew: () => go(''), fresh: r.kind === 'new', links: links, recents: rows, active: r.kind === 'run' ? r.id : null, onOpen: (id) => go(id), onSort: () => setOrder(order === 'newest' ? 'running' : 'newest'), sortLabel: order === 'newest' ? 'Show running first' : 'Show newest first', empty: _jsx(SizableText, { size: "$1", color: "$soft", px: "$2", children: !host.person ? 'Sign in to see your runs.' : recents.error ? recents.error.message : recents.loading ? 'Reading…' : 'No runs yet.' }), notice: host.person && !slack ? (_jsx(Slack, { onOpen: () => go(path({ kind: 'settings', section: 'integrations' })), onDismiss: () => setSlack(true) })) : undefined, account: host.person
                             ? {
                                 // Who, and in which organization, as claude.ai says who and on which plan.
                                 name: [host.person.name || host.person.email, host.org].filter(Boolean).join(' · '),
@@ -89,49 +92,6 @@ function Shell() {
                             }
                             : { name: 'Sign in', onPress: () => host.signIn?.() }, collapsed: collapsed, onCollapse: setCollapsed, mark: _jsx(Brand, { org: host.org, logo: host.logo }), pt: collapsed ? undefined : 92, open: drawer, onOpenChange: setDrawer, label: "Runs" }), collapsed ? null : (_jsxs(YStack, { position: "absolute", t: 10, l: 8, r: 8, z: 2, gap: "$2.5", "$max-md": { display: 'none' }, children: [_jsx(XStack, { px: "$2.5", children: name }), _jsxs(XStack, { render: "button", "aria-label": "Search runs", onPress: () => setFinding(true), items: "center", gap: "$2", px: "$2.5", height: 34, rounded: "$3", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", hoverStyle: { bg: '$hover' }, children: [_jsx(Search, { size: 15, color: "$soft" }), _jsx(SizableText, { size: "$2", color: "$soft", children: "Search" })] })] })), host.person ? _jsx(Who, { open: who.open, onOpenChange: who.onOpenChange, narrow: collapsed }) : null] }), _jsxs(YStack, { flex: 1, minW: 0, minH: 0, position: "relative", children: [_jsxs(XStack, { height: 44, px: "$2", gap: "$2", items: "center", shrink: 0, $md: { display: 'none' }, children: [_jsx(Button, { variant: "ghost", size: "icon-sm", onPress: () => setDrawer(true), "aria-label": "Open runs", children: _jsx(Menu, { size: 18 }) }), name, _jsx(XStack, { flex: 1 }), _jsx(Button, { variant: "ghost", size: "icon-sm", onPress: () => setFinding(true), "aria-label": "Search runs", children: _jsx(Search, { size: 18 }) })] }), _jsx(Pane, { onStarted: () => recents.reload() })] }), _jsx(Find, { open: finding, onOpenChange: setFinding, recents: rows, onOpen: (id) => { setFinding(false); go(id); } })] }));
 }
-/**
- * The builder's places, as a rail draws them: four in view and the rest under
- * More. Every one moves the builder through `go`, so a host that draws its own
- * rail lists the same places, in the same words, as the builder's rail does.
- */
-export function nav(host, go) {
-    const r = route(host.path);
-    const screen = r.kind === 'screen' ? r.screen : '';
-    const links = [
-        {
-            id: 'projects',
-            label: 'Projects',
-            icon: _jsx(FolderGit2, { size: 16 }),
-            onPress: () => go(path({ kind: 'screen', screen: 'projects' })),
-            active: screen === 'projects' || screen === 'sync' || r.kind === 'repo',
-        },
-        { id: 'artifacts', label: 'Artifacts', icon: _jsx(Blocks, { size: 16 }), onPress: () => go(path({ kind: 'screen', screen: 'artifacts' })), active: screen === 'artifacts' },
-        { id: 'customize', label: 'Customize', icon: _jsx(SlidersHorizontal, { size: 16 }), onPress: () => go(path({ kind: 'customize', tab: 'skills' })), active: r.kind === 'customize' || screen === 'mcp' },
-        { id: 'automations', label: 'Automations', icon: _jsx(Workflow, { size: 16 }), onPress: () => go(path({ kind: 'screen', screen: 'automations' })), active: screen === 'automations' || r.kind === 'automation' },
-    ];
-    const more = [
-        {
-            id: 'issues',
-            label: 'Issues',
-            icon: _jsx(CircleDot, { size: 16 }),
-            onPress: () => {
-                pinBoard(host.org, '');
-                go(path({ kind: 'screen', screen: 'issues' }));
-            },
-            active: screen === 'issues',
-        },
-        { id: 'templates', label: 'Templates', icon: _jsx(LayoutTemplate, { size: 16 }), onPress: () => go(path({ kind: 'screen', screen: 'templates' })), active: screen === 'templates' },
-        {
-            id: 'machines',
-            label: 'Machines',
-            icon: _jsx(Cpu, { size: 16 }),
-            onPress: () => go(path({ kind: 'settings', section: 'machines' })),
-            active: r.kind === 'settings' && r.section === 'machines',
-        },
-        { id: 'docs', label: 'Docs', icon: _jsx(BookOpen, { size: 16 }), onPress: () => window.open(DOCS, '_blank', 'noopener,noreferrer') },
-    ];
-    return { links, more };
-}
 /** The wordmark: the product's name, as its host calls it, which leads to New. */
 function Name({ onPress }) {
     const { name } = useHost();

package/lib/choice.d.ts

@@ -6,6 +6,7 @@
  * model and the machine; it only replaces the fields the caller names.
  */
 import { type Codebase, type ForgeRepo } from './api/codebases.ts';
+import type { Project } from './merge.ts';
 export interface Choice {
     repo: ForgeRepo | null;
     branch: string;
@@ -15,12 +16,32 @@ export interface Choice {
     effort: string;
     /** A draft handed over by another screen. New copies it once and clears it. */
     ask: string;
+    /** The issue that draft is, by the number the run's pull request closes; 0 for none. Handed over with it. */
+    issue: number;
 }
 export declare const boardKey: (org: string | null) => string;
+/**
+ * The choice New opens on, field by field: the last layer that says something
+ * wins. What was kept here, over the person's coding defaults, over the first
+ * run's. A field kept as '' stays '' (the default branch, the sandbox): only a
+ * field that is absent falls through, so a codebase or an issue handed over from
+ * its own screen — which keeps the codebase and the words alone — still opens on
+ * a model, a mode and an effort.
+ */
+export declare function settle<T extends object>(first: T, ...layers: (Partial<T> | null | undefined)[]): T;
 /** Point New at a forge codebase, and optionally a first draft. */
 export declare function pinCodebase(org: string | null, c: Codebase, ask?: string): void;
 /** Which board Issues is showing. '' is every board. */
 export declare function pinBoard(org: string | null, key: string): void;
+/**
+ * Point New at a project, and optionally a first draft (an issue's ask) and the
+ * issue it closes. `where` is where the run works (merge.ts `home`): on the forge
+ * it is chosen by its forge name, which is what a run and its environment
+ * address; on GitHub by GitHub's address, so the run clones and proposes there.
+ * Left out, the forge when the project is there. A project that is neither
+ * cannot be worked on, and is refused here rather than handed to the platform.
+ */
+export declare function pinRepo(org: string | null, p: Project, ask?: string, issue?: number, where?: 'github' | 'forge' | null): void;
 /**
  * A repository on GitHub, chosen from the org's installation: the run works there.
  * Its `full_name` is GitHub's address, `github.com/owner/name` — what the list

package/lib/choice.js

@@ -26,10 +26,27 @@ function write(org, value) {
         /* the next New starts empty */
     }
 }
+/**
+ * The choice New opens on, field by field: the last layer that says something
+ * wins. What was kept here, over the person's coding defaults, over the first
+ * run's. A field kept as '' stays '' (the default branch, the sandbox): only a
+ * field that is absent falls through, so a codebase or an issue handed over from
+ * its own screen — which keeps the codebase and the words alone — still opens on
+ * a model, a mode and an effort.
+ */
+export function settle(first, ...layers) {
+    let out = { ...first };
+    for (const layer of layers) {
+        if (!layer || typeof layer !== 'object' || Array.isArray(layer))
+            continue;
+        out = { ...out, ...Object.fromEntries(Object.entries(layer).filter(([, v]) => v !== undefined && v !== null)) };
+    }
+    return out;
+}
 /** Point New at a forge codebase, and optionally a first draft. */
 export function pinCodebase(org, c, ask = '') {
     const repo = asRepo(c);
-    write(org, { ...read(org), repo, branch: repo.default_branch, ask });
+    write(org, { ...read(org), repo, branch: repo.default_branch, ask, issue: 0 });
 }
 /** Which board Issues is showing. '' is every board. */
 export function pinBoard(org, key) {
@@ -41,6 +58,28 @@ export function pinBoard(org, key) {
     }
     window.dispatchEvent(new CustomEvent('hanzo-board', { detail: key }));
 }
+/**
+ * Point New at a project, and optionally a first draft (an issue's ask) and the
+ * issue it closes. `where` is where the run works (merge.ts `home`): on the forge
+ * it is chosen by its forge name, which is what a run and its environment
+ * address; on GitHub by GitHub's address, so the run clones and proposes there.
+ * Left out, the forge when the project is there. A project that is neither
+ * cannot be worked on, and is refused here rather than handed to the platform.
+ */
+export function pinRepo(org, p, ask = '', issue = 0, where = p.forge ? 'forge' : p.linked ? 'github' : null) {
+    const branch = p.branch || 'main';
+    let repo;
+    if (where === 'forge' && p.forge) {
+        repo = { owner: org ?? '', name: p.forge, full_name: org ? `${org}/${p.forge}` : p.forge, private: p.private ?? true, default_branch: branch, pushed_at: '', installation_id: 0, forge: true, clone: '' };
+    }
+    else if (where === 'github' && p.linked) {
+        repo = asHub({ owner: p.owner, name: p.name, full_name: `${p.owner}/${p.name}`, private: p.private ?? true, default_branch: branch, pushed_at: '', installation_id: 0 });
+    }
+    else {
+        throw new Error(`${p.owner}/${p.name} is neither on the forge nor linked from GitHub`);
+    }
+    write(org, { ...read(org), repo, branch, ask, issue });
+}
 export const isHub = (repo) => Boolean(repo && repo.github === true && repo.full_name?.startsWith('github.com/'));
 /** A GitHub listing row as the composer offers it. */
 export const asHub = (r) => ({ ...r, full_name: `github.com/${r.owner}/${r.name}`, github: true });

package/lib/customize/agents.d.ts

@@ -1,2 +1,2 @@
 import { type Pane } from './ui.tsx';
-export declare function Agents({ view, q, adding, onAdding, onView }: Pane): import("react").JSX.Element;
+export declare function Agents({ view, q, adding, onAdding, onView, onCount }: Pane): import("react").JSX.Element;

package/lib/customize/agents.js

@@ -3,12 +3,13 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  * Agents: the org's own — a model, instructions, the tools it may call, and
  * what it may spend.
  *
- * Yours lists them; opening one edits it in place, and only what changed is
- * sent. An agent calls only the tools it names, and only those that are on for
- * the org, so the choices are the tools that are on; "every tool" is whatever
- * the fleet's MCP server serves when it runs. A budget is required: what it may
- * spend each period, and in one run. Discover is the platform's presets whose
- * tool calls run on the platform; adding one opens a new agent written from it.
+ * Browse is the platform's presets whose tool calls run on the platform;
+ * starting from one opens a new agent written from it. Yours lists the org's
+ * agents; opening one edits it in place, and only what changed is sent. An
+ * agent calls only the tools it names, and only those that are on for the org,
+ * so the choices are the tools that are on; "every tool" is whatever the
+ * fleet's MCP server serves when it runs. A budget is required: what it may
+ * spend each period, and in one run.
  */
 import { SizableText, XStack, YStack } from '@hanzo/gui';
 import { Bot } from '@hanzogui/lucide-icons-2';
@@ -18,17 +19,18 @@ import { useEffect, useMemo, useState } from 'react';
 import { agents, ALL, create, draft, EMPTY, fromPreset, one, PERIODS, presets, remove, update } from '../api/agents.js';
 import { models } from '../api/models.js';
 import { tools } from '../api/tools.js';
-import { useRead } from '../data.js';
 import { useHost, useTarget } from '../host.js';
-import { Add, Choice, Confirm, Field, Grid, Line, Mark, matches, mono, Sheet, Soft, Tile, Visitor } from './ui.js';
-/** The model a new agent runs on when none is chosen: the deployment's own default. */
+import { useLoad } from './load.js';
+import { say } from './say.js';
+import { Add, Choice, Confirm, Empty, Failed, Field, Grid, Line, Mark, matches, mono, Part, Sheet, Soft, Tile, useCount, Visitor } from './ui.js';
 const money = (m) => `$${(m / 1_000_000).toFixed(m % 10_000 ? 4 : 2).replace(/\.?0+$/, '')}`;
-export function Agents({ view, q, adding, onAdding, onView }) {
+export function Agents({ view, q, adding, onAdding, onView, onCount }) {
     const host = useHost();
     const t = useTarget();
     const signed = Boolean(host.person);
-    const mine = useRead(signed ? () => agents(t) : null, [], [t, signed]);
-    const offered = useRead(view === 'discover' ? () => presets(t) : null, [], [t, view]);
+    const mine = useLoad(signed ? () => agents(t) : null, [], [t, signed]);
+    const offered = useLoad(view === 'discover' ? () => presets(t) : null, [], [t, view]);
+    useCount(mine.value.length, onCount);
     const [opened, setOpened] = useState(null);
     const [start, setStart] = useState(null);
     const [note, setNote] = useState('');
@@ -53,13 +55,13 @@ export function Agents({ view, q, adding, onAdding, onView }) {
     if (view === 'discover') {
         const names = new Set(mine.value.map((a) => a.name));
         const shown = offered.value.filter((p) => matches(q, p.id, p.title, p.prompt));
-        return (_jsxs(YStack, { gap: "$3", children: [offered.error && !offered.value.length ? (_jsx(Soft, { children: offered.error.message })) : offered.loading && !offered.value.length ? (_jsx(Soft, { children: "Reading the presets\u2026" })) : !shown.length ? (_jsx(Soft, { children: offered.value.length ? 'No preset matches.' : 'The platform offers no presets.' })) : (_jsxs(_Fragment, { children: [_jsx(SizableText, { size: "$1", color: "$soft", children: "Presets from the platform. Adding one opens a new agent written from it, to change before it is saved." }), _jsx(Grid, { label: "Presets", children: shown.map((p) => (_jsx(Tile, { title: p.title || p.id, detail: p.prompt, meta: `Preset ${p.id}`, mark: _jsx(Mark, { name: p.title || p.id, icon: _jsx(Bot, { size: 15 }) }), action: signed ? _jsx(Add, { name: p.title || p.id, added: names.has(p.id), onPress: () => setStart(fromPreset(p)) }) : undefined }, p.id))) })] })), editor] }));
+        return (_jsxs(YStack, { gap: "$3", children: [_jsx(Line, { children: note }), _jsx(Part, { title: "Start from a preset", detail: "A ready agent from Hanzo. You can change it before you save it.", children: offered.error && !offered.value.length ? (_jsx(Failed, { error: offered.error, onRetry: offered.reload })) : offered.loading && !offered.value.length ? (_jsx(Soft, { children: "Loading presets\u2026" })) : !shown.length ? (_jsx(Soft, { children: offered.value.length ? `No preset matches “${q.trim()}”.` : 'There are no presets yet. Start from a blank agent with New agent.' })) : (_jsx(Grid, { label: "Presets", children: shown.map((p) => (_jsx(Tile, { title: p.title || p.id, detail: p.prompt, meta: `Preset ${p.id}`, mark: _jsx(Mark, { name: p.title || p.id, icon: _jsx(Bot, { size: 15 }) }), action: signed ? _jsx(Add, { name: p.title || p.id, label: "Use", added: names.has(p.id), onPress: () => setStart(fromPreset(p)) }) : undefined }, p.id))) })) }), editor] }));
     }
     if (!signed) {
         return _jsx(Visitor, { children: "Sign in to see your agents." });
     }
     const shown = mine.value.filter((a) => matches(q, a.name, a.description, a.model));
-    return (_jsxs(YStack, { gap: "$3", children: [_jsx(Line, { children: note }), mine.error && !mine.value.length ? (_jsx(Soft, { children: mine.error.message })) : mine.loading && !mine.value.length ? (_jsx(Soft, { children: "Reading your agents\u2026" })) : !mine.value.length ? (_jsx(Soft, { action: _jsx(Button, { size: "sm", variant: "outline", onPress: () => onAdding(true), children: "New agent" }), children: "No agents yet. Give one a model, instructions and the tools it may call." })) : !shown.length ? (_jsx(Soft, { children: "No agent matches." })) : (_jsx(Grid, { label: "Your agents", children: shown.map((a) => (_jsx(Tile, { title: a.name, detail: a.description || 'No description.', meta: [a.model, `${a.runs} ${a.runs === 1 ? 'run' : 'runs'}`, reach(a), a.cap ? `${money(a.spent)} of ${money(a.cap)} this ${a.period || 'period'}` : ''].filter(Boolean).join(' · '), mark: _jsx(Mark, { name: a.name, icon: a.emoji ? _jsx(SizableText, { size: "$4", children: a.emoji }) : undefined }), onOpen: () => setOpened(a) }, a.id || a.name))) })), editor] }));
+    return (_jsxs(YStack, { gap: "$3", children: [_jsx(Line, { children: note }), mine.error && !mine.value.length ? (_jsx(Failed, { error: mine.error, onRetry: mine.reload })) : mine.loading && !mine.value.length ? (_jsx(Soft, { children: "Loading your agents\u2026" })) : !mine.value.length ? (_jsxs(Empty, { title: "No agents yet", detail: "Start from a preset, or give a new one a model, instructions and tools.", children: [_jsx(Button, { size: "sm", variant: "outline", onPress: () => onView('discover'), children: "Browse presets" }), _jsx(Button, { size: "sm", onPress: () => onAdding(true), children: "New agent" })] })) : !shown.length ? (_jsx(Soft, { children: `No agent of yours matches “${q.trim()}”.` })) : (_jsx(Grid, { label: "Your agents", children: shown.map((a) => (_jsx(Tile, { title: a.name, detail: a.description || 'No description.', meta: [a.model, `${a.runs} ${a.runs === 1 ? 'run' : 'runs'}`, reach(a), a.cap ? `${money(a.spent)} of ${money(a.cap)} this ${a.period || 'period'}` : ''].filter(Boolean).join(' · '), mark: _jsx(Mark, { name: a.name, icon: a.emoji ? _jsx(SizableText, { size: "$4", children: a.emoji }) : undefined }), onOpen: () => setOpened(a) }, a.id || a.name))) })), editor] }));
     function reach(a) {
         if (a.tools.includes(ALL))
             return 'every tool';
@@ -69,9 +71,9 @@ export function Agents({ view, q, adding, onAdding, onView }) {
 /** Write a new agent, or change one; an existing agent is read whole first, for its instructions. */
 function Editor({ agent, start, onClose, onSaved, onDeleted, }) {
     const t = useTarget();
-    const full = useRead(agent ? () => one(t, agent.id || agent.name) : null, null, [t, agent?.id]);
-    const catalog = useRead(() => models(t), [], [t]);
-    const on = useRead(() => tools(t, { activated: true }), [], [t]);
+    const full = useLoad(agent ? () => one(t, agent.id || agent.name) : null, null, [t, agent?.id]);
+    const catalog = useLoad(() => models(t), [], [t]);
+    const on = useLoad(() => tools(t, { activated: true }), [], [t]);
     const [d, setD] = useState(start ?? EMPTY);
     const [ready, setReady] = useState(!agent);
     const [working, setWorking] = useState(false);
@@ -103,14 +105,14 @@ function Editor({ agent, start, onClose, onSaved, onDeleted, }) {
             onSaved(saved);
         }
         catch (e) {
-            setNote(e.message);
+            setNote(say(e));
         }
         finally {
             setWorking(false);
         }
     };
     const pick = (name, yes) => set({ tools: yes ? [...d.tools, name] : d.tools.filter((n) => n !== name) });
-    return (_jsx(Sheet, { title: agent ? agent.name : 'New agent', open: true, onOpenChange: (o) => !o && onClose(), width: 680, children: agent && full.error && !full.value ? (_jsx(Soft, { children: full.error.message })) : !ready ? (_jsx(Soft, { children: "Reading the agent\u2026" })) : (_jsxs(_Fragment, { children: [_jsx(Field, { label: "Name", hint: agent ? 'An agent keeps its name.' : 'Letters, digits, . _ or -. Other agents call it as agent_<name>.', children: _jsx(Input, { value: d.name, onChangeText: (v) => set({ name: v }), "aria-label": "Name", disabled: Boolean(agent), autoCapitalize: "none" }) }), _jsx(Field, { label: "Description", hint: "The line another agent reads to decide whether to call this one.", children: _jsx(Input, { value: d.description, onChangeText: (v) => set({ description: v }), placeholder: "Answers questions about our codebase", "aria-label": "Description" }) }), _jsx(Field, { label: "Model", children: _jsxs(XStack, { items: "center", gap: "$2", flexWrap: "wrap", children: [_jsx(ModelPicker, { size: "sm", name: "Model", placeholder: "The deployment\u2019s default", models: catalog.value, scope: "chat", value: d.model || undefined, onChange: (id) => set({ model: id }), loading: catalog.loading, error: catalog.error?.message ?? null }), d.model && !agent ? (_jsx(Button, { size: "sm", variant: "ghost", onPress: () => set({ model: '' }), children: "Use the default" })) : null] }) }), _jsx(Field, { label: "Instructions", hint: "The system prompt: what the model reads before every run.", children: _jsx(Textarea, { value: d.instructions, onChangeText: (v) => set({ instructions: v }), placeholder: "Be terse, and cite the file you read.", "aria-label": "Instructions", rows: 8 }) }), _jsxs(YStack, { gap: "$2", children: [_jsxs(XStack, { items: "center", gap: "$3", children: [_jsxs(YStack, { flex: 1, minW: 0, children: [_jsx(SizableText, { size: "$2", color: "$ink", children: "Tools" }), _jsx(SizableText, { size: "$1", color: "$soft", children: every ? 'Every tool the fleet’s MCP server serves when it runs.' : d.tools.length ? `${d.tools.length} chosen. It can call only these.` : 'None chosen: it can call no tool.' })] }), _jsx(SizableText, { size: "$1", color: "$soft", children: "Every tool" }), _jsx(Switch, { checked: every, onCheckedChange: (v) => set({ tools: v ? [ALL] : [] }), "aria-label": "Every tool" })] }), every ? null : (_jsxs(_Fragment, { children: [_jsx(Input, { value: find, onChangeText: setFind, placeholder: "Find a tool\u2026", "aria-label": "Find a tool" }), _jsx(YStack, { borderWidth: 1, borderColor: "$borderColor", rounded: "$3", maxH: 240, overflow: "scroll", children: on.loading && !on.value.length ? (_jsx(Soft, { children: "Reading the tools that are on\u2026" })) : on.error && !on.value.length ? (_jsx(Soft, { children: on.error.message })) : !shownTools.length ? (_jsx(Soft, { children: choices.length ? 'No tool matches.' : 'No tool is on for your organization. Switch skills and connectors on first.' })) : (shownTools.map((x, i) => (_jsxs(XStack, { items: "center", gap: "$3", px: "$3", py: "$2", borderTopWidth: i ? 1 : 0, borderColor: "$borderColor", children: [_jsxs(YStack, { flex: 1, minW: 0, children: [_jsx(SizableText, { size: "$2", color: "$ink", style: mono, numberOfLines: 1, children: x.name }), _jsx(SizableText, { size: "$1", color: "$soft", numberOfLines: 1, children: [x.source, x.description].filter(Boolean).join(' · ') })] }), _jsx(Switch, { checked: d.tools.includes(x.name), onCheckedChange: (v) => pick(x.name, v), "aria-label": `Use ${x.name}` })] }, x.name)))) })] }))] }), _jsxs(YStack, { gap: "$2", children: [_jsx(SizableText, { size: "$2", color: "$ink", children: "Budget" }), _jsxs(XStack, { gap: "$3", flexWrap: "wrap", rowGap: "$2", items: "flex-end", children: [_jsxs(YStack, { gap: "$1", width: 140, children: [_jsxs(SizableText, { size: "$1", color: "$soft", children: ["Each ", d.period, ", USD"] }), _jsx(Input, { value: d.cap, onChangeText: (v) => set({ cap: v }), placeholder: "10", "aria-label": "Budget each period", inputMode: "decimal" })] }), _jsxs(YStack, { gap: "$1", width: 140, children: [_jsx(SizableText, { size: "$1", color: "$soft", children: "One run, USD" }), _jsx(Input, { value: d.task, onChangeText: (v) => set({ task: v }), placeholder: "1", "aria-label": "Budget for one run", inputMode: "decimal" })] }), _jsx(Choice, { label: "Period", value: d.period, options: PERIODS.map((p) => ({ id: p, label: p[0].toUpperCase() + p.slice(1) })), onChange: (p) => set({ period: p }) })] }), _jsxs(SizableText, { size: "$1", color: "$soft", children: [full.value && full.value.cap ? `Spent ${money(full.value.spent)} this ${full.value.period}. ` : '', "A run stops at either limit."] })] }), _jsx(Line, { children: note }), _jsxs(XStack, { gap: "$2", items: "center", children: [agent && onDeleted ? (_jsx(Button, { size: "sm", variant: "ghost", onPress: () => setAsking(true), children: "Delete" })) : null, _jsx(XStack, { flex: 1 }), _jsx(Button, { size: "sm", variant: "ghost", onPress: onClose, children: "Cancel" }), _jsx(Button, { size: "sm", disabled: working, onPress: () => void save(), children: agent ? 'Save' : 'Create' })] }), agent && onDeleted ? (_jsx(Confirm, { what: agent.name, says: "The agent and every run recorded against it are removed.", open: asking, onOpenChange: setAsking, onYes: async () => {
+    return (_jsx(Sheet, { title: agent ? agent.name : 'New agent', open: true, onOpenChange: (o) => !o && onClose(), width: 680, children: agent && full.error && !full.value ? (_jsx(Failed, { error: full.error, onRetry: full.reload })) : !ready ? (_jsx(Soft, { children: "Loading the agent\u2026" })) : (_jsxs(_Fragment, { children: [_jsx(Field, { label: "Name", hint: agent ? 'An agent keeps its name.' : 'Letters, digits, . _ or -. Other agents call it as agent_<name>.', children: _jsx(Input, { value: d.name, onChangeText: (v) => set({ name: v }), "aria-label": "Name", disabled: Boolean(agent), autoCapitalize: "none" }) }), _jsx(Field, { label: "Description", hint: "The line another agent reads to decide whether to call this one.", children: _jsx(Input, { value: d.description, onChangeText: (v) => set({ description: v }), placeholder: "Answers questions about our codebase", "aria-label": "Description" }) }), _jsx(Field, { label: "Model", children: _jsxs(XStack, { items: "center", gap: "$2", flexWrap: "wrap", children: [_jsx(ModelPicker, { size: "sm", name: "Model", placeholder: "The deployment\u2019s default", models: catalog.value, scope: "chat", value: d.model || undefined, onChange: (id) => set({ model: id }), loading: catalog.loading, error: catalog.error ? say(catalog.error) : null }), d.model && !agent ? (_jsx(Button, { size: "sm", variant: "ghost", onPress: () => set({ model: '' }), children: "Use the default" })) : null] }) }), _jsx(Field, { label: "Instructions", hint: "The system prompt: what the model reads before every run.", children: _jsx(Textarea, { value: d.instructions, onChangeText: (v) => set({ instructions: v }), placeholder: "Be terse, and cite the file you read.", "aria-label": "Instructions", rows: 8 }) }), _jsxs(YStack, { gap: "$2", children: [_jsxs(XStack, { items: "center", gap: "$3", children: [_jsxs(YStack, { flex: 1, minW: 0, children: [_jsx(SizableText, { size: "$2", color: "$ink", children: "Tools" }), _jsx(SizableText, { size: "$1", color: "$soft", children: every ? 'Every tool the fleet’s MCP server serves when it runs.' : d.tools.length ? `${d.tools.length} chosen. It can call only these.` : 'None chosen: it can call no tool.' })] }), _jsx(SizableText, { size: "$1", color: "$soft", children: "Every tool" }), _jsx(Switch, { checked: every, onCheckedChange: (v) => set({ tools: v ? [ALL] : [] }), "aria-label": "Every tool" })] }), every ? null : (_jsxs(_Fragment, { children: [_jsx(Input, { value: find, onChangeText: setFind, placeholder: "Find a tool\u2026", "aria-label": "Find a tool" }), _jsx(YStack, { borderWidth: 1, borderColor: "$borderColor", rounded: "$3", maxH: 240, overflow: "scroll", children: on.loading && !on.value.length ? (_jsx(Soft, { children: "Loading the tools that are on\u2026" })) : on.error && !on.value.length ? (_jsx(Failed, { error: on.error, onRetry: on.reload })) : !shownTools.length ? (_jsx(Soft, { children: choices.length ? 'No tool matches.' : 'No tool is on for your organization yet. Add skills or connectors first.' })) : (shownTools.map((x, i) => (_jsxs(XStack, { items: "center", gap: "$3", px: "$3", py: "$2", borderTopWidth: i ? 1 : 0, borderColor: "$borderColor", children: [_jsxs(YStack, { flex: 1, minW: 0, children: [_jsx(SizableText, { size: "$2", color: "$ink", style: mono, numberOfLines: 1, children: x.name }), _jsx(SizableText, { size: "$1", color: "$soft", numberOfLines: 1, children: [x.source, x.description].filter(Boolean).join(' · ') })] }), _jsx(Switch, { checked: d.tools.includes(x.name), onCheckedChange: (v) => pick(x.name, v), "aria-label": `Use ${x.name}` })] }, x.name)))) })] }))] }), _jsxs(YStack, { gap: "$2", children: [_jsx(SizableText, { size: "$2", color: "$ink", children: "Budget" }), _jsxs(XStack, { gap: "$3", flexWrap: "wrap", rowGap: "$2", items: "flex-end", children: [_jsxs(YStack, { gap: "$1", width: 140, children: [_jsxs(SizableText, { size: "$1", color: "$soft", children: ["Each ", d.period, ", USD"] }), _jsx(Input, { value: d.cap, onChangeText: (v) => set({ cap: v }), placeholder: "10", "aria-label": "Budget each period", inputMode: "decimal" })] }), _jsxs(YStack, { gap: "$1", width: 140, children: [_jsx(SizableText, { size: "$1", color: "$soft", children: "One run, USD" }), _jsx(Input, { value: d.task, onChangeText: (v) => set({ task: v }), placeholder: "1", "aria-label": "Budget for one run", inputMode: "decimal" })] }), _jsx(Choice, { label: "Period", value: d.period, options: PERIODS.map((p) => ({ id: p, label: p[0].toUpperCase() + p.slice(1) })), onChange: (p) => set({ period: p }) })] }), _jsxs(SizableText, { size: "$1", color: "$soft", children: [full.value && full.value.cap ? `Spent ${money(full.value.spent)} this ${full.value.period}. ` : '', "A run stops at either limit."] })] }), _jsx(Line, { children: note }), _jsxs(XStack, { gap: "$2", items: "center", children: [agent && onDeleted ? (_jsx(Button, { size: "sm", variant: "ghost", onPress: () => setAsking(true), children: "Delete" })) : null, _jsx(XStack, { flex: 1 }), _jsx(Button, { size: "sm", variant: "ghost", onPress: onClose, children: "Cancel" }), _jsx(Button, { size: "sm", disabled: working, onPress: () => void save(), children: agent ? 'Save' : 'Create' })] }), agent && onDeleted ? (_jsx(Confirm, { what: agent.name, says: "The agent and every run recorded against it are removed.", open: asking, onOpenChange: setAsking, onYes: async () => {
                         await remove(t, agent.id || agent.name);
                         onDeleted();
                     } })) : null] })) }));

package/lib/customize/connectors.d.ts

@@ -1,2 +1,2 @@
 import { type Pane } from './ui.tsx';
-export declare function Connectors({ view, q, adding, onAdding, onView }: Pane): import("react").JSX.Element;
+export declare function Connectors({ view, q, adding, onAdding, onView, onCount }: Pane): import("react").JSX.Element;