patchwork-os 0.2.0-alpha.9 → 0.2.0-beta.0

package/dist/recipes/tools/stripe.js

@@ -0,0 +1,265 @@
+/**
+ * Stripe tools — read-only access to charges, customers, subscriptions, invoices.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// stripe.listCharges
+// ============================================================================
+registerTool({
+    id: "stripe.listCharges",
+    namespace: "stripe",
+    description: "List Stripe charges, optionally filtered by customer ID or status.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of charges to return (default 10, max 100)",
+                default: 10,
+            },
+            customerId: {
+                type: "string",
+                description: "Filter by Stripe customer ID",
+            },
+            status: {
+                type: "string",
+                description: "Filter by charge status (e.g. succeeded, failed)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+            has_more: { type: "boolean" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.listCharges({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            customerId: typeof params.customerId === "string" ? params.customerId : undefined,
+            status: typeof params.status === "string" ? params.status : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// stripe.getCharge
+// ============================================================================
+registerTool({
+    id: "stripe.getCharge",
+    namespace: "stripe",
+    description: "Fetch a single Stripe charge by ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            chargeId: { type: "string", description: "Stripe charge ID (ch_...)" },
+            into: CommonSchemas.into,
+        },
+        required: ["chargeId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            amount: { type: "number" },
+            currency: { type: "string" },
+            status: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.getCharge(params.chargeId);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// stripe.listCustomers
+// ============================================================================
+registerTool({
+    id: "stripe.listCustomers",
+    namespace: "stripe",
+    description: "List Stripe customers, optionally filtered by email.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of customers to return (default 10, max 100)",
+                default: 10,
+            },
+            email: {
+                type: "string",
+                description: "Filter by customer email address",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+            has_more: { type: "boolean" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.listCustomers({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            email: typeof params.email === "string" ? params.email : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// stripe.getCustomer
+// ============================================================================
+registerTool({
+    id: "stripe.getCustomer",
+    namespace: "stripe",
+    description: "Fetch a single Stripe customer by ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            customerId: {
+                type: "string",
+                description: "Stripe customer ID (cus_...)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["customerId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            email: { type: ["string", "null"] },
+            name: { type: ["string", "null"] },
+            balance: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.getCustomer(params.customerId);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// stripe.listSubscriptions
+// ============================================================================
+registerTool({
+    id: "stripe.listSubscriptions",
+    namespace: "stripe",
+    description: "List Stripe subscriptions, optionally filtered by customer ID or status.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of subscriptions to return (default 10, max 100)",
+                default: 10,
+            },
+            customerId: {
+                type: "string",
+                description: "Filter by Stripe customer ID",
+            },
+            status: {
+                type: "string",
+                description: "Filter by status: active, past_due, canceled, trialing, all",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+            has_more: { type: "boolean" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.listSubscriptions({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            customerId: typeof params.customerId === "string" ? params.customerId : undefined,
+            status: typeof params.status === "string" ? params.status : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// stripe.listInvoices
+// ============================================================================
+registerTool({
+    id: "stripe.listInvoices",
+    namespace: "stripe",
+    description: "List Stripe invoices, optionally filtered by customer ID or status.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of invoices to return (default 10, max 100)",
+                default: 10,
+            },
+            customerId: {
+                type: "string",
+                description: "Filter by Stripe customer ID",
+            },
+            status: {
+                type: "string",
+                description: "Filter by invoice status (draft, open, paid, uncollectible, void)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+            has_more: { type: "boolean" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getStripeConnector } = await import("../../connectors/stripe.js");
+        const connector = getStripeConnector();
+        const result = await connector.listInvoices({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            customerId: typeof params.customerId === "string" ? params.customerId : undefined,
+            status: typeof params.status === "string" ? params.status : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=stripe.js.map

package/dist/recipes/tools/stripe.js.map

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

package/dist/recipes/tools/zendesk.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Zendesk tools — list/get tickets, add comments, update status, list agents.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+export {};

package/dist/recipes/tools/zendesk.js

@@ -0,0 +1,245 @@
+/**
+ * Zendesk tools — list/get tickets, add comments, update status, list agents.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+import { assertWriteAllowed } from "../../featureFlags.js";
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// zendesk.listTickets
+// ============================================================================
+registerTool({
+    id: "zendesk.listTickets",
+    namespace: "zendesk",
+    description: "List Zendesk tickets, optionally filtered by status, assignee, or free-text query.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                enum: ["new", "open", "pending", "hold", "solved", "closed"],
+                description: "Filter by ticket status",
+            },
+            assigneeId: {
+                type: "number",
+                description: "Filter by assignee user ID",
+            },
+            query: {
+                type: "string",
+                description: "Free-text search query (uses Zendesk search API)",
+            },
+            perPage: {
+                type: "number",
+                description: "Results per page (default 25, max 100)",
+                default: 25,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            results: { type: "array", items: { type: "object" } },
+            count: { type: "number" },
+            next_page: { type: ["string", "null"] },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getZendeskConnector } = await import("../../connectors/zendesk.js");
+        const connector = getZendeskConnector();
+        const result = await connector.listTickets({
+            status: params.status,
+            assigneeId: typeof params.assigneeId === "number" ? params.assigneeId : undefined,
+            query: params.query,
+            perPage: typeof params.perPage === "number" ? params.perPage : 25,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// zendesk.getTicket
+// ============================================================================
+registerTool({
+    id: "zendesk.getTicket",
+    namespace: "zendesk",
+    description: "Fetch a single Zendesk ticket by ID, including its comments.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            ticketId: { type: "number", description: "Zendesk ticket ID" },
+            includeComments: {
+                type: "boolean",
+                description: "Whether to fetch comments (default true)",
+                default: true,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["ticketId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ticket: { type: ["object", "null"] },
+            comments: { type: "array", items: { type: "object" } },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getZendeskConnector } = await import("../../connectors/zendesk.js");
+        const connector = getZendeskConnector();
+        const ticketId = params.ticketId;
+        const [ticket, comments] = await Promise.all([
+            connector.getTicket(ticketId),
+            params.includeComments !== false
+                ? connector.getTicketComments(ticketId)
+                : Promise.resolve([]),
+        ]);
+        return JSON.stringify({ ticket, comments });
+    },
+});
+// ============================================================================
+// zendesk.addComment
+// ============================================================================
+registerTool({
+    id: "zendesk.addComment",
+    namespace: "zendesk",
+    description: "Add a public or private comment to a Zendesk ticket.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            ticketId: { type: "number", description: "Zendesk ticket ID" },
+            body: { type: "string", description: "Comment text (plain text)" },
+            public: {
+                type: "boolean",
+                description: "Whether the comment is public (visible to requester). Default true.",
+                default: true,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["ticketId", "body"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            status: { type: "string" },
+            updated_at: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        assertWriteAllowed("zendesk.addComment");
+        const { getZendeskConnector } = await import("../../connectors/zendesk.js");
+        const connector = getZendeskConnector();
+        const ticket = await connector.addComment(params.ticketId, params.body, params.public !== false);
+        return JSON.stringify({
+            id: ticket.id,
+            status: ticket.status,
+            updated_at: ticket.updated_at,
+        });
+    },
+});
+// ============================================================================
+// zendesk.updateStatus
+// ============================================================================
+registerTool({
+    id: "zendesk.updateStatus",
+    namespace: "zendesk",
+    description: "Update the status of a Zendesk ticket.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            ticketId: { type: "number", description: "Zendesk ticket ID" },
+            status: {
+                type: "string",
+                enum: ["new", "open", "pending", "hold", "solved", "closed"],
+                description: "New ticket status",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["ticketId", "status"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            status: { type: "string" },
+            updated_at: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        assertWriteAllowed("zendesk.updateStatus");
+        const { getZendeskConnector } = await import("../../connectors/zendesk.js");
+        const connector = getZendeskConnector();
+        const ticket = await connector.updateStatus(params.ticketId, params.status);
+        return JSON.stringify({
+            id: ticket.id,
+            status: ticket.status,
+            updated_at: ticket.updated_at,
+        });
+    },
+});
+// ============================================================================
+// zendesk.listUsers
+// ============================================================================
+registerTool({
+    id: "zendesk.listUsers",
+    namespace: "zendesk",
+    description: "List Zendesk users, optionally filtered by role (end-user, agent, admin).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            role: {
+                type: "string",
+                enum: ["end-user", "agent", "admin"],
+                description: "Filter by user role",
+            },
+            perPage: {
+                type: "number",
+                description: "Results per page (default 50)",
+                default: 50,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            users: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "number" },
+                        name: { type: "string" },
+                        email: { type: "string" },
+                        role: { type: "string" },
+                    },
+                },
+            },
+            count: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getZendeskConnector } = await import("../../connectors/zendesk.js");
+        const connector = getZendeskConnector();
+        const users = await connector.listUsers(params.role, typeof params.perPage === "number" ? params.perPage : 50);
+        return JSON.stringify({ users, count: users.length });
+    },
+});
+//# sourceMappingURL=zendesk.js.map

package/dist/recipes/tools/zendesk.js.map

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

package/dist/recipes/validation.d.ts

@@ -0,0 +1,13 @@
+export interface LintIssue {
+    level: "error" | "warning";
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface LintResult {
+    valid: boolean;
+    issues: LintIssue[];
+    warnings: number;
+    errors: number;
+}
+export declare function validateRecipeDefinition(recipe: unknown): LintResult;