smritea-mcp 0.1.1

package/.eslintrc.json

@@ -0,0 +1,19 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "project": "./tsconfig.json",
+    "ecmaVersion": 2022
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "ignorePatterns": ["dist/**", "*.js"],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-non-null-assertion": "warn"
+  }
+}

package/.pre-commit-config.yaml

@@ -0,0 +1,30 @@
+# Pre-commit hooks for smritea-mcp
+#
+# Setup:
+#   pip install pre-commit && pre-commit install
+#
+# Usage:
+#   pre-commit run --all-files   # Run all hooks
+#   pre-commit run <hook-id>     # Run a specific hook
+#
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.4
+    hooks:
+      - id: gitleaks
+
+  - repo: local
+    hooks:
+      - id: mcp-lint
+        name: Lint
+        entry: make lint
+        language: system
+        files: ^src/.*\.ts$
+        pass_filenames: false
+
+      - id: mcp-build
+        name: Build
+        entry: make build
+        language: system
+        files: ^src/.*\.ts$
+        pass_filenames: false

package/Makefile

@@ -0,0 +1,20 @@
+.PHONY: lint typecheck build publish help
+
+help: ## Show available targets
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  %-20s %s\n", $$1, $$2}'
+
+lint: ## Type-check and lint smritea-mcp TypeScript
+	npm install --silent
+	npm run typecheck
+	npm run lint
+
+build: ## Compile TypeScript
+	rm -rf dist
+	npm install --silent
+	npm run build
+
+publish: build ## Build and publish smritea-mcp to npm (requires NPM_TOKEN env var)
+	@if [ -z "$$NPM_TOKEN" ]; then \
+		echo "ERROR: NPM_TOKEN environment variable is not set"; exit 1; \
+	fi
+	npm set "//registry.npmjs.org/:_authToken=$$NPM_TOKEN" && npm publish --access public

package/README.md

@@ -0,0 +1,214 @@
+# smritea-mcp
+
+MCP (Model Context Protocol) server for [smritea](https://smritea.ai) — gives AI assistants (Claude Code, Cursor, etc.) direct access to your smritea memory store.
+
+---
+
+## Installation
+
+### Step 1 — Run init
+
+```bash
+npx -y smritea-mcp init
+```
+
+This interactive wizard prompts for three values:
+
+```
+API base URL [https://api.smritea.ai]:
+```
+Press Enter to use the default (`https://api.smritea.ai`). If you are self-hosting smritea, enter your custom URL here.
+
+```
+API key:
+```
+Paste your smritea API key (required). You can find it in the smritea dashboard under API Keys.
+
+```
+Your name or user ID (used when you say "I prefer…", "I like…") [optional]:
+```
+Optional. If set, this value is automatically used as the `user_id` when you refer to yourself in conversation ("I prefer dark mode", "I like Python"), so memories about you are stored under a consistent ID without having to pass `user_id` explicitly every time.
+
+On success, credentials are saved to `~/.smritea/mcp-config.json`.
+
+### Step 2 — Register the server with your AI client
+
+**Claude Code** — add to `~/.claude.json` under the `mcpServers` key:
+
+```json
+{
+  "mcpServers": {
+    "smritea": {
+      "command": "npx",
+      "args": ["-y", "smritea-mcp", "serve"]
+    }
+  }
+}
+```
+
+### Step 3 — Set the active app (once per project)
+
+In a conversation with Claude Code, run:
+
+```
+Use the select_app tool with app_id "<your-app-id>"
+```
+
+This writes `.smritea/config.json` in your project directory (automatically gitignored) so all memory operations in that project are scoped to the correct app.
+
+---
+
+## Configuration
+
+smritea-mcp uses a two-tier config system.
+
+### User-scoped (`~/.smritea/mcp-config.json`)
+
+Created once by `npx smritea-mcp init`. Stores credentials shared across all projects.
+
+```json
+{
+  "api_key": "sk-...",
+  "base_url": "https://api.smritea.ai",
+  "first_person_user_id": "alice"
+}
+```
+
+`first_person_user_id` is optional. When set, it is automatically used as `user_id` for memory operations where the user refers to themselves ("I prefer…", "I like…") without explicitly passing a `user_id`.
+
+### Project-scoped (`.smritea/config.json`)
+
+Created per-project by the `select_app` tool. Determines which smritea app receives memory operations in this project. Automatically gitignored.
+
+```json
+{
+  "app_id": "app_abc123",
+  "app_name": "My App"
+}
+```
+
+### Environment variable overrides
+
+| Variable | Overrides |
+|----------|-----------|
+| `SMRITEA_API_KEY` | `api_key` in user config |
+| `SMRITEA_BASE_URL` | `base_url` in user config |
+| `SMRITEA_APP_ID` | `app_id` in project config |
+| `SMRITEA_FIRST_PERSON_USER_ID` | `first_person_user_id` in user config |
+
+---
+
+## Tools
+
+### `select_app`
+
+Set the active smritea app for the current project. All subsequent memory operations in this project will use the specified app.
+
+Writes `.smritea/config.json` in the current working directory and creates `.smritea/.gitignore` so the config is never accidentally committed.
+
+**Parameters**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `app_id` | string | Yes | The smritea app ID (e.g. `app_abc123`) |
+| `app_name` | string | No | Optional display name for the app |
+
+**Example**
+
+```
+Use the select_app tool with app_id "app_abc123" and app_name "My Project"
+```
+
+---
+
+### `list_apps`
+
+Show the currently active app for this project.
+
+> **Note**: Listing all apps via API key auth is not yet available. API keys are scoped to a single app. Use `select_app` to switch apps.
+
+**Parameters**: none
+
+---
+
+### `add_memory`
+
+Add a new memory to the active smritea app.
+
+**Parameters**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `content` | string | Yes | The memory content to store |
+| `user_id` | string | No | User ID to associate with this memory |
+| `metadata` | object | No | Optional key-value metadata |
+
+**Example**
+
+```
+Add a memory: "User prefers dark mode and uses vim keybindings" for user_id "alice"
+```
+
+---
+
+### `search_memories`
+
+Search for memories semantically. Returns results ranked by relevance score.
+
+**Parameters**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | string | Yes | Natural language search query |
+| `user_id` | string | No | Filter results to a specific user |
+| `limit` | number | No | Maximum number of results to return |
+| `method` | string | No | Search method: `quick_search`, `deep_search`, `context_aware_search` |
+| `threshold` | number | No | Minimum relevance score (0.0–1.0) |
+| `graph_depth` | number | No | Graph traversal depth override |
+| `conversation_id` | string | No | Filter to a specific conversation |
+
+**Example**
+
+```
+Search memories for "editor preferences" for user_id "alice", limit 5
+```
+
+---
+
+### `get_memory`
+
+Retrieve a single memory by its ID.
+
+**Parameters**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `memory_id` | string | Yes | The memory ID (e.g. `mem_abc123`) |
+
+---
+
+### `delete_memory`
+
+Delete a memory by its ID. This action is irreversible.
+
+**Parameters**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `memory_id` | string | Yes | The memory ID to delete |
+
+---
+
+## How it works
+
+smritea-mcp is a TypeScript MCP server using `stdio` transport. It wraps the [smritea TypeScript SDK](https://github.com/SmrutAI/smritea-sdk) and exposes memory operations as MCP tools.
+
+All JSON-RPC communication flows over stdout. All logging goes to stderr so it never interferes with the MCP protocol stream.
+
+```
+AI assistant (Claude Code / Cursor)
+    ↕ JSON-RPC over stdio
+smritea-mcp (this server)
+    ↕ HTTPS
+smritea TypeScript SDK  →  smritea Cloud API
+```

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+export interface UserConfig {
+    api_key: string;
+    base_url: string;
+    first_person_user_id?: string;
+}
+export interface ProjectConfig {
+    app_id: string;
+    app_name?: string;
+}
+export interface ResolvedConfig {
+    apiKey: string;
+    baseUrl: string;
+    appId: string;
+    /** Used as user_id when the user refers to themselves ("I prefer…", "I like…"). */
+    firstPersonUserId?: string;
+}
+export declare function loadConfig(): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAWD,wBAAgB,UAAU,IAAI,cAAc,CAyB3C"}

package/dist/config.js

@@ -0,0 +1,40 @@
+/**
+ * Two-tier configuration for smritea-mcp.
+ *
+ * User-scoped  (~/.smritea/mcp-config.json): api_key, base_url
+ * Project-scoped (.smritea/config.json):     app_id, app_name
+ *
+ * Environment variable overrides:
+ *   SMRITEA_API_KEY, SMRITEA_BASE_URL, SMRITEA_APP_ID
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const USER_CONFIG_PATH = join(homedir(), '.smritea', 'mcp-config.json');
+const PROJECT_CONFIG_PATH = join(process.cwd(), '.smritea', 'config.json');
+function readJsonFile(path) {
+    if (!existsSync(path))
+        return null;
+    const raw = readFileSync(path, 'utf-8');
+    return JSON.parse(raw);
+}
+export function loadConfig() {
+    const user = readJsonFile(USER_CONFIG_PATH);
+    const project = readJsonFile(PROJECT_CONFIG_PATH);
+    const apiKey = process.env['SMRITEA_API_KEY'] ?? user?.api_key;
+    const baseUrl = process.env['SMRITEA_BASE_URL'] ?? user?.base_url ?? 'https://api.smritea.ai';
+    const appId = process.env['SMRITEA_APP_ID'] ?? project?.app_id;
+    const firstPersonUserId = process.env['SMRITEA_FIRST_PERSON_USER_ID'] ?? user?.first_person_user_id;
+    if (!apiKey) {
+        throw new Error('smritea API key not configured. Run: npx smritea-mcp init\n' +
+            `Or set SMRITEA_API_KEY env var.\n` +
+            `Config file expected at: ${USER_CONFIG_PATH}`);
+    }
+    if (!appId) {
+        throw new Error('smritea app ID not configured. Run: npx smritea-mcp select-app <app_id>\n' +
+            `Or set SMRITEA_APP_ID env var.\n` +
+            `Config file expected at: ${PROJECT_CONFIG_PATH}`);
+    }
+    return { apiKey, baseUrl, appId, firstPersonUserId };
+}
+//# sourceMappingURL=config.js.map

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class McpConfigError extends Error {
+    constructor(message: string);
+}
+export declare class McpToolError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,YAAa,SAAQ,KAAK;aACQ,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAK7D"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+export class McpConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'McpConfigError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class McpToolError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'McpToolError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { startServer } from './server.js';
+import { createInterface } from 'node:readline/promises';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+async function runInit() {
+    const configDir = join(homedir(), '.smritea');
+    const configPath = join(configDir, 'mcp-config.json');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const baseUrlAnswer = await rl.question('API base URL [https://api.smritea.ai]: ');
+        const baseUrl = baseUrlAnswer.trim() || 'https://api.smritea.ai';
+        const apiKeyAnswer = await rl.question('API key: ');
+        const apiKey = apiKeyAnswer.trim();
+        if (!apiKey) {
+            console.error('Error: API key is required.');
+            process.exit(1);
+        }
+        const firstPersonUserIdAnswer = await rl.question('Your name or user ID (used when you say "I prefer…", "I like…") [optional]: ');
+        const firstPersonUserId = firstPersonUserIdAnswer.trim() || undefined;
+        mkdirSync(configDir, { recursive: true });
+        const configData = { api_key: apiKey, base_url: baseUrl };
+        if (firstPersonUserId !== undefined) {
+            configData['first_person_user_id'] = firstPersonUserId;
+        }
+        writeFileSync(configPath, JSON.stringify(configData, null, 2) + '\n');
+        console.error('✓ Config saved to ' + configPath);
+        if (firstPersonUserId !== undefined) {
+            console.error(`✓ First-person user ID set to: ${firstPersonUserId}`);
+        }
+        console.error('Next: use the select_app tool in your AI assistant to set an app ID.');
+    }
+    finally {
+        rl.close();
+    }
+}
+const subcommand = process.argv[2];
+if (subcommand === 'serve' || subcommand === undefined) {
+    startServer().catch((err) => {
+        console.error('Fatal:', err);
+        process.exit(1);
+    });
+}
+else if (subcommand === 'init') {
+    runInit().catch((err) => {
+        console.error('Init failed:', err);
+        process.exit(1);
+    });
+}
+else {
+    console.error(`Unknown subcommand: ${subcommand}`);
+    console.error('Usage: smritea-mcp [serve|init]');
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAcA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwGjD"}

package/dist/server.js

@@ -0,0 +1,63 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { SmriteaClient } from 'smritea-sdk';
+import { loadConfig } from './config.js';
+import { AddMemoryInput, SearchMemoriesInput, GetMemoryInput, DeleteMemoryInput, SelectAppInput } from './types.js';
+import { handleAddMemory, handleSearchMemories, handleGetMemory, handleDeleteMemory, } from './tools/memory.js';
+import { handleSelectApp, handleListApps } from './tools/app.js';
+export async function startServer() {
+    const config = loadConfig();
+    const client = new SmriteaClient({
+        apiKey: config.apiKey,
+        appId: config.appId,
+        baseUrl: config.baseUrl,
+    });
+    const server = new McpServer({ name: 'smritea', version: '0.1.0' }, {
+        instructions: 'smritea is a persistent AI memory system. Use it to remember facts, preferences, ' +
+            'decisions, and context across conversations. Proactively store anything the user tells ' +
+            'you that they would want recalled later. Before starting work on a task, search memories ' +
+            'to surface relevant context the user may not have re-stated. When the user says "remember" ' +
+            'or "don\'t forget", always call add_memory immediately.',
+    });
+    const firstPersonUserId = config.firstPersonUserId;
+    server.tool('add_memory', 'Store a memory in smritea. Call this whenever the user shares a preference, decision, fact ' +
+        'about themselves, or anything they would want recalled in a future conversation. Do not wait ' +
+        'to be asked — if the user says "I prefer X", "my X is Y", "remember that", or "don\'t forget", ' +
+        'call this immediately. If the user says "I" or refers to themselves, omit user_id — it is ' +
+        'automatically set to the configured default.', AddMemoryInput.shape, async (input) => handleAddMemory(client, AddMemoryInput.parse(input), firstPersonUserId));
+    server.tool('search_memories', 'Search smritea memories by natural language query. Call this at the start of a new task or ' +
+        'topic to surface relevant context — user preferences, past decisions, stated constraints — ' +
+        'without waiting for the user to re-explain them. Also call when the user asks "do you remember", ' +
+        '"what do you know about", or "remind me". Omit user_id when searching for the current user\'s ' +
+        'own memories — it defaults to the configured user automatically.', SearchMemoriesInput.shape, async (input) => handleSearchMemories(client, SearchMemoriesInput.parse(input), firstPersonUserId));
+    server.tool('get_memory', 'Retrieve a specific memory by its ID. Use when you already have a memory_id from a previous ' +
+        'search result and need the full memory object.', GetMemoryInput.shape, async (input) => handleGetMemory(client, GetMemoryInput.parse(input)));
+    server.tool('delete_memory', 'Permanently delete a memory by its ID. Use when the user explicitly asks to forget something ' +
+        'or says a stored fact is no longer true. This action is irreversible — confirm the memory_id ' +
+        'from a search result before deleting.', DeleteMemoryInput.shape, async (input) => handleDeleteMemory(client, DeleteMemoryInput.parse(input)));
+    server.tool('select_app', 'Set the active smritea app for this project. Writes a project-scoped config to ' +
+        '.smritea/config.json so all subsequent memory operations use this app. Call this once ' +
+        'when setting up smritea in a new project.', SelectAppInput.shape, (input) => handleSelectApp(SelectAppInput.parse(input)));
+    server.tool('list_apps', 'Show the currently configured smritea app for this project. Useful for confirming which ' +
+        'app memories are being stored under.', {}, () => handleListApps(config));
+    server.prompt('recall', 'Search your smritea memories and surface everything relevant to the current topic or task. ' +
+        'Use this at the start of a conversation or when switching context.', { topic: z.string().describe('The topic, task, or question to search memories for') }, ({ topic }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Search my smritea memories for everything relevant to: "${topic}"\n\n` +
+                        'Retrieve the most relevant results and summarise what you find before we continue. ' +
+                        'If you find preferences, constraints, or past decisions related to this topic, ' +
+                        'apply them proactively without waiting for me to re-state them.',
+                },
+            },
+        ],
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('smritea MCP server running (stdio)');
+}
+//# sourceMappingURL=server.js.map

package/dist/tools/app.d.ts

@@ -0,0 +1,15 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { SelectAppInput } from '../types.js';
+import type { ResolvedConfig } from '../config.js';
+export declare function handleSelectApp(input: SelectAppInput): CallToolResult;
+/**
+ * list_apps — stub.
+ *
+ * Listing apps via API key is not yet supported by the smritea SDK API.
+ * API key auth is scoped to a single app; a dedicated /api/v1/sdk/apps
+ * endpoint is needed before this can enumerate all apps for an organisation.
+ *
+ * For now, returns the currently active app from config.
+ */
+export declare function handleListApps(config: ResolvedConfig): CallToolResult;
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/tools/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAuBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAcrE"}

package/dist/tools/app.js

@@ -0,0 +1,51 @@
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const SMRITEA_DIR = join(process.cwd(), '.smritea');
+const CONFIG_PATH = join(SMRITEA_DIR, 'config.json');
+const GITIGNORE_PATH = join(SMRITEA_DIR, '.gitignore');
+export function handleSelectApp(input) {
+    mkdirSync(SMRITEA_DIR, { recursive: true });
+    const config = { app_id: input.app_id };
+    if (input.app_name !== undefined) {
+        config.app_name = input.app_name;
+    }
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    // Prevent committing the project-scoped config — it is machine/project-local
+    if (!existsSync(GITIGNORE_PATH)) {
+        writeFileSync(GITIGNORE_PATH, 'config.json\n', 'utf-8');
+    }
+    const name = input.app_name !== undefined ? ` (${input.app_name})` : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `App selected: ${input.app_id}${name}\nConfig written to: ${CONFIG_PATH}\nAll memory operations in this project will now use this app.`,
+            },
+        ],
+    };
+}
+/**
+ * list_apps — stub.
+ *
+ * Listing apps via API key is not yet supported by the smritea SDK API.
+ * API key auth is scoped to a single app; a dedicated /api/v1/sdk/apps
+ * endpoint is needed before this can enumerate all apps for an organisation.
+ *
+ * For now, returns the currently active app from config.
+ */
+export function handleListApps(config) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Currently active app: ${config.appId}`,
+                    '',
+                    'Note: listing all apps is not yet available via API key auth.',
+                    'To switch apps, use the select_app tool with the desired app ID.',
+                ].join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/tools/memory.d.ts

@@ -0,0 +1,12 @@
+import { SmriteaClient } from 'smritea-sdk';
+import type { Memory, SearchResult } from 'smritea-sdk';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AddMemoryInput, SearchMemoriesInput, GetMemoryInput, DeleteMemoryInput } from '../types.js';
+export declare function formatMemory(memory: Memory): string;
+export declare function formatSearchResult(result: SearchResult): string;
+export declare function formatError(err: unknown): string;
+export declare function handleAddMemory(client: SmriteaClient, input: AddMemoryInput, firstPersonUserId?: string): Promise<CallToolResult>;
+export declare function handleSearchMemories(client: SmriteaClient, input: SearchMemoriesInput, firstPersonUserId?: string): Promise<CallToolResult>;
+export declare function handleGetMemory(client: SmriteaClient, input: GetMemoryInput): Promise<CallToolResult>;
+export declare function handleDeleteMemory(client: SmriteaClient, input: DeleteMemoryInput): Promise<CallToolResult>;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuC,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1G,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQhD;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,cAAc,EACrB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,mBAAmB,EAC1B,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,cAAc,CAAC,CA4BzB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC,CASzB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,cAAc,CAAC,CASzB"}