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

package/dist/recipes/tools/caldiy.js

@@ -0,0 +1,214 @@
+/**
+ * Cal.diy tools — scheduling via the Cal.com-compatible API.
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools wrap
+ * event types and bookings; the single write tool cancels a booking.
+ *
+ * Wraps the Cal.diy connector (src/connectors/caldiy.ts):
+ *   - getEventTypes()                       → list_event_types (read)
+ *   - getBookings({status, attendeeEmail,…}) → list_bookings    (read)
+ *   - getBooking(uid)                        → get_booking      (read)
+ *   - cancelBooking(uid, reason?)            → cancel_booking   (write)
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// caldiy.list_event_types
+// ============================================================================
+registerTool({
+    id: "caldiy.list_event_types",
+    namespace: "caldiy",
+    description: "List the authenticated Cal.diy user's event types (bookable meeting templates).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                slug: { type: "string" },
+                title: { type: "string" },
+                description: { type: "string" },
+                length: { type: "number" },
+                hidden: { type: "boolean" },
+                locations: { type: "array" },
+                bookingFields: { type: "array" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async () => {
+        const { getCalDiyConnector } = await import("../../connectors/caldiy.js");
+        const connector = getCalDiyConnector();
+        const result = await connector.getEventTypes();
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// caldiy.list_bookings
+// ============================================================================
+registerTool({
+    id: "caldiy.list_bookings",
+    namespace: "caldiy",
+    description: "List Cal.diy bookings, optionally filtered by status, attendee email, or date range.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                description: "Filter by booking status (e.g. upcoming, past, cancelled, accepted)",
+            },
+            attendeeEmail: {
+                type: "string",
+                description: "Filter by attendee email address",
+            },
+            dateFrom: {
+                type: "string",
+                description: "Start of date range (ISO 8601)",
+            },
+            dateTo: {
+                type: "string",
+                description: "End of date range (ISO 8601)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                uid: { type: "string" },
+                title: { type: "string" },
+                description: { type: "string" },
+                start: { type: "string" },
+                end: { type: "string" },
+                status: { type: "string" },
+                attendees: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            email: { type: "string" },
+                            timeZone: { type: "string" },
+                        },
+                    },
+                },
+                eventType: { type: "object" },
+                cancelledBy: { type: "string" },
+                rescheduledBy: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getCalDiyConnector } = await import("../../connectors/caldiy.js");
+        const connector = getCalDiyConnector();
+        const result = await connector.getBookings({
+            status: typeof params.status === "string" ? params.status : undefined,
+            attendeeEmail: typeof params.attendeeEmail === "string"
+                ? params.attendeeEmail
+                : undefined,
+            dateFrom: typeof params.dateFrom === "string" ? params.dateFrom : undefined,
+            dateTo: typeof params.dateTo === "string" ? params.dateTo : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// caldiy.get_booking
+// ============================================================================
+registerTool({
+    id: "caldiy.get_booking",
+    namespace: "caldiy",
+    description: "Fetch a single Cal.diy booking by its UID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            uid: { type: "string", description: "Cal.diy booking UID" },
+            into: CommonSchemas.into,
+        },
+        required: ["uid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            uid: { type: "string" },
+            title: { type: "string" },
+            description: { type: "string" },
+            start: { type: "string" },
+            end: { type: "string" },
+            status: { type: "string" },
+            attendees: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        email: { type: "string" },
+                        timeZone: { type: "string" },
+                    },
+                },
+            },
+            eventType: { type: "object" },
+            cancelledBy: { type: "string" },
+            rescheduledBy: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getCalDiyConnector } = await import("../../connectors/caldiy.js");
+        const connector = getCalDiyConnector();
+        const result = await connector.getBooking(params.uid);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// caldiy.cancel_booking  (write-gated)
+// ============================================================================
+registerTool({
+    id: "caldiy.cancel_booking",
+    namespace: "caldiy",
+    description: "Cancel a Cal.diy booking by UID, with an optional reason.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            uid: { type: "string", description: "Cal.diy booking UID (required)" },
+            reason: {
+                type: "string",
+                description: "Optional cancellation reason shown to attendees",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["uid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            uid: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getCalDiyConnector } = await import("../../connectors/caldiy.js");
+        const connector = getCalDiyConnector();
+        const result = await connector.cancelBooking(params.uid, typeof params.reason === "string" ? params.reason : undefined);
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=caldiy.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * CircleCI recipe-step tools — read wrappers (list_pipelines, get_workflow,
+ * get_job) plus a write (trigger_pipeline).
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * CircleCI v2 connector methods 1:1 and JSON-stringifies the raw connector
+ * return type back out. Read tools declare `isWrite: false`; trigger_pipeline
+ * declares `isWrite: true` so the approval queue gates it appropriately.
+ */
+export {};

package/dist/recipes/tools/circleci.js

@@ -0,0 +1,204 @@
+/**
+ * CircleCI recipe-step tools — read wrappers (list_pipelines, get_workflow,
+ * get_job) plus a write (trigger_pipeline).
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the
+ * CircleCI v2 connector methods 1:1 and JSON-stringifies the raw connector
+ * return type back out. Read tools declare `isWrite: false`; trigger_pipeline
+ * declares `isWrite: true` so the approval queue gates it appropriately.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+import { wrapConnectorExecute } from "./wrapConnectorExecute.js";
+// ============================================================================
+// circleci.list_pipelines
+// ============================================================================
+registerTool({
+    id: "circleci.list_pipelines",
+    namespace: "circleci",
+    description: "List recent CircleCI pipelines for a project, optionally filtered by branch.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            projectSlug: {
+                type: "string",
+                description: "CircleCI project slug, e.g. gh/owner/repo (github/ and bitbucket/ prefixes accepted)",
+            },
+            branch: {
+                type: "string",
+                description: "Filter pipelines by VCS branch name",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["projectSlug"],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                project_slug: { type: "string" },
+                state: { type: "string" },
+                number: { type: "number" },
+                trigger: { type: "object" },
+                vcs: { type: "object" },
+                created_at: { type: "string" },
+                updated_at: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCircleCIConnector } = await import("../../connectors/circleci.js");
+        const connector = getCircleCIConnector();
+        const result = await connector.getPipelines(params.projectSlug, typeof params.branch === "string" ? params.branch : undefined);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// circleci.trigger_pipeline  (write-gated)
+// ============================================================================
+registerTool({
+    id: "circleci.trigger_pipeline",
+    namespace: "circleci",
+    description: "Trigger a new CircleCI pipeline for a project, optionally on a branch or tag with custom pipeline parameters.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            projectSlug: {
+                type: "string",
+                description: "CircleCI project slug, e.g. gh/owner/repo (github/ and bitbucket/ prefixes accepted)",
+            },
+            branch: {
+                type: "string",
+                description: "VCS branch to run the pipeline against",
+            },
+            tag: {
+                type: "string",
+                description: "VCS tag to run the pipeline against (mutually exclusive with branch)",
+            },
+            parameters: {
+                type: "object",
+                description: "Pipeline parameters map (string/boolean/number values) passed to the pipeline",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["projectSlug"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            state: { type: "string" },
+            number: { type: "number" },
+            created_at: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCircleCIConnector } = await import("../../connectors/circleci.js");
+        const connector = getCircleCIConnector();
+        const result = await connector.triggerPipeline(params.projectSlug, {
+            branch: typeof params.branch === "string" ? params.branch : undefined,
+            tag: typeof params.tag === "string" ? params.tag : undefined,
+            parameters: params.parameters && typeof params.parameters === "object"
+                ? params.parameters
+                : undefined,
+        });
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// circleci.get_workflow
+// ============================================================================
+registerTool({
+    id: "circleci.get_workflow",
+    namespace: "circleci",
+    description: "Fetch a single CircleCI workflow by its workflow ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "CircleCI workflow ID (UUID)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["id"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            name: { type: "string" },
+            status: { type: "string" },
+            pipeline_id: { type: "string" },
+            pipeline_number: { type: "number" },
+            project_slug: { type: "string" },
+            started_by: { type: "string" },
+            created_at: { type: "string" },
+            stopped_at: { type: ["string", "null"] },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCircleCIConnector } = await import("../../connectors/circleci.js");
+        const connector = getCircleCIConnector();
+        const result = await connector.getWorkflow(params.id);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// circleci.get_job
+// ============================================================================
+registerTool({
+    id: "circleci.get_job",
+    namespace: "circleci",
+    description: "Fetch a single CircleCI job by project slug and job number.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            projectSlug: {
+                type: "string",
+                description: "CircleCI project slug, e.g. gh/owner/repo (github/ and bitbucket/ prefixes accepted)",
+            },
+            jobNumber: {
+                type: "number",
+                description: "The job number within the project",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["projectSlug", "jobNumber"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            name: { type: "string" },
+            status: { type: "string" },
+            job_number: { type: "number" },
+            type: { type: "string" },
+            created_at: { type: "string" },
+            started_at: { type: ["string", "null"] },
+            stopped_at: { type: ["string", "null"] },
+            approval_request_id: { type: "string" },
+            dependencies: { type: "array", items: { type: "string" } },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCircleCIConnector } = await import("../../connectors/circleci.js");
+        const connector = getCircleCIConnector();
+        const result = await connector.getJob(params.projectSlug, params.jobNumber);
+        return JSON.stringify(result);
+    }),
+});
+//# sourceMappingURL=circleci.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circleci.js","sourceRoot":"","sources":["../../../src/recipes/tools/circleci.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,yBAAyB;IAC7B,SAAS,EAAE,UAAU;IACrB,WAAW,EACT,8EAA8E;IAChF,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sFAAsF;aACzF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC/B;SACF;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,8BAA8B,CAC/B,CAAC;QACF,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CACzC,MAAM,CAAC,WAAqB,EAC5B,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC;CACH,CAAC,CAAC;AAEH,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,2BAA2B;IAC/B,SAAS,EAAE,UAAU;IACrB,WAAW,EACT,+GAA+G;IACjH,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sFAAsF;aACzF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;aACzE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+EAA+E;aAClF;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC/B;KACF;IACD,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,8BAA8B,CAC/B,CAAC;QACF,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAC5C,MAAM,CAAC,WAAqB,EAC5B;YACE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACrE,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAC5D,UAAU,EACR,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBACxD,CAAC,CAAE,MAAM,CAAC,UAAwD;gBAClE,CAAC,CAAC,SAAS;SAChB,CACF,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC;CACH,CAAC,CAAC;AAEH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,uBAAuB;IAC3B,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,sDAAsD;IACnE,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;SACzC;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,8BAA8B,CAC/B,CAAC;QACF,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,EAAY,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC;CACH,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,kBAAkB;IACtB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,6DAA6D;IAC1E,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sFAAsF;aACzF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;KACvC;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YACxC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YACxC,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SAC3D;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,8BAA8B,CAC/B,CAAC;QACF,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CACnC,MAAM,CAAC,WAAqB,EAC5B,MAAM,CAAC,SAAmB,CAC3B,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Cloudflare tools — read wrappers (list_zones, list_dns_records,
+ * get_zone_analytics) plus a single write (create_dns_record).
+ *
+ * Self-registering tool module for the recipe tool registry. Each tool mirrors
+ * the real connector signature in `src/connectors/cloudflare.ts` and returns
+ * `JSON.stringify(result)` of the connector's native return type.
+ *
+ * Deliberately excludes destructive operations: no delete_dns_record,
+ * update_dns_record, or purge_cache. Only create_dns_record is write-gated
+ * (`isWrite: true`); the rest declare `isWrite: false`.
+ */
+export {};

package/dist/recipes/tools/cloudflare.js

@@ -0,0 +1,211 @@
+/**
+ * Cloudflare tools — read wrappers (list_zones, list_dns_records,
+ * get_zone_analytics) plus a single write (create_dns_record).
+ *
+ * Self-registering tool module for the recipe tool registry. Each tool mirrors
+ * the real connector signature in `src/connectors/cloudflare.ts` and returns
+ * `JSON.stringify(result)` of the connector's native return type.
+ *
+ * Deliberately excludes destructive operations: no delete_dns_record,
+ * update_dns_record, or purge_cache. Only create_dns_record is write-gated
+ * (`isWrite: true`); the rest declare `isWrite: false`.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+import { wrapConnectorExecute } from "./wrapConnectorExecute.js";
+// ============================================================================
+// cloudflare.list_zones
+// ============================================================================
+registerTool({
+    id: "cloudflare.list_zones",
+    namespace: "cloudflare",
+    description: "List Cloudflare zones, optionally filtered by exact zone name (domain).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Filter by exact zone name (e.g. example.com)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                status: { type: "string" },
+                nameservers: { type: "array", items: { type: "string" } },
+                plan: { type: "object", properties: { name: { type: "string" } } },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCloudflareConnector } = await import("../../connectors/cloudflare.js");
+        const connector = getCloudflareConnector();
+        const result = await connector.listZones(typeof params.name === "string" ? params.name : undefined);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// cloudflare.list_dns_records
+// ============================================================================
+registerTool({
+    id: "cloudflare.list_dns_records",
+    namespace: "cloudflare",
+    description: "List DNS records in a Cloudflare zone, optionally filtered by record type and name.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            zoneId: {
+                type: "string",
+                description: "Cloudflare zone ID",
+            },
+            type: {
+                type: "string",
+                description: "Filter by DNS record type (e.g. A, AAAA, CNAME, TXT, MX)",
+            },
+            name: {
+                type: "string",
+                description: "Filter by record name (e.g. www.example.com)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["zoneId"],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                type: { type: "string" },
+                name: { type: "string" },
+                content: { type: "string" },
+                ttl: { type: "number" },
+                proxied: { type: "boolean" },
+                proxiable: { type: "boolean" },
+                created_on: { type: "string" },
+                modified_on: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCloudflareConnector } = await import("../../connectors/cloudflare.js");
+        const connector = getCloudflareConnector();
+        const result = await connector.listDnsRecords(params.zoneId, typeof params.type === "string" ? params.type : undefined, typeof params.name === "string" ? params.name : undefined);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// cloudflare.create_dns_record  (write-gated)
+// ============================================================================
+registerTool({
+    id: "cloudflare.create_dns_record",
+    namespace: "cloudflare",
+    description: "Create a DNS record in a Cloudflare zone. Requires zoneId, type, name, and content.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            zoneId: {
+                type: "string",
+                description: "Cloudflare zone ID",
+            },
+            type: {
+                type: "string",
+                description: "DNS record type (e.g. A, AAAA, CNAME, TXT, MX)",
+            },
+            name: {
+                type: "string",
+                description: "Record name (e.g. www.example.com)",
+            },
+            content: {
+                type: "string",
+                description: "Record content (e.g. 192.0.2.1 for an A record)",
+            },
+            ttl: {
+                type: "number",
+                description: "Time-to-live in seconds (1 = automatic)",
+            },
+            proxied: {
+                type: "boolean",
+                description: "Whether the record is proxied through Cloudflare",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["zoneId", "type", "name", "content"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            type: { type: "string" },
+            name: { type: "string" },
+            content: { type: "string" },
+            ttl: { type: "number" },
+            proxied: { type: "boolean" },
+            proxiable: { type: "boolean" },
+            created_on: { type: "string" },
+            modified_on: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCloudflareConnector } = await import("../../connectors/cloudflare.js");
+        const connector = getCloudflareConnector();
+        const result = await connector.createDnsRecord(params.zoneId, params.type, params.name, params.content, typeof params.ttl === "number" ? params.ttl : undefined, typeof params.proxied === "boolean" ? params.proxied : undefined);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// cloudflare.get_zone_analytics
+// ============================================================================
+registerTool({
+    id: "cloudflare.get_zone_analytics",
+    namespace: "cloudflare",
+    description: "Fetch dashboard analytics for a Cloudflare zone over an optional time window.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            zoneId: {
+                type: "string",
+                description: "Cloudflare zone ID",
+            },
+            since: {
+                type: "string",
+                description: "Start of the window (RFC3339 timestamp or relative, e.g. -10080 minutes)",
+            },
+            until: {
+                type: "string",
+                description: "End of the window (RFC3339 timestamp or relative)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["zoneId"],
+    },
+    outputSchema: {
+        type: "object",
+        description: "Cloudflare zone analytics dashboard payload (free-form).",
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getCloudflareConnector } = await import("../../connectors/cloudflare.js");
+        const connector = getCloudflareConnector();
+        const result = await connector.getZoneAnalytics(params.zoneId, typeof params.since === "string" ? params.since : undefined, typeof params.until === "string" ? params.until : undefined);
+        return JSON.stringify(result);
+    }),
+});
+//# sourceMappingURL=cloudflare.js.map