@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/tasks/mcp/dist/tools/task-get.d.ts

@@ -0,0 +1,19 @@
+export interface TaskDetail {
+    taskId: string;
+    name: string;
+    description: string;
+    status: string;
+    priority: string;
+    dueDate?: string;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+    relationships: Array<{
+        type: string;
+        targetLabel: string;
+        targetId: string;
+        targetName?: string;
+    }>;
+}
+export declare function taskGet(taskId: string, accountId: string): Promise<TaskDetail | null>;
+//# sourceMappingURL=task-get.d.ts.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-get.d.ts","sourceRoot":"","sources":["../../src/tools/task-get.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4D3F"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-get.js

@@ -0,0 +1,51 @@
+import { getSession } from "../lib/neo4j.js";
+export async function taskGet(taskId, accountId) {
+    const session = getSession();
+    try {
+        // Fetch the task node
+        const taskResult = await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId}) RETURN t`, { taskId, accountId });
+        if (taskResult.records.length === 0)
+            return null;
+        const t = taskResult.records[0].get("t").properties;
+        // Fetch all outgoing relationships
+        const relResult = await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId})-[r]->(target)
+       RETURN type(r) AS relType, labels(target) AS targetLabels, elementId(target) AS targetId,
+              target.name AS targetName, target.givenName AS targetGivenName,
+              target.taskId AS targetTaskId`, { taskId, accountId });
+        const relationships = relResult.records.map((rec) => {
+            const targetLabels = rec.get("targetLabels");
+            const targetLabel = targetLabels[0] ?? "Unknown";
+            const targetId = rec.get("targetId");
+            // Best-effort name resolution across node types
+            const targetName = rec.get("targetName") ??
+                rec.get("targetGivenName") ??
+                rec.get("targetTaskId") ??
+                targetId;
+            return {
+                type: rec.get("relType"),
+                targetLabel,
+                targetId,
+                targetName,
+            };
+        });
+        const detail = {
+            taskId: t.taskId,
+            name: t.name,
+            description: t.description,
+            status: t.status,
+            priority: t.priority,
+            createdAt: t.createdAt,
+            updatedAt: t.updatedAt,
+            relationships,
+        };
+        if (t.dueDate)
+            detail.dueDate = t.dueDate;
+        if (t.notes)
+            detail.notes = t.notes;
+        return detail;
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=task-get.js.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-get.js","sourceRoot":"","sources":["../../src/tools/task-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoB7C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,SAAiB;IAC7D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,kEAAkE,EAClE,EAAE,MAAM,EAAE,SAAS,EAAE,CACtB,CAAC;QAEF,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjD,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QAEpD,mCAAmC;QACnC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC;;;4CAGsC,EACtC,EAAE,MAAM,EAAE,SAAS,EAAE,CACtB,CAAC;QAEF,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAClD,MAAM,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAa,CAAC;YACzD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;YACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAW,CAAC;YAE/C,gDAAgD;YAChD,MAAM,UAAU,GACb,GAAG,CAAC,GAAG,CAAC,YAAY,CAAmB;gBACvC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAmB;gBAC5C,GAAG,CAAC,GAAG,CAAC,cAAc,CAAmB;gBAC1C,QAAQ,CAAC;YAEX,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAW;gBAClC,WAAW;gBACX,QAAQ;gBACR,UAAU;aACX,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAe;YACzB,MAAM,EAAE,CAAC,CAAC,MAAgB;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAc;YACtB,WAAW,EAAE,CAAC,CAAC,WAAqB;YACpC,MAAM,EAAE,CAAC,CAAC,MAAgB;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAkB;YAC9B,SAAS,EAAE,CAAC,CAAC,SAAmB;YAChC,SAAS,EAAE,CAAC,CAAC,SAAmB;YAChC,aAAa;SACd,CAAC;QAEF,IAAI,CAAC,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAiB,CAAC;QACpD,IAAI,CAAC,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAe,CAAC;QAE9C,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-list.d.ts

@@ -0,0 +1,18 @@
+export interface TaskListParams {
+    accountId: string;
+    status?: string;
+    priority?: string;
+    relatedEntityId?: string;
+    limit?: number;
+}
+export interface TaskSummary {
+    taskId: string;
+    name: string;
+    status: string;
+    priority: string;
+    dueDate?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function taskList(params: TaskListParams): Promise<TaskSummary[]>;
+//# sourceMappingURL=task-list.d.ts.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../../src/tools/task-list.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA8D7E"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-list.js

@@ -0,0 +1,66 @@
+import { int } from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+export async function taskList(params) {
+    const { accountId, status, priority, relatedEntityId, limit = 50 } = params;
+    const session = getSession();
+    try {
+        let query;
+        const queryParams = { accountId, limit: int(limit) };
+        if (relatedEntityId) {
+            // Tasks related to a specific entity via any relationship
+            query = `
+        MATCH (t:Task {accountId: $accountId})-[]->(e)
+        WHERE elementId(e) = $relatedEntityId
+        ${status ? "AND t.status = $status" : ""}
+        ${priority ? "AND t.priority = $priority" : ""}
+        RETURN t
+        ORDER BY t.createdAt DESC
+        LIMIT $limit
+      `;
+            queryParams.relatedEntityId = relatedEntityId;
+        }
+        else {
+            query = `
+        MATCH (t:Task {accountId: $accountId})
+        ${status || priority ? "WHERE" : ""}
+        ${status ? "t.status = $status" : ""}
+        ${status && priority ? "AND" : ""}
+        ${priority ? "t.priority = $priority" : ""}
+        RETURN t
+        ORDER BY
+          CASE t.priority
+            WHEN 'urgent' THEN 0
+            WHEN 'high' THEN 1
+            WHEN 'normal' THEN 2
+            WHEN 'low' THEN 3
+            ELSE 4
+          END,
+          t.createdAt DESC
+        LIMIT $limit
+      `;
+        }
+        if (status)
+            queryParams.status = status;
+        if (priority)
+            queryParams.priority = priority;
+        const result = await session.run(query, queryParams);
+        return result.records.map((rec) => {
+            const t = rec.get("t").properties;
+            const summary = {
+                taskId: t.taskId,
+                name: t.name,
+                status: t.status,
+                priority: t.priority,
+                createdAt: t.createdAt,
+                updatedAt: t.updatedAt,
+            };
+            if (t.dueDate)
+                summary.dueDate = t.dueDate;
+            return summary;
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=task-list.js.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.js","sourceRoot":"","sources":["../../src/tools/task-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoB7C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAsB;IACnD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAE5E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,KAAa,CAAC;QAClB,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAE9E,IAAI,eAAe,EAAE,CAAC;YACpB,0DAA0D;YAC1D,KAAK,GAAG;;;UAGJ,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE;UACtC,QAAQ,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE;;;;OAI/C,CAAC;YACF,WAAW,CAAC,eAAe,GAAG,eAAe,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,KAAK,GAAG;;UAEJ,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;UACjC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE;UAClC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;UAC/B,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;OAY3C,CAAC;QACJ,CAAC;QAED,IAAI,MAAM;YAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QACxC,IAAI,QAAQ;YAAE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAErD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YAClC,MAAM,OAAO,GAAgB;gBAC3B,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,IAAI,EAAE,CAAC,CAAC,IAAc;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAkB;gBAC9B,SAAS,EAAE,CAAC,CAAC,SAAmB;gBAChC,SAAS,EAAE,CAAC,CAAC,SAAmB;aACjC,CAAC;YACF,IAAI,CAAC,CAAC,OAAO;gBAAE,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,OAAiB,CAAC;YACrD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-ready.d.ts

@@ -0,0 +1,21 @@
+export interface ReadyTask {
+    taskId: string;
+    name: string;
+    description: string;
+    priority: string;
+    dueDate?: string;
+    createdAt: string;
+}
+/**
+ * Returns tasks that are safe to start: status=pending, zero unresolved
+ * BLOCKS, and no AFFECTS conflict with currently active tasks.
+ *
+ * This is the product equivalent of the development lane compatibility
+ * matrix — it answers "what can I work on next without conflict?"
+ *
+ *   Pending task is READY when:
+ *     1. No incomplete task BLOCKS it (sequential dependency)
+ *     2. No active task AFFECTS the same entity (conflict detection)
+ */
+export declare function taskReady(accountId: string): Promise<ReadyTask[]>;
+//# sourceMappingURL=task-ready.d.ts.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-ready.d.ts","sourceRoot":"","sources":["../../src/tools/task-ready.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA0CvE"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-ready.js

@@ -0,0 +1,54 @@
+import { getSession } from "../lib/neo4j.js";
+/**
+ * Returns tasks that are safe to start: status=pending, zero unresolved
+ * BLOCKS, and no AFFECTS conflict with currently active tasks.
+ *
+ * This is the product equivalent of the development lane compatibility
+ * matrix — it answers "what can I work on next without conflict?"
+ *
+ *   Pending task is READY when:
+ *     1. No incomplete task BLOCKS it (sequential dependency)
+ *     2. No active task AFFECTS the same entity (conflict detection)
+ */
+export async function taskReady(accountId) {
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (t:Task {accountId: $accountId, status: 'pending'})
+       WHERE NOT EXISTS {
+         MATCH (blocker:Task {accountId: $accountId})-[:BLOCKS]->(t)
+         WHERE blocker.status IN ['pending', 'active']
+       }
+       AND NOT EXISTS {
+         MATCH (t)-[:AFFECTS]->(entity)<-[:AFFECTS]-(active:Task {accountId: $accountId})
+         WHERE active.status = 'active'
+       }
+       RETURN t
+       ORDER BY
+         CASE t.priority
+           WHEN 'urgent' THEN 0
+           WHEN 'high' THEN 1
+           WHEN 'normal' THEN 2
+           WHEN 'low' THEN 3
+           ELSE 4
+         END,
+         t.createdAt ASC
+       LIMIT 50`, { accountId });
+        return result.records.map((rec) => {
+            const t = rec.get("t").properties;
+            const task = {
+                taskId: t.taskId,
+                name: t.name,
+                description: t.description,
+                priority: t.priority,
+                createdAt: t.createdAt,
+            };
+            if (t.dueDate)
+                task.dueDate = t.dueDate;
+            return task;
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=task-ready.js.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-ready.js","sourceRoot":"","sources":["../../src/tools/task-ready.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;;;;;;;;;;;gBAmBU,EACV,EAAE,SAAS,EAAE,CACd,CAAC;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YAClC,MAAM,IAAI,GAAc;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,IAAI,EAAE,CAAC,CAAC,IAAc;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAqB;gBACpC,QAAQ,EAAE,CAAC,CAAC,QAAkB;gBAC9B,SAAS,EAAE,CAAC,CAAC,SAAmB;aACjC,CAAC;YACF,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,OAAiB,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-relate.d.ts

@@ -0,0 +1,12 @@
+declare const ALLOWED_REL_TYPES: readonly ["AFFECTS", "RAISED_BY", "PART_OF", "BLOCKS"];
+type RelType = typeof ALLOWED_REL_TYPES[number];
+export interface TaskRelateParams {
+    taskId: string;
+    accountId: string;
+    targetId: string;
+    targetLabel: string;
+    relType: RelType;
+}
+export declare function taskRelate(params: TaskRelateParams): Promise<void>;
+export {};
+//# sourceMappingURL=task-relate.d.ts.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-relate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-relate.d.ts","sourceRoot":"","sources":["../../src/tools/task-relate.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,iBAAiB,wDAAyD,CAAC;AACjF,KAAK,OAAO,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAIhD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwExE"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-relate.js

@@ -0,0 +1,59 @@
+import { getSession } from "../lib/neo4j.js";
+const ALLOWED_REL_TYPES = ["AFFECTS", "RAISED_BY", "PART_OF", "BLOCKS"];
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export async function taskRelate(params) {
+    const { taskId, accountId, targetId, targetLabel, relType } = params;
+    if (!ALLOWED_REL_TYPES.includes(relType)) {
+        throw new Error(`Invalid relationship type: ${relType}. Must be one of: ${ALLOWED_REL_TYPES.join(", ")}`);
+    }
+    const isTaskTarget = targetLabel === "Task";
+    const session = getSession();
+    try {
+        // Verify the source task exists
+        const taskCheck = await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId}) RETURN t`, { taskId, accountId });
+        if (taskCheck.records.length === 0) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Verify the target node exists
+        // Task targets: match by taskId property (UUID from task-create)
+        // Non-Task targets: match by elementId (from memory-search results)
+        let targetCheck;
+        if (isTaskTarget) {
+            targetCheck = await session.run(`MATCH (target:Task {taskId: $targetId, accountId: $accountId}) RETURN target`, { targetId, accountId });
+        }
+        else {
+            targetCheck = await session.run(`MATCH (target)
+         WHERE elementId(target) = $targetId AND $targetLabel IN labels(target)
+         RETURN target`, { targetId, targetLabel });
+        }
+        if (targetCheck.records.length === 0) {
+            if (isTaskTarget) {
+                const hint = !UUID_RE.test(targetId)
+                    ? ` (the value looks like an elementId, not a UUID — use the taskId returned by task-create)`
+                    : "";
+                throw new Error(`Target task not found with taskId: ${targetId}${hint}`);
+            }
+            else {
+                const hint = UUID_RE.test(targetId)
+                    ? ` (the value looks like a UUID — non-Task targets require an elementId from memory-search)`
+                    : "";
+                throw new Error(`Target ${targetLabel} not found with elementId: ${targetId}${hint}`);
+            }
+        }
+        // Create the relationship (idempotent — MERGE avoids duplicates)
+        if (isTaskTarget) {
+            await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId})
+         MATCH (target:Task {taskId: $targetId, accountId: $accountId})
+         MERGE (t)-[:${relType}]->(target)`, { taskId, accountId, targetId });
+        }
+        else {
+            await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId})
+         MATCH (target) WHERE elementId(target) = $targetId
+         MERGE (t)-[:${relType}]->(target)`, { taskId, accountId, targetId });
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=task-relate.js.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-relate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-relate.js","sourceRoot":"","sources":["../../src/tools/task-relate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAGjF,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAUlF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAwB;IACvD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAErE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,qBAAqB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,KAAK,MAAM,CAAC;IAE5C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,kEAAkE,EAClE,EAAE,MAAM,EAAE,SAAS,EAAE,CACtB,CAAC;QAEF,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,gCAAgC;QAChC,iEAAiE;QACjE,oEAAoE;QACpE,IAAI,WAAW,CAAC;QAChB,IAAI,YAAY,EAAE,CAAC;YACjB,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,8EAA8E,EAC9E,EAAE,QAAQ,EAAE,SAAS,EAAE,CACxB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B;;uBAEe,EACf,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC1B,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAClC,CAAC,CAAC,2FAA2F;oBAC7F,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACjC,CAAC,CAAC,2FAA2F;oBAC7F,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,UAAU,WAAW,8BAA8B,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,OAAO,CAAC,GAAG,CACf;;uBAEe,OAAO,aAAa,EACnC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAChC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,CAAC,GAAG,CACf;;uBAEe,OAAO,aAAa,EACnC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-update.d.ts

@@ -0,0 +1,32 @@
+export interface TaskUpdateParams {
+    taskId: string;
+    accountId: string;
+    name?: string;
+    description?: string;
+    /**
+     * Status enum (Task 885: `running` joins existing values to discriminate
+     * "action mid-flight" from `active` ("commitment accepted")). Transition
+     * to `completed` or `failed` auto-sets `completedAt`. Transition to
+     * `failed` also requires `errorMessage` to be non-empty.
+     */
+    status?: "pending" | "active" | "running" | "completed" | "failed" | "cancelled";
+    priority?: "low" | "normal" | "high" | "urgent";
+    dueDate?: string;
+    /** Appended to notes with a timestamp — never overwrites */
+    note?: string;
+    /**
+     * Task 885 — append a single step label to the Task's `steps[]` array.
+     * Atomic Cypher SET t.steps = coalesce(t.steps, []) + $step (no
+     * read-modify-write race). Each appendStep call adds one entry; emit
+     * one call per phase of the action.
+     */
+    appendStep?: string;
+    /**
+     * Task 885 — error message stored on the Task when status transitions
+     * to `failed`. Required for the `failed` transition; empty errorMessage
+     * with status=failed is rejected.
+     */
+    errorMessage?: string;
+}
+export declare function taskUpdate(params: TaskUpdateParams): Promise<void>;
+//# sourceMappingURL=task-update.d.ts.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update.d.ts","sourceRoot":"","sources":["../../src/tools/task-update.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACjF,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIxE"}

package/payload/platform/plugins/tasks/mcp/dist/tools/task-update.js

@@ -0,0 +1,112 @@
+import { getSession } from "../lib/neo4j.js";
+import { computeEmbedding } from "../lib/embeddings.js";
+export async function taskUpdate(params) {
+    const { taskId, accountId, name, description, status, priority, dueDate, note, appendStep, errorMessage } = params;
+    if (status === "failed" && (!errorMessage || errorMessage.trim().length === 0)) {
+        throw new Error("task-update: errorMessage is required when status transitions to 'failed'.");
+    }
+    const session = getSession();
+    try {
+        // Fetch current task to build updated embedding and append note. Also
+        // fetches `kind` so the lifecycle log line below knows whether this
+        // Task is an action record (kind set) vs commitment-tracking (kind null).
+        const existing = await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId})
+       RETURN t.name AS name, t.description AS description, t.notes AS notes,
+              t.status AS status, t.priority AS priority, t.kind AS kind,
+              size(coalesce(t.steps, [])) AS stepsCount`, { taskId, accountId });
+        if (existing.records.length === 0) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        const rec = existing.records[0];
+        const currentName = rec.get("name");
+        const currentDescription = rec.get("description");
+        const currentNotes = rec.get("notes") ?? "";
+        const currentStatus = rec.get("status");
+        const currentPriority = rec.get("priority");
+        const kind = rec.get("kind") ?? null;
+        const newName = name ?? currentName;
+        const newDescription = description ?? currentDescription;
+        const newStatus = status ?? currentStatus;
+        const newPriority = priority ?? currentPriority;
+        // Append note with timestamp (append-only — never overwrite)
+        let newNotes = currentNotes;
+        if (note) {
+            const timestamp = new Date().toISOString().slice(0, 16).replace("T", " ");
+            newNotes = currentNotes
+                ? `${currentNotes}\n[${timestamp}] ${note}`
+                : `[${timestamp}] ${note}`;
+        }
+        const nowIso = new Date().toISOString();
+        const setClauses = [
+            "t.status = $status",
+            "t.priority = $priority",
+            "t.notes = $notes",
+            "t.updatedAt = $updatedAt",
+        ];
+        const queryParams = {
+            taskId,
+            accountId,
+            status: newStatus,
+            priority: newPriority,
+            notes: newNotes,
+            updatedAt: nowIso,
+        };
+        if (name !== undefined) {
+            setClauses.push("t.name = $name");
+            queryParams.name = name;
+        }
+        if (description !== undefined) {
+            setClauses.push("t.description = $description");
+            queryParams.description = description;
+        }
+        if (dueDate !== undefined) {
+            setClauses.push("t.dueDate = $dueDate");
+            queryParams.dueDate = dueDate;
+        }
+        // Task 885 — atomic steps[] append. Cypher `coalesce(t.steps, []) + $step`
+        // is one round-trip; no read-modify-write race even under concurrent
+        // appends (executeWrite serializes per-tx). Distinct from notes which
+        // is a free-form string field; steps is a structured action-phase log.
+        if (appendStep !== undefined) {
+            setClauses.push("t.steps = coalesce(t.steps, []) + $appendStep");
+            queryParams.appendStep = appendStep;
+        }
+        // Task 885 — completion lifecycle. completedAt set on terminal status
+        // transitions (completed | failed). errorMessage only persisted on
+        // `failed` (the contract above already validates non-empty).
+        if (status === "completed" || status === "failed") {
+            setClauses.push("t.completedAt = $completedAt");
+            queryParams.completedAt = nowIso;
+        }
+        if (status === "failed") {
+            setClauses.push("t.errorMessage = $errorMessage");
+            queryParams.errorMessage = errorMessage;
+        }
+        // Re-embed with updated values (substitute new name/description when provided)
+        const embeddingText = `Task: ${newName} — ${newDescription} status: ${newStatus} priority: ${newPriority}${newNotes ? " " + newNotes : ""}`;
+        const embedding = await computeEmbedding(embeddingText);
+        if (embedding.length > 0) {
+            setClauses.push("t.embedding = $embedding");
+            queryParams.embedding = embedding;
+        }
+        const updateRes = await session.run(`MATCH (t:Task {taskId: $taskId, accountId: $accountId})
+       SET ${setClauses.join(", ")}
+       RETURN size(coalesce(t.steps, [])) AS stepsCount`, queryParams);
+        // Lifecycle log lines — only for action Tasks (kind set). Commitment-
+        // tracking callers (no kind) stay silent on this channel so existing
+        // [task] grep targets aren't flooded with non-action noise.
+        if (kind) {
+            if (appendStep !== undefined) {
+                process.stderr.write(`[task] action-step kind=${kind} taskId=${taskId} step=${appendStep}\n`);
+            }
+            if (status === "completed" || status === "failed") {
+                const stepsCount = updateRes.records[0]?.get("stepsCount")?.toNumber?.() ?? 0;
+                process.stderr.write(`[task] action-done kind=${kind} taskId=${taskId} status=${status} stepsCount=${stepsCount}\n`);
+            }
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=task-update.js.map

package/payload/platform/plugins/tasks/mcp/dist/tools/task-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update.js","sourceRoot":"","sources":["../../src/tools/task-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiCxD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAwB;IACvD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEnH,IAAI,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,sEAAsE;QACtE,oEAAoE;QACpE,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC;;;wDAGkD,EAClD,EAAE,MAAM,EAAE,SAAS,EAAE,CACtB,CAAC;QAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC;QAC9C,MAAM,kBAAkB,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAW,CAAC;QAC5D,MAAM,YAAY,GAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAmB,IAAI,EAAE,CAAC;QAC/D,MAAM,aAAa,GAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAY,CAAC;QACpD,MAAM,eAAe,GAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAY,CAAC;QACxD,MAAM,IAAI,GAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAmB,IAAI,IAAI,CAAC;QAExD,MAAM,OAAO,GAAG,IAAI,IAAI,WAAW,CAAC;QACpC,MAAM,cAAc,GAAG,WAAW,IAAI,kBAAkB,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,IAAI,aAAa,CAAC;QAC1C,MAAM,WAAW,GAAG,QAAQ,IAAI,eAAe,CAAC;QAEhD,6DAA6D;QAC7D,IAAI,QAAQ,GAAG,YAAY,CAAC;QAC5B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1E,QAAQ,GAAG,YAAY;gBACrB,CAAC,CAAC,GAAG,YAAY,MAAM,SAAS,KAAK,IAAI,EAAE;gBAC3C,CAAC,CAAC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,UAAU,GAAa;YAC3B,oBAAoB;YACpB,wBAAwB;YACxB,kBAAkB;YAClB,0BAA0B;SAC3B,CAAC;QACF,MAAM,WAAW,GAA4B;YAC3C,MAAM;YACN,SAAS;YACT,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,MAAM;SAClB,CAAC;QAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAClC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAChD,WAAW,CAAC,WAAW,GAAG,WAAW,CAAC;QACxC,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACxC,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,CAAC;QAED,2EAA2E;QAC3E,qEAAqE;QACrE,sEAAsE;QACtE,uEAAuE;QACvE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,UAAU,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YACjE,WAAW,CAAC,UAAU,GAAG,UAAU,CAAC;QACtC,CAAC;QAED,sEAAsE;QACtE,mEAAmE;QACnE,6DAA6D;QAC7D,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClD,UAAU,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAChD,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAClD,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC;QAC1C,CAAC;QAED,+EAA+E;QAC/E,MAAM,aAAa,GAAG,SAAS,OAAO,MAAM,cAAc,YAAY,SAAS,cAAc,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5I,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YAC5C,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC;QACpC,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC;aACO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;wDACsB,EAClD,WAAW,CACZ,CAAC;QAEF,sEAAsE;QACtE,qEAAqE;QACrE,4DAA4D;QAC5D,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,IAAI,WAAW,MAAM,SAAS,UAAU,IAAI,CACxE,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;gBAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,IAAI,WAAW,MAAM,WAAW,MAAM,eAAe,UAAU,IAAI,CAC/F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/tasks/mcp/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxy/tasks",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "neo4j-driver": "^5.28.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/telegram/PLUGIN.md

@@ -0,0 +1,35 @@
+---
+name: telegram
+description: Guide users through connecting a Telegram bot — creating a bot via BotFather, finding user IDs, and configuring admin vs public bots.
+metadata: {"platform":{"optional":true}}
+tools:
+  - message
+  - message-history
+  - telegram-webhook-register
+---
+
+# Telegram Setup
+
+Walks users through connecting Telegram bots. Covers bot creation, token configuration, finding numeric user IDs, and choosing between admin and public bot roles.
+
+## When to activate
+
+- User asks how to connect Telegram or set up a Telegram bot
+- User asks about BotFather, bot tokens, or Telegram integration
+- User needs to find their Telegram user ID for admin binding
+- User asks about admin vs public bot configuration
+- User is on the Setup page and asks about the Telegram section
+
+## What it unlocks
+
+- Telegram as a messaging channel — DMs and group conversations routed to the AI assistant
+- Multi-bot support — separate admin and public bots with different access policies
+- Admin routing — restrict a bot to admin-only access via numeric user ID bindings
+
+## References
+
+| Task | When to use | Reference |
+|------|-------------|-----------|
+| Guided setup | User wants help connecting Telegram | `references/setup-guide.md` |
+
+Load the reference and follow its instructions.

package/payload/platform/plugins/telegram/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}