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

package/dist/recipes/tools/pipedrive.js

@@ -0,0 +1,233 @@
+/**
+ * Pipedrive tools — read wrappers (deals, persons, pipelines) plus a write
+ * (create_deal) over the Pipedrive CRM REST API v1.
+ *
+ * Self-registering tool module for the recipe tool registry. Mirrors the
+ * connector method signatures faithfully (see src/connectors/pipedrive.ts):
+ *   - getDeals({ status?, start?, limit? }) → PipedriveDeal[]
+ *   - createDeal({ title, value?, currency?, stageId?, personId?, orgId?,
+ *                  status?, expectedCloseDate? }) → PipedriveDeal
+ *   - getPersons({ start?, limit? }) → PipedrivePerson[]
+ *   - getPipelines() → PipedrivePipeline[]
+ *
+ * Read tools declare `isWrite: false`; the write tool declares `isWrite: true`
+ * so the approval queue gates it appropriately.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// pipedrive.list_deals
+// ============================================================================
+registerTool({
+    id: "pipedrive.list_deals",
+    namespace: "pipedrive",
+    description: "List Pipedrive deals, optionally filtered by status with pagination.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                enum: ["open", "won", "lost", "deleted", "all_not_deleted"],
+                description: "Filter by deal status",
+            },
+            start: {
+                type: "number",
+                description: "Pagination offset (0-based index of first item)",
+            },
+            limit: {
+                type: "number",
+                description: "Max number of deals to return",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                title: { type: "string" },
+                value: { type: ["number", "null"] },
+                currency: { type: "string" },
+                status: { type: "string" },
+                stage_id: { type: ["number", "null"] },
+                expected_close_date: { type: ["string", "null"] },
+                add_time: { type: "string" },
+                update_time: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPipedriveConnector } = await import("../../connectors/pipedrive.js");
+        const connector = getPipedriveConnector();
+        const result = await connector.getDeals({
+            status: typeof params.status === "string"
+                ? params.status
+                : undefined,
+            start: typeof params.start === "number" ? params.start : undefined,
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// pipedrive.create_deal  (write-gated)
+// ============================================================================
+registerTool({
+    id: "pipedrive.create_deal",
+    namespace: "pipedrive",
+    description: "Create a new Pipedrive deal. Requires a title; all other fields optional.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            title: { type: "string", description: "Deal title (required)" },
+            value: { type: "number", description: "Deal monetary value" },
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. USD, EUR)",
+            },
+            stageId: { type: "number", description: "Pipeline stage id" },
+            personId: { type: "number", description: "Linked person id" },
+            orgId: { type: "number", description: "Linked organization id" },
+            status: {
+                type: "string",
+                enum: ["open", "won", "lost"],
+                description: "Initial deal status",
+            },
+            expectedCloseDate: {
+                type: "string",
+                description: "Expected close date (ISO YYYY-MM-DD)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["title"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            title: { type: "string" },
+            value: { type: ["number", "null"] },
+            currency: { type: "string" },
+            status: { type: "string" },
+            stage_id: { type: ["number", "null"] },
+            expected_close_date: { type: ["string", "null"] },
+            add_time: { type: "string" },
+            update_time: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPipedriveConnector } = await import("../../connectors/pipedrive.js");
+        const connector = getPipedriveConnector();
+        const result = await connector.createDeal({
+            title: params.title,
+            value: typeof params.value === "number" ? params.value : undefined,
+            currency: typeof params.currency === "string" ? params.currency : undefined,
+            stageId: typeof params.stageId === "number" ? params.stageId : undefined,
+            personId: typeof params.personId === "number" ? params.personId : undefined,
+            orgId: typeof params.orgId === "number" ? params.orgId : undefined,
+            status: typeof params.status === "string"
+                ? params.status
+                : undefined,
+            expectedCloseDate: typeof params.expectedCloseDate === "string"
+                ? params.expectedCloseDate
+                : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// pipedrive.list_persons
+// ============================================================================
+registerTool({
+    id: "pipedrive.list_persons",
+    namespace: "pipedrive",
+    description: "List Pipedrive persons (contacts) with pagination.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            start: {
+                type: "number",
+                description: "Pagination offset (0-based index of first item)",
+            },
+            limit: {
+                type: "number",
+                description: "Max number of persons to return",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                name: { type: "string" },
+                email: { type: "array", items: { type: "object" } },
+                phone: { type: "array", items: { type: "object" } },
+                org_id: { type: ["object", "null"] },
+                add_time: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPipedriveConnector } = await import("../../connectors/pipedrive.js");
+        const connector = getPipedriveConnector();
+        const result = await connector.getPersons({
+            start: typeof params.start === "number" ? params.start : undefined,
+            limit: typeof params.limit === "number" ? params.limit : undefined,
+        });
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// pipedrive.list_pipelines
+// ============================================================================
+registerTool({
+    id: "pipedrive.list_pipelines",
+    namespace: "pipedrive",
+    description: "List all Pipedrive pipelines.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                name: { type: "string" },
+                order_nr: { type: "number" },
+                active: { type: "boolean" },
+                add_time: { type: "string" },
+                update_time: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async () => {
+        const { getPipedriveConnector } = await import("../../connectors/pipedrive.js");
+        const connector = getPipedriveConnector();
+        const result = await connector.getPipelines();
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=pipedrive.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Postgres tools — read-only schema introspection plus an arbitrary-SQL query
+ * step.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the Postgres
+ * connector's `listTables` / `describeTable` schema reads, the `query` SQL
+ * runner, and the `explain` query-plan endpoint.
+ *
+ * The connector enforces a read-only-statement guard (SELECT / SHOW / EXPLAIN /
+ * WITH) at runtime, but `postgres.query` runs ARBITRARY SQL supplied by the
+ * recipe author, so it is declared `isWrite: true` so the approval queue gates
+ * it appropriately. The schema-introspection reads (`list_tables`,
+ * `describe_table`) and `explain` are non-mutating, so they are `isWrite: false`.
+ */
+export {};

package/dist/recipes/tools/postgres.js

@@ -0,0 +1,185 @@
+/**
+ * Postgres tools — read-only schema introspection plus an arbitrary-SQL query
+ * step.
+ *
+ * Self-registering tool module for the recipe tool registry. Wraps the Postgres
+ * connector's `listTables` / `describeTable` schema reads, the `query` SQL
+ * runner, and the `explain` query-plan endpoint.
+ *
+ * The connector enforces a read-only-statement guard (SELECT / SHOW / EXPLAIN /
+ * WITH) at runtime, but `postgres.query` runs ARBITRARY SQL supplied by the
+ * recipe author, so it is declared `isWrite: true` so the approval queue gates
+ * it appropriately. The schema-introspection reads (`list_tables`,
+ * `describe_table`) and `explain` are non-mutating, so they are `isWrite: false`.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// postgres.list_tables
+// ============================================================================
+registerTool({
+    id: "postgres.list_tables",
+    namespace: "postgres",
+    description: "List Postgres tables, optionally restricted to a single schema. Excludes the pg_catalog / information_schema system schemas.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            schema: {
+                type: "string",
+                description: "Optional schema name to restrict results to",
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                table_schema: { type: "string" },
+                table_name: { type: "string" },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPostgresConnector } = await import("../../connectors/postgres.js");
+        const connector = getPostgresConnector();
+        const result = await connector.listTables(typeof params.schema === "string" ? params.schema : undefined);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// postgres.describe_table
+// ============================================================================
+registerTool({
+    id: "postgres.describe_table",
+    namespace: "postgres",
+    description: "Describe the columns of a Postgres table (name, data type, nullability, default). Defaults to the public schema.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            table: {
+                type: "string",
+                description: "Table name to describe",
+            },
+            schema: {
+                type: "string",
+                description: "Schema the table lives in (default public)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["table"],
+    },
+    outputSchema: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                column_name: { type: "string" },
+                data_type: { type: "string" },
+                is_nullable: { type: "string" },
+                column_default: { type: ["string", "null"] },
+            },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPostgresConnector } = await import("../../connectors/postgres.js");
+        const connector = getPostgresConnector();
+        const result = await connector.describeTable(params.table, typeof params.schema === "string" ? params.schema : undefined);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// postgres.query  (write-gated)
+// ============================================================================
+registerTool({
+    id: "postgres.query",
+    namespace: "postgres",
+    description: "Run an ARBITRARY SQL statement against Postgres. The connector enforces a read-only guard (SELECT / SHOW / EXPLAIN / WITH) at runtime, but because the SQL is author-supplied this step is treated as a write and is gated by the approval queue. Supports positional bind parameters and a row-count cap.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            sql: {
+                type: "string",
+                description: "SQL statement to execute (read-only statements only)",
+            },
+            params: {
+                type: "array",
+                description: "Positional bind parameters for the statement ($1, $2, …)",
+                items: {},
+            },
+            rowLimit: {
+                type: "number",
+                description: "Maximum number of rows to return (default 100, max 10000)",
+                default: 100,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["sql"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            rows: { type: "array", items: { type: "object" } },
+            rowCount: { type: "number" },
+            fields: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        dataTypeID: { type: "number" },
+                    },
+                },
+            },
+            truncated: { type: "boolean" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPostgresConnector } = await import("../../connectors/postgres.js");
+        const connector = getPostgresConnector();
+        const result = await connector.query(params.sql, Array.isArray(params.params) ? params.params : undefined, typeof params.rowLimit === "number" ? params.rowLimit : undefined);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// postgres.explain
+// ============================================================================
+registerTool({
+    id: "postgres.explain",
+    namespace: "postgres",
+    description: "Return the JSON query plan for a read-only SQL statement via EXPLAIN (FORMAT JSON). Does not execute the statement's effects.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            sql: {
+                type: "string",
+                description: "SQL statement to explain (read-only statements only)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["sql"],
+    },
+    outputSchema: {
+        type: "object",
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getPostgresConnector } = await import("../../connectors/postgres.js");
+        const connector = getPostgresConnector();
+        const result = await connector.explain(params.sql);
+        return JSON.stringify(result);
+    },
+});
+//# sourceMappingURL=postgres.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * PostHog tools — capture product-analytics events (write) plus read wrappers
+ * for insights, HogQL queries, and raw events.
+ *
+ * Self-registering tool module for the recipe tool registry. Mirrors the
+ * connector method signatures in src/connectors/posthog.ts:
+ *   - captureEvent(distinctId, event, properties?, timestamp?)
+ *   - getInsights(projectId, limit?)
+ *   - queryInsight(projectId, query)
+ *   - getEvents(projectId, params)
+ *
+ * `capture_event` is the only mutating tool — it POSTs to /capture/ and so
+ * declares isWrite: true so the approval queue / kill-switch gate it. The
+ * remaining tools are read-only.
+ */
+export {};