@syntropika/tembra-sdk 0.2.2 → 0.3.0

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 (241) hide show
  1. package/README.md +43 -17
  2. package/dist/authoring/types.d.ts +64 -3
  3. package/dist/authoring/wit.d.ts +6 -0
  4. package/dist/bridge/commands.d.ts +1190 -0
  5. package/dist/bridge/identifiers.d.ts +2 -0
  6. package/dist/bridge/kernel.d.ts +18 -107
  7. package/dist/bridge/protocol.d.ts +3 -138
  8. package/dist/browser.d.ts +14 -1
  9. package/dist/browser.js +141 -3332
  10. package/dist/chunks/browser-b8jamxw2.js +3399 -0
  11. package/dist/chunks/execution-nsqc6nrt.js +1419 -0
  12. package/dist/chunks/index-01zk0xqx.js +160 -0
  13. package/dist/chunks/index-3fjdfdfd.js +152 -0
  14. package/dist/chunks/index-aaymjn7v.js +787 -0
  15. package/dist/chunks/index-c1w7z9hx.js +356 -0
  16. package/dist/chunks/index-h8t0n42q.js +738 -0
  17. package/dist/chunks/index-hfds9mzp.js +308 -0
  18. package/dist/chunks/index-kr4x67wt.js +177 -0
  19. package/dist/chunks/index-kr6bnh34.js +117 -0
  20. package/dist/chunks/index-kyt9dj0a.js +1421 -0
  21. package/dist/chunks/index-n1wxzc9w.js +830 -0
  22. package/dist/chunks/index-pvac426d.js +74 -0
  23. package/dist/chunks/index-smyds5ce.js +3234 -0
  24. package/dist/chunks/index-sse8aapb.js +121 -0
  25. package/dist/chunks/index-v6heph77.js +643 -0
  26. package/dist/chunks/index-xrdvnv37.js +3448 -0
  27. package/dist/chunks/index-za4mg94e.js +26 -0
  28. package/dist/chunks/index-zkqmnjj8.js +167 -0
  29. package/dist/coordinator.js +9 -500
  30. package/dist/error.d.ts +2 -0
  31. package/dist/errors.d.ts +3 -0
  32. package/dist/guest.d.ts +173 -0
  33. package/dist/guest.js +26 -0
  34. package/dist/host.d.ts +36 -30
  35. package/dist/host.js +37 -3310
  36. package/dist/http/bytes.d.ts +8 -0
  37. package/dist/http/events.d.ts +7 -0
  38. package/dist/http.d.ts +45 -0
  39. package/dist/http.js +291 -0
  40. package/dist/index.d.ts +2 -0
  41. package/dist/index.js +49 -862
  42. package/dist/infrastructure/rpc/client.d.ts +2 -1
  43. package/dist/infrastructure/rpc/resources.d.ts +28 -0
  44. package/dist/interpreter/abi.d.ts +54 -0
  45. package/dist/interpreter/acquire.d.ts +18 -0
  46. package/dist/interpreter/browser-network.d.ts +52 -0
  47. package/dist/interpreter/browser-port.d.ts +55 -0
  48. package/dist/interpreter/browser.d.ts +79 -0
  49. package/dist/interpreter/cli.d.ts +5 -0
  50. package/dist/interpreter/codec.d.ts +42 -0
  51. package/dist/interpreter/component/execution.d.ts +42 -0
  52. package/dist/interpreter/component/host.d.ts +69 -0
  53. package/dist/interpreter/component/instance.d.ts +40 -0
  54. package/dist/interpreter/component/kernel.d.ts +120 -0
  55. package/dist/interpreter/component/names.d.ts +5 -0
  56. package/dist/interpreter/component/port.d.ts +85 -0
  57. package/dist/interpreter/component/prepared.d.ts +97 -0
  58. package/dist/interpreter/component/resources.d.ts +45 -0
  59. package/dist/interpreter/component/revision.d.ts +87 -0
  60. package/dist/interpreter/component/scope.d.ts +116 -0
  61. package/dist/interpreter/component/streams.d.ts +28 -0
  62. package/dist/interpreter/component/values.d.ts +79 -0
  63. package/dist/interpreter/component/wasi-filesystem.d.ts +21 -0
  64. package/dist/interpreter/component/wasi-host.d.ts +64 -0
  65. package/dist/interpreter/component/wasi-http.d.ts +33 -0
  66. package/dist/interpreter/component/wasi-sockets.d.ts +183 -0
  67. package/dist/interpreter/component/wasi.d.ts +41 -0
  68. package/dist/interpreter/core.d.ts +64 -0
  69. package/dist/interpreter/fetch-http-provider.d.ts +17 -0
  70. package/dist/interpreter/filesystem/contract.d.ts +85 -0
  71. package/dist/interpreter/filesystem/memory.d.ts +3 -0
  72. package/dist/interpreter/filesystem/opfs.d.ts +3 -0
  73. package/dist/interpreter/filesystem/scope.d.ts +35 -0
  74. package/dist/interpreter/filesystem.d.ts +8 -0
  75. package/dist/interpreter/gate.d.ts +6 -0
  76. package/dist/interpreter/host-protocol.d.ts +100 -0
  77. package/dist/interpreter/http-ingress-fetch.d.ts +7 -0
  78. package/dist/interpreter/http-ingress.d.ts +96 -0
  79. package/dist/interpreter/http-provider.d.ts +85 -0
  80. package/dist/interpreter/io.d.ts +20 -0
  81. package/dist/interpreter/mobile.d.ts +149 -0
  82. package/dist/interpreter/native-ingress.d.ts +95 -0
  83. package/dist/interpreter/node-port.d.ts +25 -0
  84. package/dist/interpreter/node.d.ts +36 -0
  85. package/dist/interpreter/revision.d.ts +64 -0
  86. package/dist/interpreter/scope.d.ts +89 -0
  87. package/dist/interpreter/socket-addresses.d.ts +50 -0
  88. package/dist/interpreter/socket-provider.d.ts +110 -0
  89. package/dist/interpreter/standard-cli.d.ts +34 -0
  90. package/dist/interpreter/standard-codec.d.ts +96 -0
  91. package/dist/interpreter/standard-filesystem.d.ts +47 -0
  92. package/dist/interpreter/standard-host.d.ts +71 -0
  93. package/dist/interpreter/standard-http-values.d.ts +159 -0
  94. package/dist/interpreter/standard-http.d.ts +9 -0
  95. package/dist/interpreter/standard-ingress.d.ts +63 -0
  96. package/dist/interpreter/standard-sockets.d.ts +177 -0
  97. package/dist/interpreter/standard-streams.d.ts +218 -0
  98. package/dist/interpreter/standard-system.d.ts +35 -0
  99. package/dist/interpreter/standard-utf8.d.ts +4 -0
  100. package/dist/interpreter/standard.d.ts +18 -0
  101. package/dist/interpreter/types.d.ts +152 -0
  102. package/dist/interpreter/wit-shape.d.ts +92 -0
  103. package/dist/manager.js +5 -332
  104. package/dist/msgpack.js +9 -615
  105. package/dist/node.d.ts +8 -1
  106. package/dist/node.js +248 -3321
  107. package/dist/rpc.js +196 -699
  108. package/dist/runtime/adapters.d.ts +120 -0
  109. package/dist/runtime/adapters.js +38 -0
  110. package/dist/runtime/calls.d.ts +7 -6
  111. package/dist/runtime/lifecycle.d.ts +3 -1
  112. package/dist/runtime/orbs.d.ts +5 -4
  113. package/dist/runtime/references.d.ts +27 -1
  114. package/dist/runtime/reload.d.ts +5 -3
  115. package/dist/runtime/scopes.d.ts +1 -1
  116. package/dist/runtime/signals.d.ts +4 -0
  117. package/dist/runtime/wit-client.d.ts +38 -0
  118. package/dist/telemetry.js +4 -25
  119. package/dist/tooling/build.d.ts +2 -2
  120. package/dist/tooling/client-resources.d.ts +23 -0
  121. package/dist/tooling/client.d.ts +10 -0
  122. package/dist/tooling/component-glue.d.ts +17 -0
  123. package/dist/tooling/component.d.ts +11 -0
  124. package/dist/tooling/index.d.ts +3 -1
  125. package/dist/tooling/index.js +1155 -102
  126. package/dist/tooling/resolver.d.ts +4 -4
  127. package/dist/tooling/typecheck.d.ts +2 -1
  128. package/dist/tooling/types.d.ts +27 -12
  129. package/dist/tooling/wit.d.ts +9 -0
  130. package/dist/wasi/wasi-clocks-types.d.ts +2 -0
  131. package/dist/wasi/wasi-http-client.d.ts +5 -0
  132. package/dist/wasi/wasi-http-types.d.ts +285 -0
  133. package/dist/wasi/wasi-sockets-ip-name-lookup.d.ts +23 -0
  134. package/dist/wasi/wasi-sockets-types.d.ts +146 -0
  135. package/package.json +62 -35
  136. package/src/authoring/declaration.ts +1 -1
  137. package/src/authoring/types.ts +53 -3
  138. package/src/authoring/wit.ts +15 -0
  139. package/src/bridge/commands.ts +1105 -0
  140. package/src/bridge/identifiers.ts +2 -0
  141. package/src/bridge/kernel.ts +56 -98
  142. package/src/bridge/protocol.ts +3 -142
  143. package/src/browser.ts +90 -6
  144. package/src/context-key.ts +4 -7
  145. package/src/error.ts +1 -1
  146. package/src/errors.ts +7 -0
  147. package/src/guest.ts +327 -0
  148. package/src/host.ts +128 -23
  149. package/src/http/bytes.ts +87 -0
  150. package/src/http/events.ts +34 -0
  151. package/src/http.ts +272 -0
  152. package/src/index.ts +3 -0
  153. package/src/infrastructure/rpc/client.ts +136 -17
  154. package/src/infrastructure/rpc/resources.ts +123 -0
  155. package/src/interpreter/abi.ts +69 -0
  156. package/src/interpreter/acquire.ts +58 -0
  157. package/src/interpreter/browser-network.ts +170 -0
  158. package/src/interpreter/browser-port.ts +425 -0
  159. package/src/interpreter/browser.ts +340 -0
  160. package/src/interpreter/cli.ts +30 -0
  161. package/src/interpreter/codec.ts +298 -0
  162. package/src/interpreter/component/execution.ts +264 -0
  163. package/src/interpreter/component/host.ts +409 -0
  164. package/src/interpreter/component/instance.ts +138 -0
  165. package/src/interpreter/component/kernel.ts +611 -0
  166. package/src/interpreter/component/names.ts +13 -0
  167. package/src/interpreter/component/port.ts +598 -0
  168. package/src/interpreter/component/prepared.ts +194 -0
  169. package/src/interpreter/component/resources.ts +345 -0
  170. package/src/interpreter/component/revision.ts +702 -0
  171. package/src/interpreter/component/scope.ts +447 -0
  172. package/src/interpreter/component/streams.ts +180 -0
  173. package/src/interpreter/component/values.ts +254 -0
  174. package/src/interpreter/component/wasi-filesystem.ts +472 -0
  175. package/src/interpreter/component/wasi-host.ts +197 -0
  176. package/src/interpreter/component/wasi-http.ts +939 -0
  177. package/src/interpreter/component/wasi-sockets.ts +958 -0
  178. package/src/interpreter/component/wasi.ts +238 -0
  179. package/src/interpreter/core.ts +386 -0
  180. package/src/interpreter/fetch-http-provider.ts +98 -0
  181. package/src/interpreter/filesystem/contract.ts +138 -0
  182. package/src/interpreter/filesystem/memory.ts +180 -0
  183. package/src/interpreter/filesystem/opfs.ts +294 -0
  184. package/src/interpreter/filesystem/scope.ts +390 -0
  185. package/src/interpreter/filesystem.ts +20 -0
  186. package/src/interpreter/gate.ts +55 -0
  187. package/src/interpreter/host-protocol.ts +242 -0
  188. package/src/interpreter/http-ingress-fetch.ts +133 -0
  189. package/src/interpreter/http-ingress.ts +203 -0
  190. package/src/interpreter/http-provider.ts +105 -0
  191. package/src/interpreter/io.ts +66 -0
  192. package/src/interpreter/mobile.ts +385 -0
  193. package/src/interpreter/native-ingress.ts +550 -0
  194. package/src/interpreter/node-port.ts +218 -0
  195. package/src/interpreter/node.ts +114 -0
  196. package/src/interpreter/revision.ts +450 -0
  197. package/src/interpreter/scope.ts +453 -0
  198. package/src/interpreter/socket-addresses.ts +246 -0
  199. package/src/interpreter/socket-provider.ts +126 -0
  200. package/src/interpreter/standard-cli.ts +184 -0
  201. package/src/interpreter/standard-codec.ts +403 -0
  202. package/src/interpreter/standard-filesystem.ts +545 -0
  203. package/src/interpreter/standard-host.ts +840 -0
  204. package/src/interpreter/standard-http-values.ts +624 -0
  205. package/src/interpreter/standard-http.ts +622 -0
  206. package/src/interpreter/standard-ingress.ts +344 -0
  207. package/src/interpreter/standard-sockets.ts +847 -0
  208. package/src/interpreter/standard-streams.ts +710 -0
  209. package/src/interpreter/standard-system.ts +182 -0
  210. package/src/interpreter/standard-utf8.ts +72 -0
  211. package/src/interpreter/standard.ts +283 -0
  212. package/src/interpreter/types.ts +163 -0
  213. package/src/interpreter/wit-shape.ts +175 -0
  214. package/src/node.ts +43 -14
  215. package/src/runtime/activities.ts +6 -6
  216. package/src/runtime/adapters.ts +314 -0
  217. package/src/runtime/calls.ts +213 -90
  218. package/src/runtime/context.ts +7 -7
  219. package/src/runtime/lifecycle.ts +36 -17
  220. package/src/runtime/orbs.ts +81 -39
  221. package/src/runtime/programs.ts +16 -8
  222. package/src/runtime/references.ts +128 -11
  223. package/src/runtime/reload.ts +71 -30
  224. package/src/runtime/resources.ts +2 -2
  225. package/src/runtime/scopes.ts +17 -17
  226. package/src/runtime/session.ts +3 -1
  227. package/src/runtime/signals.ts +31 -0
  228. package/src/runtime/wit-client.ts +228 -0
  229. package/src/tooling/build.ts +152 -54
  230. package/src/tooling/client-resources.ts +74 -0
  231. package/src/tooling/client.ts +531 -0
  232. package/src/tooling/component-glue.ts +288 -0
  233. package/src/tooling/component.ts +225 -0
  234. package/src/tooling/index.ts +3 -7
  235. package/src/tooling/resolver.ts +42 -25
  236. package/src/tooling/typecheck.ts +59 -4
  237. package/src/tooling/types.ts +27 -12
  238. package/src/tooling/wit.ts +188 -0
  239. package/dist/embedded.d.ts +0 -1
  240. package/dist/embedded.js +0 -1
  241. package/src/embedded.ts +0 -301
@@ -1,9 +1,11 @@
1
- import type {
2
- OrbDefinition,
3
- PreparedReload,
4
- ReloadOptions,
5
- ReloadReport,
6
- } from "../authoring/types.ts";
1
+ import {
2
+ disposeDefinitions,
3
+ discardDefinitions,
4
+ prepareDefinitions,
5
+ isolate,
6
+ type AdaptedHostOptions,
7
+ } from "#tembra-adapters";
8
+ import type { OrbInput, PreparedReload, ReloadOptions, ReloadReport } from "../authoring/types.ts";
7
9
  import { Reason, ReloadStatus } from "../bridge/identifiers.ts";
8
10
  import type { Reload } from "../bridge/kernel.ts";
9
11
  import { KernelOp } from "../bridge/protocol.ts";
@@ -23,7 +25,7 @@ export class Replacements {
23
25
 
24
26
  /** Prepare and commit a replacement in one operation. */
25
27
  async replace(
26
- definitions: readonly OrbDefinition[],
28
+ definitions: readonly OrbInput[],
27
29
  options: ReloadOptions = {},
28
30
  remove: readonly string[] = [],
29
31
  ): Promise<ReloadReport> {
@@ -32,7 +34,7 @@ export class Replacements {
32
34
 
33
35
  /** Reject overlapping replacement attempts before capturing callbacks. */
34
36
  prepare(
35
- definitions: readonly OrbDefinition[],
37
+ definitions: readonly OrbInput[],
36
38
  options: ReloadOptions = {},
37
39
  remove: readonly string[] = [],
38
40
  ): Promise<PreparedReload> {
@@ -58,18 +60,39 @@ export class Replacements {
58
60
  await this.#pending?.catch(() => undefined);
59
61
  }
60
62
 
63
+ /** Treat the expected abort acknowledgement as settlement while preserving recovery failures. */
64
+ private async settleAbort(program: number): Promise<void> {
65
+ try {
66
+ await this.session.programs.run(program);
67
+ } catch (error) {
68
+ if (!(error instanceof TembraError) || error.reason !== Reason.ReloadAborted) throw error;
69
+ }
70
+ }
71
+
61
72
  /** Bind candidate callbacks to the kernel's prepared replacement. */
62
73
  private async capture(
63
- definitions: readonly OrbDefinition[],
74
+ definitions: readonly OrbInput[],
64
75
  options: ReloadOptions,
65
76
  remove: readonly string[],
66
77
  ): Promise<PreparedReload> {
67
78
  const session = this.session;
68
- const declarations = session.orbs.declarations(definitions);
69
- const reload = session.kernel.command<Reload>(KernelOp.Prepare, {
70
- orbs: declarations.metadata,
71
- remove,
72
- });
79
+ const candidates = prepareDefinitions(
80
+ definitions,
81
+ (session.options as AdaptedHostOptions)[isolate],
82
+ );
83
+ const materialized = Array.isArray(candidates) ? candidates : await candidates;
84
+ let declarations: ReturnType<Session["orbs"]["declarations"]>;
85
+ let reload: Reload;
86
+ try {
87
+ if (session.closing) throw new TembraError(Errors.Closed.Host);
88
+ declarations = session.orbs.declarations(materialized);
89
+ reload = session.kernel.command(KernelOp.Prepare, {
90
+ orbs: declarations.metadata,
91
+ remove,
92
+ });
93
+ } catch (error) {
94
+ return discardDefinitions(materialized, error);
95
+ }
73
96
  const definitionsByName = new Map(
74
97
  declarations.definitions.map((definition) => [definition.name, definition]),
75
98
  );
@@ -81,16 +104,22 @@ export class Replacements {
81
104
  const recordsById = new Map(records.map((record) => [record.info.id, record]));
82
105
  let program: number | undefined;
83
106
  try {
84
- for (const record of records) session.orbs.scope(record);
107
+ for (const record of records) {
108
+ const prepared = session.orbs.scope(record);
109
+ if (prepared instanceof Promise) await prepared;
110
+ }
85
111
  for (const id of reload.objects) {
86
112
  const object = session.objects.get(id);
87
113
  if (!object) continue;
88
114
  const orb = reload.providers[object.address.service];
89
115
  const record = orb === undefined ? undefined : recordsById.get(orb);
90
- if (record) session.scopes.createEnvironment(object, record);
116
+ if (record) {
117
+ const prepared = session.scopes.createEnvironment(object, record);
118
+ if (prepared instanceof Promise) await prepared;
119
+ }
91
120
  }
92
121
  for (const record of records) record.ticket = undefined;
93
- program = session.kernel.command<number>(KernelOp.ScopesReloadRegistered, {
122
+ program = session.kernel.command(KernelOp.ScopesReloadRegistered, {
94
123
  ticket: reload.id,
95
124
  deadline: options.deadline ?? 5000,
96
125
  now: session.now(),
@@ -101,14 +130,19 @@ export class Replacements {
101
130
  if (session.closing) await session.programs.run(program);
102
131
  } catch (error) {
103
132
  this.#program = undefined;
104
- if (program === undefined) {
105
- session.kernel.command(KernelOp.Abort, { ticket: reload.id });
106
- const scopes = reload.orbs.flatMap((orb) =>
107
- session.kernel.command<number[]>(KernelOp.ScopesForOrb, { orb: orb.id }),
108
- );
109
- await session.programs.cleanupScopes(scopes);
133
+ let failure = error;
134
+ try {
135
+ if (program === undefined) {
136
+ session.kernel.command(KernelOp.Abort, { ticket: reload.id });
137
+ const scopes = reload.orbs.flatMap((orb) =>
138
+ session.kernel.command(KernelOp.ScopesForOrb, { orb: orb.id }),
139
+ );
140
+ await session.programs.cleanupScopes(scopes);
141
+ }
142
+ } catch (recovery) {
143
+ failure = new AggregateError([error, recovery], "Orb preparation and recovery failed");
110
144
  }
111
- throw error;
145
+ return discardDefinitions(materialized, failure);
112
146
  }
113
147
  this.#program = undefined;
114
148
  const id = program;
@@ -130,11 +164,17 @@ export class Replacements {
130
164
  try {
131
165
  session.kernel.command(KernelOp.ProgramCommit, { program: id });
132
166
  } catch (error) {
133
- session.kernel.command(KernelOp.ProgramAbort, { program: id });
134
- await session.programs.run(id).catch(() => {});
167
+ let failure = error;
168
+ try {
169
+ session.kernel.command(KernelOp.ProgramAbort, { program: id });
170
+ await this.settleAbort(id);
171
+ } catch (recovery) {
172
+ failure = new AggregateError([error, recovery], "Orb commit and recovery failed");
173
+ }
174
+
135
175
  status = ReloadStatus.Aborted;
136
176
  this.#pending = undefined;
137
- throw error;
177
+ return discardDefinitions(materialized, failure);
138
178
  }
139
179
  status = ReloadStatus.Committed;
140
180
  this.#pending = undefined;
@@ -149,12 +189,13 @@ export class Replacements {
149
189
  status = ReloadStatus.Aborted;
150
190
  this.#prepared = undefined;
151
191
  this.#pending = undefined;
152
- session.kernel.command(KernelOp.ProgramAbort, { program: id });
153
192
  try {
154
- await session.programs.run(id);
193
+ session.kernel.command(KernelOp.ProgramAbort, { program: id });
194
+ await this.settleAbort(id);
155
195
  } catch (error) {
156
- if (!(error instanceof TembraError) || error.reason !== Reason.ReloadAborted) throw error;
196
+ return discardDefinitions(materialized, error);
157
197
  }
198
+ await disposeDefinitions(materialized);
158
199
  },
159
200
  });
160
201
  }
@@ -39,7 +39,7 @@ export class Resources {
39
39
 
40
40
  /** Ask Rust to resolve this named resource declaration. */
41
41
  private register(environment: Environment, name: string, options: ResourceOptions<any>): number {
42
- return this.session.kernel.command<{ id: number; value: number | null }>(KernelOp.Resource, {
42
+ return this.session.kernel.command(KernelOp.Resource, {
43
43
  owner: environment.owner,
44
44
  name,
45
45
  version: options.version ?? 1,
@@ -76,7 +76,7 @@ export class Resources {
76
76
  get value() {
77
77
  if (environment.phase === EnvironmentPhase.Declaring)
78
78
  refuse(Errors.Invalid.ResourceInFactory, "Resources open after declaration");
79
- const value = record.session.kernel.command<number>(KernelOp.ResourceValue, {
79
+ const value = record.session.kernel.command(KernelOp.ResourceValue, {
80
80
  resource: record.id,
81
81
  });
82
82
  return record.session.value<T>(value);
@@ -1,3 +1,4 @@
1
+ import { captureEnvironment, admitFactory, type AdaptedService } from "#tembra-adapters";
1
2
  import { Declaration } from "../authoring/declaration.ts";
2
3
  import type { Resource, ResourceOptions } from "../authoring/types.ts";
3
4
  import { Code, Reason, Status } from "../bridge/identifiers.ts";
@@ -21,7 +22,7 @@ export class Scopes {
21
22
  /** Allocate the JS callback storage for one declared scope. */
22
23
  environment(owner: Owner, orb: OrbRecord, object?: ObjectRecord): Environment {
23
24
  const environment: Environment = {
24
- id: this.session.kernel.command<number>(KernelOp.Allocate),
25
+ id: this.session.kernel.command(KernelOp.Allocate),
25
26
  owner,
26
27
  orb,
27
28
  ...(object ? { object } : {}),
@@ -47,7 +48,7 @@ export class Scopes {
47
48
  object.address.key,
48
49
  object.address.principal,
49
50
  );
50
- const scopes = session.kernel.command<number[]>(KernelOp.ScopesForOwner, {
51
+ const scopes = session.kernel.command(KernelOp.ScopesForOwner, {
51
52
  owner: { kind: OwnerKind.Object, id: object.id },
52
53
  });
53
54
  await Promise.all(scopes.map((scope) => session.programs.activate(scope)));
@@ -61,13 +62,21 @@ export class Scopes {
61
62
  const orb = session.orbs.records.get(acquired.orb);
62
63
  if (!orb) refuse(Errors.Invalid.OrbGone);
63
64
  await session.orbs.ready(orb);
64
- const environment = this.createEnvironment(object, orb);
65
+ const release = await (
66
+ orb.definition.services?.[object.address.service] as AdaptedService | undefined
67
+ )?.[admitFactory]?.();
68
+ let environment: Environment;
69
+ try {
70
+ const prepared = this.createEnvironment(object, orb);
71
+ environment = prepared instanceof Promise ? await prepared : prepared;
72
+ } finally {
73
+ release?.();
74
+ }
65
75
  object.versions.set(orb.info.id, environment);
66
76
  await this.session.programs.activate(environment.id);
67
77
  }
68
78
  if (
69
- session.kernel.command<Status>(KernelOp.Status, { reference: acquired.reference }) ===
70
- Status.Loading
79
+ session.kernel.command(KernelOp.Status, { reference: acquired.reference }) === Status.Loading
71
80
  )
72
81
  session.kernel.command(KernelOp.Ready, { object: object.id });
73
82
  object.live = true;
@@ -75,20 +84,11 @@ export class Scopes {
75
84
  }
76
85
 
77
86
  /** Run a service factory synchronously and register its scope. */
78
- createEnvironment(object: ObjectRecord, orb: OrbRecord): Environment {
87
+ createEnvironment(object: ObjectRecord, orb: OrbRecord): Environment | Promise<Environment> {
79
88
  const definition = orb.definition.services?.[object.address.service];
80
89
  if (!definition) refuse(Errors.Invalid.ServiceGone);
81
90
  const environment = this.environment({ kind: OwnerKind.Object, id: object.id }, orb, object);
82
- try {
83
- const value = definition.create?.(new Declaration(this.session, environment)) ?? {};
84
- if (value && typeof (value as { then?: unknown }).then === "function")
85
- refuse(Errors.Invalid.AsyncFactory, "Factories must be synchronous");
86
- environment.value = value;
87
- return environment;
88
- } finally {
89
- environment.phase = EnvironmentPhase.Prepared;
90
- this.session.programs.register(environment);
91
- }
91
+ return captureEnvironment(definition, new Declaration(this.session, environment));
92
92
  }
93
93
 
94
94
  /** Share host activation and reopen retired resource scopes. */
@@ -148,7 +148,7 @@ export class Scopes {
148
148
  for (const [alias, requirement] of Object.entries(environment.orb.definition.requires ?? {})) {
149
149
  let provider: KernelOrb;
150
150
  try {
151
- provider = this.session.kernel.command<KernelOrb>(KernelOp.OrbNamed, {
151
+ provider = this.session.kernel.command(KernelOp.OrbNamed, {
152
152
  name: requirement.orb ?? alias,
153
153
  ticket: environment.orb.ticket,
154
154
  });
@@ -62,7 +62,7 @@ export class Session implements StateBackend {
62
62
  this.telemetry = options.telemetry
63
63
  ? new Telemetry(options.telemetry.capacity, options.telemetry.sampleEvery)
64
64
  : undefined;
65
- this.values = new Values(() => this.kernel.command<number>(KernelOp.Allocate));
65
+ this.values = new Values(() => this.kernel.command(KernelOp.Allocate));
66
66
  this.codec = options.serialization ?? jsonCodec;
67
67
  this.name = options.name ?? "host";
68
68
  this.principal = options.principal ?? "host";
@@ -71,6 +71,7 @@ export class Session implements StateBackend {
71
71
  this.now = () => Math.floor(clock() - origin);
72
72
  const hostOrb: OrbRecord = {
73
73
  info: {
74
+ isolated: false,
74
75
  id: 0,
75
76
  owner: 0,
76
77
  name: "$host",
@@ -78,6 +79,7 @@ export class Session implements StateBackend {
78
79
  codeVersion: 1,
79
80
  services: [],
80
81
  hooks: [],
82
+ hookSignatures: {},
81
83
  requires: [],
82
84
  },
83
85
  definition: { name: "$host", apiVersion: 1 },
@@ -0,0 +1,31 @@
1
+ import { TembraError } from "../error.ts";
2
+ import { Errors } from "../errors.ts";
3
+ /** Observe both browser signals and React Native's smaller AbortSignal implementation. */
4
+ export function checkSignal(signal: AbortSignal): void {
5
+ if (signal.aborted) throw signal.reason ?? new TembraError(Errors.Cancelled.Root);
6
+ }
7
+
8
+ /** Link cancellation to a callback lifetime and remove fallback listeners when either ends. */
9
+ export function combinedSignal(owner: AbortSignal, ended: AbortSignal): AbortSignal {
10
+ if (typeof AbortSignal.any === "function") return AbortSignal.any([owner, ended]);
11
+ const controller = new AbortController();
12
+ const detach = () => {
13
+ owner.removeEventListener("abort", cancelOwner);
14
+ ended.removeEventListener("abort", cancelEnded);
15
+ };
16
+ const cancelOwner = () => {
17
+ detach();
18
+ controller.abort(owner.reason);
19
+ };
20
+ const cancelEnded = () => {
21
+ detach();
22
+ controller.abort(ended.reason);
23
+ };
24
+ if (owner.aborted) cancelOwner();
25
+ else if (ended.aborted) cancelEnded();
26
+ else {
27
+ owner.addEventListener("abort", cancelOwner, { once: true });
28
+ ended.addEventListener("abort", cancelEnded, { once: true });
29
+ }
30
+ return controller.signal;
31
+ }
@@ -0,0 +1,228 @@
1
+ /** Generated clients use checked WIT delivery on their reference's existing transport. */
2
+ import type { CapturedInvocation, ResourceCapability } from "#tembra-adapters";
3
+ import type { DynamicReference } from "../authoring/types.ts";
4
+ import { bindingName } from "../interpreter/component/names.ts";
5
+ import { resourceRoles, resourceDataFunction } from "../interpreter/component/resources.ts";
6
+ import type { GraphFunction, TypeGraph } from "../interpreter/component/values.ts";
7
+ import { encode, VALUE_LIMIT } from "../interpreter/codec.ts";
8
+ import { shapes, lift } from "../interpreter/wit-shape.ts";
9
+ import { Context, context, isContext } from "./context.ts";
10
+ import { referenceOrigin } from "./references.ts";
11
+ import { checkSignal } from "./signals.ts";
12
+
13
+ /** Public ownership operations of a provider-issued WIT resource. */
14
+ export interface WitResource {
15
+ readonly resourceType: string;
16
+ /** Release this resource through its existing SDK owner. */
17
+ release(): void;
18
+ }
19
+
20
+ /** Build-time checked metadata retained by generated WIT clients. */
21
+ export interface WitClientSchema extends TypeGraph {
22
+ readonly imports?: readonly { readonly binding: string; readonly contract?: string }[];
23
+ readonly identity: string;
24
+ readonly signature: string;
25
+ readonly resources: Readonly<Record<string, number>>;
26
+ readonly functions: Readonly<Record<string, GraphFunction>>;
27
+ }
28
+
29
+ /** An awaitable invocation of one generated, precisely typed WIT signature. */
30
+ export interface WitClient {
31
+ call<T>(method: string, args: readonly unknown[]): Promise<T>;
32
+ }
33
+
34
+ const owners = new WeakMap<object, { owner: ResourceCapability; session: object }>();
35
+ const finalizer =
36
+ typeof FinalizationRegistry === "undefined"
37
+ ? undefined
38
+ : new FinalizationRegistry<ResourceCapability>((owner) => owner.close());
39
+
40
+ /** Internal backend for the same generated wrappers and SDK resource capabilities. */
41
+ export interface WitClientBackend {
42
+ readonly identity: object;
43
+ /** Keep decoding inside the operation's existing cancellation and physical ownership scope. */
44
+ run<T>(
45
+ supplied: Context | undefined,
46
+ operation: (context: Context | undefined) => Promise<T>,
47
+ ): Promise<T>;
48
+ /** Deliver through the backend selected by this issued reference. */
49
+ invoke(
50
+ method: string,
51
+ args: unknown[],
52
+ capture: CapturedInvocation,
53
+ context?: Context,
54
+ ): Promise<void>;
55
+ }
56
+
57
+ const backends = new WeakMap<object, (schema: WitClientSchema) => WitClientBackend>();
58
+
59
+ /** Attach RPC delivery metadata to an issued reference; this grants no resource authority. */
60
+ export function bindWitReference(
61
+ reference: object,
62
+ backend: (schema: WitClientSchema) => WitClientBackend,
63
+ ): void {
64
+ backends.set(reference, backend);
65
+ }
66
+
67
+ /** Bind typed wrappers to an SDK reference without creating another capability protocol. */
68
+ export function witClient(reference: DynamicReference, schema: WitClientSchema): WitClient {
69
+ const remote = backends.get(reference);
70
+ if (remote) return resourceClient(schema, remote(schema));
71
+ if (Object.keys(schema.resources).length === 0)
72
+ return {
73
+ /** Preserve local data values and the reference's existing context and checks. */
74
+ async call<T>(method: string, args: readonly unknown[]): Promise<T> {
75
+ if (!Object.hasOwn(schema.functions, method))
76
+ throw new Error(`Unknown WIT function ${method}`);
77
+ return reference[method](...args) as Promise<T>;
78
+ },
79
+ };
80
+ const { session, record } = referenceOrigin(reference);
81
+ return resourceClient(schema, {
82
+ identity: session,
83
+ run(supplied, operation) {
84
+ const selected = supplied ? context(supplied, session) : record.context;
85
+ return selected
86
+ ? session.calls.observe(operation(selected), selected.signal)
87
+ : session.calls.root(
88
+ (ctx) => session.calls.observe(operation(ctx), ctx.signal),
89
+ false,
90
+ undefined,
91
+ record.address.principal,
92
+ );
93
+ },
94
+ async invoke(method, args, capture, ctx) {
95
+ await session.calls.invokePhysical(
96
+ capture.receiver ? capture.receiver.reference : record,
97
+ method,
98
+ args,
99
+ ctx!,
100
+ capture,
101
+ );
102
+ },
103
+ });
104
+ }
105
+
106
+ /** Encode, move and decode once for both local and RPC capability delivery. */
107
+ function resourceClient(schema: WitClientSchema, backend: WitClientBackend): WitClient {
108
+ const session = backend.identity;
109
+ const compile = shapes(schema);
110
+ const functions = new Map(
111
+ Object.entries(schema.functions).map(([name, fn]) => {
112
+ const roles = resourceRoles(schema, schema.identity, { ...fn, name });
113
+ if (roles.stream) throw new Error("Generated clients do not support stream results");
114
+ return [name, { roles, shape: compile(resourceDataFunction(fn, roles)), fn }] as const;
115
+ }),
116
+ );
117
+ /** Wrap one existing owner; its methods continue to call on its own admission claim. */
118
+ const wrap = (owner: ResourceCapability): WitResource => {
119
+ const value: WitResource & Record<string, unknown> = {
120
+ resourceType: `${owner.nominal.interface}#${owner.nominal.name}`,
121
+ release() {
122
+ finalizer?.unregister(value);
123
+ owner.close();
124
+ },
125
+ };
126
+ owners.set(value, { owner, session });
127
+ finalizer?.register(value, owner, value);
128
+ for (const [name, { roles }] of functions) {
129
+ if (roles.receiver?.name === owner.nominal.name && roles.member) {
130
+ const method = schema.javascriptNames[roles.member] ?? bindingName(roles.member, false);
131
+ value[method] = (...args: unknown[]) => invoke(name, args, owner);
132
+ }
133
+ }
134
+ return value;
135
+ };
136
+ /** Keep cancellation observable while physical settlement retains the existing owners. */
137
+ const invoke = async (
138
+ name: string,
139
+ supplied: readonly unknown[],
140
+ receiver?: ResourceCapability,
141
+ ): Promise<unknown> => {
142
+ const selected = functions.get(name);
143
+ if (!selected) throw new Error(`Unknown WIT function ${name}`);
144
+ const { roles, shape } = selected;
145
+ const args = [...supplied];
146
+ const count = selected.fn.params.length - Number(Boolean(roles.receiver));
147
+ if (args.length === count + 1 && args[count] === undefined) args.pop();
148
+ const last = args.at(-1);
149
+ const ctx = isContext(last) ? (args.pop() as Context) : undefined;
150
+ const moved: ResourceCapability[] = [];
151
+ let accepted = false;
152
+ const call = async (ctx: Context | undefined): Promise<unknown> => {
153
+ let capture: CapturedInvocation | undefined;
154
+ try {
155
+ const arguments_ = roles.arguments
156
+ ? (roles.arguments(args, (nominal, value) => {
157
+ const held =
158
+ typeof value === "object" && value !== null ? owners.get(value) : undefined;
159
+ if (
160
+ !held ||
161
+ held.session !== session ||
162
+ held.owner.nominal.interface !== nominal.interface ||
163
+ held.owner.nominal.name !== nominal.name
164
+ )
165
+ throw new Error("Expected an SDK resource of the exact nominal type and host");
166
+ const owner = held.owner.move();
167
+ finalizer?.unregister(value as object);
168
+ moved.push(owner);
169
+ return moved.length - 1;
170
+ }) as unknown[])
171
+ : args;
172
+ const input = encode(arguments_, VALUE_LIMIT, shape.params);
173
+ capture = {
174
+ signature: schema.signature,
175
+ input,
176
+ ...(receiver ? { receiver } : {}),
177
+ ...(moved.length
178
+ ? {
179
+ arguments: {
180
+ owners: moved,
181
+ get accepted() {
182
+ return accepted;
183
+ },
184
+ accept() {
185
+ accepted = true;
186
+ },
187
+ },
188
+ }
189
+ : {}),
190
+ };
191
+ await backend.invoke(name, arguments_ as unknown[], capture, ctx);
192
+ if (ctx) checkSignal(ctx.signal);
193
+ if (!capture.output)
194
+ throw new Error("Provider does not support the matching WIT capability signature");
195
+ const value: unknown = lift(shape.result, JSON.parse(capture.output.text));
196
+ const capabilities = capture.capabilities ?? [];
197
+ const consumed = new Set<number>();
198
+ const result = roles.result
199
+ ? roles.result(value, (nominal, index) => {
200
+ if (typeof index !== "number" || !Number.isInteger(index) || consumed.has(index))
201
+ throw new Error("An owned result must redeem each attachment exactly once");
202
+ const owner = capabilities[index];
203
+ if (
204
+ owner?.kind !== "resource" ||
205
+ owner.nominal.interface !== nominal.interface ||
206
+ owner.nominal.name !== nominal.name
207
+ )
208
+ throw new Error("Resource has another nominal type");
209
+ consumed.add(index);
210
+ return wrap(owner);
211
+ })
212
+ : value;
213
+ if (consumed.size !== capabilities.length)
214
+ throw new Error("Unused result capability attachment");
215
+ return selected.fn.result == null ? undefined : result;
216
+ } catch (error) {
217
+ for (const capability of capture?.capabilities ?? []) capability.close();
218
+ throw error;
219
+ } finally {
220
+ if (!accepted) for (const owner of moved) owner.close();
221
+ }
222
+ };
223
+ // The physical operation performs delivery checks and closes undelivered owners even if
224
+ // cancellation wins the observation race before the provider publishes its result.
225
+ return backend.run(ctx, call);
226
+ };
227
+ return { call: <T>(name: string, args: readonly unknown[]) => invoke(name, args) as Promise<T> };
228
+ }