@dxos/compute 0.8.4-main.ae835ea → 0.8.4-main.bc2380dfbc

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 (174) hide show
  1. package/LICENSE +102 -5
  2. package/README.md +36 -1
  3. package/dist/lib/neutral/StorageService.mjs +22 -0
  4. package/dist/lib/neutral/chunk-AKVCVI6N.mjs +25 -0
  5. package/dist/lib/neutral/chunk-AKVCVI6N.mjs.map +7 -0
  6. package/dist/lib/neutral/chunk-J5LGTIGS.mjs +10 -0
  7. package/dist/lib/neutral/chunk-JTZYM2QW.mjs +144 -0
  8. package/dist/lib/neutral/chunk-JTZYM2QW.mjs.map +7 -0
  9. package/dist/lib/neutral/chunk-LRCABAWU.mjs +17 -0
  10. package/dist/lib/neutral/chunk-LRCABAWU.mjs.map +7 -0
  11. package/dist/lib/neutral/chunk-RCLYF66G.mjs +21 -0
  12. package/dist/lib/neutral/chunk-RCLYF66G.mjs.map +7 -0
  13. package/dist/lib/neutral/chunk-SEBWOTOU.mjs +235 -0
  14. package/dist/lib/neutral/chunk-SEBWOTOU.mjs.map +7 -0
  15. package/dist/lib/neutral/chunk-VSICPGGY.mjs +53 -0
  16. package/dist/lib/neutral/chunk-VSICPGGY.mjs.map +7 -0
  17. package/dist/lib/neutral/chunk-XEVFBI6S.mjs +62 -0
  18. package/dist/lib/neutral/chunk-XEVFBI6S.mjs.map +7 -0
  19. package/dist/lib/neutral/fib-ZSJYREBW.mjs +10 -0
  20. package/dist/lib/neutral/fib-ZSJYREBW.mjs.map +7 -0
  21. package/dist/lib/neutral/index.mjs +1146 -0
  22. package/dist/lib/neutral/index.mjs.map +7 -0
  23. package/dist/lib/neutral/meta.json +1 -0
  24. package/dist/lib/neutral/reply-YH3BVOUT.mjs +10 -0
  25. package/dist/lib/neutral/reply-YH3BVOUT.mjs.map +7 -0
  26. package/dist/lib/neutral/sleep-TSPIQ5EY.mjs +10 -0
  27. package/dist/lib/neutral/sleep-TSPIQ5EY.mjs.map +7 -0
  28. package/dist/lib/neutral/testing/index.mjs +32 -0
  29. package/dist/lib/neutral/testing/index.mjs.map +7 -0
  30. package/dist/types/src/Blueprint.d.ts +192 -0
  31. package/dist/types/src/Blueprint.d.ts.map +1 -0
  32. package/dist/types/src/Credential.d.ts +27 -0
  33. package/dist/types/src/Credential.d.ts.map +1 -0
  34. package/dist/types/src/McpServer.d.ts +27 -0
  35. package/dist/types/src/McpServer.d.ts.map +1 -0
  36. package/dist/types/src/Operation.d.ts +340 -0
  37. package/dist/types/src/Operation.d.ts.map +1 -0
  38. package/dist/types/src/OperationHandlerSet.d.ts +60 -0
  39. package/dist/types/src/OperationHandlerSet.d.ts.map +1 -0
  40. package/dist/types/src/OperationRegistry.d.ts +23 -0
  41. package/dist/types/src/OperationRegistry.d.ts.map +1 -0
  42. package/dist/types/src/Process.d.ts +247 -0
  43. package/dist/types/src/Process.d.ts.map +1 -0
  44. package/dist/types/src/Routine.d.ts +63 -0
  45. package/dist/types/src/Routine.d.ts.map +1 -0
  46. package/dist/types/src/Script.d.ts +22 -0
  47. package/dist/types/src/Script.d.ts.map +1 -0
  48. package/dist/types/src/ServiceResolver.d.ts +74 -0
  49. package/dist/types/src/ServiceResolver.d.ts.map +1 -0
  50. package/dist/types/src/StorageService.d.ts +58 -0
  51. package/dist/types/src/StorageService.d.ts.map +1 -0
  52. package/dist/types/src/Template.d.ts +62 -0
  53. package/dist/types/src/Template.d.ts.map +1 -0
  54. package/dist/types/src/Template.test.d.ts +2 -0
  55. package/dist/types/src/Template.test.d.ts.map +1 -0
  56. package/dist/types/src/Trace.d.ts +216 -0
  57. package/dist/types/src/Trace.d.ts.map +1 -0
  58. package/dist/types/src/Trigger.d.ts +150 -0
  59. package/dist/types/src/Trigger.d.ts.map +1 -0
  60. package/dist/types/src/TriggerEvent.d.ts +75 -0
  61. package/dist/types/src/TriggerEvent.d.ts.map +1 -0
  62. package/dist/types/src/errors.d.ts +308 -0
  63. package/dist/types/src/errors.d.ts.map +1 -0
  64. package/dist/types/src/index.d.ts +16 -5
  65. package/dist/types/src/index.d.ts.map +1 -1
  66. package/dist/types/src/testing/definitions.d.ts +11 -0
  67. package/dist/types/src/testing/definitions.d.ts.map +1 -0
  68. package/dist/types/src/testing/fib.d.ts +8 -0
  69. package/dist/types/src/testing/fib.d.ts.map +1 -0
  70. package/dist/types/src/testing/index.d.ts +6 -4
  71. package/dist/types/src/testing/index.d.ts.map +1 -1
  72. package/dist/types/src/testing/reply.d.ts +4 -0
  73. package/dist/types/src/testing/reply.d.ts.map +1 -0
  74. package/dist/types/src/testing/sleep.d.ts +6 -0
  75. package/dist/types/src/testing/sleep.d.ts.map +1 -0
  76. package/dist/types/src/umbrella.test.d.ts +2 -0
  77. package/dist/types/src/umbrella.test.d.ts.map +1 -0
  78. package/dist/types/tsconfig.tsbuildinfo +1 -1
  79. package/package.json +28 -40
  80. package/src/Blueprint.ts +303 -0
  81. package/src/Credential.ts +53 -0
  82. package/src/McpServer.ts +44 -0
  83. package/src/Operation.ts +593 -0
  84. package/src/OperationHandlerSet.ts +134 -0
  85. package/src/OperationRegistry.ts +50 -0
  86. package/src/Process.ts +490 -0
  87. package/src/Routine.ts +75 -0
  88. package/src/Script.ts +40 -0
  89. package/src/ServiceResolver.ts +174 -0
  90. package/src/StorageService.ts +101 -0
  91. package/src/Template.test.ts +151 -0
  92. package/src/Template.ts +122 -0
  93. package/src/Trace.ts +283 -0
  94. package/src/Trigger.ts +209 -0
  95. package/src/TriggerEvent.ts +64 -0
  96. package/src/errors.ts +71 -0
  97. package/src/index.ts +18 -6
  98. package/src/testing/definitions.ts +49 -0
  99. package/src/testing/fib.ts +22 -0
  100. package/src/testing/index.ts +13 -5
  101. package/src/testing/reply.ts +18 -0
  102. package/src/testing/sleep.ts +16 -0
  103. package/src/umbrella.test.ts +51 -0
  104. package/dist/lib/browser/chunk-CY35BVJC.mjs +0 -3113
  105. package/dist/lib/browser/chunk-CY35BVJC.mjs.map +0 -7
  106. package/dist/lib/browser/index.mjs +0 -55
  107. package/dist/lib/browser/meta.json +0 -1
  108. package/dist/lib/browser/testing/index.mjs +0 -196
  109. package/dist/lib/browser/testing/index.mjs.map +0 -7
  110. package/dist/lib/node-esm/chunk-BECNONV7.mjs +0 -3115
  111. package/dist/lib/node-esm/chunk-BECNONV7.mjs.map +0 -7
  112. package/dist/lib/node-esm/index.mjs +0 -56
  113. package/dist/lib/node-esm/meta.json +0 -1
  114. package/dist/lib/node-esm/testing/index.mjs +0 -197
  115. package/dist/lib/node-esm/testing/index.mjs.map +0 -7
  116. package/dist/types/src/compute-graph-registry.d.ts +0 -37
  117. package/dist/types/src/compute-graph-registry.d.ts.map +0 -1
  118. package/dist/types/src/compute-graph-registry.test.d.ts +0 -2
  119. package/dist/types/src/compute-graph-registry.test.d.ts.map +0 -1
  120. package/dist/types/src/compute-graph.d.ts +0 -67
  121. package/dist/types/src/compute-graph.d.ts.map +0 -1
  122. package/dist/types/src/compute-graph.test.d.ts +0 -2
  123. package/dist/types/src/compute-graph.test.d.ts.map +0 -1
  124. package/dist/types/src/compute-node.d.ts +0 -24
  125. package/dist/types/src/compute-node.d.ts.map +0 -1
  126. package/dist/types/src/functions/async-function.d.ts +0 -68
  127. package/dist/types/src/functions/async-function.d.ts.map +0 -1
  128. package/dist/types/src/functions/edge-function.d.ts +0 -20
  129. package/dist/types/src/functions/edge-function.d.ts.map +0 -1
  130. package/dist/types/src/functions/function-defs.d.ts +0 -11
  131. package/dist/types/src/functions/function-defs.d.ts.map +0 -1
  132. package/dist/types/src/functions/index.d.ts +0 -4
  133. package/dist/types/src/functions/index.d.ts.map +0 -1
  134. package/dist/types/src/hyperformula.test.d.ts +0 -2
  135. package/dist/types/src/hyperformula.test.d.ts.map +0 -1
  136. package/dist/types/src/testing/test-builder.d.ts +0 -15
  137. package/dist/types/src/testing/test-builder.d.ts.map +0 -1
  138. package/dist/types/src/testing/test-plugin.d.ts +0 -35
  139. package/dist/types/src/testing/test-plugin.d.ts.map +0 -1
  140. package/dist/types/src/testing/test-runtime.d.ts +0 -10
  141. package/dist/types/src/testing/test-runtime.d.ts.map +0 -1
  142. package/dist/types/src/testing/util.d.ts +0 -2
  143. package/dist/types/src/testing/util.d.ts.map +0 -1
  144. package/dist/types/src/types/hyperformula.d.ts +0 -8
  145. package/dist/types/src/types/hyperformula.d.ts.map +0 -1
  146. package/dist/types/src/types/index.d.ts +0 -3
  147. package/dist/types/src/types/index.d.ts.map +0 -1
  148. package/dist/types/src/types/types.d.ts +0 -20
  149. package/dist/types/src/types/types.d.ts.map +0 -1
  150. package/dist/types/src/types/types.test.d.ts +0 -2
  151. package/dist/types/src/types/types.test.d.ts.map +0 -1
  152. package/dist/types/src/util.d.ts +0 -2
  153. package/dist/types/src/util.d.ts.map +0 -1
  154. package/src/compute-graph-registry.test.ts +0 -138
  155. package/src/compute-graph-registry.ts +0 -97
  156. package/src/compute-graph.test.ts +0 -87
  157. package/src/compute-graph.ts +0 -266
  158. package/src/compute-node.ts +0 -59
  159. package/src/functions/async-function.ts +0 -184
  160. package/src/functions/edge-function.ts +0 -114
  161. package/src/functions/function-defs.ts +0 -2427
  162. package/src/functions/index.ts +0 -7
  163. package/src/hyperformula.test.ts +0 -14
  164. package/src/testing/test-builder.ts +0 -60
  165. package/src/testing/test-plugin.ts +0 -98
  166. package/src/testing/test-runtime.ts +0 -38
  167. package/src/testing/util.ts +0 -9
  168. package/src/types/hyperformula.ts +0 -19
  169. package/src/types/index.ts +0 -6
  170. package/src/types/types.test.ts +0 -91
  171. package/src/types/types.ts +0 -80
  172. package/src/util.ts +0 -8
  173. /package/dist/lib/{browser/index.mjs.map → neutral/StorageService.mjs.map} +0 -0
  174. /package/dist/lib/{node-esm/index.mjs.map → neutral/chunk-J5LGTIGS.mjs.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Credential.d.ts","sourceRoot":"","sources":["../../../src/Credential.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;;IAKE;;OAEG;sBACe,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAE1E;;;OAGG;mBACY,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC;;AAZzE,qBAAa,kBAAmB,SAAQ,uBAcrC;IACD,MAAM,CAAC,aAAa,UAAW,eAAe,KAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAIvG;IAEL,MAAM,CAAC,SAAS,UAAW,eAAe,KAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAO3G;CACN"}
@@ -0,0 +1,27 @@
1
+ import * as Schema from 'effect/Schema';
2
+ /**
3
+ * MCP server connection spec — the minimal fields needed to dial an MCP server.
4
+ *
5
+ * Used as a value type embedded in blueprints and passed to runtime session connect logic.
6
+ * The user-facing ECHO object (`@dxos/assistant-toolkit` `McpServer`) composes this struct
7
+ * and adds instance-level fields (`name`, `enabled`) and ECHO annotations.
8
+ */
9
+ export declare const McpServer: Schema.Struct<{
10
+ name: Schema.optional<typeof Schema.String>;
11
+ url: Schema.SchemaClass<string, string, never>;
12
+ /**
13
+ * Transport protocol. Prefer `'http'` (Streamable HTTP) for new servers; `'sse'` is
14
+ * kept for compatibility with servers that haven't migrated and is deprecated per
15
+ * the MCP SDK. Clients support both during the migration period.
16
+ */
17
+ protocol: Schema.Union<[Schema.Literal<["http"]>, Schema.Literal<["sse"]>]>;
18
+ /**
19
+ * Optional API key sent with requests.
20
+ * Persisted in plaintext when stored on a space-replicated ECHO object — see the
21
+ * `@dxos/assistant-toolkit` `McpServer` type for security implications.
22
+ */
23
+ apiKey: Schema.optional<typeof Schema.String>;
24
+ }>;
25
+ export interface McpServer extends Schema.Schema.Type<typeof McpServer> {
26
+ }
27
+ //# sourceMappingURL=McpServer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../../src/McpServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;IASpB;;;;OAIG;;IAKH;;;;OAIG;;EAIH,CAAC;AAEH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG"}
@@ -0,0 +1,340 @@
1
+ import * as Context from 'effect/Context';
2
+ import * as Effect from 'effect/Effect';
3
+ import * as Layer from 'effect/Layer';
4
+ import * as Pipeable from 'effect/Pipeable';
5
+ import * as Schema$ from 'effect/Schema';
6
+ import type * as Types from 'effect/Types';
7
+ import { Migration, Obj, Type, type DXN, type Key } from '@dxos/echo';
8
+ import type { NoHandlerError } from './errors';
9
+ import type { Operation } from './index';
10
+ /**
11
+ * Schema type that accepts any Encoded form but requires no Context.
12
+ * This allows ECHO object schemas where Type !== Encoded due to [KindId] symbol.
13
+ */
14
+ type Schema<T> = Schema$.Schema<T, any, never>;
15
+ export declare const DefinitionTypeId: '~@dxos/operation/OperationDefinition';
16
+ export type DefinitionTypeId = typeof DefinitionTypeId;
17
+ /**
18
+ * Serializable definition of an Operation.
19
+ * Contains schema and metadata, but no runtime logic.
20
+ */
21
+ export interface Definition<I, O, S = any> extends Pipeable.Pipeable, Definition.Variance<I, O, S> {
22
+ /**
23
+ * Input schema for the operation.
24
+ */
25
+ readonly input: Schema<I>;
26
+ /**
27
+ * Output schema for the operation.
28
+ */
29
+ readonly output: Schema<O>;
30
+ readonly meta: {
31
+ readonly key: string;
32
+ readonly name?: string;
33
+ readonly version?: string;
34
+ readonly description?: string;
35
+ /**
36
+ * Deployment ID for remote invocation.
37
+ * Assigned by the EDGE function service when deployed.
38
+ */
39
+ readonly deployedId?: string;
40
+ };
41
+ /**
42
+ * Execution mode for the operation.
43
+ * - 'sync': Operation completes synchronously (fast, UI-blocking acceptable).
44
+ * - 'async': Operation may take time (should not block UI).
45
+ */
46
+ readonly executionMode: 'sync' | 'async';
47
+ /**
48
+ * ECHO types the operation uses.
49
+ * Ensures types are available when the operation is executed remotely.
50
+ */
51
+ readonly types: readonly Type.AnyEntity[];
52
+ /**
53
+ * Effect services required by this operation.
54
+ * These services will be automatically provided to the handler at invocation time.
55
+ */
56
+ readonly services: readonly Context.Tag<any, any>[];
57
+ }
58
+ /**
59
+ * Namespace for OperationDefinition helper types.
60
+ */
61
+ export declare namespace Definition {
62
+ interface Variance<I, O, S> {
63
+ [DefinitionTypeId]: {
64
+ readonly _Input: Types.Contravariant<I>;
65
+ readonly _Output: Types.Covariant<O>;
66
+ readonly _Services: Types.Covariant<S>;
67
+ };
68
+ }
69
+ /**
70
+ * Any operation definition, regardless of input/output types.
71
+ */
72
+ type Any = Definition<any, any, any>;
73
+ /**
74
+ * Extract the input type from an operation definition.
75
+ */
76
+ type Input<T extends Any> = T extends Variance<infer I, infer _O, infer _S> ? I : never;
77
+ /**
78
+ * Extract the output type from an operation definition.
79
+ */
80
+ type Output<T extends Any> = T extends Variance<infer _I, infer O, infer _S> ? O : never;
81
+ /**
82
+ * Extract the service identifier types from an operation's services array.
83
+ * Returns `never` if the operation has no services declared.
84
+ */
85
+ type Services<T extends Any> = T extends Variance<infer _I, infer _O, infer S> ? S : never;
86
+ type HandlerType<T extends Any> = T extends Variance<infer I, infer O, infer S> ? Handler<I, O, any, S> : never;
87
+ }
88
+ /**
89
+ * Runtime handler for an Operation.
90
+ */
91
+ export type Handler<I, O, E = Error, R = never> = (input: I) => Effect.Effect<O, E, R>;
92
+ export type WithHandler<T extends Definition.Any> = T & {
93
+ handler: Definition.HandlerType<T>;
94
+ };
95
+ /**
96
+ * Checks if a value is an operation definition.
97
+ */
98
+ export declare const isOperationDefinition: (value: unknown) => value is Definition.Any;
99
+ /**
100
+ * Checks if a value is an operation with a handler.
101
+ */
102
+ export declare const isOperationWithHandler: (value: unknown) => value is WithHandler<Definition.Any>;
103
+ /**a
104
+ * Props for creating an Operation definition.
105
+ * Derived from OperationDefinition with executionMode made optional (defaults to 'async').
106
+ */
107
+ export type Props<I, O> = Omit<Definition<I, O>, DefinitionTypeId | 'pipe' | 'executionMode' | 'types' | 'services'> & {
108
+ readonly executionMode?: 'sync' | 'async';
109
+ readonly types?: Definition<I, O>['types'];
110
+ readonly services?: Definition<I, O>['services'];
111
+ };
112
+ /**
113
+ * Creates a new Operation definition.
114
+ * Applies default executionMode of 'async' if not specified.
115
+ * The returned type preserves the literal types of props (including services).
116
+ */
117
+ export declare const make: <const P extends Types.NoExcessProperties<Props<any, any>, P>>(props: P) => Definition<Schema$.Schema.Type<P['input']>, Schema$.Schema.Type<P['output']>, Context.Tag.Identifier<NonNullable<P['services']>[number]>>;
118
+ /**
119
+ * Marks an operation as intrinsic — provided directly by the DXOS platform runtime rather than
120
+ * deployed as a user function. The `intrinsic:<key>` deployedId routes invocations to the
121
+ * built-in implementation registered with the runtime.
122
+ */
123
+ export declare const intrinsic: <const O extends Operation.Definition.Any>(op: O) => O;
124
+ /**
125
+ * Attaches a handler to an Operation definition.
126
+ * The handler may use any services declared in the operation, plus Operation.Service (always available).
127
+ * Dual API: can be called directly or used in a pipe.
128
+ *
129
+ * @example
130
+ * ```ts
131
+ * const MyOp = Operation.make({
132
+ * input: Schema.Void,
133
+ * output: Schema.Void,
134
+ * meta: { key: 'my-op' },
135
+ * services: [DatabaseService],
136
+ * });
137
+ *
138
+ * // Direct call - handler can use DatabaseService
139
+ * const op = Operation.withHandler(MyOp, (input) =>
140
+ * Effect.gen(function* () {
141
+ * const db = yield* DatabaseService;
142
+ * return {};
143
+ * }),
144
+ * );
145
+ *
146
+ * // Piped call
147
+ * const op = MyOp.pipe(Operation.withHandler((input) => Effect.succeed({})));
148
+ * ```
149
+ */
150
+ export declare const withHandler: {
151
+ <Def extends Definition<any, any>, E = never>(handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>): (op: Def) => WithHandler<Def>;
152
+ <Def extends Definition<any, any>, E = never>(op: Def, handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>): WithHandler<Def>;
153
+ };
154
+ /**
155
+ * Helper to make the handler type opaque.
156
+ * Workaround for TypeScript's inability to infer the handler type from the operation definition:
157
+ * ```
158
+ * error TS2742: The inferred type of 'default' cannot be named without a reference.
159
+ * ```
160
+ *
161
+ * Most of the time the exact handler type is not needed.
162
+ *
163
+ * @example
164
+ * ```ts
165
+ * const MyOp = Operation.make({
166
+ * input: Schema.Void,
167
+ * output: Schema.Void,
168
+ * meta: { key: 'my-op' },
169
+ * services: [DatabaseService],
170
+ * });
171
+ *
172
+ * export default MyOp.pipe(
173
+ * Operation.withHandler(
174
+ * Effect.fn(function* (input) {
175
+ * return { result: 'ok' };
176
+ * }),
177
+ * ),
178
+ * Operation.opaqueHandler,
179
+ * );
180
+ * ```
181
+ */
182
+ export declare const opaqueHandler: <T extends Operation.Definition.Any>(handler: Operation.WithHandler<T>) => Operation.WithHandler<Operation.Definition.Any>;
183
+ /**
184
+ * Local invocation of an operation.
185
+ */
186
+ export type Invoke = <I, O, E>(op: Definition<I, O>, input: I) => Effect.Effect<O, E>;
187
+ /**
188
+ * Remote invocation of an operation.
189
+ */
190
+ export type InvokeRemote = <I, O, E>(op: Definition<I, O>, input: I, options?: {
191
+ timeout?: number;
192
+ }) => Effect.Effect<O, E>;
193
+ /**
194
+ * Database record of an operation.
195
+ * The registry `key` and `version` live in the object meta — access via
196
+ * `Obj.getMeta(record).key` and `Obj.getMeta(record).version`.
197
+ */
198
+ export declare const PersistentOperation: Type.Obj<{
199
+ readonly name: string;
200
+ readonly description?: string | undefined;
201
+ readonly updated?: string | undefined;
202
+ readonly source?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
203
+ readonly inputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
204
+ readonly outputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
205
+ readonly services?: readonly string[] | undefined;
206
+ readonly binding?: string | undefined;
207
+ }, Schema$.Struct.Fields>;
208
+ export interface PersistentOperation extends Schema$.Schema.Type<typeof PersistentOperation> {
209
+ }
210
+ /**
211
+ * Get the registry key for a persistent operation record (from the object meta).
212
+ */
213
+ export declare const getKey: (record: PersistentOperation) => string | undefined;
214
+ /**
215
+ * Get the registry version for a persistent operation record (from the object meta).
216
+ */
217
+ export declare const getVersion: (record: PersistentOperation) => string | undefined;
218
+ /**
219
+ * Serialize an operation definition to a persistent operation record.
220
+ */
221
+ export declare const serialize: (operation: Definition.Any) => PersistentOperation;
222
+ /**
223
+ * Deserialize a persistent operation record to an operation definition.
224
+ */
225
+ export declare const deserialize: (record: PersistentOperation) => Definition.Any;
226
+ /**
227
+ * Update properties on the target operation record from the source operation record.
228
+ */
229
+ export declare const setFrom: (target: PersistentOperation, source: PersistentOperation) => void;
230
+ /**
231
+ * Options for operation invocation.
232
+ */
233
+ export interface InvokeOptions {
234
+ /**
235
+ * Space ID to provide database context for the handler.
236
+ */
237
+ spaceId?: Key.SpaceId;
238
+ /**
239
+ * DXN string of the conversation feed (queue).
240
+ * Passed to the process environment so nested operations can resolve AiContext.Service and related services.
241
+ */
242
+ conversation?: DXN.String;
243
+ /**
244
+ * Optional process-runtime tracing metadata (consumed by `@dxos/functions-runtime` when wired).
245
+ */
246
+ tracing?: unknown;
247
+ }
248
+ /**
249
+ * Operation service interface - provides unified access to operation invocation and scheduling.
250
+ * This service is automatically provided to operation handlers.
251
+ */
252
+ export interface OperationService {
253
+ /**
254
+ * Invoke an operation as an Effect.
255
+ * Returns an Effect that resolves to the operation output.
256
+ */
257
+ invoke: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<O, NoHandlerError>;
258
+ /**
259
+ * Schedule an operation to run as a followup.
260
+ * The followup is tracked and won't be cancelled when the parent operation completes.
261
+ * Returns an Effect that completes immediately after scheduling.
262
+ */
263
+ schedule: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]) => Effect.Effect<void>;
264
+ /**
265
+ * Invoke an operation and return a Promise.
266
+ * Useful for async contexts where Effect is not available.
267
+ */
268
+ invokePromise: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Promise<{
269
+ data?: O;
270
+ error?: Error;
271
+ }>;
272
+ }
273
+ declare const Service_base: Context.TagClass<Service, "@dxos/operation/Service", OperationService>;
274
+ /**
275
+ * Context tag for the Operation service.
276
+ * Operation handlers can yield this to invoke other operations or schedule followups.
277
+ *
278
+ * @example
279
+ * ```ts
280
+ * const handler = (input) => Effect.gen(function* () {
281
+ * // Schedule a followup (fire and forget)
282
+ * yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });
283
+ *
284
+ * // Invoke another operation
285
+ * return yield* Operation.invoke(OtherOperation, { data: input.data });
286
+ * });
287
+ * ```
288
+ */
289
+ export declare class Service extends Service_base {
290
+ }
291
+ /**
292
+ * Invoke an operation as an Effect.
293
+ * Yields the Operation.Service internally.
294
+ *
295
+ * @example
296
+ * ```ts
297
+ * yield* Operation.invoke(MyOperation, { data: 'test' });
298
+ * ```
299
+ */
300
+ export declare const invoke: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<O, NoHandlerError, Service>;
301
+ /**
302
+ * Schedule an operation to run as a followup.
303
+ * Yields the Operation.Service internally.
304
+ *
305
+ * @example
306
+ * ```ts
307
+ * yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });
308
+ * yield* Operation.schedule(VoidOperation); // input optional when void
309
+ * ```
310
+ */
311
+ export declare const schedule: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]) => Effect.Effect<void, never, Service>;
312
+ /**
313
+ * Provides additional invocation options to all invocations.
314
+ */
315
+ export declare const withInvocationOptions: (options: InvokeOptions) => Layer.Layer<Service, never, Service>;
316
+ /**
317
+ * Persistent operation schema v0.1.0 — `key` and `version` are stored as data properties.
318
+ * @deprecated Use {@link PersistentOperation} (v0.2.0) instead; the `key` and `version` now live in the object meta.
319
+ */
320
+ export declare const PersistentOperation_v0_1_0: Type.Obj<{
321
+ readonly key?: string | undefined;
322
+ readonly name: string;
323
+ readonly version: string;
324
+ readonly description?: string | undefined;
325
+ readonly updated?: string | undefined;
326
+ readonly source?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
327
+ readonly inputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
328
+ readonly outputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
329
+ readonly services?: readonly string[] | undefined;
330
+ readonly binding?: string | undefined;
331
+ }, Schema$.Struct.Fields>;
332
+ export interface PersistentOperation_v0_1_0 extends Schema$.Schema.Type<typeof PersistentOperation_v0_1_0> {
333
+ }
334
+ /**
335
+ * Schema migrations exported by this module.
336
+ * Exported as an array for extensibility — append future versions here.
337
+ */
338
+ export declare const migrations: Migration.ObjectMigration[];
339
+ export {};
340
+ //# sourceMappingURL=Operation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/Operation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import * as Context from 'effect/Context';
2
+ import * as Effect from 'effect/Effect';
3
+ import * as Layer from 'effect/Layer';
4
+ import { NoHandlerError } from './errors';
5
+ import type * as Operation from './Operation';
6
+ export declare const TypeId: '~@dxos/operation/OperationHandlerSet';
7
+ export type TypeId = typeof TypeId;
8
+ export interface OperationHandlerSet {
9
+ [TypeId]: TypeId;
10
+ readonly handlers: Effect.Effect<Operation.WithHandler<Operation.Definition.Any>[]>;
11
+ getHandlers(): Promise<Operation.WithHandler<Operation.Definition.Any>[]>;
12
+ }
13
+ export declare const isOperationHandlerSet: (value: unknown) => value is OperationHandlerSet;
14
+ export declare const empty: OperationHandlerSet;
15
+ /**
16
+ * Creates a new operation handler set from a list of handlers.
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * const set = OperationHandlerSet.make(
21
+ * Operation.withHandler(Operation.make({ input: Schema.Void, output: Schema.Void }), (input) => Effect.succeed({})),
22
+ * Operation.withHandler(Operation.make({ input: Schema.Void, output: Schema.Void }), (input) => Effect.succeed({})),
23
+ * );
24
+ * ```
25
+ */
26
+ export declare const make: (...handlers: Operation.WithHandler<Operation.Definition.Any>[]) => OperationHandlerSet;
27
+ export declare const async: (getHandlers: () => Promise<Operation.WithHandler<Operation.Definition.Any>[]>) => OperationHandlerSet;
28
+ /**
29
+ * Merges multiple operation handler sets into a single set.
30
+ *
31
+ */
32
+ export declare const merge: (...sets: OperationHandlerSet[]) => OperationHandlerSet;
33
+ /**
34
+ * Creates a new operation handler set from a list of lazy-loaded modules.
35
+ *
36
+ * @example
37
+ * ```ts
38
+ * const set = OperationHandlerSet.lazy(
39
+ * () => import('./my-handler'),
40
+ * () => import('./my-other-handler'),
41
+ * );
42
+ * ```
43
+ */
44
+ export declare const lazy: (...modules: (() => Promise<{
45
+ default: Operation.WithHandler<Operation.Definition.Any>;
46
+ }>)[]) => OperationHandlerSet;
47
+ /**
48
+ * Gets a handler for an operation by definition.
49
+ */
50
+ export declare const getHandler: <const Op extends Operation.Definition.Any>(set: OperationHandlerSet, definition: Op) => Effect.Effect<Operation.WithHandler<Op>, NoHandlerError>;
51
+ /**
52
+ * Gets a handler for an operation by key.
53
+ */
54
+ export declare const getHandlerByKey: (set: OperationHandlerSet, key: string) => Effect.Effect<Operation.WithHandler<Operation.Definition.Any>, NoHandlerError>;
55
+ declare const OperationHandlerProvider_base: Context.TagClass<OperationHandlerProvider, "@dxos/operation/OperationHandlerProvider", OperationHandlerSet>;
56
+ export declare class OperationHandlerProvider extends OperationHandlerProvider_base {
57
+ }
58
+ export declare const provide: (handlers: OperationHandlerSet) => Layer.Layer<OperationHandlerProvider, never, never>;
59
+ export {};
60
+ //# sourceMappingURL=OperationHandlerSet.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OperationHandlerSet.d.ts","sourceRoot":"","sources":["../../../src/OperationHandlerSet.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAG,sCAA+C,CAAC;AACtE,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpF,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;CAC3E;AAED,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,KAAK,IAAI,mBAE/D,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,mBAInB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,gBAAiB,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAG,mBAErF,CAAC;AAEF,eAAO,MAAM,KAAK,gBACH,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,KAC5E,mBAcF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAa,mBAAmB,EAAE,KAAG,mBAGtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,eACH,CAAC,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAAC,EAAE,KAC1F,mBAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,OAC7D,mBAAmB,cACZ,EAAE,KACb,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,cAAc,CAQtD,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,eAAe,QACrB,mBAAmB,OACnB,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,cAAc,CAQ5E,CAAC;;AAEL,qBAAa,wBAAyB,SAAQ,6BAG3C;CAAG;AAEN,eAAO,MAAM,OAAO,aAAc,mBAAmB,KAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAK,CACvD,CAAC"}
@@ -0,0 +1,23 @@
1
+ import * as Context from 'effect/Context';
2
+ import * as Effect from 'effect/Effect';
3
+ import * as Layer from 'effect/Layer';
4
+ import * as Option from 'effect/Option';
5
+ import { Database } from '@dxos/echo';
6
+ import * as Operation from './Operation';
7
+ import * as OperationHandlerSet from './OperationHandlerSet';
8
+ export interface OperationRegistry {
9
+ /**
10
+ * Resolve an operation by key.
11
+ */
12
+ resolve(key: string): Effect.Effect<Option.Option<Operation.Definition.Any>>;
13
+ }
14
+ declare const Service_base: Context.TagClass<Service, "@dxos/operation/OperationRegistry", OperationRegistry>;
15
+ export declare class Service extends Service_base {
16
+ }
17
+ /**
18
+ * Resolve an operation by key.
19
+ */
20
+ export declare const resolve: (key: string) => Effect.Effect<Option.Option<Operation.Definition.Any>, never, Service>;
21
+ export declare const layer: Layer.Layer<Service, never, Database.Service | OperationHandlerSet.OperationHandlerProvider>;
22
+ export {};
23
+ //# sourceMappingURL=OperationRegistry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OperationRegistry.d.ts","sourceRoot":"","sources":["../../../src/OperationRegistry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9E;;AAED,qBAAa,OAAQ,SAAQ,YAA8E;CAAG;AAE9G;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CACvC,CAAC;AAEtE,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,mBAAmB,CAAC,wBAAwB,CAkB5G,CAAC"}