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

package/dist/recipes/tools/confluence.js

@@ -0,0 +1,254 @@
+/**
+ * Confluence tools — get pages, search, create pages, append content, list spaces.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+import { assertWriteAllowed } from "../../featureFlags.js";
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// confluence.getPage
+// ============================================================================
+registerTool({
+    id: "confluence.getPage",
+    namespace: "confluence",
+    description: "Fetch a Confluence page by ID, including its storage-format body.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            pageId: { type: "string", description: "Confluence page ID" },
+            includeBody: {
+                type: "boolean",
+                description: "Whether to include the page body (default true)",
+                default: true,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["pageId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            title: { type: "string" },
+            status: { type: "string" },
+            spaceId: { type: "string" },
+            version: { type: "number" },
+            body: { type: ["string", "null"] },
+            url: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getConfluenceConnector } = await import("../../connectors/confluence.js");
+        const connector = getConfluenceConnector();
+        const page = await connector.getPage(params.pageId, params.includeBody !== false);
+        if (!page)
+            return JSON.stringify({
+                error: `Page ${params.pageId} not found`,
+            });
+        return JSON.stringify({
+            id: page.id,
+            title: page.title,
+            status: page.status,
+            spaceId: page.spaceId,
+            version: page.version.number,
+            body: page.body?.storage?.value ?? null,
+            url: page._links.webui,
+        });
+    },
+});
+// ============================================================================
+// confluence.search
+// ============================================================================
+registerTool({
+    id: "confluence.search",
+    namespace: "confluence",
+    description: "Search Confluence pages using a full-text query (CQL).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search terms" },
+            limit: {
+                type: "number",
+                description: "Max results to return (default 25)",
+                default: 25,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["query"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            results: { type: "array", items: { type: "object" } },
+            totalSize: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getConfluenceConnector } = await import("../../connectors/confluence.js");
+        const connector = getConfluenceConnector();
+        const result = await connector.search(params.query, typeof params.limit === "number" ? params.limit : 25);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// confluence.createPage
+// ============================================================================
+registerTool({
+    id: "confluence.createPage",
+    namespace: "confluence",
+    description: "Create a new Confluence page in a space.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            spaceId: { type: "string", description: "Confluence space ID" },
+            title: { type: "string", description: "Page title" },
+            body: {
+                type: "string",
+                description: "Page body in Confluence storage format (XHTML)",
+            },
+            parentId: {
+                type: "string",
+                description: "Optional parent page ID to nest this page under",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["spaceId", "title", "body"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            title: { type: "string" },
+            url: { type: "string" },
+            version: { type: "number" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        assertWriteAllowed("confluence.createPage");
+        const { getConfluenceConnector } = await import("../../connectors/confluence.js");
+        const connector = getConfluenceConnector();
+        const page = await connector.createPage({
+            spaceId: params.spaceId,
+            title: params.title,
+            body: params.body,
+            parentId: params.parentId,
+        });
+        return JSON.stringify({
+            id: page.id,
+            title: page.title,
+            url: page._links.webui,
+            version: page.version.number,
+        });
+    },
+});
+// ============================================================================
+// confluence.appendToPage
+// ============================================================================
+registerTool({
+    id: "confluence.appendToPage",
+    namespace: "confluence",
+    description: "Append content to an existing Confluence page (increments version).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            pageId: { type: "string", description: "Confluence page ID" },
+            content: {
+                type: "string",
+                description: "Storage-format XHTML content to append",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["pageId", "content"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            title: { type: "string" },
+            version: { type: "number" },
+            url: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        assertWriteAllowed("confluence.appendToPage");
+        const { getConfluenceConnector } = await import("../../connectors/confluence.js");
+        const connector = getConfluenceConnector();
+        const page = await connector.appendToPage(params.pageId, params.content);
+        return JSON.stringify({
+            id: page.id,
+            title: page.title,
+            version: page.version.number,
+            url: page._links.webui,
+        });
+    },
+});
+// ============================================================================
+// confluence.listSpaces
+// ============================================================================
+registerTool({
+    id: "confluence.listSpaces",
+    namespace: "confluence",
+    description: "List all accessible Confluence spaces.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Max spaces to return (default 50)",
+                default: 50,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            spaces: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        key: { type: "string" },
+                        name: { type: "string" },
+                        type: { type: "string" },
+                        url: { type: "string" },
+                    },
+                },
+            },
+            count: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getConfluenceConnector } = await import("../../connectors/confluence.js");
+        const connector = getConfluenceConnector();
+        const spaces = await connector.listSpaces(typeof params.limit === "number" ? params.limit : 50);
+        return JSON.stringify({
+            spaces: spaces.map((s) => ({
+                id: s.id,
+                key: s.key,
+                name: s.name,
+                type: s.type,
+                url: s._links.webui,
+            })),
+            count: spaces.length,
+        });
+    },
+});
+//# sourceMappingURL=confluence.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Datadog tools — query metrics, monitors, alerts, and incidents.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+export {};

package/dist/recipes/tools/datadog.js

@@ -0,0 +1,239 @@
+/**
+ * Datadog tools — query metrics, monitors, alerts, and incidents.
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+import { assertWriteAllowed } from "../../featureFlags.js";
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// datadog.queryMetrics
+// ============================================================================
+registerTool({
+    id: "datadog.queryMetrics",
+    namespace: "datadog",
+    description: "Query Datadog metrics for a time range. Returns time series data.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: 'Datadog metrics query string (e.g. "avg:system.cpu.user{*}")',
+            },
+            from: {
+                type: "number",
+                description: "Start of the query window (Unix timestamp, seconds)",
+            },
+            to: {
+                type: "number",
+                description: "End of the query window (Unix timestamp, seconds)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["query", "from", "to"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            series: { type: "array", items: { type: "object" } },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const result = await connector.queryMetrics(params.query, params.from, params.to);
+        return JSON.stringify(result);
+    },
+});
+// ============================================================================
+// datadog.listMonitors
+// ============================================================================
+registerTool({
+    id: "datadog.listMonitors",
+    namespace: "datadog",
+    description: "List Datadog monitors, optionally filtered by tags.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            tags: {
+                type: "array",
+                items: { type: "string" },
+                description: 'Filter monitors by tags (e.g. ["env:prod", "team:ops"])',
+            },
+            perPage: {
+                type: "number",
+                description: "Results per page (default 100)",
+                default: 100,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            monitors: { type: "array", items: { type: "object" } },
+            count: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const monitors = await connector.listMonitors({
+            tags: Array.isArray(params.tags) ? params.tags : undefined,
+            perPage: typeof params.perPage === "number" ? params.perPage : undefined,
+        });
+        return JSON.stringify({ monitors, count: monitors.length });
+    },
+});
+// ============================================================================
+// datadog.getMonitor
+// ============================================================================
+registerTool({
+    id: "datadog.getMonitor",
+    namespace: "datadog",
+    description: "Fetch a single Datadog monitor by ID.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            monitorId: { type: "number", description: "Datadog monitor ID" },
+            into: CommonSchemas.into,
+        },
+        required: ["monitorId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            name: { type: "string" },
+            status: { type: "string" },
+            overall_state: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const monitor = await connector.getMonitor(params.monitorId);
+        return JSON.stringify(monitor);
+    },
+});
+// ============================================================================
+// datadog.listActiveAlerts
+// ============================================================================
+registerTool({
+    id: "datadog.listActiveAlerts",
+    namespace: "datadog",
+    description: "List Datadog monitors currently in Alert or Warn state (active incidents).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            alerts: { type: "array", items: { type: "object" } },
+            count: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params: _ }) => {
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const alerts = await connector.listActiveAlerts();
+        return JSON.stringify({ alerts, count: alerts.length });
+    },
+});
+// ============================================================================
+// datadog.muteMonitor
+// ============================================================================
+registerTool({
+    id: "datadog.muteMonitor",
+    namespace: "datadog",
+    description: "Mute a Datadog monitor to suppress alerts. Optionally specify when the mute expires.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            monitorId: { type: "number", description: "Datadog monitor ID" },
+            end: {
+                type: "number",
+                description: "Unix timestamp when the mute expires (optional). If omitted, muted indefinitely.",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["monitorId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "number" },
+            name: { type: "string" },
+            overall_state: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        assertWriteAllowed("datadog.muteMonitor");
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const monitor = await connector.muteMonitor(params.monitorId, typeof params.end === "number" ? params.end : undefined);
+        return JSON.stringify({
+            id: monitor.id,
+            name: monitor.name,
+            overall_state: monitor.overall_state,
+        });
+    },
+});
+// ============================================================================
+// datadog.listIncidents
+// ============================================================================
+registerTool({
+    id: "datadog.listIncidents",
+    namespace: "datadog",
+    description: "List Datadog incidents.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            perPage: {
+                type: "number",
+                description: "Results per page (default 10)",
+                default: 10,
+            },
+            into: CommonSchemas.into,
+        },
+        required: [],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            data: { type: "array", items: { type: "object" } },
+            count: { type: "number" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getDatadogConnector } = await import("../../connectors/datadog.js");
+        const connector = getDatadogConnector();
+        const result = await connector.listIncidents({
+            perPage: typeof params.perPage === "number" ? params.perPage : undefined,
+        });
+        return JSON.stringify({ data: result.data, count: result.data.length });
+    },
+});
+//# sourceMappingURL=datadog.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Diagnostics tool — diagnostics.get
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+export {};

package/dist/recipes/tools/diagnostics.js

@@ -0,0 +1,36 @@
+/**
+ * Diagnostics tool — diagnostics.get
+ *
+ * Self-registering tool module for the recipe tool registry.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// diagnostics.get
+// ============================================================================
+registerTool({
+    id: "diagnostics.get",
+    namespace: "diagnostics",
+    description: "Get diagnostic summary for a file URI (requires bridge connection; returns stub if unavailable).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            uri: {
+                type: "string",
+                description: "File URI to get diagnostics for (e.g., 'file:///path/to/file.ts')",
+                default: "",
+            },
+            into: CommonSchemas.into,
+        },
+    },
+    outputSchema: {
+        type: "string",
+        description: "Diagnostic summary string (errors, warnings count or detailed list)",
+    },
+    riskDefault: "low",
+    isWrite: false,
+    execute: async ({ params, deps }) => {
+        const uri = String(params.uri ?? "");
+        return deps.getDiagnostics(uri);
+    },
+});
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/recipes/tools/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,iBAAiB;IACrB,SAAS,EAAE,aAAa;IACxB,WAAW,EACT,kGAAkG;IACpG,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mEAAmE;gBACrE,OAAO,EAAE,EAAE;aACZ;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,qEAAqE;KACxE;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Discord tools — wrappers for guilds, channels, messages, user, and send.
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools wrap
+ * connector throws into the `{count, items, error}` shape; the write tool
+ * (`discord.send_message`) returns the single-object `{ok, ..., error?}` shape
+ * and is gated through the approval queue (`isWrite: true`).
+ *
+ * Each tool wraps connector throws into the `{count, items, error}` shape that
+ * the runner's silent-fail detector (PR #75) catches as a step error rather
+ * than a silent empty list.
+ *
+ * NOTE on `discord.send_message`: Discord's REST API only accepts message
+ * sends from bot-scope OAuth tokens. The connector currently uses user-scope
+ * (identify/guilds/messages.read), so the underlying call will surface a
+ * `permission_denied` error until operators re-auth with the bot scope.
+ */
+export {};