goto-assistant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Lau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# goto-assistant
+
+Lightweight, self-hosted AI assistant with first-class MCP support. Supports both Claude (Anthropic) and OpenAI as providers, with a web-based chat interface.
+
+## Quick Start
+
+```bash
+npx goto-assistant
+```
+
+Open http://localhost:3000 — first run redirects to setup page for API key config.
+
+### Requirements
+- Node.js 20.11 or later
+- Anthropic or OpenAI API key
+
+### Data Storage
+All data (config, conversations, uploads) stored in `~/.goto-assistant/`.
+Custom location: `GOTO_DATA_DIR=/path/to/data npx goto-assistant`
+
+### Custom Port
+```bash
+PORT=3001 npx goto-assistant
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  Browser                                                │
+│  ┌──────────────┐  ┌──────────────┐                     │
+│  │  index.html   │  │  setup.html  │                     │
+│  │  (Chat UI)    │  │  (Config)    │                     │
+│  └──────┬───────┘  └──────┬───────┘                     │
+│         │ WebSocket        │ HTTP POST                   │
+└─────────┼──────────────────┼────────────────────────────┘
+          │                  │
+┌─────────┼──────────────────┼────────────────────────────┐
+│  server.ts                 │                             │
+│  ┌──────┴───────┐  ┌──────┴───────┐                     │
+│  │  WebSocket    │  │  REST API    │                     │
+│  │  Handler      │  │  /api/*      │                     │
+│  └──────┬───────┘  └──────────────┘                     │
+│         │                                                │
+│  ┌──────┴───────┐                                        │
+│  │  router.ts    │──── routes by provider                │
+│  └──┬────────┬──┘                                        │
+│     │        │                                           │
+│  ┌──┴──┐  ┌──┴───┐     ┌────────────┐                   │
+│  │Claude│  │OpenAI│────▶│ MCP Servers │                   │
+│  │Agent │  │Agent │     │ (memory,    │                   │
+│  │ SDK  │  │ SDK  │     │  fs, cron)  │                   │
+│  └──┬──┘  └──┬───┘     └────────────┘                   │
+│     │        │                                           │
+│  ┌──┴────────┴──┐     ┌────────────┐                     │
+│  │  sessions.ts  │────▶│  SQLite DB  │                    │
+│  │  (persistence)│     │  data/      │                    │
+│  └──────────────┘     └────────────┘                     │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Development Setup
+
+1. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+2. Start the development server:
+   ```bash
+   pnpm dev
+   ```
+
+3. Open `http://localhost:3000` — you'll be redirected to the setup page on first run to configure your AI provider and API key.
+
+## Configuration
+
+App configuration is stored in `data/config.json` (created on first setup). MCP server configuration is stored separately in `data/mcp.json`. Environment variables override file config:
+
+- `ANTHROPIC_API_KEY` — API key for Claude
+- `OPENAI_API_KEY` — API key for OpenAI
+
+## MCP Servers
+
+The assistant comes pre-configured with these MCP servers:
+
+| Server | Package | Capabilities |
+|--------|---------|-------------|
+| **memory** | [`@modelcontextprotocol/server-memory`](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) | Persistent knowledge graph across conversations |
+| **filesystem** | [`@modelcontextprotocol/server-filesystem`](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem) | Read, write, and manage local files |
+| **cron** | [`mcp-cron`](https://github.com/jolks/mcp-cron) | Schedule shell commands and AI prompts with access to MCP servers |
+
+Add your own through the setup page or by editing `data/mcp.json` directly. Any MCP server that supports stdio transport will work — browse the [MCP server directory](https://github.com/modelcontextprotocol/servers) for more.
+
+### Claude Code MCP servers
+
+If you use [Claude Code](https://claude.ai/code), copy the example config to get MCP servers for development:
+
+```bash
+cp .mcp.json.example .mcp.json
+```
+
+Edit `.mcp.json` to set your preferred AI provider/model for the cron server. This file is gitignored since it contains personal preferences.
+
+## Development
+
+```bash
+pnpm dev          # run with tsx (hot TypeScript execution)
+pnpm build        # compile TypeScript to dist/
+pnpm start        # run compiled build
+pnpm test         # run tests
+pnpm test:watch   # run tests in watch mode
+```

package/bin/goto-assistant.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+if (!process.env.GOTO_DATA_DIR) {
+  process.env.GOTO_DATA_DIR = join(homedir(), ".goto-assistant");
+}
+
+await import("../dist/index.js");

package/dist/agents/claude.d.ts

@@ -0,0 +1,7 @@
+import type { Config, McpServerConfig } from "../config.js";
+import type { Attachment } from "./router.js";
+export interface AgentResponse {
+    sessionId: string | null;
+    conversationId: string;
+}
+export declare function runClaude(prompt: string, config: Config, mcpServersConfig: Record<string, McpServerConfig>, onChunk: (text: string) => void, resumeSessionId?: string, attachments?: Attachment[]): Promise<AgentResponse>;

package/dist/agents/claude.js

@@ -0,0 +1,75 @@
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { MEMORY_FILE_PATH, MEMORY_SERVER_NAME } from "../config.js";
+export async function runClaude(prompt, config, mcpServersConfig, onChunk, resumeSessionId, attachments) {
+    const env = {
+        ...process.env,
+        ANTHROPIC_API_KEY: config.claude.apiKey,
+    };
+    if (config.claude.baseUrl) {
+        env.ANTHROPIC_BASE_URL = config.claude.baseUrl;
+    }
+    // Build MCP servers config with their env vars
+    const mcpServers = {};
+    for (const [name, server] of Object.entries(mcpServersConfig)) {
+        const serverEnv = { ...env, ...server.env };
+        if (name === MEMORY_SERVER_NAME) {
+            serverEnv.MEMORY_FILE_PATH = MEMORY_FILE_PATH;
+        }
+        mcpServers[name] = {
+            command: server.command,
+            args: server.args,
+            env: serverEnv,
+        };
+    }
+    const options = {
+        model: config.claude.model,
+        mcpServers,
+        permissionMode: "bypassPermissions",
+        allowDangerouslySkipPermissions: true,
+        allowedTools: Object.keys(mcpServersConfig).map((name) => `mcp__${name}__*`),
+        systemPrompt: "You are a helpful personal AI assistant. You have access to MCP tools for memory, filesystem, browser automation, and scheduled tasks. Use them when appropriate. IMPORTANT: At the start of each conversation, you MUST call the memory read_graph tool to retrieve all known context about the user before responding to their first message.",
+        env,
+        maxTurns: 30,
+    };
+    if (resumeSessionId) {
+        options.resume = resumeSessionId;
+    }
+    // When attachments are present, reference file paths in the prompt so Claude
+    // can read them via the filesystem MCP server's read_media_file tool.
+    // The query() function only accepts a plain string prompt.
+    let queryPrompt = prompt;
+    if (attachments && attachments.length > 0) {
+        const paths = attachments
+            .filter((att) => att.filePath)
+            .map((att) => att.filePath);
+        if (paths.length > 0) {
+            queryPrompt = `${prompt}\n\n[The user attached ${paths.length} image(s). Read them using the filesystem read_media_file tool to see the content:\n${paths.join("\n")}]`;
+        }
+    }
+    let sessionId = null;
+    const result = query({ prompt: queryPrompt, options });
+    for await (const message of result) {
+        if (message.type === "system" && message.subtype === "init") {
+            sessionId = message.session_id ?? null;
+        }
+        if (message.type === "assistant") {
+            const content = message.content;
+            if (content) {
+                for (const block of content) {
+                    if (block.type === "text" && block.text) {
+                        onChunk(block.text);
+                    }
+                }
+            }
+        }
+        if (message.type === "result" && message.subtype === "success") {
+            const resultMsg = message;
+            sessionId = resultMsg.session_id ?? sessionId;
+            if (resultMsg.result) {
+                onChunk(resultMsg.result);
+            }
+        }
+    }
+    return { sessionId, conversationId: "" };
+}
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAQpE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAc,EACd,MAAc,EACd,gBAAiD,EACjD,OAA+B,EAC/B,eAAwB,EACxB,WAA0B;IAE1B,MAAM,GAAG,GAA2B;QAClC,GAAG,OAAO,CAAC,GAA6B;QACxC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;KACxC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IACjD,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAoC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAA2B,EAAE,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACpE,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAChC,SAAS,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAChD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,SAAS;SACf,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAA4B;QACvC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;QAC1B,UAAU;QACV,cAAc,EAAE,mBAAmB;QACnC,+BAA+B,EAAE,IAAI;QACrC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC5E,YAAY,EAAE,iVAAiV;QAC/V,GAAG;QACH,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC;IACnC,CAAC;IAED,6EAA6E;IAC7E,sEAAsE;IACtE,2DAA2D;IAC3D,IAAI,WAAW,GAAG,MAAM,CAAC;IACzB,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,WAAW;aACtB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;aAC7B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,WAAW,GAAG,GAAG,MAAM,0BAA0B,KAAK,CAAC,MAAM,uFAAuF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1K,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAEvD,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC5D,SAAS,GAAI,OAAmC,CAAC,UAAU,IAAI,IAAI,CAAC;QACtE,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,OAAO,GAAI,OAAgE,CAAC,OAAO,CAAC;YAC1F,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACxC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/D,MAAM,SAAS,GAAG,OAAmD,CAAC;YACtE,SAAS,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC;YAC9C,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AAC3C,CAAC"}

package/dist/agents/openai.d.ts

@@ -0,0 +1,3 @@
+import type { Config, McpServerConfig } from "../config.js";
+import type { Attachment, HistoryMessage } from "./router.js";
+export declare function runOpenAI(prompt: string, config: Config, mcpServersConfig: Record<string, McpServerConfig>, onChunk: (text: string) => void, attachments?: Attachment[], history?: HistoryMessage[]): Promise<void>;

package/dist/agents/openai.js

@@ -0,0 +1,109 @@
+import { Agent, run, MCPServerStdio } from "@openai/agents";
+import { MEMORY_FILE_PATH, MEMORY_SERVER_NAME } from "../config.js";
+import { parseMessageContent } from "../sessions.js";
+import { getUpload } from "../uploads.js";
+export async function runOpenAI(prompt, config, mcpServersConfig, onChunk, attachments, history) {
+    const env = {
+        ...process.env,
+        OPENAI_API_KEY: config.openai.apiKey,
+    };
+    if (config.openai.baseUrl) {
+        env.OPENAI_BASE_URL = config.openai.baseUrl;
+    }
+    // Set up MCP stdio servers
+    const mcpServers = [];
+    for (const [name, server] of Object.entries(mcpServersConfig)) {
+        const serverEnv = { ...env, ...server.env };
+        if (name === MEMORY_SERVER_NAME) {
+            serverEnv.MEMORY_FILE_PATH = MEMORY_FILE_PATH;
+        }
+        mcpServers.push(new MCPServerStdio({
+            name,
+            fullCommand: `${server.command} ${server.args.join(" ")}`,
+            env: serverEnv,
+        }));
+    }
+    try {
+        // Connect all MCP servers
+        for (const server of mcpServers) {
+            await server.connect();
+        }
+        const agent = new Agent({
+            name: "goto-assistant",
+            instructions: "You are a helpful personal AI assistant. You have access to MCP tools for memory, filesystem, browser automation, and scheduled tasks. Use them when appropriate. IMPORTANT: At the start of each conversation, you MUST call the memory read_graph tool to retrieve all known context about the user before responding to their first message.",
+            model: config.openai.model,
+            mcpServers,
+        });
+        // Build conversation input with history
+        const inputMessages = [];
+        // Add previous messages (re-include images from uploads)
+        if (history && history.length > 0) {
+            for (const msg of history) {
+                const parsed = parseMessageContent(msg.content);
+                if (msg.role === "assistant") {
+                    // OpenAI Responses API requires assistant content as an array of output blocks
+                    inputMessages.push({
+                        role: "assistant",
+                        content: [{ type: "output_text", text: parsed.text }],
+                    });
+                }
+                else if (parsed.attachments && parsed.attachments.length > 0) {
+                    // Re-read image data for user messages that had attachments
+                    const content = [];
+                    for (const att of parsed.attachments) {
+                        const upload = getUpload(att.fileId);
+                        if (upload) {
+                            content.push({
+                                type: "input_image",
+                                image: `data:${upload.mimeType};base64,${upload.data.toString("base64")}`,
+                            });
+                        }
+                    }
+                    content.push({ type: "input_text", text: parsed.text });
+                    inputMessages.push({ role: "user", content });
+                }
+                else {
+                    inputMessages.push({ role: msg.role, content: parsed.text });
+                }
+            }
+        }
+        // Add current message
+        if (attachments && attachments.length > 0) {
+            const content = [];
+            for (const att of attachments) {
+                content.push({
+                    type: "input_image",
+                    image: `data:${att.mimeType};base64,${att.data.toString("base64")}`,
+                });
+            }
+            content.push({ type: "input_text", text: prompt });
+            inputMessages.push({ role: "user", content });
+        }
+        else {
+            inputMessages.push({ role: "user", content: prompt });
+        }
+        const input = inputMessages.length === 1 && !history?.length && !attachments?.length ? prompt : inputMessages;
+        const result = await run(agent, input, { stream: true });
+        for await (const event of result) {
+            if (event.type === "raw_model_stream_event" &&
+                event.data?.type === "output_text_delta") {
+                const delta = event.data.delta;
+                if (delta) {
+                    onChunk(delta);
+                }
+            }
+        }
+    }
+    finally {
+        // Disconnect all MCP servers
+        for (const server of mcpServers) {
+            try {
+                await server.close();
+            }
+            catch {
+                // ignore cleanup errors
+            }
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/agents/openai.js.map

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

package/dist/agents/router.d.ts

@@ -0,0 +1,15 @@
+import type { Config, McpServerConfig } from "../config.js";
+export interface Attachment {
+    filename: string;
+    mimeType: string;
+    data: Buffer;
+    filePath?: string;
+}
+export interface HistoryMessage {
+    role: string;
+    content: string;
+}
+export interface RouteResult {
+    sessionId: string | null;
+}
+export declare function routeMessage(prompt: string, config: Config, mcpServers: Record<string, McpServerConfig>, onChunk: (text: string) => void, resumeSessionId?: string, attachments?: Attachment[], history?: HistoryMessage[]): Promise<RouteResult>;

package/dist/agents/router.js

@@ -0,0 +1,17 @@
+import { runClaude } from "./claude.js";
+import { runOpenAI } from "./openai.js";
+export async function routeMessage(prompt, config, mcpServers, onChunk, resumeSessionId, attachments, history) {
+    switch (config.provider) {
+        case "claude": {
+            const result = await runClaude(prompt, config, mcpServers, onChunk, resumeSessionId, attachments);
+            return { sessionId: result.sessionId };
+        }
+        case "openai": {
+            await runOpenAI(prompt, config, mcpServers, onChunk, attachments, history);
+            return { sessionId: null };
+        }
+        default:
+            throw new Error(`Unknown provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/agents/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/agents/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkBxC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAAc,EACd,UAA2C,EAC3C,OAA+B,EAC/B,eAAwB,EACxB,WAA0B,EAC1B,OAA0B;IAE1B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;YAClG,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC3E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+export interface McpServerConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface Config {
+    provider: "claude" | "openai";
+    claude: {
+        apiKey: string;
+        model: string;
+        baseUrl: string;
+    };
+    openai: {
+        apiKey: string;
+        model: string;
+        baseUrl: string;
+    };
+    server: {
+        port: number;
+    };
+}
+export declare const DATA_DIR: string;
+export declare const MCP_CONFIG_PATH: string;
+export declare const MEMORY_FILE_PATH: string;
+export declare const MEMORY_SERVER_NAME = "memory";
+export declare function isConfigured(): boolean;
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Config): void;
+export declare function loadMcpServers(): Record<string, McpServerConfig>;
+export declare function saveMcpServers(servers: Record<string, McpServerConfig>): void;
+export declare function maskApiKey(key: string): string;
+export declare function getMaskedConfig(config: Config): Config;
+export declare function getMaskedMcpServers(servers: Record<string, McpServerConfig>): Record<string, McpServerConfig>;

package/dist/config.js

@@ -0,0 +1,67 @@
+import fs from "node:fs";
+import path from "node:path";
+export const DATA_DIR = path.join(process.cwd(), process.env.GOTO_DATA_DIR || "data");
+const CONFIG_PATH = path.join(DATA_DIR, "config.json");
+export const MCP_CONFIG_PATH = path.join(DATA_DIR, "mcp.json");
+export const MEMORY_FILE_PATH = path.join(DATA_DIR, "memory.json");
+export const MEMORY_SERVER_NAME = "memory";
+export function isConfigured() {
+    return fs.existsSync(CONFIG_PATH);
+}
+export function loadConfig() {
+    const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
+    const config = JSON.parse(raw);
+    // Environment variables override config file values
+    if (process.env.ANTHROPIC_API_KEY) {
+        config.claude.apiKey = process.env.ANTHROPIC_API_KEY;
+    }
+    if (process.env.OPENAI_API_KEY) {
+        config.openai.apiKey = process.env.OPENAI_API_KEY;
+    }
+    return config;
+}
+export function saveConfig(config) {
+    if (!fs.existsSync(DATA_DIR)) {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+export function loadMcpServers() {
+    if (!fs.existsSync(MCP_CONFIG_PATH))
+        return {};
+    const raw = fs.readFileSync(MCP_CONFIG_PATH, "utf-8");
+    const parsed = JSON.parse(raw);
+    return parsed.mcpServers ?? {};
+}
+export function saveMcpServers(servers) {
+    if (!fs.existsSync(DATA_DIR)) {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+    }
+    fs.writeFileSync(MCP_CONFIG_PATH, JSON.stringify({ mcpServers: servers }, null, 2));
+}
+export function maskApiKey(key) {
+    if (key.length <= 8)
+        return "****";
+    return key.slice(0, 4) + "****" + key.slice(-4);
+}
+export function getMaskedConfig(config) {
+    return {
+        ...config,
+        claude: { ...config.claude, apiKey: maskApiKey(config.claude.apiKey) },
+        openai: { ...config.openai, apiKey: maskApiKey(config.openai.apiKey) },
+    };
+}
+export function getMaskedMcpServers(servers) {
+    return Object.fromEntries(Object.entries(servers).map(([name, server]) => [
+        name,
+        {
+            ...server,
+            env: server.env
+                ? Object.fromEntries(Object.entries(server.env).map(([k, v]) => k.toLowerCase().includes("key") || k.toLowerCase().includes("secret")
+                    ? [k, maskApiKey(v)]
+                    : [k, v]))
+                : undefined,
+        },
+    ]));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { createApp, createServer } from "./server.js";
+import { isConfigured, loadConfig } from "./config.js";
+const app = createApp();
+const server = createServer(app);
+const port = Number(process.env.PORT) || (isConfigured() ? loadConfig().server.port : 3000);
+server.listen(port, () => {
+    console.log(`goto-assistant running at http://localhost:${port}`);
+    if (!isConfigured()) {
+        console.log("First run detected — visit the URL above to configure.");
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AACxB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AAEjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { type Express } from "express";
+import http from "node:http";
+export declare function createApp(): Express;
+export declare function createServer(app: Express): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;