@kawacode/mcp 5.0.0

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/prompts/intent-first-workflow.d.ts

@@ -0,0 +1,24 @@
+export declare const intentFirstWorkflowPrompt: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    getPrompt: (args?: {
+        task_description?: string;
+    }) => string;
+};
+export declare const prompts: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    getPrompt: (args?: {
+        task_description?: string;
+    }) => string;
+}[];

package/build/prompts/intent-first-workflow.js

@@ -0,0 +1,204 @@
+export const intentFirstWorkflowPrompt = {
+    name: 'implementation_workflow',
+    description: 'Standard workflow for implementing code changes with intent tracking. Use this when starting any code implementation task.',
+    arguments: [
+        {
+            name: 'task_description',
+            description: 'Brief description of what the user wants to implement',
+            required: false
+        }
+    ],
+    getPrompt: (args) => {
+        const taskContext = args?.task_description
+            ? `\n\n**Current Task**: ${args.task_description}`
+            : '';
+        return `## AI Code Implementation Workflow${taskContext}
+
+When implementing code changes, follow the intent-aware workflow below. This workflow tracks your work, enables team visibility, and streamlines the commit process.
+
+### Task Complexity Triage
+
+Before using MCP tools, assess the task complexity. Match your workflow to the task — don't pay 2K tokens of overhead for a one-line fix.
+
+**Skip MCP entirely** — Single-file fixes, typos, adding a log line, renaming a variable, anything where the change is obvious from the prompt alone. Just write the code.
+
+**Lightweight** — Bug fixes, small features in 1-2 files, work in familiar code areas. Use only:
+
+| When | Action | Tool |
+|------|--------|------|
+| **Before coding** | Check for active intent (resume if exists) | \`check_active_intent\` |
+| **After edits** | Log what was done | \`log_work\` or \`assign_blocks_to_intent\` |
+
+**Full workflow** — Multi-file features, unfamiliar code areas, architectural decisions, cross-cutting changes, or work that may overlap with teammates. Use the complete lifecycle:
+
+| When | Action | Tool |
+|------|--------|------|
+| **After exploring request** | Get relevant context (with discovered files) | \`get_relevant_context\` |
+| **Before coding** | Check/create intent | \`check_active_intent\`, \`create_and_activate_intent\` |
+| **After each file edit** | Assign modified line ranges | \`assign_blocks_to_intent\` |
+| **On "done"/"commit"/"worked"/etc.** | Verify blocks → Git commit → Complete | \`get_intent_changes\`, \`complete_intent\` |
+
+**Trigger phrases for commit flow**: "this worked", "let's commit", "done", "close this", "ship it", "looks good"
+
+**Token-efficient context**: Call \`get_relevant_context\` **after initial exploration** of the user's request — once you know which files are involved. Pass both the prompt AND the \`activeFiles\` parameter with files you've discovered. This gives much better relevance matching than calling with just a vague prompt.
+
+### During Implementation
+
+- Write code as normal
+- Track which files and line ranges you modify (you'll need this for block assignment)
+- If you discover the scope is larger than expected, continue under the same intent
+- **Record decisions silently** as they occur (see "Recording Decisions" below)
+
+### Recording Decisions
+
+Record decisions silently using \`record_decision\` when you:
+
+| Trigger | Decision Type | Example |
+|---------|---------------|---------|
+| Choose between alternatives | \`fork\` | "Selected Rust over TypeScript for performance" |
+| Try an approach that fails | \`abandoned\` | "mongodb-memory-server rejected due to binary issues" |
+| Find unexpected limitation | \`discovery\` | "Unix socket paths limited to 104 chars on macOS" |
+| Identify hard requirement | \`constraint\` | "Must work offline per project requirements" |
+| Make explicit trade-off | \`tradeoff\` | "Chose simplicity over flexibility" |
+| Select library/dependency | \`dependency\` | "Using serde for JSON serialization" |
+| **Option violates constraint** | Include in \`constraintViolations\` | Document in \`record_decision\` |
+
+**Important**:
+- Record decisions silently - do not announce to the user that you're recording
+- Decisions made during **conversation** (planning, discussion) are just as important as implementation decisions
+- If you forget to record during work, catch them in the pre-commit review (see Commit Flow)
+- Decisions are reviewed before commit
+
+### Commit Prompt
+
+When you detect a context switch, prompt the user:
+
+> "You have uncommitted work on **'[intent title]'** ([N] files changed). This new request appears to be a different task. Would you like to:
+> 1. **Commit** the current work first, then start on the new task
+> 2. **Continue** - this is actually related to the current intent
+> 3. **Abandon** the current work without committing"
+
+Use \`get_intent_changes\` to get the file count and change summary for the prompt.
+
+### Commit Flow
+
+When the user chooses to commit (or explicitly requests it):
+
+1. **Get changes**: Call \`get_intent_changes\` to see modified files
+
+2. **Review conversation for missed decisions**: Analyze the conversation since the intent was created. Look for architectural decisions that were made but not yet recorded:
+   - **Alternatives discussed**: "Should we use X or Y?" → "Let's use X because..."
+   - **Rejected approaches**: "We can't do X because..." or "This won't work due to..."
+   - **Trade-offs made**: "The trade-off is..." or "We chose simplicity over performance"
+   - **Constraints discovered**: "We have to..." or "This is limited by..."
+   - **Dependencies selected**: "Let's use [library] for [purpose]"
+   - **Approach changes**: "Initially tried X, but switched to Y because..."
+
+   If you identify any architectural decisions that weren't recorded, call \`record_decision\` now.
+
+3. **Get decisions**: Call \`get_session_decisions\` to retrieve all decisions (including any just recorded)
+
+4. **Present review** (if decisions were recorded):
+   \`\`\`
+   Ready to commit "[intent title]" (N files changed)
+
+   Decision points recorded this session:
+   1. [fork] Chose approach A over B
+      └─ Rejected: "approach B" (violates zero-knowledge)
+   2. [discovery] Found socket path length limit
+
+   Include these in the intent record? [Yes] [Edit] [Skip]
+   \`\`\`
+5. **Assign blocks**: Call \`assign_blocks_to_intent\` with all modified file ranges
+6. **Git operations**:
+   \`\`\`bash
+   git add <files>
+   git commit -m "<intent title>
+
+   <intent description if meaningful>
+
+   Key decisions:
+   - <decision 1 summary>
+   - <decision 2 summary>
+
+   Intent-ID: <intent-id>
+   Co-Authored-By: Claude <noreply@anthropic.com>"
+   \`\`\`
+7. **Complete intent**: Call \`complete_intent\` with the commit SHA and status='committed'
+8. **Report**: Tell the user the commit SHA and that the intent is complete
+
+- If user had a new request that triggered the commit, proceed to create a new intent for it
+- If user explicitly said "we're done", the workflow ends
+
+| Scenario | Handling |
+|----------|----------|
+| User returns after long break with stale intent | Proactively mention: "You have an active intent '[title]' from [time ago]. Want to continue, commit, or abandon it?" |
+| Pre-existing uncommitted changes when creating intent | Note in \`get_intent_changes\` warnings; let user decide what to include |
+| Git commit fails | Report error, keep intent active, let user resolve |
+| User makes changes outside Claude | \`get_intent_changes\` shows all uncommitted changes; user decides what to commit |
+| Multiple small tasks in quick succession | Use judgment - if truly separate, prompt; if related, batch under one intent |
+
+### Retroactive Intent Assignment (Committing Pre-Existing Changes)
+
+When uncommitted changes exist that weren't made under an active intent (e.g., changes from a previous session, manual edits, or mixed work), use this workflow to infer intents and commit them in logical groups:
+
+#### Step 1: Analyze Changes
+- Run \`git diff --stat\` and read individual diffs to understand what each change does
+
+#### Step 2: Group by Intent
+- Identify logical groupings — changes that serve the same purpose belong together
+- Common grouping signals: same feature area, same service/module, related refactoring, shared motivation
+
+#### Step 3: Match to Existing Intents
+For each group:
+1. Call \`list_team_intents\` to get active intents for the repo
+2. Look for an existing intent whose title and description accurately describe the group's changes
+3. If a match exists, use it. If not, create a new intent or use \`log_work\` for trivial changes
+
+#### Step 4: Commit Each Group
+For each group:
+1. \`git add\` only the files belonging to this group
+2. \`git commit\` with a message reflecting the intent
+3. Call \`complete_intent\` with the commit SHA (if using an existing intent) or \`log_work\` (for trivial changes)
+
+#### Guidelines
+- **Prefer existing intents** when they accurately describe the changes — avoid creating duplicates
+- **Use \`log_work\`** for small standalone changes (doc updates, loading spinners, one-line fixes)
+- **Present the grouping plan** to the user before committing, so they can adjust
+- **Don't force-fit** — if changes don't match any existing intent, create a new one
+- **One intent per commit** — each commit should correspond to exactly one intent
+
+### MCP Tools Reference
+
+#### Context Tools
+
+| Tool | When to Use |
+|------|-------------|
+| \`get_relevant_context\` | **EACH USER REQUEST** - Returns context relevant to the specific prompt via semantic search (token-efficient for large projects) |
+
+#### Intent Tools
+
+| Tool | When to Use |
+|------|-------------|
+| \`check_active_intent\` | Before starting any code task |
+| \`create_and_activate_intent\` | When no active intent and user requests code changes |
+| \`get_intents_for_file\` | Before modifying files (check for team conflicts) |
+| \`get_intents_for_lines\` | Before modifying specific line ranges |
+| \`assign_blocks_to_intent\` | After writing code, before committing |
+| \`get_intent_changes\` | Before prompting about commit (to show change summary) |
+| \`complete_intent\` | After successful git commit, or to abandon |
+| \`list_team_intents\` | To see what teammates are working on |
+
+#### Decision Recording Tools
+
+| Tool | When to Use |
+|------|-------------|
+| \`record_decision\` | When making architectural decisions (silently, during work). Omit intentId for repo-scoped decisions (discoveries, constraints) |
+| \`get_session_decisions\` | Before commit, to review recorded decisions |
+| \`get_project_decisions\` | To see all decisions across all intents for the project |
+| \`edit_session_decision\` | To modify or delete a decision before commit |
+| \`detect_intent_conflicts\` | Before commit, to check for conflicts with team decisions |`;
+    }
+};
+export const prompts = [intentFirstWorkflowPrompt];
+//# sourceMappingURL=intent-first-workflow.js.map

package/build/prompts/intent-first-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-first-workflow.js","sourceRoot":"","sources":["../../src/prompts/intent-first-workflow.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,4HAA4H;IACzI,SAAS,EAAE;QACT;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,SAAS,EAAE,CAAC,IAAoC,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,IAAI,EAAE,gBAAgB;YACxC,CAAC,CAAC,yBAAyB,IAAI,CAAC,gBAAgB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAA;QAEN,OAAO,qCAAqC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAyLiC,CAAA;IAC1F,CAAC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,yBAAyB,CAAC,CAAA"}

package/build/resources/active-intent.d.ts

@@ -0,0 +1,9 @@
+export interface ActiveIntentResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export declare const activeIntentResource: ActiveIntentResource;
+export declare function readActiveIntentResource(repoOrigin?: string): Promise<string>;
+export declare const resources: ActiveIntentResource[];

package/build/resources/active-intent.js

@@ -0,0 +1,52 @@
+import { request, isConnected } from '../services/muninn-ipc.js';
+export const activeIntentResource = {
+    uri: 'kawa://intent/active',
+    name: 'Active Intent',
+    description: 'The currently active intent for the connected repository',
+    mimeType: 'application/json'
+};
+export async function readActiveIntentResource(repoOrigin) {
+    if (!isConnected()) {
+        return JSON.stringify({
+            hasActiveIntent: false,
+            note: 'Muninn is not running. Start Muninn to use intent tracking.'
+        }, null, 2);
+    }
+    try {
+        const res = await request('intent', 'get-active', {
+            repoOrigin: repoOrigin || '',
+        });
+        // Muninn returns { success, activeIntentId, activeIntent }
+        const intent = res.activeIntent;
+        if (!intent) {
+            return JSON.stringify({
+                hasActiveIntent: false,
+                repoOrigin: repoOrigin || undefined,
+                note: repoOrigin
+                    ? undefined
+                    : 'No active intent. Call check_active_intent with a repoOrigin.'
+            }, null, 2);
+        }
+        return JSON.stringify({
+            hasActiveIntent: true,
+            repoOrigin: intent.repoOrigin || repoOrigin,
+            intent: {
+                id: intent.id || '',
+                title: intent.title || '',
+                description: intent.description || '',
+                templateType: intent.templateType || 'feature',
+                status: intent.status || 'active',
+                constraints: intent.constraints || [],
+                blockCount: 0
+            }
+        }, null, 2);
+    }
+    catch {
+        return JSON.stringify({
+            hasActiveIntent: false,
+            note: 'Failed to query Muninn for active intent.'
+        }, null, 2);
+    }
+}
+export const resources = [activeIntentResource];
+//# sourceMappingURL=active-intent.js.map

package/build/resources/active-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-intent.js","sourceRoot":"","sources":["../../src/resources/active-intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAShE,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,GAAG,EAAE,sBAAsB;IAC3B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,0DAA0D;IACvE,QAAQ,EAAE,kBAAkB;CAC7B,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,UAAmB;IAChE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,6DAA6D;SACpE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACb,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE;YAChD,UAAU,EAAE,UAAU,IAAI,EAAE;SAC7B,CAAC,CAAA;QAEF,2DAA2D;QAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAA;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,eAAe,EAAE,KAAK;gBACtB,UAAU,EAAE,UAAU,IAAI,SAAS;gBACnC,IAAI,EAAE,UAAU;oBACd,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,+DAA+D;aACpE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACb,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,eAAe,EAAE,IAAI;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU;YAC3C,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;gBACrC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,SAAS;gBAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;gBACrC,UAAU,EAAE,CAAC;aACd;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,2CAA2C;SAClD,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,oBAAoB,CAAC,CAAA"}

package/build/services/active-intent-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * In-memory active intent tracking.
+ *
+ * Simple Map keyed by normalized origin. Replaces Muninn's per-repo
+ * active intent tracking. State lives only for the MCP server lifetime.
+ */
+import type { Intent } from './kawa-api.js';
+export interface ActiveIntent {
+    id: string;
+    title: string;
+    description: string;
+    templateType: string;
+    status: string;
+    constraints: string[];
+    blocks: Array<{
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        contentSnippet?: string;
+    }>;
+    branch?: string;
+    forkedFrom?: string;
+    createdAt?: string;
+}
+declare class ActiveIntentStore {
+    private store;
+    get(origin: string): ActiveIntent | null;
+    set(origin: string, intent: ActiveIntent): void;
+    clear(origin: string): void;
+    /** Return all active intents as [origin, intent] pairs */
+    getAll(): Array<[string, ActiveIntent]>;
+    /** Convert an API Intent to the ActiveIntent shape and store it */
+    setFromApiIntent(origin: string, apiIntent: Intent, cloudId: string): void;
+}
+export declare const activeIntentStore: ActiveIntentStore;
+export {};

package/build/services/active-intent-store.js

@@ -0,0 +1,45 @@
+/**
+ * In-memory active intent tracking.
+ *
+ * Simple Map keyed by normalized origin. Replaces Muninn's per-repo
+ * active intent tracking. State lives only for the MCP server lifetime.
+ */
+class ActiveIntentStore {
+    store = new Map();
+    get(origin) {
+        return this.store.get(origin) || null;
+    }
+    set(origin, intent) {
+        this.store.set(origin, intent);
+    }
+    clear(origin) {
+        this.store.delete(origin);
+    }
+    /** Return all active intents as [origin, intent] pairs */
+    getAll() {
+        return [...this.store.entries()];
+    }
+    /** Convert an API Intent to the ActiveIntent shape and store it */
+    setFromApiIntent(origin, apiIntent, cloudId) {
+        this.store.set(origin, {
+            id: cloudId || apiIntent._id || apiIntent.id || '',
+            title: apiIntent.title || '',
+            description: apiIntent.description || '',
+            templateType: apiIntent.templateType || 'feature',
+            status: apiIntent.status || 'active',
+            constraints: apiIntent.constraints || [],
+            blocks: (apiIntent.blocks || []).map(b => ({
+                filePath: b.filePath,
+                startLine: b.startLine,
+                endLine: b.endLine,
+                contentSnippet: b.contentSnippet,
+            })),
+            branch: apiIntent.branch,
+            forkedFrom: apiIntent.forkedFrom,
+            createdAt: apiIntent.createdAt,
+        });
+    }
+}
+// Singleton
+export const activeIntentStore = new ActiveIntentStore();
+//# sourceMappingURL=active-intent-store.js.map

package/build/services/active-intent-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-intent-store.js","sourceRoot":"","sources":["../../src/services/active-intent-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,iBAAiB;IACb,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE/C,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,MAAoB;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAED,0DAA0D;IAC1D,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,mEAAmE;IACnE,gBAAgB,CAAC,MAAc,EAAE,SAAiB,EAAE,OAAe;QACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;YACrB,EAAE,EAAE,OAAO,IAAI,SAAS,CAAC,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE;YAClD,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,EAAE;YAC5B,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,EAAE;YACxC,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,SAAS;YACjD,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,QAAQ;YACpC,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,EAAE;YACxC,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,cAAc,EAAE,CAAC,CAAC,cAAc;aACjC,CAAC,CAAC;YACH,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC,CAAA;IACJ,CAAC;CACF;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAA"}

package/build/services/kawa-api.d.ts

@@ -0,0 +1,131 @@
+/**
+ * HTTP client for the Kawa API.
+ *
+ * Replaces Muninn IPC — all data operations go directly to the REST API.
+ * Uses Node 18+ built-in fetch (no new dependencies).
+ *
+ * Config:
+ *   KAWA_API_URL   — defaults to https://api.codeawareness.com (set to http://localhost:3008 for local dev)
+ *   KAWA_AUTH_TOKEN — JWT bearer token (optional - auto-loaded from storage if not set)
+ *
+ * Auth token resolution order:
+ *   1. KAWA_AUTH_TOKEN environment variable
+ *   2. ~/.kawa-code/.storage.caw (decrypted using username+hostname)
+ */
+export interface Intent {
+    _id?: string;
+    id?: string;
+    title: string;
+    description: string;
+    templateType: string;
+    status?: string;
+    scope?: {
+        type: string;
+        paths: string[];
+    };
+    blocks?: IntentBlock[];
+    constraints?: string[];
+    branch?: string;
+    forkedFrom?: string;
+    encrypted?: boolean;
+    authorId?: string;
+    authorName?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface IntentBlock {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    contentHash?: string;
+    contentSnippet?: string;
+    codeContent?: string;
+}
+export interface IntentTranslation {
+    intentId: string;
+    lang: string;
+    title: string;
+    description: string;
+}
+export interface Decision {
+    decisionId: string;
+    intentId?: string;
+    authorId?: string;
+    timestamp?: string;
+    decisionType: string;
+    summary: string;
+    context?: string;
+    alternatives?: string[];
+    rationale: string;
+    consequences?: string;
+    relatedFiles?: string[];
+    supersedes?: string[];
+    constraintsChecked?: string[];
+    constraintViolations?: Array<{
+        alternative: string;
+        constraint: string;
+        reason: string;
+    }>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface CreateIntentParams {
+    origin: string;
+    lang?: string;
+    title: string;
+    description: string;
+    templateType?: string;
+    constraints?: string[];
+    scope?: {
+        type: string;
+        paths: string[];
+    };
+    blocks?: IntentBlock[];
+    branch?: string;
+    forkedFrom?: string;
+}
+export declare class KawaApi {
+    private baseUrl;
+    private authToken;
+    constructor(baseUrl?: string, authToken?: string);
+    /**
+     * Refresh the auth token from storage
+     *
+     * Call this periodically to pick up token refreshes from Muninn.
+     * Returns true if a new token was loaded.
+     */
+    refreshTokenFromStorage(): boolean;
+    /**
+     * Check if the client has an auth token
+     */
+    hasAuthToken(): boolean;
+    listIntents(origin: string, lang?: string, since?: string): Promise<Intent[]>;
+    createIntent(params: CreateIntentParams): Promise<{
+        intent: Intent;
+        cloudId: string;
+    }>;
+    getIntent(intentId: string, origin: string, lang?: string): Promise<Intent>;
+    updateIntent(intentId: string, origin: string, updates: Partial<Intent>): Promise<Intent>;
+    deleteIntent(intentId: string, origin: string): Promise<void>;
+    getIntentsByFile(origin: string, filePath: string): Promise<Intent[]>;
+    getIntentsByLines(origin: string, filePath: string, startLine: number, endLine: number): Promise<Intent[]>;
+    batchSaveIntents(origin: string, lang: string, intents: CreateIntentParams[]): Promise<any>;
+    saveIntentTranslation(intentId: string, origin: string, lang: string, title: string, description: string): Promise<any>;
+    getIntentTranslation(intentId: string, origin: string, lang: string): Promise<IntentTranslation | null>;
+    getTeamDecisions(origin: string, since?: string): Promise<Decision[]>;
+    getIntentDecisions(intentId: string, origin: string): Promise<Decision[]>;
+    syncDecisions(origin: string, intentId: string, decisions: Decision[]): Promise<any>;
+    deleteDecision(decisionId: string, origin: string): Promise<void>;
+    searchRelevantContext(origin: string, query: string, activeFiles?: string[], options?: {
+        maxIntents?: number;
+        maxDecisions?: number;
+        minScore?: number;
+    }): Promise<any>;
+    private get;
+    private post;
+    private patch;
+    private del;
+    getBaseUrl(): string;
+    private request;
+}
+export declare function getApi(): KawaApi;