@zibby/skills 0.1.96 → 0.2.0

package/dist/larkDocs.d.ts

@@ -1,3 +1,33 @@
+/**
+ * Lark / Feishu Docs skill — read / create / append Lark Docx documents.
+ *
+ * The document-world twin of googleDocs.js + notion.js, but for Lark/Feishu.
+ * It REUSES the already-connected Lark app (integration `lark`) — the SAME
+ * app that powers lark.js messaging — so there is nothing new to connect: the
+ * app just needs the docx (+ optional wiki/drive) scopes added in the Lark
+ * developer console. Auth is minted EXACTLY like lark.js:
+ *   resolveIntegrationToken('lark') → { appId, appSecret, host } →
+ *   tenant_access_token (cached ~2h) → Bearer on every Docx call.
+ *
+ * Design rules (mirrors notion.js / googleDocs.js):
+ *   - resolveIntegrationToken('lark') is the SINGLE auth chokepoint (via the
+ *     larkDocsApi() helper). Don't re-resolve at call sites.
+ *   - handleToolCall() dispatches the tools and NEVER throws — any HTTP or
+ *     parse failure is returned as { ok:false, error } so a missing/broken
+ *     Lark connection can't crash the run.
+ *   - Region-aware host: whatever resolveIntegrationToken('lark') returns as
+ *     `host` (open.feishu.cn vs open.larksuite.com) is used verbatim, so the
+ *     skill always matches the connected app's region. No baked host, no CLI,
+ *     no heavy deps — pure `fetch`.
+ *
+ * Docx v1 API (host-relative):
+ *   GET  /open-apis/docx/v1/documents/{id}                     → { document:{title,...} }
+ *   GET  /open-apis/docx/v1/documents/{id}/raw_content?lang=0  → { content } (plain text)
+ *   POST /open-apis/docx/v1/documents                          → { document:{document_id,title} }
+ *   POST /open-apis/docx/v1/documents/{id}/blocks/{block}/children
+ *        (block == document_id == the doc root) → append blocks at the end
+ *   GET  /open-apis/wiki/v2/spaces/get_node?token={t}          → { node:{obj_token,obj_type} }
+ */
 /**
  * Derive the human-facing doc web URL from the open-api host + document id.
  * The open-api host (open.feishu.cn / open.larksuite.com) is region-specific;
@@ -5,7 +35,7 @@
  * canonical URL — a tenant with a vanity subdomain may render its own host, but
  * the product-domain URL still resolves for the user.
  */
-export function docWebUrl(host: any, id: any): string;
+export declare function docWebUrl(host: any, id: any): string;
 /**
  * Parse a Lark/Feishu doc reference (raw token OR URL) into { type, token }.
  *   - .../docx/<token>  → { type:'docx', token }
@@ -13,7 +43,7 @@ export function docWebUrl(host: any, id: any): string;
  *   - bare token        → { type:'docx', token }
  * Returns null when nothing usable can be extracted. Pure + side-effect-free.
  */
-export function parseLarkDocRef(ref: any): {
+export declare function parseLarkDocRef(ref: any): {
     type: string;
     token: string;
 };
@@ -25,237 +55,6 @@ export function parseLarkDocRef(ref: any): {
  * styles — honest + robust). Empty lines are skipped (Lark rejects empty text
  * blocks). Bounded by the caller's chunking to MAX_BLOCK_CHILDREN per request.
  */
-export function markdownToLarkBlocks(markdown: any): {
-    [x: string]: number | {
-        elements: {
-            text_run: {
-                content: string;
-            };
-        }[];
-        style: {};
-    };
-    block_type: number;
-}[];
-export function _resetLarkDocsTokenCache(): void;
-export namespace larkDocsSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let requiresIntegration: "lark";
-    let description: string;
-    let envKeys: any[];
-    let promptFragment: string;
-    /**
-     * Spawn the GENERIC skill MCP server (bin/mcp-skill.mjs) pointing at this
-     * module's larkDocsSkill export, so the AGENT gets real mcp__larkdocs__*
-     * tools. Auth flows through the INHERITED env (PROJECT_API_TOKEN →
-     * resolveIntegrationToken('lark')), so no provider-specific env keys are
-     * needed here. When unconnected, handleToolCall returns { ok:false, error }.
-     */
-    function resolve(): {
-        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: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                markdown?: undefined;
-                text?: undefined;
-                folderToken?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-                fileType?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                title: {
-                    type: string;
-                    description: string;
-                };
-                markdown: {
-                    type: string;
-                    description: string;
-                };
-                text: {
-                    type: string;
-                    description: string;
-                };
-                folderToken: {
-                    type: string;
-                    description: string;
-                };
-                documentId?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-                fileType?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                markdown: {
-                    type: string;
-                    description: string;
-                };
-                text: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                folderToken?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-                fileType?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                imagePath: {
-                    type: string;
-                    description: string;
-                };
-                width: {
-                    type: string;
-                    description: string;
-                };
-                height: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                markdown?: undefined;
-                text?: undefined;
-                folderToken?: undefined;
-                fileType?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                fileType: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                markdown?: undefined;
-                text?: undefined;
-                folderToken?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                text: {
-                    type: string;
-                    description: string;
-                };
-                fileType: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                markdown?: undefined;
-                folderToken?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-                commentId?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                documentId: {
-                    type: string;
-                    description: string;
-                };
-                commentId: {
-                    type: string;
-                    description: string;
-                };
-                text: {
-                    type: string;
-                    description: string;
-                };
-                fileType: {
-                    type: string;
-                    description: string;
-                };
-                title?: undefined;
-                markdown?: undefined;
-                folderToken?: undefined;
-                imagePath?: undefined;
-                width?: undefined;
-                height?: undefined;
-            };
-            required: string[];
-        };
-    })[];
-}
+export declare function markdownToLarkBlocks(markdown: any): any[];
+export declare const larkDocsSkill: any;
+export declare function _resetLarkDocsTokenCache(): void;

package/dist/linear.d.ts

@@ -1,3 +1,37 @@
+/**
+ * Linear integration — low-level API-wrapper skill.
+ *
+ * Linear exposes a single GraphQL endpoint (https://api.linear.app/graphql).
+ * Auth is a static API key (or an OAuth bearer). Unlike Jira/GitHub — whose
+ * OAuth tokens are minted by the Zibby backend and fetched via
+ * resolveIntegrationToken() — Linear has no backend integration handler yet,
+ * so this skill reads the key straight from the environment (LINEAR_API_KEY).
+ * That matches the task spec ("Auth/config via env, same pattern as jira.js's
+ * envKeys"). When a backend Linear OAuth handler + an INTEGRATIONS.LINEAR
+ * constant land, swap linearFetch's auth header to resolveIntegrationToken
+ * ('linear') and add `requiresIntegration: INTEGRATIONS.LINEAR` below — the
+ * tool surface does not need to change.
+ *
+ * Linear auth header semantics (https://developers.linear.app/docs):
+ *   - Personal API key:  Authorization: <key>            (NO "Bearer " prefix)
+ *   - OAuth access token: Authorization: Bearer <token>
+ * We pass the key verbatim. Power users who paste an OAuth token should
+ * include the "Bearer " prefix themselves, or set LINEAR_OAUTH_TOKEN.
+ *
+ * Tracker quirks the neutral adapter must know (Linear-specific):
+ *   - Workflow STATES are per-team, not global. A "state" is a WorkflowState
+ *     node {id,name,type} scoped to a team. There is no Jira-style
+ *     "transition" object — you update issue.stateId directly to ANY state
+ *     in the same team. So "transition" == resolve target state-name -> the
+ *     team's matching WorkflowState id -> issueUpdate(stateId). We do that
+ *     resolution here with the same fuzzy matching jira.js uses.
+ *   - state.type is one of: backlog | unstarted | started | completed |
+ *     canceled | triage. Useful for mapping neutral statuses.
+ *   - Linear has native ATTACHMENTS (attachmentLinkURL / attachmentCreate)
+ *     which is the first-class way to link a PR to an issue. See
+ *     linear_link_attachment below. The adapter's linkPullRequest should
+ *     prefer it and fall back to linear_add_comment.
+ */
 /**
  * Low-level Linear GraphQL helper. POSTs { query, variables }, throws on
  * transport or GraphQL errors, returns the `data` object.
@@ -10,346 +44,5 @@
  * @param {object} [variables]
  * @returns {Promise<any>} the GraphQL `data` payload
  */
-export function linearFetch(query: string, variables?: object): Promise<any>;
-export namespace linearSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let requiresIntegration: "linear";
-    let envKeys: string[];
-    let description: string;
-    let promptFragment: string;
-    function resolve(): {
-        command: any;
-        args: any[];
-        env: {
-            LINEAR_API_URL: any;
-        };
-        description: string;
-        type?: undefined;
-        alwaysLoad?: undefined;
-    } | {
-        type: string;
-        command: string;
-        args: any[];
-        env: {
-            LINEAR_API_URL: any;
-        };
-        description: string;
-        alwaysLoad: boolean;
-    };
-    function handleToolCall(name: any, args: any): Promise<string>;
-    let tools: ({
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                teamId?: undefined;
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                identifier?: undefined;
-                issueId?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                teamId: {
-                    type: string;
-                    description: string;
-                };
-                teamKey: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                identifier?: undefined;
-                issueId?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                teamId: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                identifier?: undefined;
-                issueId?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                teamId: {
-                    type: string;
-                    description: string;
-                };
-                teamKey: {
-                    type: string;
-                    description: string;
-                };
-                stateId: {
-                    type: string;
-                    description: string;
-                };
-                stateName: {
-                    type: string;
-                    description: string;
-                };
-                label: {
-                    type: string;
-                    description: string;
-                };
-                assigneeId: {
-                    type: string;
-                    description: string;
-                };
-                updatedAfter: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                identifier?: undefined;
-                issueId?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                identifier: {
-                    type: string;
-                    description: string;
-                };
-                issueId: {
-                    type: string;
-                    description: string;
-                };
-                limit?: undefined;
-                teamId?: undefined;
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                identifier: {
-                    type: string;
-                    description: string;
-                };
-                issueId: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-                teamId?: undefined;
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                identifier: {
-                    type: string;
-                    description: string;
-                };
-                issueId: {
-                    type: string;
-                    description: string;
-                };
-                body: {
-                    type: string;
-                    description: string;
-                };
-                limit?: undefined;
-                teamId?: undefined;
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                toStatus?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                identifier: {
-                    type: string;
-                    description: string;
-                };
-                issueId: {
-                    type: string;
-                    description: string;
-                };
-                stateId: {
-                    type: string;
-                    description: string;
-                };
-                stateName: {
-                    type: string;
-                    description: string;
-                };
-                toStatus: {
-                    type: string;
-                    description: string;
-                };
-                limit?: undefined;
-                teamId?: undefined;
-                teamKey?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                body?: undefined;
-                url?: undefined;
-                title?: undefined;
-                subtitle?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                identifier: {
-                    type: string;
-                    description: string;
-                };
-                issueId: {
-                    type: string;
-                    description: string;
-                };
-                url: {
-                    type: string;
-                    description: string;
-                };
-                title: {
-                    type: string;
-                    description: string;
-                };
-                subtitle: {
-                    type: string;
-                    description: string;
-                };
-                limit?: undefined;
-                teamId?: undefined;
-                teamKey?: undefined;
-                stateId?: undefined;
-                stateName?: undefined;
-                label?: undefined;
-                assigneeId?: undefined;
-                updatedAfter?: undefined;
-                body?: undefined;
-                toStatus?: undefined;
-            };
-            required: string[];
-        };
-    })[];
-}
+export declare function linearFetch(query: any, variables?: any): Promise<any>;
+export declare const linearSkill: any;