@oka-core/reason 0.2.1 → 0.2.9

package/README.md

@@ -0,0 +1,59 @@
+# @oka-core/reason
+
+MCP server for institutional knowledge capture, consolidation, and retrieval.
+
+## Install
+
+```bash
+pnpm add @oka-core/reason
+```
+
+## Usage
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "reason": {
+      "command": "npx",
+      "args": ["-y", "@oka-core/reason"]
+    }
+  }
+}
+```
+
+## Tools
+
+### Write
+
+- **observe** — Record a learning or observation
+- **decision** — Record an architectural decision
+- **deviation** — Record a deviation from established patterns
+- **done** — Mark a task as complete with summary
+- **consolidate** — Trigger knowledge consolidation
+
+### Read
+
+- **explore** — Explore learnings by area
+- **context** — Get contextual knowledge for a task
+- **patterns** — Get recurring patterns
+- **learnings** — List recent learnings
+- **decisions** — List architectural decisions
+- **priorities** — Get current priorities
+- **suggest** — Get AI-powered suggestions
+- **backlog** — View AI-generated backlog items
+- **semantic_search** — Search by meaning using embeddings
+
+### Auth
+
+- **login** — Authenticate via browser
+- **whoami** — Check authentication status
+
+## Requirements
+
+- Node.js >= 20
+
+## License
+
+UNLICENSED

package/dist/client.js

@@ -187,7 +187,7 @@ export class OkaClient {
      * POST /api/reasoning/consolidate
      */
     async triggerConsolidation(req) {
-        return this.post("/api/reasoning/consolidate", req);
+        return this.post("/api/reasoning/consolidate", req, 120_000);
     }
     // ─── HTTP helpers ───────────────────────────────────────────────
     authHeaders() {
@@ -233,9 +233,9 @@ export class OkaClient {
             clearTimeout(timer);
         }
     }
-    async post(path, body) {
+    async post(path, body, timeout) {
         const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const timer = setTimeout(() => controller.abort(), timeout ?? this.timeout);
         try {
             const response = await fetch(`${this.apiUrl}${path}`, {
                 method: "POST",

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { OkaClient } from "./client.js";
@@ -8,9 +9,11 @@ import { registerAuthTools } from "./tools/auth.js";
 import { loadEnvFile } from "./auth.js";
 // Load .env from the project root (cwd), env vars take precedence
 loadEnvFile(process.cwd());
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 const server = new McpServer({
     name: "@oka-core/reason",
-    version: "0.3.0",
+    version,
 });
 // Client resolves credentials lazily on each request — no restart needed
 // after login or credential changes.

package/dist/tools/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,SAAS,EAGV,MAAM,cAAc,CAAC;AAoEtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2nB5E"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,SAAS,EAGV,MAAM,cAAc,CAAC;AAoEtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6nB5E"}

package/dist/tools/read.js

@@ -275,8 +275,7 @@ export function registerReadTools(server, client) {
     server.tool("suggest", "Get ranked task priorities based on accumulated reasoning", {
         repo: z.string().describe("Repository identifier"),
         backlog: z
-            .array(z.string())
-            .min(1)
+            .preprocess((v) => (typeof v === "string" ? JSON.parse(v) : v), z.array(z.string()).min(1))
             .describe("List of backlog items to prioritize"),
     }, async (params) => {
         try {

package/dist/tools/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAgJ7E"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAoK7E"}

package/dist/tools/write.js

@@ -19,7 +19,12 @@ export function registerWriteTools(server, client) {
     }, async (params) => {
         await client.ingest({ event_type: "decision", payload: params });
         return {
-            content: [{ type: "text", text: "Decision recorded." }],
+            content: [
+                {
+                    type: "text",
+                    text: `Decision recorded: ${params.description} (confidence: ${params.confidence})`,
+                },
+            ],
         };
     });
     server.tool("explore", "Record an area the agent explored and what was found", {
@@ -33,7 +38,12 @@ export function registerWriteTools(server, client) {
     }, async (params) => {
         await client.ingest({ event_type: "exploration", payload: params });
         return {
-            content: [{ type: "text", text: "Exploration recorded." }],
+            content: [
+                {
+                    type: "text",
+                    text: `Exploration recorded: ${params.area} (relevance: ${params.relevance_score})`,
+                },
+            ],
         };
     });
     server.tool("deviation", "Record when the agent deviated from the original plan", {
@@ -43,7 +53,12 @@ export function registerWriteTools(server, client) {
     }, async (params) => {
         await client.ingest({ event_type: "deviation", payload: params });
         return {
-            content: [{ type: "text", text: "Deviation recorded." }],
+            content: [
+                {
+                    type: "text",
+                    text: `Deviation recorded: planned "${params.planned_action}" → actual "${params.actual_action}"`,
+                },
+            ],
         };
     });
     server.tool("done", "Record task completion with outcome and quality signals", {
@@ -62,7 +77,12 @@ export function registerWriteTools(server, client) {
     }, async (params) => {
         await client.ingest({ event_type: "completion", payload: params });
         return {
-            content: [{ type: "text", text: "Completion recorded." }],
+            content: [
+                {
+                    type: "text",
+                    text: `Completion recorded: ${params.task_id} → ${params.outcome}`,
+                },
+            ],
         };
     });
     // ─── observe (general-purpose) ─────────────────────────────────

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oka-core/reason",
-  "version": "0.2.1",
-  "description": "MCP server for Oka Reason — institutional knowledge, semantic search, and consolidation",
+  "version": "0.2.9",
+  "description": "MCP server for institutional knowledge capture, semantic search, and consolidation",
   "private": false,
   "publishConfig": {
     "access": "restricted"
@@ -28,6 +28,15 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "echo 'lint ok'",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [
     "mcp",
     "reasoning",
@@ -41,6 +50,7 @@
     "url": "https://github.com/datacircuits/agentic.git",
     "directory": "packages/reason"
   },
+  "homepage": "https://reason.oka.so",
   "engines": {
     "node": ">=20"
   },
@@ -51,14 +61,6 @@
   "devDependencies": {
     "typescript": "^5.5.0",
     "vitest": "^2.0.0",
-    "@oka/typescript-config": "0.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "check-types": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "echo 'lint ok'",
-    "typecheck": "tsc --noEmit"
+    "@oka/typescript-config": "workspace:*"
   }
-}
+}