@oka-core/reason 0.2.0

package/dist/schemas.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+// ── Write Tool Inputs ──────────────────────────────────────────────
+export const RecordDecisionInput = z.object({
+    description: z.string().min(1),
+    rationale: z.string().min(1),
+    alternatives_considered: z.array(z.string()).default([]),
+    confidence: z.number().min(0).max(1),
+});
+export const RecordExplorationInput = z.object({
+    area: z.string().min(1),
+    findings: z.string().min(1),
+    relevance_score: z.number().min(0).max(1),
+});
+export const RecordDeviationInput = z.object({
+    planned_action: z.string().min(1),
+    actual_action: z.string().min(1),
+    reason: z.string().min(1),
+});
+export const RecordCompletionInput = z.object({
+    task_id: z.string().min(1),
+    outcome: z.enum(["success", "partial", "failed"]),
+    artifacts: z.array(z.string()).default([]),
+    quality_signals: z.record(z.string(), z.number()).default({}),
+});
+export const RecordObservationInput = z.object({
+    category: z.enum([
+        "architecture",
+        "bug_pattern",
+        "convention",
+        "performance",
+        "security",
+        "workflow",
+        "dependency",
+        "code_quality",
+        "other",
+    ]),
+    summary: z.string().min(1),
+    details: z.string().optional(),
+    confidence: z.number().min(0).max(1).default(0.7),
+    file_patterns: z.array(z.string()).default([]),
+    tags: z.array(z.string()).default([]),
+});
+// ── Read Tool Inputs ───────────────────────────────────────────────
+export const GetContextInput = z.object({
+    topic: z.string().min(1),
+    repo: z.string().optional(),
+    file_patterns: z.string().optional(),
+    limit: z.number().optional().default(10),
+    min_confidence: z.number().optional().default(0.3),
+});
+export const ListLearningsInput = z.object({
+    repo: z.string().optional(),
+    category: z
+        .enum([
+        "architecture",
+        "bug_pattern",
+        "convention",
+        "decision",
+        "performance",
+        "security",
+        "workflow",
+        "domain_knowledge",
+    ])
+        .optional(),
+    status: z
+        .enum(["active", "reinforced", "contradicted", "obsolete"])
+        .optional(),
+    min_confidence: z.number().optional(),
+    limit: z.number().optional().default(30),
+});
+export const GetDecisionsInput = z.object({
+    repo: z.string().min(1),
+    module: z.string().optional(),
+    timeframe: z.string().optional(),
+});
+export const GetPatternsInput = z.object({
+    repo: z.string().min(1),
+});
+export const SuggestPrioritiesInput = z.object({
+    repo: z.string().min(1),
+    backlog: z.array(z.string()).min(1),
+});
+// ── Response Types ─────────────────────────────────────────────────
+export const ReasoningEvent = z.object({
+    id: z.string(),
+    repo: z.string(),
+    agent_id: z.string(),
+    event_type: z.string(),
+    payload: z.record(z.string(), z.unknown()),
+    session_id: z.string(),
+    timestamp: z.string(),
+});
+export const Learning = z.object({
+    id: z.string(),
+    repo: z.string(),
+    summary: z.string(),
+    file_patterns: z.array(z.string()),
+    tags: z.array(z.string()),
+    confidence: z.number(),
+    created_at: z.string(),
+});
+export const QueryResult = (itemSchema) => z.object({
+    results: z.array(itemSchema),
+    confidence: z.number(),
+    source_count: z.number(),
+});

package/dist/tools/auth.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OkaClient } from "../client.js";
+/**
+ * Register auth tools on the MCP server.
+ */
+export declare function registerAuthTools(server: McpServer, client: OkaClient): void;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ9C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA8I5E"}

package/dist/tools/auth.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { deviceAuthLogin, loadStoredCredentials, resolveApiKey, resolveApiKeyWithRefresh, } from "../auth.js";
+/**
+ * Register auth tools on the MCP server.
+ */
+export function registerAuthTools(server, client) {
+    server.tool("login", "Authenticate with Oka platform via browser login (device auth flow). " +
+        "Opens your browser to id.oka.so, waits for you to log in, " +
+        "then stores the token locally at ~/.oka/credentials.json. " +
+        "Use this when API calls return 401 unauthorized.", {
+        auth_server_url: z
+            .string()
+            .optional()
+            .describe("Auth server URL (default: https://id.oka.so)"),
+        client_id: z
+            .string()
+            .optional()
+            .describe("OAuth client ID (default: oka-reason-mcp)"),
+    }, async (params) => {
+        // Check if we have a valid (non-expired) key
+        const existing = resolveApiKey();
+        if (existing) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Already authenticated. Credentials found via env or ~/.oka/credentials.json. To re-login, remove ~/.oka/credentials.json and try again.",
+                    },
+                ],
+            };
+        }
+        // Token might be expired — try refresh before opening browser
+        const stored = loadStoredCredentials();
+        if (stored?.refresh_token) {
+            const refreshed = await resolveApiKeyWithRefresh();
+            if (refreshed) {
+                client.updateApiKey(refreshed);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Token was expired but has been refreshed automatically. Credentials updated.",
+                        },
+                    ],
+                };
+            }
+        }
+        try {
+            const result = await deviceAuthLogin(params.auth_server_url, params.client_id);
+            if (result.success) {
+                // Reinitialize client with new credentials
+                client.updateApiKey(resolveApiKey());
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result.message,
+                        },
+                    ],
+                };
+            }
+            // Failed — give user the manual URL
+            const lines = [result.message];
+            if (result.verification_uri) {
+                lines.push(`\nManual URL: ${result.verification_uri}`);
+            }
+            if (result.user_code) {
+                lines.push(`Enter code: ${result.user_code}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Login error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("whoami", "Check current authentication status — whether the MCP server has valid credentials.", {}, async () => {
+        // First try sync resolution
+        let key = resolveApiKey();
+        // If no key found, try async refresh
+        if (!key) {
+            key = await resolveApiKeyWithRefresh();
+            if (key) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Authenticated (token was refreshed automatically). Key: ${maskKey(key)}`,
+                        },
+                    ],
+                };
+            }
+        }
+        if (key) {
+            const stored = loadStoredCredentials();
+            const expiryInfo = stored?.expires_at
+                ? ` | Expires: ${new Date(stored.expires_at * 1000).toISOString()}`
+                : "";
+            const hasRefresh = stored?.refresh_token
+                ? " | Auto-refresh: enabled"
+                : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Authenticated. Key: ${maskKey(key)}${expiryInfo}${hasRefresh}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Not authenticated. Use login to authenticate, or set OKA_API_KEY in your environment.",
+                },
+            ],
+        };
+    });
+}
+function maskKey(key) {
+    return key.length > 12 ? `${key.slice(0, 8)}...${key.slice(-4)}` : "***";
+}

package/dist/tools/read.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OkaClient } from "../client.js";
+/**
+ * Register read tools on the MCP server.
+ *
+ * Tools:
+ * - context — ranked learnings for a topic (flagship query)
+ * - learnings — browse institutional knowledge
+ * - decisions — decision log
+ * - patterns — recurring patterns
+ * - suggest — evidence-ranked priorities
+ * - backlog — agentic product backlog
+ * - priorities — evidence-ranked priorities from approved backlog
+ * - consolidate — manually trigger a consolidation run
+ */
+export declare function registerReadTools(server: McpServer, client: OkaClient): void;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +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"}