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

package/node_modules/@buddi/gateway/dist/web/skills.d.ts

@@ -0,0 +1,120 @@
+import { type AgentCatalog, type Skill } from '@buddi/core';
+import type { Pool } from 'pg';
+export interface RouteReply {
+    status: number;
+    body: unknown;
+}
+export interface SkillsDeps {
+    catalog: AgentCatalog & {
+        reload?: () => void;
+    };
+    /** The owner's agents directory: an agent's own skills are under `<id>/skills`. */
+    agentsDir: string;
+    /** The owner's shared skills folder: where a written or uploaded skill goes. */
+    skillsDir: string;
+    /** Where a deleted skill goes: `<private>/.trash/skills`. */
+    trashRoot: string;
+    /** The names of the plugins installed now. */
+    plugins: () => readonly string[];
+    now: () => Date;
+    /** For a learned skill's delete, which counts its proposal as discarded. */
+    pool?: Pool;
+}
+export type SkillGroup = 'mine' | 'learned' | 'plugin' | 'catalogue';
+export type SkillFrom = {
+    kind: 'plugin';
+    plugin: string;
+    version: string;
+    installed: boolean;
+} | {
+    kind: 'catalogue';
+    package: string;
+    version: string;
+    agent: string;
+} | {
+    kind: 'upload';
+    filename: string;
+};
+export interface SkillHolder {
+    agent: string;
+    /** home: it lives in this agent's folder; every: no `agents` filter; filter: named by one; granted: the agent's file asks for it. */
+    how: 'home' | 'every' | 'filter' | 'granted';
+}
+export interface SkillRow {
+    /** The name, or `<agent>/<name>` for a skill in one agent's folder. Encode it in a path (`%2F`). */
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    group: SkillGroup;
+    file: string;
+    /** The agent whose folder holds it; null for a shared skill. */
+    home: string | null;
+    every: boolean;
+    holders: SkillHolder[];
+    /** upload: a file the owner has not marked as theirs (read as outside text); page: untrusted text was in view when it was learned. */
+    untrusted: 'upload' | 'page' | null;
+    provenance: Skill['provenance'];
+    source: string | null;
+    created: string | null;
+    updatedAt: string | null;
+    learned: {
+        by: string;
+        version: number;
+        edited: boolean;
+        keptAt: string;
+    } | null;
+    from: SkillFrom | null;
+    /** Its text can be changed here (not a plugin's). */
+    editable: boolean;
+    /** It can be deleted here (not while its plugin is installed). */
+    deletable: boolean;
+    /** It can be given to every agent (a shared skill; one in an agent's folder is granted agent by agent). */
+    shareable: boolean;
+}
+export interface SkillsAgent {
+    id: string;
+    handle: string;
+    name: string;
+    /** Its file is the owner's, so a grant can be written there (not a shipped example). */
+    writable: boolean;
+}
+/** The largest skill text accepted, in characters. */
+export declare const SKILL_TEXT_MAX = 50000;
+/** `GET /api/skills`: every skill, grouped, and the agents a picker offers. */
+export declare function listSkillsRoute(deps: SkillsDeps): RouteReply;
+/** `GET /api/skills/:id`: one skill whole — the row, its text and the file as written. */
+export declare function skillDetailRoute(deps: SkillsDeps, id: string): RouteReply;
+/** `GET /api/skills/:id/download`: the file as it is on disk. Null when there is none. */
+export declare function skillDownload(deps: SkillsDeps, id: string): {
+    filename: string;
+    text: string;
+} | null;
+/** `POST /api/skills/:id/grants` `{ every?, agents }`: who uses it, written in each agent's file. */
+export declare function grantSkillRoute(deps: SkillsDeps, id: string, body: Record<string, unknown>): RouteReply;
+/**
+ * `POST /api/skills` `{ title, description, body, every?, agents?, upload?: { filename, mine? } }`.
+ * The new file goes in the owner's shared skills folder; an upload not marked
+ * as theirs is `untrusted: true`.
+ */
+export declare function createSkillRoute(deps: SkillsDeps, body: Record<string, unknown>): RouteReply;
+/**
+ * `PUT /api/skills/:id` `{ text }` or `{ body, description?, title? }`.
+ * A learned skill's edit is version n+1 marked as the owner's correction (the
+ * earlier versions stay); a catalogue skill's counts as an owner edit, so the
+ * next update asks before replacing it; a plugin's reads only. The front
+ * matter's other keys (who holds it, where it came from, the untrusted mark)
+ * are not changed by an edit; they are named back in `ignored`.
+ */
+export declare function editSkillRoute(deps: SkillsDeps, id: string, body: Record<string, unknown>): RouteReply;
+/** `POST /api/skills/:id/trust`: the owner has read it; its text is composed as theirs from now on. */
+export declare function trustSkillRoute(deps: SkillsDeps, id: string): RouteReply;
+/**
+ * `DELETE /api/skills/:id`. Every agent that asked for it by name stops (its
+ * `skills:` line loses the name in the same write). A learned one's current
+ * file goes and its versions stay, and its proposal counts as discarded, so
+ * the agent does not propose it again for 90 days; anything else goes to the
+ * trash folder beside the agents. A plugin's is deleted with the plugin.
+ */
+export declare function deleteSkillRoute(deps: SkillsDeps, id: string): Promise<RouteReply>;
+//# sourceMappingURL=skills.d.ts.map

package/node_modules/@buddi/gateway/dist/web/skills.d.ts.map

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