patchwork-os 0.2.0-beta.1 → 0.2.0-beta.10.canary.100

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/slack.js

@@ -76,7 +76,7 @@ const slackPostMessage = {
     },
 };
 registerTool(slackPostMessage);
-// camelCase alias — older recipes (registry/, examples/) reference
+// camelCase alias — older recipes (e.g. under examples/) reference
 // `slack.postMessage`. Aliased to the snake_case canonical impl.
 registerTool({ ...slackPostMessage, id: "slack.postMessage" });
 //# sourceMappingURL=slack.js.map

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

@@ -0,0 +1,11 @@
+/**
+ * Twilio tools — SMS send + message read access via the Twilio REST API.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * `TwilioConnector` methods (`sendSms`, `listMessages`, `getMessage`).
+ *
+ * `send_sms` is write-gated (isWrite: true) so the approval queue and the
+ * write kill-switch gate it. Read tools (`list_messages`, `get_message`) are
+ * isWrite: false.
+ */
+export {};

package/dist/recipes/tools/twilio.js

@@ -0,0 +1,179 @@
+/**
+ * Twilio tools — SMS send + message read access via the Twilio REST API.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * `TwilioConnector` methods (`sendSms`, `listMessages`, `getMessage`).
+ *
+ * `send_sms` is write-gated (isWrite: true) so the approval queue and the
+ * write kill-switch gate it. Read tools (`list_messages`, `get_message`) are
+ * isWrite: false.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// twilio.send_sms  (write-gated)
+// ============================================================================
+registerTool({
+    id: "twilio.send_sms",
+    namespace: "twilio",
+    description: "Send an SMS via Twilio. 'to' and 'body' are required; 'from' falls back to the connector's defaultFrom. Phone numbers must be E.164 (e.g. +14155551234).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            to: {
+                type: "string",
+                description: "Destination phone number in E.164 format (+14155551234)",
+            },
+            body: {
+                type: "string",
+                description: "SMS message body text",
+            },
+            from: {
+                type: "string",
+                description: "Optional sender phone number in E.164 format; defaults to the connector's configured defaultFrom",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["to", "body"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            sid: { type: "string" },
+            account_sid: { type: "string" },
+            to: { type: "string" },
+            from: { type: "string" },
+            body: { type: "string" },
+            status: { type: "string" },
+            direction: { type: "string" },
+            date_sent: { type: ["string", "null"] },
+            date_created: { type: "string" },
+            date_updated: { type: "string" },
+            price: { type: ["string", "null"] },
+            price_unit: { type: ["string", "null"] },
+            error_code: { type: ["number", "null"] },
+            error_message: { type: ["string", "null"] },
+            num_segments: { type: "string" },
+            num_media: { type: "string" },
+            uri: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getTwilioConnector } = await import("../../connectors/twilio.js");
+        const connector = getTwilioConnector();
+        const result = await connector.sendSms({
+            to: params.to,
+            body: params.body,
+            from: typeof params.from === "string" ? params.from : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// twilio.list_messages
+// ============================================================================
+registerTool({
+    id: "twilio.list_messages",
+    namespace: "twilio",
+    description: "List Twilio messages, optionally filtered by 'to', 'from', or 'dateSent' (YYYY-MM-DD).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            to: {
+                type: "string",
+                description: "Filter by destination phone number (E.164)",
+            },
+            from: {
+                type: "string",
+                description: "Filter by sender phone number (E.164)",
+            },
+            dateSent: {
+                type: "string",
+                description: "Filter by send date (YYYY-MM-DD)",
+            },
+            limit: {
+                type: "number",
+                description: "Max number of messages to return (default 20)",
+                default: 20,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            messages: { type: "array", items: { type: "object" } },
+            page: { type: "number" },
+            page_size: { type: "number" },
+            next_page_uri: { type: ["string", "null"] },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getTwilioConnector } = await import("../../connectors/twilio.js");
+        const connector = getTwilioConnector();
+        const result = await connector.listMessages({
+            to: typeof params.to === "string" ? params.to : undefined,
+            from: typeof params.from === "string" ? params.from : undefined,
+            dateSent: typeof params.dateSent === "string" ? params.dateSent : undefined,
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// twilio.get_message
+// ============================================================================
+registerTool({
+    id: "twilio.get_message",
+    namespace: "twilio",
+    description: "Fetch a single Twilio message by its message SID (SM...).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            messageSid: {
+                type: "string",
+                description: "Twilio message SID (SM...)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["messageSid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            sid: { type: "string" },
+            account_sid: { type: "string" },
+            to: { type: "string" },
+            from: { type: "string" },
+            body: { type: "string" },
+            status: { type: "string" },
+            direction: { type: "string" },
+            date_sent: { type: ["string", "null"] },
+            date_created: { type: "string" },
+            date_updated: { type: "string" },
+            price: { type: ["string", "null"] },
+            price_unit: { type: ["string", "null"] },
+            error_code: { type: ["number", "null"] },
+            error_message: { type: ["string", "null"] },
+            num_segments: { type: "string" },
+            num_media: { type: "string" },
+            uri: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getTwilioConnector } = await import("../../connectors/twilio.js");
+        const connector = getTwilioConnector();
+        const result = await connector.getMessage(params.messageSid);
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=twilio.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Vercel tools — read-only access to deployments and projects.
+ *
+ * Self-registering tool module for the recipe tool registry. Read-only set
+ * only (v1 safe): no createDeployment / cancelDeployment / env-var mutations.
+ * Each tool mirrors the real connector signature in `src/connectors/vercel.ts`
+ * and returns `JSON.stringify(result)` of the connector's native return type.
+ */
+export {};

package/dist/recipes/tools/vercel.js

@@ -0,0 +1,145 @@
+/**
+ * Vercel tools — read-only access to deployments and projects.
+ *
+ * Self-registering tool module for the recipe tool registry. Read-only set
+ * only (v1 safe): no createDeployment / cancelDeployment / env-var mutations.
+ * Each tool mirrors the real connector signature in `src/connectors/vercel.ts`
+ * and returns `JSON.stringify(result)` of the connector's native return type.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// vercel.list_deployments
+// ============================================================================
+registerTool({
+    id: "vercel.list_deployments",
+    namespace: "vercel",
+    description: "List Vercel deployments, optionally filtered by project ID and state.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            projectId: {
+                type: "string",
+                description: "Filter by Vercel project ID",
+            },
+            limit: {
+                type: "number",
+                description: "Max number of deployments to return",
+            },
+            state: {
+                type: "string",
+                description: "Filter by deployment state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                uid: { type: "string" },
+                name: { type: "string" },
+                url: { type: "string" },
+                state: { type: "string" },
+                createdAt: { type: "number" },
+                target: { type: ["string", "null"] },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getVercelConnector } = await import("../../connectors/vercel.js");
+        const connector = getVercelConnector();
+        const result = await connector.listDeployments({
+            projectId: typeof params.projectId === "string" ? params.projectId : undefined,
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+            state: typeof params.state === "string" ? params.state : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// vercel.get_deployment
+// ============================================================================
+registerTool({
+    id: "vercel.get_deployment",
+    namespace: "vercel",
+    description: "Fetch a single Vercel deployment by ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "Vercel deployment ID" },
+            into: CommonSchemas.into,
+        },
+        required: ["id"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            uid: { type: "string" },
+            name: { type: "string" },
+            url: { type: "string" },
+            state: { type: "string" },
+            createdAt: { type: "number" },
+            target: { type: ["string", "null"] },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getVercelConnector } = await import("../../connectors/vercel.js");
+        const connector = getVercelConnector();
+        const result = await connector.getDeployment(params.id);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// vercel.list_projects
+// ============================================================================
+registerTool({
+    id: "vercel.list_projects",
+    namespace: "vercel",
+    description: "List Vercel projects.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max number of projects to return",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                framework: { type: ["string", "null"] },
+                link: { type: "object" },
+                latestDeployments: { type: "array", items: { type: "object" } },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getVercelConnector } = await import("../../connectors/vercel.js");
+        const connector = getVercelConnector();
+        const result = await connector.listProjects({
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=vercel.js.map

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

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

package/dist/recipes/validation.d.ts

@@ -1,8 +1,25 @@
 export interface LintIssue {
     level: "error" | "warning";
     message: string;
+    /** 1-indexed line in the source YAML, when available (populated in a later phase). */
     line?: number;
+    /** 1-indexed column in the source YAML, when available. */
     column?: number;
+    /**
+     * Stable, machine-readable code for UI keying. Schema-validation issues
+     * use the AJV keyword (`required`, `type`, `enum`, ...); future hand-rolled
+     * checks can adopt their own short kebab-case codes. Optional — older
+     * issues without a code render the same way they always did.
+     */
+    code?: string;
+    /**
+     * Dot-separated path into the recipe object pointing at the offending
+     * field (e.g. `steps.0.tool` or `trigger.at`). For schema-validation
+     * issues this is the AJV `instancePath` with leading slash dropped and
+     * remaining slashes turned into dots; `recipe` if the issue is at root.
+     * Unset for issues whose location is implicit in the message.
+     */
+    path?: string;
 }
 export interface LintResult {
     valid: boolean;