@dakera-ai/dakera 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -275,7 +275,7 @@ interface TextUpsertResponse {
     /** Approximate number of tokens processed */
     tokens_processed: number;
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating embeddings in milliseconds */
     embedding_time_ms: number;
 }
@@ -316,7 +316,7 @@ interface TextQueryResponse {
     /** Search results */
     results: TextSearchResult[];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating query embedding in milliseconds */
     embedding_time_ms: number;
     /** Time spent searching in milliseconds */
@@ -342,12 +342,37 @@ interface BatchTextQueryResponse {
     /** Results for each query */
     results: TextSearchResult[][];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating all embeddings in milliseconds */
     embedding_time_ms: number;
     /** Time spent on all searches in milliseconds */
     search_time_ms: number;
 }
+/**
+ * Request body for ``PUT /v1/namespaces/:namespace`` (upsert semantics).
+ *
+ * Creates the namespace if it does not exist, or updates its configuration
+ * if it already exists.
+ */
+interface ConfigureNamespaceRequest {
+    /** Vector dimension. Required on creation; must match on update. */
+    dimension: number;
+    /** Distance metric (default: cosine). */
+    distance?: DistanceMetric;
+}
+/**
+ * Response from ``PUT /v1/namespaces/:namespace``.
+ */
+interface ConfigureNamespaceResponse {
+    /** Namespace name. */
+    namespace: string;
+    /** Vector dimension. */
+    dimension: number;
+    /** Distance metric in use. */
+    distance: DistanceMetric;
+    /** ``true`` if the namespace was newly created; ``false`` if it already existed. */
+    created: boolean;
+}
 /** Memory type classification */
 type MemoryType = 'episodic' | 'semantic' | 'procedural' | 'strategic';
 /** Request to store a memory */
@@ -1210,6 +1235,17 @@ declare class DakeraClient {
         indexType?: string;
         metadata?: Record<string, unknown>;
     }): Promise<NamespaceInfo>;
+    /**
+     * Create or update a namespace configuration (upsert semantics).
+     *
+     * Creates the namespace if it does not exist, or updates its configuration
+     * if it already exists.  Requires Write scope.
+     *
+     * @param namespace - Namespace name
+     * @param request - dimension and optional distance metric
+     * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+     */
+    configureNamespace(namespace: string, request: ConfigureNamespaceRequest): Promise<ConfigureNamespaceResponse>;
     /**
      * Delete a namespace.
      *
@@ -1763,4 +1799,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.d.ts

@@ -275,7 +275,7 @@ interface TextUpsertResponse {
     /** Approximate number of tokens processed */
     tokens_processed: number;
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating embeddings in milliseconds */
     embedding_time_ms: number;
 }
@@ -316,7 +316,7 @@ interface TextQueryResponse {
     /** Search results */
     results: TextSearchResult[];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating query embedding in milliseconds */
     embedding_time_ms: number;
     /** Time spent searching in milliseconds */
@@ -342,12 +342,37 @@ interface BatchTextQueryResponse {
     /** Results for each query */
     results: TextSearchResult[][];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating all embeddings in milliseconds */
     embedding_time_ms: number;
     /** Time spent on all searches in milliseconds */
     search_time_ms: number;
 }
+/**
+ * Request body for ``PUT /v1/namespaces/:namespace`` (upsert semantics).
+ *
+ * Creates the namespace if it does not exist, or updates its configuration
+ * if it already exists.
+ */
+interface ConfigureNamespaceRequest {
+    /** Vector dimension. Required on creation; must match on update. */
+    dimension: number;
+    /** Distance metric (default: cosine). */
+    distance?: DistanceMetric;
+}
+/**
+ * Response from ``PUT /v1/namespaces/:namespace``.
+ */
+interface ConfigureNamespaceResponse {
+    /** Namespace name. */
+    namespace: string;
+    /** Vector dimension. */
+    dimension: number;
+    /** Distance metric in use. */
+    distance: DistanceMetric;
+    /** ``true`` if the namespace was newly created; ``false`` if it already existed. */
+    created: boolean;
+}
 /** Memory type classification */
 type MemoryType = 'episodic' | 'semantic' | 'procedural' | 'strategic';
 /** Request to store a memory */
@@ -1210,6 +1235,17 @@ declare class DakeraClient {
         indexType?: string;
         metadata?: Record<string, unknown>;
     }): Promise<NamespaceInfo>;
+    /**
+     * Create or update a namespace configuration (upsert semantics).
+     *
+     * Creates the namespace if it does not exist, or updates its configuration
+     * if it already exists.  Requires Write scope.
+     *
+     * @param namespace - Namespace name
+     * @param request - dimension and optional distance metric
+     * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+     */
+    configureNamespace(namespace: string, request: ConfigureNamespaceRequest): Promise<ConfigureNamespaceResponse>;
     /**
      * Delete a namespace.
      *
@@ -1763,4 +1799,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.js

@@ -473,6 +473,19 @@ var DakeraClient = class {
     if (options.metadata) body.metadata = options.metadata;
     return this.request("POST", "/v1/namespaces", body);
   }
+  /**
+   * Create or update a namespace configuration (upsert semantics).
+   *
+   * Creates the namespace if it does not exist, or updates its configuration
+   * if it already exists.  Requires Write scope.
+   *
+   * @param namespace - Namespace name
+   * @param request - dimension and optional distance metric
+   * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+   */
+  async configureNamespace(namespace, request) {
+    return this.request("PUT", `/v1/namespaces/${namespace}`, request);
+  }
   /**
    * Delete a namespace.
    *

package/dist/index.mjs

@@ -435,6 +435,19 @@ var DakeraClient = class {
     if (options.metadata) body.metadata = options.metadata;
     return this.request("POST", "/v1/namespaces", body);
   }
+  /**
+   * Create or update a namespace configuration (upsert semantics).
+   *
+   * Creates the namespace if it does not exist, or updates its configuration
+   * if it already exists.  Requires Write scope.
+   *
+   * @param namespace - Namespace name
+   * @param request - dimension and optional distance metric
+   * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+   */
+  async configureNamespace(namespace, request) {
+    return this.request("PUT", `/v1/namespaces/${namespace}`, request);
+  }
   /**
    * Delete a namespace.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",