@feeble/blay-openclaw-plugin 0.1.17

package/dist/tools/action-items.js

@@ -0,0 +1,101 @@
+/**
+ * Action Item Tools — blay_list_action_items, blay_create_action_item, blay_update_action_item
+ */
+import { Type } from "@sinclair/typebox";
+import { formatError } from "../client.js";
+import { formatActionItem, formatConfirmation } from "../utils/formatting.js";
+export function createListActionItemsTool(client) {
+    return {
+        name: "blay_list_action_items",
+        label: "Blay List Action Items",
+        description: "List action items (discrete to-dos assigned to people). Use this for follow-ups and commitments — these are separate from tasks. Filter by assignee, status, or overdue.",
+        parameters: Type.Object({
+            assigneeId: Type.Optional(Type.String({ description: "Filter by assignee user ID" })),
+            status: Type.Optional(Type.String({ description: "Filter by status (pending, completed, cancelled)" })),
+            overdue: Type.Optional(Type.Boolean({ description: "Only return overdue action items" })),
+            limit: Type.Optional(Type.Number({ description: "Max results (default 50)" })),
+        }),
+        async execute(_toolCallId, params) {
+            const res = await client.get("/api/v1/action-items", {
+                assigneeId: params.assigneeId,
+                status: params.status,
+                overdue: params.overdue ? "true" : undefined,
+                limit: params.limit?.toString(),
+            });
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            const items = res.data.data ?? [];
+            if (items.length === 0) {
+                return { content: [{ type: "text", text: "No action items found." }], details: {} };
+            }
+            return {
+                content: [
+                    { type: "text", text: `# Action Items (${items.length})\n\n${items.map(formatActionItem).join("\n")}` },
+                ],
+                details: {},
+            };
+        },
+    };
+}
+export function createCreateActionItemTool(client) {
+    return {
+        name: "blay_create_action_item",
+        label: "Blay Create Action Item",
+        description: "Create a new action item assigned to a user. Action items are discrete follow-ups or commitments — use tasks for larger pieces of work.",
+        parameters: Type.Object({
+            title: Type.String({ description: "Action item title" }),
+            targetUserId: Type.String({ description: "User ID of the person who needs to act on this" }),
+            priority: Type.Optional(Type.String({ description: "Priority level" })),
+            dueDate: Type.Optional(Type.Number({ description: "Due date as Unix timestamp in milliseconds" })),
+            projectId: Type.Optional(Type.String({ description: "Associated project ID" })),
+        }),
+        async execute(_toolCallId, params) {
+            const res = await client.post("/api/v1/action-items", {
+                title: params.title,
+                targetUserId: params.targetUserId,
+                priority: params.priority,
+                dueDate: params.dueDate,
+                projectId: params.projectId,
+            });
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            return {
+                content: [{ type: "text", text: formatConfirmation("Action item created", res.data) }],
+                details: {},
+            };
+        },
+    };
+}
+export function createUpdateActionItemTool(client) {
+    return {
+        name: "blay_update_action_item",
+        label: "Blay Update Action Item",
+        description: "Update an existing action item's fields. Use blay_list_action_items first to find the right ID.",
+        parameters: Type.Object({
+            actionItemId: Type.String({ description: "The action item ID to update" }),
+            title: Type.Optional(Type.String({ description: "New title" })),
+            status: Type.Optional(Type.String({ description: "New status (pending, completed, cancelled)" })),
+            priority: Type.Optional(Type.String({ description: "New priority" })),
+            dueDate: Type.Optional(Type.Number({ description: "New due date as Unix timestamp in milliseconds" })),
+        }),
+        async execute(_toolCallId, params) {
+            const { actionItemId, ...updates } = params;
+            const body = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (value !== undefined)
+                    body[key] = value;
+            }
+            const res = await client.patch(`/api/v1/action-items/${actionItemId}`, body);
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            return {
+                content: [{ type: "text", text: formatConfirmation("Action item updated", res.data) }],
+                details: {},
+            };
+        },
+    };
+}
+//# sourceMappingURL=action-items.js.map

package/dist/tools/action-items.js.map

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

package/dist/tools/briefing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Briefing Tool — blay_briefing
+ *
+ * Composite tool that calls multiple endpoints in parallel and
+ * assembles a complete context dump in one tool call.
+ */
+import type { BlayClient } from "../client.js";
+import type { ToolResult } from "../types.js";
+export declare function createBriefingTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{}>;
+    execute(): Promise<ToolResult>;
+};

package/dist/tools/briefing.js

@@ -0,0 +1,138 @@
+/**
+ * Briefing Tool — blay_briefing
+ *
+ * Composite tool that calls multiple endpoints in parallel and
+ * assembles a complete context dump in one tool call.
+ */
+import { Type } from "@sinclair/typebox";
+import { formatError } from "../client.js";
+import { formatTask, formatActionItem, formatNotification, formatUser, formatRelativeDate, } from "../utils/formatting.js";
+export function createBriefingTool(client) {
+    return {
+        name: "blay_briefing",
+        label: "Blay Briefing",
+        description: "Get a complete briefing of your current work in Blay. Returns your identity, urgent/overdue items, in-progress tasks (with stale flags), backlog, recently completed work, blocked items, pending action items, unread notifications, and team summary. This is the best tool to start with when you need context about the user's work.",
+        parameters: Type.Object({}),
+        async execute() {
+            const meRes = await client.get("/api/v1/me");
+            if (!meRes.ok) {
+                return {
+                    content: [{ type: "text", text: `Error fetching user identity: ${formatError(meRes)}` }],
+                    details: {},
+                };
+            }
+            const me = meRes.data;
+            const userId = me.userId;
+            const [orgRes, inProgressRes, backlogRes, overdueRes, blockedRes, staleRes, completedRes, actionItemsRes, notificationsRes] = await Promise.all([
+                client.get("/api/v1/org"),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    status: "in_progress",
+                    limit: "20",
+                }),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    status: "not_started",
+                    limit: "20",
+                }),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    overdue: "true",
+                    limit: "20",
+                }),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    blocked: "true",
+                    limit: "20",
+                }),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    stale: "true",
+                    limit: "20",
+                }),
+                client.get("/api/v1/tasks", {
+                    assigneeId: userId,
+                    status: "completed",
+                    limit: "5",
+                }),
+                client.get("/api/v1/action-items", {
+                    assigneeId: userId,
+                    status: "pending",
+                    limit: "20",
+                }),
+                client.get("/api/v1/notifications", {
+                    unreadOnly: "true",
+                    limit: "20",
+                }),
+            ]);
+            const sections = [];
+            sections.push(`## You\n**${me.name}** (${me.email}) — ${me.role ?? "member"} at **${me.orgName ?? "your org"}**\nYour user ID: ${me.userId}`);
+            const overdue = overdueRes.ok ? overdueRes.data.data : [];
+            if (overdue.length > 0) {
+                sections.push(`## Overdue Tasks (${overdue.length})\n${overdue.map(formatTask).join("\n")}`);
+            }
+            else {
+                sections.push("## Overdue Tasks\nNone — you're all caught up!");
+            }
+            const blocked = blockedRes.ok ? blockedRes.data.data : [];
+            if (blocked.length > 0) {
+                sections.push(`## Blocked Tasks (${blocked.length})\n${blocked.map(formatTask).join("\n")}`);
+            }
+            const inProgress = inProgressRes.ok ? inProgressRes.data.data : [];
+            const staleIds = new Set((staleRes.ok ? staleRes.data.data : []).map((t) => t.id));
+            if (inProgress.length > 0) {
+                const formatted = inProgress.map((t) => {
+                    const line = formatTask(t);
+                    if (staleIds.has(t.id)) {
+                        const updated = t.updatedAt
+                            ? ` (last update: ${formatRelativeDate(t.updatedAt)})`
+                            : "";
+                        return `${line} STALE${updated}`;
+                    }
+                    return line;
+                });
+                const staleCount = inProgress.filter((t) => staleIds.has(t.id)).length;
+                const header = staleCount > 0
+                    ? `## In Progress (${inProgress.length}) — ${staleCount} stale`
+                    : `## In Progress (${inProgress.length})`;
+                sections.push(`${header}\n${formatted.join("\n")}`);
+            }
+            else {
+                sections.push("## In Progress\nNo tasks currently in progress.");
+            }
+            const backlog = backlogRes.ok ? backlogRes.data.data : [];
+            if (backlog.length > 0) {
+                sections.push(`## Backlog (${backlog.length})\n${backlog.map(formatTask).join("\n")}`);
+            }
+            const completed = completedRes.ok ? completedRes.data.data : [];
+            if (completed.length > 0) {
+                const formatted = completed.map((t) => {
+                    const line = formatTask(t);
+                    const when = t.updatedAt ? ` — completed ${formatRelativeDate(t.updatedAt)}` : "";
+                    return `${line}${when}`;
+                });
+                sections.push(`## Recently Completed (${completed.length})\n${formatted.join("\n")}`);
+            }
+            const actionItems = actionItemsRes.ok ? actionItemsRes.data.data : [];
+            if (actionItems.length > 0) {
+                sections.push(`## Pending Action Items (${actionItems.length})\n${actionItems.map(formatActionItem).join("\n")}`);
+            }
+            const notifications = notificationsRes.ok ? notificationsRes.data.data : [];
+            if (notifications.length > 0) {
+                sections.push(`## Unread Notifications (${notifications.length})\n${notifications.map(formatNotification).join("\n")}`);
+            }
+            if (orgRes.ok) {
+                const org = orgRes.data;
+                const members = org.members ?? [];
+                if (members.length > 0) {
+                    sections.push(`## Team (${members.length} members)\n${members.map(formatUser).join("\n")}`);
+                }
+            }
+            return {
+                content: [{ type: "text", text: `# Blay Briefing\n\n${sections.join("\n\n")}` }],
+                details: {},
+            };
+        },
+    };
+}
+//# sourceMappingURL=briefing.js.map

package/dist/tools/briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../../src/tools/briefing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAahC,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,0UAA0U;QAC5U,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,OAAO;YACX,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAa,YAAY,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;oBACxF,OAAO,EAAE,EAAE;iBACZ,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;YACtB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YAEzB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,GACzH,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,MAAM,CAAC,GAAG,CAA0B,aAAa,CAAC;gBAClD,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,eAAe,EAAE;oBACpF,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,WAAW;oBACnB,KAAK,EAAE,GAAG;iBACX,CAAC;gBACF,MAAM,CAAC,GAAG,CAA2D,sBAAsB,EAAE;oBAC3F,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,CAAC,GAAG,CAAsC,uBAAuB,EAAE;oBACvE,UAAU,EAAE,MAAM;oBAClB,KAAK,EAAE,IAAI;iBACZ,CAAC;aACH,CAAC,CAAC;YAEL,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,QAAQ,CAAC,IAAI,CACX,aAAa,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,IAAI,IAAI,QAAQ,SAAS,EAAE,CAAC,OAAO,IAAI,UAAU,qBAAqB,EAAE,CAAC,MAAM,EAAE,CAC/H,CAAC;YAEF,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;YAED,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAY,CAAC,CACnE,CAAC;YAEF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACrC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAY,CAAC,EAAE,CAAC;wBACjC,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS;4BACzB,CAAC,CAAC,kBAAkB,kBAAkB,CAAC,CAAC,CAAC,SAAmB,CAAC,GAAG;4BAChE,CAAC,CAAC,EAAE,CAAC;wBACP,OAAO,GAAG,IAAI,SAAS,OAAO,EAAE,CAAC;oBACnC,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;gBACH,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAY,CAAC,CAAC,CAAC,MAAM,CAAC;gBACjF,MAAM,MAAM,GACV,UAAU,GAAG,CAAC;oBACZ,CAAC,CAAC,mBAAmB,UAAU,CAAC,MAAM,OAAO,UAAU,QAAQ;oBAC/D,CAAC,CAAC,mBAAmB,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACpC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,kBAAkB,CAAC,CAAC,CAAC,SAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5F,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;gBAC1B,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,0BAA0B,SAAS,CAAC,MAAM,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;YAED,MAAM,WAAW,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,4BAA4B,WAAW,CAAC,MAAM,MAAM,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpH,CAAC;YAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,4BAA4B,aAAa,CAAC,MAAM,MAAM,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1H,CAAC;YAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,MAAM,CAAC,IAA+C,CAAC;gBACnE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBAClC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,QAAQ,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,cAAc,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9F,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChF,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Comment Tools — blay_list_comments, blay_post_comment
+ */
+import type { BlayClient } from "../client.js";
+import type { ToolResult } from "../types.js";
+export declare function createListCommentsTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        entityType: import("@sinclair/typebox").TString;
+        entityId: import("@sinclair/typebox").TString;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>;
+    execute(_toolCallId: string, params: {
+        entityType: string;
+        entityId: string;
+        limit?: number;
+    }): Promise<ToolResult>;
+};
+export declare function createPostCommentTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        content: import("@sinclair/typebox").TString;
+        taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        resourceId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        actionItemId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        isNote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        mentions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>;
+    execute(_toolCallId: string, params: {
+        content: string;
+        taskId?: string;
+        projectId?: string;
+        resourceId?: string;
+        actionItemId?: string;
+        isNote?: boolean;
+        mentions?: string[];
+    }): Promise<ToolResult>;
+};

package/dist/tools/comments.js

@@ -0,0 +1,79 @@
+/**
+ * Comment Tools — blay_list_comments, blay_post_comment
+ */
+import { Type } from "@sinclair/typebox";
+import { formatError } from "../client.js";
+import { formatRelativeDate } from "../utils/formatting.js";
+export function createListCommentsTool(client) {
+    return {
+        name: "blay_list_comments",
+        label: "Blay List Comments",
+        description: "List comments on a task, project, resource, or action item. Use blay_get_context instead if you also need the entity's metadata and other details in one call.",
+        parameters: Type.Object({
+            entityType: Type.String({ description: "Entity type: 'task', 'project', 'resource', or 'actionItem'" }),
+            entityId: Type.String({ description: "The entity ID" }),
+            limit: Type.Optional(Type.Number({ description: "Max comments to return (default 50)" })),
+        }),
+        async execute(_toolCallId, params) {
+            const res = await client.get("/api/v1/comments", {
+                entityType: params.entityType,
+                entityId: params.entityId,
+                limit: params.limit?.toString(),
+            });
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            const comments = res.data.data ?? [];
+            if (comments.length === 0) {
+                return { content: [{ type: "text", text: "No comments found." }], details: {} };
+            }
+            const formatted = comments
+                .map((c) => `**${c.authorName ?? "Unknown"}** (${formatRelativeDate(c.createdAt)}):\n${c.content}`)
+                .join("\n\n---\n\n");
+            return {
+                content: [{ type: "text", text: `# Comments (${comments.length})\n\n${formatted}` }],
+                details: {},
+            };
+        },
+    };
+}
+export function createPostCommentTool(client) {
+    return {
+        name: "blay_post_comment",
+        label: "Blay Post Comment",
+        description: "Post a comment on a task, project, resource, or action item. Specify exactly one entity ID.",
+        parameters: Type.Object({
+            content: Type.String({ description: "Comment text" }),
+            taskId: Type.Optional(Type.String({ description: "Task ID to comment on" })),
+            projectId: Type.Optional(Type.String({ description: "Project ID to comment on" })),
+            resourceId: Type.Optional(Type.String({ description: "Resource ID to comment on" })),
+            actionItemId: Type.Optional(Type.String({ description: "Action item ID to comment on" })),
+            isNote: Type.Optional(Type.Boolean({ description: "If true, this is a private note" })),
+            mentions: Type.Optional(Type.Array(Type.String(), { description: "User IDs to mention" })),
+        }),
+        async execute(_toolCallId, params) {
+            const body = { content: params.content };
+            if (params.taskId)
+                body.taskId = params.taskId;
+            if (params.projectId)
+                body.projectId = params.projectId;
+            if (params.resourceId)
+                body.resourceId = params.resourceId;
+            if (params.actionItemId)
+                body.actionItemId = params.actionItemId;
+            if (params.isNote !== undefined)
+                body.isNote = params.isNote;
+            if (params.mentions)
+                body.mentions = params.mentions;
+            const res = await client.post("/api/v1/comments", body);
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            return {
+                content: [{ type: "text", text: "Comment posted successfully." }],
+                details: {},
+            };
+        },
+    };
+}
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Context Tool — blay_get_context
+ */
+import type { BlayClient } from "../client.js";
+import type { ToolResult } from "../types.js";
+export declare function createGetContextTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        entityType: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"project">]>;
+        entityId: import("@sinclair/typebox").TString;
+        depth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shallow">, import("@sinclair/typebox").TLiteral<"standard">, import("@sinclair/typebox").TLiteral<"deep">]>>;
+    }>;
+    execute(_toolCallId: string, params: {
+        entityType: "task" | "project";
+        entityId: string;
+        depth?: "shallow" | "standard" | "deep";
+    }): Promise<ToolResult>;
+};

package/dist/tools/context.js

@@ -0,0 +1,31 @@
+/**
+ * Context Tool — blay_get_context
+ */
+import { Type } from "@sinclair/typebox";
+import { formatError } from "../client.js";
+import { formatContextEntity } from "../utils/formatting.js";
+export function createGetContextTool(client) {
+    return {
+        name: "blay_get_context",
+        label: "Blay Get Context",
+        description: "Get deep assembled context for a task or project in one call. Prefer this over blay_get_task + blay_list_comments + separate calls when you need comprehensive context. Returns the entity, its project, recent comments, subtasks, resources, and collaborators depending on depth level.",
+        parameters: Type.Object({
+            entityType: Type.Union([Type.Literal("task"), Type.Literal("project")], { description: "Entity type" }),
+            entityId: Type.String({ description: "Entity ID" }),
+            depth: Type.Optional(Type.Union([Type.Literal("shallow"), Type.Literal("standard"), Type.Literal("deep")], {
+                description: "Context depth: 'shallow' (metadata only), 'standard' (entity + project + recent comments, default), 'deep' (everything including subtasks, resources, links, collaborators)",
+            })),
+        }),
+        async execute(_toolCallId, params) {
+            const res = await client.get(`/api/v1/context/${params.entityType}/${params.entityId}`, { depth: params.depth });
+            if (!res.ok) {
+                return { content: [{ type: "text", text: formatError(res) }], details: {} };
+            }
+            return {
+                content: [{ type: "text", text: formatContextEntity(res.data) }],
+                details: {},
+            };
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,4RAA4R;QAC9R,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;YACvG,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;gBACpF,WAAW,EACT,6KAA6K;aAChL,CAAC,CACH;SACF,CAAC;QACF,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,MAAqG;YAErG,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,mBAAmB,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,EACzD,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACxB,CAAC;YAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC9E,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChE,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/instrumentation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool Instrumentation — wraps tool execute() to capture telemetry.
+ *
+ * When a RunTracker is active, records start time, params, result/error,
+ * and duration for each tool call. When no tracker is active, passes
+ * through to the original execute unchanged.
+ *
+ * Truncates params to 2KB and results to 1KB to keep run records bounded.
+ */
+import type { ToolResult } from "../types.js";
+export declare function truncate(value: unknown, maxLength: number): string | undefined;
+/**
+ * Wraps a tool's execute method to capture telemetry for the active RunTracker.
+ * Returns the same tool shape with instrumented execute.
+ */
+export declare function instrumentTool<T extends {
+    name: string;
+    execute: (...args: any[]) => Promise<ToolResult>;
+}>(tool: T): T;

package/dist/tools/instrumentation.js

@@ -0,0 +1,84 @@
+/**
+ * Tool Instrumentation — wraps tool execute() to capture telemetry.
+ *
+ * When a RunTracker is active, records start time, params, result/error,
+ * and duration for each tool call. When no tracker is active, passes
+ * through to the original execute unchanged.
+ *
+ * Truncates params to 2KB and results to 1KB to keep run records bounded.
+ */
+import { getCurrentRunTracker } from "../channel/run-tracker.js";
+import { isAborted } from "../channel/abort.js";
+const MAX_PARAMS_LENGTH = 2048;
+const MAX_RESULT_LENGTH = 1024;
+export function truncate(value, maxLength) {
+    if (value === undefined || value === null)
+        return undefined;
+    let str;
+    if (typeof value === "string") {
+        str = value;
+    }
+    else {
+        try {
+            str = JSON.stringify(value);
+        }
+        catch {
+            str = String(value);
+        }
+    }
+    if (str.length > maxLength) {
+        return str.slice(0, maxLength) + "...[truncated]";
+    }
+    return str;
+}
+/**
+ * Wraps a tool's execute method to capture telemetry for the active RunTracker.
+ * Returns the same tool shape with instrumented execute.
+ */
+export function instrumentTool(tool) {
+    const originalExecute = tool.execute;
+    const instrumentedExecute = async function (toolCallId, params, ...rest) {
+        // Safety net: block blay_* tool execution when abort is active
+        if (isAborted()) {
+            throw new Error("Agent run was aborted by user");
+        }
+        const tracker = getCurrentRunTracker();
+        if (!tracker) {
+            return originalExecute.call(this, toolCallId, params, ...rest);
+        }
+        const startedAt = Date.now();
+        try {
+            const result = await originalExecute.call(this, toolCallId, params, ...rest);
+            const completedAt = Date.now();
+            const resultText = result?.content?.[0]?.text;
+            const record = {
+                name: tool.name,
+                params: truncate(params, MAX_PARAMS_LENGTH),
+                result: truncate(resultText, MAX_RESULT_LENGTH),
+                status: "success",
+                startedAt,
+                completedAt,
+                durationMs: completedAt - startedAt,
+            };
+            tracker.recordToolCall(record);
+            return result;
+        }
+        catch (err) {
+            const completedAt = Date.now();
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            const record = {
+                name: tool.name,
+                params: truncate(params, MAX_PARAMS_LENGTH),
+                status: "error",
+                error: truncate(errorMessage, MAX_RESULT_LENGTH),
+                startedAt,
+                completedAt,
+                durationMs: completedAt - startedAt,
+            };
+            tracker.recordToolCall(record);
+            throw err;
+        }
+    };
+    return { ...tool, execute: instrumentedExecute };
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/tools/instrumentation.js.map

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

package/dist/tools/notifications.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Notification Tools — blay_list_notifications, blay_mark_notification_read
+ */
+import type { BlayClient } from "../client.js";
+import type { ToolResult } from "../types.js";
+export declare function createListNotificationsTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        unreadOnly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>;
+    execute(_toolCallId: string, params: {
+        unreadOnly?: boolean;
+        limit?: number;
+    }): Promise<ToolResult>;
+};
+export declare function createMarkNotificationReadTool(client: BlayClient): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        notificationId: import("@sinclair/typebox").TString;
+    }>;
+    execute(_toolCallId: string, params: {
+        notificationId: string;
+    }): Promise<ToolResult>;
+};