@zibby/skills 0.1.96 → 0.2.0

package/dist/datasetStore.d.ts

@@ -1,326 +1,52 @@
-export function __clearEnsuredStores(): void;
-export namespace datasetStoreSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let description: string;
-    let promptFragment: string;
-    function resolve(): {
-        command: any;
-        args: any[];
-        env: {};
-        description: string;
-        type?: undefined;
-        alwaysLoad?: undefined;
-    } | {
-        type: string;
-        command: string;
-        args: any[];
-        env: {};
-        description: string;
-        alwaysLoad: boolean;
-    };
-    function handleToolCall(name: any, args: any): Promise<string>;
-    let tools: ({
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                record: {
-                    type: string;
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    description: string;
-                };
-                agent: {
-                    type: string;
-                    description: string;
-                };
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                limit?: undefined;
-                since?: undefined;
-                until?: undefined;
-                name?: undefined;
-                type?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                path?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                select: {
-                    type: string;
-                    description: string;
-                };
-                where: {
-                    type: string;
-                    description: string;
-                };
-                groupBy: {
-                    type: string;
-                    description: string;
-                };
-                orderBy: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                since: {
-                    type: string;
-                    description: string;
-                };
-                until: {
-                    type: string;
-                    description: string;
-                };
-                agent: {
-                    type: string;
-                    description: string;
-                };
-                record?: undefined;
-                description?: undefined;
-                name?: undefined;
-                type?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                path?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: any[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                name: {
-                    type: string;
-                    description: string;
-                };
-                type: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    description: string;
-                };
-                store?: undefined;
-                record?: undefined;
-                agent?: undefined;
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                limit?: undefined;
-                since?: undefined;
-                until?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                path?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                sql: {
-                    type: string;
-                    description: string;
-                };
-                params: {
-                    type: string;
-                    description: string;
-                };
-                record?: undefined;
-                description?: undefined;
-                agent?: undefined;
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                limit?: undefined;
-                since?: undefined;
-                until?: undefined;
-                name?: undefined;
-                type?: undefined;
-                path?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                path: {
-                    type: string;
-                    description: string;
-                };
-                content: {
-                    type: string;
-                    description: string;
-                };
-                contentBase64: {
-                    type: string;
-                    description: string;
-                };
-                contentType: {
-                    type: string;
-                    description: string;
-                };
-                record?: undefined;
-                description?: undefined;
-                agent?: undefined;
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                limit?: undefined;
-                since?: undefined;
-                until?: undefined;
-                name?: undefined;
-                type?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                path: {
-                    type: string;
-                    description: string;
-                };
-                record?: undefined;
-                description?: undefined;
-                agent?: undefined;
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                limit?: undefined;
-                since?: undefined;
-                until?: undefined;
-                name?: undefined;
-                type?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-                prefix?: undefined;
-                cursor?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                store: {
-                    type: string;
-                    description: string;
-                };
-                prefix: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                cursor: {
-                    type: string;
-                    description: string;
-                };
-                record?: undefined;
-                description?: undefined;
-                agent?: undefined;
-                select?: undefined;
-                where?: undefined;
-                groupBy?: undefined;
-                orderBy?: undefined;
-                since?: undefined;
-                until?: undefined;
-                name?: undefined;
-                type?: undefined;
-                sql?: undefined;
-                params?: undefined;
-                path?: undefined;
-                content?: undefined;
-                contentBase64?: undefined;
-                contentType?: undefined;
-            };
-            required: any[];
-        };
-    })[];
-}
+/**
+ * datasetStore.js — durable, queryable structured-artifact store skill.
+ *
+ * WHAT IT IS
+ * ──────────
+ * A hand-written multi-tool skill (same shape as kvMemory.js / reviewMemory.js /
+ * github.js): `serverName`, `allowedTools`, `tools[]`, `handleToolCall`, and a
+ * `resolve()` that spawns the GENERIC bin/mcp-skill.mjs. Unlike kv-memory (a
+ * key→value MEMORY for picking up where a prior run left off), this is a durable
+ * STRUCTURED-RECORD store: an agent appends arbitrary JSON records to a named
+ * store and later runs SQL-style queries/aggregations over them — e.g. to
+ * accumulate metrics across runs and produce a report.
+ *
+ * STORES v2 — NAME-BASED RESOLUTION (the shared contract)
+ * ────────────────────────────────────────────────────────
+ * Stores are auto-provisioned at DEPLOY and resolved at runtime BY NAME via env:
+ *   - The run carries one `ZIBBY_STORE__<name> = <storeId>` per bound store.
+ *   - The agent reads the injected "AVAILABLE STORES" prompt catalog (name +
+ *     description), picks one, and passes the chosen logical `name` to the tool.
+ *   - This name→storeId env map is BOTH the allowlist AND the resolver: the
+ *     agent can only ever write to a declared/bound name (anti-fragmentation).
+ *
+ * BACKEND (already built — NO change here)
+ * ─────────────────────────────────────────
+ * Two routes on the SAME base URL kv-memory uses (getAccountApiUrl(), prod
+ * https://api-prod.zibby.app), authed with the SAME Bearer project token
+ * (getSessionToken()):
+ *   - POST {base}/datasets/stores/{storeId}/append  body { record, agent }
+ *       → { ok, id, ts }
+ *   - POST {base}/datasets/stores/{storeId}/query   body { select?, where?,
+ *       groupBy?, orderBy?, limit?, since?, until?, agent? }
+ *       → { ok, rowCount, columns, rows }
+ * Plus the per-type data routes on the same base: /sql (sqlite stores) and
+ * /put /get /list /delete (file stores — blob storage by relative path).
+ * The `storeId` lives in the URL path. Tenancy (account + project) is enforced
+ * SERVER-SIDE from the Bearer token — the skill NEVER sends account/project.
+ *
+ * AUTOMATIC PER-AGENT TAGGING
+ * ────────────────────────────
+ * Appends default `agent` to the writing agent's namespace (WORKFLOW_TYPE,
+ * falling back to the literal 'agent'), so records are auto-tagged with who
+ * wrote them and `query`'s optional `agent` filter can scope to one writer.
+ *
+ * AUTH — identical to kvMemory.js / reviewMemory.js
+ * ──────────────────────────────────────────────────
+ * Calls ZIBBY'S OWN backend with PROJECT_API_TOKEN (Bearer) against
+ * ZIBBY_ACCOUNT_API_URL (default api-prod.zibby.app). Mirrors
+ * @zibby/core/backend-client.js getSessionToken()/getAccountApiUrl() rather than
+ * importing a non-existent helper, so the auth model stays identical.
+ */
+export declare function __clearEnsuredStores(): void;
+export declare const datasetStoreSkill: any;

package/dist/discord.d.ts

@@ -1,3 +1,33 @@
+/**
+ * Discord integration — low-level API-wrapper skill.
+ *
+ * Lets an agent post messages into a Discord server the user's bot has been
+ * invited to, and discover the channels it can post to. Talks the Discord
+ * REST API (v10) directly with a static BOT token — no MCP server of its own;
+ * served over the GENERIC skill MCP binary (bin/mcp-skill.mjs), exactly like
+ * linear.js / github.js.
+ *
+ * AUTH (single chokepoint: resolveDiscordAuth):
+ *   1. resolveIntegrationToken('discord') — the Zibby-cloud path. The backend
+ *      stores the bot token on the account's provider='discord' integration
+ *      row (paste-based connect) and returns { token, guildId } from
+ *      GET /integrations/token/discord.
+ *   2. DISCORD_BOT_TOKEN env — the self-host / local fallback (same pattern
+ *      as linear.js's LINEAR_API_KEY): when the env token is present it wins,
+ *      so a self-hosted run never needs the Zibby cloud at all.
+ *
+ * Discord auth header semantics (https://discord.com/developers/docs):
+ *   Authorization: Bot <token>
+ * A raw token pasted without the "Bot " prefix gets it added here.
+ *
+ * FAIL-SOFT: handleToolCall never throws — every error path returns
+ * JSON.stringify({ ok:false, error }) so a notify step can't crash a workflow.
+ *
+ * Discord hard limit: message `content` is capped at 2000 chars — longer text
+ * is CHUNKED into sequential messages (split on line boundaries when possible)
+ * rather than truncated or rejected.
+ */
+export declare const DISCORD_MAX_CONTENT = 2000;
 /**
  * Split `text` into Discord-postable chunks of <= DISCORD_MAX_CONTENT chars.
  * Prefers newline boundaries so code blocks / paragraphs stay readable; falls
@@ -7,71 +37,5 @@
  * @param {number} [max=DISCORD_MAX_CONTENT]
  * @returns {string[]} non-empty chunks (empty input → []).
  */
-export function chunkDiscordContent(text: string, max?: number): string[];
-export const DISCORD_MAX_CONTENT: 2000;
-export namespace discordSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let requiresIntegration: "discord";
-    let envKeys: string[];
-    let description: string;
-    let promptFragment: string;
-    /**
-     * Spawn spec for the GENERIC skill MCP server (bin/mcp-skill.mjs) pointed at
-     * this module's discordSkill export — the model gets real mcp__discord__*
-     * tools. Mirrors linear.js resolve() (see its docblock for the dist-relative
-     * module-path rationale). Env allow-list: the self-host token/guild vars +
-     * the backend-client vars resolveIntegrationToken needs in the child.
-     */
-    function resolve(): {
-        command: any;
-        args: any[];
-        env: {};
-        description: string;
-        type?: undefined;
-        alwaysLoad?: undefined;
-    } | {
-        type: string;
-        command: string;
-        args: any[];
-        env: {};
-        description: string;
-        alwaysLoad: boolean;
-    };
-    function handleToolCall(name: any, args?: {}): Promise<string>;
-    let tools: ({
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                channelId: {
-                    type: string;
-                    description: string;
-                };
-                text: {
-                    type: string;
-                    description: string;
-                };
-                guildId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                guildId: {
-                    type: string;
-                    description: string;
-                };
-                channelId?: undefined;
-                text?: undefined;
-            };
-            required?: undefined;
-        };
-    })[];
-}
+export declare function chunkDiscordContent(text: any, max?: number): any[];
+export declare const discordSkill: any;