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

package/node_modules/@buddi/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/node_modules/@buddi/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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"}