@sol-merrai/cli 0.1.4 → 0.2.0
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 +122 -81
- package/dist/bin.mjs +834 -0
- package/dist/bin.mjs.map +1 -0
- package/dist/index.d.mts +584 -25
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +135 -2
- package/dist/index.mjs.map +1 -0
- package/package.json +8 -6
- package/.env.example +0 -3
- package/.env.prod.example +0 -3
- package/dist/cli.d.mts +0 -1
- package/dist/cli.mjs +0 -256
- package/dist/cli.mjs.map +0 -1
- package/dist/client-BirYnOM4.mjs +0 -27
- package/dist/client-BirYnOM4.mjs.map +0 -1
package/dist/index.mjs
CHANGED
|
@@ -1,3 +1,136 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createORPCClient, createSafeClient } from "@orpc/client";
|
|
2
|
+
import { RPCLink } from "@orpc/client/fetch";
|
|
3
|
+
import fs from "node:fs";
|
|
4
|
+
import os from "node:os";
|
|
5
|
+
import path from "node:path";
|
|
2
6
|
|
|
3
|
-
|
|
7
|
+
//#region src/client.ts
|
|
8
|
+
const resolveBaseURL = (baseURL) => {
|
|
9
|
+
const resolved = baseURL?.trim();
|
|
10
|
+
if (!resolved) throw new Error("baseURL is required. Set --base-url, MERRAI_BASE_URL, or saved credentials");
|
|
11
|
+
return resolved.endsWith("/") ? resolved.slice(0, -1) : resolved;
|
|
12
|
+
};
|
|
13
|
+
const resolveHeaders = (headers, apiKey, cookie) => {
|
|
14
|
+
const resolvedHeaders = new Headers(headers);
|
|
15
|
+
if (apiKey) resolvedHeaders.set("x-api-key", apiKey);
|
|
16
|
+
if (cookie) resolvedHeaders.set("Cookie", cookie);
|
|
17
|
+
return Object.fromEntries(resolvedHeaders.entries());
|
|
18
|
+
};
|
|
19
|
+
const createRawMerraiClient = (options = {}) => {
|
|
20
|
+
return createORPCClient(new RPCLink({
|
|
21
|
+
fetch: options.fetch,
|
|
22
|
+
headers: () => resolveHeaders(options.headers, options.apiKey, options.cookie),
|
|
23
|
+
url: `${resolveBaseURL(options.baseURL)}/rpc`
|
|
24
|
+
}));
|
|
25
|
+
};
|
|
26
|
+
const createMerraiClient = (options = {}) => createSafeClient(createRawMerraiClient(options));
|
|
27
|
+
const createMerraiThrowingClient = (options = {}) => createRawMerraiClient(options);
|
|
28
|
+
|
|
29
|
+
//#endregion
|
|
30
|
+
//#region src/config.ts
|
|
31
|
+
const DEFAULT_MERRAI_BASE_URL = "https://api.merrai.app";
|
|
32
|
+
const CREDENTIALS_VERSION = 1;
|
|
33
|
+
const trimmed = (value) => {
|
|
34
|
+
const result = value?.trim();
|
|
35
|
+
return result === void 0 || result.length === 0 ? void 0 : result;
|
|
36
|
+
};
|
|
37
|
+
const isUnknownRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
38
|
+
const resolveHomeDirectory = (env) => trimmed(env.HOME) ?? trimmed(env.USERPROFILE) ?? os.homedir();
|
|
39
|
+
const resolveMerraiConfigPaths = (env) => {
|
|
40
|
+
const home = resolveHomeDirectory(env);
|
|
41
|
+
const xdgConfigHome = trimmed(env.XDG_CONFIG_HOME);
|
|
42
|
+
const windowsAppData = trimmed(env.APPDATA);
|
|
43
|
+
const directory = xdgConfigHome ? path.join(xdgConfigHome, "merrai") : process.platform === "win32" && windowsAppData ? path.join(windowsAppData, "Merrai") : path.join(home, ".config", "merrai");
|
|
44
|
+
return {
|
|
45
|
+
credentials: path.join(directory, "credentials.json"),
|
|
46
|
+
directory,
|
|
47
|
+
legacyClaudeCredentials: path.join(home, ".merrai-claude-code", "credentials.json")
|
|
48
|
+
};
|
|
49
|
+
};
|
|
50
|
+
const parseCredentials = (raw, options) => {
|
|
51
|
+
try {
|
|
52
|
+
const value = JSON.parse(raw);
|
|
53
|
+
if (!isUnknownRecord(value)) return null;
|
|
54
|
+
if (options.requireVersion && value.version !== CREDENTIALS_VERSION) return null;
|
|
55
|
+
const apiKey = typeof value.apiKey === "string" ? trimmed(value.apiKey) : void 0;
|
|
56
|
+
const baseURL = typeof value.baseURL === "string" ? trimmed(value.baseURL) : void 0;
|
|
57
|
+
if (apiKey === void 0) return null;
|
|
58
|
+
return {
|
|
59
|
+
apiKey,
|
|
60
|
+
...baseURL === void 0 ? {} : { baseURL },
|
|
61
|
+
savedAt: typeof value.savedAt === "string" ? value.savedAt : (/* @__PURE__ */ new Date(0)).toISOString(),
|
|
62
|
+
version: CREDENTIALS_VERSION
|
|
63
|
+
};
|
|
64
|
+
} catch {
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
const readCredentialsFile = (file, options) => {
|
|
69
|
+
if (!fs.existsSync(file)) return null;
|
|
70
|
+
try {
|
|
71
|
+
const credentials = parseCredentials(fs.readFileSync(file, "utf8"), { requireVersion: options.requireVersion });
|
|
72
|
+
if (credentials === null && options.strict) throw new Error(`Invalid Merrai credentials file at ${file}. Run 'merrai auth set-key' to replace it.`);
|
|
73
|
+
return credentials;
|
|
74
|
+
} catch (error) {
|
|
75
|
+
if (options.strict) throw error;
|
|
76
|
+
return null;
|
|
77
|
+
}
|
|
78
|
+
};
|
|
79
|
+
const loadMerraiCredentials = (env, options = {}) => {
|
|
80
|
+
const paths = resolveMerraiConfigPaths(env);
|
|
81
|
+
return readCredentialsFile(paths.credentials, {
|
|
82
|
+
requireVersion: true,
|
|
83
|
+
strict: options.strict === true
|
|
84
|
+
}) ?? readCredentialsFile(paths.legacyClaudeCredentials, {
|
|
85
|
+
requireVersion: false,
|
|
86
|
+
strict: options.strict === true
|
|
87
|
+
});
|
|
88
|
+
};
|
|
89
|
+
const saveMerraiCredentials = (env, input) => {
|
|
90
|
+
const apiKey = trimmed(input.apiKey);
|
|
91
|
+
if (apiKey === void 0) throw new Error("API key cannot be empty");
|
|
92
|
+
const paths = resolveMerraiConfigPaths(env);
|
|
93
|
+
fs.mkdirSync(paths.directory, {
|
|
94
|
+
mode: 448,
|
|
95
|
+
recursive: true
|
|
96
|
+
});
|
|
97
|
+
fs.chmodSync(paths.directory, 448);
|
|
98
|
+
const credentials = {
|
|
99
|
+
apiKey,
|
|
100
|
+
baseURL: trimmed(input.baseURL) ?? DEFAULT_MERRAI_BASE_URL,
|
|
101
|
+
savedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
102
|
+
version: CREDENTIALS_VERSION
|
|
103
|
+
};
|
|
104
|
+
fs.writeFileSync(paths.credentials, JSON.stringify(credentials, null, 2), { mode: 384 });
|
|
105
|
+
fs.chmodSync(paths.credentials, 384);
|
|
106
|
+
return credentials;
|
|
107
|
+
};
|
|
108
|
+
const removeFileIfPresent = (file) => {
|
|
109
|
+
try {
|
|
110
|
+
fs.unlinkSync(file);
|
|
111
|
+
return true;
|
|
112
|
+
} catch (error) {
|
|
113
|
+
if (error instanceof Error && "code" in error && error.code === "ENOENT") return false;
|
|
114
|
+
throw error;
|
|
115
|
+
}
|
|
116
|
+
};
|
|
117
|
+
const clearMerraiCredentials = (env, options = {}) => {
|
|
118
|
+
const paths = resolveMerraiConfigPaths(env);
|
|
119
|
+
const removedShared = removeFileIfPresent(paths.credentials);
|
|
120
|
+
const removedLegacy = options.includeLegacy === true ? removeFileIfPresent(paths.legacyClaudeCredentials) : false;
|
|
121
|
+
return removedShared || removedLegacy;
|
|
122
|
+
};
|
|
123
|
+
const resolveMerraiClientOptions = (env, overrides, options = {}) => {
|
|
124
|
+
const apiKeyOverride = trimmed(overrides.apiKey) ?? trimmed(env.MERRAI_API_KEY);
|
|
125
|
+
const baseURLOverride = trimmed(overrides.baseURL) ?? trimmed(env.MERRAI_BASE_URL);
|
|
126
|
+
const credentials = apiKeyOverride !== void 0 && baseURLOverride !== void 0 ? null : loadMerraiCredentials(env, { strict: options.strictCredentials !== false });
|
|
127
|
+
return {
|
|
128
|
+
apiKey: apiKeyOverride ?? credentials?.apiKey,
|
|
129
|
+
baseURL: baseURLOverride ?? credentials?.baseURL ?? DEFAULT_MERRAI_BASE_URL,
|
|
130
|
+
cookie: trimmed(overrides.cookie) ?? trimmed(env.MERRAI_COOKIE)
|
|
131
|
+
};
|
|
132
|
+
};
|
|
133
|
+
|
|
134
|
+
//#endregion
|
|
135
|
+
export { DEFAULT_MERRAI_BASE_URL, clearMerraiCredentials, createMerraiClient, createMerraiThrowingClient, createRawMerraiClient, loadMerraiCredentials, resolveBaseURL, resolveMerraiClientOptions, resolveMerraiConfigPaths, saveMerraiCredentials };
|
|
136
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../src/client.ts","../src/config.ts"],"sourcesContent":["import { createORPCClient, createSafeClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport type RpcProcedure<Input = unknown, Output = unknown> = (\n input?: Input\n) => Promise<readonly [unknown, Output, ...unknown[]]>;\n\nexport type ThrowingRpcProcedure<Input = unknown, Output = unknown> = (\n input?: Input\n) => Promise<Output>;\n\nexport type EntityType =\n | \"person\"\n | \"event\"\n | \"action\"\n | \"knowledge\"\n | \"document\";\n\nexport type JsonValue =\n | boolean\n | number\n | string\n | null\n | JsonValue[]\n | { [key: string]: JsonValue };\n\nexport interface AddMemoryInput {\n memory: string;\n observationDate?: string;\n source?: string;\n lobeKey?: string;\n}\n\nexport interface AddMemoryOutput {\n queued: boolean;\n workflowId: string;\n}\n\nexport interface AddMemoryRecallInput {\n memory: string;\n observationDate?: string;\n}\n\nexport interface AddMemoryRecallOutput {\n processing: true;\n status: \"enqueued\";\n}\n\nexport interface AddMemoriesInput {\n memories: {\n memory: string;\n observationDate?: string;\n source?: string;\n lobeKey?: string;\n }[];\n}\n\nexport interface AddMemoriesOutput {\n failures: { error: string; groupKey: string | null }[];\n queued: number;\n workflowId: string;\n}\n\nexport interface FindMemoryEntitiesInput {\n name: string;\n type?: EntityType;\n limit?: number;\n}\n\nexport interface MemoriesByEntityInput {\n entityId: string;\n limit?: number;\n}\n\nexport interface MemoriesByDateInput {\n start?: string;\n end?: string;\n limit?: number;\n}\n\nexport interface MemoryRecallResult {\n category: string | null;\n content: string;\n id: string;\n lobeKey: string;\n recordedAt: string;\n}\n\nexport interface FindMemoryEntitiesOutput {\n entities: {\n displayName: string;\n id: string;\n memoryCount: number;\n name: string;\n type: EntityType;\n }[];\n suggestedNextAction: {\n entityIds: string[];\n tool: \"search_memories_by_entity\";\n when: string;\n } | null;\n}\n\nexport interface SearchMemoryRecallInput {\n limit?: number;\n query: string;\n}\n\nexport interface SearchMemoryRecallOutput {\n memories: MemoryRecallResult[];\n suggestedNextAction: {\n consentRequired: true;\n tool: \"add_memory\";\n when: string;\n } | null;\n}\n\nexport interface MemoriesByEntityOutput {\n entity: {\n displayName: string;\n id: string;\n type: EntityType;\n };\n memories: MemoryRecallResult[];\n}\n\nexport interface MemoriesByDateOutput {\n memories: MemoryRecallResult[];\n range: {\n end: string | null;\n start: string | null;\n };\n}\n\nexport interface MemoryOverviewOutput {\n account: {\n name: string;\n numberOfAiTools: number | null;\n preferredMessagingChannel: string | null;\n primaryRole: string | null;\n workplace: string | null;\n };\n profile: {\n facts: Omit<MemoryRecallResult, \"id\">[];\n ongoingContext: Omit<MemoryRecallResult, \"id\">[];\n scope: string;\n suggestions: {\n expiresAt: string | null;\n text: string;\n }[];\n updatedAt: string;\n } | null;\n suggestedNextAction: {\n tool: \"search_memory\";\n when: string;\n };\n}\n\nexport interface ListLivingDocumentsInput {\n status?: (\"enabled\" | \"disabled\" | \"archived\")[];\n}\n\nexport type LivingDocumentStatus = \"enabled\" | \"disabled\" | \"archived\";\n\nexport interface LivingDocument {\n autoPublish: boolean;\n createdAt: string;\n currentApprovedVersionId: string | null;\n currentVersionId: string | null;\n description: string | null;\n entities: string[];\n extractionPrompt: string;\n id: string;\n patchFailureCount: number;\n routingSummary: string | null;\n routingSummaryDirty: boolean;\n status: LivingDocumentStatus;\n title: string;\n triggerKeywords: string[];\n updatedAt: string;\n}\n\nexport interface LivingDocumentVersion {\n causedByMemoryIds: string[];\n causedByRunId: string | null;\n contentMd: string;\n contentMdSummary: string | null;\n createdAt: string;\n documentId: string;\n extractorModel: string | null;\n id: string;\n parentVersionId: string | null;\n patch: JsonValue;\n updatedAt: string;\n versionNumber: number;\n}\n\nexport interface LivingDocumentShare {\n createdAt: string;\n documentId: string;\n expiresAt: string | null;\n id: string;\n mode: \"pinned\" | \"live\";\n permissions: \"view\" | \"view+comment\";\n revokedAt: string | null;\n shareToken: string;\n updatedAt: string;\n versionId: string | null;\n}\n\nexport interface ListLivingDocumentsOutput {\n documents: LivingDocument[];\n slots: {\n limit: number;\n plan: string;\n remaining: number;\n used: number;\n };\n}\n\nexport interface ListLivingDocumentsRecallOutput {\n documents: {\n autoPublish: boolean;\n currentVersion: { createdAt: string; number: number } | null;\n id: string;\n status: string;\n summary: string;\n title: string;\n }[];\n}\n\nexport interface ReadLivingDocumentRecallInput {\n documentId: string;\n}\n\nexport interface ReadLivingDocumentRecallOutput {\n document: {\n activeShares: {\n expiresAt: string | null;\n mode: string;\n permissions: string;\n url: string;\n versionId: string | null;\n }[];\n autoPublish: boolean;\n currentVersion: {\n contentMarkdown: string;\n createdAt: string;\n id: string;\n number: number;\n } | null;\n description: string | null;\n entities: string[];\n headings: string[];\n id: string;\n status: string;\n summary: string;\n title: string;\n triggerKeywords: string[];\n };\n}\n\nexport interface GetLivingDocumentOutput {\n currentVersion: LivingDocumentVersion | null;\n document: LivingDocument;\n}\n\nexport interface ListLivingDocumentSharesOutput {\n shares: LivingDocumentShare[];\n}\n\nexport interface GetLivingDocumentInput {\n id: string;\n}\n\nexport interface ListLivingDocumentSharesInput {\n documentId: string;\n}\n\nexport interface AddChatSessionInput {\n memories: {\n memory: string;\n source?: string;\n }[];\n lobeKey?: string;\n source?: string;\n sessionMetadata?: Record<string, unknown>;\n}\n\nexport interface AddChatSessionOutput {\n queued: number;\n workflowId: string;\n}\n\nexport interface AddChatSessionsInput {\n lobeKey?: string;\n source?: string;\n questionMetadata?: Record<string, unknown>;\n /**\n * Override the V3 extractor's prompt profile.\n * - `general` — default chat-ingest extraction.\n * - `agent` — agent-scoped ingests (no user, only agent_id).\n * - `code-personal` — coding-session bias (developer intent over\n * assistant scaffolding, code-specific entities).\n * When omitted, the server resolves a profile from `source`\n * (e.g. `claude-code` → `code-personal`); use this only to override\n * that mapping or for sources the server hasn't pre-mapped.\n */\n extractionProfile?: \"general\" | \"agent\" | \"code-personal\";\n /**\n * Optional idempotency key (1-64 chars, [A-Za-z0-9_-]). When supplied,\n * retries with the same key short-circuit on the server instead of\n * re-running the ingest pipeline. Derive deterministically from\n * (sessionId, turnRange) so retries collide but distinct flushes do not.\n */\n idempotencyKey?: string;\n sessions: {\n sessionId: string;\n metadata?: Record<string, unknown>;\n turns: {\n content: string;\n role: \"user\" | \"assistant\";\n speaker?: string;\n turnIndex: number;\n }[];\n }[];\n}\n\nexport interface AddChatSessionsOutput {\n queuedSessions: number;\n workflowId: string;\n}\n\nexport interface SearchMemoriesInput {\n query: string;\n lobeKey?: string;\n limit?: number;\n threshold?: number;\n mode?: \"fast\" | \"adaptive\" | \"reflective\";\n graph?: {\n enabled?: boolean;\n maxNeighborsPerSeed?: number;\n maxTotalNeighbors?: number;\n };\n}\n\nexport interface SearchMemoryHit {\n category: string | null;\n content: string;\n id: string;\n memoryDate: string;\n score: number;\n summary: string | null;\n}\n\nexport interface MemoryStatusInput {\n lobeKey?: string;\n}\n\nexport interface MemoryStatusOutput {\n count: number;\n}\n\nexport interface ClearLobeInput {\n lobeKey: string;\n}\n\nexport interface ClearLobeOutput {\n deleted: number;\n}\n\nexport interface MemoryListItem {\n category: string | null;\n content: string;\n createdAt: string;\n expiresAt: string | null;\n id: string;\n isCurrent: string;\n lobeKey: string;\n memoryAt: string | null;\n memoryKind: string;\n metadata: JsonValue | null;\n summary: string | null;\n supersededByMemoryId: string | null;\n updatedAt: string;\n}\n\nexport interface AuthSessionOutput {\n session: {\n createdAt: string | null;\n expiresAt: string | null;\n id: string;\n ipAddress: string | null;\n token: string;\n updatedAt: string | null;\n userAgent: string | null;\n userId: string;\n };\n user: {\n createdAt: string | null;\n email: string;\n emailVerified: boolean;\n id: string;\n image: string | null;\n name: string;\n onboardingComplete: boolean;\n updatedAt: string | null;\n };\n}\n\nexport type UsagePlan = \"free\" | \"beta\";\nexport type UsageMeter =\n | \"assistant_messages\"\n | \"automation_executions\"\n | \"llm_tokens\"\n | \"memory_processed\";\n\nexport interface UsageMeterSummary {\n allowed: boolean;\n current: number;\n limit: number | null;\n meter: UsageMeter;\n periodKey: string;\n plan: UsagePlan;\n remaining: number | null;\n userId: string;\n}\n\nexport interface UsageSummaryOutput {\n billing: {\n hasPaidPlan: boolean;\n plan: UsagePlan;\n scheduledDowngradeAt: string | null;\n };\n llm: {\n byModel: {\n inputTokens: number;\n model: string;\n outputTokens: number;\n provider: string;\n requests: number;\n totalTokens: number;\n }[];\n bySurface: {\n inputTokens: number;\n outputTokens: number;\n requests: number;\n surface: string;\n totalTokens: number;\n }[];\n recentRequests: {\n cachedInputTokens: number;\n createdAt: string;\n id: string;\n inputTokens: number;\n model: string;\n outputTokens: number;\n provider: string;\n reasoningTokens: number;\n requestId: string | null;\n surface: string;\n totalTokens: number;\n }[];\n totals: {\n cachedInputTokens: number;\n inputTokens: number;\n outputTokens: number;\n reasoningTokens: number;\n requests: number;\n totalTokens: number;\n };\n };\n meters: {\n automationExecutions: UsageMeterSummary;\n llmTokens: UsageMeterSummary;\n memoryProcessed: UsageMeterSummary;\n };\n periodStart: string;\n plan: UsagePlan;\n plans: {\n automations: number | null;\n id: UsagePlan;\n memories: number | null;\n tokens: number | null;\n }[];\n}\n\nexport interface GetSessionStartContextInput {\n /**\n * Restrict to a single lobe. Plugin callers pass `cc:<repo-slug>` so memory\n * is scoped to the active project. Omit to read across every lobe.\n */\n lobeKey?: string;\n /**\n * Short retrieval hints biased toward what the caller is about to do\n * (e.g. current git branch name, last commit subject, cwd basename).\n * Cap: 5 hints × 200 chars.\n */\n recentHints?: string[];\n /**\n * Caller-side budget. Server hard caps both numbers regardless.\n */\n budget?: {\n /** Default 15, hard cap 30. */\n maxMemories?: number;\n /** Default 2000, hard cap 4000. Char-based estimate (chars / 4). */\n maxTokens?: number;\n };\n}\n\nexport interface GetSessionStartContextOutput {\n /** Markdown block ready to drop into a hook's `additionalContext`. */\n markdown: string;\n /** IDs of every memory referenced in the markdown. */\n memoryIds: string[];\n /** True when the response was truncated by the budget. */\n hasMore: boolean;\n /** Server-side ISO 8601 timestamp the context was generated. */\n generatedAt: string;\n}\n\ninterface MerraiProcedureContract {\n addChatSession: {\n input: AddChatSessionInput;\n output: AddChatSessionOutput;\n };\n addChatSessions: {\n input: AddChatSessionsInput;\n output: AddChatSessionsOutput;\n };\n addMemories: { input: AddMemoriesInput; output: AddMemoriesOutput };\n addMemory: { input: AddMemoryInput; output: AddMemoryOutput };\n clearLobe: { input: ClearLobeInput; output: ClearLobeOutput };\n findMemoryEntities: {\n input: FindMemoryEntitiesInput;\n output: FindMemoryEntitiesOutput;\n };\n getLivingDocument: {\n input: GetLivingDocumentInput;\n output: GetLivingDocumentOutput;\n };\n getSessionStartContext: {\n input: GetSessionStartContextInput;\n output: GetSessionStartContextOutput;\n };\n healthCheck: { input: undefined; output: \"OK\" };\n listLivingDocuments: {\n input: ListLivingDocumentsInput;\n output: ListLivingDocumentsOutput;\n };\n listLivingDocumentShares: {\n input: ListLivingDocumentSharesInput;\n output: ListLivingDocumentSharesOutput;\n };\n memories: { input: undefined; output: MemoryListItem[] };\n memoriesByDate: {\n input: MemoriesByDateInput;\n output: MemoriesByDateOutput;\n };\n memoriesByEntity: {\n input: MemoriesByEntityInput;\n output: MemoriesByEntityOutput;\n };\n memoryOverview: { input: undefined; output: MemoryOverviewOutput };\n memoryStatus: { input: MemoryStatusInput; output: MemoryStatusOutput };\n searchMemories: { input: SearchMemoriesInput; output: SearchMemoryHit[] };\n session: { input: undefined; output: AuthSessionOutput | null };\n usageSummary: { input: undefined; output: UsageSummaryOutput };\n}\n\ninterface MerraiRecallProcedureContract {\n addMemory: {\n input: AddMemoryRecallInput;\n output: AddMemoryRecallOutput;\n };\n listLivingDocuments: {\n input: undefined;\n output: ListLivingDocumentsRecallOutput;\n };\n readLivingDocument: {\n input: ReadLivingDocumentRecallInput;\n output: ReadLivingDocumentRecallOutput;\n };\n searchMemory: {\n input: SearchMemoryRecallInput;\n output: SearchMemoryRecallOutput;\n };\n}\n\ntype SafeProcedureClient<Contract> = {\n [ProcedureName in keyof Contract]: Contract[ProcedureName] extends {\n input: infer Input;\n output: infer Output;\n }\n ? RpcProcedure<Input, Output>\n : never;\n};\n\ntype ThrowingProcedureClient<Contract> = {\n [ProcedureName in keyof Contract]: Contract[ProcedureName] extends {\n input: infer Input;\n output: infer Output;\n }\n ? ThrowingRpcProcedure<Input, Output>\n : never;\n};\n\nexport type MerraiClient = SafeProcedureClient<MerraiProcedureContract> & {\n recall: SafeProcedureClient<MerraiRecallProcedureContract>;\n};\n\nexport type MerraiThrowingClient =\n ThrowingProcedureClient<MerraiProcedureContract> & {\n recall: ThrowingProcedureClient<MerraiRecallProcedureContract>;\n };\n\nexport interface 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, MERRAI_BASE_URL, or saved credentials\"\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 fetch: options.fetch,\n headers: () =>\n resolveHeaders(options.headers, options.apiKey, options.cookie),\n url: `${resolveBaseURL(options.baseURL)}/rpc`,\n });\n\n return createORPCClient(link);\n};\n\nexport const createMerraiClient = (options: MerraiClientOptions = {}) =>\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Legacy cast requires typed boundary validation.\n createSafeClient(createRawMerraiClient(options)) as unknown as MerraiClient;\n\nexport const createMerraiThrowingClient = (\n options: MerraiClientOptions = {}\n): MerraiThrowingClient =>\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- oRPC is dynamic without the server contract package; keep the cast at this construction seam.\n createRawMerraiClient(options) as unknown as MerraiThrowingClient;\n","import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport type { MerraiClientOptions } from \"./client\";\n\nexport const DEFAULT_MERRAI_BASE_URL = \"https://api.merrai.app\";\nconst CREDENTIALS_VERSION = 1;\n\nexport type MerraiCliEnvironment = Readonly<Record<string, string | undefined>>;\n\nexport interface MerraiCliConnectionOverrides {\n apiKey?: string;\n baseURL?: string;\n cookie?: string;\n}\n\nexport interface MerraiCredentials {\n apiKey: string;\n baseURL?: string;\n savedAt: string;\n version: typeof CREDENTIALS_VERSION;\n}\n\nexport interface MerraiConfigPaths {\n credentials: string;\n directory: string;\n legacyClaudeCredentials: string;\n}\n\nconst trimmed = (value: string | undefined): string | undefined => {\n const result = value?.trim();\n return result === undefined || result.length === 0 ? undefined : result;\n};\n\nconst isUnknownRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst resolveHomeDirectory = (env: MerraiCliEnvironment): string =>\n trimmed(env.HOME) ?? trimmed(env.USERPROFILE) ?? os.homedir();\n\nexport const resolveMerraiConfigPaths = (\n env: MerraiCliEnvironment\n): MerraiConfigPaths => {\n const home = resolveHomeDirectory(env);\n const xdgConfigHome = trimmed(env.XDG_CONFIG_HOME);\n const windowsAppData = trimmed(env.APPDATA);\n const directory = xdgConfigHome\n ? path.join(xdgConfigHome, \"merrai\")\n : process.platform === \"win32\" && windowsAppData\n ? path.join(windowsAppData, \"Merrai\")\n : path.join(home, \".config\", \"merrai\");\n\n return {\n credentials: path.join(directory, \"credentials.json\"),\n directory,\n legacyClaudeCredentials: path.join(\n home,\n \".merrai-claude-code\",\n \"credentials.json\"\n ),\n };\n};\n\nconst parseCredentials = (\n raw: string,\n options: { requireVersion: boolean }\n): MerraiCredentials | null => {\n try {\n const value: unknown = JSON.parse(raw);\n if (!isUnknownRecord(value)) {\n return null;\n }\n\n if (options.requireVersion && value.version !== CREDENTIALS_VERSION) {\n return null;\n }\n const apiKey =\n typeof value.apiKey === \"string\" ? trimmed(value.apiKey) : undefined;\n const baseURL =\n typeof value.baseURL === \"string\" ? trimmed(value.baseURL) : undefined;\n if (apiKey === undefined) {\n return null;\n }\n\n return {\n apiKey,\n ...(baseURL === undefined ? {} : { baseURL }),\n savedAt:\n typeof value.savedAt === \"string\"\n ? value.savedAt\n : new Date(0).toISOString(),\n version: CREDENTIALS_VERSION,\n };\n } catch {\n return null;\n }\n};\n\nconst readCredentialsFile = (\n file: string,\n options: { requireVersion: boolean; strict: boolean }\n): MerraiCredentials | null => {\n if (!fs.existsSync(file)) {\n return null;\n }\n try {\n const credentials = parseCredentials(fs.readFileSync(file, \"utf8\"), {\n requireVersion: options.requireVersion,\n });\n if (credentials === null && options.strict) {\n throw new Error(\n `Invalid Merrai credentials file at ${file}. Run 'merrai auth set-key' to replace it.`\n );\n }\n return credentials;\n } catch (error) {\n if (options.strict) {\n throw error;\n }\n return null;\n }\n};\n\nexport const loadMerraiCredentials = (\n env: MerraiCliEnvironment,\n options: { strict?: boolean } = {}\n): MerraiCredentials | null => {\n const paths = resolveMerraiConfigPaths(env);\n return (\n readCredentialsFile(paths.credentials, {\n requireVersion: true,\n strict: options.strict === true,\n }) ??\n readCredentialsFile(paths.legacyClaudeCredentials, {\n requireVersion: false,\n strict: options.strict === true,\n })\n );\n};\n\nexport const saveMerraiCredentials = (\n env: MerraiCliEnvironment,\n input: { apiKey: string; baseURL?: string }\n): MerraiCredentials => {\n const apiKey = trimmed(input.apiKey);\n if (apiKey === undefined) {\n throw new Error(\"API key cannot be empty\");\n }\n\n const paths = resolveMerraiConfigPaths(env);\n fs.mkdirSync(paths.directory, { mode: 0o700, recursive: true });\n fs.chmodSync(paths.directory, 0o700);\n const credentials: MerraiCredentials = {\n apiKey,\n baseURL: trimmed(input.baseURL) ?? DEFAULT_MERRAI_BASE_URL,\n savedAt: new Date().toISOString(),\n version: CREDENTIALS_VERSION,\n };\n fs.writeFileSync(paths.credentials, JSON.stringify(credentials, null, 2), {\n mode: 0o600,\n });\n fs.chmodSync(paths.credentials, 0o600);\n return credentials;\n};\n\nconst removeFileIfPresent = (file: string): boolean => {\n try {\n fs.unlinkSync(file);\n return true;\n } catch (error) {\n if (error instanceof Error && \"code\" in error && error.code === \"ENOENT\") {\n return false;\n }\n throw error;\n }\n};\n\nexport const clearMerraiCredentials = (\n env: MerraiCliEnvironment,\n options: { includeLegacy?: boolean } = {}\n): boolean => {\n const paths = resolveMerraiConfigPaths(env);\n const removedShared = removeFileIfPresent(paths.credentials);\n const removedLegacy =\n options.includeLegacy === true\n ? removeFileIfPresent(paths.legacyClaudeCredentials)\n : false;\n return removedShared || removedLegacy;\n};\n\nexport const resolveMerraiClientOptions = (\n env: MerraiCliEnvironment,\n overrides: MerraiCliConnectionOverrides,\n options: { strictCredentials?: boolean } = {}\n): MerraiClientOptions => {\n const apiKeyOverride =\n trimmed(overrides.apiKey) ?? trimmed(env.MERRAI_API_KEY);\n const baseURLOverride =\n trimmed(overrides.baseURL) ?? trimmed(env.MERRAI_BASE_URL);\n const credentials =\n apiKeyOverride !== undefined && baseURLOverride !== undefined\n ? null\n : loadMerraiCredentials(env, {\n strict: options.strictCredentials !== false,\n });\n return {\n apiKey: apiKeyOverride ?? credentials?.apiKey,\n baseURL: baseURLOverride ?? credentials?.baseURL ?? DEFAULT_MERRAI_BASE_URL,\n cookie: trimmed(overrides.cookie) ?? trimmed(env.MERRAI_COOKIE),\n };\n};\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,13 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sol-merrai/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Command-line client for Merrai",
|
|
5
5
|
"bin": {
|
|
6
|
-
"merrai": "dist/
|
|
6
|
+
"merrai": "dist/bin.mjs"
|
|
7
7
|
},
|
|
8
8
|
"files": [
|
|
9
|
-
".env.example",
|
|
10
|
-
".env.prod.example",
|
|
11
9
|
"dist",
|
|
12
10
|
"README.md"
|
|
13
11
|
],
|
|
@@ -24,13 +22,17 @@
|
|
|
24
22
|
"scripts": {
|
|
25
23
|
"build": "tsdown",
|
|
26
24
|
"check-types": "tsgo --noEmit",
|
|
27
|
-
"prepack": "bun run build"
|
|
25
|
+
"prepack": "bun run build",
|
|
26
|
+
"test": "vitest run"
|
|
28
27
|
},
|
|
29
28
|
"dependencies": {
|
|
30
29
|
"@orpc/client": "^1.10.0",
|
|
31
|
-
"
|
|
30
|
+
"commander": "^14.0.3"
|
|
32
31
|
},
|
|
33
32
|
"devDependencies": {
|
|
34
33
|
"tsdown": "^0.20.3"
|
|
34
|
+
},
|
|
35
|
+
"engines": {
|
|
36
|
+
"node": ">=20"
|
|
35
37
|
}
|
|
36
38
|
}
|
package/.env.example
DELETED
package/.env.prod.example
DELETED
package/dist/cli.d.mts
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { };
|
package/dist/cli.mjs
DELETED
|
@@ -1,256 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import { t as createMerraiClient } from "./client-BirYnOM4.mjs";
|
|
3
|
-
import { ORPCError } from "@orpc/client";
|
|
4
|
-
import dotenv from "dotenv";
|
|
5
|
-
import { dirname, resolve } from "node:path";
|
|
6
|
-
import { fileURLToPath } from "node:url";
|
|
7
|
-
|
|
8
|
-
//#region src/cli.ts
|
|
9
|
-
const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
|
10
|
-
const productionEnvNames = new Set(["prod", "production"]);
|
|
11
|
-
const isProductionEnv = () => {
|
|
12
|
-
const envName = (process.env.MERRAI_ENV ?? process.env.NODE_ENV ?? "").trim();
|
|
13
|
-
return productionEnvNames.has(envName);
|
|
14
|
-
};
|
|
15
|
-
const loadPackageEnv = () => {
|
|
16
|
-
dotenv.config({
|
|
17
|
-
path: resolve(packageRoot, ".env"),
|
|
18
|
-
quiet: true
|
|
19
|
-
});
|
|
20
|
-
if (isProductionEnv()) dotenv.config({
|
|
21
|
-
path: resolve(packageRoot, ".env.prod"),
|
|
22
|
-
override: true,
|
|
23
|
-
quiet: true
|
|
24
|
-
});
|
|
25
|
-
dotenv.config({
|
|
26
|
-
path: resolve(packageRoot, ".env.local"),
|
|
27
|
-
override: true,
|
|
28
|
-
quiet: true
|
|
29
|
-
});
|
|
30
|
-
};
|
|
31
|
-
const HELP_TEXT = `merrai
|
|
32
|
-
|
|
33
|
-
Usage:
|
|
34
|
-
merrai <command> [options]
|
|
35
|
-
|
|
36
|
-
Commands:
|
|
37
|
-
health Check API connectivity
|
|
38
|
-
session Fetch the current session
|
|
39
|
-
memories List memories for the current user
|
|
40
|
-
usage-summary Fetch current usage summary
|
|
41
|
-
add-memory --memory <text> Queue a memory for processing
|
|
42
|
-
search --query <text> Hybrid search (vector + FTS + 1-hop graph)
|
|
43
|
-
memory-status Count processed memories
|
|
44
|
-
clear-lobe --lobe <key> Soft-delete all memories in a lobe
|
|
45
|
-
add-memories --input JSON Bulk-queue memories for processing
|
|
46
|
-
rpc <procedure> [--input JSON] Call a top-level oRPC procedure directly
|
|
47
|
-
|
|
48
|
-
Search options (for \`search\`):
|
|
49
|
-
--query <text> Query string (also accepted positionally)
|
|
50
|
-
--lobe <key> Restrict to a single lobe
|
|
51
|
-
--limit <n> Max hits to return (default 10)
|
|
52
|
-
--threshold <f> Min cosine similarity for vector pool (default 0.2)
|
|
53
|
-
--mode <m> fast | adaptive | reflective (default fast)
|
|
54
|
-
--no-graph Disable 1-hop graph expansion
|
|
55
|
-
--graph-per-seed <n> Max graph neighbors per seed (default 3)
|
|
56
|
-
--graph-max <n> Max total graph neighbors (default 10)
|
|
57
|
-
|
|
58
|
-
Global options:
|
|
59
|
-
--base-url <url> API base URL (default: packages/cli/.env or .env.prod)
|
|
60
|
-
--api-key <key> API key for protected procedures
|
|
61
|
-
--cookie <cookie> Session cookie for protected procedures
|
|
62
|
-
--json Always print JSON output
|
|
63
|
-
-h, --help Show this help text
|
|
64
|
-
|
|
65
|
-
Environment:
|
|
66
|
-
packages/cli/.env Package-local env file
|
|
67
|
-
packages/cli/.env.prod Loaded when MERRAI_ENV=prod or NODE_ENV=production
|
|
68
|
-
packages/cli/.env.local Local override file
|
|
69
|
-
MERRAI_ENV=prod Enables packages/cli/.env.prod
|
|
70
|
-
MERRAI_BASE_URL Default for --base-url
|
|
71
|
-
MERRAI_API_KEY Default for --api-key
|
|
72
|
-
MERRAI_COOKIE Default for --cookie
|
|
73
|
-
`;
|
|
74
|
-
const parseArgs = (argv) => {
|
|
75
|
-
const flags = {};
|
|
76
|
-
const positionals = [];
|
|
77
|
-
for (let index = 0; index < argv.length; index++) {
|
|
78
|
-
const token = argv[index];
|
|
79
|
-
if (!token) continue;
|
|
80
|
-
if (token === "-h") {
|
|
81
|
-
flags.help = true;
|
|
82
|
-
continue;
|
|
83
|
-
}
|
|
84
|
-
if (!token.startsWith("--")) {
|
|
85
|
-
positionals.push(token);
|
|
86
|
-
continue;
|
|
87
|
-
}
|
|
88
|
-
const [rawKey = "", inlineValue] = token.slice(2).split("=", 2);
|
|
89
|
-
const nextToken = argv[index + 1];
|
|
90
|
-
const hasNextValue = inlineValue === void 0 && nextToken !== void 0 && !nextToken.startsWith("-");
|
|
91
|
-
flags[rawKey] = inlineValue ?? (hasNextValue ? argv[++index] ?? "" : true);
|
|
92
|
-
}
|
|
93
|
-
return {
|
|
94
|
-
flags,
|
|
95
|
-
positionals
|
|
96
|
-
};
|
|
97
|
-
};
|
|
98
|
-
const getStringFlag = (flags, key) => {
|
|
99
|
-
const value = flags[key];
|
|
100
|
-
return typeof value === "string" ? value : void 0;
|
|
101
|
-
};
|
|
102
|
-
const getBooleanFlag = (flags, key) => flags[key] === true;
|
|
103
|
-
const parseJson = (value, flagName) => {
|
|
104
|
-
try {
|
|
105
|
-
return JSON.parse(value);
|
|
106
|
-
} catch (error) {
|
|
107
|
-
throw new Error(`Invalid JSON passed to ${flagName}: ${error instanceof Error ? error.message : String(error)}`);
|
|
108
|
-
}
|
|
109
|
-
};
|
|
110
|
-
const printOutput = (value, forceJson) => {
|
|
111
|
-
if (!forceJson && typeof value === "string") {
|
|
112
|
-
console.log(value);
|
|
113
|
-
return;
|
|
114
|
-
}
|
|
115
|
-
console.log(JSON.stringify(value, null, 2));
|
|
116
|
-
};
|
|
117
|
-
const printError = (error) => {
|
|
118
|
-
if (error instanceof ORPCError) {
|
|
119
|
-
const suffix = error.data ? `\n${JSON.stringify(error.data, null, 2)}` : "";
|
|
120
|
-
console.error(`oRPC ${error.status} ${error.code}: ${error.message}${suffix}`);
|
|
121
|
-
return;
|
|
122
|
-
}
|
|
123
|
-
if (error instanceof Error) {
|
|
124
|
-
console.error(error.message);
|
|
125
|
-
return;
|
|
126
|
-
}
|
|
127
|
-
console.error(String(error));
|
|
128
|
-
};
|
|
129
|
-
const requireString = (value, message) => {
|
|
130
|
-
if (!value) throw new Error(message);
|
|
131
|
-
return value;
|
|
132
|
-
};
|
|
133
|
-
const main = async () => {
|
|
134
|
-
loadPackageEnv();
|
|
135
|
-
const parsed = parseArgs(process.argv.slice(2));
|
|
136
|
-
const [command] = parsed.positionals;
|
|
137
|
-
if (!command || getBooleanFlag(parsed.flags, "help")) {
|
|
138
|
-
console.log(HELP_TEXT);
|
|
139
|
-
return;
|
|
140
|
-
}
|
|
141
|
-
const baseURL = getStringFlag(parsed.flags, "base-url") ?? process.env.MERRAI_BASE_URL;
|
|
142
|
-
const client = createMerraiClient({
|
|
143
|
-
apiKey: getStringFlag(parsed.flags, "api-key") ?? process.env.MERRAI_API_KEY,
|
|
144
|
-
baseURL,
|
|
145
|
-
cookie: getStringFlag(parsed.flags, "cookie") ?? process.env.MERRAI_COOKIE
|
|
146
|
-
});
|
|
147
|
-
const forceJson = getBooleanFlag(parsed.flags, "json");
|
|
148
|
-
let output;
|
|
149
|
-
switch (command) {
|
|
150
|
-
case "health": {
|
|
151
|
-
const [error, data] = await client.healthCheck();
|
|
152
|
-
if (error) throw error;
|
|
153
|
-
output = data;
|
|
154
|
-
break;
|
|
155
|
-
}
|
|
156
|
-
case "session": {
|
|
157
|
-
const [error, data] = await client.session();
|
|
158
|
-
if (error) throw error;
|
|
159
|
-
output = data;
|
|
160
|
-
break;
|
|
161
|
-
}
|
|
162
|
-
case "memories": {
|
|
163
|
-
const [error, data] = await client.memories();
|
|
164
|
-
if (error) throw error;
|
|
165
|
-
output = data;
|
|
166
|
-
break;
|
|
167
|
-
}
|
|
168
|
-
case "usage-summary": {
|
|
169
|
-
const [error, data] = await client.usageSummary();
|
|
170
|
-
if (error) throw error;
|
|
171
|
-
output = data;
|
|
172
|
-
break;
|
|
173
|
-
}
|
|
174
|
-
case "add-memory": {
|
|
175
|
-
const memory = requireString(getStringFlag(parsed.flags, "memory") ?? parsed.positionals[1], "add-memory requires --memory <text> or a positional memory string");
|
|
176
|
-
const source = getStringFlag(parsed.flags, "source");
|
|
177
|
-
const lobeKey = getStringFlag(parsed.flags, "lobe") ?? getStringFlag(parsed.flags, "lobe-key");
|
|
178
|
-
const [error, data] = await client.addMemory({
|
|
179
|
-
memory,
|
|
180
|
-
source,
|
|
181
|
-
lobeKey
|
|
182
|
-
});
|
|
183
|
-
if (error) throw error;
|
|
184
|
-
output = data;
|
|
185
|
-
break;
|
|
186
|
-
}
|
|
187
|
-
case "search": {
|
|
188
|
-
const query = requireString(getStringFlag(parsed.flags, "query") ?? parsed.positionals[1], "search requires --query <text> or a positional query string");
|
|
189
|
-
const lobeKey = getStringFlag(parsed.flags, "lobe") ?? getStringFlag(parsed.flags, "lobe-key");
|
|
190
|
-
const limitFlag = getStringFlag(parsed.flags, "limit");
|
|
191
|
-
const thresholdFlag = getStringFlag(parsed.flags, "threshold");
|
|
192
|
-
const modeFlag = getStringFlag(parsed.flags, "mode");
|
|
193
|
-
if (modeFlag !== void 0 && modeFlag !== "fast" && modeFlag !== "adaptive" && modeFlag !== "reflective") throw new Error("--mode must be one of: fast, adaptive, reflective");
|
|
194
|
-
const noGraph = getBooleanFlag(parsed.flags, "no-graph");
|
|
195
|
-
const graphPerSeedFlag = getStringFlag(parsed.flags, "graph-per-seed");
|
|
196
|
-
const graphMaxFlag = getStringFlag(parsed.flags, "graph-max");
|
|
197
|
-
const graph = noGraph || graphPerSeedFlag || graphMaxFlag ? {
|
|
198
|
-
...noGraph ? { enabled: false } : {},
|
|
199
|
-
...graphPerSeedFlag ? { maxNeighborsPerSeed: Number.parseInt(graphPerSeedFlag, 10) } : {},
|
|
200
|
-
...graphMaxFlag ? { maxTotalNeighbors: Number.parseInt(graphMaxFlag, 10) } : {}
|
|
201
|
-
} : void 0;
|
|
202
|
-
const [error, data] = await client.searchMemories({
|
|
203
|
-
query,
|
|
204
|
-
...lobeKey ? { lobeKey } : {},
|
|
205
|
-
...limitFlag ? { limit: Number.parseInt(limitFlag, 10) } : {},
|
|
206
|
-
...thresholdFlag ? { threshold: Number.parseFloat(thresholdFlag) } : {},
|
|
207
|
-
...modeFlag ? { mode: modeFlag } : {},
|
|
208
|
-
...graph ? { graph } : {}
|
|
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
|
-
}
|
|
235
|
-
case "rpc": {
|
|
236
|
-
const procedureName = requireString(parsed.positionals[1], "rpc requires a top-level procedure name");
|
|
237
|
-
const procedure = client[procedureName];
|
|
238
|
-
if (typeof procedure !== "function") throw new Error(`Unknown procedure: ${procedureName}`);
|
|
239
|
-
const inputFlag = getStringFlag(parsed.flags, "input");
|
|
240
|
-
const [error, data] = await procedure(inputFlag ? parseJson(inputFlag, "--input") : void 0);
|
|
241
|
-
if (error) throw error;
|
|
242
|
-
output = data;
|
|
243
|
-
break;
|
|
244
|
-
}
|
|
245
|
-
default: throw new Error(`Unknown command: ${command}`);
|
|
246
|
-
}
|
|
247
|
-
printOutput(output, forceJson);
|
|
248
|
-
};
|
|
249
|
-
main().catch((error) => {
|
|
250
|
-
printError(error);
|
|
251
|
-
process.exitCode = 1;
|
|
252
|
-
});
|
|
253
|
-
|
|
254
|
-
//#endregion
|
|
255
|
-
export { };
|
|
256
|
-
//# sourceMappingURL=cli.mjs.map
|
package/dist/cli.mjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/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> Hybrid search (vector + FTS + 1-hop graph)\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\nSearch options (for \\`search\\`):\n --query <text> Query string (also accepted positionally)\n --lobe <key> Restrict to a single lobe\n --limit <n> Max hits to return (default 10)\n --threshold <f> Min cosine similarity for vector pool (default 0.2)\n --mode <m> fast | adaptive | reflective (default fast)\n --no-graph Disable 1-hop graph expansion\n --graph-per-seed <n> Max graph neighbors per seed (default 3)\n --graph-max <n> Max total graph neighbors (default 10)\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 modeFlag = getStringFlag(parsed.flags, \"mode\");\n if (\n modeFlag !== undefined &&\n modeFlag !== \"fast\" &&\n modeFlag !== \"adaptive\" &&\n modeFlag !== \"reflective\"\n ) {\n throw new Error(\"--mode must be one of: fast, adaptive, reflective\");\n }\n const noGraph = getBooleanFlag(parsed.flags, \"no-graph\");\n const graphPerSeedFlag = getStringFlag(parsed.flags, \"graph-per-seed\");\n const graphMaxFlag = getStringFlag(parsed.flags, \"graph-max\");\n const graph =\n noGraph || graphPerSeedFlag || graphMaxFlag\n ? {\n ...(noGraph ? { enabled: false } : {}),\n ...(graphPerSeedFlag\n ? {\n maxNeighborsPerSeed: Number.parseInt(graphPerSeedFlag, 10),\n }\n : {}),\n ...(graphMaxFlag\n ? {\n maxTotalNeighbors: Number.parseInt(graphMaxFlag, 10),\n }\n : {}),\n }\n : undefined;\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 ...(modeFlag ? { mode: modeFlag } : {}),\n ...(graph ? { graph } : {}),\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(\n lobeKey ? { lobeKey } : {}\n );\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/dist/client-BirYnOM4.mjs
DELETED
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
import { createORPCClient, createSafeClient } from "@orpc/client";
|
|
2
|
-
import { RPCLink } from "@orpc/client/fetch";
|
|
3
|
-
|
|
4
|
-
//#region src/client.ts
|
|
5
|
-
const resolveBaseURL = (baseURL) => {
|
|
6
|
-
const resolved = baseURL?.trim();
|
|
7
|
-
if (!resolved) throw new Error("baseURL is required. Set --base-url or MERRAI_BASE_URL in the CLI env file");
|
|
8
|
-
return resolved.endsWith("/") ? resolved.slice(0, -1) : resolved;
|
|
9
|
-
};
|
|
10
|
-
const resolveHeaders = (headers, apiKey, cookie) => {
|
|
11
|
-
const resolvedHeaders = new Headers(headers);
|
|
12
|
-
if (apiKey) resolvedHeaders.set("x-api-key", apiKey);
|
|
13
|
-
if (cookie) resolvedHeaders.set("Cookie", cookie);
|
|
14
|
-
return Object.fromEntries(resolvedHeaders.entries());
|
|
15
|
-
};
|
|
16
|
-
const createRawMerraiClient = (options = {}) => {
|
|
17
|
-
return createORPCClient(new RPCLink({
|
|
18
|
-
url: `${resolveBaseURL(options.baseURL)}/rpc`,
|
|
19
|
-
headers: () => resolveHeaders(options.headers, options.apiKey, options.cookie),
|
|
20
|
-
fetch: options.fetch
|
|
21
|
-
}));
|
|
22
|
-
};
|
|
23
|
-
const createMerraiClient = (options = {}) => createSafeClient(createRawMerraiClient(options));
|
|
24
|
-
|
|
25
|
-
//#endregion
|
|
26
|
-
export { createRawMerraiClient as n, resolveBaseURL as r, createMerraiClient as t };
|
|
27
|
-
//# sourceMappingURL=client-BirYnOM4.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"client-BirYnOM4.mjs","names":[],"sources":["../src/client.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 mode?: \"fast\" | \"adaptive\" | \"reflective\";\n graph?: {\n enabled?: boolean;\n maxNeighborsPerSeed?: number;\n maxTotalNeighbors?: number;\n };\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"],"mappings":";;;;AA8DA,MAAa,kBAAkB,YAAqB;CAClD,MAAM,WAAW,SAAS,MAAM;AAEhC,KAAI,CAAC,SACH,OAAM,IAAI,MACR,6EACD;AAGH,QAAO,SAAS,SAAS,IAAI,GAAG,SAAS,MAAM,GAAG,GAAG,GAAG;;AAG1D,MAAM,kBACJ,SACA,QACA,WAC2B;CAC3B,MAAM,kBAAkB,IAAI,QAAQ,QAAQ;AAE5C,KAAI,OACF,iBAAgB,IAAI,aAAa,OAAO;AAG1C,KAAI,OACF,iBAAgB,IAAI,UAAU,OAAO;AAGvC,QAAO,OAAO,YAAY,gBAAgB,SAAS,CAAC;;AAGtD,MAAa,yBAAyB,UAA+B,EAAE,KAAK;AAQ1E,QAAO,iBAPM,IAAI,QAAQ;EACvB,KAAK,GAAG,eAAe,QAAQ,QAAQ,CAAC;EACxC,eACE,eAAe,QAAQ,SAAS,QAAQ,QAAQ,QAAQ,OAAO;EACjE,OAAO,QAAQ;EAChB,CAAC,CAE2B;;AAG/B,MAAa,sBAAsB,UAA+B,EAAE,KAClE,iBAAiB,sBAAsB,QAAQ,CAAC"}
|