@anaralabs/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anara Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @anaralabs/sdk
+
+Official TypeScript SDK for the [Anara](https://anara.com) API. It mirrors
+Anara's in-product code-agent SDK — the full `anara.*` surface (library search,
+research, entities, documents, spreadsheets, notes, images, RLM map/ask) — as a
+typed HTTP client. Give a coding agent (Claude Code, Codex, …) the same tools
+the Anara agent has, over a single API key.
+
+Zero runtime dependencies. Works in Node 18+, Deno, Bun, edge runtimes, and the
+browser (anywhere `fetch` exists).
+
+## Install
+
+```bash
+npm install @anaralabs/sdk
+```
+
+## Authenticate
+
+Mint an API key (Better Auth) from your signed-in browser session:
+
+```bash
+curl -X POST https://anara.com/api/better-auth/api-key/create \
+  -H 'content-type: application/json' \
+  -H 'cookie: <signed-in-browser-cookie>' \
+  -d '{"name":"CLI","permissions":{"anara":["read","chat","write"]}}'
+```
+
+Keys look like `anara_…`. Reads need `anara:read`; library writes need
+`anara:write`. Keep them secret; never commit them.
+
+## Use
+
+```ts
+import { createAnaraClient } from '@anaralabs/sdk';
+
+// `apiKey` defaults to the ANARA_API_KEY environment variable.
+const anara = createAnaraClient();
+
+// Retrieval — one call answers most questions, with citable passages.
+const hits = await anara.search({ query: 'wooden pallet recycling drop-off' });
+
+// Search + read the winners' pages in one shot.
+const research = await anara.research({
+  query: ['revenue 2021', 'revenue 2022'],
+  readPages: 2,
+});
+
+// Library entities (CRUD). Writes need an `anara:write` key.
+const drafts = await anara.entities.query({
+  type: 'NOTE',
+  nameContains: 'draft',
+});
+const folder = await anara.entities.create({ type: 'GROUP', name: 'Drafts' });
+for (const d of drafts) await anara.entities.move(d.id, folder.id);
+
+// Fan a cheap sub-LM over big data (RLM).
+const labels = await anara.map(reviews, 'Reply POSITIVE or NEGATIVE.');
+```
+
+## How it works
+
+The package is a thin client: every `anara.*` method is one HTTP call to the
+Anara API (`POST /api/v1/sdk` with `{ method, args }`), dispatched server-side
+against your authenticated workspace. `anara.me()` hits `GET /api/v1/me`. There
+is no Anara logic in the package itself — just typed calls over your key.
+
+## Surface
+
+`entities.query/get/create/update/move/delete` · `search` · `research` ·
+`retrieval.vectorSearch/keywordSearch/rerank` ·
+`documents.getPages/expandContext/readToc/readMedia/extract` ·
+`store.put/get` · `map` · `ask` · `askMany` ·
+`spreadsheets.query/applyEdits` · `notes.read/edit` · `images.create` ·
+`chats.search` · `workspace.queryDb` · `me`.
+
+`invoke(method, args)` is the escape hatch for any method not yet wrapped.
+
+Errors are thrown as `AnaraApiError` (`.status`, `.code`, `.details`);
+`isAnaraApiError(e)` is a type guard.
+
+### Drop-in agent guide
+
+`ANARA_AGENT_GUIDE` is a ready-made system-prompt block teaching an agent when
+and how to call the SDK:
+
+```ts
+import { ANARA_AGENT_GUIDE } from '@anaralabs/sdk';
+```
+
+## Configuration
+
+```ts
+createAnaraClient({
+  apiKey: '…', // or ANARA_API_KEY
+  baseUrl: 'https://anara.com', // override for self-hosted / preview
+  fetch: customFetch, // override the fetch implementation
+  headers: { 'x-trace': '…' }, // extra headers on every request
+});
+```

package/dist/agent-guide.d.ts

@@ -0,0 +1,2 @@
+export declare const ANARA_AGENT_GUIDE = "# Anara SDK \u2014 agent guide\n\nYou have an `anara` client (`@anaralabs/sdk`) authenticated to a research workspace.\nIt mirrors Anara's code-agent SDK: every call hits the Anara API over your key.\n\n## Retrieval (the common job)\n- `anara.search({ query, documentIds?, limit? })` \u2192 ranked, citable passages. ONE call answers most \"what does my library say about X\". STOP once you have a plausible answer \u2014 re-verifying is the #1 cost.\n- `anara.research({ query, readPages? })` \u2192 search + read the top winners' pages in one call. Pass an array of sub-questions (\u22646) to decompose.\n- `anara.retrieval.vectorSearch/keywordSearch({ queries })` then `anara.retrieval.rerank({ query, candidates, topK })` to compose custom recall. Gather wide, rerank, return narrow.\n- `anara.documents.getPages(documentId, [page])` to read full pages.\n\n## Library entities (CRUD)\n- `anara.entities.query({ type?, nameContains?, groupId?, limit? })`, `anara.entities.get(id, { withBody })`.\n- `anara.entities.create({ type: 'NOTE'|'GROUP'|'SPREADSHEET', ... })`, `update(id, { name })`, `move(id, groupId)`, `delete(ids, { dryRun })`.\n- Bulk delete? `delete(ids, { dryRun: true })` FIRST. Writes need an `anara:write` key.\n\n## Heavier tools\n- `anara.map(items, instruction, opts?)` and `anara.askMany(tasks, instruction?)` \u2014 fan a cheap sub-LM over big data when the per-item decision needs language judgment (NOT for string/regex/numeric tests \u2014 do those in plain code). `anara.ask(prompt, instruction?)` is the single-shot version.\n- `anara.store.put(value)` and `anara.store.get(handle)` \u2014 stash big intermediate data out of context (`store.put` needs an `anara:write` key).\n\n## How to use it well\n- Prefer `anara.search` over scraping; it already does retrieval + rerank.\n- One decisive call per step \u2014 round-trips are the cost.\n- Treat results as evidence to cite, not ground truth.\n";
+//# sourceMappingURL=agent-guide.d.ts.map

package/dist/agent-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../src/agent-guide.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,64DAwB7B,CAAC"}

package/dist/agent-guide.js

@@ -0,0 +1,29 @@
+// A drop-in system-prompt block teaching a coding agent (Claude Code, Codex, …)
+// how to drive the Anara SDK — the same `anara.*` surface the in-product code
+// agent uses, over an API key.
+export const ANARA_AGENT_GUIDE = `# Anara SDK — agent guide
+
+You have an \`anara\` client (\`@anaralabs/sdk\`) authenticated to a research workspace.
+It mirrors Anara's code-agent SDK: every call hits the Anara API over your key.
+
+## Retrieval (the common job)
+- \`anara.search({ query, documentIds?, limit? })\` → ranked, citable passages. ONE call answers most "what does my library say about X". STOP once you have a plausible answer — re-verifying is the #1 cost.
+- \`anara.research({ query, readPages? })\` → search + read the top winners' pages in one call. Pass an array of sub-questions (≤6) to decompose.
+- \`anara.retrieval.vectorSearch/keywordSearch({ queries })\` then \`anara.retrieval.rerank({ query, candidates, topK })\` to compose custom recall. Gather wide, rerank, return narrow.
+- \`anara.documents.getPages(documentId, [page])\` to read full pages.
+
+## Library entities (CRUD)
+- \`anara.entities.query({ type?, nameContains?, groupId?, limit? })\`, \`anara.entities.get(id, { withBody })\`.
+- \`anara.entities.create({ type: 'NOTE'|'GROUP'|'SPREADSHEET', ... })\`, \`update(id, { name })\`, \`move(id, groupId)\`, \`delete(ids, { dryRun })\`.
+- Bulk delete? \`delete(ids, { dryRun: true })\` FIRST. Writes need an \`anara:write\` key.
+
+## Heavier tools
+- \`anara.map(items, instruction, opts?)\` and \`anara.askMany(tasks, instruction?)\` — fan a cheap sub-LM over big data when the per-item decision needs language judgment (NOT for string/regex/numeric tests — do those in plain code). \`anara.ask(prompt, instruction?)\` is the single-shot version.
+- \`anara.store.put(value)\` and \`anara.store.get(handle)\` — stash big intermediate data out of context (\`store.put\` needs an \`anara:write\` key).
+
+## How to use it well
+- Prefer \`anara.search\` over scraping; it already does retrieval + rerank.
+- One decisive call per step — round-trips are the cost.
+- Treat results as evidence to cite, not ground truth.
+`;
+//# sourceMappingURL=agent-guide.js.map

package/dist/agent-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.js","sourceRoot":"","sources":["../src/agent-guide.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,87 @@
+import type { AnaraClientOptions, AnaraMe, AskTask, ChatsSearchInput, CreateEntityInput, DeleteEntitiesOptions, DeleteEntitiesResult, DocumentPages, EntityEnvelope, EntityQuery, ExpandContextInput, ExtractInput, GetEntityOptions, ImageCreateInput, MapOptions, MapResult, NoteEditInput, NoteReadInput, Passage, ReadMediaInput, ReadTocInput, RerankInput, ResearchInput, ResearchResult, RetrievalInput, SearchHit, SearchInput, SpreadsheetApplyEditsInput, SpreadsheetQueryInput, StorePutResult, UpdateEntityPatch, WorkspaceQueryInput } from './types.js';
+/**
+ * Typed client for the Anara API. Mirrors the in-product `anara.*` SDK: every
+ * method is a `POST /api/v1/sdk/{method}` call whose JSON body is the method's
+ * arguments, dispatched server-side against your authenticated workspace.
+ *
+ * ```ts
+ * const anara = createAnaraClient();
+ * const notes = await anara.entities.query({ type: 'NOTE', limit: 50 });
+ * const hits = await anara.search({ query: 'wooden pallet recycling' });
+ * ```
+ */
+export declare class AnaraClient {
+    private readonly config;
+    constructor(options?: AnaraClientOptions);
+    /** The user + active workspace the API key resolves to. */
+    me(): Promise<AnaraMe>;
+    /** Call a single `anara.*` method by name (escape hatch for the typed methods). */
+    invoke<T = unknown>(method: string, body?: Record<string, unknown>): Promise<T>;
+    readonly entities: {
+        query: (query?: EntityQuery) => Promise<EntityEnvelope[]>;
+        get: (id: string, options?: GetEntityOptions) => Promise<EntityEnvelope>;
+        create: (input: CreateEntityInput) => Promise<EntityEnvelope>;
+        update: (id: string, patch: UpdateEntityPatch) => Promise<EntityEnvelope>;
+        move: (id: string, groupId: string | null) => Promise<EntityEnvelope>;
+        delete: (ids: string | string[], options?: DeleteEntitiesOptions) => Promise<DeleteEntitiesResult>;
+    };
+    search(input: SearchInput): Promise<SearchHit[]>;
+    research(input: ResearchInput): Promise<ResearchResult | ResearchResult[]>;
+    readonly retrieval: {
+        vectorSearch: (input: RetrievalInput) => Promise<SearchHit[]>;
+        keywordSearch: (input: RetrievalInput) => Promise<SearchHit[]>;
+        rerank: (input: RerankInput) => Promise<SearchHit[]>;
+    };
+    readonly documents: {
+        getPages: (documentId: string, pages?: number[]) => Promise<DocumentPages>;
+        expandContext: (input: ExpandContextInput) => Promise<{
+            passages: Passage[];
+        }>;
+        readToc: (input: ReadTocInput) => Promise<{
+            toc: unknown;
+        }>;
+        readMedia: (input: ReadMediaInput) => Promise<{
+            passages: Array<{
+                passageId: string;
+                text: string;
+            }>;
+        }>;
+        extract: (input: ExtractInput) => Promise<{
+            items: Array<Record<string, unknown>>;
+        }>;
+    };
+    readonly spreadsheets: {
+        query: (input: SpreadsheetQueryInput) => Promise<unknown>;
+        applyEdits: (input: SpreadsheetApplyEditsInput) => Promise<unknown>;
+    };
+    readonly notes: {
+        read: (input: NoteReadInput) => Promise<{
+            success?: boolean;
+            content?: string;
+            message?: string;
+        }>;
+        edit: (input: NoteEditInput) => Promise<{
+            success: boolean;
+        }>;
+    };
+    readonly images: {
+        create: (input: ImageCreateInput) => Promise<{
+            url: string;
+        }>;
+    };
+    readonly workspace: {
+        queryDb: (input: WorkspaceQueryInput) => Promise<unknown>;
+    };
+    readonly chats: {
+        search: (input: ChatsSearchInput) => Promise<unknown>;
+    };
+    readonly store: {
+        put: (value: unknown) => Promise<StorePutResult>;
+        get: <T = unknown>(handle: string) => Promise<T>;
+    };
+    map(items: unknown[] | string, instruction: string, options?: MapOptions): Promise<MapResult[]>;
+    ask(prompt: string, instruction?: string): Promise<string>;
+    askMany(tasks: AskTask[], instruction?: string): Promise<MapResult[]>;
+}
+export declare function createAnaraClient(options?: AnaraClientOptions): AnaraClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,112 @@
+import { AnaraError } from './errors.js';
+import { httpRequest, normalizeBaseUrl } from './http.js';
+const DEFAULT_BASE_URL = 'https://anara.com';
+function envApiKey() {
+    const env = globalThis.process?.env;
+    return env?.ANARA_API_KEY;
+}
+function compact(body) {
+    for (const key of Object.keys(body)) {
+        if (body[key] === undefined)
+            delete body[key];
+    }
+    return body;
+}
+/**
+ * Typed client for the Anara API. Mirrors the in-product `anara.*` SDK: every
+ * method is a `POST /api/v1/sdk/{method}` call whose JSON body is the method's
+ * arguments, dispatched server-side against your authenticated workspace.
+ *
+ * ```ts
+ * const anara = createAnaraClient();
+ * const notes = await anara.entities.query({ type: 'NOTE', limit: 50 });
+ * const hits = await anara.search({ query: 'wooden pallet recycling' });
+ * ```
+ */
+export class AnaraClient {
+    config;
+    constructor(options = {}) {
+        const apiKey = (options.apiKey ?? envApiKey())?.trim();
+        if (!apiKey) {
+            throw new AnaraError('AnaraClient requires an API key — pass `new AnaraClient({ apiKey })` or set the ANARA_API_KEY environment variable.');
+        }
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        if (typeof fetchImpl !== 'function') {
+            throw new AnaraError('No `fetch` implementation available — pass `options.fetch`.');
+        }
+        this.config = {
+            apiKey,
+            baseUrl: normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL),
+            fetch: fetchImpl,
+            headers: options.headers ?? {},
+        };
+    }
+    /** The user + active workspace the API key resolves to. */
+    me() {
+        return httpRequest(this.config, 'GET', '/api/v1/me');
+    }
+    /** Call a single `anara.*` method by name (escape hatch for the typed methods). */
+    invoke(method, body = {}) {
+        return httpRequest(this.config, 'POST', `/api/v1/sdk/${encodeURIComponent(method)}`, { body });
+    }
+    entities = {
+        query: (query = {}) => this.invoke('entities.query', { ...query }),
+        get: (id, options) => this.invoke('entities.get', compact({ id, ...options })),
+        create: (input) => this.invoke('entities.create', { ...input }),
+        update: (id, patch) => this.invoke('entities.update', compact({ id, ...patch })),
+        move: (id, groupId) => this.invoke('entities.move', { id, groupId }),
+        delete: (ids, options) => this.invoke('entities.delete', compact({ ids, ...options })),
+    };
+    search(input) {
+        return this.invoke('search', { ...input });
+    }
+    research(input) {
+        return this.invoke('research', { ...input });
+    }
+    retrieval = {
+        vectorSearch: (input) => this.invoke('retrieval.vectorSearch', { ...input }),
+        keywordSearch: (input) => this.invoke('retrieval.keywordSearch', { ...input }),
+        rerank: (input) => this.invoke('retrieval.rerank', { ...input }),
+    };
+    documents = {
+        getPages: (documentId, pages) => this.invoke('documents.getPages', compact({ documentId, pages })),
+        expandContext: (input) => this.invoke('documents.expandContext', { ...input }),
+        readToc: (input) => this.invoke('documents.readToc', { ...input }),
+        readMedia: (input) => this.invoke('documents.readMedia', { ...input }),
+        extract: (input) => this.invoke('documents.extract', { ...input }),
+    };
+    spreadsheets = {
+        query: (input) => this.invoke('spreadsheets.query', { ...input }),
+        applyEdits: (input) => this.invoke('spreadsheets.applyEdits', { ...input }),
+    };
+    notes = {
+        read: (input) => this.invoke('notes.read', { ...input }),
+        edit: (input) => this.invoke('notes.edit', { ...input }),
+    };
+    images = {
+        create: (input) => this.invoke('images.create', { ...input }),
+    };
+    workspace = {
+        queryDb: (input) => this.invoke('workspace.queryDb', { ...input }),
+    };
+    chats = {
+        search: (input) => this.invoke('chats.search', { ...input }),
+    };
+    store = {
+        put: (value) => this.invoke('store.put', { value }),
+        get: (handle) => this.invoke('store.get', { handle }),
+    };
+    map(items, instruction, options) {
+        return this.invoke('map', compact({ items, instruction, ...options }));
+    }
+    ask(prompt, instruction) {
+        return this.invoke('ask', compact({ prompt, instruction }));
+    }
+    askMany(tasks, instruction) {
+        return this.invoke('askMany', compact({ tasks, instruction }));
+    }
+}
+export function createAnaraClient(options = {}) {
+    return new AnaraClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export type AnaraErrorCode = 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'rate_limited' | 'server_error' | 'unknown';
+export declare class AnaraError extends Error {
+    constructor(message: string);
+}
+export declare class AnaraApiError extends AnaraError {
+    readonly status: number;
+    /** The server's semantic code when present (e.g. `approval_required`,
+     * `guardrail`), otherwise derived from the HTTP status. */
+    readonly code: AnaraErrorCode | (string & {});
+    readonly details?: unknown;
+    constructor(status: number, message: string, details?: unknown, code?: string);
+}
+export declare function isAnaraError(value: unknown): value is AnaraError;
+export declare function isAnaraApiError(value: unknown): value is AnaraApiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,cAAc,GACd,SAAS,CAAC;AAEd,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAM1B;CACF;AAYD,qBAAa,aAAc,SAAQ,UAAU;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;+DAC2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,YACE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE,MAAM,EAOd;CACF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/errors.js

@@ -0,0 +1,45 @@
+export class AnaraError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AnaraError';
+        // Keep `instanceof` working when the class is downleveled or crosses a
+        // bundler/module boundary.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+function codeForStatus(status) {
+    if (status === 400 || status === 422)
+        return 'bad_request';
+    if (status === 401)
+        return 'unauthorized';
+    if (status === 403)
+        return 'forbidden';
+    if (status === 404)
+        return 'not_found';
+    if (status === 429)
+        return 'rate_limited';
+    if (status >= 500)
+        return 'server_error';
+    return 'unknown';
+}
+export class AnaraApiError extends AnaraError {
+    status;
+    /** The server's semantic code when present (e.g. `approval_required`,
+     * `guardrail`), otherwise derived from the HTTP status. */
+    code;
+    details;
+    constructor(status, message, details, code) {
+        super(message);
+        this.name = 'AnaraApiError';
+        this.status = status;
+        this.code = code ?? codeForStatus(status);
+        this.details = details;
+    }
+}
+export function isAnaraError(value) {
+    return value instanceof AnaraError;
+}
+export function isAnaraApiError(value) {
+    return value instanceof AnaraApiError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,uEAAuE;QACvE,2BAA2B;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,aAAa,CAAC;IAC3D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,cAAc,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAClC,MAAM,CAAS;IACxB;+DAC2D;IAClD,IAAI,CAAiC;IACrC,OAAO,CAAW;IAE3B,YACE,MAAc,EACd,OAAe,EACf,OAAiB,EACjB,IAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,19 @@
+import { AnaraApiError } from './errors.js';
+export interface HttpConfig {
+    baseUrl: string;
+    apiKey: string;
+    fetch: typeof fetch;
+    headers: Record<string, string>;
+}
+export type QueryParams = Record<string, string | number | undefined>;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+export declare function buildUrl(baseUrl: string, path: string, query?: QueryParams): string;
+export declare function errorFromResponse(response: Response): Promise<AnaraApiError>;
+export interface RequestOptions {
+    query?: QueryParams;
+    body?: unknown;
+    signal?: AbortSignal;
+}
+export declare function requestHeaders(config: HttpConfig, extra?: Record<string, string>): Record<string, string>;
+export declare function httpRequest<T>(config: HttpConfig, method: string, path: string, options?: RequestOptions): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,WAAW,GAClB,MAAM,CAQR;AAiCD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,aAAa,CAAC,CAUxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAeZ"}

package/dist/http.js

@@ -0,0 +1,74 @@
+import { AnaraApiError } from './errors.js';
+export function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, '');
+}
+export function buildUrl(baseUrl, path, query) {
+    const url = new URL(`${baseUrl}${path}`);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+async function parseResponse(response) {
+    const raw = await response.text();
+    let data;
+    if (raw) {
+        try {
+            data = JSON.parse(raw);
+        }
+        catch {
+            data = raw;
+        }
+    }
+    if (!response.ok) {
+        const message = isRecord(data) && typeof data.error === 'string'
+            ? data.error
+            : `Anara API request failed (${response.status})`;
+        const details = isRecord(data) ? data.details : data;
+        // Prefer the server's semantic code (approval_required, guardrail, …) over
+        // the status-derived fallback.
+        const code = isRecord(data) && typeof data.code === 'string' ? data.code : undefined;
+        throw new AnaraApiError(response.status, message, details, code);
+    }
+    return data;
+}
+export async function errorFromResponse(response) {
+    try {
+        await parseResponse(response);
+    }
+    catch (error) {
+        if (error instanceof AnaraApiError)
+            return error;
+    }
+    return new AnaraApiError(response.status, `Anara API request failed (${response.status})`);
+}
+export function requestHeaders(config, extra) {
+    // Caller headers first, then the SDK-managed ones — so a stray `x-api-key` in
+    // `config.headers` can never override the configured key.
+    return {
+        accept: 'application/json',
+        ...config.headers,
+        ...extra,
+        'x-api-key': config.apiKey,
+    };
+}
+export async function httpRequest(config, method, path, options = {}) {
+    const headers = requestHeaders(config);
+    let body;
+    if (options.body !== undefined) {
+        headers['content-type'] = 'application/json';
+        body = JSON.stringify(options.body);
+    }
+    const response = await config.fetch(buildUrl(config.baseUrl, path, options.query), 
+    // `redirect: 'error'` so a cross-origin redirect can never re-send the
+    // x-api-key header to another host — it fails loudly instead.
+    { method, headers, body, signal: options.signal, redirect: 'error' });
+    return parseResponse(response);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { AnaraClient, createAnaraClient } from './client.js';
+export { AnaraError, AnaraApiError, isAnaraError, isAnaraApiError, type AnaraErrorCode, } from './errors.js';
+export { ANARA_AGENT_GUIDE } from './agent-guide.js';
+export { ANARA_METHODS, WRITE_METHODS, isAnaraMethod, entityEnvelope, type AnaraMethodName, type MethodSpec, } from './schemas.js';
+export { buildOpenApiDocument, type OpenApiOptions } from './openapi.js';
+export type { AnaraClientOptions, AnaraUser, AnaraMe, EntityEnvelope, EntityQuery, GetEntityOptions, CreateEntityInput, UpdateEntityPatch, DeleteEntitiesOptions, DeleteEntitiesResult, SearchInput, SearchHit, Passage, DocumentPages, ResearchInput, ResearchResult, RetrievalInput, RerankInput, StorePutResult, MapOptions, MapResult, AskTask, ExpandContextInput, ReadTocInput, ReadMediaInput, ExtractInput, SpreadsheetQueryInput, SpreadsheetApplyEditsInput, NoteReadInput, NoteEditInput, ImageCreateInput, WorkspaceQueryInput, ChatsSearchInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,OAAO,EACP,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { AnaraClient, createAnaraClient } from './client.js';
+export { AnaraError, AnaraApiError, isAnaraError, isAnaraApiError, } from './errors.js';
+export { ANARA_AGENT_GUIDE } from './agent-guide.js';
+export { ANARA_METHODS, WRITE_METHODS, isAnaraMethod, entityEnvelope, } from './schemas.js';
+export { buildOpenApiDocument } from './openapi.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,GAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAuB,MAAM,cAAc,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,38 @@
+export interface OpenApiOptions {
+    title?: string;
+    version?: string;
+    /** Base server URL, e.g. `https://anara.com`. */
+    serverUrl?: string;
+}
+/**
+ * Generates the OpenAPI 3.1 document for the anara.* surface straight from the
+ * zod method registry, so the spec is always in sync with the schemas the
+ * server validates with and the client is typed from. Each method is one POST
+ * operation at `/api/v1/sdk/{method}`; the request body is the method's
+ * positional args, the response is its return value.
+ */
+export declare function buildOpenApiDocument(options?: OpenApiOptions): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers?: {
+        url: string;
+    }[] | undefined;
+    components: {
+        securitySchemes: {
+            ApiKeyAuth: {
+                type: string;
+                in: string;
+                name: string;
+            };
+        };
+    };
+    security: {
+        ApiKeyAuth: never[];
+    }[];
+    paths: Record<string, unknown>;
+};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,cAAmB;;;QAwC3D,KAAK;QACL,OAAO;QACP,WAAW;;;;;;QAKX,eAAe;YACb,UAAU;gBAAI,IAAI;gBAAY,EAAE;gBAAY,IAAI;;;;;;;;EAMvD"}