viviscape-mcp 2.0.2 → 2.2.0

package/dist/projection.js

@@ -0,0 +1,132 @@
+/**
+ * Response shaping for list tools -- phase 2 of docs/AGENT-CAPABILITY-SPEC.md.
+ *
+ * The core API returns every column it has: a task row carries ~90 fields
+ * (including fleet columns like vin and unit_class) and a project row carries 87
+ * (including video-conference config and welcome messages). Six open tasks came
+ * back as 102 KB; 211 active projects as 487 KB, which no caller can afford to
+ * read. These helpers trim to a PM-relevant default, page the result, and tell
+ * the caller what was left out so it can ask for more deliberately.
+ */
+/** Task fields worth returning by default, of roughly 90 available. */
+export const TASK_FIELDS = [
+    'task_id', 'task', 'status', 'percentage', 'priority',
+    'company_id', 'company_name', 'group_id', 'group_name',
+    'milestone_id', 'milestone', 'estimated_time', 'total_duration_str',
+    'deadline', 'start', 'end', 'staff_assignees', 'total_comments', 'unread_for_me',
+];
+/** Project (group) fields worth returning by default, of 87 available. */
+export const PROJECT_FIELDS = [
+    'intGroupId', 'strGroupName', 'intCompanyId', 'strCompany',
+    'status', 'bitActive', 'group_type', 'percentage',
+    'total_tasks', 'total_tasks_open', 'total_tasks_completed',
+    'target_date', 'complete_date', 'total_estimated_str', 'total_duration_str',
+];
+/**
+ * Note fields worth returning by default. Excludes `note` (the full body) and
+ * `firefly_transcript_id`: the account list runs to hundreds of rows and the
+ * bodies dominate the payload. Ask for fields:["note"] to read one.
+ */
+export const NOTE_FIELDS = [
+    'note_id', 'title', 'book_id', 'creator', 'creator_id',
+    'summary', 'tags', 'assigned_users', 'knowledge', 'is_public',
+    'last_update', 'create_date',
+];
+/** Project/task file fields worth returning by default. */
+export const FILE_FIELDS = [
+    'file_id', 'group_id', 'task_id', 'title', 'file_name', 'file_type',
+    'file_size_friendly', 'author', 'user_id', 'post_date', 'url_path',
+    'is_public', 'is_private',
+];
+export const DEFAULT_LIMIT = 50;
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** Parse the staff_assignees blob, which arrives as JSON text or as an array. */
+function assigneeIds(row) {
+    const raw = row.staff_assignees;
+    let arr = raw;
+    if (typeof raw === 'string') {
+        try {
+            arr = JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(arr))
+        return [];
+    return arr
+        .map((u) => (isRecord(u) ? Number(u.user_id) : Number(u)))
+        .filter((n) => Number.isFinite(n));
+}
+const lower = (v) => String(v ?? '').toLowerCase();
+/** Apply the filters the backend does not support, in-process. */
+export function filterTasks(rows, f) {
+    return rows.filter((row) => {
+        if (!isRecord(row))
+            return true;
+        if (f.company_id && Number(row.company_id) !== f.company_id)
+            return false;
+        if (f.project_id && Number(row.group_id) !== f.project_id)
+            return false;
+        if (f.status && lower(row.status) !== f.status.toLowerCase())
+            return false;
+        if (f.priority && lower(row.priority) !== f.priority.toLowerCase())
+            return false;
+        if (f.assignee_id && !assigneeIds(row).includes(f.assignee_id))
+            return false;
+        if (f.search) {
+            const hay = `${lower(row.task)} ${lower(row.description)} ${lower(row.notes)}`;
+            if (!hay.includes(f.search.toLowerCase()))
+                return false;
+        }
+        // `end` is the task's own due date; `deadline` is a human string ("In 2 Days").
+        if (f.due_before || f.due_after) {
+            const due = Date.parse(String(row.end ?? ''));
+            if (!Number.isFinite(due))
+                return false;
+            if (f.due_before && due > Date.parse(f.due_before))
+                return false;
+            if (f.due_after && due < Date.parse(f.due_after))
+                return false;
+        }
+        return true;
+    });
+}
+function pick(row, fields) {
+    if (!isRecord(row))
+        return row;
+    const out = {};
+    for (const f of fields)
+        if (f in row)
+            out[f] = row[f];
+    return out;
+}
+/**
+ * Trim, page, and annotate a list response. Non-array payloads (a single record,
+ * or an error object) pass through untouched.
+ *
+ * Pass fields: ['all'] to opt out of projection and get every column.
+ */
+export function shape(payload, defaults, opts = {}) {
+    if (!Array.isArray(payload))
+        return payload;
+    const total = payload.length;
+    const offset = Math.max(0, opts.offset ?? 0);
+    const limit = Math.max(1, opts.limit ?? DEFAULT_LIMIT);
+    const page = payload.slice(offset, offset + limit);
+    const all = opts.fields?.length === 1 && opts.fields[0] === 'all';
+    const fields = all ? null : (opts.fields?.length ? opts.fields : defaults);
+    const items = fields ? page.map((r) => pick(r, fields)) : page;
+    const available = isRecord(payload[0]) ? Object.keys(payload[0]).length : 0;
+    const next = offset + page.length;
+    return {
+        total,
+        returned: page.length,
+        offset,
+        ...(next < total ? { next_offset: next } : {}),
+        fields: fields
+            ? `${fields.length} of ${available} columns; pass fields:["all"] or a specific list for more`
+            : `all ${available} columns`,
+        items,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viviscape-mcp",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "MCP server for the ViviScape API — CRM, projects, companies, notes, and insights, authenticated as the signed-in ViviScape user",
   "type": "module",
   "main": "dist/index.js",