@dain-os/mcp-server 0.17.0 → 0.18.0

package/dist/meta.d.ts

@@ -9,7 +9,7 @@
  * it here removes that drift between the two transports.
  */
 export declare const SERVER_NAME = "dainos";
-export declare const SERVER_VERSION = "0.17.0";
+export declare const SERVER_VERSION = "0.18.0";
 /**
  * Instructions advertised to MCP clients in the `initialize` response.
  *
@@ -23,5 +23,5 @@ export declare const SERVER_VERSION = "0.17.0";
  * instruction it later runs, so stale tool names stay recoverable until the
  * library catches up.
  */
-export declare const SERVER_INSTRUCTIONS = "# DainOS MCP\n\nDainOS is the agency operating system (projects, tasks, proposals, CRM,\ndeveloper changelog/sessions/knowledge-base, and the Claude instruction\nlibrary). This server exposes it through two kinds of tools.\n\n## 1. Generic tools \u2014 operate on ANY resource\n\n- describe_schema \u2014 list every resource with its fields, filters, and allowed\n  operations. CALL THIS FIRST in a session before reading or writing data you\n  are not already certain about.\n- query  \u2014 read.  { resource, id? | filters? | search?, parentId?, sort?, limit?, offset? }\n- mutate \u2014 write. { resource, operation: 'create' | 'update' | 'delete', id?, parentId?, data? }\n\nNested resources need parentId (e.g. milestones under a project, comments under\na task). Free-text search only works on resources marked searchable.\n\n## 2. Semantic tools \u2014 carry business logic the generic trio can't express\n\nPrefer the semantic tool whenever one matches your intent:\n\n  Tasks      create_task \u00B7 complete_task \u00B7 regenerate_client_view\n  Cadence    claim_next_task \u00B7 report_task_progress \u00B7 mark_blocked \u00B7 request_unblock\n  Proposals  set_proposal_status \u00B7 create_proposal_option \u00B7 update_proposal_option\n             set_recommended_option \u00B7 proposal_content \u00B7 describe_proposal_block_types\n  Developer  log_changelog_entry \u00B7 log_knowledge_base_entry \u00B7 log_time_entry \u00B7 score_pr_finding\n  Library    get_instruction \u00B7 list_instructions \u00B7 search_instructions \u00B7 upsert_instruction\n\nThese are all CURRENT. Do not translate them.\n\n## Old tool names (read this if an instruction names a tool you don't have)\n\nv0.8 removed ~36 thin CRUD tools. If a command, skill, or rule tells you to call\na tool that is NOT listed above, it predates the refactor. Translate it:\n\n  list_projects / get_project           -> query projects\n  list_tasks / get_task                 -> query tasks\n  list_milestones                       -> query milestones (parentId = projectId)\n  update_task                           -> mutate tasks update\n  add_task_comment                      -> mutate task_comments create (parentId = taskId)\n  list_proposals / get_proposal         -> query proposals\n  list_recent_sessions / list_sessions  -> query session_context\n  log_session_context                   -> mutate session_context create\n  list_changelog                        -> query developer_changelog\n  search_knowledge_base                 -> query developer_knowledge_base (search = \"...\")\n  update_knowledge_base_entry           -> mutate developer_knowledge_base update\n  list_tenant_users / list_users        -> query iam_users (filters: status)\n  get_user                              -> query iam_users (id = \"...\")\n  lookup_product_repos                  -> query product_repos (filters: owner, repo)\n  summarise_product_tasks               -> query product_task_summary (parentId = productId)\n  list_unscored_pr_findings             -> query pr_review_findings (filters: repo, prNumber, scoredBy)\n\ncomplete_task still exists for the task done-state walk \u2014 only the plain field\nupdate moved to mutate. When in doubt, call describe_schema and match your\nintent to a resource.";
+export declare const SERVER_INSTRUCTIONS = "# DainOS MCP\n\nDainOS is the agency operating system (projects, tasks, proposals, CRM,\ndeveloper changelog/sessions/knowledge-base, and the Claude instruction\nlibrary). This server exposes it through two kinds of tools.\n\n## 1. Generic tools \u2014 operate on ANY resource\n\n- describe_schema \u2014 list every resource with its fields, filters, and allowed\n  operations. CALL THIS FIRST in a session before reading or writing data you\n  are not already certain about.\n- query  \u2014 read.  { resource, id? | filters? | search?, parentId?, sort?, limit?, offset? }\n- mutate \u2014 write. { resource, operation: 'create' | 'update' | 'delete', id?, parentId?, data? }\n\nNested resources need parentId (e.g. milestones under a project, comments under\na task). Free-text search only works on resources marked searchable.\n\n## 2. Semantic tools \u2014 carry business logic the generic trio can't express\n\nPrefer the semantic tool whenever one matches your intent:\n\n  Tasks      create_task \u00B7 complete_task \u00B7 regenerate_client_view\n  Cadence    claim_next_task \u00B7 report_task_progress \u00B7 mark_blocked \u00B7 request_unblock\n  Proposals  set_proposal_status \u00B7 create_proposal_option \u00B7 update_proposal_option\n             set_recommended_option \u00B7 proposal_content \u00B7 describe_proposal_block_types\n  Developer  log_changelog_entry \u00B7 log_knowledge_base_entry \u00B7 log_time_entry \u00B7 score_pr_finding\n  AI spend   get_ai_spend_totals \u00B7 get_ai_spend_summary\n  Library    get_instruction \u00B7 list_instructions \u00B7 search_instructions \u00B7 upsert_instruction\n\nThese are all CURRENT. Do not translate them.\n\n## Old tool names (read this if an instruction names a tool you don't have)\n\nv0.8 removed ~36 thin CRUD tools. If a command, skill, or rule tells you to call\na tool that is NOT listed above, it predates the refactor. Translate it:\n\n  list_projects / get_project           -> query projects\n  list_tasks / get_task                 -> query tasks\n  list_milestones                       -> query milestones (parentId = projectId)\n  update_task                           -> mutate tasks update\n  add_task_comment                      -> mutate task_comments create (parentId = taskId)\n  list_proposals / get_proposal         -> query proposals\n  list_recent_sessions / list_sessions  -> query session_context\n  log_session_context                   -> mutate session_context create\n  list_changelog                        -> query developer_changelog\n  search_knowledge_base                 -> query developer_knowledge_base (search = \"...\")\n  update_knowledge_base_entry           -> mutate developer_knowledge_base update\n  list_tenant_users / list_users        -> query iam_users (filters: status)\n  get_user                              -> query iam_users (id = \"...\")\n  lookup_product_repos                  -> query product_repos (filters: owner, repo)\n  summarise_product_tasks               -> query product_task_summary (parentId = productId)\n  list_unscored_pr_findings             -> query pr_review_findings (filters: repo, prNumber, scoredBy)\n\ncomplete_task still exists for the task done-state walk \u2014 only the plain field\nupdate moved to mutate. When in doubt, call describe_schema and match your\nintent to a resource.";
 //# sourceMappingURL=meta.d.ts.map

package/dist/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,stGAsDV,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,oxGAuDV,CAAC"}

package/dist/meta.js

@@ -9,7 +9,7 @@
  * it here removes that drift between the two transports.
  */
 export const SERVER_NAME = 'dainos';
-export const SERVER_VERSION = '0.17.0';
+export const SERVER_VERSION = '0.18.0';
 /**
  * Instructions advertised to MCP clients in the `initialize` response.
  *
@@ -49,6 +49,7 @@ Prefer the semantic tool whenever one matches your intent:
   Proposals  set_proposal_status · create_proposal_option · update_proposal_option
              set_recommended_option · proposal_content · describe_proposal_block_types
   Developer  log_changelog_entry · log_knowledge_base_entry · log_time_entry · score_pr_finding
+  AI spend   get_ai_spend_totals · get_ai_spend_summary
   Library    get_instruction · list_instructions · search_instructions · upsert_instruction
 
 These are all CURRENT. Do not translate them.

package/dist/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAsDb,CAAC"}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAuDb,CAAC"}

package/dist/tools/semantic/ai-usage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AI spend semantic tools — read-only views over the tenant's AI cost ledger.
+ *
+ * Two cost streams, two currencies, never summed:
+ *   - completion spend lives in app.ai_usage_logs and is reported in USD cents
+ *     (Anthropic bills in USD).
+ *   - embedding spend lives in app.embedding_costs and is reported in GBP
+ *     (the embedding writer converts at write time).
+ *
+ * Backed by the Express routes under /ai/usage (see ai-usage.routes.ts). The
+ * reads are gated only by the ai_assistant module and are tenant-scoped, so the
+ * PAT owner only ever sees their own tenant's spend.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const aiUsageSemanticTools: ToolDefinition[];
+//# sourceMappingURL=ai-usage.d.ts.map

package/dist/tools/semantic/ai-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.d.ts","sourceRoot":"","sources":["../../../src/tools/semantic/ai-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8ElD,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAGhD,CAAC"}

package/dist/tools/semantic/ai-usage.js

@@ -0,0 +1,77 @@
+/**
+ * AI spend semantic tools — read-only views over the tenant's AI cost ledger.
+ *
+ * Two cost streams, two currencies, never summed:
+ *   - completion spend lives in app.ai_usage_logs and is reported in USD cents
+ *     (Anthropic bills in USD).
+ *   - embedding spend lives in app.embedding_costs and is reported in GBP
+ *     (the embedding writer converts at write time).
+ *
+ * Backed by the Express routes under /ai/usage (see ai-usage.routes.ts). The
+ * reads are gated only by the ai_assistant module and are tenant-scoped, so the
+ * PAT owner only ever sees their own tenant's spend.
+ */
+import { z } from 'zod';
+// ── get_ai_spend_totals ──────────────────────────────────────────────
+const getAiSpendTotals = {
+    name: 'get_ai_spend_totals',
+    description: 'Headline AI spend for the current tenant: this calendar month, this ' +
+        'calendar quarter, and all-time. Returns BOTH cost streams: `completion` ' +
+        '(Otto/LLM calls, USD cents) and `embeddings` (RAG embedding calls, GBP). ' +
+        'The two are different currencies and must NOT be summed into one figure. ' +
+        'Present them separately. Use for "what are we spending on AI?".',
+    inputSchema: z.object({}),
+    handler: async (client) => {
+        const [completion, embeddings] = await Promise.all([
+            client.get('/ai/usage/totals'),
+            client.get('/ai/usage/embeddings/totals'),
+        ]);
+        return {
+            completion: { currency: 'USD_cents', ...completion },
+            embeddings: { currency: 'GBP', ...embeddings },
+            note: 'completion costs are USD cents; embedding costs are GBP. Do not sum across the two.',
+        };
+    },
+};
+// ── get_ai_spend_summary ─────────────────────────────────────────────
+const getAiSpendSummary = {
+    name: 'get_ai_spend_summary',
+    description: 'Aggregated AI spend broken down by a grouping key, for the current tenant. ' +
+        'Choose `source`: "completion" (Otto/LLM spend, USD cents, group by feature, ' +
+        'user, or model) or "embeddings" (RAG spend, GBP, group by provider, model, ' +
+        'or call_kind). Optional `from`/`to` ISO 8601 dates bound the window. Use for ' +
+        '"which feature costs the most?" or "AI spend by model last month".',
+    inputSchema: z.object({
+        source: z
+            .enum(['completion', 'embeddings'])
+            .default('completion')
+            .describe('"completion" = ai_usage_logs (USD cents); "embeddings" = embedding_costs (GBP).'),
+        groupBy: z
+            .string()
+            .optional()
+            .describe('Grouping key. completion: feature | user | model (default feature). ' +
+            'embeddings: provider | model | call_kind (default model).'),
+        from: z.string().optional().describe('ISO 8601 start of window (inclusive).'),
+        to: z.string().optional().describe('ISO 8601 end of window (inclusive).'),
+    }),
+    handler: async (client, input) => {
+        const params = new URLSearchParams();
+        if (input.groupBy)
+            params.set('groupBy', input.groupBy);
+        if (input.from)
+            params.set('from', input.from);
+        if (input.to)
+            params.set('to', input.to);
+        const qs = params.toString();
+        const suffix = qs ? `?${qs}` : '';
+        const path = input.source === 'embeddings'
+            ? `/ai/usage/embeddings/summary${suffix}`
+            : `/ai/usage/summary${suffix}`;
+        return client.get(path);
+    },
+};
+export const aiUsageSemanticTools = [
+    getAiSpendTotals,
+    getAiSpendSummary,
+];
+//# sourceMappingURL=ai-usage.js.map

package/dist/tools/semantic/ai-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.js","sourceRoot":"","sources":["../../../src/tools/semantic/ai-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,wEAAwE;AAExE,MAAM,gBAAgB,GAAmB;IACvC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,sEAAsE;QACtE,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,iEAAiE;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,MAAM,CAAC,GAAG,CAAc,kBAAkB,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAkB,6BAA6B,CAAC;SAC3D,CAAC,CAAC;QACH,OAAO;YACL,UAAU,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE;YACpD,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE;YAC9C,IAAI,EAAE,qFAAqF;SAC5F,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,iBAAiB,GAAmB;IACxC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,6EAA6E;QAC7E,8EAA8E;QAC9E,6EAA6E;QAC7E,+EAA+E;QAC/E,oEAAoE;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;aAClC,OAAO,CAAC,YAAY,CAAC;aACrB,QAAQ,CAAC,iFAAiF,CAAC;QAC9F,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sEAAsE;YACpE,2DAA2D,CAC9D;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC7E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC1E,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,KAAK,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,CAAC,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,KAAK,YAAY;YAC3B,CAAC,CAAC,+BAA+B,MAAM,EAAE;YACzC,CAAC,CAAC,oBAAoB,MAAM,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACpD,gBAAgB;IAChB,iBAAiB;CAClB,CAAC"}

package/dist/tools/semantic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,eAAO,MAAM,aAAa,EAAE,cAAc,EAMzC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,eAAO,MAAM,aAAa,EAAE,cAAc,EAOzC,CAAC"}

package/dist/tools/semantic/index.js

@@ -7,11 +7,13 @@ import { cadenceSemanticTools } from './cadence.js';
 import { proposalSemanticTools } from './proposals.js';
 import { proposalContentTools } from './proposal-content.js';
 import { developerSemanticTools } from './developer.js';
+import { aiUsageSemanticTools } from './ai-usage.js';
 export const semanticTools = [
     ...taskSemanticTools, // create_task, complete_task, regenerate_client_view
     ...cadenceSemanticTools, // claim_next_task, report_task_progress, mark_blocked, request_unblock
     ...proposalSemanticTools, // set_proposal_status, create/update_proposal_option, set_recommended_option
     ...proposalContentTools, // proposal_content (consolidated ops), describe_proposal_block_types
     ...developerSemanticTools, // log_changelog_entry, log_knowledge_base_entry, log_time_entry, score_pr_finding
+    ...aiUsageSemanticTools, // get_ai_spend_totals, get_ai_spend_summary
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/semantic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,GAAG,iBAAiB,EAAW,qDAAqD;IACpF,GAAG,oBAAoB,EAAQ,uEAAuE;IACtG,GAAG,qBAAqB,EAAO,6EAA6E;IAC5G,GAAG,oBAAoB,EAAQ,qEAAqE;IACpG,GAAG,sBAAsB,EAAM,kFAAkF;CAClH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,GAAG,iBAAiB,EAAW,qDAAqD;IACpF,GAAG,oBAAoB,EAAQ,uEAAuE;IACtG,GAAG,qBAAqB,EAAO,6EAA6E;IAC5G,GAAG,oBAAoB,EAAQ,qEAAqE;IACpG,GAAG,sBAAsB,EAAM,kFAAkF;IACjH,GAAG,oBAAoB,EAAQ,4CAA4C;CAC5E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dain-os/mcp-server",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "MCP server for DainOS — manage projects, tasks, proposals, and proposal content from Claude Code and other MCP clients",
   "type": "module",
   "bin": {