@nirmos/sdk 0.2.0 → 0.3.2

package/src/core/transport.ts

@@ -20,7 +20,11 @@ import {
 import type { HeadersInput, RequestOptions } from "./types.js";
 
 export interface TransportConfig {
-  apiKey: string;
+  apiKey?: string;
+  accessToken?: string;
+  credentials?: RequestCredentials;
+  runtime?: boolean;
+  onError?: (error: APIError) => void;
   baseUrl: string;
   timeoutMs: number;
   maxRetries: number;
@@ -31,7 +35,9 @@ export interface TransportConfig {
 export interface TransportRequest {
   method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
   path: string;
-  query?: Readonly<Record<string, string | number | boolean | undefined>>;
+  query?: Readonly<
+    Record<string, string | number | boolean | readonly string[] | undefined>
+  >;
   body?: unknown;
   options?: RequestOptions;
 }
@@ -41,7 +47,7 @@ export interface TransportResponse<T> {
   response: Response;
 }
 
-const SDK_VERSION = "1.0.0";
+const SDK_VERSION = "0.3.0";
 
 export class HttpTransport {
   readonly #config: TransportConfig;
@@ -55,16 +61,26 @@ export class HttpTransport {
     const data = await parseResponseBody(response);
 
     if (!response.ok) {
-      throw createApiError(response, data);
+      const error = createApiError(response, data);
+      this.#config.onError?.(error);
+      throw error;
     }
 
     return { data: data as T, response };
   }
 
+  /** Control-plane and Knowledge envelope decoder; no raw Response at callsites. */
+  async data<T>(request: TransportRequest): Promise<T> {
+    const { data } = await this.request<{ data: T } | undefined>(request);
+    return data?.data as T;
+  }
+
   async ensureSuccess(response: Response): Promise<Response> {
     if (response.ok) return response;
     const data = await parseResponseBody(response);
-    throw createApiError(response, data);
+    const error = createApiError(response, data);
+    this.#config.onError?.(error);
+    throw error;
   }
 
   async fetch(request: TransportRequest): Promise<Response> {
@@ -146,7 +162,12 @@ export class HttpTransport {
         method: request.method,
         headers: this.#headers(request),
         body:
-          request.body === undefined ? undefined : JSON.stringify(request.body),
+          request.body === undefined
+            ? undefined
+            : request.body instanceof FormData
+              ? request.body
+              : JSON.stringify(request.body),
+        credentials: this.#config.credentials,
         signal: controller.signal,
       });
       if (!response.body) return response;
@@ -207,7 +228,9 @@ export class HttpTransport {
       `${this.#config.baseUrl}/`,
     );
     for (const [key, value] of Object.entries(request.query ?? {})) {
-      if (value !== undefined) url.searchParams.set(key, String(value));
+      if (Array.isArray(value))
+        for (const item of value) url.searchParams.append(key + "[]", item);
+      else if (value !== undefined) url.searchParams.set(key, String(value));
     }
     return url.toString();
   }
@@ -215,14 +238,24 @@ export class HttpTransport {
   #headers(request: TransportRequest): Headers {
     const headers = createHeaders(this.#config.headers);
     headers.set("accept", "application/json");
-    headers.set("x-api-key", this.#config.apiKey);
     headers.set("x-nirmos-sdk-version", SDK_VERSION);
-    if (request.body !== undefined) {
+    if (request.body !== undefined && !(request.body instanceof FormData)) {
       headers.set("content-type", "application/json");
     }
     createHeaders(request.options?.headers).forEach((value, key) => {
-      if (key.toLowerCase() !== "x-api-key") headers.set(key, value);
+      if (!["x-api-key", "authorization"].includes(key.toLowerCase()))
+        headers.set(key, value);
     });
+    if (this.#config.apiKey) headers.set("x-api-key", this.#config.apiKey);
+    if (this.#config.accessToken)
+      headers.set("authorization", `Bearer ${this.#config.accessToken}`);
+    if (
+      this.#config.runtime &&
+      !["GET", "HEAD", "OPTIONS"].includes(request.method)
+    ) {
+      headers.set("x-request-timestamp", String(Date.now()));
+      headers.set("x-request-nonce", globalThis.crypto.randomUUID());
+    }
     if (request.options?.idempotencyKey) {
       headers.set("idempotency-key", request.options.idempotencyKey);
     }
@@ -261,7 +294,10 @@ function createApiError(response: Response, payload: unknown): APIError {
     retryAfterMs,
     details: error.details,
     metadata,
-    requestId: metadata.requestId,
+    requestId:
+      readString(error, "requestId") ??
+      readString(root, "requestId") ??
+      metadata.requestId,
     traceId: metadata.traceId,
     headers: response.headers,
   };

package/src/gateway/types.ts

@@ -167,7 +167,9 @@ export interface EmbeddingCreateParams {
   user?: string;
   /** Optional provider override. Omit to use the model's configured default provider. */
   provider?: string;
+  /** @deprecated Embeddings never fall back to another vector space. Requests with this option are rejected. */
   fallbackModels?: readonly string[];
+  /** @deprecated Embeddings require direct model selection. */
   routingStrategy?: RoutingStrategy;
 }
 

package/src/index.ts

@@ -1,5 +1,16 @@
-export { Nirmos, NirmosClient } from "./client.js";
-export type { NirmosOptions } from "./client.js";
+export { Nirmos } from "./client.js";
+export type {
+  NirmosOptions,
+  NirmosAuth,
+  EndpointExecution,
+  KnowledgeMatch,
+  KnowledgeSearchRequest,
+  KnowledgeSearchResponse,
+  KnowledgeSearchMode,
+  KnowledgeSearchStatus,
+  PromptTestRequest,
+  PromptTestResponse,
+} from "./client.js";
 
 export {
   APIError,
@@ -81,3 +92,61 @@ export type {
   RenderedPrompt,
   TextPromptContent,
 } from "./prompts/types.js";
+
+export type { Requests, Queries, Responses } from "./management/contracts.js";
+export type * from "./management/execution-types.js";
+
+export type {
+  MemoryPage,
+  MemorySpace,
+  MemoryPolicy,
+  MemoryItem,
+  MemoryEvidence,
+  MemoryRelation,
+  MemoryEmbedding,
+  MemoryItemEntity,
+  MemoryEntity,
+  MemoryProfile,
+  MemoryRun,
+  MemorySpaceCreate,
+  MemorySpaceUpdate,
+  MemoryPolicyCreate,
+  MemoryPolicyUpdate,
+  MemoryItemUpdate,
+  MemorySpaceFilters,
+  MemoryPolicyFilters,
+  MemoryItemFilters,
+  MemoryRunFilters,
+  MemoryType,
+  MemoryStatus,
+  MemoryLayer,
+  MemorySourceType,
+  MemoryMessage,
+  MemoryEvent,
+  MemoryIngestRequest,
+  MemorySearchFilters,
+  MemorySearchRequest,
+  MemoryContextRequest,
+  MemoryResult,
+  MemorySearchResponse,
+  MemoryContextResponse,
+  MemoryIndexingResult,
+  MemoryIngestResponse,
+  MemoryManualRequest,
+  MemoryIndexingConfig,
+  MemoryReindexRequest,
+  MemoryGenerateRequest,
+  MemoryProfileGenerateResponse,
+  MemoryObservationGenerateResponse,
+} from "./memory/types.js";
+
+export { managementManifest } from "./management/manifest.js";
+
+export {
+  extractPromptVariableNames,
+  interpolatePromptVariables,
+  promptVariableValue,
+  validatePromptTemplate,
+  validatePromptVariableValues,
+  validatePromptSettings,
+} from "./prompts/variables.js";