@1mbrain/sdk 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -0,0 +1,239 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AGENT_SYSTEM_PROMPT: () => AGENT_SYSTEM_PROMPT,
+  OneMBrainClient: () => OneMBrainClient,
+  OneMBrainError: () => OneMBrainError
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/prompts.ts
+var AGENT_SYSTEM_PROMPT = `You are equipped with 1MBrain, a highly advanced long-term memory engine. 
+You have access to memory tools (e.g., \`remember\` and \`recall\`) to store and retrieve information across sessions.
+
+CRITICAL INSTRUCTIONS FOR USING YOUR MEMORY:
+
+1. ALWAYS SEARCH FIRST: Before asking the user for information you might already know, or before making assumptions, ALWAYS use the \`recall\` tool to search your memory.
+2. PREFER SPECIFIC QUERIES: When using \`recall\`, use specific conceptual queries rather than vague keywords. (e.g., "user dietary restrictions" instead of "food").
+3. RECORD NEW FACTS ACTIVELY: Whenever the user provides new, durable information (preferences, facts, state changes, or important events), immediately use the \`remember\` tool to store it. Do not ask for permission to remember.
+4. DO NOT DELETE STALE FACTS: If the user changes their mind (e.g., "I used to like Apple, now I like Samsung"), simply \`remember\` the new fact. 1MBrain's chronological supersedence engine will automatically decay the old fact and prioritize the new one.
+5. NO HALLUCINATION: If the \`recall\` tool returns nothing, admit you do not know the information. Do not invent past interactions.`;
+
+// src/index.ts
+var OneMBrainError = class extends Error {
+  constructor(message, status, details) {
+    super(message);
+    this.status = status;
+    this.details = details;
+    this.name = "OneMBrainError";
+  }
+  status;
+  details;
+};
+var OneMBrainClient = class {
+  apiUrl;
+  apiKey;
+  agentId;
+  fetchFn;
+  constructor(config) {
+    if (!config.apiUrl) {
+      throw new Error("apiUrl is required");
+    }
+    if (!config.apiKey) {
+      throw new Error("apiKey is required");
+    }
+    this.apiUrl = config.apiUrl.replace(/\/+$/, "");
+    this.apiKey = config.apiKey;
+    this.agentId = config.agentId;
+    this.fetchFn = config.fetch ?? fetch;
+  }
+  async remember(input) {
+    const agentId = this.resolveAgentId(input.agentId);
+    const envelope = await this.request("/v1/memories", {
+      method: "POST",
+      agentId,
+      body: {
+        ...input,
+        agentId
+      }
+    });
+    return deserializeMemory(envelope.data);
+  }
+  async recall(input) {
+    const agentId = this.resolveAgentId(input.agentId);
+    const params = toSearchParams({
+      ...input,
+      agentId,
+      q: input.query,
+      query: void 0
+    });
+    const envelope = await this.request(
+      `/v1/memories/search?${params.toString()}`,
+      {
+        method: "GET",
+        agentId
+      }
+    );
+    const results = envelope.data.map((result) => ({
+      ...result,
+      memory: deserializeMemory(result.memory)
+    }));
+    if (envelope.meta) {
+      results.confidence = envelope.meta.confidence;
+      results.reason = envelope.meta.reason;
+    }
+    return results;
+  }
+  async forget(id, options = {}) {
+    const envelope = await this.request(`/v1/memories/${id}`, {
+      method: "DELETE",
+      agentId: this.resolveAgentId(options.agentId)
+    });
+    return envelope.success;
+  }
+  async associate(sourceId, input) {
+    const envelope = await this.request(
+      `/v1/memories/${sourceId}/associate`,
+      {
+        method: "POST",
+        agentId: this.resolveAgentId(input.agentId),
+        body: {
+          targetId: input.targetId,
+          strength: input.strength,
+          origin: input.origin,
+          relationType: input.relationType
+        }
+      }
+    );
+    return envelope.success;
+  }
+  /**
+   * Ingest a web page URL into memory.
+   *
+   * The server-side pipeline will:
+   * 1. Fetch the page HTML
+   * 2. Extract main content → Markdown
+   * 3. Chunk and extract factual claims via LLM
+   * 4. Store facts as memories (type, importance, metadata auto-set)
+   *
+   * Works from any gateway: Telegram, Discord, browser extension, CLI.
+   *
+   * @param url - The URL to ingest
+   * @param options - Optional overrides (agentId, confidenceThreshold, etc.)
+   */
+  async ingestUrl(url, options = {}) {
+    const agentId = this.resolveAgentId(options.agentId);
+    const envelope = await this.request("/v1/ingest/url", {
+      method: "POST",
+      agentId,
+      body: {
+        url,
+        agentId,
+        confidenceThreshold: options.confidenceThreshold,
+        maxChunkChars: options.maxChunkChars,
+        deduplicate: options.deduplicate
+      }
+    });
+    return envelope.data;
+  }
+  async consolidate(options = {}) {
+    const agentId = this.resolveAgentId(options.agentId);
+    const envelope = await this.request("/v1/consolidate", {
+      method: "POST",
+      agentId,
+      body: {
+        agentId,
+        dryRun: options.dryRun,
+        clusterStrategy: options.clusterStrategy
+      }
+    });
+    return envelope.data;
+  }
+  resolveAgentId(agentId) {
+    const resolved = agentId ?? this.agentId;
+    if (!resolved) {
+      throw new Error("agentId is required");
+    }
+    return resolved;
+  }
+  async request(path, options) {
+    const response = await this.fetchFn(`${this.apiUrl}${path}`, {
+      method: options.method,
+      headers: {
+        "content-type": "application/json",
+        "x-api-key": this.apiKey,
+        "x-agent-id": options.agentId
+      },
+      body: options.body === void 0 ? void 0 : JSON.stringify(options.body)
+    });
+    const payload = await readJson(response);
+    if (!response.ok) {
+      throw new OneMBrainError(
+        extractErrorMessage(payload, response.statusText),
+        response.status,
+        payload
+      );
+    }
+    return payload;
+  }
+};
+function deserializeMemory(memory) {
+  return {
+    ...memory,
+    createdAt: new Date(memory.createdAt),
+    lastAccessedAt: new Date(memory.lastAccessedAt)
+  };
+}
+function toSearchParams(input) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(input)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      params.set(key, value.join(","));
+      continue;
+    }
+    params.set(key, String(value));
+  }
+  return params;
+}
+async function readJson(response) {
+  const text = await response.text();
+  return text ? JSON.parse(text) : {};
+}
+function extractErrorMessage(payload, fallback) {
+  if (payload && typeof payload === "object" && "error" in payload) {
+    return String(payload.error);
+  }
+  if (payload && typeof payload === "object" && "message" in payload) {
+    return String(payload.message);
+  }
+  return fallback || "1MBrain request failed";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENT_SYSTEM_PROMPT,
+  OneMBrainClient,
+  OneMBrainError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/prompts.ts"],"sourcesContent":["import type {\n  CreateAssociationInput,\n  CreateMemoryInput,\n  Memory,\n  SearchMemoryInput,\n  SearchResult,\n} from '@1mbrain/core';\n\nexport interface OneMBrainClientConfig {\n  apiUrl: string;\n  apiKey: string;\n  agentId?: string;\n  fetch?: typeof fetch;\n}\n\nexport type RememberInput = Omit<CreateMemoryInput, 'agentId'> & {\n  agentId?: string;\n};\n\nexport type RecallInput = Omit<SearchMemoryInput, 'agentId'> & {\n  agentId?: string;\n};\n\nexport type AssociateInput = Omit<CreateAssociationInput, 'sourceId' | 'agentId'> & {\n  agentId?: string;\n};\n\nexport interface IngestUrlOptions {\n  agentId?: string;\n  confidenceThreshold?: number;\n  maxChunkChars?: number;\n  deduplicate?: boolean;\n}\n\nexport interface IngestResult {\n  title: string;\n  url: string;\n  sourceHash: string;\n  chunkCount: number;\n  extractedCount: number;\n  storedCount: number;\n  skippedCount: number;\n  errorCount: number;\n  deduplicated: boolean;\n  memoryIds: string[];\n}\n\nexport interface ConsolidateOptions {\n  agentId?: string;\n  dryRun?: boolean;\n  clusterStrategy?: 'tags' | 'graph' | 'hybrid';\n}\n\nexport interface ConsolidationResult {\n  agentId: string;\n  triggerReason: 'sleep-cycle' | 'threshold';\n  dryRun: boolean;\n  storedCount: number;\n  archivedCount: number;\n  clustersProcessed: number;\n  skipped: {\n    noCandidates: number;\n    tooSmallClusters: number;\n    summarizationFailed: number;\n    dryRun: number;\n  };\n  errors: string[];\n  summaryIds: string[];\n}\n\nexport interface ApiEnvelope<T> {\n  success: boolean;\n  data: T;\n  meta?: Record<string, unknown>;\n  message?: string;\n}\n\nexport class OneMBrainError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly details?: unknown,\n  ) {\n    super(message);\n    this.name = 'OneMBrainError';\n  }\n}\n\nexport class OneMBrainClient {\n  private readonly apiUrl: string;\n  private readonly apiKey: string;\n  private readonly agentId?: string;\n  private readonly fetchFn: typeof fetch;\n\n  constructor(config: OneMBrainClientConfig) {\n    if (!config.apiUrl) {\n      throw new Error('apiUrl is required');\n    }\n\n    if (!config.apiKey) {\n      throw new Error('apiKey is required');\n    }\n\n    this.apiUrl = config.apiUrl.replace(/\\/+$/, '');\n    this.apiKey = config.apiKey;\n    this.agentId = config.agentId;\n    this.fetchFn = config.fetch ?? fetch;\n  }\n\n  async remember(input: RememberInput): Promise<Memory> {\n    const agentId = this.resolveAgentId(input.agentId);\n    const envelope = await this.request<ApiEnvelope<SerializedMemory>>('/v1/memories', {\n      method: 'POST',\n      agentId,\n      body: {\n        ...input,\n        agentId,\n      },\n    });\n\n    return deserializeMemory(envelope.data);\n  }\n\n  async recall(input: RecallInput): Promise<SearchResult[]> {\n    const agentId = this.resolveAgentId(input.agentId);\n    const params = toSearchParams({\n      ...input,\n      agentId,\n      q: input.query,\n      query: undefined,\n    });\n    const envelope = await this.request<ApiEnvelope<SerializedSearchResult[]>>(\n      `/v1/memories/search?${params.toString()}`,\n      {\n        method: 'GET',\n        agentId,\n      },\n    );\n\n    const results = envelope.data.map((result) => ({\n      ...result,\n      memory: deserializeMemory(result.memory),\n    })) as SearchResult[] & { confidence?: string; reason?: string };\n\n    if (envelope.meta) {\n      results.confidence = envelope.meta.confidence as string | undefined;\n      results.reason = envelope.meta.reason as string | undefined;\n    }\n\n    return results;\n  }\n\n  async forget(id: string, options: { agentId?: string } = {}): Promise<boolean> {\n    const envelope = await this.request<ApiEnvelope<unknown>>(`/v1/memories/${id}`, {\n      method: 'DELETE',\n      agentId: this.resolveAgentId(options.agentId),\n    });\n\n    return envelope.success;\n  }\n\n  async associate(sourceId: string, input: AssociateInput): Promise<boolean> {\n    const envelope = await this.request<ApiEnvelope<unknown>>(\n      `/v1/memories/${sourceId}/associate`,\n      {\n        method: 'POST',\n        agentId: this.resolveAgentId(input.agentId),\n        body: {\n          targetId: input.targetId,\n          strength: input.strength,\n          origin: input.origin,\n          relationType: input.relationType,\n        },\n      },\n    );\n\n    return envelope.success;\n  }\n\n  /**\n   * Ingest a web page URL into memory.\n   *\n   * The server-side pipeline will:\n   * 1. Fetch the page HTML\n   * 2. Extract main content → Markdown\n   * 3. Chunk and extract factual claims via LLM\n   * 4. Store facts as memories (type, importance, metadata auto-set)\n   *\n   * Works from any gateway: Telegram, Discord, browser extension, CLI.\n   *\n   * @param url - The URL to ingest\n   * @param options - Optional overrides (agentId, confidenceThreshold, etc.)\n   */\n  async ingestUrl(url: string, options: IngestUrlOptions = {}): Promise<IngestResult> {\n    const agentId = this.resolveAgentId(options.agentId);\n    const envelope = await this.request<ApiEnvelope<IngestResult>>('/v1/ingest/url', {\n      method: 'POST',\n      agentId,\n      body: {\n        url,\n        agentId,\n        confidenceThreshold: options.confidenceThreshold,\n        maxChunkChars: options.maxChunkChars,\n        deduplicate: options.deduplicate,\n      },\n    });\n\n    return envelope.data;\n  }\n\n  async consolidate(options: ConsolidateOptions = {}): Promise<ConsolidationResult> {\n    const agentId = this.resolveAgentId(options.agentId);\n    const envelope = await this.request<ApiEnvelope<ConsolidationResult>>('/v1/consolidate', {\n      method: 'POST',\n      agentId,\n      body: {\n        agentId,\n        dryRun: options.dryRun,\n        clusterStrategy: options.clusterStrategy,\n      },\n    });\n\n    return envelope.data;\n  }\n\n  private resolveAgentId(agentId?: string): string {\n    const resolved = agentId ?? this.agentId;\n\n    if (!resolved) {\n      throw new Error('agentId is required');\n    }\n\n    return resolved;\n  }\n\n  private async request<T>(\n    path: string,\n    options: {\n      method: 'GET' | 'POST' | 'DELETE';\n      agentId: string;\n      body?: unknown;\n    },\n  ): Promise<T> {\n    const response = await this.fetchFn(`${this.apiUrl}${path}`, {\n      method: options.method,\n      headers: {\n        'content-type': 'application/json',\n        'x-api-key': this.apiKey,\n        'x-agent-id': options.agentId,\n      },\n      body: options.body === undefined ? undefined : JSON.stringify(options.body),\n    });\n\n    const payload = await readJson(response);\n\n    if (!response.ok) {\n      throw new OneMBrainError(\n        extractErrorMessage(payload, response.statusText),\n        response.status,\n        payload,\n      );\n    }\n\n    return payload as T;\n  }\n}\n\ntype SerializedMemory = Omit<Memory, 'createdAt' | 'lastAccessedAt'> & {\n  createdAt: string;\n  lastAccessedAt: string;\n};\n\ntype SerializedSearchResult = Omit<SearchResult, 'memory'> & {\n  memory: SerializedMemory;\n};\n\nfunction deserializeMemory(memory: SerializedMemory): Memory {\n  return {\n    ...memory,\n    createdAt: new Date(memory.createdAt),\n    lastAccessedAt: new Date(memory.lastAccessedAt),\n  };\n}\n\nfunction toSearchParams(input: Record<string, unknown>): URLSearchParams {\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(input)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      params.set(key, value.join(','));\n      continue;\n    }\n\n    params.set(key, String(value));\n  }\n\n  return params;\n}\n\nasync function readJson(response: Response): Promise<unknown> {\n  const text = await response.text();\n  return text ? JSON.parse(text) : {};\n}\n\nfunction extractErrorMessage(payload: unknown, fallback: string): string {\n  if (payload && typeof payload === 'object' && 'error' in payload) {\n    return String((payload as { error: unknown }).error);\n  }\n\n  if (payload && typeof payload === 'object' && 'message' in payload) {\n    return String((payload as { message: unknown }).message);\n  }\n\n  return fallback || '1MBrain request failed';\n}\n\nexport type { Memory, SearchResult };\nexport { AGENT_SYSTEM_PROMPT } from './prompts.js';\n","export const AGENT_SYSTEM_PROMPT = `You are equipped with 1MBrain, a highly advanced long-term memory engine. \nYou have access to memory tools (e.g., \\`remember\\` and \\`recall\\`) to store and retrieve information across sessions.\n\nCRITICAL INSTRUCTIONS FOR USING YOUR MEMORY:\n\n1. ALWAYS SEARCH FIRST: Before asking the user for information you might already know, or before making assumptions, ALWAYS use the \\`recall\\` tool to search your memory.\n2. PREFER SPECIFIC QUERIES: When using \\`recall\\`, use specific conceptual queries rather than vague keywords. (e.g., \"user dietary restrictions\" instead of \"food\").\n3. RECORD NEW FACTS ACTIVELY: Whenever the user provides new, durable information (preferences, facts, state changes, or important events), immediately use the \\`remember\\` tool to store it. Do not ask for permission to remember.\n4. DO NOT DELETE STALE FACTS: If the user changes their mind (e.g., \"I used to like Apple, now I like Samsung\"), simply \\`remember\\` the new fact. 1MBrain's chronological supersedence engine will automatically decay the old fact and prioritize the new one.\n5. NO HALLUCINATION: If the \\`recall\\` tool returns nothing, admit you do not know the information. Do not invent past interactions.`;\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -1,178 +1,11 @@
-export class OneMBrainError extends Error {
-    status;
-    details;
-    constructor(message, status, details) {
-        super(message);
-        this.status = status;
-        this.details = details;
-        this.name = 'OneMBrainError';
-    }
-}
-export class OneMBrainClient {
-    apiUrl;
-    apiKey;
-    agentId;
-    fetchFn;
-    constructor(config) {
-        if (!config.apiUrl) {
-            throw new Error('apiUrl is required');
-        }
-        if (!config.apiKey) {
-            throw new Error('apiKey is required');
-        }
-        this.apiUrl = config.apiUrl.replace(/\/+$/, '');
-        this.apiKey = config.apiKey;
-        this.agentId = config.agentId;
-        this.fetchFn = config.fetch ?? fetch;
-    }
-    async remember(input) {
-        const agentId = this.resolveAgentId(input.agentId);
-        const envelope = await this.request('/v1/memories', {
-            method: 'POST',
-            agentId,
-            body: {
-                ...input,
-                agentId,
-            },
-        });
-        return deserializeMemory(envelope.data);
-    }
-    async recall(input) {
-        const agentId = this.resolveAgentId(input.agentId);
-        const params = toSearchParams({
-            ...input,
-            agentId,
-            q: input.query,
-            query: undefined,
-        });
-        const envelope = await this.request(`/v1/memories/search?${params.toString()}`, {
-            method: 'GET',
-            agentId,
-        });
-        return envelope.data.map((result) => ({
-            ...result,
-            memory: deserializeMemory(result.memory),
-        }));
-    }
-    async forget(id, options = {}) {
-        const envelope = await this.request(`/v1/memories/${id}`, {
-            method: 'DELETE',
-            agentId: this.resolveAgentId(options.agentId),
-        });
-        return envelope.success;
-    }
-    async associate(sourceId, input) {
-        const envelope = await this.request(`/v1/memories/${sourceId}/associate`, {
-            method: 'POST',
-            agentId: this.resolveAgentId(input.agentId),
-            body: {
-                targetId: input.targetId,
-                strength: input.strength,
-                origin: input.origin,
-                relationType: input.relationType,
-            },
-        });
-        return envelope.success;
-    }
-    /**
-     * Ingest a web page URL into memory.
-     *
-     * The server-side pipeline will:
-     * 1. Fetch the page HTML
-     * 2. Extract main content → Markdown
-     * 3. Chunk and extract factual claims via LLM
-     * 4. Store facts as memories (type, importance, metadata auto-set)
-     *
-     * Works from any gateway: Telegram, Discord, browser extension, CLI.
-     *
-     * @param url - The URL to ingest
-     * @param options - Optional overrides (agentId, confidenceThreshold, etc.)
-     */
-    async ingestUrl(url, options = {}) {
-        const agentId = this.resolveAgentId(options.agentId);
-        const envelope = await this.request('/v1/ingest/url', {
-            method: 'POST',
-            agentId,
-            body: {
-                url,
-                agentId,
-                confidenceThreshold: options.confidenceThreshold,
-                maxChunkChars: options.maxChunkChars,
-                deduplicate: options.deduplicate,
-            },
-        });
-        return envelope.data;
-    }
-    async consolidate(options = {}) {
-        const agentId = this.resolveAgentId(options.agentId);
-        const envelope = await this.request('/v1/consolidate', {
-            method: 'POST',
-            agentId,
-            body: {
-                agentId,
-                dryRun: options.dryRun,
-                clusterStrategy: options.clusterStrategy,
-            },
-        });
-        return envelope.data;
-    }
-    resolveAgentId(agentId) {
-        const resolved = agentId ?? this.agentId;
-        if (!resolved) {
-            throw new Error('agentId is required');
-        }
-        return resolved;
-    }
-    async request(path, options) {
-        const response = await this.fetchFn(`${this.apiUrl}${path}`, {
-            method: options.method,
-            headers: {
-                'content-type': 'application/json',
-                'x-api-key': this.apiKey,
-                'x-agent-id': options.agentId,
-            },
-            body: options.body === undefined ? undefined : JSON.stringify(options.body),
-        });
-        const payload = await readJson(response);
-        if (!response.ok) {
-            throw new OneMBrainError(extractErrorMessage(payload, response.statusText), response.status, payload);
-        }
-        return payload;
-    }
-}
-function deserializeMemory(memory) {
-    return {
-        ...memory,
-        createdAt: new Date(memory.createdAt),
-        lastAccessedAt: new Date(memory.lastAccessedAt),
-    };
-}
-function toSearchParams(input) {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(input)) {
-        if (value === undefined || value === null) {
-            continue;
-        }
-        if (Array.isArray(value)) {
-            params.set(key, value.join(','));
-            continue;
-        }
-        params.set(key, String(value));
-    }
-    return params;
-}
-async function readJson(response) {
-    const text = await response.text();
-    return text ? JSON.parse(text) : {};
-}
-function extractErrorMessage(payload, fallback) {
-    if (payload && typeof payload === 'object' && 'error' in payload) {
-        return String(payload.error);
-    }
-    if (payload && typeof payload === 'object' && 'message' in payload) {
-        return String(payload.message);
-    }
-    return fallback || '1MBrain request failed';
-}
-export { AGENT_SYSTEM_PROMPT } from './prompts.js';
+import {
+  AGENT_SYSTEM_PROMPT,
+  OneMBrainClient,
+  OneMBrainError
+} from "./chunk-TLPCKSTS.js";
+export {
+  AGENT_SYSTEM_PROMPT,
+  OneMBrainClient,
+  OneMBrainError
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,24 +1,27 @@
 {
   "name": "@1mbrain/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript client SDK for the 1MBrain REST API.",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     },
     "./hermes": {
+      "types": "./dist/hermes.d.ts",
       "import": "./dist/hermes.js",
-      "types": "./dist/hermes.d.ts"
+      "require": "./dist/hermes.cjs"
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -p tsconfig.json --watch",
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly",
+    "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
@@ -26,6 +29,7 @@
     "@1mbrain/core": "*"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0"
   },