@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.
- package/README.md +43 -17
- package/dist/authoring/types.d.ts +64 -3
- package/dist/authoring/wit.d.ts +6 -0
- package/dist/bridge/commands.d.ts +1190 -0
- package/dist/bridge/identifiers.d.ts +2 -0
- package/dist/bridge/kernel.d.ts +18 -107
- package/dist/bridge/protocol.d.ts +3 -138
- package/dist/browser.d.ts +14 -1
- package/dist/browser.js +141 -3298
- package/dist/chunks/browser-b8jamxw2.js +3399 -0
- package/dist/chunks/execution-nsqc6nrt.js +1419 -0
- package/dist/chunks/index-01zk0xqx.js +160 -0
- package/dist/chunks/index-3fjdfdfd.js +152 -0
- package/dist/chunks/index-aaymjn7v.js +787 -0
- package/dist/chunks/index-c1w7z9hx.js +356 -0
- package/dist/chunks/index-h8t0n42q.js +738 -0
- package/dist/chunks/index-hfds9mzp.js +308 -0
- package/dist/chunks/index-kr4x67wt.js +177 -0
- package/dist/chunks/index-kr6bnh34.js +117 -0
- package/dist/chunks/index-kyt9dj0a.js +1421 -0
- package/dist/chunks/index-n1wxzc9w.js +830 -0
- package/dist/chunks/index-pvac426d.js +74 -0
- package/dist/chunks/index-smyds5ce.js +3234 -0
- package/dist/chunks/index-sse8aapb.js +121 -0
- package/dist/chunks/index-v6heph77.js +643 -0
- package/dist/chunks/index-xrdvnv37.js +3448 -0
- package/dist/chunks/index-za4mg94e.js +26 -0
- package/dist/chunks/index-zkqmnjj8.js +167 -0
- package/dist/coordinator.js +9 -500
- package/dist/error.d.ts +2 -0
- package/dist/errors.d.ts +3 -0
- package/dist/guest.d.ts +173 -0
- package/dist/guest.js +26 -0
- package/dist/host.d.ts +36 -30
- package/dist/host.js +37 -3276
- package/dist/http/bytes.d.ts +8 -0
- package/dist/http/events.d.ts +7 -0
- package/dist/http.d.ts +45 -0
- package/dist/http.js +291 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +49 -862
- package/dist/infrastructure/rpc/client.d.ts +2 -1
- package/dist/infrastructure/rpc/resources.d.ts +28 -0
- package/dist/interpreter/abi.d.ts +54 -0
- package/dist/interpreter/acquire.d.ts +18 -0
- package/dist/interpreter/browser-network.d.ts +52 -0
- package/dist/interpreter/browser-port.d.ts +55 -0
- package/dist/interpreter/browser.d.ts +79 -0
- package/dist/interpreter/cli.d.ts +5 -0
- package/dist/interpreter/codec.d.ts +42 -0
- package/dist/interpreter/component/execution.d.ts +42 -0
- package/dist/interpreter/component/host.d.ts +69 -0
- package/dist/interpreter/component/instance.d.ts +40 -0
- package/dist/interpreter/component/kernel.d.ts +120 -0
- package/dist/interpreter/component/names.d.ts +5 -0
- package/dist/interpreter/component/port.d.ts +85 -0
- package/dist/interpreter/component/prepared.d.ts +97 -0
- package/dist/interpreter/component/resources.d.ts +45 -0
- package/dist/interpreter/component/revision.d.ts +87 -0
- package/dist/interpreter/component/scope.d.ts +116 -0
- package/dist/interpreter/component/streams.d.ts +28 -0
- package/dist/interpreter/component/values.d.ts +79 -0
- package/dist/interpreter/component/wasi-filesystem.d.ts +21 -0
- package/dist/interpreter/component/wasi-host.d.ts +64 -0
- package/dist/interpreter/component/wasi-http.d.ts +33 -0
- package/dist/interpreter/component/wasi-sockets.d.ts +183 -0
- package/dist/interpreter/component/wasi.d.ts +41 -0
- package/dist/interpreter/core.d.ts +64 -0
- package/dist/interpreter/fetch-http-provider.d.ts +17 -0
- package/dist/interpreter/filesystem/contract.d.ts +85 -0
- package/dist/interpreter/filesystem/memory.d.ts +3 -0
- package/dist/interpreter/filesystem/opfs.d.ts +3 -0
- package/dist/interpreter/filesystem/scope.d.ts +35 -0
- package/dist/interpreter/filesystem.d.ts +8 -0
- package/dist/interpreter/gate.d.ts +6 -0
- package/dist/interpreter/host-protocol.d.ts +100 -0
- package/dist/interpreter/http-ingress-fetch.d.ts +7 -0
- package/dist/interpreter/http-ingress.d.ts +96 -0
- package/dist/interpreter/http-provider.d.ts +85 -0
- package/dist/interpreter/io.d.ts +20 -0
- package/dist/interpreter/mobile.d.ts +149 -0
- package/dist/interpreter/native-ingress.d.ts +95 -0
- package/dist/interpreter/node-port.d.ts +25 -0
- package/dist/interpreter/node.d.ts +36 -0
- package/dist/interpreter/revision.d.ts +64 -0
- package/dist/interpreter/scope.d.ts +89 -0
- package/dist/interpreter/socket-addresses.d.ts +50 -0
- package/dist/interpreter/socket-provider.d.ts +110 -0
- package/dist/interpreter/standard-cli.d.ts +34 -0
- package/dist/interpreter/standard-codec.d.ts +96 -0
- package/dist/interpreter/standard-filesystem.d.ts +47 -0
- package/dist/interpreter/standard-host.d.ts +71 -0
- package/dist/interpreter/standard-http-values.d.ts +159 -0
- package/dist/interpreter/standard-http.d.ts +9 -0
- package/dist/interpreter/standard-ingress.d.ts +63 -0
- package/dist/interpreter/standard-sockets.d.ts +177 -0
- package/dist/interpreter/standard-streams.d.ts +218 -0
- package/dist/interpreter/standard-system.d.ts +35 -0
- package/dist/interpreter/standard-utf8.d.ts +4 -0
- package/dist/interpreter/standard.d.ts +18 -0
- package/dist/interpreter/types.d.ts +152 -0
- package/dist/interpreter/wit-shape.d.ts +92 -0
- package/dist/manager.js +5 -332
- package/dist/msgpack.js +9 -615
- package/dist/node.d.ts +8 -1
- package/dist/node.js +248 -3287
- package/dist/rpc.js +196 -699
- package/dist/runtime/adapters.d.ts +120 -0
- package/dist/runtime/adapters.js +38 -0
- package/dist/runtime/calls.d.ts +9 -3
- package/dist/runtime/lifecycle.d.ts +3 -1
- package/dist/runtime/orbs.d.ts +5 -4
- package/dist/runtime/references.d.ts +27 -1
- package/dist/runtime/reload.d.ts +5 -3
- package/dist/runtime/scopes.d.ts +1 -1
- package/dist/runtime/signals.d.ts +4 -0
- package/dist/runtime/wit-client.d.ts +38 -0
- package/dist/telemetry.js +4 -25
- package/dist/tooling/build.d.ts +2 -2
- package/dist/tooling/client-resources.d.ts +23 -0
- package/dist/tooling/client.d.ts +10 -0
- package/dist/tooling/component-glue.d.ts +17 -0
- package/dist/tooling/component.d.ts +11 -0
- package/dist/tooling/index.d.ts +3 -1
- package/dist/tooling/index.js +1155 -102
- package/dist/tooling/resolver.d.ts +4 -4
- package/dist/tooling/typecheck.d.ts +2 -1
- package/dist/tooling/types.d.ts +27 -12
- package/dist/tooling/wit.d.ts +9 -0
- package/dist/wasi/wasi-clocks-types.d.ts +2 -0
- package/dist/wasi/wasi-http-client.d.ts +5 -0
- package/dist/wasi/wasi-http-types.d.ts +285 -0
- package/dist/wasi/wasi-sockets-ip-name-lookup.d.ts +23 -0
- package/dist/wasi/wasi-sockets-types.d.ts +146 -0
- package/package.json +62 -35
- package/src/authoring/declaration.ts +1 -1
- package/src/authoring/types.ts +53 -3
- package/src/authoring/wit.ts +15 -0
- package/src/bridge/commands.ts +1105 -0
- package/src/bridge/identifiers.ts +2 -0
- package/src/bridge/kernel.ts +56 -98
- package/src/bridge/protocol.ts +3 -142
- package/src/browser.ts +90 -6
- package/src/context-key.ts +4 -7
- package/src/error.ts +1 -1
- package/src/errors.ts +7 -0
- package/src/guest.ts +327 -0
- package/src/host.ts +128 -23
- package/src/http/bytes.ts +87 -0
- package/src/http/events.ts +34 -0
- package/src/http.ts +272 -0
- package/src/index.ts +3 -0
- package/src/infrastructure/rpc/client.ts +136 -17
- package/src/infrastructure/rpc/resources.ts +123 -0
- package/src/interpreter/abi.ts +69 -0
- package/src/interpreter/acquire.ts +58 -0
- package/src/interpreter/browser-network.ts +170 -0
- package/src/interpreter/browser-port.ts +425 -0
- package/src/interpreter/browser.ts +340 -0
- package/src/interpreter/cli.ts +30 -0
- package/src/interpreter/codec.ts +298 -0
- package/src/interpreter/component/execution.ts +264 -0
- package/src/interpreter/component/host.ts +409 -0
- package/src/interpreter/component/instance.ts +138 -0
- package/src/interpreter/component/kernel.ts +611 -0
- package/src/interpreter/component/names.ts +13 -0
- package/src/interpreter/component/port.ts +598 -0
- package/src/interpreter/component/prepared.ts +194 -0
- package/src/interpreter/component/resources.ts +345 -0
- package/src/interpreter/component/revision.ts +702 -0
- package/src/interpreter/component/scope.ts +447 -0
- package/src/interpreter/component/streams.ts +180 -0
- package/src/interpreter/component/values.ts +254 -0
- package/src/interpreter/component/wasi-filesystem.ts +472 -0
- package/src/interpreter/component/wasi-host.ts +197 -0
- package/src/interpreter/component/wasi-http.ts +939 -0
- package/src/interpreter/component/wasi-sockets.ts +958 -0
- package/src/interpreter/component/wasi.ts +238 -0
- package/src/interpreter/core.ts +386 -0
- package/src/interpreter/fetch-http-provider.ts +98 -0
- package/src/interpreter/filesystem/contract.ts +138 -0
- package/src/interpreter/filesystem/memory.ts +180 -0
- package/src/interpreter/filesystem/opfs.ts +294 -0
- package/src/interpreter/filesystem/scope.ts +390 -0
- package/src/interpreter/filesystem.ts +20 -0
- package/src/interpreter/gate.ts +55 -0
- package/src/interpreter/host-protocol.ts +242 -0
- package/src/interpreter/http-ingress-fetch.ts +133 -0
- package/src/interpreter/http-ingress.ts +203 -0
- package/src/interpreter/http-provider.ts +105 -0
- package/src/interpreter/io.ts +66 -0
- package/src/interpreter/mobile.ts +385 -0
- package/src/interpreter/native-ingress.ts +550 -0
- package/src/interpreter/node-port.ts +218 -0
- package/src/interpreter/node.ts +114 -0
- package/src/interpreter/revision.ts +450 -0
- package/src/interpreter/scope.ts +453 -0
- package/src/interpreter/socket-addresses.ts +246 -0
- package/src/interpreter/socket-provider.ts +126 -0
- package/src/interpreter/standard-cli.ts +184 -0
- package/src/interpreter/standard-codec.ts +403 -0
- package/src/interpreter/standard-filesystem.ts +545 -0
- package/src/interpreter/standard-host.ts +840 -0
- package/src/interpreter/standard-http-values.ts +624 -0
- package/src/interpreter/standard-http.ts +622 -0
- package/src/interpreter/standard-ingress.ts +344 -0
- package/src/interpreter/standard-sockets.ts +847 -0
- package/src/interpreter/standard-streams.ts +710 -0
- package/src/interpreter/standard-system.ts +182 -0
- package/src/interpreter/standard-utf8.ts +72 -0
- package/src/interpreter/standard.ts +283 -0
- package/src/interpreter/types.ts +163 -0
- package/src/interpreter/wit-shape.ts +175 -0
- package/src/node.ts +43 -14
- package/src/runtime/activities.ts +6 -6
- package/src/runtime/adapters.ts +314 -0
- package/src/runtime/calls.ts +218 -56
- package/src/runtime/context.ts +7 -7
- package/src/runtime/lifecycle.ts +36 -17
- package/src/runtime/orbs.ts +81 -39
- package/src/runtime/programs.ts +16 -8
- package/src/runtime/references.ts +128 -11
- package/src/runtime/reload.ts +71 -30
- package/src/runtime/resources.ts +2 -2
- package/src/runtime/scopes.ts +17 -17
- package/src/runtime/session.ts +3 -1
- package/src/runtime/signals.ts +31 -0
- package/src/runtime/wit-client.ts +228 -0
- package/src/tooling/build.ts +152 -54
- package/src/tooling/client-resources.ts +74 -0
- package/src/tooling/client.ts +531 -0
- package/src/tooling/component-glue.ts +288 -0
- package/src/tooling/component.ts +225 -0
- package/src/tooling/index.ts +3 -7
- package/src/tooling/resolver.ts +42 -25
- package/src/tooling/typecheck.ts +59 -4
- package/src/tooling/types.ts +27 -12
- package/src/tooling/wit.ts +188 -0
- package/dist/embedded.d.ts +0 -1
- package/dist/embedded.js +0 -1
- package/src/embedded.ts +0 -293
|
@@ -0,0 +1,1105 @@
|
|
|
1
|
+
// Generated from crates/bridge/src/{commands,protocol,wire}. Do not edit.
|
|
2
|
+
// Regenerate with: TEMBRA_BLESS=1 cargo test -p tembra-bridge --test typescript
|
|
3
|
+
import type { Code, Lifetime, Status } from "./identifiers.ts";
|
|
4
|
+
|
|
5
|
+
type ValueOf<T> = T[keyof T];
|
|
6
|
+
|
|
7
|
+
export const KernelOp = Object.freeze({
|
|
8
|
+
ContextDerive: "context-derive",
|
|
9
|
+
ContextValue: "context-value",
|
|
10
|
+
ContextStats: "context-stats",
|
|
11
|
+
Allocate: "allocate",
|
|
12
|
+
ScopeRegister: "scope-register",
|
|
13
|
+
ScopeExists: "scope-exists",
|
|
14
|
+
ScopesForOwner: "scopes-for-owner",
|
|
15
|
+
ScopesForOrb: "scopes-for-orb",
|
|
16
|
+
ScopeAddResource: "scope-add-resource",
|
|
17
|
+
ScopeActivate: "scope-activate",
|
|
18
|
+
ScopesCleanup: "scopes-cleanup",
|
|
19
|
+
ScopesReloadRegistered: "scopes-reload-registered",
|
|
20
|
+
ScopesReload: "scopes-reload",
|
|
21
|
+
ProgramRun: "program-run",
|
|
22
|
+
ProgramNext: "program-next",
|
|
23
|
+
ProgramCompleteStep: "program-complete-step",
|
|
24
|
+
ProgramCommit: "program-commit",
|
|
25
|
+
ProgramAbort: "program-abort",
|
|
26
|
+
ProgramForget: "program-forget",
|
|
27
|
+
Features: "features",
|
|
28
|
+
Prepare: "prepare",
|
|
29
|
+
Gate: "gate",
|
|
30
|
+
GateOrbs: "gate-orbs",
|
|
31
|
+
Commit: "commit",
|
|
32
|
+
Abort: "abort",
|
|
33
|
+
Orbs: "orbs",
|
|
34
|
+
Orb: "orb",
|
|
35
|
+
OrbNamed: "orb-named",
|
|
36
|
+
NextDeadline: "next-deadline",
|
|
37
|
+
Address: "address",
|
|
38
|
+
Acquire: "acquire",
|
|
39
|
+
Ready: "ready",
|
|
40
|
+
Dependency: "dependency",
|
|
41
|
+
Undepend: "undepend",
|
|
42
|
+
Fail: "fail",
|
|
43
|
+
Status: "status",
|
|
44
|
+
Duplicate: "duplicate",
|
|
45
|
+
Release: "release",
|
|
46
|
+
Forget: "forget",
|
|
47
|
+
Root: "root",
|
|
48
|
+
CleanupRoot: "cleanup-root",
|
|
49
|
+
RootPrincipal: "root-principal",
|
|
50
|
+
EnterExecution: "enter-execution",
|
|
51
|
+
CheckContext: "check-context",
|
|
52
|
+
CheckRoot: "check-root",
|
|
53
|
+
EndRoot: "end-root",
|
|
54
|
+
EndRootBatch: "end-root-batch",
|
|
55
|
+
CancelRoot: "cancel-root",
|
|
56
|
+
BeginCall: "begin-call",
|
|
57
|
+
AdmitCall: "admit-call",
|
|
58
|
+
BeginOperation: "begin-operation",
|
|
59
|
+
BeginHookObservation: "begin-hook-observation",
|
|
60
|
+
FinishCall: "finish-call",
|
|
61
|
+
FinishCallBatch: "finish-call-batch",
|
|
62
|
+
Invocation: "invocation",
|
|
63
|
+
StateInit: "state-init",
|
|
64
|
+
Snapshot: "snapshot",
|
|
65
|
+
StateAdopt: "state-adopt",
|
|
66
|
+
Task: "task",
|
|
67
|
+
TaskRoot: "task-root",
|
|
68
|
+
StopTask: "stop-task",
|
|
69
|
+
FinishTask: "finish-task",
|
|
70
|
+
Resource: "resource",
|
|
71
|
+
ResourceOpened: "resource-opened",
|
|
72
|
+
ResourceValue: "resource-value",
|
|
73
|
+
CloseResource: "close-resource",
|
|
74
|
+
ResourceClosed: "resource-closed",
|
|
75
|
+
Disposed: "disposed",
|
|
76
|
+
Tick: "tick",
|
|
77
|
+
NextWake: "next-wake",
|
|
78
|
+
NextIdle: "next-idle",
|
|
79
|
+
Close: "close",
|
|
80
|
+
FinishClose: "finish-close",
|
|
81
|
+
Diagnostics: "diagnostics",
|
|
82
|
+
Drain: "drain",
|
|
83
|
+
Restrict: "restrict",
|
|
84
|
+
ContributionOrdinal: "contribution-ordinal",
|
|
85
|
+
Contribute: "contribute",
|
|
86
|
+
HookPlan: "hook-plan",
|
|
87
|
+
Listen: "listen",
|
|
88
|
+
Subscribe: "subscribe",
|
|
89
|
+
Enqueue: "enqueue",
|
|
90
|
+
NextDelivery: "next-delivery",
|
|
91
|
+
FinishDelivery: "finish-delivery",
|
|
92
|
+
Unsubscribe: "unsubscribe",
|
|
93
|
+
} as const);
|
|
94
|
+
export type KernelOp = ValueOf<typeof KernelOp>;
|
|
95
|
+
|
|
96
|
+
export const NativeOp = Object.freeze({
|
|
97
|
+
Activate: "activate",
|
|
98
|
+
Dispose: "dispose",
|
|
99
|
+
CancelEffect: "cancel-effect",
|
|
100
|
+
Effect: "effect",
|
|
101
|
+
Invoke: "invoke",
|
|
102
|
+
Contribute: "contribute",
|
|
103
|
+
} as const);
|
|
104
|
+
export type NativeOp = ValueOf<typeof NativeOp>;
|
|
105
|
+
|
|
106
|
+
export const OwnerKind = Object.freeze({
|
|
107
|
+
Host: "host",
|
|
108
|
+
Orb: "orb",
|
|
109
|
+
Object: "object",
|
|
110
|
+
} as const);
|
|
111
|
+
export type OwnerKind = ValueOf<typeof OwnerKind>;
|
|
112
|
+
|
|
113
|
+
export const ActionType = Object.freeze({
|
|
114
|
+
Execute: "execute",
|
|
115
|
+
CancelEffects: "cancel-effects",
|
|
116
|
+
ProgramPrepared: "program-prepared",
|
|
117
|
+
ProgramComplete: "program-complete",
|
|
118
|
+
Dispose: "dispose",
|
|
119
|
+
CloseResource: "close-resource",
|
|
120
|
+
DropValue: "drop-value",
|
|
121
|
+
CancelRoot: "cancel-root",
|
|
122
|
+
CancelCall: "cancel-call",
|
|
123
|
+
CancelTask: "cancel-task",
|
|
124
|
+
RetireOrb: "retire-orb",
|
|
125
|
+
State: "state",
|
|
126
|
+
SubscriptionFailed: "subscription-failed",
|
|
127
|
+
DetachSubscription: "detach-subscription",
|
|
128
|
+
Deliver: "deliver",
|
|
129
|
+
} as const);
|
|
130
|
+
export type ActionType = ValueOf<typeof ActionType>;
|
|
131
|
+
|
|
132
|
+
export const EffectType = Object.freeze({
|
|
133
|
+
Stop: "stop",
|
|
134
|
+
Open: "open",
|
|
135
|
+
Close: "close",
|
|
136
|
+
Restore: "restore",
|
|
137
|
+
Prepare: "prepare",
|
|
138
|
+
Validate: "validate",
|
|
139
|
+
Initialize: "initialize",
|
|
140
|
+
Migrate: "migrate",
|
|
141
|
+
Adopt: "adopt",
|
|
142
|
+
Start: "start",
|
|
143
|
+
Drop: "drop",
|
|
144
|
+
} as const);
|
|
145
|
+
export type EffectType = ValueOf<typeof EffectType>;
|
|
146
|
+
|
|
147
|
+
export const StepType = Object.freeze({
|
|
148
|
+
Execute: "execute",
|
|
149
|
+
Wait: "wait",
|
|
150
|
+
Prepared: "prepared",
|
|
151
|
+
Complete: "complete",
|
|
152
|
+
Failed: "failed",
|
|
153
|
+
} as const);
|
|
154
|
+
export type StepType = ValueOf<typeof StepType>;
|
|
155
|
+
|
|
156
|
+
export interface Features {
|
|
157
|
+
hooks: boolean;
|
|
158
|
+
subscriptions: boolean;
|
|
159
|
+
views: boolean;
|
|
160
|
+
telemetry: boolean;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
export interface ContextStats {
|
|
164
|
+
live: number;
|
|
165
|
+
peak: number;
|
|
166
|
+
keys: number;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
export interface ContextEntryText {
|
|
170
|
+
kind: "text";
|
|
171
|
+
value: string;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
export interface ContextEntryInteger {
|
|
175
|
+
kind: "integer";
|
|
176
|
+
value: number;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
export interface ContextEntryBoolean {
|
|
180
|
+
kind: "boolean";
|
|
181
|
+
value: boolean;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
export interface ContextEntryOpaque {
|
|
185
|
+
kind: "opaque";
|
|
186
|
+
source: number;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
export type ContextEntry =
|
|
190
|
+
| ContextEntryText
|
|
191
|
+
| ContextEntryInteger
|
|
192
|
+
| ContextEntryBoolean
|
|
193
|
+
| ContextEntryOpaque;
|
|
194
|
+
|
|
195
|
+
export interface KernelError {
|
|
196
|
+
code: Code;
|
|
197
|
+
reason: string;
|
|
198
|
+
message: string;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
export interface ServiceInfo {
|
|
202
|
+
name: string;
|
|
203
|
+
methods: string[];
|
|
204
|
+
signature: string | null;
|
|
205
|
+
lifetime: Lifetime;
|
|
206
|
+
linger: number;
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
export interface RequirementInfo {
|
|
210
|
+
orb: string;
|
|
211
|
+
apiVersion: number;
|
|
212
|
+
services: Record<string, string[]>;
|
|
213
|
+
signatures: Record<string, string>;
|
|
214
|
+
hooks: string[];
|
|
215
|
+
hookSignatures: Record<string, string>;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
export interface KernelOrb {
|
|
219
|
+
id: number;
|
|
220
|
+
owner: number;
|
|
221
|
+
codeVersion: number;
|
|
222
|
+
name: string;
|
|
223
|
+
apiVersion: number;
|
|
224
|
+
services: ServiceInfo[];
|
|
225
|
+
hooks: string[];
|
|
226
|
+
hookSignatures: Record<string, string>;
|
|
227
|
+
requires: RequirementInfo[];
|
|
228
|
+
isolated: boolean;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
export interface Reload {
|
|
232
|
+
id: number;
|
|
233
|
+
codeVersion: number;
|
|
234
|
+
orbs: KernelOrb[];
|
|
235
|
+
objects: number[];
|
|
236
|
+
providers: Record<string, number>;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
export interface AddressInfo {
|
|
240
|
+
service: string;
|
|
241
|
+
key: string[];
|
|
242
|
+
principal: string;
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
export interface Acquisition {
|
|
246
|
+
reference: number;
|
|
247
|
+
object: number;
|
|
248
|
+
orb: number;
|
|
249
|
+
codeVersion: number;
|
|
250
|
+
activate: boolean;
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
export interface Invocation {
|
|
254
|
+
id: number;
|
|
255
|
+
root: number;
|
|
256
|
+
object: number;
|
|
257
|
+
orb: number;
|
|
258
|
+
codeVersion: number;
|
|
259
|
+
method: string;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
export interface HookObservation {
|
|
263
|
+
invocation: Invocation;
|
|
264
|
+
plan: number[];
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
export interface Snapshot {
|
|
268
|
+
value: number;
|
|
269
|
+
revision: string;
|
|
270
|
+
version: number;
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
export interface ResourceClaim {
|
|
274
|
+
id: number;
|
|
275
|
+
value: number | null;
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
export interface Diagnostics {
|
|
279
|
+
objects: number;
|
|
280
|
+
references: number;
|
|
281
|
+
roots: number;
|
|
282
|
+
calls: number;
|
|
283
|
+
resources: number;
|
|
284
|
+
tasks: number;
|
|
285
|
+
orbs: number;
|
|
286
|
+
closing: boolean;
|
|
287
|
+
codeVersion: number;
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
export interface Replacement {
|
|
291
|
+
previous: number | null;
|
|
292
|
+
next: number | null;
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
export interface EffectStop {
|
|
296
|
+
type: "stop";
|
|
297
|
+
scope: number;
|
|
298
|
+
keepListeners: boolean;
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
export interface EffectOpen {
|
|
302
|
+
type: "open";
|
|
303
|
+
resource: number;
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
export interface EffectClose {
|
|
307
|
+
type: "close";
|
|
308
|
+
resource: number;
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
export interface EffectRestore {
|
|
312
|
+
type: "restore";
|
|
313
|
+
previous: number;
|
|
314
|
+
resource: number;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
export interface EffectPrepare {
|
|
318
|
+
type: "prepare";
|
|
319
|
+
scope: number;
|
|
320
|
+
previous: number | null;
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
export interface EffectValidate {
|
|
324
|
+
type: "validate";
|
|
325
|
+
scope: number;
|
|
326
|
+
value: number;
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
export interface EffectInitialize {
|
|
330
|
+
type: "initialize";
|
|
331
|
+
scope: number;
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
export interface EffectMigrate {
|
|
335
|
+
type: "migrate";
|
|
336
|
+
scope: number;
|
|
337
|
+
value: number | null;
|
|
338
|
+
version: number;
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
export interface EffectAdopt {
|
|
342
|
+
type: "adopt";
|
|
343
|
+
replacements: Replacement[];
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
export interface EffectStart {
|
|
347
|
+
type: "start";
|
|
348
|
+
scope: number;
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
export interface EffectDrop {
|
|
352
|
+
type: "drop";
|
|
353
|
+
scope: number;
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
export type Effect =
|
|
357
|
+
| EffectStop
|
|
358
|
+
| EffectOpen
|
|
359
|
+
| EffectClose
|
|
360
|
+
| EffectRestore
|
|
361
|
+
| EffectPrepare
|
|
362
|
+
| EffectValidate
|
|
363
|
+
| EffectInitialize
|
|
364
|
+
| EffectMigrate
|
|
365
|
+
| EffectAdopt
|
|
366
|
+
| EffectStart
|
|
367
|
+
| EffectDrop;
|
|
368
|
+
|
|
369
|
+
export interface ActionExecute {
|
|
370
|
+
type: "execute";
|
|
371
|
+
id: number;
|
|
372
|
+
effects: Effect[];
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
export interface ActionCancelEffects {
|
|
376
|
+
type: "cancel-effects";
|
|
377
|
+
id: number;
|
|
378
|
+
effects: Effect[];
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
export interface ActionProgramPrepared {
|
|
382
|
+
type: "program-prepared";
|
|
383
|
+
id: number;
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
export interface ActionProgramComplete {
|
|
387
|
+
type: "program-complete";
|
|
388
|
+
id: number;
|
|
389
|
+
error: KernelError | null;
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
export interface ActionDispose {
|
|
393
|
+
type: "dispose";
|
|
394
|
+
id: number;
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
export interface ActionCloseResource {
|
|
398
|
+
type: "close-resource";
|
|
399
|
+
id: number;
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
export interface ActionDropValue {
|
|
403
|
+
type: "drop-value";
|
|
404
|
+
id: number;
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
export interface ActionCancelRoot {
|
|
408
|
+
type: "cancel-root";
|
|
409
|
+
id: number;
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
export interface ActionCancelCall {
|
|
413
|
+
type: "cancel-call";
|
|
414
|
+
id: number;
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
export interface ActionCancelTask {
|
|
418
|
+
type: "cancel-task";
|
|
419
|
+
id: number;
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
export interface ActionRetireOrb {
|
|
423
|
+
type: "retire-orb";
|
|
424
|
+
id: number;
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
export interface ActionState {
|
|
428
|
+
type: "state";
|
|
429
|
+
id: number;
|
|
430
|
+
revision: string;
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
export interface ActionSubscriptionFailed {
|
|
434
|
+
type: "subscription-failed";
|
|
435
|
+
id: number;
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
export interface ActionDetachSubscription {
|
|
439
|
+
type: "detach-subscription";
|
|
440
|
+
id: number;
|
|
441
|
+
}
|
|
442
|
+
|
|
443
|
+
export interface ActionDeliver {
|
|
444
|
+
type: "deliver";
|
|
445
|
+
id: number;
|
|
446
|
+
payload: number;
|
|
447
|
+
operation: number;
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
export type Action =
|
|
451
|
+
| ActionExecute
|
|
452
|
+
| ActionCancelEffects
|
|
453
|
+
| ActionProgramPrepared
|
|
454
|
+
| ActionProgramComplete
|
|
455
|
+
| ActionDispose
|
|
456
|
+
| ActionCloseResource
|
|
457
|
+
| ActionDropValue
|
|
458
|
+
| ActionCancelRoot
|
|
459
|
+
| ActionCancelCall
|
|
460
|
+
| ActionCancelTask
|
|
461
|
+
| ActionRetireOrb
|
|
462
|
+
| ActionState
|
|
463
|
+
| ActionSubscriptionFailed
|
|
464
|
+
| ActionDetachSubscription
|
|
465
|
+
| ActionDeliver;
|
|
466
|
+
|
|
467
|
+
export interface StepExecute {
|
|
468
|
+
type: "execute";
|
|
469
|
+
effects: Effect[];
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
export interface StepWait {
|
|
473
|
+
type: "wait";
|
|
474
|
+
deadline: string | null;
|
|
475
|
+
}
|
|
476
|
+
|
|
477
|
+
export interface StepPrepared {
|
|
478
|
+
type: "prepared";
|
|
479
|
+
}
|
|
480
|
+
|
|
481
|
+
export interface StepComplete {
|
|
482
|
+
type: "complete";
|
|
483
|
+
}
|
|
484
|
+
|
|
485
|
+
export interface StepFailed {
|
|
486
|
+
type: "failed";
|
|
487
|
+
error: KernelError;
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
export type Step = StepExecute | StepWait | StepPrepared | StepComplete | StepFailed;
|
|
491
|
+
|
|
492
|
+
export interface CallSettlement {
|
|
493
|
+
actions: Action[];
|
|
494
|
+
deadline: number | null;
|
|
495
|
+
}
|
|
496
|
+
|
|
497
|
+
export type Owner = { kind: "host" } | { kind: "orb" | "object"; id: number };
|
|
498
|
+
|
|
499
|
+
export interface ContextKeyInput {
|
|
500
|
+
name: string;
|
|
501
|
+
version: number;
|
|
502
|
+
kind: "text" | "integer" | "boolean" | "opaque";
|
|
503
|
+
}
|
|
504
|
+
|
|
505
|
+
export interface ServiceDeclaration {
|
|
506
|
+
name: string;
|
|
507
|
+
methods: readonly string[];
|
|
508
|
+
signature?: string | null | undefined;
|
|
509
|
+
lifetime?: Lifetime | null | undefined;
|
|
510
|
+
linger?: number | null | undefined;
|
|
511
|
+
}
|
|
512
|
+
|
|
513
|
+
export interface RequirementDeclaration {
|
|
514
|
+
orb: string;
|
|
515
|
+
apiVersion: number;
|
|
516
|
+
services?: Readonly<Record<string, readonly string[]>> | null | undefined;
|
|
517
|
+
signatures?: Readonly<Record<string, string>> | null | undefined;
|
|
518
|
+
hooks?: readonly string[] | null | undefined;
|
|
519
|
+
hookSignatures?: Readonly<Record<string, string>> | null | undefined;
|
|
520
|
+
}
|
|
521
|
+
|
|
522
|
+
export interface OrbDeclaration {
|
|
523
|
+
name: string;
|
|
524
|
+
apiVersion: number;
|
|
525
|
+
services: readonly ServiceDeclaration[];
|
|
526
|
+
requires?: readonly RequirementDeclaration[] | null | undefined;
|
|
527
|
+
hooks?: readonly string[] | null | undefined;
|
|
528
|
+
hookSignatures?: Readonly<Record<string, string>> | null | undefined;
|
|
529
|
+
isolated?: boolean | null | undefined;
|
|
530
|
+
}
|
|
531
|
+
|
|
532
|
+
export interface MigrationInput {
|
|
533
|
+
object: number;
|
|
534
|
+
revision: number | string;
|
|
535
|
+
value: number;
|
|
536
|
+
version: number;
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
export interface ReplacementInput {
|
|
540
|
+
previous?: number | null | undefined;
|
|
541
|
+
next?: number | null | undefined;
|
|
542
|
+
}
|
|
543
|
+
|
|
544
|
+
export interface ErrorInput {
|
|
545
|
+
code: Code;
|
|
546
|
+
reason: string;
|
|
547
|
+
message: string;
|
|
548
|
+
}
|
|
549
|
+
|
|
550
|
+
export interface CompletionInput {
|
|
551
|
+
value?: number | null | undefined;
|
|
552
|
+
error?: ErrorInput | null | undefined;
|
|
553
|
+
}
|
|
554
|
+
|
|
555
|
+
/** Commands without input fields. */
|
|
556
|
+
export type EmptyInput = Record<string, never>;
|
|
557
|
+
|
|
558
|
+
/** Derive a child context frame carrying a typed scalar or an owner-issued reference. */
|
|
559
|
+
export interface ContextDeriveInput {
|
|
560
|
+
root: number;
|
|
561
|
+
context?: number | null | undefined;
|
|
562
|
+
call?: number | null | undefined;
|
|
563
|
+
key: ContextKeyInput;
|
|
564
|
+
value?: string | number | boolean | null | undefined;
|
|
565
|
+
source?: number | null | undefined;
|
|
566
|
+
}
|
|
567
|
+
|
|
568
|
+
/** Read the nearest binding of a typed context key. */
|
|
569
|
+
export interface ContextValueInput {
|
|
570
|
+
root: number;
|
|
571
|
+
context?: number | null | undefined;
|
|
572
|
+
call?: number | null | undefined;
|
|
573
|
+
key: ContextKeyInput;
|
|
574
|
+
}
|
|
575
|
+
|
|
576
|
+
/** Describe a declared scope to the lifecycle engine. */
|
|
577
|
+
export interface ScopeRegisterInput {
|
|
578
|
+
scope: number;
|
|
579
|
+
owner: Owner;
|
|
580
|
+
orb: number;
|
|
581
|
+
parents?: readonly number[] | null | undefined;
|
|
582
|
+
dependencies?: readonly number[] | null | undefined;
|
|
583
|
+
resources?: readonly number[] | null | undefined;
|
|
584
|
+
stateVersion?: number | null | undefined;
|
|
585
|
+
migrate?: boolean | null | undefined;
|
|
586
|
+
}
|
|
587
|
+
|
|
588
|
+
/** Report whether a scope is registered. */
|
|
589
|
+
export interface ScopeExistsInput {
|
|
590
|
+
scope: number;
|
|
591
|
+
}
|
|
592
|
+
|
|
593
|
+
/** List scopes owned by the host, an orb or an object. */
|
|
594
|
+
export interface ScopesForOwnerInput {
|
|
595
|
+
owner: Owner;
|
|
596
|
+
}
|
|
597
|
+
|
|
598
|
+
/** List scopes of one orb version. */
|
|
599
|
+
export interface ScopesForOrbInput {
|
|
600
|
+
orb: number;
|
|
601
|
+
}
|
|
602
|
+
|
|
603
|
+
/** Attach a resource to a registered scope. */
|
|
604
|
+
export interface ScopeAddResourceInput {
|
|
605
|
+
scope: number;
|
|
606
|
+
resource: number;
|
|
607
|
+
}
|
|
608
|
+
|
|
609
|
+
/** Start the activation program of a registered scope. */
|
|
610
|
+
export interface ScopeActivateInput {
|
|
611
|
+
scope: number;
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
/** Start a cleanup program for scopes. */
|
|
615
|
+
export interface ScopesCleanupInput {
|
|
616
|
+
scopes: readonly number[];
|
|
617
|
+
object?: number | null | undefined;
|
|
618
|
+
}
|
|
619
|
+
|
|
620
|
+
/** Reload every registered candidate scope of a prepared ticket. */
|
|
621
|
+
export interface ScopesReloadRegisteredInput {
|
|
622
|
+
ticket: number;
|
|
623
|
+
deadline: number | string;
|
|
624
|
+
now?: number | string | null | undefined;
|
|
625
|
+
}
|
|
626
|
+
|
|
627
|
+
/** Reload explicit previous/next scope pairs of a prepared ticket. */
|
|
628
|
+
export interface ScopesReloadInput {
|
|
629
|
+
ticket: number;
|
|
630
|
+
deadline: number | string;
|
|
631
|
+
now?: number | string | null | undefined;
|
|
632
|
+
replacements: readonly ReplacementInput[];
|
|
633
|
+
}
|
|
634
|
+
|
|
635
|
+
/** Start a prepared lifecycle program. */
|
|
636
|
+
export interface ProgramRunInput {
|
|
637
|
+
program: number;
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
/** Read a program's next step without executing callbacks. */
|
|
641
|
+
export interface ProgramNextInput {
|
|
642
|
+
program: number;
|
|
643
|
+
}
|
|
644
|
+
|
|
645
|
+
/** Acknowledge the physical settlement of every effect in the current step. */
|
|
646
|
+
export interface ProgramCompleteStepInput {
|
|
647
|
+
program: number;
|
|
648
|
+
results: readonly CompletionInput[];
|
|
649
|
+
}
|
|
650
|
+
|
|
651
|
+
/** Commit a prepared reload program. */
|
|
652
|
+
export interface ProgramCommitInput {
|
|
653
|
+
program: number;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
/** Abort a reload program. */
|
|
657
|
+
export interface ProgramAbortInput {
|
|
658
|
+
program: number;
|
|
659
|
+
}
|
|
660
|
+
|
|
661
|
+
/** Forget a settled program. */
|
|
662
|
+
export interface ProgramForgetInput {
|
|
663
|
+
program: number;
|
|
664
|
+
}
|
|
665
|
+
|
|
666
|
+
/** Prepare orb contracts as a reload candidate. */
|
|
667
|
+
export interface PrepareInput {
|
|
668
|
+
orbs: readonly OrbDeclaration[];
|
|
669
|
+
remove?: readonly string[] | null | undefined;
|
|
670
|
+
}
|
|
671
|
+
|
|
672
|
+
/** Gate candidate objects of a prepared ticket. */
|
|
673
|
+
export interface GateInput {
|
|
674
|
+
ticket: number;
|
|
675
|
+
objects: readonly number[];
|
|
676
|
+
}
|
|
677
|
+
|
|
678
|
+
/** Gate candidate orb owners of a prepared ticket. */
|
|
679
|
+
export interface GateOrbsInput {
|
|
680
|
+
ticket: number;
|
|
681
|
+
owners: readonly number[];
|
|
682
|
+
}
|
|
683
|
+
|
|
684
|
+
/** Commit a prepared ticket and its state migrations. */
|
|
685
|
+
export interface CommitInput {
|
|
686
|
+
ticket: number;
|
|
687
|
+
migrations?: readonly MigrationInput[] | null | undefined;
|
|
688
|
+
}
|
|
689
|
+
|
|
690
|
+
/** Abort a prepared ticket. */
|
|
691
|
+
export interface AbortInput {
|
|
692
|
+
ticket: number;
|
|
693
|
+
}
|
|
694
|
+
|
|
695
|
+
/** Describe one installed orb version. */
|
|
696
|
+
export interface OrbInput {
|
|
697
|
+
id: number;
|
|
698
|
+
}
|
|
699
|
+
|
|
700
|
+
/** Find an installed orb, or a candidate of a prepared ticket, by name. */
|
|
701
|
+
export interface OrbNamedInput {
|
|
702
|
+
name: string;
|
|
703
|
+
ticket?: number | null | undefined;
|
|
704
|
+
}
|
|
705
|
+
|
|
706
|
+
/** Read a managed object's address. */
|
|
707
|
+
export interface AddressInput {
|
|
708
|
+
object: number;
|
|
709
|
+
}
|
|
710
|
+
|
|
711
|
+
/** Claim a reference to a managed object. */
|
|
712
|
+
export interface AcquireInput {
|
|
713
|
+
service: string;
|
|
714
|
+
key: readonly string[];
|
|
715
|
+
principal: string;
|
|
716
|
+
apiVersion?: number | null | undefined;
|
|
717
|
+
methods?: readonly string[] | null | undefined;
|
|
718
|
+
}
|
|
719
|
+
|
|
720
|
+
/** Mark an activated object live. */
|
|
721
|
+
export interface ReadyInput {
|
|
722
|
+
object: number;
|
|
723
|
+
}
|
|
724
|
+
|
|
725
|
+
/** Record that an object depends on a reference. */
|
|
726
|
+
export interface DependencyInput {
|
|
727
|
+
object: number;
|
|
728
|
+
reference: number;
|
|
729
|
+
}
|
|
730
|
+
|
|
731
|
+
/** Detach an object's dependency. */
|
|
732
|
+
export interface UndependInput {
|
|
733
|
+
object: number;
|
|
734
|
+
reference: number;
|
|
735
|
+
}
|
|
736
|
+
|
|
737
|
+
/** Mark an object's activation as failed. */
|
|
738
|
+
export interface FailInput {
|
|
739
|
+
object: number;
|
|
740
|
+
}
|
|
741
|
+
|
|
742
|
+
/** Read a reference's status. */
|
|
743
|
+
export interface StatusInput {
|
|
744
|
+
reference: number;
|
|
745
|
+
}
|
|
746
|
+
|
|
747
|
+
/** Duplicate a claim with exactly its existing authority and API expectation. */
|
|
748
|
+
export interface DuplicateInput {
|
|
749
|
+
reference: number;
|
|
750
|
+
}
|
|
751
|
+
|
|
752
|
+
/** Release a reference claim. */
|
|
753
|
+
export interface ReleaseInput {
|
|
754
|
+
reference: number;
|
|
755
|
+
}
|
|
756
|
+
|
|
757
|
+
/** Forget a released reference. */
|
|
758
|
+
export interface ForgetInput {
|
|
759
|
+
reference: number;
|
|
760
|
+
}
|
|
761
|
+
|
|
762
|
+
/** Begin a root for a principal. */
|
|
763
|
+
export interface RootInput {
|
|
764
|
+
principal: string;
|
|
765
|
+
}
|
|
766
|
+
|
|
767
|
+
/** Begin a cleanup root for a principal. */
|
|
768
|
+
export interface CleanupRootInput {
|
|
769
|
+
principal: string;
|
|
770
|
+
}
|
|
771
|
+
|
|
772
|
+
/** Read a root's principal. */
|
|
773
|
+
export interface RootPrincipalInput {
|
|
774
|
+
root: number;
|
|
775
|
+
}
|
|
776
|
+
|
|
777
|
+
/** Enter the invocation's isolated heap under its retained private execution ancestry. */
|
|
778
|
+
export interface EnterExecutionInput {
|
|
779
|
+
call: number;
|
|
780
|
+
context?: number | null | undefined;
|
|
781
|
+
}
|
|
782
|
+
|
|
783
|
+
/** Recheck a root and, when supplied, that an invocation belongs to it. */
|
|
784
|
+
export interface CheckContextInput {
|
|
785
|
+
root: number;
|
|
786
|
+
call?: number | null | undefined;
|
|
787
|
+
}
|
|
788
|
+
|
|
789
|
+
/** Reject a cancelled or ended root. */
|
|
790
|
+
export interface CheckRootInput {
|
|
791
|
+
root: number;
|
|
792
|
+
}
|
|
793
|
+
|
|
794
|
+
/** End a root. */
|
|
795
|
+
export interface EndRootInput {
|
|
796
|
+
root: number;
|
|
797
|
+
}
|
|
798
|
+
|
|
799
|
+
/** End logical root admission and return all resulting cleanup metadata in one exchange. */
|
|
800
|
+
export interface EndRootBatchInput {
|
|
801
|
+
root: number;
|
|
802
|
+
}
|
|
803
|
+
|
|
804
|
+
/** Cancel a root. */
|
|
805
|
+
export interface CancelRootInput {
|
|
806
|
+
root: number;
|
|
807
|
+
}
|
|
808
|
+
|
|
809
|
+
/** Admit a service call through a reference. */
|
|
810
|
+
export interface BeginCallInput {
|
|
811
|
+
reference: number;
|
|
812
|
+
root: number;
|
|
813
|
+
method: string;
|
|
814
|
+
context?: number | null | undefined;
|
|
815
|
+
}
|
|
816
|
+
|
|
817
|
+
/** Recheck the caller's context, then admit a service call, in one bounded exchange. */
|
|
818
|
+
export interface AdmitCallInput {
|
|
819
|
+
reference: number;
|
|
820
|
+
root: number;
|
|
821
|
+
parent?: number | null | undefined;
|
|
822
|
+
method: string;
|
|
823
|
+
context?: number | null | undefined;
|
|
824
|
+
}
|
|
825
|
+
|
|
826
|
+
/** Admit an owner-bound callback operation. */
|
|
827
|
+
export interface BeginOperationInput {
|
|
828
|
+
orb: number;
|
|
829
|
+
root: number;
|
|
830
|
+
operation: number;
|
|
831
|
+
object?: number | null | undefined;
|
|
832
|
+
context?: number | null | undefined;
|
|
833
|
+
}
|
|
834
|
+
|
|
835
|
+
/** Admit the single owner-bound observation of a terminal hook. */
|
|
836
|
+
export interface BeginHookObservationInput {
|
|
837
|
+
source: number;
|
|
838
|
+
orb: number;
|
|
839
|
+
operation: number;
|
|
840
|
+
object?: number | null | undefined;
|
|
841
|
+
hook: string;
|
|
842
|
+
}
|
|
843
|
+
|
|
844
|
+
/** Finish a physical call. */
|
|
845
|
+
export interface FinishCallInput {
|
|
846
|
+
call: number;
|
|
847
|
+
}
|
|
848
|
+
|
|
849
|
+
/** Tick, finish a physical call, drain its actions and read the next deadline in one exchange. */
|
|
850
|
+
export interface FinishCallBatchInput {
|
|
851
|
+
call: number;
|
|
852
|
+
now: number | string;
|
|
853
|
+
}
|
|
854
|
+
|
|
855
|
+
/** Describe an admitted call. */
|
|
856
|
+
export interface InvocationInput {
|
|
857
|
+
call: number;
|
|
858
|
+
}
|
|
859
|
+
|
|
860
|
+
/** Initialize an object's state. */
|
|
861
|
+
export interface StateInitInput {
|
|
862
|
+
object: number;
|
|
863
|
+
value: number;
|
|
864
|
+
version: number;
|
|
865
|
+
}
|
|
866
|
+
|
|
867
|
+
/** Read an object's state metadata. */
|
|
868
|
+
export interface SnapshotInput {
|
|
869
|
+
object: number;
|
|
870
|
+
}
|
|
871
|
+
|
|
872
|
+
/** Adopt a new state value when the expected revision still matches. */
|
|
873
|
+
export interface StateAdoptInput {
|
|
874
|
+
call: number;
|
|
875
|
+
object: number;
|
|
876
|
+
revision: number | string;
|
|
877
|
+
value: number;
|
|
878
|
+
}
|
|
879
|
+
|
|
880
|
+
/** Begin a background task. */
|
|
881
|
+
export interface TaskInput {
|
|
882
|
+
owner: Owner;
|
|
883
|
+
}
|
|
884
|
+
|
|
885
|
+
/** Begin a root for a task. */
|
|
886
|
+
export interface TaskRootInput {
|
|
887
|
+
task: number;
|
|
888
|
+
principal: string;
|
|
889
|
+
}
|
|
890
|
+
|
|
891
|
+
/** Request that a task stop. */
|
|
892
|
+
export interface StopTaskInput {
|
|
893
|
+
task: number;
|
|
894
|
+
}
|
|
895
|
+
|
|
896
|
+
/** Finish a task. */
|
|
897
|
+
export interface FinishTaskInput {
|
|
898
|
+
task: number;
|
|
899
|
+
}
|
|
900
|
+
|
|
901
|
+
/** Claim a named resource. */
|
|
902
|
+
export interface ResourceInput {
|
|
903
|
+
owner: Owner;
|
|
904
|
+
name: string;
|
|
905
|
+
version: number;
|
|
906
|
+
exclusive?: boolean | null | undefined;
|
|
907
|
+
dependencies?: readonly number[] | null | undefined;
|
|
908
|
+
}
|
|
909
|
+
|
|
910
|
+
/** Record a resource's opened value. */
|
|
911
|
+
export interface ResourceOpenedInput {
|
|
912
|
+
resource: number;
|
|
913
|
+
value: number;
|
|
914
|
+
}
|
|
915
|
+
|
|
916
|
+
/** Read a resource's opened value. */
|
|
917
|
+
export interface ResourceValueInput {
|
|
918
|
+
resource: number;
|
|
919
|
+
}
|
|
920
|
+
|
|
921
|
+
/** Request a resource close before an optional version. */
|
|
922
|
+
export interface CloseResourceInput {
|
|
923
|
+
resource: number;
|
|
924
|
+
before?: number | null | undefined;
|
|
925
|
+
}
|
|
926
|
+
|
|
927
|
+
/** Record that a resource closed. */
|
|
928
|
+
export interface ResourceClosedInput {
|
|
929
|
+
resource: number;
|
|
930
|
+
}
|
|
931
|
+
|
|
932
|
+
/** Record that an object was disposed. */
|
|
933
|
+
export interface DisposedInput {
|
|
934
|
+
object: number;
|
|
935
|
+
}
|
|
936
|
+
|
|
937
|
+
/** Advance host-relative monotonic time. */
|
|
938
|
+
export interface TickInput {
|
|
939
|
+
now: number | string;
|
|
940
|
+
}
|
|
941
|
+
|
|
942
|
+
/** Restrict the methods a reference may call. */
|
|
943
|
+
export interface RestrictInput {
|
|
944
|
+
reference: number;
|
|
945
|
+
methods: readonly string[];
|
|
946
|
+
}
|
|
947
|
+
|
|
948
|
+
/** Register a hook contribution. */
|
|
949
|
+
export interface ContributeInput {
|
|
950
|
+
orb: number;
|
|
951
|
+
target: string;
|
|
952
|
+
hook: string;
|
|
953
|
+
operation: number;
|
|
954
|
+
priority?: number | null | undefined;
|
|
955
|
+
ordinal: number;
|
|
956
|
+
}
|
|
957
|
+
|
|
958
|
+
/** Read the admitted contribution plan of a hook. */
|
|
959
|
+
export interface HookPlanInput {
|
|
960
|
+
root: number;
|
|
961
|
+
target: string;
|
|
962
|
+
hook: string;
|
|
963
|
+
}
|
|
964
|
+
|
|
965
|
+
/** Connect a scope listener to a source. */
|
|
966
|
+
export interface ListenInput {
|
|
967
|
+
scope: number;
|
|
968
|
+
previous?: number | null | undefined;
|
|
969
|
+
name: string;
|
|
970
|
+
source: number;
|
|
971
|
+
sizing?: number | null | undefined;
|
|
972
|
+
operation: number;
|
|
973
|
+
maxPending: number;
|
|
974
|
+
maxBytes?: number | null | undefined;
|
|
975
|
+
coalesce?: boolean | null | undefined;
|
|
976
|
+
}
|
|
977
|
+
|
|
978
|
+
/** Subscribe an owner to a source. */
|
|
979
|
+
export interface SubscribeInput {
|
|
980
|
+
owner: Owner;
|
|
981
|
+
source: number;
|
|
982
|
+
operation: number;
|
|
983
|
+
maxPending: number;
|
|
984
|
+
maxBytes?: number | null | undefined;
|
|
985
|
+
coalesce?: boolean | null | undefined;
|
|
986
|
+
}
|
|
987
|
+
|
|
988
|
+
/** Queue a delivery. */
|
|
989
|
+
export interface EnqueueInput {
|
|
990
|
+
subscription: number;
|
|
991
|
+
payload: number;
|
|
992
|
+
bytes?: number | null | undefined;
|
|
993
|
+
}
|
|
994
|
+
|
|
995
|
+
/** Take the next queued delivery payload. */
|
|
996
|
+
export interface NextDeliveryInput {
|
|
997
|
+
subscription: number;
|
|
998
|
+
}
|
|
999
|
+
|
|
1000
|
+
/** Finish the current delivery. */
|
|
1001
|
+
export interface FinishDeliveryInput {
|
|
1002
|
+
subscription: number;
|
|
1003
|
+
}
|
|
1004
|
+
|
|
1005
|
+
/** Remove a subscription. */
|
|
1006
|
+
export interface UnsubscribeInput {
|
|
1007
|
+
subscription: number;
|
|
1008
|
+
}
|
|
1009
|
+
|
|
1010
|
+
/** Every kernel operation with its typed input and the result it determines. */
|
|
1011
|
+
export interface KernelCommands {
|
|
1012
|
+
"context-derive": { input: ContextDeriveInput; output: number };
|
|
1013
|
+
"context-value": { input: ContextValueInput; output: ContextEntry | null };
|
|
1014
|
+
"context-stats": { input: EmptyInput; output: ContextStats };
|
|
1015
|
+
allocate: { input: EmptyInput; output: number };
|
|
1016
|
+
"scope-register": { input: ScopeRegisterInput; output: null };
|
|
1017
|
+
"scope-exists": { input: ScopeExistsInput; output: boolean };
|
|
1018
|
+
"scopes-for-owner": { input: ScopesForOwnerInput; output: number[] };
|
|
1019
|
+
"scopes-for-orb": { input: ScopesForOrbInput; output: number[] };
|
|
1020
|
+
"scope-add-resource": { input: ScopeAddResourceInput; output: null };
|
|
1021
|
+
"scope-activate": { input: ScopeActivateInput; output: number };
|
|
1022
|
+
"scopes-cleanup": { input: ScopesCleanupInput; output: number };
|
|
1023
|
+
"scopes-reload-registered": { input: ScopesReloadRegisteredInput; output: number };
|
|
1024
|
+
"scopes-reload": { input: ScopesReloadInput; output: number };
|
|
1025
|
+
"program-run": { input: ProgramRunInput; output: null };
|
|
1026
|
+
"program-next": { input: ProgramNextInput; output: Step };
|
|
1027
|
+
"program-complete-step": { input: ProgramCompleteStepInput; output: null };
|
|
1028
|
+
"program-commit": { input: ProgramCommitInput; output: null };
|
|
1029
|
+
"program-abort": { input: ProgramAbortInput; output: null };
|
|
1030
|
+
"program-forget": { input: ProgramForgetInput; output: null };
|
|
1031
|
+
features: { input: EmptyInput; output: Features };
|
|
1032
|
+
prepare: { input: PrepareInput; output: Reload };
|
|
1033
|
+
gate: { input: GateInput; output: boolean };
|
|
1034
|
+
"gate-orbs": { input: GateOrbsInput; output: boolean };
|
|
1035
|
+
commit: { input: CommitInput; output: number };
|
|
1036
|
+
abort: { input: AbortInput; output: null };
|
|
1037
|
+
orbs: { input: EmptyInput; output: KernelOrb[] };
|
|
1038
|
+
orb: { input: OrbInput; output: KernelOrb };
|
|
1039
|
+
"orb-named": { input: OrbNamedInput; output: KernelOrb };
|
|
1040
|
+
"next-deadline": { input: EmptyInput; output: number | null };
|
|
1041
|
+
address: { input: AddressInput; output: AddressInfo };
|
|
1042
|
+
acquire: { input: AcquireInput; output: Acquisition };
|
|
1043
|
+
ready: { input: ReadyInput; output: null };
|
|
1044
|
+
dependency: { input: DependencyInput; output: null };
|
|
1045
|
+
undepend: { input: UndependInput; output: null };
|
|
1046
|
+
fail: { input: FailInput; output: null };
|
|
1047
|
+
status: { input: StatusInput; output: Status };
|
|
1048
|
+
duplicate: { input: DuplicateInput; output: number };
|
|
1049
|
+
release: { input: ReleaseInput; output: null };
|
|
1050
|
+
forget: { input: ForgetInput; output: null };
|
|
1051
|
+
root: { input: RootInput; output: number };
|
|
1052
|
+
"cleanup-root": { input: CleanupRootInput; output: number };
|
|
1053
|
+
"root-principal": { input: RootPrincipalInput; output: string };
|
|
1054
|
+
"enter-execution": { input: EnterExecutionInput; output: number };
|
|
1055
|
+
"check-context": { input: CheckContextInput; output: null };
|
|
1056
|
+
"check-root": { input: CheckRootInput; output: null };
|
|
1057
|
+
"end-root": { input: EndRootInput; output: null };
|
|
1058
|
+
"end-root-batch": { input: EndRootBatchInput; output: CallSettlement };
|
|
1059
|
+
"cancel-root": { input: CancelRootInput; output: null };
|
|
1060
|
+
"begin-call": { input: BeginCallInput; output: Invocation };
|
|
1061
|
+
"admit-call": { input: AdmitCallInput; output: Invocation };
|
|
1062
|
+
"begin-operation": { input: BeginOperationInput; output: Invocation };
|
|
1063
|
+
"begin-hook-observation": { input: BeginHookObservationInput; output: HookObservation };
|
|
1064
|
+
"finish-call": { input: FinishCallInput; output: null };
|
|
1065
|
+
"finish-call-batch": { input: FinishCallBatchInput; output: CallSettlement };
|
|
1066
|
+
invocation: { input: InvocationInput; output: Invocation };
|
|
1067
|
+
"state-init": { input: StateInitInput; output: Snapshot };
|
|
1068
|
+
snapshot: { input: SnapshotInput; output: Snapshot };
|
|
1069
|
+
"state-adopt": { input: StateAdoptInput; output: Snapshot };
|
|
1070
|
+
task: { input: TaskInput; output: number };
|
|
1071
|
+
"task-root": { input: TaskRootInput; output: number };
|
|
1072
|
+
"stop-task": { input: StopTaskInput; output: null };
|
|
1073
|
+
"finish-task": { input: FinishTaskInput; output: null };
|
|
1074
|
+
resource: { input: ResourceInput; output: ResourceClaim };
|
|
1075
|
+
"resource-opened": { input: ResourceOpenedInput; output: null };
|
|
1076
|
+
"resource-value": { input: ResourceValueInput; output: number };
|
|
1077
|
+
"close-resource": { input: CloseResourceInput; output: boolean };
|
|
1078
|
+
"resource-closed": { input: ResourceClosedInput; output: null };
|
|
1079
|
+
disposed: { input: DisposedInput; output: null };
|
|
1080
|
+
tick: { input: TickInput; output: null };
|
|
1081
|
+
"next-wake": { input: EmptyInput; output: number | null };
|
|
1082
|
+
"next-idle": { input: EmptyInput; output: number | null };
|
|
1083
|
+
close: { input: EmptyInput; output: null };
|
|
1084
|
+
"finish-close": { input: EmptyInput; output: null };
|
|
1085
|
+
diagnostics: { input: EmptyInput; output: Diagnostics };
|
|
1086
|
+
drain: { input: EmptyInput; output: Action[] };
|
|
1087
|
+
restrict: { input: RestrictInput; output: null };
|
|
1088
|
+
"contribution-ordinal": { input: EmptyInput; output: number };
|
|
1089
|
+
contribute: { input: ContributeInput; output: null };
|
|
1090
|
+
"hook-plan": { input: HookPlanInput; output: number[] };
|
|
1091
|
+
listen: { input: ListenInput; output: number };
|
|
1092
|
+
subscribe: { input: SubscribeInput; output: number };
|
|
1093
|
+
enqueue: { input: EnqueueInput; output: null };
|
|
1094
|
+
"next-delivery": { input: NextDeliveryInput; output: number | null };
|
|
1095
|
+
"finish-delivery": { input: FinishDeliveryInput; output: null };
|
|
1096
|
+
unsubscribe: { input: UnsubscribeInput; output: null };
|
|
1097
|
+
}
|
|
1098
|
+
|
|
1099
|
+
export type KernelInput<K extends KernelOp> = KernelCommands[K]["input"];
|
|
1100
|
+
export type KernelOutput<K extends KernelOp> = KernelCommands[K]["output"];
|
|
1101
|
+
|
|
1102
|
+
/** The structured result of one platform exchange. */
|
|
1103
|
+
export type KernelOutcome<T> =
|
|
1104
|
+
| { ok: T; error?: undefined }
|
|
1105
|
+
| { ok?: undefined; error: KernelError };
|