@sol-merrai/cli 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,10 +18,58 @@ npm install -g @sol-merrai/cli
18
18
  merrai health
19
19
  merrai session --api-key "merrai_..."
20
20
  merrai memories --api-key "merrai_..."
21
+ merrai usage-summary --api-key "merrai_..."
21
22
  merrai add-memory --memory "Met Sarah at lunch" --source cli --lobe people
22
23
  merrai rpc healthCheck
23
24
  ```
24
25
 
26
+ ## Commands
27
+
28
+ ### `health`
29
+
30
+ Check API connectivity.
31
+
32
+ ### `session`
33
+
34
+ Fetch the current session.
35
+
36
+ ### `memories`
37
+
38
+ List memories for the current user.
39
+
40
+ ### `usage-summary`
41
+
42
+ Fetch current usage summary.
43
+
44
+ ### `add-memory`
45
+
46
+ Queue a memory for processing.
47
+
48
+ | Flag | Required | Description |
49
+ | ------------------- | -------- | -------------------------------------------------------- |
50
+ | `--memory <text>` | Yes | The memory text (also accepted as a positional argument) |
51
+ | `--source <text>` | No | Source identifier (defaults to `"testing-ui"`) |
52
+ | `--lobe <name>` | No | Lobe to store the memory in (defaults to `"main"`) |
53
+ | `--lobe-key <name>` | No | Deprecated alias for `--lobe` |
54
+
55
+ ### `rpc <procedure>`
56
+
57
+ Call a top-level oRPC procedure directly.
58
+
59
+ | Flag | Required | Description |
60
+ | ---------------- | -------- | ----------------------------------- |
61
+ | `--input <json>` | No | JSON input to pass to the procedure |
62
+
63
+ ## Global Options
64
+
65
+ | Flag | Description |
66
+ | ------------------- | ------------------------------------------ |
67
+ | `--base-url <url>` | API base URL (overrides `MERRAI_BASE_URL`) |
68
+ | `--api-key <key>` | API key for protected procedures |
69
+ | `--cookie <cookie>` | Session cookie for protected procedures |
70
+ | `--json` | Always print JSON output |
71
+ | `-h`, `--help` | Show help text |
72
+
25
73
  ## Configuration
26
74
 
27
75
  You can pass settings as flags:
@@ -82,14 +130,3 @@ Protected commands support either:
82
130
  - Session cookie auth via `--cookie` or `MERRAI_COOKIE`.
83
131
 
84
132
  API keys are the recommended option for CLI usage.
85
-
86
- ## Memory Lobes
87
-
88
- For `add-memory`, use `--lobe <name>` to keep memories separated by lobe. The
89
- legacy `--lobe-key` flag still works.
90
-
91
- ```bash
92
- merrai add-memory \
93
- --memory "Met Sarah at lunch" \
94
- --lobe people
95
- ```
package/dist/cli.mjs CHANGED
@@ -61,6 +61,10 @@ Commands:
61
61
  memories List memories for the current user
62
62
  usage-summary Fetch current usage summary
63
63
  add-memory --memory <text> Queue a memory for processing
64
+ search --query <text> Semantic search across memories
65
+ memory-status Count processed memories
66
+ clear-lobe --lobe <key> Soft-delete all memories in a lobe
67
+ add-memories --input JSON Bulk-queue memories for processing
64
68
  rpc <procedure> [--input JSON] Call a top-level oRPC procedure directly
65
69
 
66
70
  Global options:
@@ -192,6 +196,42 @@ const main = async () => {
192
196
  output = data;
193
197
  break;
194
198
  }
199
+ case "search": {
200
+ const query = requireString(getStringFlag(parsed.flags, "query") ?? parsed.positionals[1], "search requires --query <text> or a positional query string");
201
+ const lobeKey = getStringFlag(parsed.flags, "lobe") ?? getStringFlag(parsed.flags, "lobe-key");
202
+ const limitFlag = getStringFlag(parsed.flags, "limit");
203
+ const thresholdFlag = getStringFlag(parsed.flags, "threshold");
204
+ const [error, data] = await client.searchMemories({
205
+ query,
206
+ ...lobeKey ? { lobeKey } : {},
207
+ ...limitFlag ? { limit: Number.parseInt(limitFlag, 10) } : {},
208
+ ...thresholdFlag ? { threshold: Number.parseFloat(thresholdFlag) } : {}
209
+ });
210
+ if (error) throw error;
211
+ output = data;
212
+ break;
213
+ }
214
+ case "memory-status": {
215
+ const lobeKey = getStringFlag(parsed.flags, "lobe") ?? getStringFlag(parsed.flags, "lobe-key");
216
+ const [error, data] = await client.memoryStatus(lobeKey ? { lobeKey } : {});
217
+ if (error) throw error;
218
+ output = data;
219
+ break;
220
+ }
221
+ case "clear-lobe": {
222
+ const lobeKey = requireString(getStringFlag(parsed.flags, "lobe") ?? getStringFlag(parsed.flags, "lobe-key") ?? parsed.positionals[1], "clear-lobe requires --lobe <key> or a positional lobe key");
223
+ const [error, data] = await client.clearLobe({ lobeKey });
224
+ if (error) throw error;
225
+ output = data;
226
+ break;
227
+ }
228
+ case "add-memories": {
229
+ const memoriesInput = parseJson(requireString(getStringFlag(parsed.flags, "input"), "add-memories requires --input <JSON array>"), "--input");
230
+ const [error, data] = await client.addMemories({ memories: memoriesInput });
231
+ if (error) throw error;
232
+ output = data;
233
+ break;
234
+ }
195
235
  case "rpc": {
196
236
  const procedureName = requireString(parsed.positionals[1], "rpc requires a top-level procedure name");
197
237
  const procedure = client[procedureName];
package/dist/cli.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.mjs","names":[],"sources":["../src/client.ts","../src/cli.ts"],"sourcesContent":["import { createORPCClient, createSafeClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport type RpcProcedure<Input = unknown> = (\n input?: Input\n) => Promise<readonly [unknown, unknown, ...unknown[]]>;\n\nexport type AddMemoryInput = {\n memory: string;\n source?: string;\n lobeKey?: string;\n};\n\nexport type MerraiClient = Record<string, RpcProcedure> & {\n addMemory: RpcProcedure<AddMemoryInput>;\n healthCheck: RpcProcedure;\n memories: RpcProcedure;\n session: RpcProcedure;\n usageSummary: RpcProcedure;\n};\n\nexport type MerraiClientOptions = {\n baseURL?: string;\n apiKey?: string;\n cookie?: string;\n fetch?: typeof fetch;\n headers?: HeadersInit;\n};\n\nexport const resolveBaseURL = (baseURL?: string) => {\n const resolved = baseURL?.trim();\n\n if (!resolved) {\n throw new Error(\n \"baseURL is required. Set --base-url or MERRAI_BASE_URL in the CLI env file\"\n );\n }\n\n return resolved.endsWith(\"/\") ? resolved.slice(0, -1) : resolved;\n};\n\nconst resolveHeaders = (\n headers?: HeadersInit,\n apiKey?: string,\n cookie?: string\n): Record<string, string> => {\n const resolvedHeaders = new Headers(headers);\n\n if (apiKey) {\n resolvedHeaders.set(\"x-api-key\", apiKey);\n }\n\n if (cookie) {\n resolvedHeaders.set(\"Cookie\", cookie);\n }\n\n return Object.fromEntries(resolvedHeaders.entries());\n};\n\nexport const createRawMerraiClient = (options: MerraiClientOptions = {}) => {\n const link = new RPCLink({\n url: `${resolveBaseURL(options.baseURL)}/rpc`,\n headers: () =>\n resolveHeaders(options.headers, options.apiKey, options.cookie),\n fetch: options.fetch,\n });\n\n return createORPCClient(link);\n};\n\nexport const createMerraiClient = (options: MerraiClientOptions = {}) =>\n createSafeClient(createRawMerraiClient(options)) as unknown as MerraiClient;\n","#!/usr/bin/env node\n\nimport { ORPCError } from \"@orpc/client\";\nimport dotenv from \"dotenv\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { RpcProcedure } from \"./client\";\n\nimport { createMerraiClient } from \"./client\";\n\ntype ParsedArgs = {\n flags: Record<string, string | boolean>;\n positionals: string[];\n};\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst productionEnvNames = new Set([\"prod\", \"production\"]);\n\nconst isProductionEnv = () => {\n const envName = (process.env.MERRAI_ENV ?? process.env.NODE_ENV ?? \"\").trim();\n\n return productionEnvNames.has(envName);\n};\n\nconst loadPackageEnv = () => {\n dotenv.config({\n path: resolve(packageRoot, \".env\"),\n quiet: true,\n });\n if (isProductionEnv()) {\n dotenv.config({\n path: resolve(packageRoot, \".env.prod\"),\n override: true,\n quiet: true,\n });\n }\n dotenv.config({\n path: resolve(packageRoot, \".env.local\"),\n override: true,\n quiet: true,\n });\n};\n\nconst HELP_TEXT = `merrai\n\nUsage:\n merrai <command> [options]\n\nCommands:\n health Check API connectivity\n session Fetch the current session\n memories List memories for the current user\n usage-summary Fetch current usage summary\n add-memory --memory <text> Queue a memory for processing\n rpc <procedure> [--input JSON] Call a top-level oRPC procedure directly\n\nGlobal options:\n --base-url <url> API base URL (default: packages/cli/.env or .env.prod)\n --api-key <key> API key for protected procedures\n --cookie <cookie> Session cookie for protected procedures\n --json Always print JSON output\n -h, --help Show this help text\n\nEnvironment:\n packages/cli/.env Package-local env file\n packages/cli/.env.prod Loaded when MERRAI_ENV=prod or NODE_ENV=production\n packages/cli/.env.local Local override file\n MERRAI_ENV=prod Enables packages/cli/.env.prod\n MERRAI_BASE_URL Default for --base-url\n MERRAI_API_KEY Default for --api-key\n MERRAI_COOKIE Default for --cookie\n`;\n\nconst parseArgs = (argv: string[]): ParsedArgs => {\n const flags: Record<string, string | boolean> = {};\n const positionals: string[] = [];\n\n for (let index = 0; index < argv.length; index++) {\n const token = argv[index];\n\n if (!token) {\n continue;\n }\n\n if (token === \"-h\") {\n flags.help = true;\n continue;\n }\n\n if (!token.startsWith(\"--\")) {\n positionals.push(token);\n continue;\n }\n\n const [rawKey = \"\", inlineValue] = token.slice(2).split(\"=\", 2);\n const nextToken = argv[index + 1];\n const hasNextValue =\n inlineValue === undefined &&\n nextToken !== undefined &&\n !nextToken.startsWith(\"-\");\n\n flags[rawKey] =\n inlineValue ?? (hasNextValue ? (argv[++index] ?? \"\") : true);\n }\n\n return { flags, positionals };\n};\n\nconst getStringFlag = (\n flags: ParsedArgs[\"flags\"],\n key: string\n): string | undefined => {\n const value = flags[key];\n return typeof value === \"string\" ? value : undefined;\n};\n\nconst getBooleanFlag = (flags: ParsedArgs[\"flags\"], key: string): boolean =>\n flags[key] === true;\n\nconst parseJson = (value: string, flagName: string): unknown => {\n try {\n return JSON.parse(value) as unknown;\n } catch (error) {\n throw new Error(\n `Invalid JSON passed to ${flagName}: ${error instanceof Error ? error.message : String(error)}`\n );\n }\n};\n\nconst printOutput = (value: unknown, forceJson: boolean) => {\n if (!forceJson && typeof value === \"string\") {\n console.log(value);\n return;\n }\n\n console.log(JSON.stringify(value, null, 2));\n};\n\nconst printError = (error: unknown) => {\n if (error instanceof ORPCError) {\n const suffix = error.data ? `\\n${JSON.stringify(error.data, null, 2)}` : \"\";\n console.error(\n `oRPC ${error.status} ${error.code}: ${error.message}${suffix}`\n );\n return;\n }\n\n if (error instanceof Error) {\n console.error(error.message);\n return;\n }\n\n console.error(String(error));\n};\n\nconst requireString = (value: string | undefined, message: string): string => {\n if (!value) {\n throw new Error(message);\n }\n\n return value;\n};\n\nconst main = async () => {\n loadPackageEnv();\n\n const parsed = parseArgs(process.argv.slice(2));\n const [command] = parsed.positionals;\n\n if (!command || getBooleanFlag(parsed.flags, \"help\")) {\n console.log(HELP_TEXT);\n return;\n }\n\n const baseURL =\n getStringFlag(parsed.flags, \"base-url\") ?? process.env.MERRAI_BASE_URL;\n const apiKey =\n getStringFlag(parsed.flags, \"api-key\") ?? process.env.MERRAI_API_KEY;\n const cookie =\n getStringFlag(parsed.flags, \"cookie\") ?? process.env.MERRAI_COOKIE;\n const client = createMerraiClient({ apiKey, baseURL, cookie });\n const forceJson = getBooleanFlag(parsed.flags, \"json\");\n\n let output: unknown;\n\n switch (command) {\n case \"health\": {\n const [error, data] = await client.healthCheck();\n if (error) throw error;\n output = data;\n break;\n }\n case \"session\": {\n const [error, data] = await client.session();\n if (error) throw error;\n output = data;\n break;\n }\n case \"memories\": {\n const [error, data] = await client.memories();\n if (error) throw error;\n output = data;\n break;\n }\n case \"usage-summary\": {\n const [error, data] = await client.usageSummary();\n if (error) throw error;\n output = data;\n break;\n }\n case \"add-memory\": {\n const memory = requireString(\n getStringFlag(parsed.flags, \"memory\") ?? parsed.positionals[1],\n \"add-memory requires --memory <text> or a positional memory string\"\n );\n const source = getStringFlag(parsed.flags, \"source\");\n const lobeKey =\n getStringFlag(parsed.flags, \"lobe\") ??\n getStringFlag(parsed.flags, \"lobe-key\");\n const [error, data] = await client.addMemory({\n memory,\n source,\n lobeKey,\n });\n if (error) throw error;\n output = data;\n break;\n }\n case \"rpc\": {\n const procedureName = requireString(\n parsed.positionals[1],\n \"rpc requires a top-level procedure name\"\n );\n const procedure = (client as unknown as Record<string, RpcProcedure>)[\n procedureName\n ];\n\n if (typeof procedure !== \"function\") {\n throw new Error(`Unknown procedure: ${procedureName}`);\n }\n\n const inputFlag = getStringFlag(parsed.flags, \"input\");\n const input = inputFlag ? parseJson(inputFlag, \"--input\") : undefined;\n const [error, data] = await procedure(input);\n if (error) throw error;\n output = data;\n break;\n }\n default:\n throw new Error(`Unknown command: ${command}`);\n }\n\n printOutput(output, forceJson);\n};\n\nmain().catch((error: unknown) => {\n printError(error);\n process.exitCode = 1;\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"cli.mjs","names":[],"sources":["../src/client.ts","../src/cli.ts"],"sourcesContent":["import { createORPCClient, createSafeClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport type RpcProcedure<Input = unknown> = (\n input?: Input\n) => Promise<readonly [unknown, unknown, ...unknown[]]>;\n\nexport type AddMemoryInput = {\n memory: string;\n source?: string;\n lobeKey?: string;\n};\n\nexport type AddMemoriesInput = {\n memories: Array<{\n memory: string;\n source?: string;\n lobeKey?: string;\n }>;\n};\n\nexport type SearchMemoriesInput = {\n query: string;\n lobeKey?: string;\n limit?: number;\n threshold?: number;\n};\n\nexport type MemoryStatusInput = {\n lobeKey?: string;\n};\n\nexport type ClearLobeInput = {\n lobeKey: string;\n};\n\nexport type MerraiClient = Record<string, RpcProcedure> & {\n addMemory: RpcProcedure<AddMemoryInput>;\n addMemories: RpcProcedure<AddMemoriesInput>;\n clearLobe: RpcProcedure<ClearLobeInput>;\n healthCheck: RpcProcedure;\n memories: RpcProcedure;\n memoryStatus: RpcProcedure<MemoryStatusInput>;\n searchMemories: RpcProcedure<SearchMemoriesInput>;\n session: RpcProcedure;\n usageSummary: RpcProcedure;\n};\n\nexport type MerraiClientOptions = {\n baseURL?: string;\n apiKey?: string;\n cookie?: string;\n fetch?: typeof fetch;\n headers?: HeadersInit;\n};\n\nexport const resolveBaseURL = (baseURL?: string) => {\n const resolved = baseURL?.trim();\n\n if (!resolved) {\n throw new Error(\n \"baseURL is required. Set --base-url or MERRAI_BASE_URL in the CLI env file\"\n );\n }\n\n return resolved.endsWith(\"/\") ? resolved.slice(0, -1) : resolved;\n};\n\nconst resolveHeaders = (\n headers?: HeadersInit,\n apiKey?: string,\n cookie?: string\n): Record<string, string> => {\n const resolvedHeaders = new Headers(headers);\n\n if (apiKey) {\n resolvedHeaders.set(\"x-api-key\", apiKey);\n }\n\n if (cookie) {\n resolvedHeaders.set(\"Cookie\", cookie);\n }\n\n return Object.fromEntries(resolvedHeaders.entries());\n};\n\nexport const createRawMerraiClient = (options: MerraiClientOptions = {}) => {\n const link = new RPCLink({\n url: `${resolveBaseURL(options.baseURL)}/rpc`,\n headers: () =>\n resolveHeaders(options.headers, options.apiKey, options.cookie),\n fetch: options.fetch,\n });\n\n return createORPCClient(link);\n};\n\nexport const createMerraiClient = (options: MerraiClientOptions = {}) =>\n createSafeClient(createRawMerraiClient(options)) as unknown as MerraiClient;\n","#!/usr/bin/env node\n\nimport { ORPCError } from \"@orpc/client\";\nimport dotenv from \"dotenv\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { RpcProcedure } from \"./client\";\n\nimport { createMerraiClient } from \"./client\";\n\ntype ParsedArgs = {\n flags: Record<string, string | boolean>;\n positionals: string[];\n};\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst productionEnvNames = new Set([\"prod\", \"production\"]);\n\nconst isProductionEnv = () => {\n const envName = (process.env.MERRAI_ENV ?? process.env.NODE_ENV ?? \"\").trim();\n\n return productionEnvNames.has(envName);\n};\n\nconst loadPackageEnv = () => {\n dotenv.config({\n path: resolve(packageRoot, \".env\"),\n quiet: true,\n });\n if (isProductionEnv()) {\n dotenv.config({\n path: resolve(packageRoot, \".env.prod\"),\n override: true,\n quiet: true,\n });\n }\n dotenv.config({\n path: resolve(packageRoot, \".env.local\"),\n override: true,\n quiet: true,\n });\n};\n\nconst HELP_TEXT = `merrai\n\nUsage:\n merrai <command> [options]\n\nCommands:\n health Check API connectivity\n session Fetch the current session\n memories List memories for the current user\n usage-summary Fetch current usage summary\n add-memory --memory <text> Queue a memory for processing\n search --query <text> Semantic search across memories\n memory-status Count processed memories\n clear-lobe --lobe <key> Soft-delete all memories in a lobe\n add-memories --input JSON Bulk-queue memories for processing\n rpc <procedure> [--input JSON] Call a top-level oRPC procedure directly\n\nGlobal options:\n --base-url <url> API base URL (default: packages/cli/.env or .env.prod)\n --api-key <key> API key for protected procedures\n --cookie <cookie> Session cookie for protected procedures\n --json Always print JSON output\n -h, --help Show this help text\n\nEnvironment:\n packages/cli/.env Package-local env file\n packages/cli/.env.prod Loaded when MERRAI_ENV=prod or NODE_ENV=production\n packages/cli/.env.local Local override file\n MERRAI_ENV=prod Enables packages/cli/.env.prod\n MERRAI_BASE_URL Default for --base-url\n MERRAI_API_KEY Default for --api-key\n MERRAI_COOKIE Default for --cookie\n`;\n\nconst parseArgs = (argv: string[]): ParsedArgs => {\n const flags: Record<string, string | boolean> = {};\n const positionals: string[] = [];\n\n for (let index = 0; index < argv.length; index++) {\n const token = argv[index];\n\n if (!token) {\n continue;\n }\n\n if (token === \"-h\") {\n flags.help = true;\n continue;\n }\n\n if (!token.startsWith(\"--\")) {\n positionals.push(token);\n continue;\n }\n\n const [rawKey = \"\", inlineValue] = token.slice(2).split(\"=\", 2);\n const nextToken = argv[index + 1];\n const hasNextValue =\n inlineValue === undefined &&\n nextToken !== undefined &&\n !nextToken.startsWith(\"-\");\n\n flags[rawKey] =\n inlineValue ?? (hasNextValue ? (argv[++index] ?? \"\") : true);\n }\n\n return { flags, positionals };\n};\n\nconst getStringFlag = (\n flags: ParsedArgs[\"flags\"],\n key: string\n): string | undefined => {\n const value = flags[key];\n return typeof value === \"string\" ? value : undefined;\n};\n\nconst getBooleanFlag = (flags: ParsedArgs[\"flags\"], key: string): boolean =>\n flags[key] === true;\n\nconst parseJson = (value: string, flagName: string): unknown => {\n try {\n return JSON.parse(value) as unknown;\n } catch (error) {\n throw new Error(\n `Invalid JSON passed to ${flagName}: ${error instanceof Error ? error.message : String(error)}`\n );\n }\n};\n\nconst printOutput = (value: unknown, forceJson: boolean) => {\n if (!forceJson && typeof value === \"string\") {\n console.log(value);\n return;\n }\n\n console.log(JSON.stringify(value, null, 2));\n};\n\nconst printError = (error: unknown) => {\n if (error instanceof ORPCError) {\n const suffix = error.data ? `\\n${JSON.stringify(error.data, null, 2)}` : \"\";\n console.error(\n `oRPC ${error.status} ${error.code}: ${error.message}${suffix}`\n );\n return;\n }\n\n if (error instanceof Error) {\n console.error(error.message);\n return;\n }\n\n console.error(String(error));\n};\n\nconst requireString = (value: string | undefined, message: string): string => {\n if (!value) {\n throw new Error(message);\n }\n\n return value;\n};\n\nconst main = async () => {\n loadPackageEnv();\n\n const parsed = parseArgs(process.argv.slice(2));\n const [command] = parsed.positionals;\n\n if (!command || getBooleanFlag(parsed.flags, \"help\")) {\n console.log(HELP_TEXT);\n return;\n }\n\n const baseURL =\n getStringFlag(parsed.flags, \"base-url\") ?? process.env.MERRAI_BASE_URL;\n const apiKey =\n getStringFlag(parsed.flags, \"api-key\") ?? process.env.MERRAI_API_KEY;\n const cookie =\n getStringFlag(parsed.flags, \"cookie\") ?? process.env.MERRAI_COOKIE;\n const client = createMerraiClient({ apiKey, baseURL, cookie });\n const forceJson = getBooleanFlag(parsed.flags, \"json\");\n\n let output: unknown;\n\n switch (command) {\n case \"health\": {\n const [error, data] = await client.healthCheck();\n if (error) throw error;\n output = data;\n break;\n }\n case \"session\": {\n const [error, data] = await client.session();\n if (error) throw error;\n output = data;\n break;\n }\n case \"memories\": {\n const [error, data] = await client.memories();\n if (error) throw error;\n output = data;\n break;\n }\n case \"usage-summary\": {\n const [error, data] = await client.usageSummary();\n if (error) throw error;\n output = data;\n break;\n }\n case \"add-memory\": {\n const memory = requireString(\n getStringFlag(parsed.flags, \"memory\") ?? parsed.positionals[1],\n \"add-memory requires --memory <text> or a positional memory string\"\n );\n const source = getStringFlag(parsed.flags, \"source\");\n const lobeKey =\n getStringFlag(parsed.flags, \"lobe\") ??\n getStringFlag(parsed.flags, \"lobe-key\");\n const [error, data] = await client.addMemory({\n memory,\n source,\n lobeKey,\n });\n if (error) throw error;\n output = data;\n break;\n }\n case \"search\": {\n const query = requireString(\n getStringFlag(parsed.flags, \"query\") ?? parsed.positionals[1],\n \"search requires --query <text> or a positional query string\"\n );\n const lobeKey =\n getStringFlag(parsed.flags, \"lobe\") ??\n getStringFlag(parsed.flags, \"lobe-key\");\n const limitFlag = getStringFlag(parsed.flags, \"limit\");\n const thresholdFlag = getStringFlag(parsed.flags, \"threshold\");\n const [error, data] = await client.searchMemories({\n query,\n ...(lobeKey ? { lobeKey } : {}),\n ...(limitFlag ? { limit: Number.parseInt(limitFlag, 10) } : {}),\n ...(thresholdFlag\n ? { threshold: Number.parseFloat(thresholdFlag) }\n : {}),\n });\n if (error) throw error;\n output = data;\n break;\n }\n case \"memory-status\": {\n const lobeKey =\n getStringFlag(parsed.flags, \"lobe\") ??\n getStringFlag(parsed.flags, \"lobe-key\");\n const [error, data] = await client.memoryStatus((lobeKey ? { lobeKey } : {}));\n if (error) throw error;\n output = data;\n break;\n }\n case \"clear-lobe\": {\n const lobeKey = requireString(\n getStringFlag(parsed.flags, \"lobe\") ??\n getStringFlag(parsed.flags, \"lobe-key\") ??\n parsed.positionals[1],\n \"clear-lobe requires --lobe <key> or a positional lobe key\"\n );\n const [error, data] = await client.clearLobe({ lobeKey });\n if (error) throw error;\n output = data;\n break;\n }\n case \"add-memories\": {\n const inputFlag = requireString(\n getStringFlag(parsed.flags, \"input\"),\n \"add-memories requires --input <JSON array>\"\n );\n const memoriesInput = parseJson(inputFlag, \"--input\") as Array<{\n memory: string;\n source?: string;\n lobeKey?: string;\n }>;\n const [error, data] = await client.addMemories({\n memories: memoriesInput,\n });\n if (error) throw error;\n output = data;\n break;\n }\n case \"rpc\": {\n const procedureName = requireString(\n parsed.positionals[1],\n \"rpc requires a top-level procedure name\"\n );\n const procedure = (client as unknown as Record<string, RpcProcedure>)[\n procedureName\n ];\n\n if (typeof procedure !== \"function\") {\n throw new Error(`Unknown procedure: ${procedureName}`);\n }\n\n const inputFlag = getStringFlag(parsed.flags, \"input\");\n const input = inputFlag ? parseJson(inputFlag, \"--input\") : undefined;\n const [error, data] = await procedure(input);\n if (error) throw error;\n output = data;\n break;\n }\n default:\n throw new Error(`Unknown command: ${command}`);\n }\n\n printOutput(output, forceJson);\n};\n\nmain().catch((error: unknown) => {\n printError(error);\n process.exitCode = 1;\n});\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sol-merrai/cli",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Command-line client for Merrai",
5
5
  "bin": {
6
6
  "merrai": "dist/cli.mjs"