@nirmos/sdk 0.3.2 → 0.3.4

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 (73) hide show
  1. package/README.md +285 -17
  2. package/dist/cjs/core/transport.js +16 -3
  3. package/dist/cjs/core/transport.js.map +1 -1
  4. package/dist/cjs/core/version.js +6 -0
  5. package/dist/cjs/core/version.js.map +1 -0
  6. package/dist/cjs/evaluations/types.js +3 -0
  7. package/dist/cjs/evaluations/types.js.map +1 -0
  8. package/dist/cjs/gateway/chat-stream.js +10 -0
  9. package/dist/cjs/gateway/chat-stream.js.map +1 -1
  10. package/dist/cjs/gateway/chat.js +1 -0
  11. package/dist/cjs/gateway/chat.js.map +1 -1
  12. package/dist/cjs/gateway/embeddings.js +1 -0
  13. package/dist/cjs/gateway/embeddings.js.map +1 -1
  14. package/dist/cjs/gateway/mappers.js +39 -2
  15. package/dist/cjs/gateway/mappers.js.map +1 -1
  16. package/dist/cjs/memory/execution-types.js +3 -0
  17. package/dist/cjs/memory/execution-types.js.map +1 -0
  18. package/dist/esm/core/transport.js +15 -2
  19. package/dist/esm/core/transport.js.map +1 -1
  20. package/dist/esm/core/version.d.ts +2 -0
  21. package/dist/esm/core/version.d.ts.map +1 -0
  22. package/dist/esm/core/version.js +3 -0
  23. package/dist/esm/core/version.js.map +1 -0
  24. package/dist/esm/evaluations/types.d.ts +13 -0
  25. package/dist/esm/evaluations/types.d.ts.map +1 -0
  26. package/dist/esm/evaluations/types.js +2 -0
  27. package/dist/esm/evaluations/types.js.map +1 -0
  28. package/dist/esm/gateway/chat-stream.d.ts.map +1 -1
  29. package/dist/esm/gateway/chat-stream.js +11 -1
  30. package/dist/esm/gateway/chat-stream.js.map +1 -1
  31. package/dist/esm/gateway/chat.d.ts.map +1 -1
  32. package/dist/esm/gateway/chat.js +1 -0
  33. package/dist/esm/gateway/chat.js.map +1 -1
  34. package/dist/esm/gateway/embeddings.d.ts.map +1 -1
  35. package/dist/esm/gateway/embeddings.js +1 -0
  36. package/dist/esm/gateway/embeddings.js.map +1 -1
  37. package/dist/esm/gateway/mappers.d.ts +2 -0
  38. package/dist/esm/gateway/mappers.d.ts.map +1 -1
  39. package/dist/esm/gateway/mappers.js +38 -2
  40. package/dist/esm/gateway/mappers.js.map +1 -1
  41. package/dist/esm/gateway/types.d.ts +8 -0
  42. package/dist/esm/gateway/types.d.ts.map +1 -1
  43. package/dist/esm/index.d.ts +1 -0
  44. package/dist/esm/index.d.ts.map +1 -1
  45. package/dist/esm/management/contracts.d.ts +4865 -9009
  46. package/dist/esm/management/contracts.d.ts.map +1 -1
  47. package/dist/esm/memory/execution-types.d.ts +35 -0
  48. package/dist/esm/memory/execution-types.d.ts.map +1 -0
  49. package/dist/esm/memory/execution-types.js +2 -0
  50. package/dist/esm/memory/execution-types.js.map +1 -0
  51. package/dist/esm/memory/types.d.ts +9 -23
  52. package/dist/esm/memory/types.d.ts.map +1 -1
  53. package/examples/evaluation-offline.mjs +149 -0
  54. package/examples/evaluation-quickstart.mjs +205 -0
  55. package/examples/evaluation-quickstart.ts +250 -0
  56. package/examples/evaluation-trace-import.mjs +81 -0
  57. package/examples/evaluation-trace-import.ts +105 -0
  58. package/examples/memory-quickstart.mjs +199 -0
  59. package/examples/memory-quickstart.ts +240 -0
  60. package/examples/tsconfig.json +5 -0
  61. package/package.json +5 -4
  62. package/src/core/transport.ts +14 -2
  63. package/src/core/version.ts +2 -0
  64. package/src/evaluations/types.ts +18 -0
  65. package/src/gateway/chat-stream.ts +12 -1
  66. package/src/gateway/chat.ts +1 -0
  67. package/src/gateway/embeddings.ts +1 -0
  68. package/src/gateway/mappers.ts +55 -2
  69. package/src/gateway/types.ts +8 -0
  70. package/src/index.ts +11 -0
  71. package/src/management/contracts.ts +42 -79
  72. package/src/memory/execution-types.ts +2 -0
  73. package/src/memory/types.ts +10 -22
@@ -0,0 +1,2 @@
1
+ // Generated from the Memory runtime response schema. Do not edit.
2
+ export type MemoryIngestResponse = { "memoryRunId": string; "memories": Array<{ "id": string; "content": string; "type": "preference" | "fact" | "relationship" | "decision" | "constraint" | "commitment" | "procedure" | "event" | "project_fact" | "temporary_state" | "observation" | "custom"; "layer": "atomic" | "observation"; "status": "active" | "superseded" | "expired" | "archived" | "deleted"; "validFrom": string | null; "validUntil": string | null; "confidence": number | null; }>; "candidateCount": number; "acceptedCount": number; "rejectedCount": number; "insertedCount": number; "mergedCount": number; "reinforcedCount": number; "supersededCount": number; "ignoredCount": number; "indexing": { "indexed": number; "failed": number; "diagnostics"?: Array<{ "code": string; "status": number; "retryable": boolean; "details"?: { [key: string]: unknown; }; }>; }; "replayed": boolean; };
@@ -79,6 +79,10 @@ export interface MemorySearchFilters {
79
79
  export interface MemorySearchRequest {
80
80
  memorySpaceId: string;
81
81
  query: string;
82
+ /** Default relevant: one bounded model check. Raw returns nearest neighbors without validation. */
83
+ relevance?: "relevant" | "raw";
84
+ /** Minimum normalized vector similarity (0–1), before ranking. Calibrate per embedding model. */
85
+ minScore?: number;
82
86
  limit?: number;
83
87
  filters?: MemorySearchFilters;
84
88
  }
@@ -100,29 +104,13 @@ export type MemoryResult = Pick<
100
104
  | "confidence"
101
105
  >;
102
106
  export interface MemorySearchResponse {
103
- memories: Array<MemoryResult & { score: number }>;
104
- }
105
- export interface MemoryContextResponse {
106
- memories: Array<MemoryResult & { score?: number }>;
107
- }
108
- export interface MemoryIndexingResult {
109
- indexed: number;
110
- failed: number;
111
- }
112
- export interface MemoryIngestResponse {
113
- memoryRunId: string;
114
- memories: MemoryResult[];
115
- candidateCount: number;
116
- acceptedCount: number;
117
- rejectedCount: number;
118
- insertedCount: number;
119
- mergedCount: number;
120
- reinforcedCount: number;
121
- supersededCount: number;
122
- ignoredCount: number;
123
- indexing: MemoryIndexingResult;
124
- replayed?: boolean;
107
+ memories: Array<MemoryResult & { score: number; similarityScore: number }>;
108
+ relevance: "relevant" | "raw";
125
109
  }
110
+ export type MemoryContextResponse = MemorySearchResponse;
111
+
112
+ export type { MemoryIngestResponse } from "./execution-types.js";
113
+ export type MemoryIndexingResult = import("./execution-types.js").MemoryIngestResponse["indexing"];
126
114
  export interface MemoryManualRequest {
127
115
  memorySpaceId: string;
128
116
  content: string;