patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/tools/createLinearIssue.d.ts

@@ -0,0 +1,84 @@
+export declare function createLinearIssueTool(): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                title: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                description: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                teamKey: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                priority: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                labelNames: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        maxLength: number;
+                    };
+                    maxItems: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                };
+                identifier: {
+                    type: string;
+                };
+                title: {
+                    type: string;
+                };
+                url: {
+                    type: string;
+                };
+                state: {
+                    type: string;
+                };
+                team: {
+                    type: string;
+                };
+                linearConnected: {
+                    type: string;
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/createLinearIssue.js

@@ -0,0 +1,146 @@
+import { createIssue, listTeams, loadTokens } from "../connectors/linear.js";
+import { requireString, successStructured } from "./utils.js";
+export function createLinearIssueTool() {
+    return {
+        schema: {
+            name: "createLinearIssue",
+            description: "Create a new Linear issue. Requires Linear connector connected. Returns the created issue identifier and URL.",
+            annotations: { readOnlyHint: false },
+            inputSchema: {
+                type: "object",
+                required: ["title"],
+                properties: {
+                    title: {
+                        type: "string",
+                        description: "Issue title.",
+                        maxLength: 500,
+                    },
+                    description: {
+                        type: "string",
+                        description: "Issue description (Markdown).",
+                        maxLength: 10000,
+                    },
+                    teamKey: {
+                        type: "string",
+                        description: "Team key (e.g. 'ENG'). If omitted, uses the first team in your workspace.",
+                        maxLength: 50,
+                    },
+                    priority: {
+                        type: "integer",
+                        description: "Priority: 0=no priority, 1=urgent, 2=high, 3=medium, 4=low.",
+                        minimum: 0,
+                        maximum: 4,
+                    },
+                    labelNames: {
+                        type: "array",
+                        description: "Label names to attach (must already exist in Linear).",
+                        items: { type: "string", maxLength: 100 },
+                        maxItems: 10,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    identifier: { type: "string" },
+                    title: { type: "string" },
+                    url: { type: "string" },
+                    state: { type: "string" },
+                    team: { type: "string" },
+                    linearConnected: { type: "boolean" },
+                    error: { type: "string" },
+                },
+                required: [
+                    "id",
+                    "identifier",
+                    "title",
+                    "url",
+                    "state",
+                    "team",
+                    "linearConnected",
+                ],
+            },
+        },
+        timeoutMs: 20_000,
+        async handler(args, signal) {
+            const tokens = loadTokens();
+            if (!tokens) {
+                return successStructured({
+                    id: "",
+                    identifier: "",
+                    title: "",
+                    url: "",
+                    state: "",
+                    team: "",
+                    linearConnected: false,
+                    error: "Linear not connected. GET /connections/linear/authorize first.",
+                });
+            }
+            const title = requireString(args, "title", 500);
+            const description = typeof args.description === "string" ? args.description : undefined;
+            const teamKeyArg = typeof args.teamKey === "string" ? args.teamKey : undefined;
+            const priority = typeof args.priority === "number" ? args.priority : undefined;
+            const labelNames = Array.isArray(args.labelNames)
+                ? args.labelNames
+                    .filter((l) => typeof l === "string")
+                    .map(String)
+                : [];
+            try {
+                // Resolve team ID
+                const teams = await listTeams(signal);
+                if (teams.length === 0) {
+                    throw new Error("No teams found in Linear workspace.");
+                }
+                let teamName;
+                let teamLabel;
+                if (teamKeyArg) {
+                    const match = teams.find((t) => t.key.toLowerCase() === teamKeyArg.toLowerCase());
+                    if (!match) {
+                        throw new Error(`Team '${teamKeyArg}' not found. Available teams: ${teams.map((t) => t.key).join(", ")}`);
+                    }
+                    teamName = match.name;
+                    teamLabel = match.key ? `${match.name} (${match.key})` : match.name;
+                }
+                else {
+                    const first = teams[0];
+                    if (!first)
+                        throw new Error("No teams found in Linear workspace.");
+                    teamName = first.name;
+                    teamLabel = first.key ? `${first.name} (${first.key})` : first.name;
+                }
+                const issue = await createIssue({
+                    team: teamName,
+                    title,
+                    description,
+                    priority,
+                    labels: labelNames.length > 0 ? labelNames : undefined,
+                }, signal);
+                return successStructured({
+                    id: issue.id,
+                    identifier: issue.identifier,
+                    title: issue.title,
+                    url: issue.url,
+                    state: issue.state?.name ?? "",
+                    team: teamLabel,
+                    linearConnected: true,
+                });
+            }
+            catch (err) {
+                const notConnected = err instanceof Error && err.message.includes("not connected");
+                return successStructured({
+                    id: "",
+                    identifier: "",
+                    title: "",
+                    url: "",
+                    state: "",
+                    team: "",
+                    linearConnected: !notConnected,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=createLinearIssue.js.map

package/dist/tools/createLinearIssue.js.map

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

package/dist/tools/fetchCalendarEvents.d.ts

@@ -0,0 +1,94 @@
+export declare function createFetchCalendarEventsTool(): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                daysAhead: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                calendarId: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                events: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            id: {
+                                type: string;
+                            };
+                            summary: {
+                                type: string;
+                            };
+                            description: {
+                                type: string[];
+                            };
+                            start: {
+                                type: string;
+                            };
+                            end: {
+                                type: string;
+                            };
+                            allDay: {
+                                type: string;
+                            };
+                            location: {
+                                type: string[];
+                            };
+                            htmlLink: {
+                                type: string;
+                            };
+                            attendees: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                count: {
+                    type: string;
+                };
+                daysAhead: {
+                    type: string;
+                };
+                calendarConnected: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/fetchCalendarEvents.js

@@ -0,0 +1,97 @@
+import { listEvents } from "../connectors/googleCalendar.js";
+import { successStructured } from "./utils.js";
+export function createFetchCalendarEventsTool() {
+    return {
+        schema: {
+            name: "fetchCalendarEvents",
+            description: "Fetch upcoming Google Calendar events. Returns events for the next N days. Requires Google Calendar connector connected.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    daysAhead: {
+                        type: "integer",
+                        description: "Number of days ahead to fetch (default: 7, max: 30).",
+                        minimum: 1,
+                        maximum: 30,
+                    },
+                    maxResults: {
+                        type: "integer",
+                        description: "Maximum events to return (default: 20, max: 50).",
+                        minimum: 1,
+                        maximum: 50,
+                    },
+                    calendarId: {
+                        type: "string",
+                        description: "Calendar ID to query (e.g. 'primary' or an email address). Defaults to the connected calendar.",
+                        maxLength: 200,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    events: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                id: { type: "string" },
+                                summary: { type: "string" },
+                                description: { type: ["string", "null"] },
+                                start: { type: "string" },
+                                end: { type: "string" },
+                                allDay: { type: "boolean" },
+                                location: { type: ["string", "null"] },
+                                htmlLink: { type: "string" },
+                                attendees: { type: "array", items: { type: "string" } },
+                            },
+                            required: ["id", "summary", "start", "end", "allDay", "htmlLink"],
+                        },
+                    },
+                    count: { type: "integer" },
+                    daysAhead: { type: "integer" },
+                    calendarConnected: { type: "boolean" },
+                },
+                required: ["events", "count", "daysAhead", "calendarConnected"],
+            },
+        },
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const daysAhead = typeof args.daysAhead === "number" ? args.daysAhead : 7;
+            const maxResults = typeof args.maxResults === "number" ? args.maxResults : 20;
+            const calendarId = typeof args.calendarId === "string" ? args.calendarId : undefined;
+            try {
+                const events = await listEvents({ daysAhead, maxResults, calendarId }, signal);
+                return successStructured({
+                    events: events.map((e) => ({
+                        id: e.id,
+                        summary: e.summary,
+                        description: e.description ?? null,
+                        start: e.start,
+                        end: e.end,
+                        allDay: e.allDay,
+                        location: e.location ?? null,
+                        htmlLink: e.htmlLink,
+                        attendees: e.attendees ?? [],
+                    })),
+                    count: events.length,
+                    daysAhead,
+                    calendarConnected: true,
+                });
+            }
+            catch (err) {
+                const notConnected = err instanceof Error && err.message.includes("not connected");
+                return successStructured({
+                    events: [],
+                    count: 0,
+                    daysAhead,
+                    calendarConnected: !notConnected,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=fetchCalendarEvents.js.map

package/dist/tools/fetchCalendarEvents.js.map

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

package/dist/tools/fetchGithubIssue.d.ts

@@ -0,0 +1,80 @@
+export declare function createFetchGithubIssueTool(): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                issueRef: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                number: {
+                    type: string;
+                };
+                title: {
+                    type: string;
+                };
+                body: {
+                    type: string;
+                };
+                state: {
+                    type: string;
+                };
+                url: {
+                    type: string;
+                };
+                repo: {
+                    type: string;
+                };
+                author: {
+                    type: string;
+                };
+                labels: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                assignees: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                createdAt: {
+                    type: string;
+                };
+                updatedAt: {
+                    type: string;
+                };
+                comments: {
+                    type: string;
+                };
+                githubConnected: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/fetchGithubIssue.js

@@ -0,0 +1,84 @@
+import { fetchGitHubIssue } from "../connectors/github.js";
+import { requireString, successStructured } from "./utils.js";
+export function createFetchGithubIssueTool() {
+    return {
+        schema: {
+            name: "fetchGithubIssue",
+            description: "Fetch a GitHub issue by URL or owner/repo#number ref. Returns title, body, state, labels, assignees, and author. Requires GitHub connector connected.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["issueRef"],
+                properties: {
+                    issueRef: {
+                        type: "string",
+                        description: "GitHub issue URL (https://github.com/owner/repo/issues/42) or short ref (owner/repo#42).",
+                        maxLength: 500,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    number: { type: "integer" },
+                    title: { type: "string" },
+                    body: { type: "string" },
+                    state: { type: "string" },
+                    url: { type: "string" },
+                    repo: { type: "string" },
+                    author: { type: "string" },
+                    labels: { type: "array", items: { type: "string" } },
+                    assignees: { type: "array", items: { type: "string" } },
+                    createdAt: { type: "string" },
+                    updatedAt: { type: "string" },
+                    comments: { type: "integer" },
+                    githubConnected: { type: "boolean" },
+                },
+                required: [
+                    "number",
+                    "title",
+                    "body",
+                    "state",
+                    "url",
+                    "repo",
+                    "author",
+                    "labels",
+                    "assignees",
+                    "createdAt",
+                    "updatedAt",
+                    "comments",
+                    "githubConnected",
+                ],
+            },
+        },
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const issueRef = requireString(args, "issueRef", 500);
+            try {
+                const issue = await fetchGitHubIssue(issueRef, signal);
+                return successStructured({ ...issue, githubConnected: true });
+            }
+            catch (err) {
+                const notConnected = err instanceof Error && err.message.includes("not connected");
+                return successStructured({
+                    number: 0,
+                    title: "",
+                    body: "",
+                    state: "",
+                    url: "",
+                    repo: "",
+                    author: "",
+                    labels: [],
+                    assignees: [],
+                    createdAt: "",
+                    updatedAt: "",
+                    comments: 0,
+                    githubConnected: !notConnected,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=fetchGithubIssue.js.map

package/dist/tools/fetchGithubIssue.js.map

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