patchwork-os 0.2.0-beta.10.canary.99 → 0.2.0-beta.11

package/dist/recipes/tools/salesforce.js

@@ -0,0 +1,184 @@
+/**
+ * Salesforce recipe-step tools — read wrappers (query, search, get_object)
+ * plus a write-gated create_record.
+ *
+ * Self-registering tool module for the recipe tool registry. Unlike the
+ * class-plus-accessor connectors, src/connectors/salesforce.ts exports a set
+ * of standalone async functions (module-function pattern) — there is no
+ * getSalesforceConnector(). Each tool dynamically imports the function it wraps
+ * and JSON-stringifies the raw connector return value back out.
+ *
+ * Read tools (`query`, `searchSosl`, `getObject`) declare `isWrite: false`;
+ * `create_record` declares `isWrite: true` so the approval queue gates the
+ * mutation. The connector itself enforces SELECT-only SOQL and FIND-only SOSL,
+ * and validates sObject / record-id shapes before issuing the call.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+import { wrapConnectorExecute } from "./wrapConnectorExecute.js";
+// ============================================================================
+// salesforce.query  (SOQL — read)
+// ============================================================================
+registerTool({
+    id: "salesforce.query",
+    namespace: "salesforce",
+    description: "Execute a SOQL SELECT query against Salesforce. The statement must start " +
+        "with SELECT (enforced by the connector). An optional limit caps the page " +
+        "size (default 200, hard cap 200).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            soql: {
+                type: "string",
+                description: "SOQL SELECT query (must start with SELECT)",
+            },
+            limit: {
+                type: "number",
+                description: "Optional page-size cap (default 200, hard cap 200)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["soql"],
+    },
+    // SoqlQueryResult — see src/connectors/salesforce.ts.
+    outputSchema: {
+        type: "object",
+        properties: {
+            totalSize: { type: "number" },
+            done: { type: "boolean" },
+            records: {
+                type: "array",
+                items: { type: "object" },
+            },
+            nextRecordsUrl: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { query } = await import("../../connectors/salesforce.js");
+        const result = await query(params.soql, typeof params.limit === "number" ? { limit: params.limit } : undefined);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// salesforce.search  (SOSL — read)
+// ============================================================================
+registerTool({
+    id: "salesforce.search",
+    namespace: "salesforce",
+    description: "Execute a SOSL search against Salesforce. The statement must start with " +
+        "FIND (enforced by the connector).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            sosl: {
+                type: "string",
+                description: "SOSL search expression (must start with FIND)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["sosl"],
+    },
+    // SoslSearchResult — see src/connectors/salesforce.ts.
+    outputSchema: {
+        type: "object",
+        properties: {
+            searchRecords: {
+                type: "array",
+                items: { type: "object" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { searchSosl } = await import("../../connectors/salesforce.js");
+        const result = await searchSosl(params.sosl);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// salesforce.get_object  (read)
+// ============================================================================
+registerTool({
+    id: "salesforce.get_object",
+    namespace: "salesforce",
+    description: "Fetch a single Salesforce sObject record by its API name and record id " +
+        "(e.g. object_name: 'Account', record_id: '001...').",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            object_name: {
+                type: "string",
+                description: "sObject API name (e.g. 'Account', 'Contact')",
+            },
+            record_id: {
+                type: "string",
+                description: "Salesforce record id (15 or 18 chars)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["object_name", "record_id"],
+    },
+    // getObject resolves to the raw sObject record (Record<string, unknown>).
+    outputSchema: {
+        type: "object",
+        additionalProperties: true,
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getObject } = await import("../../connectors/salesforce.js");
+        const result = await getObject(params.object_name, params.record_id);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// salesforce.create_record  (write-gated)
+// ============================================================================
+registerTool({
+    id: "salesforce.create_record",
+    namespace: "salesforce",
+    description: "Create a new Salesforce sObject record. Supply the sObject API name and a " +
+        "fields object mapping field API names to values.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            object_name: {
+                type: "string",
+                description: "sObject API name (e.g. 'Account', 'Contact', 'Lead')",
+            },
+            fields: {
+                type: "object",
+                description: "Field API names mapped to values (e.g. { Name: 'Acme', Industry: 'Tech' })",
+                additionalProperties: true,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["object_name", "fields"],
+    },
+    // CreateRecordResult — see src/connectors/salesforce.ts.
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            success: { type: "boolean" },
+            errors: { type: "array", items: {} },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { createRecord } = await import("../../connectors/salesforce.js");
+        const fields = params.fields && typeof params.fields === "object"
+            ? params.fields
+            : {};
+        const result = await createRecord(params.object_name, fields);
+        return JSON.stringify(result);
+    }),
+});
+//# sourceMappingURL=salesforce.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * SendGrid tools — transactional email send (write) plus read wrappers for
+ * dynamic/legacy templates and email stats.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * SendGridConnector (src/connectors/sendgrid.ts) methods `send`,
+ * `listTemplates`, and `getStats`.
+ */
+export {};

package/dist/recipes/tools/sendgrid.js

@@ -0,0 +1,174 @@
+/**
+ * SendGrid tools — transactional email send (write) plus read wrappers for
+ * dynamic/legacy templates and email stats.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * SendGridConnector (src/connectors/sendgrid.ts) methods `send`,
+ * `listTemplates`, and `getStats`.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// sendgrid.send_email  (write-gated)
+// ============================================================================
+registerTool({
+    id: "sendgrid.send_email",
+    namespace: "sendgrid",
+    description: "Send a transactional email via SendGrid. Requires `to`, `subject`, and at " +
+        "least one of `text`/`html`. `from` defaults to the connected verified sender.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            to: {
+                type: "string",
+                description: "Recipient email address (required)",
+            },
+            subject: {
+                type: "string",
+                description: "Email subject line (required, non-empty)",
+            },
+            text: {
+                type: "string",
+                description: "Plain-text body (one of text/html is required)",
+            },
+            html: {
+                type: "string",
+                description: "HTML body (one of text/html is required)",
+            },
+            from: {
+                type: "string",
+                description: "Sender email address. Defaults to the connected verified sender (fromEmail).",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["to", "subject"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            messageId: { type: "string" },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getSendGridConnector } = await import("../../connectors/sendgrid.js");
+        try {
+            const connector = getSendGridConnector();
+            const result = await connector.send({
+                to: params.to,
+                subject: params.subject,
+                text: typeof params.text === "string" ? params.text : undefined,
+                html: typeof params.html === "string" ? params.html : undefined,
+                from: typeof params.from === "string" ? params.from : undefined,
+            });
+            return JSON.stringify({ ok: true, messageId: result.messageId });
+        }
+        catch (err) {
+            return JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// sendgrid.list_templates
+// ============================================================================
+registerTool({
+    id: "sendgrid.list_templates",
+    namespace: "sendgrid",
+    description: "List SendGrid email templates, optionally filtered by generation " +
+        "(legacy or dynamic).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of templates to return (page_size)",
+            },
+            generations: {
+                type: "string",
+                enum: ["legacy", "dynamic"],
+                description: "Filter by template generation",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            result: { type: "array", items: { type: "object" } },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getSendGridConnector } = await import("../../connectors/sendgrid.js");
+        const connector = getSendGridConnector();
+        const result = await connector.listTemplates({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            generations: params.generations === "legacy" || params.generations === "dynamic"
+                ? params.generations
+                : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// sendgrid.get_stats
+// ============================================================================
+registerTool({
+    id: "sendgrid.get_stats",
+    namespace: "sendgrid",
+    description: "Fetch SendGrid email statistics for a date range, optionally aggregated " +
+        "by day/week/month.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            startDate: {
+                type: "string",
+                description: "Start date YYYY-MM-DD (required)",
+            },
+            endDate: {
+                type: "string",
+                description: "End date YYYY-MM-DD (optional, defaults to today)",
+            },
+            aggregatedBy: {
+                type: "string",
+                enum: ["day", "week", "month"],
+                description: "Aggregation bucket size",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["startDate"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getSendGridConnector } = await import("../../connectors/sendgrid.js");
+        const connector = getSendGridConnector();
+        const data = await connector.getStats({
+            startDate: params.startDate,
+            endDate: typeof params.endDate === "string" ? params.endDate : undefined,
+            aggregatedBy: params.aggregatedBy === "day" ||
+                params.aggregatedBy === "week" ||
+                params.aggregatedBy === "month"
+                ? params.aggregatedBy
+                : undefined,
+        });
+        return JSON.stringify({ data });
+    },
+});
+//# sourceMappingURL=sendgrid.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Shopify tools — read-only access to products, orders, and customers.
+ *
+ * Self-registering tool module for the recipe tool registry. Each tool lazily
+ * imports the Shopify connector and wraps a single read method, returning the
+ * connector result verbatim via JSON.stringify.
+ *
+ * Connector methods mirrored (see src/connectors/shopify.ts):
+ *   - listProducts({ limit?, status?, vendor?, productType? }) -> { data: ShopifyProduct[] }
+ *   - listOrders({ limit?, status?, financialStatus?, fulfillmentStatus? }) -> { data: ShopifyOrder[] }
+ *   - getOrder(orderId: string | number) -> ShopifyOrder
+ *   - listCustomers({ limit?, query? }) -> { data: ShopifyCustomer[] }
+ *
+ * All v1 tools are read-only (`isWrite: false`, `riskDefault: "low"`).
+ */
+export {};

package/dist/recipes/tools/shopify.js

@@ -0,0 +1,265 @@
+/**
+ * Shopify tools — read-only access to products, orders, and customers.
+ *
+ * Self-registering tool module for the recipe tool registry. Each tool lazily
+ * imports the Shopify connector and wraps a single read method, returning the
+ * connector result verbatim via JSON.stringify.
+ *
+ * Connector methods mirrored (see src/connectors/shopify.ts):
+ *   - listProducts({ limit?, status?, vendor?, productType? }) -> { data: ShopifyProduct[] }
+ *   - listOrders({ limit?, status?, financialStatus?, fulfillmentStatus? }) -> { data: ShopifyOrder[] }
+ *   - getOrder(orderId: string | number) -> ShopifyOrder
+ *   - listCustomers({ limit?, query? }) -> { data: ShopifyCustomer[] }
+ *
+ * All v1 tools are read-only (`isWrite: false`, `riskDefault: "low"`).
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// shopify.list_products
+// ============================================================================
+registerTool({
+    id: "shopify.list_products",
+    namespace: "shopify",
+    description: "List Shopify products, optionally filtered by status, vendor, or product type.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of products to return (default 50, max 250)",
+                default: 50,
+            },
+            status: {
+                type: "string",
+                description: "Filter by product status (active, archived, draft)",
+            },
+            vendor: {
+                type: "string",
+                description: "Filter by vendor name",
+            },
+            productType: {
+                type: "string",
+                description: "Filter by product type",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "number" },
+                        title: { type: "string" },
+                        body_html: { type: ["string", "null"] },
+                        vendor: { type: "string" },
+                        product_type: { type: "string" },
+                        status: { type: "string" },
+                        created_at: { type: "string" },
+                        updated_at: { type: "string" },
+                        tags: { type: "string" },
+                        variants: { type: "array", items: { type: "object" } },
+                    },
+                },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getShopifyConnector } = await import("../../connectors/shopify.js");
+        const connector = getShopifyConnector();
+        const result = await connector.listProducts({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            status: typeof params.status === "string" ? params.status : undefined,
+            vendor: typeof params.vendor === "string" ? params.vendor : undefined,
+            productType: typeof params.productType === "string" ? params.productType : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// shopify.list_orders
+// ============================================================================
+registerTool({
+    id: "shopify.list_orders",
+    namespace: "shopify",
+    description: "List Shopify orders, optionally filtered by status, financial status, or fulfillment status.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of orders to return (default 50, max 250)",
+                default: 50,
+            },
+            status: {
+                type: "string",
+                description: "Filter by order status (open, closed, cancelled, any; default any)",
+            },
+            financialStatus: {
+                type: "string",
+                description: "Filter by financial status (e.g. paid, pending, refunded, voided)",
+            },
+            fulfillmentStatus: {
+                type: "string",
+                description: "Filter by fulfillment status (e.g. shipped, partial, unshipped, any)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "number" },
+                        order_number: { type: "number" },
+                        name: { type: "string" },
+                        email: { type: ["string", "null"] },
+                        financial_status: { type: ["string", "null"] },
+                        fulfillment_status: { type: ["string", "null"] },
+                        total_price: { type: "string" },
+                        subtotal_price: { type: "string" },
+                        currency: { type: "string" },
+                        created_at: { type: "string" },
+                        updated_at: { type: "string" },
+                        customer: { type: ["object", "null"] },
+                    },
+                },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getShopifyConnector } = await import("../../connectors/shopify.js");
+        const connector = getShopifyConnector();
+        const result = await connector.listOrders({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            status: typeof params.status === "string" ? params.status : undefined,
+            financialStatus: typeof params.financialStatus === "string"
+                ? params.financialStatus
+                : undefined,
+            fulfillmentStatus: typeof params.fulfillmentStatus === "string"
+                ? params.fulfillmentStatus
+                : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// shopify.get_order
+// ============================================================================
+registerTool({
+    id: "shopify.get_order",
+    namespace: "shopify",
+    description: "Fetch a single Shopify order by ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            orderId: {
+                type: ["string", "number"],
+                description: "Shopify order ID",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["orderId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            order_number: { type: "number" },
+            name: { type: "string" },
+            email: { type: ["string", "null"] },
+            financial_status: { type: ["string", "null"] },
+            fulfillment_status: { type: ["string", "null"] },
+            total_price: { type: "string" },
+            subtotal_price: { type: "string" },
+            currency: { type: "string" },
+            created_at: { type: "string" },
+            updated_at: { type: "string" },
+            customer: { type: ["object", "null"] },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getShopifyConnector } = await import("../../connectors/shopify.js");
+        const connector = getShopifyConnector();
+        const result = await connector.getOrder(params.orderId);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// shopify.list_customers
+// ============================================================================
+registerTool({
+    id: "shopify.list_customers",
+    namespace: "shopify",
+    description: "List Shopify customers, optionally filtered by a search query string.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of customers to return (default 50, max 250)",
+                default: 50,
+            },
+            query: {
+                type: "string",
+                description: "Search query (uses the Shopify customer search endpoint, e.g. email or name)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "number" },
+                        email: { type: ["string", "null"] },
+                        first_name: { type: ["string", "null"] },
+                        last_name: { type: ["string", "null"] },
+                        phone: { type: ["string", "null"] },
+                        orders_count: { type: "number" },
+                        total_spent: { type: "string" },
+                        state: { type: "string" },
+                        created_at: { type: "string" },
+                        updated_at: { type: "string" },
+                    },
+                },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getShopifyConnector } = await import("../../connectors/shopify.js");
+        const connector = getShopifyConnector();
+        const result = await connector.listCustomers({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            query: typeof params.query === "string" ? params.query : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=shopify.js.map