@dxos/assistant 0.8.4-main.67995b8 → 0.8.4-main.72ec0f3

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 (176) hide show
  1. package/dist/lib/browser/chunk-J5LGTIGS.mjs +10 -0
  2. package/dist/lib/browser/extraction/index.mjs +121 -165
  3. package/dist/lib/browser/extraction/index.mjs.map +4 -4
  4. package/dist/lib/browser/index.mjs +1110 -1034
  5. package/dist/lib/browser/index.mjs.map +4 -4
  6. package/dist/lib/browser/meta.json +1 -1
  7. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +11 -0
  8. package/dist/lib/node-esm/extraction/index.mjs +121 -165
  9. package/dist/lib/node-esm/extraction/index.mjs.map +4 -4
  10. package/dist/lib/node-esm/index.mjs +1110 -1034
  11. package/dist/lib/node-esm/index.mjs.map +4 -4
  12. package/dist/lib/node-esm/meta.json +1 -1
  13. package/dist/types/src/{context/binding.d.ts → conversation/context.d.ts} +54 -5
  14. package/dist/types/src/conversation/context.d.ts.map +1 -0
  15. package/dist/types/src/conversation/conversation.d.ts +29 -26
  16. package/dist/types/src/conversation/conversation.d.ts.map +1 -1
  17. package/dist/types/src/conversation/index.d.ts +1 -0
  18. package/dist/types/src/conversation/index.d.ts.map +1 -1
  19. package/dist/types/src/diff.d.ts +15 -0
  20. package/dist/types/src/diff.d.ts.map +1 -0
  21. package/dist/types/src/diff.test.d.ts +2 -0
  22. package/dist/types/src/diff.test.d.ts.map +1 -0
  23. package/dist/types/src/errors.d.ts +46 -13
  24. package/dist/types/src/errors.d.ts.map +1 -1
  25. package/dist/types/src/execution-graph.d.ts +85 -0
  26. package/dist/types/src/execution-graph.d.ts.map +1 -0
  27. package/dist/types/src/execution-graph.test.d.ts +2 -0
  28. package/dist/types/src/execution-graph.test.d.ts.map +1 -0
  29. package/dist/types/src/extraction/extraction-llm-function/extraction-llm-function.d.ts +1 -1
  30. package/dist/types/src/extraction/extraction-llm-function/extraction-llm-function.d.ts.map +1 -1
  31. package/dist/types/src/extraction/extraction-ner-function/extraction-ner-function.d.ts +100 -57
  32. package/dist/types/src/extraction/extraction-ner-function/extraction-ner-function.d.ts.map +1 -1
  33. package/dist/types/src/extraction/extraction-ner-function/named-entity-recognition.d.ts.map +1 -1
  34. package/dist/types/src/extraction/extraction.d.ts +262 -221
  35. package/dist/types/src/extraction/extraction.d.ts.map +1 -1
  36. package/dist/types/src/extraction/quotes.d.ts +1 -1
  37. package/dist/types/src/extraction/quotes.d.ts.map +1 -1
  38. package/dist/types/src/functions/services.d.ts +18 -4
  39. package/dist/types/src/functions/services.d.ts.map +1 -1
  40. package/dist/types/src/index.d.ts +3 -2
  41. package/dist/types/src/index.d.ts.map +1 -1
  42. package/dist/types/src/session/GenericToolkit.d.ts +84 -0
  43. package/dist/types/src/session/GenericToolkit.d.ts.map +1 -0
  44. package/dist/types/src/session/artifact-diff.d.ts +27 -0
  45. package/dist/types/src/session/artifact-diff.d.ts.map +1 -0
  46. package/dist/types/src/session/error-handling.d.ts +4 -0
  47. package/dist/types/src/session/error-handling.d.ts.map +1 -0
  48. package/dist/types/src/session/format.d.ts +12 -0
  49. package/dist/types/src/session/format.d.ts.map +1 -0
  50. package/dist/types/src/session/format.test.d.ts +2 -0
  51. package/dist/types/src/session/format.test.d.ts.map +1 -0
  52. package/dist/types/src/session/index.d.ts +4 -0
  53. package/dist/types/src/session/index.d.ts.map +1 -1
  54. package/dist/types/src/session/observer.d.ts +22 -0
  55. package/dist/types/src/session/observer.d.ts.map +1 -0
  56. package/dist/types/src/session/session.d.ts +28 -237
  57. package/dist/types/src/session/session.d.ts.map +1 -1
  58. package/dist/types/src/session/toolkit.d.ts +15 -0
  59. package/dist/types/src/session/toolkit.d.ts.map +1 -0
  60. package/dist/types/src/session/version-pin.d.ts +4 -4
  61. package/dist/types/src/session/version-pin.d.ts.map +1 -1
  62. package/dist/types/src/templates/index.d.ts +1 -1
  63. package/dist/types/src/templates/system.d.ts +18 -0
  64. package/dist/types/src/templates/system.d.ts.map +1 -0
  65. package/dist/types/src/types/artifact.d.ts +20 -0
  66. package/dist/types/src/types/artifact.d.ts.map +1 -0
  67. package/dist/types/src/types/index.d.ts +2 -0
  68. package/dist/types/src/types/index.d.ts.map +1 -0
  69. package/dist/types/tsconfig.tsbuildinfo +1 -1
  70. package/package.json +33 -36
  71. package/src/conversation/context.ts +186 -0
  72. package/src/conversation/conversation.ts +93 -61
  73. package/src/conversation/index.ts +1 -0
  74. package/src/diff.test.ts +43 -0
  75. package/src/diff.ts +84 -0
  76. package/src/errors.ts +6 -1
  77. package/src/execution-graph.test.ts +740 -0
  78. package/src/execution-graph.ts +509 -0
  79. package/src/extraction/extraction-llm-function/extraction-llm-function.test.ts +10 -9
  80. package/src/extraction/extraction-llm-function/extraction-llm-function.ts +48 -56
  81. package/src/extraction/extraction-ner-function/extraction-ner-function.test.ts +18 -17
  82. package/src/extraction/extraction-ner-function/extraction-ner-function.ts +42 -43
  83. package/src/extraction/extraction-ner-function/named-entity-recognition.test.ts +12 -6
  84. package/src/extraction/extraction-ner-function/named-entity-recognition.ts +2 -0
  85. package/src/extraction/extraction.ts +7 -6
  86. package/src/extraction/quotes.test.ts +3 -3
  87. package/src/extraction/quotes.ts +4 -4
  88. package/src/functions/services.ts +108 -45
  89. package/src/index.ts +3 -2
  90. package/src/session/GenericToolkit.ts +130 -0
  91. package/src/session/artifact-diff.ts +41 -0
  92. package/src/session/error-handling.ts +41 -0
  93. package/src/session/format.test.ts +61 -0
  94. package/src/session/format.ts +144 -0
  95. package/src/session/index.ts +5 -0
  96. package/src/session/observer.ts +59 -0
  97. package/src/session/session.conversations.json +1 -0
  98. package/src/session/session.test.ts +38 -199
  99. package/src/session/session.ts +128 -251
  100. package/src/session/toolkit.ts +48 -0
  101. package/src/session/version-pin.ts +7 -8
  102. package/src/templates/index.ts +1 -1
  103. package/src/templates/instructions/format.tpl +61 -0
  104. package/src/templates/instructions/system.tpl +48 -0
  105. package/src/templates/system.ts +41 -0
  106. package/src/{types.ts → types/artifact.ts} +31 -7
  107. package/src/types/index.ts +5 -0
  108. package/src/typings.d.ts +5 -0
  109. package/dist/lib/browser/chunk-6WRGDEMH.mjs +0 -89
  110. package/dist/lib/browser/chunk-6WRGDEMH.mjs.map +0 -7
  111. package/dist/lib/browser/chunk-SIXTNSGV.mjs +0 -250
  112. package/dist/lib/browser/chunk-SIXTNSGV.mjs.map +0 -7
  113. package/dist/lib/browser/named-entity-recognition-O46UTCLR.mjs +0 -13
  114. package/dist/lib/node-esm/chunk-3UU5V4FS.mjs +0 -91
  115. package/dist/lib/node-esm/chunk-3UU5V4FS.mjs.map +0 -7
  116. package/dist/lib/node-esm/chunk-FD5NXKDP.mjs +0 -252
  117. package/dist/lib/node-esm/chunk-FD5NXKDP.mjs.map +0 -7
  118. package/dist/lib/node-esm/named-entity-recognition-W4VMRCH6.mjs +0 -14
  119. package/dist/types/bin/chat.d.ts +0 -2
  120. package/dist/types/bin/chat.d.ts.map +0 -1
  121. package/dist/types/src/context/binder.d.ts +0 -34
  122. package/dist/types/src/context/binder.d.ts.map +0 -1
  123. package/dist/types/src/context/binding.d.ts.map +0 -1
  124. package/dist/types/src/context/index.d.ts +0 -3
  125. package/dist/types/src/context/index.d.ts.map +0 -1
  126. package/dist/types/src/research/exa.d.ts +0 -12
  127. package/dist/types/src/research/exa.d.ts.map +0 -1
  128. package/dist/types/src/research/graph.d.ts +0 -51
  129. package/dist/types/src/research/graph.d.ts.map +0 -1
  130. package/dist/types/src/research/graph.test.d.ts +0 -2
  131. package/dist/types/src/research/graph.test.d.ts.map +0 -1
  132. package/dist/types/src/research/index.d.ts +0 -4
  133. package/dist/types/src/research/index.d.ts.map +0 -1
  134. package/dist/types/src/research/research.d.ts +0 -10
  135. package/dist/types/src/research/research.d.ts.map +0 -1
  136. package/dist/types/src/research/research.test.d.ts +0 -2
  137. package/dist/types/src/research/research.test.d.ts.map +0 -1
  138. package/dist/types/src/session/version-pin.test.d.ts +0 -2
  139. package/dist/types/src/session/version-pin.test.d.ts.map +0 -1
  140. package/dist/types/src/summarization/summarization.test.d.ts +0 -2
  141. package/dist/types/src/summarization/summarization.test.d.ts.map +0 -1
  142. package/dist/types/src/templates/prompt.d.ts +0 -30
  143. package/dist/types/src/templates/prompt.d.ts.map +0 -1
  144. package/dist/types/src/testing/exa-search-1748337321991.d.ts +0 -38
  145. package/dist/types/src/testing/exa-search-1748337321991.d.ts.map +0 -1
  146. package/dist/types/src/testing/exa-search-1748337331526.d.ts +0 -37
  147. package/dist/types/src/testing/exa-search-1748337331526.d.ts.map +0 -1
  148. package/dist/types/src/testing/exa-search-1748337344119.d.ts +0 -58
  149. package/dist/types/src/testing/exa-search-1748337344119.d.ts.map +0 -1
  150. package/dist/types/src/testing/index.d.ts +0 -3
  151. package/dist/types/src/testing/index.d.ts.map +0 -1
  152. package/dist/types/src/types.d.ts +0 -13
  153. package/dist/types/src/types.d.ts.map +0 -1
  154. package/src/context/binder.ts +0 -103
  155. package/src/context/binding.ts +0 -32
  156. package/src/context/index.ts +0 -6
  157. package/src/research/exa.ts +0 -97
  158. package/src/research/graph.test.ts +0 -64
  159. package/src/research/graph.ts +0 -369
  160. package/src/research/index.ts +0 -7
  161. package/src/research/instructions-research.tpl +0 -98
  162. package/src/research/research.test.ts +0 -190
  163. package/src/research/research.ts +0 -87
  164. package/src/session/__snapshots__/session.test.ts.snap +0 -32
  165. package/src/session/version-pin.test.ts +0 -7
  166. package/src/summarization/summarization.test.ts +0 -199
  167. package/src/templates/assistant.tpl +0 -111
  168. package/src/templates/prompt.ts +0 -45
  169. package/src/testing/exa-search-1748337321991.ts +0 -131
  170. package/src/testing/exa-search-1748337331526.ts +0 -144
  171. package/src/testing/exa-search-1748337344119.ts +0 -133
  172. package/src/testing/index.ts +0 -11
  173. package/src/typedefs.d.ts +0 -8
  174. /package/dist/lib/browser/{named-entity-recognition-O46UTCLR.mjs.map → chunk-J5LGTIGS.mjs.map} +0 -0
  175. /package/dist/lib/node-esm/{named-entity-recognition-W4VMRCH6.mjs.map → chunk-HSLMI22Q.mjs.map} +0 -0
  176. /package/src/extraction/extraction-llm-function/{instructions.tpl → transcription-instructions.tpl} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"quotes.d.ts","sourceRoot":"","sources":["../../../../src/extraction/quotes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,eAAO,MAAM,gBAAgB;;;;;EAe3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3E,eAAO,MAAM,UAAU,GAAU,QAAQ,MAAM,EAAE,EAAE,IAAI,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAS7F,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,QAAQ,gBAAgB,WAYtE,CAAC"}
1
+ {"version":3,"file":"quotes.d.ts","sourceRoot":"","sources":["../../../../src/extraction/quotes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,eAAO,MAAM,gBAAgB;;;;;EAe3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3E,eAAO,MAAM,UAAU,GAAU,QAAQ,MAAM,EAAE,EAAE,IAAI,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAS7F,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,QAAQ,gBAAgB,WAYtE,CAAC"}
@@ -1,6 +1,20 @@
1
- import { Layer } from 'effect';
1
+ import * as Tool from '@effect/ai/Tool';
2
+ import type * as Toolkit from '@effect/ai/Toolkit';
3
+ import * as Layer from 'effect/Layer';
2
4
  import { ToolExecutionService, ToolResolverService } from '@dxos/ai';
3
- import { LocalFunctionExecutionService, type FunctionDefinition } from '@dxos/functions';
4
- export declare const makeToolResolverFromFunctions: (functions: FunctionDefinition<any, any>[]) => Layer.Layer<ToolResolverService>;
5
- export declare const makeToolExecutionServiceFromFunctions: (functions: FunctionDefinition<any, any>[]) => Layer.Layer<ToolExecutionService, never, LocalFunctionExecutionService>;
5
+ import { DatabaseService } from '@dxos/echo-db';
6
+ import { FunctionDefinition, FunctionInvocationService } from '@dxos/functions';
7
+ /**
8
+ * Constructs a `ToolResolverService` whose `resolve(id)` looks up tools in the following order:
9
+ * 1. Toolkit: return an existing tool from the provided `toolkit` if one is present under `id`.
10
+ * 2. Functions in DB: query `FunctionType` by `key=id`; if found, deserialize and project to a tool
11
+ * (propagating any `deployedFunctionId` discovered in the object's metadata).
12
+ * 3. Functions passed in: fall back to a matching `FunctionDefinition` from the `functions` array.
13
+ *
14
+ * If none of the above yield a match, the effect fails with `AiToolNotFoundError`.
15
+ *
16
+ * Requires `DatabaseService` in the environment.
17
+ */
18
+ export declare const makeToolResolverFromFunctions: (functions: FunctionDefinition.Any[], toolkit: Toolkit.Toolkit<any>) => Layer.Layer<ToolResolverService, never, DatabaseService>;
19
+ export declare const makeToolExecutionServiceFromFunctions: (toolkit: Toolkit.Toolkit<any>, handlersLayer: Layer.Layer<Tool.Handler<any>, never, never>) => Layer.Layer<ToolExecutionService, never, FunctionInvocationService>;
6
20
  //# sourceMappingURL=services.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../src/functions/services.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,EAAoC,MAAM,QAAQ,CAAC;AAElF,OAAO,EAAuB,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGzF,eAAO,MAAM,6BAA6B,GACxC,WAAW,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KACxC,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAWjC,CAAC;AAEF,eAAO,MAAM,qCAAqC,GAChD,WAAW,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KACxC,KAAK,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,EAAE,6BAA6B,CA0BxE,CAAC"}
1
+ {"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../src/functions/services.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAuB,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG1F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAY,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,GACxC,WAAW,kBAAkB,CAAC,GAAG,EAAE,EACnC,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAC5B,KAAK,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,EAAE,eAAe,CA8BzD,CAAC;AAEF,eAAO,MAAM,qCAAqC,GAChD,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAC7B,eAAe,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAC1D,KAAK,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,EAAE,yBAAyB,CAoCpE,CAAC"}
@@ -1,7 +1,8 @@
1
- export * from './context';
2
1
  export * from './conversation';
2
+ export * from './diff';
3
+ export * from './errors';
4
+ export * from './execution-graph';
3
5
  export * from './functions';
4
- export * from './research';
5
6
  export * from './session';
6
7
  export * from './templates';
7
8
  export * from './types';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
@@ -0,0 +1,84 @@
1
+ import type * as Tool from '@effect/ai/Tool';
2
+ import * as Toolkit from '@effect/ai/Toolkit';
3
+ import * as Effect from 'effect/Effect';
4
+ import * as Layer from 'effect/Layer';
5
+ import * as Pipeable from 'effect/Pipeable';
6
+ import type * as Schema from 'effect/Schema';
7
+ import type * as SchemaAST from 'effect/SchemaAST';
8
+ /**
9
+ * Unique identifier for generic toolkit instances.
10
+ */
11
+ export declare const TypeId = "~@dxos/assistant/GenericToolkit";
12
+ /**
13
+ * Type-level representation of the generic toolkit identifier.
14
+ */
15
+ export type TypeId = typeof TypeId;
16
+ /**
17
+ * Type-safe way to define toolkits where we don't know specific types of tools,
18
+ * and we want to bundle definition and handlers together.
19
+ *
20
+ * Usefull for plugin-based systems, where tools are dynamically added.
21
+ *
22
+ * @param TR requirements type to the tool invocation.
23
+ * @param E failure type to the handlers layer.
24
+ * @param R requirements type to the handlers layer.
25
+ */
26
+ export interface GenericToolkit<TR = never, E = never, R = never> extends Pipeable.Pipeable {
27
+ readonly [TypeId]: TypeId;
28
+ /**
29
+ * Toolkit definition.
30
+ */
31
+ readonly toolkit: Toolkit.Toolkit<GenericTools<TR>>;
32
+ /**
33
+ * Handlers layer.
34
+ */
35
+ readonly layer: Layer.Layer<unknown, E, R>;
36
+ /**
37
+ * Handlers effect.
38
+ */
39
+ readonly handlers: Effect.Effect<Toolkit.WithHandler<GenericTools<TR>>, E, R>;
40
+ }
41
+ /**
42
+ * Generic constraint.
43
+ *
44
+ * NOTE: Only use in place of `T extends PortableToolkit.Any`. Not suitable for standalone use.
45
+ */
46
+ export interface Any {
47
+ readonly [TypeId]: TypeId;
48
+ readonly toolkit: Toolkit.Toolkit<any>;
49
+ readonly layer: Layer.Layer<unknown, any, any>;
50
+ }
51
+ export type InvocationRequirements<T extends Any> = T extends GenericToolkit<infer TR, infer _E, infer _R> ? TR : never;
52
+ export type Failure<T extends Any> = T extends GenericToolkit<infer _TR, infer E, infer _R> ? E : never;
53
+ export type Requirements<T extends Any> = T extends GenericToolkit<infer _TR, infer _E, infer R> ? R : never;
54
+ /**
55
+ * Creates a portable toolkit from toolkit definition and handlers layer.
56
+ */
57
+ export declare const make: <Tools extends Record<string, Tool.Any>, E, R>(toolkit: Toolkit.Toolkit<Tools>, layer: Layer.Layer<Tool.HandlersFor<Tools>, E, R>) => GenericToolkit<E, R>;
58
+ /**
59
+ * Merges multiple portable toolkits into a single portable toolkit.
60
+ */
61
+ export declare const merge: <const Toolkits extends ReadonlyArray<Any>>(
62
+ /**
63
+ * The toolkits to merge together.
64
+ */
65
+ ...toolkits: Toolkits) => GenericToolkit<InvocationRequirements<Toolkits[number]>, Failure<Toolkits[number]>, Requirements<Toolkits[number]>>;
66
+ /**
67
+ * Generic tools type where we cannot statically enumerate individual tools.
68
+ */
69
+ export type GenericTools<R = never> = Record<string, Tool.Tool<string, {
70
+ readonly parameters: AnyStructSchemaNoContext;
71
+ readonly success: Schema.Schema.AnyNoContext;
72
+ readonly failure: typeof Schema.Never;
73
+ }, R>>;
74
+ export interface AnyStructSchemaNoContext extends Pipeable.Pipeable {
75
+ readonly [Schema.TypeId]: any;
76
+ readonly make: any;
77
+ readonly Type: any;
78
+ readonly Encoded: any;
79
+ readonly Context: never;
80
+ readonly ast: SchemaAST.AST;
81
+ readonly fields: Schema.Struct.Fields;
82
+ readonly annotations: any;
83
+ }
84
+ //# sourceMappingURL=GenericToolkit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GenericToolkit.d.ts","sourceRoot":"","sources":["../../../../src/session/GenericToolkit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import * as Context from 'effect/Context';
2
+ import { type ObjectId } from '@dxos/echo/internal';
3
+ import { type ObjectVersion } from '@dxos/echo-db';
4
+ declare const ArtifactDiffResolver_base: Context.TagClass<ArtifactDiffResolver, "@dxos/assistant/ArtifactDiffResolver", ArtifactDiffResolver.Service>;
5
+ /**
6
+ * Resolves artifact ids to their versions.
7
+ * Used to give the model a sense of the changes to the artifacts made by users during the conversation.
8
+ * The artifacts versions are pinned in the history, and whenever the artifact changes in-between assistant's steps,
9
+ * a diff is inserted into the conversation.
10
+ *
11
+ * Can be optionally provided to the session run call.
12
+ */
13
+ export declare class ArtifactDiffResolver extends ArtifactDiffResolver_base {
14
+ }
15
+ export declare namespace ArtifactDiffResolver {
16
+ type Service = {
17
+ resolve: (artifacts: {
18
+ id: ObjectId;
19
+ lastVersion: ObjectVersion;
20
+ }[]) => Promise<Map<ObjectId, {
21
+ version: ObjectVersion;
22
+ diff?: string;
23
+ }>>;
24
+ };
25
+ }
26
+ export {};
27
+ //# sourceMappingURL=artifact-diff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"artifact-diff.d.ts","sourceRoot":"","sources":["../../../../src/session/artifact-diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;;AAEnD;;;;;;;GAOG;AAEH,qBAAa,oBAAqB,SAAQ,yBAGvC;CAAG;AAEN,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,CACP,SAAS,EAAE;YACT,EAAE,EAAE,QAAQ,CAAC;YACb,WAAW,EAAE,aAAa,CAAC;SAC5B,EAAE,KACA,OAAO,CACV,GAAG,CACD,QAAQ,EACR;YACE,OAAO,EAAE,aAAa,CAAC;YACvB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CACF,CACF,CAAC;KACH,CAAC;CACH"}
@@ -0,0 +1,4 @@
1
+ import * as AiError from '@effect/ai/AiError';
2
+ import * as Effect from 'effect/Effect';
3
+ export declare const mapAiError: (err: AiError.AiError) => Effect.Effect<AiError.AiError>;
4
+ //# sourceMappingURL=error-handling.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../../../src/session/error-handling.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAcxC,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,CAAC,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAoB1B,CAAC"}
@@ -0,0 +1,12 @@
1
+ import * as Effect from 'effect/Effect';
2
+ import { Message } from '@dxos/types';
3
+ import { type AiSessionRunError, type AiSessionRunParams } from './session';
4
+ /**
5
+ * Formats the system prompt.
6
+ */
7
+ export declare const formatSystemPrompt: ({ system, blueprints, objects, }: Pick<AiSessionRunParams<any>, "system" | "blueprints" | "objects">) => Effect.Effect<string, never, never>;
8
+ /**
9
+ * Formats the user prompt.
10
+ */
11
+ export declare const formatUserPrompt: ({ prompt, history, }: Pick<AiSessionRunParams<any>, "prompt" | "history">) => Effect.Effect<Message.Message, AiSessionRunError>;
12
+ //# sourceMappingURL=format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/session/format.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,OAAO,EAAqB,OAAO,EAAE,MAAM,aAAa,CAAC;AAMzD,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE5E;;GAEG;AAEH,eAAO,MAAM,kBAAkB,GAAI,kCAIhC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC,wCAsCjE,CAAC;AAEL;;GAEG;AAGH,eAAO,MAAM,gBAAgB,GAAI,sBAG9B,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAoCrG,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=format.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../../../../src/session/format.test.ts"],"names":[],"mappings":""}
@@ -1,3 +1,7 @@
1
+ export * from './artifact-diff';
2
+ export * from './observer';
1
3
  export * from './session';
4
+ export * from './toolkit';
2
5
  export * from './version-pin';
6
+ export * as GenericToolkit from './GenericToolkit';
3
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,22 @@
1
+ import * as Effect from 'effect/Effect';
2
+ import { type AiParser, type ConsolePrinter } from '@dxos/ai';
3
+ import { type Message } from '@dxos/types';
4
+ /**
5
+ * Live observer of the generation process.
6
+ */
7
+ export interface GenerationObserver extends AiParser.ParseResponseCallbacks {
8
+ /**
9
+ * Complete messages fired during the session, both from the model and from the user.
10
+ * This message will contain all message blocks emitted through the `onBlock` callback.
11
+ */
12
+ onMessage: (message: Message.Message) => Effect.Effect<void>;
13
+ }
14
+ export declare const GenerationObserver: Readonly<{
15
+ make: ({ onBegin, onPart, onBlock, onEnd, onMessage, }?: Partial<GenerationObserver>) => GenerationObserver;
16
+ noop: () => GenerationObserver;
17
+ /**
18
+ * Debug printer to be used in unit-tests and browser devtools.
19
+ */
20
+ fromPrinter: (printer: ConsolePrinter) => GenerationObserver;
21
+ }>;
22
+ //# sourceMappingURL=observer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../../src/session/observer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ,CAAC,sBAAsB;IACzE;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,kBAAkB;6DAO1B,OAAO,CAAC,kBAAkB,CAAC,KAAQ,kBAAkB;;IAUxD;;OAEG;2BACoB,cAAc;EAiBrC,CAAC"}
@@ -1,20 +1,28 @@
1
- import { AiLanguageModel, AiToolkit, type AiError, type AiResponse, type AiTool } from '@effect/ai';
2
- import { Context, Effect, type Schema } from 'effect';
3
- import { ToolExecutionService, ToolResolverService, type AgentStatus, type AiInputPreprocessingError, type AiToolNotFoundError } from '@dxos/ai';
4
- import { Event } from '@dxos/async';
1
+ import type * as AiError from '@effect/ai/AiError';
2
+ import * as LanguageModel from '@effect/ai/LanguageModel';
3
+ import type * as Tool from '@effect/ai/Tool';
4
+ import type * as Toolkit from '@effect/ai/Toolkit';
5
+ import * as Effect from 'effect/Effect';
6
+ import type * as Schema from 'effect/Schema';
7
+ import { type AiToolNotFoundError, type PromptPreprocessingError, type ToolExecutionService, type ToolResolverService } from '@dxos/ai';
5
8
  import { type Blueprint } from '@dxos/blueprints';
6
- import { ObjectVersion } from '@dxos/echo-db';
7
- import { type ObjectId } from '@dxos/echo-schema';
8
- import { DataType } from '@dxos/schema';
9
- import { AiAssistantError } from '../errors';
10
- export type AiSessionOptions = {};
11
- export type SessionRunOptions<Tools extends AiTool.Any> = {
9
+ import { Obj } from '@dxos/echo';
10
+ import { TracingService } from '@dxos/functions';
11
+ import { Message } from '@dxos/types';
12
+ import { type AiAssistantError } from '../errors';
13
+ import { GenerationObserver } from './observer';
14
+ export type AiSessionRunError = AiError.AiError | PromptPreprocessingError | AiToolNotFoundError | AiAssistantError;
15
+ export type AiSessionRunRequirements = LanguageModel.LanguageModel | ToolExecutionService | ToolResolverService | TracingService;
16
+ export type AiSessionRunParams<Tools extends Record<string, Tool.Any>> = {
12
17
  prompt: string;
13
- history: DataType.Message[];
14
- systemPrompt?: string;
15
- toolkit?: AiToolkit.AiToolkit<Tools>;
18
+ system?: string;
19
+ history?: Message.Message[];
20
+ objects?: Obj.Any[];
16
21
  blueprints?: Blueprint.Blueprint[];
22
+ toolkit?: Toolkit.WithHandler<Tools>;
23
+ observer?: GenerationObserver;
17
24
  };
25
+ export type AiSessionOptions = {};
18
26
  /**
19
27
  * Contains message history, tools, current context.
20
28
  * Current context means the state of the app, time of day, and other contextual information.
@@ -27,234 +35,17 @@ export type SessionRunOptions<Tools extends AiTool.Any> = {
27
35
  */
28
36
  export declare class AiSession {
29
37
  private readonly _options;
38
+ /** Prevents concurrent execution of session. */
30
39
  private readonly _semaphore;
31
- /** Pending messages (incl. the current user request). */
32
- private _pending;
33
- /** Current streaming response. */
34
- private _stream;
35
- /** Prior history from queue. */
40
+ /** Message history from queue. */
36
41
  private _history;
37
- /**
38
- * New message.
39
- */
40
- readonly message: Event<import("@dxos/schema").Message>;
41
- /**
42
- * Complete block added to Message.
43
- */
44
- readonly block: Event<{
45
- version: unknown;
46
- _tag: "anchor";
47
- pending?: boolean | undefined;
48
- objectId: string;
49
- } | {
50
- name?: string | undefined;
51
- _tag: "file";
52
- pending?: boolean | undefined;
53
- url: string;
54
- mediaType?: string | undefined;
55
- } | {
56
- id?: string | undefined;
57
- source?: {
58
- type: "base64";
59
- mediaType: string;
60
- data: string;
61
- } | {
62
- type: "http";
63
- url: string;
64
- } | undefined;
65
- _tag: "image";
66
- pending?: boolean | undefined;
67
- } | {
68
- _tag: "json";
69
- pending?: boolean | undefined;
70
- data: string;
71
- disposition?: string | undefined;
72
- } | {
73
- text: string;
74
- _tag: "proposal";
75
- pending?: boolean | undefined;
76
- } | {
77
- _tag: "reasoning";
78
- pending?: boolean | undefined;
79
- reasoningText?: string | undefined;
80
- redactedText?: string | undefined;
81
- signature?: string | undefined;
82
- } | {
83
- reference: import("@dxos/echo-schema").Ref<import("@dxos/echo/Type").Expando>;
84
- _tag: "reference";
85
- pending?: boolean | undefined;
86
- } | {
87
- _tag: "select";
88
- pending?: boolean | undefined;
89
- options: readonly string[];
90
- } | {
91
- _tag: "status";
92
- pending?: boolean | undefined;
93
- statusText: string;
94
- } | {
95
- text: string;
96
- _tag: "suggest";
97
- pending?: boolean | undefined;
98
- } | {
99
- text: string;
100
- _tag: "text";
101
- pending?: boolean | undefined;
102
- disposition?: string | undefined;
103
- mimeType?: string | undefined;
104
- } | {
105
- name: string;
106
- input: unknown;
107
- _tag: "toolCall";
108
- pending?: boolean | undefined;
109
- toolCallId: string;
110
- } | {
111
- _tag: "toolList";
112
- pending?: boolean | undefined;
113
- } | {
114
- name: string;
115
- _tag: "toolResult";
116
- pending?: boolean | undefined;
117
- toolCallId: string;
118
- result: unknown;
119
- } | {
120
- text: string;
121
- _tag: "transcript";
122
- pending?: boolean | undefined;
123
- started: string;
124
- }>;
125
- /**
126
- * Update partial block (while streaming).
127
- */
128
- readonly update: Event<{
129
- version: unknown;
130
- _tag: "anchor";
131
- pending?: boolean | undefined;
132
- objectId: string;
133
- } | {
134
- name?: string | undefined;
135
- _tag: "file";
136
- pending?: boolean | undefined;
137
- url: string;
138
- mediaType?: string | undefined;
139
- } | {
140
- id?: string | undefined;
141
- source?: {
142
- type: "base64";
143
- mediaType: string;
144
- data: string;
145
- } | {
146
- type: "http";
147
- url: string;
148
- } | undefined;
149
- _tag: "image";
150
- pending?: boolean | undefined;
151
- } | {
152
- _tag: "json";
153
- pending?: boolean | undefined;
154
- data: string;
155
- disposition?: string | undefined;
156
- } | {
157
- text: string;
158
- _tag: "proposal";
159
- pending?: boolean | undefined;
160
- } | {
161
- _tag: "reasoning";
162
- pending?: boolean | undefined;
163
- reasoningText?: string | undefined;
164
- redactedText?: string | undefined;
165
- signature?: string | undefined;
166
- } | {
167
- reference: import("@dxos/echo-schema").Ref<import("@dxos/echo/Type").Expando>;
168
- _tag: "reference";
169
- pending?: boolean | undefined;
170
- } | {
171
- _tag: "select";
172
- pending?: boolean | undefined;
173
- options: readonly string[];
174
- } | {
175
- _tag: "status";
176
- pending?: boolean | undefined;
177
- statusText: string;
178
- } | {
179
- text: string;
180
- _tag: "suggest";
181
- pending?: boolean | undefined;
182
- } | {
183
- text: string;
184
- _tag: "text";
185
- pending?: boolean | undefined;
186
- disposition?: string | undefined;
187
- mimeType?: string | undefined;
188
- } | {
189
- name: string;
190
- input: unknown;
191
- _tag: "toolCall";
192
- pending?: boolean | undefined;
193
- toolCallId: string;
194
- } | {
195
- _tag: "toolList";
196
- pending?: boolean | undefined;
197
- } | {
198
- name: string;
199
- _tag: "toolResult";
200
- pending?: boolean | undefined;
201
- toolCallId: string;
202
- result: unknown;
203
- } | {
204
- text: string;
205
- _tag: "transcript";
206
- pending?: boolean | undefined;
207
- started: string;
208
- }>;
209
- /**
210
- * Unparsed events from the underlying generation stream.
211
- */
212
- readonly streamEvent: Event<AiResponse.TextPart | AiResponse.ReasoningPart | AiResponse.RedactedReasoningPart | AiResponse.ToolCallPart | AiResponse.MetadataPart | AiResponse.FinishPart>;
213
- /**
214
- * User prompt or tool result.
215
- */
216
- readonly userMessage: Event<import("@dxos/schema").Message>;
217
- /**
218
- * Agent self-reporting its status.
219
- * Triggered by the model.
220
- */
221
- readonly statusReport: Event<AgentStatus>;
222
- /**
223
- * Emits when the session is done.
224
- */
225
- readonly done: Event<void>;
42
+ /** Pending messages for this session (incl. the current prompt). */
43
+ private _pending;
226
44
  constructor(_options?: AiSessionOptions);
45
+ run: <Tools extends Record<string, Tool.Any>>({ prompt, system: systemTemplate, history, objects, blueprints, toolkit, observer, }: AiSessionRunParams<Tools>) => Effect.Effect<Message.Message[], AiSessionRunError, AiSessionRunRequirements>;
227
46
  /**
228
- * Runs the AI model loop interacting with tools and artifacts.
229
- * @param options - The session options.
230
- * @returns The messages generated by the session, including the user's prompt.
47
+ * @deprecated
231
48
  */
232
- run: <Tools extends AiTool.Any>(options: SessionRunOptions<Tools>) => Effect.Effect<DataType.Message[], AiAssistantError | AiInputPreprocessingError | AiToolNotFoundError | AiError.AiError, AiLanguageModel.AiLanguageModel | ToolResolverService | ToolExecutionService | AiTool.ToHandler<Tools>>;
233
- runStructured<S extends Schema.Schema.AnyNoContext>(schema: S, options: SessionRunOptions<AiTool.Any>): Promise<Schema.Schema.Type<S>>;
234
- private _formatUserPrompt;
235
- abort(): void;
236
- }
237
- declare const ArtifactDiffResolver_base: Context.TagClass<ArtifactDiffResolver, "@dxos/assistant/ArtifactDiffResolver", ArtifactDiffResolver.Service>;
238
- /**
239
- * Resolves artifact ids to their versions.
240
- * Used to give the model a sense of the changes to the artifacts made by users during the conversation.
241
- * The artifacts versions are pinned in the history, and whenever the artifact changes in-between assistant's steps,
242
- * a diff is inserted into the conversation.
243
- *
244
- * Can be optionally provided to the session run call.
245
- */
246
- export declare class ArtifactDiffResolver extends ArtifactDiffResolver_base {
247
- }
248
- export declare namespace ArtifactDiffResolver {
249
- type Service = {
250
- resolve: (artifacts: {
251
- id: ObjectId;
252
- lastVersion: ObjectVersion;
253
- }[]) => Promise<Map<ObjectId, {
254
- version: ObjectVersion;
255
- diff?: string;
256
- }>>;
257
- };
49
+ runStructured<S extends Schema.Schema.AnyNoContext>(_schema: S, _options: AiSessionRunParams<any>): Promise<Schema.Schema.Type<S>>;
258
50
  }
259
- export {};
260
51
  //# sourceMappingURL=session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/session/session.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EAAS,OAAO,EAAE,MAAM,EAAwB,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGnF,OAAO,EAKL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EAEzB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAqB,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAElC,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,IAAI;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAiDR,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA/CrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAEtE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAA0B;IAE1C,kCAAkC;IAClC,OAAO,CAAC,OAAO,CAA+B;IAE9C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAA0B;IAE1C;;OAEG;IACH,SAAgB,OAAO,wCAAiC;IAExD;;OAEG;IACH,SAAgB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAiC;IAEtD;;OAEG;IACH,SAAgB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAiC;IAEvD;;OAEG;IACH,SAAgB,WAAW,uKAAgC;IAE3D;;OAEG;IACH,SAAgB,WAAW,wCAAiC;IAE5D;;;OAGG;IACH,SAAgB,YAAY,qBAA4B;IAExD;;OAEG;IACH,SAAgB,IAAI,cAAqB;gBAEZ,QAAQ,GAAE,gBAAqB;IAE5D;;;;OAIG;IAEH,GAAG,GAAI,KAAK,SAAS,MAAM,CAAC,GAAG,EAC7B,SAAS,iBAAiB,CAAC,KAAK,CAAC,KAChC,MAAM,CAAC,MAAM,CACd,QAAQ,CAAC,OAAO,EAAE,EAClB,gBAAgB,GAAG,yBAAyB,GAAG,mBAAmB,GAAG,OAAO,CAAC,OAAO,EACpF,eAAe,CAAC,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CACvG,CA4F2E;IAEtE,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,EACtD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAUjC,OAAO,CAAC,iBAAiB,CAwCpB;IAEL,KAAK,IAAI,IAAI;CAGd;;AA+BD;;;;;;;GAOG;AAEH,qBAAa,oBAAqB,SAAQ,yBAGvC;CAAG;AAEN,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,CAAC,SAAS,EAAE;YAAE,EAAE,EAAE,QAAQ,CAAC;YAAC,WAAW,EAAE,aAAa,CAAA;SAAE,EAAE,KAAK,OAAO,CAC7E,GAAG,CACD,QAAQ,EACR;YACE,OAAO,EAAE,aAAa,CAAC;YACvB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CACF,CACF,CAAC;KACH,CAAC;CACH"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/session/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAG7C,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAGzB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,wBAAwB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAEpH,MAAM,MAAM,wBAAwB,GAChC,aAAa,CAAC,aAAa,GAC3B,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;IACvE,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAElC;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAWR,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAVrC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAEtE,kCAAkC;IAElC,OAAO,CAAC,QAAQ,CAAyB;IAEzC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAyB;gBAEZ,QAAQ,GAAE,gBAAqB;IAE5D,GAAG,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,sFAQ5C,kBAAkB,CAAC,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,wBAAwB,CAAC,CA+FhC;IAE5E;;OAEG;IAEG,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,EACtD,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CASlC"}
@@ -0,0 +1,15 @@
1
+ import type * as Tool from '@effect/ai/Tool';
2
+ import * as Toolkit from '@effect/ai/Toolkit';
3
+ import * as Effect from 'effect/Effect';
4
+ import { type AiToolNotFoundError, ToolExecutionService, type ToolId, ToolResolverService } from '@dxos/ai';
5
+ import { type Blueprint } from '@dxos/blueprints';
6
+ export type ToolkitParams<Tools extends Record<string, Tool.Any>> = {
7
+ toolkit?: Toolkit.Toolkit<Tools>;
8
+ toolIds?: ToolId[];
9
+ blueprints?: Blueprint.Blueprint[];
10
+ };
11
+ /**
12
+ * Build a combined toolkit from the blueprint tools and the provided toolkit.
13
+ */
14
+ export declare const createToolkit: <Tools extends Record<string, Tool.Any> = {}>({ toolkit: toolkitParam, toolIds, blueprints, }: ToolkitParams<Tools>) => Effect.Effect<Toolkit.WithHandler<any>, AiToolNotFoundError, ToolResolverService | ToolExecutionService | Tool.HandlersFor<Tools>>;
15
+ //# sourceMappingURL=toolkit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../../../../src/session/toolkit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,MAAM,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,iDAIxE,aAAa,CAAC,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,CACrC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EACxB,mBAAmB,EACnB,mBAAmB,GAAG,oBAAoB,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAkBlE,CAAC"}
@@ -1,7 +1,7 @@
1
- import { Schema } from 'effect';
1
+ import * as Schema from 'effect/Schema';
2
+ import { type AnyEchoObject } from '@dxos/echo/internal';
2
3
  import { type ObjectVersion } from '@dxos/echo-db';
3
- import { type BaseEchoObject } from '@dxos/echo-schema';
4
- import { type ContentBlock } from '@dxos/schema';
4
+ import { type ContentBlock } from '@dxos/types';
5
5
  declare const VersionPinSchema: Schema.Struct<{
6
6
  objectId: import("@dxos/keys").ObjectIdClass;
7
7
  version: Schema.Schema<ObjectVersion, ObjectVersion, never>;
@@ -14,7 +14,7 @@ export interface VersionPin extends Schema.Schema.Type<typeof VersionPinSchema>
14
14
  }
15
15
  export declare const VersionPin: typeof VersionPinSchema & {
16
16
  DISPOSITION: 'version-pin';
17
- fromObject: (object: BaseEchoObject) => VersionPin;
17
+ fromObject: (object: AnyEchoObject) => VersionPin;
18
18
  createBlock: (pin: VersionPin) => ContentBlock.Any;
19
19
  };
20
20
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"version-pin.d.ts","sourceRoot":"","sources":["../../../../src/session/version-pin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,QAAA,MAAM,gBAAgB;;;EAKpB,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAElF,eAAO,MAAM,UAAU,EAAE,OAAO,gBAAgB,GAAG;IACjD,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,UAAU,CAAC;IACnD,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,CAAC,GAAG,CAAC;CAiBpD,CAAC"}
1
+ {"version":3,"file":"version-pin.d.ts","sourceRoot":"","sources":["../../../../src/session/version-pin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,QAAA,MAAM,gBAAgB;;;EAKpB,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAElF,eAAO,MAAM,UAAU,EAAE,OAAO,gBAAgB,GAAG;IACjD,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,UAAU,CAAC;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,CAAC,GAAG,CAAC;CAiBpD,CAAC"}
@@ -1,2 +1,2 @@
1
- export * from './prompt';
1
+ export * from './system';
2
2
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { type ModelCapabilities } from '@dxos/ai';
2
+ import { Template } from '@dxos/blueprints';
3
+ /**
4
+ * System template variables.
5
+ */
6
+ export type SystemPromptOptions = ModelCapabilities & {
7
+ DATETIME: string;
8
+ };
9
+ /**
10
+ * Base system prompt.
11
+ * NOTE: This contains protocol instructions that can not be dynamically edited.
12
+ */
13
+ export declare const createSystemPrompt: (options?: Partial<SystemPromptOptions>) => string;
14
+ export declare const templates: {
15
+ /** Editable system prompt.*/
16
+ system: Template.Template;
17
+ };
18
+ //# sourceMappingURL=system.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/templates/system.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAS,OAAO,CAAC,mBAAmB,CAAM,WAM1E,CAAC;AAEJ,eAAO,MAAM,SAAS;IACpB,6BAA6B;;CAQ9B,CAAC"}