llama-stack-client 0.2.16 → 0.2.17

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 (149) hide show
  1. package/LICENSE +4 -198
  2. package/index.d.mts +2 -2
  3. package/index.d.ts +2 -2
  4. package/index.d.ts.map +1 -1
  5. package/index.js.map +1 -1
  6. package/index.mjs +1 -1
  7. package/index.mjs.map +1 -1
  8. package/package.json +2 -6
  9. package/resources/agents/agents.d.ts +29 -2
  10. package/resources/agents/agents.d.ts.map +1 -1
  11. package/resources/agents/agents.js.map +1 -1
  12. package/resources/agents/agents.mjs.map +1 -1
  13. package/resources/agents/session.d.ts +18 -0
  14. package/resources/agents/session.d.ts.map +1 -1
  15. package/resources/agents/steps.d.ts +4 -1
  16. package/resources/agents/steps.d.ts.map +1 -1
  17. package/resources/agents/turn.d.ts +113 -8
  18. package/resources/agents/turn.d.ts.map +1 -1
  19. package/resources/benchmarks.d.ts +15 -0
  20. package/resources/benchmarks.d.ts.map +1 -1
  21. package/resources/chat/chat.d.ts +24 -0
  22. package/resources/chat/chat.d.ts.map +1 -1
  23. package/resources/chat/chat.js.map +1 -1
  24. package/resources/chat/chat.mjs.map +1 -1
  25. package/resources/chat/completions.d.ts +648 -6
  26. package/resources/chat/completions.d.ts.map +1 -1
  27. package/resources/datasets.d.ts +42 -6
  28. package/resources/datasets.d.ts.map +1 -1
  29. package/resources/eval/eval.d.ts +9 -0
  30. package/resources/eval/eval.d.ts.map +1 -1
  31. package/resources/eval/eval.js.map +1 -1
  32. package/resources/eval/eval.mjs.map +1 -1
  33. package/resources/files.d.ts +9 -0
  34. package/resources/files.d.ts.map +1 -1
  35. package/resources/index.d.ts +1 -1
  36. package/resources/index.d.ts.map +1 -1
  37. package/resources/index.js.map +1 -1
  38. package/resources/index.mjs +1 -1
  39. package/resources/index.mjs.map +1 -1
  40. package/resources/inference.d.ts +36 -0
  41. package/resources/inference.d.ts.map +1 -1
  42. package/resources/inspect.d.ts +45 -1
  43. package/resources/inspect.d.ts.map +1 -1
  44. package/resources/inspect.js +1 -1
  45. package/resources/inspect.mjs +1 -1
  46. package/resources/models.d.ts +21 -0
  47. package/resources/models.d.ts.map +1 -1
  48. package/resources/post-training/job.d.ts +95 -2
  49. package/resources/post-training/job.d.ts.map +1 -1
  50. package/resources/post-training/post-training.d.ts +206 -0
  51. package/resources/post-training/post-training.d.ts.map +1 -1
  52. package/resources/post-training/post-training.js.map +1 -1
  53. package/resources/post-training/post-training.mjs.map +1 -1
  54. package/resources/providers.d.ts +9 -0
  55. package/resources/providers.d.ts.map +1 -1
  56. package/resources/responses/input-items.d.ts +114 -0
  57. package/resources/responses/input-items.d.ts.map +1 -1
  58. package/resources/responses/responses.d.ts +1265 -12
  59. package/resources/responses/responses.d.ts.map +1 -1
  60. package/resources/responses/responses.js.map +1 -1
  61. package/resources/responses/responses.mjs.map +1 -1
  62. package/resources/routes.d.ts +10 -1
  63. package/resources/routes.d.ts.map +1 -1
  64. package/resources/routes.js +1 -1
  65. package/resources/routes.mjs +1 -1
  66. package/resources/safety.d.ts +72 -1
  67. package/resources/safety.d.ts.map +1 -1
  68. package/resources/safety.js +6 -0
  69. package/resources/safety.js.map +1 -1
  70. package/resources/safety.mjs +6 -0
  71. package/resources/safety.mjs.map +1 -1
  72. package/resources/scoring-functions.d.ts +51 -0
  73. package/resources/scoring-functions.d.ts.map +1 -1
  74. package/resources/scoring.d.ts +9 -0
  75. package/resources/scoring.d.ts.map +1 -1
  76. package/resources/shared.d.ts +209 -3
  77. package/resources/shared.d.ts.map +1 -1
  78. package/resources/shields.d.ts +7 -1
  79. package/resources/shields.d.ts.map +1 -1
  80. package/resources/synthetic-data-generation.d.ts +18 -1
  81. package/resources/synthetic-data-generation.d.ts.map +1 -1
  82. package/resources/synthetic-data-generation.js +3 -0
  83. package/resources/synthetic-data-generation.js.map +1 -1
  84. package/resources/synthetic-data-generation.mjs +3 -0
  85. package/resources/synthetic-data-generation.mjs.map +1 -1
  86. package/resources/telemetry.d.ts +214 -0
  87. package/resources/telemetry.d.ts.map +1 -1
  88. package/resources/tool-runtime/rag-tool.d.ts +16 -4
  89. package/resources/tool-runtime/rag-tool.d.ts.map +1 -1
  90. package/resources/tool-runtime/rag-tool.js +2 -2
  91. package/resources/tool-runtime/rag-tool.mjs +2 -2
  92. package/resources/tool-runtime/tool-runtime.d.ts +52 -1
  93. package/resources/tool-runtime/tool-runtime.d.ts.map +1 -1
  94. package/resources/tool-runtime/tool-runtime.js.map +1 -1
  95. package/resources/tool-runtime/tool-runtime.mjs.map +1 -1
  96. package/resources/toolgroups.d.ts +30 -0
  97. package/resources/toolgroups.d.ts.map +1 -1
  98. package/resources/tools.d.ts +45 -0
  99. package/resources/tools.d.ts.map +1 -1
  100. package/resources/vector-dbs.d.ts +45 -0
  101. package/resources/vector-dbs.d.ts.map +1 -1
  102. package/resources/vector-io.d.ts +9 -0
  103. package/resources/vector-io.d.ts.map +1 -1
  104. package/resources/vector-stores/files.d.ts +149 -1
  105. package/resources/vector-stores/files.d.ts.map +1 -1
  106. package/resources/vector-stores/vector-stores.d.ts +121 -1
  107. package/resources/vector-stores/vector-stores.d.ts.map +1 -1
  108. package/resources/vector-stores/vector-stores.js.map +1 -1
  109. package/resources/vector-stores/vector-stores.mjs.map +1 -1
  110. package/src/index.ts +9 -1
  111. package/src/resources/agents/agents.ts +29 -2
  112. package/src/resources/agents/session.ts +18 -0
  113. package/src/resources/agents/steps.ts +4 -1
  114. package/src/resources/agents/turn.ts +113 -8
  115. package/src/resources/benchmarks.ts +15 -0
  116. package/src/resources/chat/chat.ts +24 -0
  117. package/src/resources/chat/completions.ts +678 -0
  118. package/src/resources/datasets.ts +42 -6
  119. package/src/resources/eval/eval.ts +9 -0
  120. package/src/resources/files.ts +9 -0
  121. package/src/resources/index.ts +7 -1
  122. package/src/resources/inference.ts +36 -0
  123. package/src/resources/inspect.ts +45 -1
  124. package/src/resources/models.ts +21 -0
  125. package/src/resources/post-training/job.ts +95 -2
  126. package/src/resources/post-training/post-training.ts +206 -0
  127. package/src/resources/providers.ts +9 -0
  128. package/src/resources/responses/input-items.ts +114 -0
  129. package/src/resources/responses/responses.ts +1265 -12
  130. package/src/resources/routes.ts +10 -1
  131. package/src/resources/safety.ts +83 -1
  132. package/src/resources/scoring-functions.ts +51 -0
  133. package/src/resources/scoring.ts +9 -0
  134. package/src/resources/shared.ts +209 -3
  135. package/src/resources/shields.ts +7 -1
  136. package/src/resources/synthetic-data-generation.ts +18 -1
  137. package/src/resources/telemetry.ts +214 -0
  138. package/src/resources/tool-runtime/rag-tool.ts +16 -4
  139. package/src/resources/tool-runtime/tool-runtime.ts +52 -1
  140. package/src/resources/toolgroups.ts +30 -0
  141. package/src/resources/tools.ts +45 -0
  142. package/src/resources/vector-dbs.ts +45 -0
  143. package/src/resources/vector-io.ts +9 -0
  144. package/src/resources/vector-stores/files.ts +149 -1
  145. package/src/resources/vector-stores/vector-stores.ts +121 -1
  146. package/src/version.ts +1 -1
  147. package/version.d.ts +1 -1
  148. package/version.js +1 -1
  149. package/version.mjs +1 -1
@@ -11,30 +11,75 @@ export declare class Tools extends APIResource {
11
11
  */
12
12
  get(toolName: string, options?: Core.RequestOptions): Core.APIPromise<Tool>;
13
13
  }
14
+ /**
15
+ * Response containing a list of tools.
16
+ */
14
17
  export interface ListToolsResponse {
18
+ /**
19
+ * List of tools
20
+ */
15
21
  data: ToolListResponse;
16
22
  }
23
+ /**
24
+ * A tool that can be invoked by agents.
25
+ */
17
26
  export interface Tool {
27
+ /**
28
+ * Human-readable description of what the tool does
29
+ */
18
30
  description: string;
19
31
  identifier: string;
32
+ /**
33
+ * List of parameters this tool accepts
34
+ */
20
35
  parameters: Array<Tool.Parameter>;
21
36
  provider_id: string;
37
+ /**
38
+ * ID of the tool group this tool belongs to
39
+ */
22
40
  toolgroup_id: string;
41
+ /**
42
+ * Type of resource, always 'tool'
43
+ */
23
44
  type: 'tool';
45
+ /**
46
+ * (Optional) Additional metadata about the tool
47
+ */
24
48
  metadata?: {
25
49
  [key: string]: boolean | number | string | Array<unknown> | unknown | null;
26
50
  };
27
51
  provider_resource_id?: string;
28
52
  }
29
53
  export declare namespace Tool {
54
+ /**
55
+ * Parameter definition for a tool.
56
+ */
30
57
  interface Parameter {
58
+ /**
59
+ * Human-readable description of what the parameter does
60
+ */
31
61
  description: string;
62
+ /**
63
+ * Name of the parameter
64
+ */
32
65
  name: string;
66
+ /**
67
+ * Type of the parameter (e.g., string, integer)
68
+ */
33
69
  parameter_type: string;
70
+ /**
71
+ * Whether this parameter is required for tool invocation
72
+ */
34
73
  required: boolean;
74
+ /**
75
+ * (Optional) Default value for the parameter if not provided
76
+ */
35
77
  default?: boolean | number | string | Array<unknown> | unknown | null;
36
78
  }
37
79
  }
80
+ /**
81
+ * List of tools
82
+ */
38
83
  export type ToolListResponse = Array<Tool>;
39
84
  export interface ToolListParams {
40
85
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAC9F,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAatE;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;CAG5E;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAElC,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,MAAM,CAAC;IAErB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAE1F,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,yBAAiB,IAAI,CAAC;IACpB,UAAiB,SAAS;QACxB,WAAW,EAAE,MAAM,CAAC;QAEpB,IAAI,EAAE,MAAM,CAAC;QAEb,cAAc,EAAE,MAAM,CAAC;QAEvB,QAAQ,EAAE,OAAO,CAAC;QAElB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;KACvE;CACF;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAC9F,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAatE;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;CAG5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAElC,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAE1F,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,yBAAiB,IAAI,CAAC;IACpB;;OAEG;IACH,UAAiB,SAAS;QACxB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,cAAc,EAAE,MAAM,CAAC;QAEvB;;WAEG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;KACvE;CACF;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
@@ -18,35 +18,80 @@ export declare class VectorDBs extends APIResource {
18
18
  */
19
19
  unregister(vectorDBId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
20
20
  }
21
+ /**
22
+ * Response from listing vector databases.
23
+ */
21
24
  export interface ListVectorDBsResponse {
25
+ /**
26
+ * List of vector databases
27
+ */
22
28
  data: VectorDBListResponse;
23
29
  }
30
+ /**
31
+ * Vector database resource for storing and querying vector embeddings.
32
+ */
24
33
  export interface VectorDBRetrieveResponse {
34
+ /**
35
+ * Dimension of the embedding vectors
36
+ */
25
37
  embedding_dimension: number;
38
+ /**
39
+ * Name of the embedding model to use for vector generation
40
+ */
26
41
  embedding_model: string;
27
42
  identifier: string;
28
43
  provider_id: string;
44
+ /**
45
+ * Type of resource, always 'vector_db' for vector databases
46
+ */
29
47
  type: 'vector_db';
30
48
  provider_resource_id?: string;
31
49
  vector_db_name?: string;
32
50
  }
51
+ /**
52
+ * List of vector databases
53
+ */
33
54
  export type VectorDBListResponse = Array<VectorDBListResponse.VectorDBListResponseItem>;
34
55
  export declare namespace VectorDBListResponse {
56
+ /**
57
+ * Vector database resource for storing and querying vector embeddings.
58
+ */
35
59
  interface VectorDBListResponseItem {
60
+ /**
61
+ * Dimension of the embedding vectors
62
+ */
36
63
  embedding_dimension: number;
64
+ /**
65
+ * Name of the embedding model to use for vector generation
66
+ */
37
67
  embedding_model: string;
38
68
  identifier: string;
39
69
  provider_id: string;
70
+ /**
71
+ * Type of resource, always 'vector_db' for vector databases
72
+ */
40
73
  type: 'vector_db';
41
74
  provider_resource_id?: string;
42
75
  vector_db_name?: string;
43
76
  }
44
77
  }
78
+ /**
79
+ * Vector database resource for storing and querying vector embeddings.
80
+ */
45
81
  export interface VectorDBRegisterResponse {
82
+ /**
83
+ * Dimension of the embedding vectors
84
+ */
46
85
  embedding_dimension: number;
86
+ /**
87
+ * Name of the embedding model to use for vector generation
88
+ */
47
89
  embedding_model: string;
48
90
  identifier: string;
49
91
  provider_id: string;
92
+ /**
93
+ * Type of resource, always 'vector_db' for vector databases
94
+ */
50
95
  type: 'vector_db';
51
96
  provider_resource_id?: string;
52
97
  vector_db_name?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"vector-dbs.d.ts","sourceRoot":"","sources":["../src/resources/vector-dbs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,qBAAa,SAAU,SAAQ,WAAW;IACxC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAItG;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;IAM1E;;OAEG;IACH,QAAQ,CACN,IAAI,EAAE,sBAAsB,EAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAC5B,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAI5C;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;CAMrF;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,eAAe,EAAE,MAAM,CAAC;IAExB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,EAAE,WAAW,CAAC;IAElB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;AAExF,yBAAiB,oBAAoB,CAAC;IACpC,UAAiB,wBAAwB;QACvC,mBAAmB,EAAE,MAAM,CAAC;QAE5B,eAAe,EAAE,MAAM,CAAC;QAExB,UAAU,EAAE,MAAM,CAAC;QAEnB,WAAW,EAAE,MAAM,CAAC;QAEpB,IAAI,EAAE,WAAW,CAAC;QAElB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,eAAe,EAAE,MAAM,CAAC;IAExB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,EAAE,WAAW,CAAC;IAElB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
1
+ {"version":3,"file":"vector-dbs.d.ts","sourceRoot":"","sources":["../src/resources/vector-dbs.ts"],"names":[],"mappings":"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"}
@@ -11,8 +11,17 @@ export declare class VectorIo extends APIResource {
11
11
  */
12
12
  query(body: VectorIoQueryParams, options?: Core.RequestOptions): Core.APIPromise<QueryChunksResponse>;
13
13
  }
14
+ /**
15
+ * Response from querying chunks in a vector database.
16
+ */
14
17
  export interface QueryChunksResponse {
18
+ /**
19
+ * List of content chunks returned from the query
20
+ */
15
21
  chunks: Array<QueryChunksResponse.Chunk>;
22
+ /**
23
+ * Relevance scores corresponding to each returned chunk
24
+ */
16
25
  scores: Array<number>;
17
26
  }
18
27
  export declare namespace QueryChunksResponse {
@@ -1 +1 @@
1
- {"version":3,"file":"vector-io.d.ts","sourceRoot":"","sources":["../src/resources/vector-io.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"vector-io.d.ts","sourceRoot":"","sources":["../src/resources/vector-io.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAQxF;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC;CAGtG;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC;QAEnC;;;WAGG;QACH,QAAQ,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;SAAE,CAAC;QAEzF;;;WAGG;QACH,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAErC;;WAEG;QACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAE1B;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IAED,UAAiB,KAAK,CAAC;QACrB;;;WAGG;QACH,UAAiB,aAAa;YAC5B;;eAEG;YACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;YAEnC;;eAEG;YACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAE/B;;;eAGG;YACH,QAAQ,CAAC,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;YAEtB;;eAEG;YACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAE7B;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAE3B;;eAEG;YACH,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB;;eAEG;YACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAE9B;;eAEG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B;KACF;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,MAAM,EAAE,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE1C;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yBAAiB,oBAAoB,CAAC;IACpC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC;QAEnC;;;WAGG;QACH,QAAQ,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;SAAE,CAAC;QAEzF;;;WAGG;QACH,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAErC;;WAEG;QACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAE1B;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IAED,UAAiB,KAAK,CAAC;QACrB;;;WAGG;QACH,UAAiB,aAAa;YAC5B;;eAEG;YACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;YAEnC;;eAEG;YACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAE/B;;;eAGG;YACH,QAAQ,CAAC,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;YAEtB;;eAEG;YACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAE7B;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAE3B;;eAEG;YACH,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB;;eAEG;YACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAE9B;;eAEG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B;KACF;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,kBAAkB,CAAC;IAEjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;CACzF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
@@ -31,69 +31,174 @@ export declare class Files extends APIResource {
31
31
  * OpenAI Vector Store File object.
32
32
  */
33
33
  export interface VectorStoreFile {
34
+ /**
35
+ * Unique identifier for the file
36
+ */
34
37
  id: string;
38
+ /**
39
+ * Key-value attributes associated with the file
40
+ */
35
41
  attributes: {
36
42
  [key: string]: boolean | number | string | Array<unknown> | unknown | null;
37
43
  };
44
+ /**
45
+ * Strategy used for splitting the file into chunks
46
+ */
38
47
  chunking_strategy: VectorStoreFile.VectorStoreChunkingStrategyAuto | VectorStoreFile.VectorStoreChunkingStrategyStatic;
48
+ /**
49
+ * Timestamp when the file was added to the vector store
50
+ */
39
51
  created_at: number;
52
+ /**
53
+ * Object type identifier, always "vector_store.file"
54
+ */
40
55
  object: string;
56
+ /**
57
+ * Current processing status of the file
58
+ */
41
59
  status: 'completed' | 'in_progress' | 'cancelled' | 'failed';
60
+ /**
61
+ * Storage space used by this file in bytes
62
+ */
42
63
  usage_bytes: number;
64
+ /**
65
+ * ID of the vector store containing this file
66
+ */
43
67
  vector_store_id: string;
68
+ /**
69
+ * (Optional) Error information if file processing failed
70
+ */
44
71
  last_error?: VectorStoreFile.LastError;
45
72
  }
46
73
  export declare namespace VectorStoreFile {
74
+ /**
75
+ * Automatic chunking strategy for vector store files.
76
+ */
47
77
  interface VectorStoreChunkingStrategyAuto {
78
+ /**
79
+ * Strategy type, always "auto" for automatic chunking
80
+ */
48
81
  type: 'auto';
49
82
  }
83
+ /**
84
+ * Static chunking strategy with configurable parameters.
85
+ */
50
86
  interface VectorStoreChunkingStrategyStatic {
87
+ /**
88
+ * Configuration parameters for the static chunking strategy
89
+ */
51
90
  static: VectorStoreChunkingStrategyStatic.Static;
91
+ /**
92
+ * Strategy type, always "static" for static chunking
93
+ */
52
94
  type: 'static';
53
95
  }
54
96
  namespace VectorStoreChunkingStrategyStatic {
97
+ /**
98
+ * Configuration parameters for the static chunking strategy
99
+ */
55
100
  interface Static {
101
+ /**
102
+ * Number of tokens to overlap between adjacent chunks
103
+ */
56
104
  chunk_overlap_tokens: number;
105
+ /**
106
+ * Maximum number of tokens per chunk, must be between 100 and 4096
107
+ */
57
108
  max_chunk_size_tokens: number;
58
109
  }
59
110
  }
111
+ /**
112
+ * (Optional) Error information if file processing failed
113
+ */
60
114
  interface LastError {
115
+ /**
116
+ * Error code indicating the type of failure
117
+ */
61
118
  code: 'server_error' | 'rate_limit_exceeded';
119
+ /**
120
+ * Human-readable error message describing the failure
121
+ */
62
122
  message: string;
63
123
  }
64
124
  }
65
125
  /**
66
- * Response from listing vector stores.
126
+ * Response from listing files in a vector store.
67
127
  */
68
128
  export interface FileListResponse {
129
+ /**
130
+ * List of vector store file objects
131
+ */
69
132
  data: Array<VectorStoreFile>;
133
+ /**
134
+ * Whether there are more files available beyond this page
135
+ */
70
136
  has_more: boolean;
137
+ /**
138
+ * Object type identifier, always "list"
139
+ */
71
140
  object: string;
141
+ /**
142
+ * (Optional) ID of the first file in the list for pagination
143
+ */
72
144
  first_id?: string;
145
+ /**
146
+ * (Optional) ID of the last file in the list for pagination
147
+ */
73
148
  last_id?: string;
74
149
  }
75
150
  /**
76
151
  * Response from deleting a vector store file.
77
152
  */
78
153
  export interface FileDeleteResponse {
154
+ /**
155
+ * Unique identifier of the deleted file
156
+ */
79
157
  id: string;
158
+ /**
159
+ * Whether the deletion operation was successful
160
+ */
80
161
  deleted: boolean;
162
+ /**
163
+ * Object type identifier for the deletion response
164
+ */
81
165
  object: string;
82
166
  }
83
167
  /**
84
168
  * Response from retrieving the contents of a vector store file.
85
169
  */
86
170
  export interface FileContentResponse {
171
+ /**
172
+ * Key-value attributes associated with the file
173
+ */
87
174
  attributes: {
88
175
  [key: string]: boolean | number | string | Array<unknown> | unknown | null;
89
176
  };
177
+ /**
178
+ * List of content items from the file
179
+ */
90
180
  content: Array<FileContentResponse.Content>;
181
+ /**
182
+ * Unique identifier for the file
183
+ */
91
184
  file_id: string;
185
+ /**
186
+ * Name of the file
187
+ */
92
188
  filename: string;
93
189
  }
94
190
  export declare namespace FileContentResponse {
191
+ /**
192
+ * Content item from a vector store file or search result.
193
+ */
95
194
  interface Content {
195
+ /**
196
+ * The actual text content
197
+ */
96
198
  text: string;
199
+ /**
200
+ * Content type, currently only "text" is supported
201
+ */
97
202
  type: 'text';
98
203
  }
99
204
  }
@@ -114,16 +219,40 @@ export interface FileCreateParams {
114
219
  chunking_strategy?: FileCreateParams.VectorStoreChunkingStrategyAuto | FileCreateParams.VectorStoreChunkingStrategyStatic;
115
220
  }
116
221
  export declare namespace FileCreateParams {
222
+ /**
223
+ * Automatic chunking strategy for vector store files.
224
+ */
117
225
  interface VectorStoreChunkingStrategyAuto {
226
+ /**
227
+ * Strategy type, always "auto" for automatic chunking
228
+ */
118
229
  type: 'auto';
119
230
  }
231
+ /**
232
+ * Static chunking strategy with configurable parameters.
233
+ */
120
234
  interface VectorStoreChunkingStrategyStatic {
235
+ /**
236
+ * Configuration parameters for the static chunking strategy
237
+ */
121
238
  static: VectorStoreChunkingStrategyStatic.Static;
239
+ /**
240
+ * Strategy type, always "static" for static chunking
241
+ */
122
242
  type: 'static';
123
243
  }
124
244
  namespace VectorStoreChunkingStrategyStatic {
245
+ /**
246
+ * Configuration parameters for the static chunking strategy
247
+ */
125
248
  interface Static {
249
+ /**
250
+ * Number of tokens to overlap between adjacent chunks
251
+ */
126
252
  chunk_overlap_tokens: number;
253
+ /**
254
+ * Maximum number of tokens per chunk, must be between 100 and 4096
255
+ */
127
256
  max_chunk_size_tokens: number;
128
257
  }
129
258
  }
@@ -137,10 +266,29 @@ export interface FileUpdateParams {
137
266
  };
138
267
  }
139
268
  export interface FileListParams {
269
+ /**
270
+ * (Optional) A cursor for use in pagination. `after` is an object ID that defines
271
+ * your place in the list.
272
+ */
140
273
  after?: string;
274
+ /**
275
+ * (Optional) A cursor for use in pagination. `before` is an object ID that defines
276
+ * your place in the list.
277
+ */
141
278
  before?: string;
279
+ /**
280
+ * (Optional) Filter by file status to only return files with the specified status.
281
+ */
142
282
  filter?: 'completed' | 'in_progress' | 'cancelled' | 'failed';
283
+ /**
284
+ * (Optional) A limit on the number of objects to be returned. Limit can range
285
+ * between 1 and 100, and the default is 20.
286
+ */
143
287
  limit?: number;
288
+ /**
289
+ * (Optional) Sort order by the `created_at` timestamp of the objects. `asc` for
290
+ * ascending order and `desc` for descending order.
291
+ */
144
292
  order?: string;
145
293
  }
146
294
  export declare namespace Files {
@@ -1 +1 @@
1
- {"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/vector-stores/files.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/vector-stores/files.ts"],"names":[],"mappings":"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"}
@@ -35,38 +35,104 @@ export declare class VectorStores extends APIResource {
35
35
  * Response from listing vector stores.
36
36
  */
37
37
  export interface ListVectorStoresResponse {
38
+ /**
39
+ * List of vector store objects
40
+ */
38
41
  data: Array<VectorStore>;
42
+ /**
43
+ * Whether there are more vector stores available beyond this page
44
+ */
39
45
  has_more: boolean;
46
+ /**
47
+ * Object type identifier, always "list"
48
+ */
40
49
  object: string;
50
+ /**
51
+ * (Optional) ID of the first vector store in the list for pagination
52
+ */
41
53
  first_id?: string;
54
+ /**
55
+ * (Optional) ID of the last vector store in the list for pagination
56
+ */
42
57
  last_id?: string;
43
58
  }
44
59
  /**
45
60
  * OpenAI Vector Store object.
46
61
  */
47
62
  export interface VectorStore {
63
+ /**
64
+ * Unique identifier for the vector store
65
+ */
48
66
  id: string;
67
+ /**
68
+ * Timestamp when the vector store was created
69
+ */
49
70
  created_at: number;
71
+ /**
72
+ * File processing status counts for the vector store
73
+ */
50
74
  file_counts: VectorStore.FileCounts;
75
+ /**
76
+ * Set of key-value pairs that can be attached to the vector store
77
+ */
51
78
  metadata: {
52
79
  [key: string]: boolean | number | string | Array<unknown> | unknown | null;
53
80
  };
81
+ /**
82
+ * Object type identifier, always "vector_store"
83
+ */
54
84
  object: string;
85
+ /**
86
+ * Current status of the vector store
87
+ */
55
88
  status: string;
89
+ /**
90
+ * Storage space used by the vector store in bytes
91
+ */
56
92
  usage_bytes: number;
93
+ /**
94
+ * (Optional) Expiration policy for the vector store
95
+ */
57
96
  expires_after?: {
58
97
  [key: string]: boolean | number | string | Array<unknown> | unknown | null;
59
98
  };
99
+ /**
100
+ * (Optional) Timestamp when the vector store will expire
101
+ */
60
102
  expires_at?: number;
103
+ /**
104
+ * (Optional) Timestamp of last activity on the vector store
105
+ */
61
106
  last_active_at?: number;
107
+ /**
108
+ * (Optional) Name of the vector store
109
+ */
62
110
  name?: string;
63
111
  }
64
112
  export declare namespace VectorStore {
113
+ /**
114
+ * File processing status counts for the vector store
115
+ */
65
116
  interface FileCounts {
117
+ /**
118
+ * Number of files that had their processing cancelled
119
+ */
66
120
  cancelled: number;
121
+ /**
122
+ * Number of files that have been successfully processed
123
+ */
67
124
  completed: number;
125
+ /**
126
+ * Number of files that failed to process
127
+ */
68
128
  failed: number;
129
+ /**
130
+ * Number of files currently being processed
131
+ */
69
132
  in_progress: number;
133
+ /**
134
+ * Total number of files in the vector store
135
+ */
70
136
  total: number;
71
137
  }
72
138
  }
@@ -74,18 +140,42 @@ export declare namespace VectorStore {
74
140
  * Response from deleting a vector store.
75
141
  */
76
142
  export interface VectorStoreDeleteResponse {
143
+ /**
144
+ * Unique identifier of the deleted vector store
145
+ */
77
146
  id: string;
147
+ /**
148
+ * Whether the deletion operation was successful
149
+ */
78
150
  deleted: boolean;
151
+ /**
152
+ * Object type identifier for the deletion response
153
+ */
79
154
  object: string;
80
155
  }
81
156
  /**
82
- * Response from searching a vector store.
157
+ * Paginated response from searching a vector store.
83
158
  */
84
159
  export interface VectorStoreSearchResponse {
160
+ /**
161
+ * List of search result objects
162
+ */
85
163
  data: Array<VectorStoreSearchResponse.Data>;
164
+ /**
165
+ * Whether there are more results available beyond this page
166
+ */
86
167
  has_more: boolean;
168
+ /**
169
+ * Object type identifier for the search results page
170
+ */
87
171
  object: string;
172
+ /**
173
+ * The original search query that was executed
174
+ */
88
175
  search_query: string;
176
+ /**
177
+ * (Optional) Token for retrieving the next page of results
178
+ */
89
179
  next_page?: string;
90
180
  }
91
181
  export declare namespace VectorStoreSearchResponse {
@@ -93,17 +183,41 @@ export declare namespace VectorStoreSearchResponse {
93
183
  * Response from searching a vector store.
94
184
  */
95
185
  interface Data {
186
+ /**
187
+ * List of content items matching the search query
188
+ */
96
189
  content: Array<Data.Content>;
190
+ /**
191
+ * Unique identifier of the file containing the result
192
+ */
97
193
  file_id: string;
194
+ /**
195
+ * Name of the file containing the result
196
+ */
98
197
  filename: string;
198
+ /**
199
+ * Relevance score for this search result
200
+ */
99
201
  score: number;
202
+ /**
203
+ * (Optional) Key-value attributes associated with the file
204
+ */
100
205
  attributes?: {
101
206
  [key: string]: string | number | boolean;
102
207
  };
103
208
  }
104
209
  namespace Data {
210
+ /**
211
+ * Content item from a vector store file or search result.
212
+ */
105
213
  interface Content {
214
+ /**
215
+ * The actual text content
216
+ */
106
217
  text: string;
218
+ /**
219
+ * Content type, currently only "text" is supported
220
+ */
107
221
  type: 'text';
108
222
  }
109
223
  }
@@ -223,7 +337,13 @@ export declare namespace VectorStoreSearchParams {
223
337
  * Ranking options for fine-tuning the search results.
224
338
  */
225
339
  interface RankingOptions {
340
+ /**
341
+ * (Optional) Name of the ranking algorithm to use
342
+ */
226
343
  ranker?: string;
344
+ /**
345
+ * (Optional) Minimum relevance score threshold for results
346
+ */
227
347
  score_threshold?: number;
228
348
  }
229
349
  }