@nirmos/sdk 0.1.0 → 0.3.1

package/src/gateway/types.ts

@@ -91,8 +91,7 @@ export interface PromptReference {
   position?: "before" | "after";
 }
 
-export interface ChatCreateParams {
-  model: string;
+interface ChatCreateParamsBase {
   messages?: readonly ChatMessage[];
   /** Resolve and render a managed prompt before sending the gateway request. */
   prompt?: PromptReference;
@@ -105,12 +104,27 @@ export interface ChatCreateParams {
   responseFormat?: ResponseFormat;
   seed?: number;
   user?: string;
+  /** Optional provider override. Omit to let the gateway select a provider. */
   provider?: string;
   fallbackModels?: readonly string[];
   routingStrategy?: RoutingStrategy;
   metadata?: Readonly<Record<string, JsonValue>>;
 }
 
+export type ChatCreateParams = ChatCreateParamsBase &
+  (
+    | {
+        /** Model identifier. Provider selection is handled by the gateway by default. */
+        model: string;
+        route?: never;
+      }
+    | {
+        /** Nirmos route identifier. Routing is resolved by the gateway. */
+        route: string;
+        model?: never;
+      }
+  );
+
 export type FinishReason = ExtensibleString<
   "stop" | "length" | "toolCalls" | "contentFilter"
 >;
@@ -145,13 +159,17 @@ export interface ChatStreamEvent {
 }
 
 export interface EmbeddingCreateParams {
+  /** Model identifier. Provider selection is handled by the gateway by default. */
   model: string;
   input: string | readonly string[];
   dimensions?: number;
   encoding?: "float" | "base64";
   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;
 }
 
@@ -171,6 +189,7 @@ export type ImageSize = ExtensibleString<
 >;
 
 export interface ImageGenerateParams {
+  /** Model identifier. Provider selection is handled by the gateway by default. */
   model: string;
   prompt: string;
   count?: number;
@@ -183,6 +202,7 @@ export interface ImageGenerateParams {
   responseFormat?: "url" | "base64";
   background?: ExtensibleString<"transparent" | "opaque" | "auto">;
   user?: string;
+  /** Optional provider override. Omit to use the model's configured default provider. */
   provider?: string;
   metadata?: Readonly<Record<string, JsonValue>>;
 }

package/src/index.ts

@@ -1,5 +1,12 @@
-export { Nirmos, NirmosClient } from "./client.js";
-export type { NirmosOptions } from "./client.js";
+export { Nirmos } from "./client.js";
+export type {
+  NirmosOptions,
+  NirmosAuth,
+  EndpointExecution,
+  KnowledgeMatch,
+  PromptTestRequest,
+  PromptTestResponse,
+} from "./client.js";
 
 export {
   APIError,
@@ -81,3 +88,52 @@ 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";