@syntropika/tembra-sdk 0.0.0-stage → 0.2.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 (134) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +47 -2
  3. package/dist/authoring/declaration.d.ts +48 -0
  4. package/dist/authoring/hooks.d.ts +11 -0
  5. package/dist/authoring/orb.d.ts +3 -0
  6. package/dist/authoring/service-identities.d.ts +7 -0
  7. package/dist/authoring/services.d.ts +8 -0
  8. package/dist/authoring/types.d.ts +181 -0
  9. package/dist/bridge/identifiers.d.ts +207 -0
  10. package/dist/bridge/kernel.d.ts +117 -0
  11. package/dist/bridge/protocol.d.ts +181 -0
  12. package/dist/browser.d.ts +21 -0
  13. package/dist/browser.js +3335 -0
  14. package/dist/codec.d.ts +1 -0
  15. package/dist/codecs/json.d.ts +13 -0
  16. package/dist/codecs/msgpack.d.ts +3 -0
  17. package/dist/context-key.d.ts +35 -0
  18. package/dist/coordinator.d.ts +1 -0
  19. package/dist/coordinator.js +543 -0
  20. package/dist/embedded.d.ts +1 -0
  21. package/dist/embedded.js +1 -0
  22. package/dist/error.d.ts +13 -0
  23. package/dist/errors.d.ts +122 -0
  24. package/dist/hooks.d.ts +1 -0
  25. package/dist/host.d.ts +98 -0
  26. package/dist/host.js +3278 -0
  27. package/dist/identifiers.d.ts +1 -0
  28. package/dist/index.d.ts +12 -0
  29. package/dist/index.js +864 -0
  30. package/dist/infrastructure/coordinator.d.ts +13 -0
  31. package/dist/infrastructure/manager.d.ts +23 -0
  32. package/dist/infrastructure/rpc/channel.d.ts +55 -0
  33. package/dist/infrastructure/rpc/client.d.ts +20 -0
  34. package/dist/infrastructure/rpc/server.d.ts +10 -0
  35. package/dist/infrastructure/rpc/state.d.ts +16 -0
  36. package/dist/kernel.d.ts +1 -0
  37. package/dist/manager.d.ts +1 -0
  38. package/dist/manager.js +390 -0
  39. package/dist/msgpack.d.ts +1 -0
  40. package/dist/msgpack.js +635 -0
  41. package/dist/node.d.ts +14 -0
  42. package/dist/node.js +3336 -0
  43. package/dist/orb.d.ts +1 -0
  44. package/dist/protocol.d.ts +1 -0
  45. package/dist/rpc.d.ts +3 -0
  46. package/dist/rpc.js +1091 -0
  47. package/dist/runtime/activities.d.ts +30 -0
  48. package/dist/runtime/calls.d.ts +22 -0
  49. package/dist/runtime/context.d.ts +38 -0
  50. package/dist/runtime/declaration.d.ts +1 -0
  51. package/dist/runtime/lifecycle.d.ts +28 -0
  52. package/dist/runtime/orbs.d.ts +39 -0
  53. package/dist/runtime/programs.d.ts +31 -0
  54. package/dist/runtime/records.d.ts +107 -0
  55. package/dist/runtime/references.d.ts +38 -0
  56. package/dist/runtime/reload.d.ts +17 -0
  57. package/dist/runtime/resources.d.ts +24 -0
  58. package/dist/runtime/scopes.d.ts +35 -0
  59. package/dist/runtime/session.d.ts +69 -0
  60. package/dist/state/binding.d.ts +28 -0
  61. package/dist/state/selection.d.ts +21 -0
  62. package/dist/state/types.d.ts +35 -0
  63. package/dist/state.d.ts +2 -0
  64. package/dist/telemetry.d.ts +23 -0
  65. package/dist/telemetry.js +27 -0
  66. package/dist/tooling/build.d.ts +3 -0
  67. package/dist/tooling/index.d.ts +2 -0
  68. package/dist/tooling/index.js +181 -0
  69. package/dist/tooling/resolver.d.ts +5 -0
  70. package/dist/tooling/typecheck.d.ts +2 -0
  71. package/dist/tooling/types.d.ts +29 -0
  72. package/dist/types.d.ts +1 -0
  73. package/dist/values.d.ts +23 -0
  74. package/package.json +103 -4
  75. package/src/authoring/declaration.ts +237 -0
  76. package/src/authoring/hooks.ts +101 -0
  77. package/src/authoring/orb.ts +88 -0
  78. package/src/authoring/service-identities.ts +20 -0
  79. package/src/authoring/services.ts +46 -0
  80. package/src/authoring/types.ts +256 -0
  81. package/src/bridge/identifiers.ts +212 -0
  82. package/src/bridge/kernel.ts +117 -0
  83. package/src/bridge/protocol.ts +193 -0
  84. package/src/browser.ts +59 -0
  85. package/src/codec.ts +1 -0
  86. package/src/codecs/json.ts +147 -0
  87. package/src/codecs/msgpack.ts +26 -0
  88. package/src/context-key.ts +94 -0
  89. package/src/coordinator.ts +1 -0
  90. package/src/embedded.ts +293 -0
  91. package/src/error.ts +50 -0
  92. package/src/errors.ts +237 -0
  93. package/src/hooks.ts +1 -0
  94. package/src/host.ts +173 -0
  95. package/src/identifiers.ts +1 -0
  96. package/src/index.ts +22 -0
  97. package/src/infrastructure/coordinator.ts +76 -0
  98. package/src/infrastructure/manager.ts +77 -0
  99. package/src/infrastructure/rpc/channel.ts +107 -0
  100. package/src/infrastructure/rpc/client.ts +216 -0
  101. package/src/infrastructure/rpc/server.ts +201 -0
  102. package/src/infrastructure/rpc/state.ts +70 -0
  103. package/src/kernel.ts +1 -0
  104. package/src/manager.ts +1 -0
  105. package/src/msgpack.ts +1 -0
  106. package/src/node.ts +53 -0
  107. package/src/orb.ts +1 -0
  108. package/src/protocol.ts +1 -0
  109. package/src/rpc.ts +3 -0
  110. package/src/runtime/activities.ts +197 -0
  111. package/src/runtime/calls.ts +165 -0
  112. package/src/runtime/context.ts +128 -0
  113. package/src/runtime/declaration.ts +1 -0
  114. package/src/runtime/lifecycle.ts +227 -0
  115. package/src/runtime/orbs.ts +292 -0
  116. package/src/runtime/programs.ts +274 -0
  117. package/src/runtime/records.ts +127 -0
  118. package/src/runtime/references.ts +406 -0
  119. package/src/runtime/reload.ts +161 -0
  120. package/src/runtime/resources.ts +157 -0
  121. package/src/runtime/scopes.ts +210 -0
  122. package/src/runtime/session.ts +181 -0
  123. package/src/state/binding.ts +157 -0
  124. package/src/state/selection.ts +122 -0
  125. package/src/state/types.ts +47 -0
  126. package/src/state.ts +2 -0
  127. package/src/telemetry.ts +45 -0
  128. package/src/tooling/build.ts +83 -0
  129. package/src/tooling/index.ts +8 -0
  130. package/src/tooling/resolver.ts +95 -0
  131. package/src/tooling/typecheck.ts +32 -0
  132. package/src/tooling/types.ts +32 -0
  133. package/src/types.ts +1 -0
  134. package/src/values.ts +85 -0
@@ -0,0 +1,212 @@
1
+ /** Named public options and built-in failures. Values remain stable on the wire. */
2
+ type ValueOf<T> = T[keyof T];
3
+
4
+ export const Code = Object.freeze({
5
+ Invalid: "invalid",
6
+ Unavailable: "unavailable",
7
+ Released: "released",
8
+ Gone: "gone",
9
+ Expired: "expired",
10
+ Cancelled: "cancelled",
11
+ Forbidden: "forbidden",
12
+ Conflict: "conflict",
13
+ Unsupported: "unsupported",
14
+ Closed: "closed",
15
+ Exhausted: "exhausted",
16
+ } as const);
17
+ export type Code = ValueOf<typeof Code>;
18
+
19
+ export const Reason = Object.freeze({
20
+ ActivationBusy: "activation_busy",
21
+ Address: "address",
22
+ AlreadyCommitted: "already_committed",
23
+ AmbiguousScope: "ambiguous_scope",
24
+ ApiVersion: "api_version",
25
+ Arguments: "arguments",
26
+ AsyncFactory: "async_factory",
27
+ AsyncState: "async_state",
28
+ Bigint: "bigint",
29
+ ByteResult: "byte_result",
30
+ Call: "call",
31
+ Callback: "callback",
32
+ CleanupBusy: "cleanup_busy",
33
+ Clock: "clock",
34
+ Codec: "codec",
35
+ Connection: "connection",
36
+ Context: "context",
37
+ Contribution: "contribution",
38
+ CoordinationLimits: "coordination_limits",
39
+ Deadline: "deadline",
40
+ Dependency: "dependency",
41
+ DependencyCycle: "dependency_cycle",
42
+ DependencyService: "dependency_service",
43
+ Disposing: "disposing",
44
+ Driver: "driver",
45
+ Duplicate: "duplicate",
46
+ DuplicateContribution: "duplicate_contribution",
47
+ DuplicateListener: "duplicate_listener",
48
+ DuplicateResource: "duplicate_resource",
49
+ DuplicateService: "duplicate_service",
50
+ EffectResults: "effect_results",
51
+ EffectsRunning: "effects_running",
52
+ EngineEffect: "engine_effect",
53
+ EventSource: "event_source",
54
+ ExclusiveDependent: "exclusive_dependent",
55
+ Executor: "executor",
56
+ Orb: "orb",
57
+ OrbGone: "orb_gone",
58
+ OrbInstalled: "orb_installed",
59
+ OrbScope: "orb_scope",
60
+ Factory: "factory",
61
+ FactoryExpired: "factory_expired",
62
+ FrameSize: "frame_size",
63
+ GateBusy: "gate_busy",
64
+ GateOrb: "gate_orb",
65
+ GateObject: "gate_object",
66
+ Hook: "hook",
67
+ HookDependency: "hook_dependency",
68
+ Hooks: "hooks",
69
+ HooksDisabled: "hooks_disabled",
70
+ Host: "host",
71
+ HostAddress: "host_address",
72
+ HostResource: "host_resource",
73
+ HostResourceReload: "host_resource_reload",
74
+ Identities: "identities",
75
+ Implementation: "implementation",
76
+ Invocation: "invocation",
77
+ Javascript: "javascript",
78
+ JsonAccessor: "json_accessor",
79
+ JsonCycle: "json_cycle",
80
+ JsonNumber: "json_number",
81
+ JsonSymbol: "json_symbol",
82
+ JsonTag: "json_tag",
83
+ JsonType: "json_type",
84
+ JsonValue: "json_value",
85
+ Lifetime: "lifetime",
86
+ Linger: "linger",
87
+ ListenerCallback: "listener_callback",
88
+ LiveConsumer: "live_consumer",
89
+ LiveReference: "live_reference",
90
+ LocalValue: "local_value",
91
+ Memory: "memory",
92
+ Metadata: "metadata",
93
+ MetadataSize: "metadata_size",
94
+ Method: "method",
95
+ MigrationGate: "migration_gate",
96
+ MigrationRequired: "migration_required",
97
+ MigrationValue: "migration_value",
98
+ MissingHook: "missing_hook",
99
+ MissingMethod: "missing_method",
100
+ NativeEffect: "native_effect",
101
+ NativeMethod: "native_method",
102
+ NativeObject: "native_object",
103
+ NativeService: "native_service",
104
+ Next: "next",
105
+ NextUsed: "next_used",
106
+ NotReady: "not_ready",
107
+ Object: "object",
108
+ ObjectState: "object_state",
109
+ ObservationSource: "observation_source",
110
+ ObservationAdmitted: "observation_admitted",
111
+ Opaque: "opaque",
112
+ Operation: "operation",
113
+ OperationOwner: "operation_owner",
114
+ Owner: "owner",
115
+ Payload: "payload",
116
+ PendingRequests: "pending_requests",
117
+ PrepareDeadline: "prepare_deadline",
118
+ Priority: "priority",
119
+ Program: "program",
120
+ ProgramPhase: "program_phase",
121
+ ProgramRunning: "program_running",
122
+ Reference: "reference",
123
+ ReloadAborted: "reload_aborted",
124
+ ReloadDeadline: "reload_deadline",
125
+ ReloadPreparing: "reload_preparing",
126
+ ReloadRunning: "reload_running",
127
+ ReloadTicket: "reload_ticket",
128
+ RemoteOpaque: "remote_opaque",
129
+ RemoteReferences: "remote_references",
130
+ Request: "request",
131
+ RequestIds: "request_ids",
132
+ Requires: "requires",
133
+ Resource: "resource",
134
+ ResourceDependencies: "resource_dependencies",
135
+ ResourceDependency: "resource_dependency",
136
+ ResourceHost: "resource_host",
137
+ ResourceInFactory: "resource_in_factory",
138
+ ResourceState: "resource_state",
139
+ ResourceVersion: "resource_version",
140
+ Result: "result",
141
+ RetainedVersions: "retained_versions",
142
+ RevisionExhausted: "revision_exhausted",
143
+ Root: "root",
144
+ Route: "route",
145
+ RpcFrame: "rpc_frame",
146
+ RpcOperation: "rpc_operation",
147
+ RpcRequest: "rpc_request",
148
+ RustType: "rust_type",
149
+ Scope: "scope",
150
+ ScopeClosed: "scope_closed",
151
+ ScopeOrb: "scope_orb",
152
+ ScopeOwner: "scope_owner",
153
+ ScopeResource: "scope_resource",
154
+ Serialization: "serialization",
155
+ Service: "service",
156
+ ServiceGone: "service_gone",
157
+ State: "state",
158
+ StateCycle: "state_cycle",
159
+ StateInitialized: "state_initialized",
160
+ StateOwner: "state_owner",
161
+ StateRevision: "state_revision",
162
+ StateValidation: "state_validation",
163
+ StateValue: "state_value",
164
+ StateVersion: "state_version",
165
+ Subscription: "subscription",
166
+ SubscriptionBusy: "subscription_busy",
167
+ SubscriptionIdle: "subscription_idle",
168
+ SubscriptionQueue: "subscription_queue",
169
+ SubscriptionSize: "subscription_size",
170
+ SubscriptionsDisabled: "subscriptions_disabled",
171
+ Superseded: "superseded",
172
+ Task: "task",
173
+ Telemetry: "telemetry",
174
+ UndeclaredDependency: "undeclared_dependency",
175
+ UndeclaredService: "undeclared_service",
176
+ UnknownService: "unknown_service",
177
+ UpgradeConflict: "upgrade_conflict",
178
+ Utf8: "utf8",
179
+ Value: "value",
180
+ ValueGone: "value_gone",
181
+ ValuesExhausted: "values_exhausted",
182
+ Views: "views",
183
+ } as const);
184
+ export type Reason = ValueOf<typeof Reason>;
185
+
186
+ export const Lifetime = Object.freeze({
187
+ Referenced: "referenced",
188
+ Host: "host",
189
+ } as const);
190
+ export type Lifetime = ValueOf<typeof Lifetime>;
191
+
192
+ export const Status = Object.freeze({
193
+ Loading: "loading",
194
+ Live: "live",
195
+ Released: "released",
196
+ Gone: "gone",
197
+ } as const);
198
+ export type Status = ValueOf<typeof Status>;
199
+
200
+ export const ReloadStatus = Object.freeze({
201
+ Prepared: "prepared",
202
+ Committed: "committed",
203
+ Aborted: "aborted",
204
+ } as const);
205
+ export type ReloadStatus = ValueOf<typeof ReloadStatus>;
206
+
207
+ export const HookCapability = Object.freeze({
208
+ Observe: "observe",
209
+ Transform: "transform",
210
+ Decide: "decide",
211
+ } as const);
212
+ export type HookCapability = ValueOf<typeof HookCapability>;
@@ -0,0 +1,117 @@
1
+ import { TembraError } from "../error.ts";
2
+ import { Code, Lifetime } from "./identifiers.ts";
3
+ import { ActionType, EffectType, KernelOp, OwnerKind } from "./protocol.ts";
4
+
5
+ /** Implemented by Node-API, browser WASM, and embedded V8's native binding. */
6
+ export interface KernelPort {
7
+ /** Exchange one JSON metadata request with the Rust kernel. */
8
+ request(metadata: string): string;
9
+
10
+ /** Release the platform binding after host shutdown. */
11
+ free?(): void;
12
+ }
13
+
14
+ export interface KernelFeatures {
15
+ hooks: boolean;
16
+ subscriptions: boolean;
17
+ views: boolean;
18
+ telemetry: boolean;
19
+ }
20
+ export type Owner =
21
+ | { kind: typeof OwnerKind.Host }
22
+ | { kind: typeof OwnerKind.Orb | typeof OwnerKind.Object; id: number };
23
+ export interface KernelOrb {
24
+ id: number;
25
+ owner: number;
26
+ codeVersion: number;
27
+ name: string;
28
+ apiVersion: number;
29
+ services: { name: string; methods: string[]; lifetime: Lifetime; linger: number }[];
30
+ hooks: string[];
31
+ requires: {
32
+ orb: string;
33
+ apiVersion: number;
34
+ services: Record<string, string[]>;
35
+ hooks: string[];
36
+ }[];
37
+ }
38
+ export interface Acquisition {
39
+ reference: number;
40
+ object: number;
41
+ orb: number;
42
+ codeVersion: number;
43
+ activate: boolean;
44
+ }
45
+ export interface Invocation {
46
+ id: number;
47
+ root: number;
48
+ object: number;
49
+ orb: number;
50
+ codeVersion: number;
51
+ method: string;
52
+ }
53
+ export interface HookObservation {
54
+ invocation: Invocation;
55
+ plan: number[];
56
+ }
57
+ export interface Snapshot {
58
+ value: number;
59
+ revision: string;
60
+ version: number;
61
+ }
62
+ export interface Reload {
63
+ id: number;
64
+ codeVersion: number;
65
+ orbs: KernelOrb[];
66
+ objects: number[];
67
+ providers: Record<string, number>;
68
+ }
69
+ export interface Effect {
70
+ type: EffectType;
71
+ scope?: number;
72
+ previous?: number | null;
73
+ resource?: number;
74
+ value?: number | null;
75
+ version?: number;
76
+ keepListeners?: boolean;
77
+ replacements?: { previous: number | null; next: number | null }[];
78
+ }
79
+ export interface Action {
80
+ type: ActionType;
81
+ id: number;
82
+ revision?: string;
83
+ effects?: Effect[];
84
+ payload?: number;
85
+ operation?: number;
86
+ error?: { code: Code; reason: string; message: string } | null;
87
+ }
88
+ export interface Diagnostics {
89
+ objects: number;
90
+ references: number;
91
+ roots: number;
92
+ calls: number;
93
+ resources: number;
94
+ tasks: number;
95
+ orbs: number;
96
+ closing: boolean;
97
+ codeVersion: number;
98
+ }
99
+
100
+ export class Kernel {
101
+ readonly features: KernelFeatures;
102
+
103
+ /** Read the capabilities of the supplied kernel binding. */
104
+ constructor(readonly port: KernelPort) {
105
+ this.features = this.command(KernelOp.Features);
106
+ }
107
+
108
+ /** Decode a kernel result or raise its structured error. */
109
+ command<T = null>(op: KernelOp, fields: Record<string, unknown> = {}): T {
110
+ const envelope = JSON.parse(this.port.request(JSON.stringify({ ...fields, op }))) as {
111
+ ok?: T;
112
+ error?: { code: Code; reason: string; message: string };
113
+ };
114
+ if (envelope.error) throw new TembraError(envelope.error);
115
+ return envelope.ok as T;
116
+ }
117
+ }
@@ -0,0 +1,193 @@
1
+ /** Closed adapter vocabulary. Strings are retained only as the wire representation. */
2
+ type ValueOf<T> = T[keyof T];
3
+
4
+ export const KernelOp = Object.freeze({
5
+ ContextDerive: "context-derive",
6
+ ContextValue: "context-value",
7
+ ContextStats: "context-stats",
8
+ Allocate: "allocate",
9
+ ScopeRegister: "scope-register",
10
+ ScopeExists: "scope-exists",
11
+ ScopesForOwner: "scopes-for-owner",
12
+ ScopesForOrb: "scopes-for-orb",
13
+ ScopeAddResource: "scope-add-resource",
14
+ ScopeActivate: "scope-activate",
15
+ ScopesCleanup: "scopes-cleanup",
16
+ ScopesReloadRegistered: "scopes-reload-registered",
17
+ ScopesReload: "scopes-reload",
18
+ ProgramRun: "program-run",
19
+ ProgramNext: "program-next",
20
+ ProgramCompleteStep: "program-complete-step",
21
+ ProgramCommit: "program-commit",
22
+ ProgramAbort: "program-abort",
23
+ ProgramForget: "program-forget",
24
+ Features: "features",
25
+ Prepare: "prepare",
26
+ Gate: "gate",
27
+ GateOrbs: "gate-orbs",
28
+ Commit: "commit",
29
+ Abort: "abort",
30
+ Orbs: "orbs",
31
+ Orb: "orb",
32
+ OrbNamed: "orb-named",
33
+ NextDeadline: "next-deadline",
34
+ Address: "address",
35
+ Acquire: "acquire",
36
+ Ready: "ready",
37
+ Dependency: "dependency",
38
+ Undepend: "undepend",
39
+ Fail: "fail",
40
+ Status: "status",
41
+ Release: "release",
42
+ Forget: "forget",
43
+ Root: "root",
44
+ CleanupRoot: "cleanup-root",
45
+ RootPrincipal: "root-principal",
46
+ CheckContext: "check-context",
47
+ CheckRoot: "check-root",
48
+ EndRoot: "end-root",
49
+ CancelRoot: "cancel-root",
50
+ BeginCall: "begin-call",
51
+ BeginOperation: "begin-operation",
52
+ BeginHookObservation: "begin-hook-observation",
53
+ FinishCall: "finish-call",
54
+ Invocation: "invocation",
55
+ StateInit: "state-init",
56
+ Snapshot: "snapshot",
57
+ StateAdopt: "state-adopt",
58
+ Task: "task",
59
+ TaskRoot: "task-root",
60
+ StopTask: "stop-task",
61
+ FinishTask: "finish-task",
62
+ Resource: "resource",
63
+ ResourceOpened: "resource-opened",
64
+ ResourceValue: "resource-value",
65
+ CloseResource: "close-resource",
66
+ ResourceClosed: "resource-closed",
67
+ Disposed: "disposed",
68
+ Tick: "tick",
69
+ NextWake: "next-wake",
70
+ NextIdle: "next-idle",
71
+ Close: "close",
72
+ FinishClose: "finish-close",
73
+ Diagnostics: "diagnostics",
74
+ Drain: "drain",
75
+ Restrict: "restrict",
76
+ Contribute: "contribute",
77
+ ContributionOrdinal: "contribution-ordinal",
78
+ HookPlan: "hook-plan",
79
+ Listen: "listen",
80
+ Subscribe: "subscribe",
81
+ Enqueue: "enqueue",
82
+ NextDelivery: "next-delivery",
83
+ FinishDelivery: "finish-delivery",
84
+ Unsubscribe: "unsubscribe",
85
+ } as const);
86
+ export type KernelOp = ValueOf<typeof KernelOp>;
87
+
88
+ export const ActionType = Object.freeze({
89
+ Execute: "execute",
90
+ CancelEffects: "cancel-effects",
91
+ ProgramPrepared: "program-prepared",
92
+ ProgramComplete: "program-complete",
93
+ Dispose: "dispose",
94
+ CloseResource: "close-resource",
95
+ DropValue: "drop-value",
96
+ CancelRoot: "cancel-root",
97
+ CancelTask: "cancel-task",
98
+ RetireOrb: "retire-orb",
99
+ State: "state",
100
+ SubscriptionFailed: "subscription-failed",
101
+ DetachSubscription: "detach-subscription",
102
+ Deliver: "deliver",
103
+ } as const);
104
+ export type ActionType = ValueOf<typeof ActionType>;
105
+
106
+ export const EffectType = Object.freeze({
107
+ Stop: "stop",
108
+ Open: "open",
109
+ Close: "close",
110
+ Restore: "restore",
111
+ Prepare: "prepare",
112
+ Validate: "validate",
113
+ Initialize: "initialize",
114
+ Migrate: "migrate",
115
+ Adopt: "adopt",
116
+ Start: "start",
117
+ Drop: "drop",
118
+ } as const);
119
+ export type EffectType = ValueOf<typeof EffectType>;
120
+
121
+ export const StepType = Object.freeze({
122
+ Execute: "execute",
123
+ Wait: "wait",
124
+ Prepared: "prepared",
125
+ Complete: "complete",
126
+ Failed: "failed",
127
+ } as const);
128
+ export type StepType = ValueOf<typeof StepType>;
129
+
130
+ export const NativeOp = Object.freeze({
131
+ Activate: "activate",
132
+ Dispose: "dispose",
133
+ CancelEffect: "cancel-effect",
134
+ Effect: "effect",
135
+ Invoke: "invoke",
136
+ Contribute: "contribute",
137
+ } as const);
138
+ export type NativeOp = ValueOf<typeof NativeOp>;
139
+
140
+ export const RpcOp = Object.freeze({
141
+ Describe: "describe",
142
+ Get: "get",
143
+ Release: "release",
144
+ Call: "call",
145
+ Cancel: "cancel",
146
+ } as const);
147
+ export type RpcOp = ValueOf<typeof RpcOp>;
148
+
149
+ export const RpcEvent = Object.freeze({
150
+ State: "state",
151
+ } as const);
152
+ export type RpcEvent = ValueOf<typeof RpcEvent>;
153
+
154
+ export const OwnerKind = Object.freeze({
155
+ Host: "host",
156
+ Orb: "orb",
157
+ Object: "object",
158
+ } as const);
159
+ export type OwnerKind = ValueOf<typeof OwnerKind>;
160
+
161
+ export const EnvironmentPhase = Object.freeze({
162
+ Declaring: "declaring",
163
+ Prepared: "prepared",
164
+ Live: "live",
165
+ Closed: "closed",
166
+ } as const);
167
+ export type EnvironmentPhase = ValueOf<typeof EnvironmentPhase>;
168
+
169
+ export const CoordinationDecision = Object.freeze({
170
+ Preparing: "preparing",
171
+ Commit: "commit",
172
+ Abort: "abort",
173
+ } as const);
174
+ export type CoordinationDecision = ValueOf<typeof CoordinationDecision>;
175
+
176
+ export const Outcome = Object.freeze({
177
+ Ok: "ok",
178
+ Error: "error",
179
+ } as const);
180
+ export type Outcome = ValueOf<typeof Outcome>;
181
+
182
+ export const CodecTag = Object.freeze({
183
+ Bigint: "bigint",
184
+ Bytes: "bytes",
185
+ Object: "object",
186
+ } as const);
187
+ export type CodecTag = ValueOf<typeof CodecTag>;
188
+
189
+ export const CodecId = Object.freeze({
190
+ Json: "tembra-json/1",
191
+ MessagePack: "tembra-msgpack/1",
192
+ } as const);
193
+ export type CodecId = ValueOf<typeof CodecId>;
package/src/browser.ts ADDED
@@ -0,0 +1,59 @@
1
+ import { orb } from "./authoring/orb.ts";
2
+ import type { HostOptions } from "./authoring/types.ts";
3
+ import type { KernelPort } from "./bridge/kernel.ts";
4
+ import { Host } from "./host.ts";
5
+
6
+ export interface WasmModule {
7
+ WasmKernel: new () => KernelPort;
8
+ default?: (input?: unknown) => Promise<unknown>;
9
+ }
10
+ export type BrowserHostOptions = Omit<HostOptions, "kernel"> & {
11
+ kernel?: KernelPort;
12
+ wasm?: WasmModule | (() => Promise<WasmModule>);
13
+ wasmInput?: unknown;
14
+ baseURL?: string | URL;
15
+ };
16
+
17
+ /** Runs orbs in the browser or Worker's existing JS realm; WASM owns only kernel metadata. */
18
+ export async function createHost(options: BrowserHostOptions = {}): Promise<Host> {
19
+ let kernel = options.kernel;
20
+ if (!kernel) {
21
+ const supplied = options.wasm;
22
+ const module =
23
+ typeof supplied === "function"
24
+ ? await supplied()
25
+ : (supplied ?? ((await import("@syntropika/tembra-engine-wasm")) as WasmModule));
26
+ await module.default?.(options.wasmInput);
27
+ kernel = new module.WasmKernel();
28
+ }
29
+ return new Host({
30
+ ...options,
31
+ kernel,
32
+ load:
33
+ options.load ??
34
+ (async (location) => {
35
+ const base = options.baseURL ?? globalThis.location?.href;
36
+ const url =
37
+ location instanceof URL ? location : base ? new URL(location, base) : new URL(location);
38
+ return orb(
39
+ (await import(url.href)).default as import("./authoring/types.ts").OrbDefinition,
40
+ );
41
+ }),
42
+ });
43
+ }
44
+
45
+ export { orb };
46
+ export type { Host };
47
+
48
+ export {
49
+ Code,
50
+ HookCapability,
51
+ Lifetime,
52
+ Reason,
53
+ ReloadStatus,
54
+ Status,
55
+ } from "./bridge/identifiers.ts";
56
+
57
+ export { Errors, type ErrorDescriptor } from "./errors.ts";
58
+
59
+ export { ContextKey, ContextKind, opaqueFrom, type OpaqueContextValue } from "./context-key.ts";
package/src/codec.ts ADDED
@@ -0,0 +1 @@
1
+ export * from "./codecs/json.ts";