@zibby/skills 0.1.96 → 0.2.0

package/dist/figma.d.ts

@@ -1,416 +1,13 @@
 /** Accept a raw file key OR a figma.com URL (/file/, /design/, /board/, /proto/) → the key. */
-export function fileKeyFrom(fileKeyOrUrl: any): string;
+export declare function fileKeyFrom(fileKeyOrUrl: any): string;
 /** Accept a comma-string OR array of node ids; map URL form `1-23` → API `1:23`; join with commas. */
-export function normalizeNodeIds(ids: any): string;
+export declare function normalizeNodeIds(ids: any): string;
 /** Extract the `node-id` query param from a Figma URL, dash→colon. */
-export function nodeIdFromUrl(url: any): string;
+export declare function nodeIdFromUrl(url: any): string;
 /**
  * Dev-Mode-style spec for a REST node: size, position, opacity, cornerRadius,
  * fills (hex), strokes, effects, auto-layout, and text style — recursing
  * `depth` levels into children. Used by figma_get_node_specs.
  */
-export function nodeSpec(n: any, depth: any): {
-    id: any;
-    name: any;
-    type: any;
-};
-export namespace figmaSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let requiresIntegration: "figma";
-    let envKeys: any[];
-    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: {
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                fileKey: {
-                    type: string;
-                    description: string;
-                };
-                depth: {
-                    type: string;
-                    description: string;
-                };
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                fileKey: {
-                    type: string;
-                    description: string;
-                };
-                ids: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                depth: {
-                    type: string;
-                    description: string;
-                };
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                file: {
-                    type: string;
-                    description: string;
-                };
-                ids: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                depth: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                fileKey: {
-                    type: string;
-                    description: string;
-                };
-                ids: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                format: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                scale: {
-                    type: string;
-                    description: string;
-                };
-                svg_include_id: {
-                    type: string;
-                    description: string;
-                };
-                version: {
-                    type: string;
-                    description: string;
-                };
-                depth?: undefined;
-                file?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                file: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                fileKey: {
-                    type: string;
-                    description: string;
-                };
-                depth?: undefined;
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                file: {
-                    type: string;
-                    description: string;
-                };
-                message: {
-                    type: string;
-                    description: string;
-                };
-                comment_id: {
-                    type: string;
-                    description: string;
-                };
-                node_id: {
-                    type: string;
-                    description: string;
-                };
-                x: {
-                    type: string;
-                    description: string;
-                };
-                y: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                team_id: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                project_id: {
-                    type: string;
-                    description: string;
-                };
-                branch_data: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                url?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                url: {
-                    type: string;
-                    description: string;
-                };
-                fileKey?: undefined;
-                depth?: undefined;
-                ids?: undefined;
-                file?: undefined;
-                format?: undefined;
-                scale?: undefined;
-                svg_include_id?: undefined;
-                version?: undefined;
-                message?: undefined;
-                comment_id?: undefined;
-                node_id?: undefined;
-                x?: undefined;
-                y?: undefined;
-                team_id?: undefined;
-                project_id?: undefined;
-                branch_data?: undefined;
-            };
-            required: string[];
-        };
-    })[];
-}
+export declare function nodeSpec(n: any, depth: any): any;
+export declare const figmaSkill: any;

package/dist/function-skill.d.ts

@@ -1,14 +1,28 @@
 /**
- * Create and register a skill.
+ * Unified Skill Factory
  *
- * Function skill:  skill(id, { description, input, handler })
- * MCP skill:       skill(id, { resolve(), serverName?, ... })
+ * Function skill (one skill = one tool, flat):
  *
- * @param {string} id — Unique skill identifier
- * @param {SkillConfig} config — Skill definition
- * @returns {Skill} A registered skill object
+ *   import { skill } from '@zibby/skills';
+ *
+ *   export const add = skill('add', {
+ *     description: 'Add two numbers',
+ *     input: { a: 'number', b: 'number' },
+ *     handler: async ({ a, b }) => ({ result: a + b })
+ *   });
+ *
+ * MCP skill:
+ *
+ *   import { skill } from '@zibby/skills';
+ *
+ *   export const linear = skill('linear', {
+ *     resolve() {
+ *       if (!process.env.LINEAR_API_KEY) return null;
+ *       return { command: 'npx', args: ['-y', '@linear/mcp-server'],
+ *                env: { LINEAR_API_KEY: process.env.LINEAR_API_KEY } };
+ *     }
+ *   });
  */
-export function skill(id: string, config: SkillConfig): Skill;
 /**
  * Create and register a skill.
  *
@@ -19,131 +33,5 @@ export function skill(id: string, config: SkillConfig): Skill;
  * @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;
-};
+export declare function skill(id: any, config: any): any;
+export declare const functionSkill: typeof skill;

package/dist/function-skill.js

@@ -1 +1 @@
-import{createRequire as i}from"module";import{fileURLToPath as a}from"url";import{registerHandlers as u}from"@zibby/core/function-skill-registry.js";import{registerSkill as c}from"@zibby/agent-workflow";var p=i(import.meta.url);function f(){try{return p.resolve("@zibby/core/function-bridge.js")}catch{return null}}var m=import.meta.url;function h(){let e=Error.prepareStackTrace;try{Error.prepareStackTrace=(l,o)=>o;let t=new Error().stack;for(let l=2;l<t.length;l++){let o=t[l].getFileName();if(o&&o!==m&&!o.startsWith("node:"))return o.startsWith("file://")?a(o):o}return null}finally{Error.prepareStackTrace=e}}function y(e){if(!e||typeof e!="object")return{type:"object",properties:{},required:[]};let r={},t=[];for(let[l,o]of Object.entries(e))if(typeof o=="string")r[l]={type:o},t.push(l);else{let{required:s,...n}=o;r[l]=n,s!==!1&&t.push(l)}return{type:"object",properties:r,required:t}}function v(e,r,t){if(typeof t.handler!="function")throw new Error(`Skill "${e}" must have a handler function`);let l={[e]:t.handler},o=[{name:e,description:t.description||"",input_schema:y(t.input)}];return u(e,l,o),{id:e,type:"function",serverName:e,allowedTools:[`mcp__${e}__*`],description:t.description||`Function skill: ${e}`,envKeys:[],tools:o,resolve(){let s=f();return s?{command:"node",args:[s,r,e]}:null}}}function k(e,r){return{id:e,type:"mcp",serverName:r.serverName||e,allowedTools:r.allowedTools||[`mcp__${r.serverName||e}__*`],description:r.description||`MCP skill: ${e}`,envKeys:r.envKeys||[],tools:r.tools||[],resolve:r.resolve,...r.cursorKey&&{cursorKey:r.cursorKey},...r.sessionEnvKey&&{sessionEnvKey:r.sessionEnvKey}}}function d(e,r){let t;if("handler"in r){if(typeof r.handler!="function")throw new Error(`Skill "${e}" must have a handler function`);let l=h();if(!l)throw new Error(`Could not resolve caller file for skill "${e}".`);t=v(e,l,r)}else if(typeof r.resolve=="function")t=k(e,r);else throw new Error(`Skill "${e}" must have either a handler (function skill) or resolve (MCP skill).`);return c(t),t}var S=d;export{S as functionSkill,d as skill};
+import{createRequire as i}from"module";import{fileURLToPath as a}from"url";import{registerHandlers as u}from"@zibby/core/function-skill-registry.js";import{registerSkill as c}from"@zibby/agent-workflow";var p=i(import.meta.url);function f(){try{return p.resolve("@zibby/core/function-bridge.js")}catch{return null}}var m=import.meta.url;function y(){let e=Error.prepareStackTrace;try{Error.prepareStackTrace=(l,o)=>o;let t=new Error().stack;for(let l=2;l<t.length;l++){let o=t[l].getFileName();if(o&&o!==m&&!o.startsWith("node:"))return o.startsWith("file://")?a(o):o}return null}finally{Error.prepareStackTrace=e}}function h(e){if(!e||typeof e!="object")return{type:"object",properties:{},required:[]};let r={},t=[];for(let[l,o]of Object.entries(e))if(typeof o=="string")r[l]={type:o},t.push(l);else{let{required:s,...n}=o;r[l]=n,s!==!1&&t.push(l)}return{type:"object",properties:r,required:t}}function v(e,r,t){if(typeof t.handler!="function")throw new Error(`Skill "${e}" must have a handler function`);let l={[e]:t.handler},o=[{name:e,description:t.description||"",input_schema:h(t.input)}];return u(e,l,o),{id:e,type:"function",serverName:e,allowedTools:[`mcp__${e}__*`],description:t.description||`Function skill: ${e}`,envKeys:[],tools:o,resolve(){let s=f();return s?{command:"node",args:[s,r,e]}:null}}}function k(e,r){return{id:e,type:"mcp",serverName:r.serverName||e,allowedTools:r.allowedTools||[`mcp__${r.serverName||e}__*`],description:r.description||`MCP skill: ${e}`,envKeys:r.envKeys||[],tools:r.tools||[],resolve:r.resolve,...r.cursorKey&&{cursorKey:r.cursorKey},...r.sessionEnvKey&&{sessionEnvKey:r.sessionEnvKey}}}function d(e,r){let t;if("handler"in r){if(typeof r.handler!="function")throw new Error(`Skill "${e}" must have a handler function`);let l=y();if(!l)throw new Error(`Could not resolve caller file for skill "${e}".`);t=v(e,l,r)}else if(typeof r.resolve=="function")t=k(e,r);else throw new Error(`Skill "${e}" must have either a handler (function skill) or resolve (MCP skill).`);return c(t),t}var S=d;export{S as functionSkill,d as skill};