@zibby/skills 0.1.34 → 0.1.35

package/dist/chat-notify.d.ts

@@ -0,0 +1,409 @@
+export namespace chatNotifySkill {
+    let id: string;
+    let description: string;
+    let envKeys: any[];
+    const serverName: string;
+    const allowedTools: string[];
+    let promptFragment: string;
+    /**
+     * Runtime MCP server selection. Picks the provider whose env var
+     * the user actually set. Falls back to null when neither is
+     * configured (workflow code should already have errored on env
+     * validation before reaching this point).
+     */
+    function resolve(ctx: any): {
+        type: string;
+        command: string;
+        args: any[];
+        env: {};
+        alwaysLoad: boolean;
+    };
+    function handleToolCall(name: any, args: any, context: any): Promise<string>;
+    const tools: ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel?: undefined;
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                blocks: {
+                    type: string;
+                    description: string;
+                };
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                thread_ts: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                blocks?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                timestamp: {
+                    type: string;
+                    description: string;
+                };
+                reaction: {
+                    type: string;
+                    description: string;
+                };
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                thread_ts: {
+                    type: string;
+                    description: string;
+                };
+                text?: undefined;
+                blocks?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                user_id: {
+                    type: string;
+                    description: string;
+                };
+                channel?: undefined;
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                email: {
+                    type: string;
+                    description: string;
+                };
+                channel?: undefined;
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                usergroup?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                usergroup: {
+                    type: string;
+                    description: string;
+                };
+                channel?: undefined;
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                limit?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                query?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+                channel?: undefined;
+                text?: undefined;
+                blocks?: undefined;
+                thread_ts?: undefined;
+                timestamp?: undefined;
+                reaction?: undefined;
+                user_id?: undefined;
+                email?: undefined;
+                usergroup?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                receive_id: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                message_id?: undefined;
+                page_size?: undefined;
+                chat_id?: undefined;
+                email?: undefined;
+                query?: undefined;
+                limit?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                message_id: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                receive_id?: undefined;
+                page_size?: undefined;
+                chat_id?: undefined;
+                email?: undefined;
+                query?: undefined;
+                limit?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                page_size: {
+                    type: string;
+                    description: string;
+                };
+                receive_id?: undefined;
+                text?: undefined;
+                message_id?: undefined;
+                chat_id?: undefined;
+                email?: undefined;
+                query?: undefined;
+                limit?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                chat_id: {
+                    type: string;
+                    description: string;
+                };
+                page_size: {
+                    type: string;
+                    description: string;
+                };
+                receive_id?: undefined;
+                text?: undefined;
+                message_id?: undefined;
+                email?: undefined;
+                query?: undefined;
+                limit?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                email: {
+                    type: string;
+                    description: string;
+                };
+                receive_id?: undefined;
+                text?: undefined;
+                message_id?: undefined;
+                page_size?: undefined;
+                chat_id?: undefined;
+                query?: undefined;
+                limit?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+                receive_id?: undefined;
+                text?: undefined;
+                message_id?: undefined;
+                page_size?: undefined;
+                chat_id?: undefined;
+                email?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}

package/dist/core-tools.d.ts

@@ -0,0 +1,131 @@
+export namespace coreToolsSkill {
+    let id: string;
+    let description: string;
+    let envKeys: any[];
+    let tools: ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                content?: undefined;
+                command?: undefined;
+                cwd?: undefined;
+                url?: undefined;
+                seconds?: undefined;
+                reason?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+                command?: undefined;
+                cwd?: undefined;
+                url?: undefined;
+                seconds?: undefined;
+                reason?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                content?: undefined;
+                command?: undefined;
+                cwd?: undefined;
+                url?: undefined;
+                seconds?: undefined;
+                reason?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                command: {
+                    type: string;
+                    description: string;
+                };
+                cwd: {
+                    type: string;
+                    description: string;
+                };
+                path?: undefined;
+                content?: undefined;
+                url?: undefined;
+                seconds?: undefined;
+                reason?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                url: {
+                    type: string;
+                    description: string;
+                };
+                path?: undefined;
+                content?: undefined;
+                command?: undefined;
+                cwd?: undefined;
+                seconds?: undefined;
+                reason?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                seconds: {
+                    type: string;
+                    description: string;
+                };
+                reason: {
+                    type: string;
+                    description: string;
+                };
+                path?: undefined;
+                content?: undefined;
+                command?: undefined;
+                cwd?: undefined;
+                url?: undefined;
+            };
+            required?: undefined;
+        };
+    })[];
+    function handleToolCall(name: any, args: any, context: any): Promise<any>;
+    function resolve(): any;
+}

package/dist/function-skill.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Create and register a skill.
+ *
+ * Function skill:  skill(id, { description, input, handler })
+ * MCP skill:       skill(id, { resolve(), serverName?, ... })
+ *
+ * @param {string} id — Unique skill identifier
+ * @param {SkillConfig} config — Skill definition
+ * @returns {Skill} A registered skill object
+ */
+export function skill(id: string, config: SkillConfig): Skill;
+/**
+ * Create and register a skill.
+ *
+ * Function skill:  skill(id, { description, input, handler })
+ * MCP skill:       skill(id, { resolve(), serverName?, ... })
+ *
+ * @param {string} id — Unique skill identifier
+ * @param {SkillConfig} config — Skill definition
+ * @returns {Skill} A registered skill object
+ */
+export function functionSkill(id: string, config: SkillConfig): Skill;
+/**
+ * A tool exposed by a skill (Anthropic tool-definition shape).
+ */
+export type SkillTool = {
+    /**
+     * — Tool name.
+     */
+    name: string;
+    /**
+     * — Human-readable description.
+     */
+    description?: string;
+    /**
+     * — JSON Schema for the tool input.
+     */
+    input_schema?: any;
+};
+/**
+ * A registered skill object. Returned by {@link skill} and consumed by
+ * `registerSkill` / the workflow runtime.
+ */
+export type Skill = {
+    /**
+     * — Unique skill identifier.
+     */
+    id: string;
+    /**
+     * — Skill kind.
+     */
+    type: "function" | "mcp";
+    /**
+     * — MCP server name this skill registers under.
+     */
+    serverName: string;
+    /**
+     * — Glob patterns of tools this skill grants.
+     */
+    allowedTools: string[];
+    /**
+     * — Human-readable description.
+     */
+    description: string;
+    /**
+     * — Env var names the skill reads at resolve time.
+     */
+    envKeys: string[];
+    /**
+     * — Tool definitions exposed by the skill.
+     */
+    tools: SkillTool[];
+    /**
+     *   — Returns the MCP server launch config, or null when unavailable.
+     */
+    resolve: () => ({
+        command: string;
+        args: string[];
+        env?: Record<string, string>;
+    } | null);
+    /**
+     * — Optional Cursor MCP registry key.
+     */
+    cursorKey?: string;
+    /**
+     * — Optional env key carrying session info.
+     */
+    sessionEnvKey?: string;
+};
+/**
+ * Function-skill input field: either a JSON-Schema type string
+ * (e.g. `'number'`) or a partial JSON-Schema object with an optional
+ * `required` flag (defaults to required).
+ */
+export type SkillInputField = string | (any & {
+    required?: boolean;
+});
+/**
+ * Configuration passed to {@link skill}.
+ *
+ * Provide `handler` for a function skill (one skill = one tool), or
+ * `resolve` for an MCP skill.
+ */
+export type SkillConfig = {
+    /**
+     * — Human-readable description.
+     */
+    description?: string;
+    /**
+     * — Function-skill input schema.
+     */
+    input?: Record<string, SkillInputField>;
+    /**
+     * — Function-skill handler (makes it a function skill).
+     */
+    handler?: (args: any) => any;
+    /**
+     * — MCP-skill resolver (makes it an MCP skill).
+     */
+    resolve?: () => ({
+        command: string;
+        args: string[];
+        env?: Record<string, string>;
+    } | null);
+    /**
+     * — MCP server name (defaults to `id`).
+     */
+    serverName?: string;
+    /**
+     * — Allowed tool globs.
+     */
+    allowedTools?: string[];
+    /**
+     * — Env var names the skill reads.
+     */
+    envKeys?: string[];
+    /**
+     * — Tool definitions (MCP skills).
+     */
+    tools?: SkillTool[];
+    /**
+     * — Optional Cursor MCP registry key.
+     */
+    cursorKey?: string;
+    /**
+     * — Optional session env key.
+     */
+    sessionEnvKey?: string;
+};