@remnic/hermes-provider 1.0.2 → 9.3.515

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.
Files changed (4) hide show
  1. package/dist/index.d.ts +3 -1
  2. package/dist/index.js +37 -5
  3. package/dist/index.js.map +1 -1
  4. package/package.json +3 -2
package/dist/index.d.ts CHANGED
@@ -107,12 +107,13 @@ interface RecallOptions {
107
107
  topK?: number;
108
108
  mode?: "auto" | "no_recall" | "minimal" | "full" | "graph_mode";
109
109
  includeDebug?: boolean;
110
+ idempotencyKey?: string;
110
111
  }
111
112
  interface ObserveOptions {
112
113
  namespace?: string;
113
114
  skipExtraction?: boolean;
114
115
  }
115
- type MessagePartSourceFormat = "openai" | "anthropic" | "openclaw" | "lossless-claw" | "remnic";
116
+ type MessagePartSourceFormat = "openai" | "anthropic" | "openclaw" | "pi" | "lossless-claw" | "remnic";
116
117
  type LcmMessagePartKind = "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
117
118
  interface ObserveMessagePart {
118
119
  ordinal?: number;
@@ -197,6 +198,7 @@ declare class HermesClient {
197
198
  }): Promise<EngramAccessLcmSearchResponse>;
198
199
  private queryString;
199
200
  private request;
201
+ private parseErrorResponse;
200
202
  }
201
203
 
202
204
  export { type EngramAccessEntityGetResponse, type EngramAccessEntityListResponse, type EngramAccessHealthResponse, type EngramAccessLcmSearchResponse, type EngramAccessMemoryBrowseResponse, type EngramAccessMemoryGetResponse, type EngramAccessObserveResponse, type EngramAccessRecallResponse, type EngramAccessWriteResponse, HermesClient, type HermesClientOptions, HermesError, type LcmMessagePartKind, type MemoryStoreRequest, type MessagePartSourceFormat, type ObserveMessage, type ObserveMessagePart, type ObserveOptions, type RecallOptions };
package/dist/index.js CHANGED
@@ -12,6 +12,9 @@ var HermesError = class extends Error {
12
12
  code;
13
13
  details;
14
14
  };
15
+ function hasNonEmptyIdempotencyKey(value) {
16
+ return typeof value === "string" && value.trim().length > 0;
17
+ }
15
18
  var HermesClient = class {
16
19
  baseUrl;
17
20
  authToken;
@@ -46,7 +49,10 @@ var HermesClient = class {
46
49
  if (options?.topK !== void 0) body.topK = options.topK;
47
50
  if (options?.mode) body.mode = options.mode;
48
51
  if (options?.includeDebug !== void 0) body.includeDebug = options.includeDebug;
49
- return this.request("POST", "/engram/v1/recall", body, { noRetry: true });
52
+ if (options?.idempotencyKey) body.idempotencyKey = options.idempotencyKey;
53
+ return this.request("POST", "/engram/v1/recall", body, {
54
+ noRetry: !options?.idempotencyKey
55
+ });
50
56
  }
51
57
  async observe(sessionKey, messages, options) {
52
58
  const body = {
@@ -63,7 +69,9 @@ var HermesClient = class {
63
69
  namespace: request.namespace ?? this.defaultNamespace,
64
70
  sessionKey: request.sessionKey ?? this.defaultSessionKey
65
71
  };
66
- return this.request("POST", "/engram/v1/memories", body, { noRetry: true });
72
+ return this.request("POST", "/engram/v1/memories", body, {
73
+ noRetry: !hasNonEmptyIdempotencyKey(request.idempotencyKey)
74
+ });
67
75
  }
68
76
  async submitSuggestion(request) {
69
77
  const body = {
@@ -71,7 +79,9 @@ var HermesClient = class {
71
79
  namespace: request.namespace ?? this.defaultNamespace,
72
80
  sessionKey: request.sessionKey ?? this.defaultSessionKey
73
81
  };
74
- return this.request("POST", "/engram/v1/suggestions", body, { noRetry: true });
82
+ return this.request("POST", "/engram/v1/suggestions", body, {
83
+ noRetry: !hasNonEmptyIdempotencyKey(request.idempotencyKey)
84
+ });
75
85
  }
76
86
  // -----------------------------------------------------------------------
77
87
  // Browse / read methods
@@ -186,18 +196,22 @@ var HermesClient = class {
186
196
  const retryAfter = response.headers.get("retry-after");
187
197
  let waitMs = this.retryBaseDelayMs * 4;
188
198
  if (retryAfter) {
189
- const parsed = parseInt(retryAfter, 10);
199
+ const trimmedRetryAfter = retryAfter.trim();
200
+ const parsed = /^[0-9]+$/.test(trimmedRetryAfter) ? Number(trimmedRetryAfter) : Number.NaN;
190
201
  if (Number.isFinite(parsed) && parsed > 0) {
191
202
  waitMs = parsed * 1e3;
192
203
  }
193
204
  }
194
205
  const errorBody = await response.json().catch(() => ({ error: "rate_limited", code: "rate_limited" }));
195
206
  lastRateLimitError = new HermesError(429, errorBody.code ?? "rate_limited", errorBody.error);
207
+ if (attempt >= maxAttempts - 1) {
208
+ throw lastRateLimitError;
209
+ }
196
210
  await new Promise((resolve) => setTimeout(resolve, waitMs));
197
211
  continue;
198
212
  }
199
213
  if (response.status >= 400 && response.status < 500) {
200
- const error = await response.json();
214
+ const error = await this.parseErrorResponse(response);
201
215
  throw new HermesError(
202
216
  response.status,
203
217
  error.code ?? `http_${response.status}`,
@@ -221,6 +235,24 @@ var HermesClient = class {
221
235
  if (lastRateLimitError) throw lastRateLimitError;
222
236
  throw lastError ?? new Error("request failed after retries");
223
237
  }
238
+ async parseErrorResponse(response) {
239
+ try {
240
+ const parsed = await response.json();
241
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
242
+ const error = parsed;
243
+ return {
244
+ error: typeof error.error === "string" && error.error.trim() ? error.error : response.statusText || `HTTP ${response.status}`,
245
+ code: typeof error.code === "string" && error.code.trim() ? error.code : void 0,
246
+ details: Array.isArray(error.details) ? error.details.filter((detail) => detail !== null && typeof detail === "object" && typeof detail.field === "string" && typeof detail.message === "string") : void 0
247
+ };
248
+ }
249
+ } catch {
250
+ }
251
+ return {
252
+ error: response.statusText || `HTTP ${response.status}`,
253
+ code: `http_${response.status}`
254
+ };
255
+ }
224
256
  };
225
257
  export {
226
258
  HermesClient,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @remnic/hermes-provider\n *\n * Typed HTTP client for the Remnic memory API.\n *\n * Usage:\n * const client = new HermesClient({ baseUrl: \"http://127.0.0.1:4318\", authToken: \"secret\" });\n * const health = await client.health();\n * const memories = await client.recall(\"what did I work on last week?\");\n */\n\n// ---------------------------------------------------------------------------\n// Configuration\n// ---------------------------------------------------------------------------\n\nexport interface HermesClientOptions {\n /** Base URL of the Engram HTTP server (e.g. \"http://127.0.0.1:4318\") */\n baseUrl: string;\n /** Bearer token for authentication */\n authToken: string;\n /** Default namespace for requests (optional) */\n namespace?: string;\n /** Default session key (optional) */\n sessionKey?: string;\n /** Max retries for server errors (default: 3) */\n maxRetries?: number;\n /** Base delay in ms between retries (default: 100) */\n retryBaseDelayMs?: number;\n /** Request timeout in ms (default: 5000) */\n timeoutMs?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Response types\n// ---------------------------------------------------------------------------\n\nexport interface EngramAccessHealthResponse {\n ok: boolean;\n memoryDir: string;\n namespacesEnabled: boolean;\n defaultNamespace: string;\n searchBackend: string;\n qmdEnabled: boolean;\n nativeKnowledgeEnabled: boolean;\n projectionAvailable: boolean;\n}\n\nexport interface EngramAccessRecallResponse {\n context?: string;\n results?: Array<{ id: string; content: string; score?: number; category?: string }>;\n count?: number;\n traceId?: string;\n plannerMode?: string;\n fallbackUsed?: boolean;\n sourcesUsed?: string[];\n budgetsApplied?: Record<string, unknown>;\n latencyMs?: number;\n}\n\nexport interface EngramAccessObserveResponse {\n accepted: number;\n sessionKey: string;\n namespace?: string;\n lcmArchived?: boolean;\n extractionQueued?: boolean;\n}\n\nexport interface EngramAccessWriteResponse {\n memoryId?: string;\n status: string;\n dryRun?: boolean;\n idempotencyReplay?: boolean;\n path?: string;\n duplicateOf?: string;\n idempotencyKey?: string;\n}\n\nexport interface EngramAccessEntityListResponse {\n entities: Array<{ name: string; type: string; factCount?: number }>;\n total: number;\n}\n\nexport interface EngramAccessEntityGetResponse {\n found: boolean;\n entity?: { name: string; type: string; observations?: string[] };\n}\n\nexport interface EngramAccessMemoryBrowseResponse {\n memories: Array<Record<string, unknown>>;\n total: number;\n}\n\nexport interface EngramAccessMemoryGetResponse {\n found: boolean;\n memory?: Record<string, unknown>;\n}\n\nexport interface EngramAccessLcmSearchResponse {\n query: string;\n namespace?: string;\n results: Array<{ sessionId?: string; content?: string; turnIndex?: number }>;\n count: number;\n lcmEnabled: boolean;\n}\n\nexport interface RecallOptions {\n sessionKey?: string;\n namespace?: string;\n topK?: number;\n mode?: \"auto\" | \"no_recall\" | \"minimal\" | \"full\" | \"graph_mode\";\n includeDebug?: boolean;\n}\n\nexport interface ObserveOptions {\n namespace?: string;\n skipExtraction?: boolean;\n}\n\nexport type MessagePartSourceFormat =\n | \"openai\"\n | \"anthropic\"\n | \"openclaw\"\n | \"lossless-claw\"\n | \"remnic\";\n\nexport type LcmMessagePartKind =\n | \"text\"\n | \"tool_call\"\n | \"tool_result\"\n | \"patch\"\n | \"file_read\"\n | \"file_write\"\n | \"step_start\"\n | \"step_finish\"\n | \"snapshot\"\n | \"retry\";\n\nexport interface ObserveMessagePart {\n ordinal?: number;\n kind: LcmMessagePartKind;\n payload: Record<string, unknown>;\n toolName?: string | null;\n filePath?: string | null;\n createdAt?: string | null;\n}\n\nexport interface ObserveMessage {\n role: \"user\" | \"assistant\";\n content: string;\n sourceFormat?: MessagePartSourceFormat;\n rawContent?: unknown;\n parts?: ObserveMessagePart[];\n}\n\nexport interface MemoryStoreRequest {\n content: string;\n category?: string;\n confidence?: number;\n tags?: string[];\n entityRef?: string;\n ttl?: string;\n sourceReason?: string;\n sessionKey?: string;\n namespace?: string;\n idempotencyKey?: string;\n dryRun?: boolean;\n schemaVersion?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Error types\n// ---------------------------------------------------------------------------\n\nexport class HermesError extends Error {\n constructor(\n readonly status: number,\n readonly code: string,\n message: string,\n readonly details?: Array<{ field: string; message: string }>,\n ) {\n super(message);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport class HermesClient {\n private readonly baseUrl: string;\n private readonly authToken: string;\n private readonly defaultNamespace?: string;\n private readonly defaultSessionKey?: string;\n private readonly maxRetries: number;\n private readonly retryBaseDelayMs: number;\n private readonly timeoutMs: number;\n\n constructor(options: HermesClientOptions) {\n this.baseUrl = options.baseUrl.endsWith(\"/\") ? options.baseUrl.slice(0, -1) : options.baseUrl;\n this.authToken = options.authToken;\n this.defaultNamespace = options.namespace;\n this.defaultSessionKey = options.sessionKey;\n this.maxRetries = options.maxRetries ?? 3;\n this.retryBaseDelayMs = options.retryBaseDelayMs ?? 100;\n this.timeoutMs = options.timeoutMs ?? 5000;\n }\n\n // -----------------------------------------------------------------------\n // Core methods\n // -----------------------------------------------------------------------\n\n async health(): Promise<EngramAccessHealthResponse> {\n return this.request<EngramAccessHealthResponse>(\"GET\", \"/engram/v1/health\");\n }\n\n async recall(query: string, options?: RecallOptions): Promise<EngramAccessRecallResponse> {\n const body: Record<string, unknown> = {\n query,\n };\n const sk = options?.sessionKey ?? this.defaultSessionKey;\n if (sk) body.sessionKey = sk;\n const ns = options?.namespace ?? this.defaultNamespace;\n if (ns) body.namespace = ns;\n if (options?.topK !== undefined) body.topK = options.topK;\n if (options?.mode) body.mode = options.mode;\n if (options?.includeDebug !== undefined) body.includeDebug = options.includeDebug;\n return this.request<EngramAccessRecallResponse>(\"POST\", \"/engram/v1/recall\", body, { noRetry: true });\n }\n\n async observe(\n sessionKey: string,\n messages: ObserveMessage[],\n options?: ObserveOptions,\n ): Promise<EngramAccessObserveResponse> {\n const body: Record<string, unknown> = {\n sessionKey,\n messages,\n namespace: options?.namespace ?? this.defaultNamespace,\n skipExtraction: options?.skipExtraction ?? false,\n };\n return this.request<EngramAccessObserveResponse>(\"POST\", \"/engram/v1/observe\", body, { noRetry: true });\n }\n\n async store(request: MemoryStoreRequest): Promise<EngramAccessWriteResponse> {\n const body: Record<string, unknown> = {\n ...request,\n namespace: request.namespace ?? this.defaultNamespace,\n sessionKey: request.sessionKey ?? this.defaultSessionKey,\n };\n return this.request<EngramAccessWriteResponse>(\"POST\", \"/engram/v1/memories\", body, { noRetry: true });\n }\n\n async submitSuggestion(request: MemoryStoreRequest): Promise<EngramAccessWriteResponse> {\n const body: Record<string, unknown> = {\n ...request,\n namespace: request.namespace ?? this.defaultNamespace,\n sessionKey: request.sessionKey ?? this.defaultSessionKey,\n };\n return this.request<EngramAccessWriteResponse>(\"POST\", \"/engram/v1/suggestions\", body, { noRetry: true });\n }\n\n // -----------------------------------------------------------------------\n // Browse / read methods\n // -----------------------------------------------------------------------\n\n async getEntities(options?: {\n namespace?: string;\n query?: string;\n limit?: number;\n offset?: number;\n }): Promise<EngramAccessEntityListResponse> {\n const params: Record<string, unknown> = {\n namespace: options?.namespace ?? this.defaultNamespace,\n };\n if (options?.query) params.q = options.query;\n if (options?.limit !== undefined) params.limit = options.limit;\n if (options?.offset !== undefined) params.offset = options.offset;\n return this.request<EngramAccessEntityListResponse>(\n \"GET\",\n `/engram/v1/entities${this.queryString(params)}`,\n );\n }\n\n async getEntity(name: string, options?: { namespace?: string }): Promise<EngramAccessEntityGetResponse> {\n try {\n return await this.request<EngramAccessEntityGetResponse>(\n \"GET\",\n `/engram/v1/entities/${encodeURIComponent(name)}${this.queryString({ namespace: options?.namespace ?? this.defaultNamespace })}`,\n );\n } catch (err) {\n // 404 is a valid \"not found\" response for entity lookups\n if (err instanceof HermesError && err.status === 404) {\n return { found: false };\n }\n throw err;\n }\n }\n\n async getMemories(options?: {\n query?: string;\n status?: string;\n category?: string;\n namespace?: string;\n sort?: string;\n limit?: number;\n offset?: number;\n }): Promise<EngramAccessMemoryBrowseResponse> {\n const params: Record<string, unknown> = {\n namespace: options?.namespace ?? this.defaultNamespace,\n };\n // The HTTP API uses `q` for the search query parameter\n if (options?.query) params.q = options.query;\n if (options?.status) params.status = options.status;\n if (options?.category) params.category = options.category;\n if (options?.sort) params.sort = options.sort;\n if (options?.limit !== undefined) params.limit = options.limit;\n if (options?.offset !== undefined) params.offset = options.offset;\n return this.request<EngramAccessMemoryBrowseResponse>(\n \"GET\",\n `/engram/v1/memories${this.queryString(params)}`,\n );\n }\n\n async getMemory(id: string, options?: { namespace?: string }): Promise<EngramAccessMemoryGetResponse> {\n try {\n return await this.request<EngramAccessMemoryGetResponse>(\n \"GET\",\n `/engram/v1/memories/${encodeURIComponent(id)}${this.queryString({ namespace: options?.namespace ?? this.defaultNamespace })}`,\n );\n } catch (err) {\n // 404 is a valid \"not found\" response, not an error\n if (err instanceof HermesError && err.status === 404) {\n return { found: false };\n }\n throw err;\n }\n }\n\n async lcmSearch(\n query: string,\n options?: { sessionKey?: string; namespace?: string; limit?: number },\n ): Promise<EngramAccessLcmSearchResponse> {\n const body: Record<string, unknown> = {\n query,\n sessionKey: options?.sessionKey ?? this.defaultSessionKey,\n namespace: options?.namespace ?? this.defaultNamespace,\n ...(options?.limit !== undefined ? { limit: options.limit } : {}),\n };\n return this.request<EngramAccessLcmSearchResponse>(\"POST\", \"/engram/v1/lcm/search\", body);\n }\n\n // -----------------------------------------------------------------------\n // Internal helpers\n // -----------------------------------------------------------------------\n\n private queryString(params?: Record<string, unknown>): string {\n if (!params) return \"\";\n const parts: string[] = [];\n for (const [key, value] of Object.entries(params)) {\n if (value !== undefined && value !== null && value !== \"\") {\n parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n }\n }\n return parts.length > 0 ? `?${parts.join(\"&\")}` : \"\";\n }\n\n private async request<T>(method: string, path: string, body?: Record<string, unknown>, options?: { noRetry?: boolean }): Promise<T> {\n // Skip retries for state-mutating writes to prevent duplicate side effects.\n // Read-only POST endpoints (recall, lcm/search) are safe to retry.\n const isMutating = options?.noRetry === true;\n const maxAttempts = isMutating ? 1 : this.maxRetries + 1;\n let lastError: Error | null = null;\n let lastRateLimitError: HermesError | null = null;\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n if (attempt > 0) {\n const delay = this.retryBaseDelayMs * Math.pow(2, attempt - 1);\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n\n let timeout: ReturnType<typeof setTimeout> | undefined;\n try {\n const url = `${this.baseUrl}${path}`;\n const controller = new AbortController();\n timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n const headers: Record<string, string> = {\n \"Authorization\": `Bearer ${this.authToken}`,\n \"Content-Type\": \"application/json\",\n };\n\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeout);\n timeout = undefined;\n\n // Success responses\n if (response.ok) {\n if (response.status === 204) return {} as T;\n return (await response.json()) as T;\n }\n\n // Rate-limited — back off and retry\n if (response.status === 429) {\n const retryAfter = response.headers.get(\"retry-after\");\n let waitMs = this.retryBaseDelayMs * 4;\n if (retryAfter) {\n const parsed = parseInt(retryAfter, 10);\n // Only use numeric seconds form; date-form Retry-After is ignored\n // (isNaN catches NaN from date-form headers like \"Fri, 04 Apr 2026\")\n if (Number.isFinite(parsed) && parsed > 0) {\n waitMs = parsed * 1000;\n }\n }\n const errorBody = await response.json().catch(() => ({ error: \"rate_limited\", code: \"rate_limited\" })) as { error: string; code?: string };\n lastRateLimitError = new HermesError(429, errorBody.code ?? \"rate_limited\", errorBody.error);\n await new Promise((resolve) => setTimeout(resolve, waitMs));\n continue;\n }\n\n // Client errors — do not retry\n if (response.status >= 400 && response.status < 500) {\n const error = (await response.json()) as {\n error: string;\n code?: string;\n details?: Array<{ field: string; message: string }>;\n };\n throw new HermesError(\n response.status,\n error.code ?? `http_${response.status}`,\n error.error,\n error.details,\n );\n }\n\n // Server error — retry\n lastError = new Error(`HTTP ${response.status}`);\n continue;\n } catch (err) {\n if (timeout !== undefined) clearTimeout(timeout);\n if (err instanceof HermesError) throw err;\n if (err instanceof DOMException && err.name === \"AbortError\") {\n lastError = new Error(`request timed out after ${this.timeoutMs}ms`);\n continue;\n }\n lastError = err as Error;\n continue;\n }\n }\n\n // If we exhausted retries due to rate limiting, throw the preserved 429 error\n if (lastRateLimitError) throw lastRateLimitError;\n throw lastError ?? new Error(\"request failed after retries\");\n }\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @remnic/hermes-provider\n *\n * Typed HTTP client for the Remnic memory API.\n *\n * Usage:\n * const client = new HermesClient({ baseUrl: \"http://127.0.0.1:4318\", authToken: \"secret\" });\n * const health = await client.health();\n * const memories = await client.recall(\"what did I work on last week?\");\n */\n\n// ---------------------------------------------------------------------------\n// Configuration\n// ---------------------------------------------------------------------------\n\nexport interface HermesClientOptions {\n /** Base URL of the Engram HTTP server (e.g. \"http://127.0.0.1:4318\") */\n baseUrl: string;\n /** Bearer token for authentication */\n authToken: string;\n /** Default namespace for requests (optional) */\n namespace?: string;\n /** Default session key (optional) */\n sessionKey?: string;\n /** Max retries for server errors (default: 3) */\n maxRetries?: number;\n /** Base delay in ms between retries (default: 100) */\n retryBaseDelayMs?: number;\n /** Request timeout in ms (default: 5000) */\n timeoutMs?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Response types\n// ---------------------------------------------------------------------------\n\nexport interface EngramAccessHealthResponse {\n ok: boolean;\n memoryDir: string;\n namespacesEnabled: boolean;\n defaultNamespace: string;\n searchBackend: string;\n qmdEnabled: boolean;\n nativeKnowledgeEnabled: boolean;\n projectionAvailable: boolean;\n}\n\nexport interface EngramAccessRecallResponse {\n context?: string;\n results?: Array<{ id: string; content: string; score?: number; category?: string }>;\n count?: number;\n traceId?: string;\n plannerMode?: string;\n fallbackUsed?: boolean;\n sourcesUsed?: string[];\n budgetsApplied?: Record<string, unknown>;\n latencyMs?: number;\n}\n\nexport interface EngramAccessObserveResponse {\n accepted: number;\n sessionKey: string;\n namespace?: string;\n lcmArchived?: boolean;\n extractionQueued?: boolean;\n}\n\nexport interface EngramAccessWriteResponse {\n memoryId?: string;\n status: string;\n dryRun?: boolean;\n idempotencyReplay?: boolean;\n path?: string;\n duplicateOf?: string;\n idempotencyKey?: string;\n}\n\nexport interface EngramAccessEntityListResponse {\n entities: Array<{ name: string; type: string; factCount?: number }>;\n total: number;\n}\n\nexport interface EngramAccessEntityGetResponse {\n found: boolean;\n entity?: { name: string; type: string; observations?: string[] };\n}\n\nexport interface EngramAccessMemoryBrowseResponse {\n memories: Array<Record<string, unknown>>;\n total: number;\n}\n\nexport interface EngramAccessMemoryGetResponse {\n found: boolean;\n memory?: Record<string, unknown>;\n}\n\nexport interface EngramAccessLcmSearchResponse {\n query: string;\n namespace?: string;\n results: Array<{ sessionId?: string; content?: string; turnIndex?: number }>;\n count: number;\n lcmEnabled: boolean;\n}\n\nexport interface RecallOptions {\n sessionKey?: string;\n namespace?: string;\n topK?: number;\n mode?: \"auto\" | \"no_recall\" | \"minimal\" | \"full\" | \"graph_mode\";\n includeDebug?: boolean;\n idempotencyKey?: string;\n}\n\nexport interface ObserveOptions {\n namespace?: string;\n skipExtraction?: boolean;\n}\n\nexport type MessagePartSourceFormat =\n | \"openai\"\n | \"anthropic\"\n | \"openclaw\"\n | \"pi\"\n | \"lossless-claw\"\n | \"remnic\";\n\nexport type LcmMessagePartKind =\n | \"text\"\n | \"tool_call\"\n | \"tool_result\"\n | \"patch\"\n | \"file_read\"\n | \"file_write\"\n | \"step_start\"\n | \"step_finish\"\n | \"snapshot\"\n | \"retry\";\n\nexport interface ObserveMessagePart {\n ordinal?: number;\n kind: LcmMessagePartKind;\n payload: Record<string, unknown>;\n toolName?: string | null;\n filePath?: string | null;\n createdAt?: string | null;\n}\n\nexport interface ObserveMessage {\n role: \"user\" | \"assistant\";\n content: string;\n sourceFormat?: MessagePartSourceFormat;\n rawContent?: unknown;\n parts?: ObserveMessagePart[];\n}\n\nexport interface MemoryStoreRequest {\n content: string;\n category?: string;\n confidence?: number;\n tags?: string[];\n entityRef?: string;\n ttl?: string;\n sourceReason?: string;\n sessionKey?: string;\n namespace?: string;\n idempotencyKey?: string;\n dryRun?: boolean;\n schemaVersion?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Error types\n// ---------------------------------------------------------------------------\n\nexport class HermesError extends Error {\n constructor(\n readonly status: number,\n readonly code: string,\n message: string,\n readonly details?: Array<{ field: string; message: string }>,\n ) {\n super(message);\n }\n}\n\nfunction hasNonEmptyIdempotencyKey(value: unknown): value is string {\n return typeof value === \"string\" && value.trim().length > 0;\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport class HermesClient {\n private readonly baseUrl: string;\n private readonly authToken: string;\n private readonly defaultNamespace?: string;\n private readonly defaultSessionKey?: string;\n private readonly maxRetries: number;\n private readonly retryBaseDelayMs: number;\n private readonly timeoutMs: number;\n\n constructor(options: HermesClientOptions) {\n this.baseUrl = options.baseUrl.endsWith(\"/\") ? options.baseUrl.slice(0, -1) : options.baseUrl;\n this.authToken = options.authToken;\n this.defaultNamespace = options.namespace;\n this.defaultSessionKey = options.sessionKey;\n this.maxRetries = options.maxRetries ?? 3;\n this.retryBaseDelayMs = options.retryBaseDelayMs ?? 100;\n this.timeoutMs = options.timeoutMs ?? 5000;\n }\n\n // -----------------------------------------------------------------------\n // Core methods\n // -----------------------------------------------------------------------\n\n async health(): Promise<EngramAccessHealthResponse> {\n return this.request<EngramAccessHealthResponse>(\"GET\", \"/engram/v1/health\");\n }\n\n async recall(query: string, options?: RecallOptions): Promise<EngramAccessRecallResponse> {\n const body: Record<string, unknown> = {\n query,\n };\n const sk = options?.sessionKey ?? this.defaultSessionKey;\n if (sk) body.sessionKey = sk;\n const ns = options?.namespace ?? this.defaultNamespace;\n if (ns) body.namespace = ns;\n if (options?.topK !== undefined) body.topK = options.topK;\n if (options?.mode) body.mode = options.mode;\n if (options?.includeDebug !== undefined) body.includeDebug = options.includeDebug;\n if (options?.idempotencyKey) body.idempotencyKey = options.idempotencyKey;\n return this.request<EngramAccessRecallResponse>(\"POST\", \"/engram/v1/recall\", body, {\n noRetry: !options?.idempotencyKey,\n });\n }\n\n async observe(\n sessionKey: string,\n messages: ObserveMessage[],\n options?: ObserveOptions,\n ): Promise<EngramAccessObserveResponse> {\n const body: Record<string, unknown> = {\n sessionKey,\n messages,\n namespace: options?.namespace ?? this.defaultNamespace,\n skipExtraction: options?.skipExtraction ?? false,\n };\n return this.request<EngramAccessObserveResponse>(\"POST\", \"/engram/v1/observe\", body, { noRetry: true });\n }\n\n async store(request: MemoryStoreRequest): Promise<EngramAccessWriteResponse> {\n const body: Record<string, unknown> = {\n ...request,\n namespace: request.namespace ?? this.defaultNamespace,\n sessionKey: request.sessionKey ?? this.defaultSessionKey,\n };\n return this.request<EngramAccessWriteResponse>(\"POST\", \"/engram/v1/memories\", body, {\n noRetry: !hasNonEmptyIdempotencyKey(request.idempotencyKey),\n });\n }\n\n async submitSuggestion(request: MemoryStoreRequest): Promise<EngramAccessWriteResponse> {\n const body: Record<string, unknown> = {\n ...request,\n namespace: request.namespace ?? this.defaultNamespace,\n sessionKey: request.sessionKey ?? this.defaultSessionKey,\n };\n return this.request<EngramAccessWriteResponse>(\"POST\", \"/engram/v1/suggestions\", body, {\n noRetry: !hasNonEmptyIdempotencyKey(request.idempotencyKey),\n });\n }\n\n // -----------------------------------------------------------------------\n // Browse / read methods\n // -----------------------------------------------------------------------\n\n async getEntities(options?: {\n namespace?: string;\n query?: string;\n limit?: number;\n offset?: number;\n }): Promise<EngramAccessEntityListResponse> {\n const params: Record<string, unknown> = {\n namespace: options?.namespace ?? this.defaultNamespace,\n };\n if (options?.query) params.q = options.query;\n if (options?.limit !== undefined) params.limit = options.limit;\n if (options?.offset !== undefined) params.offset = options.offset;\n return this.request<EngramAccessEntityListResponse>(\n \"GET\",\n `/engram/v1/entities${this.queryString(params)}`,\n );\n }\n\n async getEntity(name: string, options?: { namespace?: string }): Promise<EngramAccessEntityGetResponse> {\n try {\n return await this.request<EngramAccessEntityGetResponse>(\n \"GET\",\n `/engram/v1/entities/${encodeURIComponent(name)}${this.queryString({ namespace: options?.namespace ?? this.defaultNamespace })}`,\n );\n } catch (err) {\n // 404 is a valid \"not found\" response for entity lookups\n if (err instanceof HermesError && err.status === 404) {\n return { found: false };\n }\n throw err;\n }\n }\n\n async getMemories(options?: {\n query?: string;\n status?: string;\n category?: string;\n namespace?: string;\n sort?: string;\n limit?: number;\n offset?: number;\n }): Promise<EngramAccessMemoryBrowseResponse> {\n const params: Record<string, unknown> = {\n namespace: options?.namespace ?? this.defaultNamespace,\n };\n // The HTTP API uses `q` for the search query parameter\n if (options?.query) params.q = options.query;\n if (options?.status) params.status = options.status;\n if (options?.category) params.category = options.category;\n if (options?.sort) params.sort = options.sort;\n if (options?.limit !== undefined) params.limit = options.limit;\n if (options?.offset !== undefined) params.offset = options.offset;\n return this.request<EngramAccessMemoryBrowseResponse>(\n \"GET\",\n `/engram/v1/memories${this.queryString(params)}`,\n );\n }\n\n async getMemory(id: string, options?: { namespace?: string }): Promise<EngramAccessMemoryGetResponse> {\n try {\n return await this.request<EngramAccessMemoryGetResponse>(\n \"GET\",\n `/engram/v1/memories/${encodeURIComponent(id)}${this.queryString({ namespace: options?.namespace ?? this.defaultNamespace })}`,\n );\n } catch (err) {\n // 404 is a valid \"not found\" response, not an error\n if (err instanceof HermesError && err.status === 404) {\n return { found: false };\n }\n throw err;\n }\n }\n\n async lcmSearch(\n query: string,\n options?: { sessionKey?: string; namespace?: string; limit?: number },\n ): Promise<EngramAccessLcmSearchResponse> {\n const body: Record<string, unknown> = {\n query,\n sessionKey: options?.sessionKey ?? this.defaultSessionKey,\n namespace: options?.namespace ?? this.defaultNamespace,\n ...(options?.limit !== undefined ? { limit: options.limit } : {}),\n };\n return this.request<EngramAccessLcmSearchResponse>(\"POST\", \"/engram/v1/lcm/search\", body);\n }\n\n // -----------------------------------------------------------------------\n // Internal helpers\n // -----------------------------------------------------------------------\n\n private queryString(params?: Record<string, unknown>): string {\n if (!params) return \"\";\n const parts: string[] = [];\n for (const [key, value] of Object.entries(params)) {\n if (value !== undefined && value !== null && value !== \"\") {\n parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n }\n }\n return parts.length > 0 ? `?${parts.join(\"&\")}` : \"\";\n }\n\n private async request<T>(method: string, path: string, body?: Record<string, unknown>, options?: { noRetry?: boolean }): Promise<T> {\n // Skip retries for state-mutating writes to prevent duplicate side effects.\n // Read-only POST endpoints (recall, lcm/search) are safe to retry.\n const isMutating = options?.noRetry === true;\n const maxAttempts = isMutating ? 1 : this.maxRetries + 1;\n let lastError: Error | null = null;\n let lastRateLimitError: HermesError | null = null;\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n if (attempt > 0) {\n const delay = this.retryBaseDelayMs * Math.pow(2, attempt - 1);\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n\n let timeout: ReturnType<typeof setTimeout> | undefined;\n try {\n const url = `${this.baseUrl}${path}`;\n const controller = new AbortController();\n timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n const headers: Record<string, string> = {\n \"Authorization\": `Bearer ${this.authToken}`,\n \"Content-Type\": \"application/json\",\n };\n\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeout);\n timeout = undefined;\n\n // Success responses\n if (response.ok) {\n if (response.status === 204) return {} as T;\n return (await response.json()) as T;\n }\n\n // Rate-limited — back off and retry\n if (response.status === 429) {\n const retryAfter = response.headers.get(\"retry-after\");\n let waitMs = this.retryBaseDelayMs * 4;\n if (retryAfter) {\n const trimmedRetryAfter = retryAfter.trim();\n const parsed = /^[0-9]+$/.test(trimmedRetryAfter)\n ? Number(trimmedRetryAfter)\n : Number.NaN;\n // Only use the RFC seconds form when the entire header is digits.\n // Date-like or malformed values such as \"60 seconds\" are ignored\n // so parseInt() cannot turn a prefix into a long sleep.\n if (Number.isFinite(parsed) && parsed > 0) {\n waitMs = parsed * 1000;\n }\n }\n const errorBody = await response.json().catch(() => ({ error: \"rate_limited\", code: \"rate_limited\" })) as { error: string; code?: string };\n lastRateLimitError = new HermesError(429, errorBody.code ?? \"rate_limited\", errorBody.error);\n if (attempt >= maxAttempts - 1) {\n throw lastRateLimitError;\n }\n await new Promise((resolve) => setTimeout(resolve, waitMs));\n continue;\n }\n\n // Client errors — do not retry\n if (response.status >= 400 && response.status < 500) {\n const error = await this.parseErrorResponse(response);\n throw new HermesError(\n response.status,\n error.code ?? `http_${response.status}`,\n error.error,\n error.details,\n );\n }\n\n // Server error — retry\n lastError = new Error(`HTTP ${response.status}`);\n continue;\n } catch (err) {\n if (timeout !== undefined) clearTimeout(timeout);\n if (err instanceof HermesError) throw err;\n if (err instanceof DOMException && err.name === \"AbortError\") {\n lastError = new Error(`request timed out after ${this.timeoutMs}ms`);\n continue;\n }\n lastError = err as Error;\n continue;\n }\n }\n\n // If we exhausted retries due to rate limiting, throw the preserved 429 error\n if (lastRateLimitError) throw lastRateLimitError;\n throw lastError ?? new Error(\"request failed after retries\");\n }\n\n private async parseErrorResponse(response: Response): Promise<{\n error: string;\n code?: string;\n details?: Array<{ field: string; message: string }>;\n }> {\n try {\n const parsed = await response.json() as unknown;\n if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n const error = parsed as Record<string, unknown>;\n return {\n error: typeof error.error === \"string\" && error.error.trim() ? error.error : response.statusText || `HTTP ${response.status}`,\n code: typeof error.code === \"string\" && error.code.trim() ? error.code : undefined,\n details: Array.isArray(error.details)\n ? error.details.filter((detail): detail is { field: string; message: string } => (\n detail !== null\n && typeof detail === \"object\"\n && typeof (detail as { field?: unknown }).field === \"string\"\n && typeof (detail as { message?: unknown }).message === \"string\"\n ))\n : undefined,\n };\n }\n } catch {\n // Preserve the HTTP status for non-JSON or empty 4xx responses.\n }\n return {\n error: response.statusText || `HTTP ${response.status}`,\n code: `http_${response.status}`,\n };\n }\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@remnic/hermes-provider",
3
- "version": "1.0.2",
3
+ "version": "9.3.515",
4
4
  "description": "Typed HTTP client for the Remnic memory API",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -37,6 +37,7 @@
37
37
  "openclaw"
38
38
  ],
39
39
  "scripts": {
40
- "build": "tsup src/index.ts --format esm --dts"
40
+ "build": "tsup src/index.ts --format esm --dts",
41
+ "check-types": "tsc --noEmit"
41
42
  }
42
43
  }