@dakera-ai/dakera 0.9.6 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/dist/index.d.mts +78 -1
  2. package/dist/index.d.ts +78 -1
  3. package/dist/index.js +55 -0
  4. package/dist/index.mjs +55 -0
  5. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -1344,6 +1344,43 @@ interface GraphExport {
1344
1344
  /** Total number of edges in the export. */
1345
1345
  edge_count: number;
1346
1346
  }
1347
+ /** Response from `GET /v1/knowledge/query` (KG-2). */
1348
+ interface KgQueryResponse {
1349
+ /** Agent whose graph was queried. */
1350
+ agent_id: string;
1351
+ /** Number of unique memory node IDs referenced by the returned edges. */
1352
+ node_count: number;
1353
+ /** Number of edges returned. */
1354
+ edge_count: number;
1355
+ /** Matching edges, up to `limit`. */
1356
+ edges: GraphEdge[];
1357
+ }
1358
+ /** Response from `GET /v1/knowledge/path` (KG-2). */
1359
+ interface KgPathResponse {
1360
+ /** Agent whose graph was traversed. */
1361
+ agent_id: string;
1362
+ /** Source memory ID. */
1363
+ from_id: string;
1364
+ /** Target memory ID. */
1365
+ to_id: string;
1366
+ /** Number of edges in the shortest path (0 if source === target). */
1367
+ hop_count: number;
1368
+ /** Ordered list of memory IDs from source to target (inclusive). */
1369
+ path: string[];
1370
+ }
1371
+ /** Response from `GET /v1/knowledge/export` with `format=json` (KG-2). */
1372
+ interface KgExportResponse {
1373
+ /** Agent whose graph was exported. */
1374
+ agent_id: string;
1375
+ /** Export format used (`"json"` when this interface is returned). */
1376
+ format: string;
1377
+ /** Total number of unique memory node IDs in the export. */
1378
+ node_count: number;
1379
+ /** Total number of edges in the export. */
1380
+ edge_count: number;
1381
+ /** All graph edges for the agent. */
1382
+ edges: GraphEdge[];
1383
+ }
1347
1384
  /** Options for `client.memories.graph()`. */
1348
1385
  interface MemoryGraphOptions {
1349
1386
  /** Maximum traversal depth (default: 1, max: 3). */
@@ -2305,6 +2342,46 @@ declare class DakeraClient {
2305
2342
  summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
2306
2343
  /** Deduplicate memories */
2307
2344
  deduplicate(request: DeduplicateRequest): Promise<DeduplicateResponse>;
2345
+ /**
2346
+ * Query the memory knowledge graph using a filter DSL (KG-2).
2347
+ *
2348
+ * Calls `GET /v1/knowledge/query`.
2349
+ *
2350
+ * @param agentId - Agent whose graph to query.
2351
+ * @param options - Optional filters: `rootId`, `edgeType`, `minWeight`,
2352
+ * `maxDepth` (default 3), `limit` (default 100, max 1000).
2353
+ */
2354
+ knowledgeQuery(agentId: string, options?: {
2355
+ rootId?: string;
2356
+ edgeType?: string;
2357
+ minWeight?: number;
2358
+ maxDepth?: number;
2359
+ limit?: number;
2360
+ }): Promise<KgQueryResponse>;
2361
+ /**
2362
+ * Find the BFS shortest path between two memory IDs (KG-2).
2363
+ *
2364
+ * Calls `GET /v1/knowledge/path`.
2365
+ *
2366
+ * @param agentId - Agent whose graph to traverse.
2367
+ * @param fromId - Source memory ID.
2368
+ * @param toId - Target memory ID.
2369
+ * @throws {@link NotFoundError} if no path exists between the two memories.
2370
+ */
2371
+ knowledgePath(agentId: string, fromId: string, toId: string): Promise<KgPathResponse>;
2372
+ /**
2373
+ * Export the memory knowledge graph as JSON or GraphML (KG-2).
2374
+ *
2375
+ * Calls `GET /v1/knowledge/export`.
2376
+ *
2377
+ * @param agentId - Agent whose graph to export.
2378
+ * @param format - `"json"` (default) or `"graphml"`.
2379
+ *
2380
+ * @returns `KgExportResponse` for `format="json"`. For `format="graphml"`
2381
+ * the server returns `application/xml` — use the raw fetch API if you
2382
+ * need the GraphML XML string.
2383
+ */
2384
+ knowledgeExport(agentId: string, format?: string): Promise<KgExportResponse>;
2308
2385
  /**
2309
2386
  * Build a cross-agent memory network graph (DASH-A).
2310
2387
  *
@@ -2736,4 +2813,4 @@ declare class TimeoutError extends DakeraError {
2736
2813
  constructor(message: string);
2737
2814
  }
2738
2815
 
2739
- export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, 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 ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, 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 };
2816
+ export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, 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 ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, 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 CHANGED
@@ -1344,6 +1344,43 @@ interface GraphExport {
1344
1344
  /** Total number of edges in the export. */
1345
1345
  edge_count: number;
1346
1346
  }
1347
+ /** Response from `GET /v1/knowledge/query` (KG-2). */
1348
+ interface KgQueryResponse {
1349
+ /** Agent whose graph was queried. */
1350
+ agent_id: string;
1351
+ /** Number of unique memory node IDs referenced by the returned edges. */
1352
+ node_count: number;
1353
+ /** Number of edges returned. */
1354
+ edge_count: number;
1355
+ /** Matching edges, up to `limit`. */
1356
+ edges: GraphEdge[];
1357
+ }
1358
+ /** Response from `GET /v1/knowledge/path` (KG-2). */
1359
+ interface KgPathResponse {
1360
+ /** Agent whose graph was traversed. */
1361
+ agent_id: string;
1362
+ /** Source memory ID. */
1363
+ from_id: string;
1364
+ /** Target memory ID. */
1365
+ to_id: string;
1366
+ /** Number of edges in the shortest path (0 if source === target). */
1367
+ hop_count: number;
1368
+ /** Ordered list of memory IDs from source to target (inclusive). */
1369
+ path: string[];
1370
+ }
1371
+ /** Response from `GET /v1/knowledge/export` with `format=json` (KG-2). */
1372
+ interface KgExportResponse {
1373
+ /** Agent whose graph was exported. */
1374
+ agent_id: string;
1375
+ /** Export format used (`"json"` when this interface is returned). */
1376
+ format: string;
1377
+ /** Total number of unique memory node IDs in the export. */
1378
+ node_count: number;
1379
+ /** Total number of edges in the export. */
1380
+ edge_count: number;
1381
+ /** All graph edges for the agent. */
1382
+ edges: GraphEdge[];
1383
+ }
1347
1384
  /** Options for `client.memories.graph()`. */
1348
1385
  interface MemoryGraphOptions {
1349
1386
  /** Maximum traversal depth (default: 1, max: 3). */
@@ -2305,6 +2342,46 @@ declare class DakeraClient {
2305
2342
  summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
2306
2343
  /** Deduplicate memories */
2307
2344
  deduplicate(request: DeduplicateRequest): Promise<DeduplicateResponse>;
2345
+ /**
2346
+ * Query the memory knowledge graph using a filter DSL (KG-2).
2347
+ *
2348
+ * Calls `GET /v1/knowledge/query`.
2349
+ *
2350
+ * @param agentId - Agent whose graph to query.
2351
+ * @param options - Optional filters: `rootId`, `edgeType`, `minWeight`,
2352
+ * `maxDepth` (default 3), `limit` (default 100, max 1000).
2353
+ */
2354
+ knowledgeQuery(agentId: string, options?: {
2355
+ rootId?: string;
2356
+ edgeType?: string;
2357
+ minWeight?: number;
2358
+ maxDepth?: number;
2359
+ limit?: number;
2360
+ }): Promise<KgQueryResponse>;
2361
+ /**
2362
+ * Find the BFS shortest path between two memory IDs (KG-2).
2363
+ *
2364
+ * Calls `GET /v1/knowledge/path`.
2365
+ *
2366
+ * @param agentId - Agent whose graph to traverse.
2367
+ * @param fromId - Source memory ID.
2368
+ * @param toId - Target memory ID.
2369
+ * @throws {@link NotFoundError} if no path exists between the two memories.
2370
+ */
2371
+ knowledgePath(agentId: string, fromId: string, toId: string): Promise<KgPathResponse>;
2372
+ /**
2373
+ * Export the memory knowledge graph as JSON or GraphML (KG-2).
2374
+ *
2375
+ * Calls `GET /v1/knowledge/export`.
2376
+ *
2377
+ * @param agentId - Agent whose graph to export.
2378
+ * @param format - `"json"` (default) or `"graphml"`.
2379
+ *
2380
+ * @returns `KgExportResponse` for `format="json"`. For `format="graphml"`
2381
+ * the server returns `application/xml` — use the raw fetch API if you
2382
+ * need the GraphML XML string.
2383
+ */
2384
+ knowledgeExport(agentId: string, format?: string): Promise<KgExportResponse>;
2308
2385
  /**
2309
2386
  * Build a cross-agent memory network graph (DASH-A).
2310
2387
  *
@@ -2736,4 +2813,4 @@ declare class TimeoutError extends DakeraError {
2736
2813
  constructor(message: string);
2737
2814
  }
2738
2815
 
2739
- export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, 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 ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, 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 };
2816
+ export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, 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 ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, 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 CHANGED
@@ -1374,6 +1374,61 @@ var DakeraClient = class {
1374
1374
  async deduplicate(request) {
1375
1375
  return this.request("POST", "/v1/knowledge/deduplicate", request);
1376
1376
  }
1377
+ // -------------------------------------------------------------------------
1378
+ // KG-2: Graph Query & Export
1379
+ // -------------------------------------------------------------------------
1380
+ /**
1381
+ * Query the memory knowledge graph using a filter DSL (KG-2).
1382
+ *
1383
+ * Calls `GET /v1/knowledge/query`.
1384
+ *
1385
+ * @param agentId - Agent whose graph to query.
1386
+ * @param options - Optional filters: `rootId`, `edgeType`, `minWeight`,
1387
+ * `maxDepth` (default 3), `limit` (default 100, max 1000).
1388
+ */
1389
+ async knowledgeQuery(agentId2, options) {
1390
+ const params = new URLSearchParams({ agent_id: agentId2 });
1391
+ if (options?.rootId != null) params.set("root_id", options.rootId);
1392
+ if (options?.edgeType != null) params.set("edge_type", options.edgeType);
1393
+ if (options?.minWeight != null) params.set("min_weight", String(options.minWeight));
1394
+ if (options?.maxDepth != null) params.set("max_depth", String(options.maxDepth));
1395
+ if (options?.limit != null) params.set("limit", String(options.limit));
1396
+ return this.request("GET", `/v1/knowledge/query?${params}`);
1397
+ }
1398
+ /**
1399
+ * Find the BFS shortest path between two memory IDs (KG-2).
1400
+ *
1401
+ * Calls `GET /v1/knowledge/path`.
1402
+ *
1403
+ * @param agentId - Agent whose graph to traverse.
1404
+ * @param fromId - Source memory ID.
1405
+ * @param toId - Target memory ID.
1406
+ * @throws {@link NotFoundError} if no path exists between the two memories.
1407
+ */
1408
+ async knowledgePath(agentId2, fromId, toId) {
1409
+ const params = new URLSearchParams({
1410
+ agent_id: agentId2,
1411
+ from: fromId,
1412
+ to: toId
1413
+ });
1414
+ return this.request("GET", `/v1/knowledge/path?${params}`);
1415
+ }
1416
+ /**
1417
+ * Export the memory knowledge graph as JSON or GraphML (KG-2).
1418
+ *
1419
+ * Calls `GET /v1/knowledge/export`.
1420
+ *
1421
+ * @param agentId - Agent whose graph to export.
1422
+ * @param format - `"json"` (default) or `"graphml"`.
1423
+ *
1424
+ * @returns `KgExportResponse` for `format="json"`. For `format="graphml"`
1425
+ * the server returns `application/xml` — use the raw fetch API if you
1426
+ * need the GraphML XML string.
1427
+ */
1428
+ async knowledgeExport(agentId2, format = "json") {
1429
+ const params = new URLSearchParams({ agent_id: agentId2, format });
1430
+ return this.request("GET", `/v1/knowledge/export?${params}`);
1431
+ }
1377
1432
  /**
1378
1433
  * Build a cross-agent memory network graph (DASH-A).
1379
1434
  *
package/dist/index.mjs CHANGED
@@ -1334,6 +1334,61 @@ var DakeraClient = class {
1334
1334
  async deduplicate(request) {
1335
1335
  return this.request("POST", "/v1/knowledge/deduplicate", request);
1336
1336
  }
1337
+ // -------------------------------------------------------------------------
1338
+ // KG-2: Graph Query & Export
1339
+ // -------------------------------------------------------------------------
1340
+ /**
1341
+ * Query the memory knowledge graph using a filter DSL (KG-2).
1342
+ *
1343
+ * Calls `GET /v1/knowledge/query`.
1344
+ *
1345
+ * @param agentId - Agent whose graph to query.
1346
+ * @param options - Optional filters: `rootId`, `edgeType`, `minWeight`,
1347
+ * `maxDepth` (default 3), `limit` (default 100, max 1000).
1348
+ */
1349
+ async knowledgeQuery(agentId2, options) {
1350
+ const params = new URLSearchParams({ agent_id: agentId2 });
1351
+ if (options?.rootId != null) params.set("root_id", options.rootId);
1352
+ if (options?.edgeType != null) params.set("edge_type", options.edgeType);
1353
+ if (options?.minWeight != null) params.set("min_weight", String(options.minWeight));
1354
+ if (options?.maxDepth != null) params.set("max_depth", String(options.maxDepth));
1355
+ if (options?.limit != null) params.set("limit", String(options.limit));
1356
+ return this.request("GET", `/v1/knowledge/query?${params}`);
1357
+ }
1358
+ /**
1359
+ * Find the BFS shortest path between two memory IDs (KG-2).
1360
+ *
1361
+ * Calls `GET /v1/knowledge/path`.
1362
+ *
1363
+ * @param agentId - Agent whose graph to traverse.
1364
+ * @param fromId - Source memory ID.
1365
+ * @param toId - Target memory ID.
1366
+ * @throws {@link NotFoundError} if no path exists between the two memories.
1367
+ */
1368
+ async knowledgePath(agentId2, fromId, toId) {
1369
+ const params = new URLSearchParams({
1370
+ agent_id: agentId2,
1371
+ from: fromId,
1372
+ to: toId
1373
+ });
1374
+ return this.request("GET", `/v1/knowledge/path?${params}`);
1375
+ }
1376
+ /**
1377
+ * Export the memory knowledge graph as JSON or GraphML (KG-2).
1378
+ *
1379
+ * Calls `GET /v1/knowledge/export`.
1380
+ *
1381
+ * @param agentId - Agent whose graph to export.
1382
+ * @param format - `"json"` (default) or `"graphml"`.
1383
+ *
1384
+ * @returns `KgExportResponse` for `format="json"`. For `format="graphml"`
1385
+ * the server returns `application/xml` — use the raw fetch API if you
1386
+ * need the GraphML XML string.
1387
+ */
1388
+ async knowledgeExport(agentId2, format = "json") {
1389
+ const params = new URLSearchParams({ agent_id: agentId2, format });
1390
+ return this.request("GET", `/v1/knowledge/export?${params}`);
1391
+ }
1337
1392
  /**
1338
1393
  * Build a cross-agent memory network graph (DASH-A).
1339
1394
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dakera-ai/dakera",
3
- "version": "0.9.6",
3
+ "version": "0.9.7",
4
4
  "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",