@withbuddi/buddi 0.1.0-pre.30 → 0.1.0-pre.32

package/packages/gateway/dist/web/catalogue-source.js

@@ -0,0 +1,124 @@
+/**
+ * Where the agent catalogue comes from on this installation: the market list
+ * `/api/market` already keeps (`market.ts`), read for its `agents`, plus what
+ * the install sheet's picks can be answered with here, and each package's
+ * picture (agent-catalogue.md §5).
+ *
+ * Opening the catalogue fetches the list when the kept copy is stale; offline
+ * it answers the copy, marked stale, or says it needs withbuddi.com. Each
+ * listing is read strictly (`parseAgentPackage`): one that does not parse, or
+ * does not hash to its integrity, is left out and said so in `problems`, never
+ * shown half-read.
+ */
+import { listOwnerPlaces } from '@buddi/core';
+import { parseAgentPackage, PackageRefusal, sriSha256 } from '../agents/catalogue-package.js';
+import { loadMarketIndex, marketAsset, marketAssetUrl } from './market.js';
+import { runPageQuery } from './pages.js';
+import { installedRecord } from './plugins.js';
+import { currentVersion } from './version.js';
+/** The packages a market index carries, each read strictly. */
+export function readPackages(index, log = () => { }) {
+    const raw = Array.isArray(index.agents) ? index.agents : [];
+    const packages = [];
+    const problems = [];
+    const seen = new Set();
+    for (const entry of raw) {
+        try {
+            const pkg = parseAgentPackage(entry);
+            if (seen.has(pkg.manifest.name))
+                throw new PackageRefusal(`${pkg.manifest.name}: listed twice`);
+            seen.add(pkg.manifest.name);
+            packages.push(pkg);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            problems.push(message);
+            log(`catalogue: left out a listing: ${message}`);
+        }
+    }
+    const order = ['work', 'money', 'home', 'health', 'learning', 'life'];
+    packages.sort((a, b) => order.indexOf(a.manifest.category) - order.indexOf(b.manifest.category) || a.manifest.title.localeCompare(b.manifest.title));
+    return { packages, problems };
+}
+async function queryData(deps, plugin, name) {
+    if (!deps.registry.queries().some((q) => q.plugin === plugin && q.name === name))
+        return null;
+    const answer = await runPageQuery({ registry: deps.registry, ctx: deps.ctx, now: deps.now, log: deps.log }, plugin, name, new URLSearchParams()).catch(() => null);
+    if (answer?.status !== 200)
+        return null;
+    const data = answer.body?.data;
+    return data !== null && typeof data === 'object' ? data : null;
+}
+function rows(value) {
+    return Array.isArray(value) ? value.filter((r) => r !== null && typeof r === 'object') : [];
+}
+export function createCatalogueService(deps) {
+    const market = { env: deps.env, log: deps.log, now: deps.now, ...(deps.fetch ? { fetch: deps.fetch } : {}) };
+    let read;
+    return {
+        async load(opts = {}) {
+            const loaded = await loadMarketIndex(market, opts.refresh === true ? { refresh: true } : opts.cachedOnly === true ? { cachedOnly: true } : {});
+            if ('unavailable' in loaded)
+                return { unavailable: loaded.unavailable };
+            // Read once per copy: an agent's page asks on every load, and each read hashes every package.
+            if (read?.fetchedAt !== loaded.fetchedAt || read.index !== loaded.index) {
+                read = { fetchedAt: loaded.fetchedAt, index: loaded.index, ...readPackages(loaded.index, deps.log) };
+            }
+            return { fetchedAt: loaded.fetchedAt, stale: loaded.stale, packages: read.packages, problems: read.problems };
+        },
+        async choices() {
+            const mail = await queryData(deps, 'email', 'accounts');
+            const calendar = await queryData(deps, 'calendar', 'settings');
+            let places = [];
+            try {
+                places = (await listOwnerPlaces(deps.ctx.db)).map((p) => ({ id: p.id, label: p.label }));
+            }
+            catch {
+                places = [];
+            }
+            return {
+                mailboxes: rows(mail?.accounts)
+                    .map((a) => a.address)
+                    .filter((a) => typeof a === 'string' && a !== ''),
+                calendars: rows(calendar?.calendars)
+                    .map((c) => c.name)
+                    .filter((n) => typeof n === 'string' && n !== ''),
+                places,
+            };
+        },
+        async needs() {
+            const mail = await queryData(deps, 'email', 'accounts');
+            const image = await queryData(deps, 'image', 'settings');
+            return {
+                mailbox: rows(mail?.accounts).length > 0,
+                // An account the image plugin will draw with: the one chosen in Settings → Image. A linked
+                // account nobody chose yet is refused by image.generate, so it does not count.
+                'image-account': typeof image?.account === 'string' && image.account !== '',
+            };
+        },
+        async avatar(pkg) {
+            if (!pkg.avatar || !pkg.avatarSha256)
+                return null;
+            const url = marketAssetUrl(deps.env, pkg.avatar);
+            if (!url) {
+                deps.log(`catalogue: the picture of "${pkg.manifest.name}" is not a market file: ${pkg.avatar}`);
+                return null;
+            }
+            try {
+                const asset = await marketAsset(market, url);
+                if (sriSha256(asset.bytes) !== pkg.avatarSha256) {
+                    deps.log(`catalogue: the picture of "${pkg.manifest.name}" does not hash to what its listing names; left out`);
+                    return null;
+                }
+                return asset.bytes;
+            }
+            catch (err) {
+                deps.log(`catalogue: the picture of "${pkg.manifest.name}" could not be fetched: ${err instanceof Error ? err.message : String(err)}`);
+                return null;
+            }
+        },
+        version: deps.version ?? (() => currentVersion(deps.env)),
+        plugins: () => installedRecord(deps.env).plugins,
+    };
+}
+//# sourceMappingURL=catalogue-source.js.map

package/packages/gateway/dist/web/catalogue-source.js.map

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

package/packages/gateway/dist/web/catalogue.d.ts

@@ -0,0 +1,155 @@
+import { type CatalogueBinding, type CatalogueEntryView, type CatalogueService, type Drift, type MissingNeed, type MissingPlugin } from '../agents/platform-catalogue.js';
+import { type MarketDeps } from './market.js';
+import type { PagesDeps } from './pages.js';
+import type { RouteReply } from './plugins.js';
+import { type TakeOnDeps } from './take-on.js';
+import type { DecideResult, WriteResult } from './write.js';
+export interface CatalogueDeps extends PagesDeps {
+    env: NodeJS.ProcessEnv;
+    log: (line: string) => void;
+    pool: TakeOnDeps['pool'];
+    service: CatalogueService;
+    binding: CatalogueBinding;
+    /** Decide an approval `approved` as the owner: the card's own decide. */
+    approve: (actionId: string) => Promise<WriteResult<DecideResult>>;
+    /** Decide it `rejected`: the owner said no at the install sheet's extra step. */
+    reject?: (actionId: string) => Promise<WriteResult<DecideResult>>;
+    engine?: TakeOnDeps['engine'];
+    /** The running registry, when it can load a plugin live. */
+    liveRegistry?: TakeOnDeps['registry'];
+    fetch?: MarketDeps['fetch'];
+    /** How long the job waits for a plugin it installed to load. One minute. */
+    loadWaitMs?: number;
+}
+/** A plugin the catalogue needs, as the card and the sheet draw it. */
+export type MissingView = (MissingPlugin & {
+    title: string;
+    listed: boolean;
+    byBuddi: boolean;
+    version?: string;
+}) | MissingNeed;
+/** One of a package's skills as the detail page titles and opens it. */
+export interface CatalogueSkillView {
+    /** The file name without `.md`. */
+    name: string;
+    description: string;
+    /** The skill's text as the package carries it (no front matter). */
+    text: string;
+}
+export interface CatalogueCard extends Omit<CatalogueEntryView, 'missing' | 'skills'> {
+    missing?: MissingView[];
+    skills: CatalogueSkillView[];
+    /** Add works now: nothing is missing, or only By-buddi plugins it installs on the way. */
+    addable: boolean;
+}
+/** The catalogue as the page draws it. */
+export declare function catalogueRoute(deps: CatalogueDeps, url: URL): Promise<RouteReply>;
+/** Where an agent from the catalogue stands, as its own page draws it (`GET /api/agents` → `catalogue`). */
+export interface AgentCatalogueProvenance {
+    source: 'market';
+    /** The package it came from (or, with `via`, the one that does its job now). */
+    package: string;
+    title: string;
+    /** The version written; with `via`, the older agent's own version. */
+    version: string;
+    /** The version the kept list has, or null when there is no copy or it is no longer listed. */
+    latest: string | null;
+    drift: Drift;
+    /** The kept list no longer has it: it keeps working, and no update will come. */
+    delisted: boolean;
+    /** `buddi/planner`, when this is an older agent the package replaces. */
+    via?: string;
+}
+/**
+ * Every agent on disk that came from the catalogue (or that a package replaces),
+ * with its drift against the kept copy of the list. Never fetches: an agent's
+ * page asks on every load, and without a copy only what the sidecar knows is said.
+ */
+export declare function agentsCatalogue(deps: Pick<CatalogueDeps, 'service' | 'binding'>): Promise<Record<string, AgentCatalogueProvenance>>;
+/**
+ * `POST /api/catalogue/:name/plan` — what adding it would do, writing nothing:
+ * the plugins it installs on the way, the picks with their defaults and
+ * choices, the handle (a free one beside the package's when that is taken),
+ * the tools with their tiers, the missions, and the approval's preview.
+ */
+export declare function planRoute(deps: CatalogueDeps, name: string, body: Record<string, unknown>): Promise<RouteReply>;
+export type JobStepState = 'waiting' | 'fetching' | 'reading' | 'installing' | 'loading' | 'adding' | 'confirm' | 'done' | 'failed';
+export interface CatalogueJob {
+    id: string;
+    name: string;
+    version: string;
+    title: string;
+    /** `confirm`: the grant that resolved is not the one shown; the owner says yes or no (`POST …/confirm`). */
+    state: 'running' | 'confirm' | 'done' | 'failed';
+    steps: Array<{
+        kind: 'plugin' | 'agent';
+        name: string;
+        title: string;
+        state: JobStepState;
+        reason?: string;
+    }>;
+    agent?: {
+        id: string;
+        handle: string;
+        name: string;
+    };
+    approvalId?: string;
+    /** With `confirm`: the whole grant as it resolved, the tools not shown before, and the approval's preview. */
+    confirm?: {
+        tools: Array<{
+            name: string;
+            tier: string;
+            description: string;
+        }>;
+        unshown: string[];
+        preview: string;
+    };
+    error?: string;
+    startedAt: string;
+    finishedAt?: string;
+}
+/** For tests: forget the jobs. */
+export declare function resetCatalogueJobs(): void;
+/** For tests: wait until a job has finished, or stopped to ask. */
+export declare function catalogueJobSettled(id: string, timeoutMs?: number): Promise<CatalogueJob | undefined>;
+/** `GET /api/catalogue/jobs/:id`. */
+export declare function jobRoute(id: string): RouteReply;
+/**
+ * `POST /api/catalogue/:name/install` `{ version, fills, handle, missionsOn, plan?, tools? }`
+ * — answers 202 with the job at once; `GET /api/catalogue/jobs/:id` gives its
+ * progress. `plan` is the fingerprint the plan route gave for the same picks;
+ * `tools` the grant the sheet listed. The click approves the agent only when
+ * one of them is exactly what resolves; otherwise the job stops at `confirm`.
+ */
+export declare function installRoute(deps: CatalogueDeps, name: string, body: Record<string, unknown>): Promise<RouteReply>;
+/**
+ * `POST /api/catalogue/jobs/:id/confirm` `{ approve: boolean }` — the owner's
+ * answer to a job stopped at `confirm`: yes approves the agent with the grant
+ * the job showed; no rejects the approval and ends the job. Its plugins stay.
+ */
+export declare function confirmJobRoute(deps: CatalogueDeps, id: string, body: Record<string, unknown>): Promise<RouteReply>;
+/**
+ * `POST /api/catalogue/:name/update/plan` `{ agentId }` — the update sheet:
+ * the version and `changes`, the persona diff, tools added and removed,
+ * missions added, and whether the owner edited the file (then only "See what
+ * changed" and "Replace my changes" are offered).
+ */
+export declare function updatePlanRoute(deps: CatalogueDeps, name: string, body: Record<string, unknown>): Promise<RouteReply>;
+/**
+ * `POST /api/catalogue/:name/update` `{ agentId, plan, replace? }` — the
+ * owner's click on Update (or "Replace my changes", with `replace: true`) is
+ * the approval, of the plan `update/plan` showed: `plan` is its fingerprint,
+ * and anything it covers that moved since (the package, the grant, the file
+ * or a skill on disk) answers 409, untouched. An edited file without
+ * `replace` is refused, untouched.
+ */
+export declare function updateRoute(deps: CatalogueDeps, name: string, body: Record<string, unknown>): Promise<RouteReply>;
+/**
+ * `GET /api/agents/:id/remove` — what removing it does: the preview
+ * `platform.delete_agent` carries (its missions paused, the plugins no other
+ * agent uses named). Nothing changes.
+ */
+export declare function removePreviewRoute(deps: CatalogueDeps, agentId: string): Promise<RouteReply>;
+/** `POST /api/agents/:id/remove` — Remove from team: the click is the approval. The directory goes to the trash. */
+export declare function removeRoute(deps: CatalogueDeps, agentId: string): Promise<RouteReply>;
+//# sourceMappingURL=catalogue.d.ts.map

package/packages/gateway/dist/web/catalogue.d.ts.map

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