patchwork-os 0.2.0-alpha.34 → 0.2.0-alpha.36

package/dist/recipes/tools/asana.js

@@ -0,0 +1,524 @@
+/**
+ * Asana tools — read wrappers (workspaces, projects, tasks, user) plus writes
+ * (create_task, update_task, complete_task, add_task_comment).
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools wrap
+ * 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. Write tools use a single-object response shape (no count/items)
+ * but still surface failures via an `error` field.
+ *
+ * Note: Asana's only OAuth scope (`default`) grants read+write combined —
+ * there is no read-only-only scope. Defense lives here at the recipe-tool
+ * layer: read tools declare `isWrite: false`, write tools declare
+ * `isWrite: true` so the approval queue gates them appropriately.
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+// ============================================================================
+// asana.get_current_user
+// ============================================================================
+registerTool({
+    id: "asana.get_current_user",
+    namespace: "asana",
+    description: "Fetch the authenticated Asana user (gid, name, email).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            into: CommonSchemas.into,
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array", items: { type: "object" } },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async () => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        try {
+            const connector = getAsanaConnector();
+            const user = await connector.getCurrentUser();
+            return JSON.stringify({ count: 1, items: [user] });
+        }
+        catch (err) {
+            return JSON.stringify({
+                count: 0,
+                items: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.list_workspaces
+// ============================================================================
+registerTool({
+    id: "asana.list_workspaces",
+    namespace: "asana",
+    description: "List Asana workspaces the authenticated user belongs to.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            max: CommonSchemas.max,
+            into: CommonSchemas.into,
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array", items: { type: "object" } },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        const limit = typeof params.max === "number" ? params.max : 50;
+        try {
+            const connector = getAsanaConnector();
+            const workspaces = await connector.listWorkspaces({ limit });
+            return JSON.stringify({ count: workspaces.length, items: workspaces });
+        }
+        catch (err) {
+            return JSON.stringify({
+                count: 0,
+                items: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.list_projects
+// ============================================================================
+registerTool({
+    id: "asana.list_projects",
+    namespace: "asana",
+    description: "List projects within an Asana workspace.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            workspaceGid: {
+                type: "string",
+                description: "Asana workspace gid",
+            },
+            max: CommonSchemas.max,
+            into: CommonSchemas.into,
+        },
+        required: ["workspaceGid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array", items: { type: "object" } },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        const limit = typeof params.max === "number" ? params.max : 50;
+        try {
+            const connector = getAsanaConnector();
+            const projects = await connector.listProjects({
+                workspaceGid: params.workspaceGid,
+                limit,
+            });
+            return JSON.stringify({ count: projects.length, items: projects });
+        }
+        catch (err) {
+            return JSON.stringify({
+                count: 0,
+                items: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.list_tasks
+// ============================================================================
+registerTool({
+    id: "asana.list_tasks",
+    namespace: "asana",
+    description: "List Asana tasks. Requires either projectGid, or assignee + workspaceGid.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            projectGid: {
+                type: "string",
+                description: "Asana project gid (filter by project)",
+            },
+            assignee: {
+                type: "string",
+                description: "Asana user gid or 'me' (filter by assignee)",
+            },
+            workspaceGid: {
+                type: "string",
+                description: "Asana workspace gid (required when filtering by assignee)",
+            },
+            max: CommonSchemas.max,
+            into: CommonSchemas.into,
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array", items: { type: "object" } },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        const limit = typeof params.max === "number" ? params.max : 50;
+        try {
+            const connector = getAsanaConnector();
+            const tasks = await connector.listTasks({
+                projectGid: params.projectGid,
+                assignee: params.assignee,
+                workspaceGid: params.workspaceGid,
+                limit,
+            });
+            return JSON.stringify({ count: tasks.length, items: tasks });
+        }
+        catch (err) {
+            return JSON.stringify({
+                count: 0,
+                items: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.get_task
+// ============================================================================
+registerTool({
+    id: "asana.get_task",
+    namespace: "asana",
+    description: "Fetch a single Asana task by gid.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            taskGid: {
+                type: "string",
+                description: "Asana task gid",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["taskGid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array", items: { type: "object" } },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        try {
+            const connector = getAsanaConnector();
+            const task = await connector.getTask(params.taskGid);
+            return JSON.stringify({ count: 1, items: [task] });
+        }
+        catch (err) {
+            return JSON.stringify({
+                count: 0,
+                items: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.create_task  (write-gated)
+// ============================================================================
+registerTool({
+    id: "asana.create_task",
+    namespace: "asana",
+    description: "Create a new Asana task in a workspace, optionally attached to a project, assigned, due-dated, or nested under a parent task.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            workspace_gid: {
+                type: "string",
+                description: "Asana workspace gid (required)",
+            },
+            name: { type: "string", description: "Task title (required)" },
+            project_gid: {
+                type: "string",
+                description: "Optional project gid to attach the task to",
+            },
+            notes: {
+                type: "string",
+                description: "Optional task body / notes (free-form text)",
+            },
+            assignee_gid: {
+                type: "string",
+                description: "Optional Asana user gid to assign the task to",
+            },
+            due_on: {
+                type: "string",
+                description: "Optional ISO date YYYY-MM-DD",
+            },
+            parent_task_gid: {
+                type: "string",
+                description: "Optional parent task gid (creates a subtask)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["workspace_gid", "name"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            gid: { type: "string" },
+            name: { type: "string" },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        try {
+            const connector = getAsanaConnector();
+            const task = await connector.createTask({
+                workspaceGid: params.workspace_gid,
+                name: params.name,
+                projectGid: typeof params.project_gid === "string"
+                    ? params.project_gid
+                    : undefined,
+                notes: typeof params.notes === "string" ? params.notes : undefined,
+                assigneeGid: typeof params.assignee_gid === "string"
+                    ? params.assignee_gid
+                    : undefined,
+                dueOn: typeof params.due_on === "string" ? params.due_on : undefined,
+                parentTaskGid: typeof params.parent_task_gid === "string"
+                    ? params.parent_task_gid
+                    : undefined,
+            });
+            return JSON.stringify({ ok: true, gid: task.gid, name: task.name });
+        }
+        catch (err) {
+            return JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.update_task  (write-gated)
+// ============================================================================
+registerTool({
+    id: "asana.update_task",
+    namespace: "asana",
+    description: "Update fields on an Asana task. At least one of name/notes/completed/assignee_gid/due_on must be supplied.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            task_gid: { type: "string", description: "Asana task gid (required)" },
+            name: { type: "string", description: "New task title" },
+            notes: { type: "string", description: "New task notes / body" },
+            completed: {
+                type: "boolean",
+                description: "Mark task completed/uncompleted",
+            },
+            assignee_gid: {
+                type: "string",
+                description: "New assignee user gid",
+            },
+            due_on: {
+                type: "string",
+                description: "ISO date YYYY-MM-DD",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["task_gid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            gid: { type: "string" },
+            name: { type: "string" },
+            completed: { type: "boolean" },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        // Defense at wrapper level — refuse when no update fields supplied so the
+        // recipe author sees a clear error rather than an Asana 400.
+        const updates = {};
+        if (typeof params.name === "string")
+            updates.name = params.name;
+        if (typeof params.notes === "string")
+            updates.notes = params.notes;
+        if (typeof params.completed === "boolean") {
+            updates.completed = params.completed;
+        }
+        if (typeof params.assignee_gid === "string") {
+            updates.assigneeGid = params.assignee_gid;
+        }
+        if (typeof params.due_on === "string")
+            updates.dueOn = params.due_on;
+        if (Object.keys(updates).length === 0) {
+            return JSON.stringify({
+                ok: false,
+                error: "update_task requires at least one of name/notes/completed/assignee_gid/due_on",
+            });
+        }
+        try {
+            const connector = getAsanaConnector();
+            const task = await connector.updateTask(params.task_gid, updates);
+            return JSON.stringify({
+                ok: true,
+                gid: task.gid,
+                name: task.name,
+                completed: task.completed,
+            });
+        }
+        catch (err) {
+            return JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.complete_task  (write-gated)
+// ============================================================================
+registerTool({
+    id: "asana.complete_task",
+    namespace: "asana",
+    description: "Mark an Asana task completed (sets completed: true).",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            task_gid: { type: "string", description: "Asana task gid (required)" },
+            into: CommonSchemas.into,
+        },
+        required: ["task_gid"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            gid: { type: "string" },
+            completed: { type: "boolean" },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        try {
+            const connector = getAsanaConnector();
+            const task = await connector.completeTask(params.task_gid);
+            return JSON.stringify({
+                ok: true,
+                gid: task.gid,
+                completed: task.completed,
+            });
+        }
+        catch (err) {
+            return JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+// ============================================================================
+// asana.add_task_comment  (write-gated)
+// ============================================================================
+registerTool({
+    id: "asana.add_task_comment",
+    namespace: "asana",
+    description: "Append a comment story to an Asana task's timeline.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            task_gid: { type: "string", description: "Asana task gid (required)" },
+            text: {
+                type: "string",
+                description: "Comment text (non-empty, plain text)",
+                minLength: 1,
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["task_gid", "text"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            gid: { type: "string" },
+            text: { type: "string" },
+            created_at: { type: "string" },
+            error: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: true,
+    isConnector: true,
+    execute: async ({ params }) => {
+        const { getAsanaConnector } = await import("../../connectors/asana.js");
+        const text = typeof params.text === "string" ? params.text : "";
+        if (!text) {
+            return JSON.stringify({
+                ok: false,
+                error: "add_task_comment requires non-empty text",
+            });
+        }
+        try {
+            const connector = getAsanaConnector();
+            const story = await connector.addTaskComment(params.task_gid, {
+                text,
+            });
+            return JSON.stringify({
+                ok: true,
+                gid: story.gid,
+                text: story.text,
+                created_at: story.created_at,
+            });
+        }
+        catch (err) {
+            return JSON.stringify({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    },
+});
+//# sourceMappingURL=asana.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asana.js","sourceRoot":"","sources":["../../../src/recipes/tools/asana.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,wBAAwB;IAC5B,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,wDAAwD;IACrE,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,cAAc,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,uBAAuB;IAC3B,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,0DAA0D;IACvE,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,qBAAqB;IACzB,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,0CAA0C;IACvD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,cAAc,CAAC;KAC3B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC;gBAC5C,YAAY,EAAE,MAAM,CAAC,YAAsB;gBAC3C,KAAK;aACN,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,kBAAkB;IACtB,SAAS,EAAE,OAAO;IAClB,WAAW,EACT,2EAA2E;IAC7E,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2DAA2D;aAC9D;YACD,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC;gBACtC,UAAU,EAAE,MAAM,CAAC,UAAgC;gBACnD,QAAQ,EAAE,MAAM,CAAC,QAA8B;gBAC/C,YAAY,EAAE,MAAM,CAAC,YAAkC;gBACvD,KAAK;aACN,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,gBAAgB;IACpB,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,mCAAmC;IAChD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gBAAgB;aAC9B;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,OAAiB,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,mBAAmB;IACvB,SAAS,EAAE,OAAO;IAClB,WAAW,EACT,+HAA+H;IACjI,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC9D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC;KACpC;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC;gBACtC,YAAY,EAAE,MAAM,CAAC,aAAuB;gBAC5C,IAAI,EAAE,MAAM,CAAC,IAAc;gBAC3B,UAAU,EACR,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;oBACpC,CAAC,CAAC,MAAM,CAAC,WAAW;oBACpB,CAAC,CAAC,SAAS;gBACf,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAClE,WAAW,EACT,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;oBACrC,CAAC,CAAC,MAAM,CAAC,YAAY;oBACrB,CAAC,CAAC,SAAS;gBACf,KAAK,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACpE,aAAa,EACX,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ;oBACxC,CAAC,CAAC,MAAM,CAAC,eAAe;oBACxB,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,mBAAmB;IACvB,SAAS,EAAE,OAAO;IAClB,WAAW,EACT,4GAA4G;IAC9G,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACtE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACvD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC/D,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iCAAiC;aAC/C;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,0EAA0E;QAC1E,6DAA6D;QAC7D,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAChE,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACnE,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;QAC5C,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAErE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EACH,+EAA+E;aAClF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,CACrC,MAAM,CAAC,QAAkB,EACzB,OAMC,CACF,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,IAAI;gBACR,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,qBAAqB;IACzB,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,sDAAsD;IACnE,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACtE,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,QAAkB,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,IAAI;gBACR,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E,YAAY,CAAC;IACX,EAAE,EAAE,wBAAwB;IAC5B,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,qDAAqD;IAClE,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACtE,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;gBACnD,SAAS,EAAE,CAAC;aACb;YACD,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAC/B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;IACD,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,0CAA0C;aAClD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,QAAkB,EAAE;gBACtE,IAAI;aACL,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,IAAI;gBACR,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,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 {};