@syntropika/tembra-sdk 0.2.1 → 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 -3298
  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 -3276
  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 -3287
  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 +9 -3
  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 +218 -56
  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 -293
@@ -0,0 +1,26 @@
1
+ // src/telemetry.ts
2
+ class Telemetry2 {
3
+ capacity;
4
+ sampleEvery;
5
+ #events = [];
6
+ #next = 0;
7
+ constructor(capacity = 256, sampleEvery = 1) {
8
+ this.capacity = capacity;
9
+ this.sampleEvery = sampleEvery;
10
+ if (!Number.isInteger(capacity) || capacity <= 0 || !Number.isInteger(sampleEvery) || sampleEvery <= 0)
11
+ throw new RangeError("Invalid telemetry limits");
12
+ }
13
+ sample() {
14
+ return this.#next++ % this.sampleEvery === 0;
15
+ }
16
+ record(trace) {
17
+ if (this.#events.length === this.capacity)
18
+ this.#events.shift();
19
+ this.#events.push(trace);
20
+ }
21
+ drain() {
22
+ return this.#events.splice(0);
23
+ }
24
+ }
25
+
26
+ export { Telemetry2 };
@@ -0,0 +1,167 @@
1
+ import {
2
+ EnvironmentPhase
3
+ } from "./index-kr4x67wt.js";
4
+ import {
5
+ Errors2,
6
+ refuse
7
+ } from "./index-c1w7z9hx.js";
8
+
9
+ // src/interpreter/cli.ts
10
+ function captureCli(options) {
11
+ const input = options.stdin;
12
+ return {
13
+ ...options,
14
+ ...options.arguments ? { arguments: [...options.arguments] } : {},
15
+ ...options.environment ? { environment: options.environment.map(([key, value]) => [key, value]) } : {},
16
+ ...typeof input === "object" ? { stdin: "bytes" in input ? { bytes: input.bytes.slice() } : { ...input } } : {},
17
+ ...typeof options.stdout === "object" ? { stdout: { ...options.stdout } } : {},
18
+ ...typeof options.stderr === "object" ? { stderr: { ...options.stderr } } : {}
19
+ };
20
+ }
21
+ function cliPacket(options) {
22
+ if (!options)
23
+ return "{}";
24
+ const stdin = options.stdin;
25
+ return JSON.stringify({
26
+ ...options,
27
+ ...typeof stdin === "object" && "bytes" in stdin ? { stdin: { bytes: Array.from(stdin.bytes) } } : {}
28
+ });
29
+ }
30
+
31
+ // src/runtime/adapters.ts
32
+ var capturedMethods = new WeakMap;
33
+ function bindCaptured2(handle, signature, invoke, invokeData) {
34
+ if (signature || invokeData)
35
+ capturedMethods.set(handle, {
36
+ signature,
37
+ invoke,
38
+ ...invokeData ? { invokeData } : {}
39
+ });
40
+ return handle;
41
+ }
42
+ function capturedMethod2(handle, signature) {
43
+ const adapter = capturedMethods.get(handle);
44
+ return adapter?.signature === signature ? adapter : undefined;
45
+ }
46
+ function capturedDataMethod2(handle) {
47
+ return capturedMethods.get(handle)?.invokeData;
48
+ }
49
+ var declareFactory2 = Symbol("tembra.declare-factory");
50
+ var validateEnvironment2 = Symbol("tembra.validate-environment");
51
+ var isolate2 = Symbol("tembra.isolate");
52
+ var signature2 = Symbol("tembra.signature");
53
+ var signatures2 = Symbol("tembra.signatures");
54
+ var disposeOrb2 = Symbol("tembra.dispose-orb");
55
+ var releaseEnvironment2 = Symbol("tembra.release-environment");
56
+ var isolatedRevision2 = Symbol("tembra.isolated-revision");
57
+ var admitFactory2 = Symbol("tembra.admit-factory");
58
+ function prepareDefinitions2(definitions, isolated) {
59
+ if (!definitions.some((definition) => ("artifact" in definition)))
60
+ return [...definitions];
61
+ const captured = definitions.map((definition) => ("artifact" in definition) ? {
62
+ ...definition.requires ? {
63
+ requires: Object.fromEntries(Object.entries(definition.requires).map(([name, provider]) => [
64
+ name,
65
+ { ...provider }
66
+ ]))
67
+ } : {},
68
+ ...definition.grants ? {
69
+ grants: {
70
+ ...definition.grants,
71
+ ...definition.grants.system ? { system: [...definition.grants.system] } : {},
72
+ ...definition.grants.filesystem ? {
73
+ filesystem: definition.grants.filesystem.map((mount) => ({ ...mount }))
74
+ } : {},
75
+ ...definition.grants.http ? {
76
+ http: definition.grants.http.map((grant) => ({
77
+ ...grant,
78
+ origins: [...grant.origins]
79
+ }))
80
+ } : {},
81
+ ...definition.grants.network ? {
82
+ network: definition.grants.network.map((grant) => ({
83
+ ...grant,
84
+ ...grant.connect ? { connect: [...grant.connect] } : {},
85
+ ...grant.listen ? { listen: [...grant.listen] } : {},
86
+ ...grant.bind ? { bind: [...grant.bind] } : {},
87
+ ...grant.datagrams ? { datagrams: [...grant.datagrams] } : {}
88
+ }))
89
+ } : {}
90
+ }
91
+ } : {},
92
+ artifact: definition.artifact.slice(),
93
+ ...definition.cli ? { cli: captureCli(definition.cli) } : {}
94
+ } : definition);
95
+ return prepareBackends(captured, isolated);
96
+ }
97
+ async function prepareBackends(definitions, isolated) {
98
+ const prepared = new Array(definitions.length);
99
+ let next = 0;
100
+ const failures = [];
101
+ async function prepare() {
102
+ while (failures.length === 0 && next < definitions.length) {
103
+ const index = next++;
104
+ const definition = definitions[index];
105
+ try {
106
+ if ("artifact" in definition) {
107
+ if (!isolated)
108
+ throw new Error("This host has no isolated execution backend");
109
+ const materialized = await isolated(definition);
110
+ if (!materialized)
111
+ throw new Error("Execution backend returned no Orb definition");
112
+ prepared[index] = materialized;
113
+ } else
114
+ prepared[index] = definition;
115
+ } catch (error) {
116
+ failures.push({ index, reason: error });
117
+ } finally {
118
+ definitions[index] = undefined;
119
+ }
120
+ }
121
+ }
122
+ await Promise.all(Array.from({ length: Math.min(4, definitions.length) }, prepare));
123
+ const completed = prepared.filter((definition) => definition !== undefined);
124
+ if (failures.length) {
125
+ const errors = failures.sort((a, b) => a.index - b.index).map((failure) => failure.reason);
126
+ return discardDefinitions2(completed, errors.length === 1 ? errors[0] : new AggregateError(errors, "Orb preparation failed"));
127
+ }
128
+ return completed;
129
+ }
130
+ async function discardDefinitions2(definitions, error) {
131
+ try {
132
+ await disposeDefinitions2(definitions);
133
+ } catch (disposal) {
134
+ throw new AggregateError([error, disposal], "Orb operation and disposal failed");
135
+ }
136
+ throw error;
137
+ }
138
+ async function disposeDefinitions2(definitions) {
139
+ const results = await Promise.allSettled(definitions.map(async (definition) => definition[disposeOrb2]?.()));
140
+ const failures = results.filter((result) => result.status === "rejected");
141
+ if (failures.length)
142
+ throw new AggregateError(failures.map((result) => result.reason), "Backend disposal failed");
143
+ }
144
+ function captureEnvironment2(definition, declaration) {
145
+ const environment = declaration.environment;
146
+ const finish = () => {
147
+ environment.phase = EnvironmentPhase.Prepared;
148
+ declaration.session.programs.register(environment);
149
+ };
150
+ const prepare = definition[declareFactory2];
151
+ if (prepare)
152
+ return Promise.resolve().then(() => prepare(declaration)).then((value) => {
153
+ environment.value = value ?? {};
154
+ return environment;
155
+ }).finally(finish);
156
+ try {
157
+ const value = definition.create?.(declaration) ?? {};
158
+ if (value && typeof value.then === "function")
159
+ refuse(Errors2.Invalid.AsyncFactory);
160
+ environment.value = value;
161
+ return environment;
162
+ } finally {
163
+ finish();
164
+ }
165
+ }
166
+
167
+ export { cliPacket, bindCaptured2, capturedMethod2, capturedDataMethod2, declareFactory2, validateEnvironment2, isolate2, signature2, signatures2, disposeOrb2, releaseEnvironment2, isolatedRevision2, admitFactory2, prepareDefinitions2, discardDefinitions2, disposeDefinitions2, captureEnvironment2 };