@satori-sh/cli 0.0.2

package/README.md

@@ -0,0 +1,88 @@
+# satori
+
+CLI tool for Satori memory server.
+
+## Installation
+
+Using Bun (recommended):
+```bash
+bun add -g @satori-sh/cli
+```
+
+Using npm:
+```bash
+npm install -g @satori-sh/cli
+```
+
+## Usage
+
+### Chat (Default)
+
+Start memory-augmented chat sessions:
+```bash
+satori "What's the best pizza topping?"
+satori "hello" --provider openai --model gpt-4o
+```
+
+### Search Memories
+
+Query the memory database:
+```bash
+satori search "what is my favorite food?"
+```
+
+### Add Memory
+
+Add new memories:
+```bash
+satori add "I like pizza"
+```
+
+**Options & Memory:**
+- `--provider <openai|anthropic>` (default: openai)
+- `--model <model>` (default: gpt-4o)
+- `--memory-id <id>` (scopes conversations)
+- `--no-stream` (disables streaming)
+
+**Memory Sessions:** If no `--memory-id` is provided, a random ID is generated. Set `SATORI_MEMORY_ID=generated-id` to continue sessions:
+```bash
+export SATORI_MEMORY_ID=example-words-joined
+satori chat "Follow up question"
+```
+
+## Configuration
+
+**Required:**
+- `SATORI_API_KEY` - Satori authentication key
+
+**For Chat:**
+- `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` - LLM provider keys
+
+**Optional:**
+- `SATORI_BASE_URL` (default: http://localhost:8000)
+- `SATORI_PROVIDER` (default: openai)
+- `SATORI_MODEL` (default: gpt-4o)
+- `SATORI_MEMORY_ID` - Session scoping
+- `SATORI_MOCK` - Enable mock mode
+
+## Troubleshooting
+
+- **API Key Errors**: Ensure provider keys are set (`OPENAI_API_KEY` or `ANTHROPIC_API_KEY`)
+- **Memory Server Down**: Chat falls back to raw LLM responses with warning logs
+- **Memory ID Issues**: Invalid IDs scope searches but don't break functionality
+- **Streaming Problems**: Use `--no-stream` for terminal compatibility
+
+## Contributing
+
+### Publishing
+
+1. Update version: `npm version patch|minor|major`
+2. Publish beta: `npm publish --tag beta`
+3. Test: `npm install @satori-sh/cli@beta`
+4. Promote: `npm dist-tag add @satori-sh/cli@<version> latest`
+
+### Notes
+- Uses ES modules for modern compatibility
+- `prepublishOnly` builds automatically
+- Test beta versions before promoting
+- OTP required for publishing

package/bun.lock

@@ -0,0 +1,37 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@satori-sh/cli",
+      "dependencies": {
+        "chalk": "^5.6.2",
+        "commander": "^12.1.0",
+        "random-words": "^2.0.1",
+      },
+      "devDependencies": {
+        "@types/bun": "^1.3.3",
+        "@types/node": "^24.10.1",
+        "typescript": "^5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+
+    "@types/node": ["@types/node@24.10.4", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-vnDVpYPMzs4wunl27jHrfmwojOGKya0xyM3sH+UE5iv5uPS6vX7UIoh6m+vQc5LGBq52HBKPIn/zcSZVzeDEZg=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
+    "random-words": ["random-words@2.0.1", "", { "dependencies": { "seedrandom": "^3.0.5" } }, "sha512-nZNJAmgcFmtJMTDDIUCm/iK4R6RydC6NvALvWhYItXQrgYGk1F7Gww416LpVROFQtfVd5TaLEf4WuSsko03N7w=="],
+
+    "seedrandom": ["seedrandom@3.0.5", "", {}, "sha512-8OwmbklUNzwezjGInmZ+2clQmExQPvomqjL7LFqOYqtmuxRgQYqOD3mHaU+MvZn5FLUeVxVfQjwLZW/n/JFuqg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/dist/add.d.ts

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

package/dist/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../src/add.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B7D"}

package/dist/add.js

@@ -0,0 +1,27 @@
+import { getConfig } from './config.js';
+export async function addMemories(text) {
+    if (!text || !text.trim()) {
+        console.error('Text cannot be empty');
+        return;
+    }
+    try {
+        const config = getConfig();
+        const response = await fetch(`${config.baseUrl}/memories`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`
+            },
+            body: JSON.stringify({ messages: [{ role: "user", content: text }] })
+        });
+        if (!response.ok) {
+            console.error(`HTTP error: ${response.status} ${response.statusText}`);
+            return;
+        }
+        await response.json();
+    }
+    catch (error) {
+        console.error(`Error adding memory: ${error instanceof Error ? error.message : error}`);
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../src/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,WAAW,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SACtE,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,CAAC,IAAI,EAAiB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { Config } from './types.js';
+export declare function getConfig(): Config;
+//# 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,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,wBAAgB,SAAS,IAAI,MAAM,CAelC"}

package/dist/config.js

@@ -0,0 +1,15 @@
+export function getConfig() {
+    const apiKey = process.env.SATORI_API_KEY;
+    const baseUrl = process.env.SATORI_BASE_URL || 'http://localhost:8000';
+    if (!apiKey) {
+        throw new Error('Missing SATORI_API_KEY environment variable');
+    }
+    try {
+        new URL(baseUrl);
+    }
+    catch {
+        throw new Error('Invalid SATORI_BASE_URL format');
+    }
+    return { apiKey, baseUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,uBAAuB,CAAC;IAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { searchMemories } from './search.js';
+export { addMemories } from './add.js';
+export declare function main(): Promise<void>;
+//# 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":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAsB,IAAI,kBA0CzB"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { Command } from 'commander';
+import { getConfig } from './config.js';
+import { searchMemories } from './search.js';
+import { addMemories } from './add.js';
+// Re-export for external use
+export { searchMemories } from './search.js';
+export { addMemories } from './add.js';
+export async function main() {
+    try {
+        getConfig(); // Validate early
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : 'Configuration error');
+        process.exit(1);
+    }
+    const program = new Command();
+    program
+        .name('satori')
+        .description('CLI tool for Satori memory server')
+        .version('0.0.1');
+    program
+        .argument('<query>', 'search query for memories')
+        .action(async (query) => {
+        await searchMemories(query);
+    });
+    program
+        .command('add')
+        .description('add a new memory')
+        .argument('<text>', 'text to add as memory')
+        .action(async (text) => {
+        await addMemories(text);
+    });
+    program
+        .command('chat')
+        .description('Start a chat session')
+        .option('--provider <provider>', 'Provider to use (openai or anthropic)', 'openai')
+        .option('--model <model>', 'Model to use', 'gpt-4o')
+        .option('--memory-id <id>', 'Memory ID for scoping')
+        .option('--no-stream', 'Disable streaming')
+        .action(async (options) => {
+        // TODO: Implement chat logic
+        console.log('Chat command invoked with options:', options);
+    });
+    program.parse();
+}
+if (import.meta.main) {
+    main();
+}
+//# 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,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,SAAS,EAAE,CAAC,CAAC,iBAAiB;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,mCAAmC,CAAC;SAChD,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kBAAkB,CAAC;SAC/B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,uBAAuB,EAAE,uCAAuC,EAAE,QAAQ,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,QAAQ,CAAC;SACnD,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;SACnD,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,6BAA6B;QAC7B,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,12 @@
+import { SearchResponse } from './types.js';
+interface MemoryOptions {
+    memoryId?: string;
+    topK?: number;
+}
+export declare function buildMemoryContext(prompt: string, options?: MemoryOptions): Promise<{
+    results: SearchResponse['results'];
+    memoryId: string;
+    instruction?: string;
+}>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C7K"}

package/dist/memory.js

@@ -0,0 +1,42 @@
+import { getConfig } from './config.js';
+import { generate } from 'random-words';
+export async function buildMemoryContext(prompt, options = {}) {
+    let memoryId;
+    let generated = false;
+    if (options.memoryId) {
+        memoryId = options.memoryId;
+    }
+    else if (process.env.SATORI_MEMORY_ID) {
+        memoryId = process.env.SATORI_MEMORY_ID;
+    }
+    else {
+        const words = generate({ exactly: 3 });
+        memoryId = words.join('-');
+        generated = true;
+    }
+    const topK = options.topK || 5;
+    const config = getConfig();
+    const response = await fetch(`${config.baseUrl}/search`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${config.apiKey}`
+        },
+        body: JSON.stringify({
+            query: prompt,
+            memory_id: memoryId,
+            top_k: topK
+        })
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const instruction = generated ? `Set SATORI_MEMORY_ID=${memoryId} to reuse this session.` : undefined;
+    return {
+        results: data.results,
+        memoryId,
+        instruction
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOxC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,UAAyB,EAAE;IAClF,IAAI,QAAgB,CAAC;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACxC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAa,CAAC;QACnD,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,SAAS,EAAE;QACvD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;SAC3C;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,IAAI;SACZ,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAC;IAErD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,wBAAwB,QAAQ,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtG,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/search.d.ts

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

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAGA,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjE"}

package/dist/search.js

@@ -0,0 +1,27 @@
+import { getConfig } from './config.js';
+export async function searchMemories(query) {
+    if (!query || !query.trim()) {
+        console.error('Query cannot be empty');
+        return;
+    }
+    try {
+        const config = getConfig();
+        const response = await fetch(`${config.baseUrl}/search`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`
+            },
+            body: JSON.stringify({ query })
+        });
+        if (!response.ok) {
+            console.error(`HTTP error: ${response.status} ${response.statusText}`);
+            return;
+        }
+        await response.json();
+    }
+    catch (error) {
+        console.error(`Error searching memories: ${error instanceof Error ? error.message : error}`);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa;IAChD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,SAAS,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/src/add.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Adds a new memory to the Satori server.
+ *
+ * @param {string} text - The text content to add as a memory
+ * @param {object} [options] - Additional options for the memory
+ * @param {string} [options.memoryId] - Optional memory ID for scoping
+ * @returns {Promise<void>} Logs success or error messages to console
+ * @throws {Error} If the text is empty
+ *
+ * @example
+ * ```bash
+ * satori add "I like pizza"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * await addMemories("User prefers dark mode", { memoryId: "session-123" });
+ * ```
+ */
+export declare function addMemories(text: string, options?: {
+    memoryId?: string;
+}): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/src/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/add.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BlG"}

package/dist/src/add.js

@@ -0,0 +1,46 @@
+import { getConfig } from './config.js';
+/**
+ * Adds a new memory to the Satori server.
+ *
+ * @param {string} text - The text content to add as a memory
+ * @param {object} [options] - Additional options for the memory
+ * @param {string} [options.memoryId] - Optional memory ID for scoping
+ * @returns {Promise<void>} Logs success or error messages to console
+ * @throws {Error} If the text is empty
+ *
+ * @example
+ * ```bash
+ * satori add "I like pizza"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * await addMemories("User prefers dark mode", { memoryId: "session-123" });
+ * ```
+ */
+export async function addMemories(text, options = {}) {
+    if (!text || !text.trim()) {
+        console.error('Text cannot be empty');
+        return;
+    }
+    try {
+        const config = await getConfig();
+        const response = await fetch(`${config.baseUrl}/memories`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`
+            },
+            body: JSON.stringify({ messages: [{ role: "user", content: text }], ...(options.memoryId && { memory_id: options.memoryId }) })
+        });
+        if (!response.ok) {
+            console.error(`HTTP error: ${response.status} ${response.statusText}`);
+            return;
+        }
+        await response.json();
+    }
+    catch (error) {
+        console.error(`Error adding memory: ${error instanceof Error ? error.message : error}`);
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/src/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,UAAiC,EAAE;IACjF,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,WAAW,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;SAChI,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,CAAC,IAAI,EAAiB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,39 @@
+import { Config } from './types.js';
+/**
+ * Checks write access to the config directory by attempting to create, write, and delete a temporary file.
+ *
+ * @throws {Error} If write access is denied or any operation fails
+ */
+export declare function checkWriteAccess(): Promise<void>;
+/**
+ * Saves the API key to the config file.
+ *
+ * @param {string} apiKey - The API key to save
+ * @throws {Error} If write access fails or saving fails
+ */
+export declare function saveApiKey(apiKey: string): Promise<void>;
+/**
+ * Saves the memory ID to the config file.
+ *
+ * @param {string} memoryId - The memory ID to save
+ * @throws {Error} If write access fails or saving fails
+ */
+export declare function saveMemoryId(memoryId: string): Promise<void>;
+/**
+ * Retrieves and validates configuration from file and environment variables.
+ * Fetches the memory_id and api_key from the config file in ~/.config/satori/satori.json.
+ *
+ * If the API key isn't in the config, it looks in SATORI_API_KEY.
+ * If there is no API key in either place it will call the API to get a new key.
+ *
+ * @returns {Promise<Config>} The validated configuration object
+ * @throws {Error} If required environment variables are missing or invalid
+ *
+ * @example
+ * ```typescript
+ * const config = await getConfig();
+ * console.log(config.apiKey); // API key from ~/.config/satori/satori.json or SATORI_API_KEY env var, or null
+ * ```
+ */
+export declare function getConfig(): Promise<Config>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKpC;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAatD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9D;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAalE;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAoEjD"}

package/dist/src/config.js

@@ -0,0 +1,165 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * Checks write access to the config directory by attempting to create, write, and delete a temporary file.
+ *
+ * @throws {Error} If write access is denied or any operation fails
+ */
+export async function checkWriteAccess() {
+    // Dynamic import used instead of static import at top-level to enable mocking with Bun's mock.module() in tests.
+    // Static imports cannot be overridden by module mocks in Bun, so this allows fs operations to be properly mocked.
+    const { promises: fs } = await import('node:fs');
+    const dir = join(homedir(), '.config', 'satori');
+    try {
+        await fs.mkdir(dir, { recursive: true });
+        const tempFile = join(dir, `temp-${randomUUID()}.txt`);
+        await fs.writeFile(tempFile, 'test');
+        await fs.unlink(tempFile);
+    }
+    catch (error) {
+        throw new Error(`Cannot write to config directory: ${error instanceof Error ? error.message : error}`);
+    }
+}
+/**
+ * Saves the API key to the config file.
+ *
+ * @param {string} apiKey - The API key to save
+ * @throws {Error} If write access fails or saving fails
+ */
+export async function saveApiKey(apiKey) {
+    // Dynamic import used instead of static import at top-level to enable mocking with Bun's mock.module() in tests.
+    // Static imports cannot be overridden by module mocks in Bun, so this allows fs operations to be properly mocked.
+    const { promises: fs } = await import('node:fs');
+    await checkWriteAccess();
+    const configPath = join(homedir(), '.config', 'satori', 'satori.json');
+    try {
+        const existing = await loadConfigFile();
+        const config = { ...existing, api_key: apiKey };
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+    }
+    catch (error) {
+        throw new Error(`Failed to save API key: ${error instanceof Error ? error.message : error}`);
+    }
+}
+/**
+ * Saves the memory ID to the config file.
+ *
+ * @param {string} memoryId - The memory ID to save
+ * @throws {Error} If write access fails or saving fails
+ */
+export async function saveMemoryId(memoryId) {
+    // Dynamic import used instead of static import at top-level to enable mocking with Bun's mock.module() in tests.
+    // Static imports cannot be overridden by module mocks in Bun, so this allows fs operations to be properly mocked.
+    const { promises: fs } = await import('node:fs');
+    await checkWriteAccess();
+    const configPath = join(homedir(), '.config', 'satori', 'satori.json');
+    try {
+        const existing = await loadConfigFile();
+        const config = { ...existing, memory_id: memoryId };
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+    }
+    catch (error) {
+        throw new Error(`Failed to save memory ID: ${error instanceof Error ? error.message : error}`);
+    }
+}
+/**
+ * Loads the config file data.
+ *
+ * @returns {Promise<Record<string, any>>} The config data
+ */
+async function loadConfigFile() {
+    try {
+        const configPath = join(homedir(), '.config', 'satori', 'satori.json');
+        const configFile = Bun.file(configPath);
+        if (await configFile.exists()) {
+            return await configFile.json();
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return {};
+}
+/**
+ * Retrieves and validates configuration from file and environment variables.
+ * Fetches the memory_id and api_key from the config file in ~/.config/satori/satori.json.
+ *
+ * If the API key isn't in the config, it looks in SATORI_API_KEY.
+ * If there is no API key in either place it will call the API to get a new key.
+ *
+ * @returns {Promise<Config>} The validated configuration object
+ * @throws {Error} If required environment variables are missing or invalid
+ *
+ * @example
+ * ```typescript
+ * const config = await getConfig();
+ * console.log(config.apiKey); // API key from ~/.config/satori/satori.json or SATORI_API_KEY env var, or null
+ * ```
+ */
+export async function getConfig() {
+    if (process.platform !== 'darwin') {
+        throw new Error('We do not currently support Windows yet, email support@satori.sh to request Windows support');
+    }
+    let apiKey = null;
+    let memoryId = undefined;
+    try {
+        const configPath = join(homedir(), '.config', 'satori', 'satori.json');
+        const configFile = Bun.file(configPath);
+        if (await configFile.exists()) {
+            const data = await configFile.json();
+            if (data && typeof data.api_key === 'string') {
+                apiKey = data.api_key;
+            }
+            if (data && typeof data.memory_id === 'string') {
+                memoryId = data.memory_id;
+            }
+        }
+    }
+    catch {
+        // If file reading or parsing fails, apiKey and memoryId remain default
+    }
+    // Fallback to environment variable if not set from file
+    if (!apiKey) {
+        apiKey = process.env.SATORI_API_KEY || null;
+    }
+    const baseUrl = process.env.SATORI_BASE_URL || 'https://api.satori.sh';
+    try {
+        new URL(baseUrl);
+    }
+    catch {
+        throw new Error('Invalid SATORI_BASE_URL format');
+    }
+    // Generate new API key if still null
+    if (!apiKey) {
+        try {
+            const response = await fetch(`${baseUrl}/orgs`, {
+                method: 'POST',
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data && typeof data.api_key === 'string') {
+                apiKey = data.api_key;
+                await saveApiKey(apiKey);
+            }
+            else {
+                throw new Error('Invalid response: missing api_key');
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to generate API key: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    const provider = process.env.SATORI_PROVIDER || 'openai';
+    const model = process.env.SATORI_MODEL || 'gpt-4o';
+    const openaiKey = process.env.OPENAI_API_KEY;
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    // Fallback to config file memoryId if not set via env
+    if (!memoryId) {
+        memoryId = process.env.SATORI_MEMORY_ID;
+    }
+    return { apiKey, baseUrl, provider, model, openaiKey, anthropicKey, memoryId };
+}
+//# sourceMappingURL=config.js.map