@inhuman.tools/plexus-expectations 0.0.0-stage → 0.1.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 (160) hide show
  1. package/LICENSE.md +7 -0
  2. package/README.md +144 -2
  3. package/dist/driver/ExpectationActor.d.ts +56 -0
  4. package/dist/driver/ExpectationActor.d.ts.map +1 -0
  5. package/dist/driver/ExpectationActor.js +210 -0
  6. package/dist/driver/ExpectationActor.js.map +1 -0
  7. package/dist/driver/PEWDriver.d.ts +144 -0
  8. package/dist/driver/PEWDriver.d.ts.map +1 -0
  9. package/dist/driver/PEWDriver.js +303 -0
  10. package/dist/driver/PEWDriver.js.map +1 -0
  11. package/dist/driver/PEWDriverConnection.d.ts +139 -0
  12. package/dist/driver/PEWDriverConnection.d.ts.map +1 -0
  13. package/dist/driver/PEWDriverConnection.js +298 -0
  14. package/dist/driver/PEWDriverConnection.js.map +1 -0
  15. package/dist/driver/actor-machine.d.ts +28 -0
  16. package/dist/driver/actor-machine.d.ts.map +1 -0
  17. package/dist/driver/actor-machine.js +50 -0
  18. package/dist/driver/actor-machine.js.map +1 -0
  19. package/dist/driver/connection-miss.d.ts +9 -0
  20. package/dist/driver/connection-miss.d.ts.map +1 -0
  21. package/dist/driver/connection-miss.js +13 -0
  22. package/dist/driver/connection-miss.js.map +1 -0
  23. package/dist/driver/index.d.ts +6 -0
  24. package/dist/driver/index.d.ts.map +1 -0
  25. package/dist/driver/index.js +5 -0
  26. package/dist/driver/index.js.map +1 -0
  27. package/dist/error-with-invariant.d.ts +9 -0
  28. package/dist/error-with-invariant.d.ts.map +1 -0
  29. package/dist/error-with-invariant.js +12 -0
  30. package/dist/error-with-invariant.js.map +1 -0
  31. package/dist/executor/index.d.ts +4 -0
  32. package/dist/executor/index.d.ts.map +1 -0
  33. package/dist/executor/index.js +4 -0
  34. package/dist/executor/index.js.map +1 -0
  35. package/dist/executor/kernel-intern.d.ts +16 -0
  36. package/dist/executor/kernel-intern.d.ts.map +1 -0
  37. package/dist/executor/kernel-intern.js +98 -0
  38. package/dist/executor/kernel-intern.js.map +1 -0
  39. package/dist/executor/orchestrator.d.ts +97 -0
  40. package/dist/executor/orchestrator.d.ts.map +1 -0
  41. package/dist/executor/orchestrator.js +465 -0
  42. package/dist/executor/orchestrator.js.map +1 -0
  43. package/dist/executor/types.d.ts +8 -0
  44. package/dist/executor/types.d.ts.map +1 -0
  45. package/dist/executor/types.js +2 -0
  46. package/dist/executor/types.js.map +1 -0
  47. package/dist/index.d.ts +2 -0
  48. package/dist/index.d.ts.map +1 -0
  49. package/dist/index.js +2 -0
  50. package/dist/index.js.map +1 -0
  51. package/dist/schemas/connection.d.ts +4 -0
  52. package/dist/schemas/connection.d.ts.map +1 -0
  53. package/dist/schemas/connection.js +4 -0
  54. package/dist/schemas/connection.js.map +1 -0
  55. package/dist/schemas/index.d.ts +2 -0
  56. package/dist/schemas/index.d.ts.map +1 -0
  57. package/dist/schemas/index.js +2 -0
  58. package/dist/schemas/index.js.map +1 -0
  59. package/dist/shared/attention.d.ts +27 -0
  60. package/dist/shared/attention.d.ts.map +1 -0
  61. package/dist/shared/attention.js +116 -0
  62. package/dist/shared/attention.js.map +1 -0
  63. package/dist/shared/control.d.ts +4 -0
  64. package/dist/shared/control.d.ts.map +1 -0
  65. package/dist/shared/control.js +2 -0
  66. package/dist/shared/control.js.map +1 -0
  67. package/dist/shared/index.d.ts +7 -0
  68. package/dist/shared/index.d.ts.map +1 -0
  69. package/dist/shared/index.js +7 -0
  70. package/dist/shared/index.js.map +1 -0
  71. package/dist/shared/map-field-awareness.d.ts +19 -0
  72. package/dist/shared/map-field-awareness.d.ts.map +1 -0
  73. package/dist/shared/map-field-awareness.js +58 -0
  74. package/dist/shared/map-field-awareness.js.map +1 -0
  75. package/dist/shared/models/ApprovableExpectation.d.ts +15 -0
  76. package/dist/shared/models/ApprovableExpectation.d.ts.map +1 -0
  77. package/dist/shared/models/ApprovableExpectation.js +138 -0
  78. package/dist/shared/models/ApprovableExpectation.js.map +1 -0
  79. package/dist/shared/models/ConnectionSpec.d.ts +44 -0
  80. package/dist/shared/models/ConnectionSpec.d.ts.map +1 -0
  81. package/dist/shared/models/ConnectionSpec.js +180 -0
  82. package/dist/shared/models/ConnectionSpec.js.map +1 -0
  83. package/dist/shared/models/DriverSpec.d.ts +45 -0
  84. package/dist/shared/models/DriverSpec.d.ts.map +1 -0
  85. package/dist/shared/models/DriverSpec.js +221 -0
  86. package/dist/shared/models/DriverSpec.js.map +1 -0
  87. package/dist/shared/models/IntrospectingPlexusModel.d.ts +8 -0
  88. package/dist/shared/models/IntrospectingPlexusModel.d.ts.map +1 -0
  89. package/dist/shared/models/IntrospectingPlexusModel.js +48 -0
  90. package/dist/shared/models/IntrospectingPlexusModel.js.map +1 -0
  91. package/dist/shared/models/Job.d.ts +85 -0
  92. package/dist/shared/models/Job.d.ts.map +1 -0
  93. package/dist/shared/models/Job.js +261 -0
  94. package/dist/shared/models/Job.js.map +1 -0
  95. package/dist/shared/models/ProgrammaticJob.d.ts +6 -0
  96. package/dist/shared/models/ProgrammaticJob.d.ts.map +1 -0
  97. package/dist/shared/models/ProgrammaticJob.js +80 -0
  98. package/dist/shared/models/ProgrammaticJob.js.map +1 -0
  99. package/dist/shared/models/WorkContainer.d.ts +36 -0
  100. package/dist/shared/models/WorkContainer.d.ts.map +1 -0
  101. package/dist/shared/models/WorkContainer.js +140 -0
  102. package/dist/shared/models/WorkContainer.js.map +1 -0
  103. package/dist/shared/models/WorkExpectation.d.ts +63 -0
  104. package/dist/shared/models/WorkExpectation.d.ts.map +1 -0
  105. package/dist/shared/models/WorkExpectation.js +290 -0
  106. package/dist/shared/models/WorkExpectation.js.map +1 -0
  107. package/dist/shared/models/WorkExpectationWithIntrospection.d.ts +4 -0
  108. package/dist/shared/models/WorkExpectationWithIntrospection.d.ts.map +1 -0
  109. package/dist/shared/models/WorkExpectationWithIntrospection.js +28 -0
  110. package/dist/shared/models/WorkExpectationWithIntrospection.js.map +1 -0
  111. package/dist/shared/models/index.d.ts +7 -0
  112. package/dist/shared/models/index.d.ts.map +1 -0
  113. package/dist/shared/models/index.js +6 -0
  114. package/dist/shared/models/index.js.map +1 -0
  115. package/dist/shared/models/jsonRecord.d.ts +14 -0
  116. package/dist/shared/models/jsonRecord.d.ts.map +1 -0
  117. package/dist/shared/models/jsonRecord.js +46 -0
  118. package/dist/shared/models/jsonRecord.js.map +1 -0
  119. package/dist/shared/resolution.d.ts +39 -0
  120. package/dist/shared/resolution.d.ts.map +1 -0
  121. package/dist/shared/resolution.js +124 -0
  122. package/dist/shared/resolution.js.map +1 -0
  123. package/dist/shared/revalidation-demand.d.ts +27 -0
  124. package/dist/shared/revalidation-demand.d.ts.map +1 -0
  125. package/dist/shared/revalidation-demand.js +116 -0
  126. package/dist/shared/revalidation-demand.js.map +1 -0
  127. package/dist/shared/role.d.ts +12 -0
  128. package/dist/shared/role.d.ts.map +1 -0
  129. package/dist/shared/role.js +21 -0
  130. package/dist/shared/role.js.map +1 -0
  131. package/dist/shared/types.d.ts +43 -0
  132. package/dist/shared/types.d.ts.map +1 -0
  133. package/dist/shared/types.js +12 -0
  134. package/dist/shared/types.js.map +1 -0
  135. package/package.json +79 -3
  136. package/src/driver/ExpectationActor.ts +244 -0
  137. package/src/driver/PEWDriver.ts +302 -0
  138. package/src/driver/actor-machine.ts +54 -0
  139. package/src/driver/connection-miss.ts +13 -0
  140. package/src/driver/index.ts +5 -0
  141. package/src/executor/index.ts +3 -0
  142. package/src/executor/kernel-intern.ts +121 -0
  143. package/src/executor/orchestrator.ts +463 -0
  144. package/src/executor/types.ts +3 -0
  145. package/src/index.ts +1 -0
  146. package/src/schemas/connection.ts +4 -0
  147. package/src/schemas/index.ts +1 -0
  148. package/src/shared/control.ts +4 -0
  149. package/src/shared/index.ts +6 -0
  150. package/src/shared/map-field-awareness.ts +65 -0
  151. package/src/shared/models/ConnectionSpec.ts +84 -0
  152. package/src/shared/models/DriverSpec.ts +102 -0
  153. package/src/shared/models/Job.ts +192 -0
  154. package/src/shared/models/WorkContainer.ts +90 -0
  155. package/src/shared/models/WorkExpectation.ts +229 -0
  156. package/src/shared/models/index.ts +6 -0
  157. package/src/shared/models/jsonRecord.ts +49 -0
  158. package/src/shared/revalidation-demand.ts +121 -0
  159. package/src/shared/role.ts +32 -0
  160. package/src/shared/types.ts +57 -0
@@ -0,0 +1,465 @@
1
+ var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
2
+ var useValue = arguments.length > 2;
3
+ for (var i = 0; i < initializers.length; i++) {
4
+ value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
5
+ }
6
+ return useValue ? value : void 0;
7
+ };
8
+ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
9
+ function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
10
+ var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
11
+ var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
12
+ var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
13
+ var _, done = false;
14
+ for (var i = decorators.length - 1; i >= 0; i--) {
15
+ var context = {};
16
+ for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
17
+ for (var p in contextIn.access) context.access[p] = contextIn.access[p];
18
+ context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
19
+ var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
20
+ if (kind === "accessor") {
21
+ if (result === void 0) continue;
22
+ if (result === null || typeof result !== "object") throw new TypeError("Object expected");
23
+ if (_ = accept(result.get)) descriptor.get = _;
24
+ if (_ = accept(result.set)) descriptor.set = _;
25
+ if (_ = accept(result.init)) initializers.unshift(_);
26
+ }
27
+ else if (_ = accept(result)) {
28
+ if (kind === "field") initializers.unshift(_);
29
+ else descriptor[key] = _;
30
+ }
31
+ }
32
+ if (target) Object.defineProperty(target, contextIn.name, descriptor);
33
+ done = true;
34
+ };
35
+ import { DefaultedMap } from "@here.build/collections";
36
+ import { action, autorun, comparer, computed, observable, reaction, toJS } from "mobx";
37
+ import invariant from "tiny-invariant";
38
+ import { acquireConnection, releaseConnection, } from "./kernel-intern.js";
39
+ import { extraLiveFromState, isDriverConnectionClass, } from "../driver/PEWDriver.js";
40
+ import { Job } from "../shared/models/Job.js";
41
+ import { WorkContainer, walkWork } from "../shared/models/WorkContainer.js";
42
+ import { WorkExpectation, isTreeOrphan } from "../shared/models/WorkExpectation.js";
43
+ /**
44
+ * Seam: session work graph → honor (PEW) and claim (Job).
45
+ *
46
+ * Honor is reachable PEW → handle. Unstarted cancel writes the durable
47
+ * ending here and must not poke `ensure` — MCP: an unstarted tool must not
48
+ * spin the server. Do not call `Actor.complete` — unstarted Work has no
49
+ * Actor. `handle` is not the sealer. License is phase 1 on an Approvable
50
+ * leaf. A sealed parent is not honored (the
51
+ * child is already ending in the agentic runtime, or must not start).
52
+ *
53
+ * INTERN TABLE IS NOT AN ATOM. `#connections` is a plain Map of kernel-interned
54
+ * instances (one live driver per kernel connection id). Honor re-enters by
55
+ * reading catalog `spec.readyState` and, once minted, `instance.readyState`.
56
+ * `handle` only when `ready`.
57
+ *
58
+ * A rejected ensure/load memo IS the sticky failure (no hot loop).
59
+ *
60
+ * Honor and Job claim do not start in the constructor. PEW autorun used to
61
+ * run during `super()`, so a readiness Promise after construct was not a
62
+ * gate. Call {@link activate} after replicas are pinned and recovery ran.
63
+ *
64
+ * Import discipline: this module does not import harness or the session document.
65
+ */
66
+ let Orchestrator = (() => {
67
+ let _instanceExtraInitializers = [];
68
+ let _get_reachableJobs_decorators;
69
+ return class Orchestrator {
70
+ static {
71
+ const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
72
+ __esDecorate(this, null, _get_reachableJobs_decorators, { kind: "getter", name: "reachableJobs", static: false, private: false, access: { has: obj => "reachableJobs" in obj, get: obj => obj.reachableJobs }, metadata: _metadata }, null, _instanceExtraInitializers);
73
+ if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
74
+ }
75
+ kernel = __runInitializers(this, _instanceExtraInitializers);
76
+ session;
77
+ #disposed = false;
78
+ #admissionStopped = false;
79
+ #activated = observable.box(false);
80
+ #disposeWork;
81
+ /** Disposed with the orchestrator — a dead session must not keep writing the live kernel catalog. */
82
+ #mirrorDisposers = [];
83
+ #processes = new Map();
84
+ /** Execute (phase 2) — started BODY. */
85
+ #jobAbort = new Map();
86
+ /** In-flight license (phase 1). */
87
+ #guardAbort = new Map();
88
+ /**
89
+ * Process-local: execute already claimed this job. Survives seal:false
90
+ * so the starter does not re-run BODY. A new Orchestrator is empty —
91
+ * bootstrap `orchestrated && !completed` runs execute once more.
92
+ */
93
+ #bodyStarted = new WeakSet();
94
+ /**
95
+ * Origin-dispatched PEW skip. Lives here, not on the session subclass:
96
+ * honor used to run during `super()`, and subclass fields are unassigned
97
+ * then (JS). A child WeakSet made `shouldHonor` throw `undefined.has`.
98
+ */
99
+ originCompletions = new WeakSet();
100
+ #disposeAborts;
101
+ constructor(kernel, session) {
102
+ this.kernel = kernel;
103
+ this.session = session;
104
+ this.#mirrorDisposers.push(autorun(() => {
105
+ if (this.#disposed || !this.#activated.get())
106
+ return;
107
+ for (const name of Object.keys(this.drivers)) {
108
+ // Driver discovery is intentionally eager so the kernel catalog can
109
+ // expose class-side offers and live facts before a connection is
110
+ // ensured. A session may not be able to load every driver in a
111
+ // shared kernel, so consume a rejected discovery promise here; the
112
+ // driver spec already carries the failure for interested readers.
113
+ void this.#classes.get(name).catch(() => { });
114
+ }
115
+ }));
116
+ this.#disposeWork = autorun(() => {
117
+ if (this.#disposed || !this.#activated.get())
118
+ return;
119
+ for (const node of collectReachable(this.session.root)) {
120
+ if (node.isDone || isTreeOrphan(node))
121
+ continue;
122
+ if (!this.shouldHonor(node))
123
+ continue;
124
+ const spec = this.connections[node.connectionId];
125
+ if (spec === undefined)
126
+ continue;
127
+ void spec.readyState;
128
+ const instance = this.#connections.get(node.connectionId);
129
+ if (instance !== undefined) {
130
+ if (instance.readyState === "ready")
131
+ instance.handle(node);
132
+ continue;
133
+ }
134
+ invariant(Object.hasOwn(this.connections, node.connectionId), `unknown connection ${node.connectionId}`);
135
+ void this.ensure(node.connectionId);
136
+ }
137
+ });
138
+ this.#disposeAborts = autorun(() => {
139
+ if (this.#disposed || !this.#activated.get())
140
+ return;
141
+ const live = new Set(this.reachableJobs);
142
+ for (const [job, ac] of this.#jobAbort) {
143
+ if (live.has(job) || ac.signal.aborted)
144
+ continue;
145
+ ac.abort();
146
+ }
147
+ for (const [job, ac] of this.#guardAbort) {
148
+ if (live.has(job) || ac.signal.aborted)
149
+ continue;
150
+ ac.abort();
151
+ }
152
+ });
153
+ }
154
+ get reachableJobs() {
155
+ const root = this.session.root;
156
+ const jobs = new Set();
157
+ if (root instanceof Job)
158
+ jobs.add(root);
159
+ if (root instanceof WorkContainer) {
160
+ for (const job of Iterator.from(walkWork(root)).filter((node) => node instanceof Job)) {
161
+ jobs.add(job);
162
+ }
163
+ }
164
+ return [...jobs];
165
+ }
166
+ /**
167
+ * Two functions. License (phase 1) returns `true` | `false` and writes
168
+ * `orchestrationResult` (`orchestrated` follows). `true` → await execute
169
+ * (phase 2). `false` → skip execute, `completed = true`. Bootstrap
170
+ * `orchestrated && !completed` skips the license and runs execute.
171
+ * `signal` aborts when the job leaves the graph or the orchestrator disposes.
172
+ */
173
+ registerExecutor(Class, license, execute, options) {
174
+ invariant(!this.#processes.has(Class), `Orchestrator: executor already registered for ${Class.name}`);
175
+ const seal = options?.seal !== false;
176
+ this.#processes.set(Class, autorun(() => {
177
+ if (this.#disposed || !this.#activated.get())
178
+ return;
179
+ for (const node of this.reachableJobs) {
180
+ if (!(node instanceof Class))
181
+ continue;
182
+ const job = node;
183
+ if (job.completed || job.cancelled)
184
+ continue;
185
+ if (job.orchestrationResult === false) {
186
+ job.markComplete();
187
+ continue;
188
+ }
189
+ if (job.orchestrationResult === true) {
190
+ this.#startExecute(job, execute, seal);
191
+ continue;
192
+ }
193
+ if (this.#guardAbort.has(job) || this.#jobAbort.has(job))
194
+ continue;
195
+ // Ordering is data on the job: wait here until every predecessor is released.
196
+ if (!job.afterReleased)
197
+ continue;
198
+ this.#startGuard(job, license, execute, seal);
199
+ }
200
+ }));
201
+ }
202
+ #startGuard(job, license, execute, seal) {
203
+ const settle = action((ok) => {
204
+ if (job.orchestrationResult !== null || job.completed || job.cancelled)
205
+ return;
206
+ job.orchestrationResult = ok;
207
+ if (ok) {
208
+ this.#startExecute(job, execute, seal);
209
+ }
210
+ else {
211
+ job.markComplete();
212
+ }
213
+ });
214
+ // A guard that threw never licensed the job: deny it with a crash receipt.
215
+ const crashed = action((error) => {
216
+ if (job.orchestrationResult !== null || job.completed || job.cancelled)
217
+ return;
218
+ this.#recordCrash(job, "license", error);
219
+ job.orchestrationResult = false;
220
+ job.markComplete();
221
+ });
222
+ try {
223
+ const result = license(job, this);
224
+ if (typeof result === "boolean") {
225
+ settle(result);
226
+ return;
227
+ }
228
+ const ac = new AbortController();
229
+ this.#guardAbort.set(job, ac);
230
+ void result.then((ok) => {
231
+ if (ac.signal.aborted)
232
+ return;
233
+ settle(ok);
234
+ return ok;
235
+ }, (error) => {
236
+ if (ac.signal.aborted)
237
+ return;
238
+ crashed(error);
239
+ }).finally(action(() => {
240
+ this.#guardAbort.delete(job);
241
+ }));
242
+ }
243
+ catch (error) {
244
+ crashed(error);
245
+ }
246
+ }
247
+ #startExecute(job, execute, seal) {
248
+ if (this.#bodyStarted.has(job) || job.completed || job.cancelled)
249
+ return;
250
+ if (job.orchestrationResult !== true)
251
+ return;
252
+ this.#bodyStarted.add(job);
253
+ action(() => {
254
+ job.markStarted();
255
+ })();
256
+ const ac = new AbortController();
257
+ this.#jobAbort.set(job, ac);
258
+ void Promise.resolve()
259
+ .then(() => execute(job, ac.signal, this))
260
+ .then(() => false, (error) => {
261
+ // An abort (cancel, park, leaving the graph) is not a crash: the aborter owns the ending.
262
+ if (ac.signal.aborted || job.completed || job.cancelled)
263
+ return false;
264
+ action(() => this.#recordCrash(job, "body", error))();
265
+ return true;
266
+ })
267
+ .then(action((crashed) => {
268
+ if (seal || crashed)
269
+ job.markComplete();
270
+ this.#jobAbort.delete(job);
271
+ }))
272
+ .catch(() => { });
273
+ }
274
+ #recordCrash(job, phase, error) {
275
+ const detail = error instanceof Error ? error.message : String(error);
276
+ job.crash = `${phase}: ${detail === "" ? "unknown error" : detail}`;
277
+ try {
278
+ this.stampCrash(job, phase, detail);
279
+ }
280
+ catch {
281
+ /* the crash fact is already on the job; the receipt is best effort */
282
+ }
283
+ }
284
+ /**
285
+ * Host hook: a guard or body threw. `job.crash` is set; write the receipt
286
+ * the job's joiners read (a tool outcome, a call failure). The orchestrator
287
+ * completes the job right after.
288
+ */
289
+ stampCrash(_job, _phase, _detail) { }
290
+ /** In-flight claimed Jobs (handler has not `finally`'d). */
291
+ inFlightJobs() {
292
+ return this.#jobAbort.keys();
293
+ }
294
+ /** Abort an in-flight executor. No-op if the job is not claimed here. */
295
+ abortJob(job, reason) {
296
+ this.#jobAbort.get(job)?.abort(reason);
297
+ }
298
+ #connections = new Map();
299
+ #classes = new DefaultedMap(this.#loadDriverClass.bind(this));
300
+ #ensured = new DefaultedMap(this.#ensureConnection.bind(this));
301
+ /**
302
+ * Honor still `handle`s leftover attach PEW. Origin-dispatched completions
303
+ * return false (PR4). Default true unless the node is in {@link originCompletions}.
304
+ */
305
+ shouldHonor(node) {
306
+ return !this.originCompletions.has(node);
307
+ }
308
+ /** Process-local. Secrets are never a Plexus field. */
309
+ connectionSecrets(_connectionId) {
310
+ return { get: () => undefined };
311
+ }
312
+ /** After bootstrap, before ensure settles. The session host binds the settings writer here. */
313
+ attachConnection(_connectionId, _instance) { }
314
+ connectionOf(expectation) {
315
+ return this.#connections.get(expectation.connectionId);
316
+ }
317
+ actorOf(expectation) {
318
+ const connection = this.connectionOf(expectation);
319
+ if (!connection?.has(expectation))
320
+ return undefined;
321
+ return connection.resolveExpectation(expectation);
322
+ }
323
+ #loadDriverClass(driverName) {
324
+ return (async () => {
325
+ // JS: subclass fields (SessionOrchestrator.sessionDaemon) are unassigned during super().
326
+ await Promise.resolve();
327
+ const driver = this.drivers[driverName];
328
+ invariant(driver !== undefined, `unknown driver ${driverName}`);
329
+ try {
330
+ const cls = await this.loadDriverModule(driver);
331
+ invariant(isDriverConnectionClass(cls), "loadDriverModule: result is not a PEWDriver class");
332
+ // Occupancy is kernel-plane: interned connections outlive a session wrap.
333
+ cls.awareness = this.kernel.awareness;
334
+ cls.driverName = driverName;
335
+ const spec = this.drivers[driverName];
336
+ if (spec !== undefined) {
337
+ spec.stampLoad({
338
+ readyState: "ready",
339
+ error: "",
340
+ offersJson: JSON.stringify(cls.offers),
341
+ live: extraLiveFromState(cls.state),
342
+ });
343
+ // Offers are class state a driver may keep fresh (local detection). The
344
+ // reaction also holds the observation that wakes a lazy `cls.offers`.
345
+ this.#mirrorDisposers.push(reaction(() => toJS(cls.offers), (offers) => {
346
+ if (!this.#disposed)
347
+ spec.offers = offers;
348
+ }, { equals: comparer.structural }));
349
+ }
350
+ return cls;
351
+ }
352
+ catch (error) {
353
+ const spec = this.drivers[driverName];
354
+ if (spec !== undefined)
355
+ spec.stampLoad({ readyState: "failed", error: String(error) });
356
+ throw error;
357
+ }
358
+ })();
359
+ }
360
+ #ensureConnection(connectionId) {
361
+ const pending = (async () => {
362
+ const driver = this.kernel.root.connections[connectionId]?.driver;
363
+ invariant(driver !== undefined, `unknown driver for connection ${connectionId}`);
364
+ const instance = await acquireConnection(this.kernel.root, this, connectionId, async () => {
365
+ const cls = await this.#classes.get(driver.name);
366
+ const minted = new cls(connectionId,
367
+ // YAML: settings stamped onto the connection before ensure.
368
+ this.kernel.root.connections[connectionId]?.configuration ?? {}, this.connectionSecrets(connectionId));
369
+ action(() => {
370
+ minted.awareness = this.kernel.awareness; // kernel occupancy, not session
371
+ })();
372
+ return minted;
373
+ });
374
+ action(() => {
375
+ instance.awareness = this.kernel.awareness;
376
+ })();
377
+ this.#connections.set(connectionId, instance);
378
+ await instance.ensureBootstrapStarted();
379
+ this.attachConnection(connectionId, instance);
380
+ return instance;
381
+ })();
382
+ void pending.then(undefined, () => { });
383
+ return pending;
384
+ }
385
+ ensure(connectionId) {
386
+ return this.#ensured.get(connectionId);
387
+ }
388
+ /** True once the connection memo has been poked — without poking it. */
389
+ isEnsured(connectionId) {
390
+ return this.#ensured.has(connectionId);
391
+ }
392
+ /** Intern-owner remint. Deletes the sticky `#ensured` memo. */
393
+ forgetConnection(id) {
394
+ this.#ensured.delete(id);
395
+ this.#connections.delete(id);
396
+ releaseConnection(this.kernel.root, this, id);
397
+ }
398
+ /** True after {@link activate}; constructor and registerExecutor do not honor. */
399
+ get activated() {
400
+ return this.#activated.get();
401
+ }
402
+ /**
403
+ * Start honor, Job claim, and driver discovery. Idempotent. No-op after
404
+ * park/dispose — those already stopped admission.
405
+ */
406
+ activate() {
407
+ if (this.#disposed || this.#admissionStopped)
408
+ return;
409
+ action(() => {
410
+ this.#activated.set(true);
411
+ })();
412
+ }
413
+ /**
414
+ * Stop honor and new claim. In-flight BODY and live connections stay —
415
+ * park waits dispatched MCP before {@link Symbol.dispose} releases them.
416
+ */
417
+ stopAdmission() {
418
+ if (this.#admissionStopped)
419
+ return;
420
+ this.#admissionStopped = true;
421
+ this.#disposeWork();
422
+ for (const dispose of this.#processes.values())
423
+ dispose();
424
+ this.#processes.clear();
425
+ for (const ac of this.#guardAbort.values())
426
+ ac.abort("park");
427
+ }
428
+ [(_get_reachableJobs_decorators = [computed], Symbol.dispose)]() {
429
+ if (this.#disposed)
430
+ return;
431
+ this.#disposed = true;
432
+ this.stopAdmission();
433
+ for (const ac of this.#jobAbort.values())
434
+ ac.abort();
435
+ for (const ac of this.#guardAbort.values())
436
+ ac.abort();
437
+ this.#disposeAborts();
438
+ this.#jobAbort.clear();
439
+ this.#guardAbort.clear();
440
+ for (const id of this.#connections.keys())
441
+ releaseConnection(this.kernel.root, this, id);
442
+ this.#connections.clear();
443
+ for (const dispose of this.#mirrorDisposers.splice(0))
444
+ dispose();
445
+ }
446
+ get drivers() {
447
+ return this.kernel.root.drivers;
448
+ }
449
+ get connections() {
450
+ return this.kernel.root.connections;
451
+ }
452
+ };
453
+ })();
454
+ export { Orchestrator };
455
+ function collectReachable(root) {
456
+ if (!(root instanceof WorkContainer))
457
+ return new Set();
458
+ const found = new Set();
459
+ for (const node of walkWork(root)) {
460
+ if (node instanceof WorkExpectation)
461
+ found.add(node);
462
+ }
463
+ return found;
464
+ }
465
+ //# sourceMappingURL=orchestrator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/executor/orchestrator.ts"],"names":[],"mappings":"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","sourcesContent":["import { DefaultedMap } from \"@here.build/collections\";\nimport { action, autorun, comparer, computed, observable, type IReactionDisposer, reaction, toJS } from \"mobx\";\nimport invariant from \"tiny-invariant\";\n\nimport {\n acquireConnection,\n releaseConnection,\n} from \"./kernel-intern.js\";\nimport { ExpectationActor } from \"../driver/ExpectationActor.js\";\nimport {\n type ConnectionSecretsView,\n type DriverConnectionClass,\n extraLiveFromState,\n isDriverConnectionClass,\n type PEWDriver,\n} from \"../driver/PEWDriver.js\";\nimport { DriverSpec } from \"../shared/models/DriverSpec.js\";\nimport { Job } from \"../shared/models/Job.js\";\nimport { WorkContainer, walkWork } from \"../shared/models/WorkContainer.js\";\nimport { type AnyWorkExpectation, WorkExpectation, isTreeOrphan } from \"../shared/models/WorkExpectation.js\";\nimport { type KernelPlexus, type SessionPlexus } from \"../shared/types.js\";\n\n/** Class identity for `instanceof`. `registerExecutor` never constructs. */\nexport type JobConstructor<T extends Job = Job> = abstract new (...args: any[]) => T;\n\n/**\n * Seam: session work graph → honor (PEW) and claim (Job).\n *\n * Honor is reachable PEW → handle. Unstarted cancel writes the durable\n * ending here and must not poke `ensure` — MCP: an unstarted tool must not\n * spin the server. Do not call `Actor.complete` — unstarted Work has no\n * Actor. `handle` is not the sealer. License is phase 1 on an Approvable\n * leaf. A sealed parent is not honored (the\n * child is already ending in the agentic runtime, or must not start).\n *\n * INTERN TABLE IS NOT AN ATOM. `#connections` is a plain Map of kernel-interned\n * instances (one live driver per kernel connection id). Honor re-enters by\n * reading catalog `spec.readyState` and, once minted, `instance.readyState`.\n * `handle` only when `ready`.\n *\n * A rejected ensure/load memo IS the sticky failure (no hot loop).\n *\n * Honor and Job claim do not start in the constructor. PEW autorun used to\n * run during `super()`, so a readiness Promise after construct was not a\n * gate. Call {@link activate} after replicas are pinned and recovery ran.\n *\n * Import discipline: this module does not import harness or the session document.\n */\nexport abstract class Orchestrator<\n K extends KernelPlexus = KernelPlexus,\n S extends SessionPlexus = SessionPlexus,\n> implements Disposable {\n #disposed = false;\n #admissionStopped = false;\n readonly #activated = observable.box(false);\n readonly #disposeWork: () => void;\n /** Disposed with the orchestrator — a dead session must not keep writing the live kernel catalog. */\n readonly #mirrorDisposers: IReactionDisposer[] = [];\n readonly #processes = new Map<JobConstructor, () => void>();\n /** Execute (phase 2) — started BODY. */\n readonly #jobAbort = new Map<Job, AbortController>();\n /** In-flight license (phase 1). */\n readonly #guardAbort = new Map<Job, AbortController>();\n /**\n * Process-local: execute already claimed this job. Survives seal:false\n * so the starter does not re-run BODY. A new Orchestrator is empty —\n * bootstrap `orchestrated && !completed` runs execute once more.\n */\n readonly #bodyStarted = new WeakSet<Job>();\n /**\n * Origin-dispatched PEW skip. Lives here, not on the session subclass:\n * honor used to run during `super()`, and subclass fields are unassigned\n * then (JS). A child WeakSet made `shouldHonor` throw `undefined.has`.\n */\n protected readonly originCompletions = new WeakSet<WorkExpectation>();\n readonly #disposeAborts: () => void;\n\n constructor(\n public readonly kernel: K,\n public readonly session: S,\n ) {\n this.#mirrorDisposers.push(\n autorun(() => {\n if (this.#disposed || !this.#activated.get()) return;\n for (const name of Object.keys(this.drivers)) {\n // Driver discovery is intentionally eager so the kernel catalog can\n // expose class-side offers and live facts before a connection is\n // ensured. A session may not be able to load every driver in a\n // shared kernel, so consume a rejected discovery promise here; the\n // driver spec already carries the failure for interested readers.\n void this.#classes.get(name).catch(() => {});\n }\n }),\n );\n this.#disposeWork = autorun(() => {\n if (this.#disposed || !this.#activated.get()) return;\n for (const node of collectReachable(this.session.root)) {\n if (node.isDone || isTreeOrphan(node)) continue;\n if (!this.shouldHonor(node)) continue;\n const spec = this.connections[node.connectionId];\n if (spec === undefined) continue;\n void spec.readyState;\n const instance = this.#connections.get(node.connectionId);\n if (instance !== undefined) {\n if (instance.readyState === \"ready\") instance.handle(node);\n continue;\n }\n invariant(Object.hasOwn(this.connections, node.connectionId), `unknown connection ${node.connectionId}`);\n void this.ensure(node.connectionId);\n }\n });\n this.#disposeAborts = autorun(() => {\n if (this.#disposed || !this.#activated.get()) return;\n const live = new Set(this.reachableJobs);\n for (const [job, ac] of this.#jobAbort) {\n if (live.has(job) || ac.signal.aborted) continue;\n ac.abort();\n }\n for (const [job, ac] of this.#guardAbort) {\n if (live.has(job) || ac.signal.aborted) continue;\n ac.abort();\n }\n });\n }\n\n @computed\n protected get reachableJobs(): Job[] {\n const root = this.session.root;\n const jobs = new Set<Job>();\n if (root instanceof Job) jobs.add(root);\n if (root instanceof WorkContainer) {\n for (const job of Iterator.from(walkWork(root)).filter((node): node is Job => node instanceof Job)) {\n jobs.add(job);\n }\n }\n return [...jobs];\n }\n\n /**\n * Two functions. License (phase 1) returns `true` | `false` and writes\n * `orchestrationResult` (`orchestrated` follows). `true` → await execute\n * (phase 2). `false` → skip execute, `completed = true`. Bootstrap\n * `orchestrated && !completed` skips the license and runs execute.\n * `signal` aborts when the job leaves the graph or the orchestrator disposes.\n */\n registerExecutor<T extends Job>(\n Class: JobConstructor<T>,\n license: (job: T, orchestrator: this) => boolean | Promise<boolean>,\n execute: (job: T, signal: AbortSignal, orchestrator: this) => void | Promise<void>,\n options?: { readonly seal?: boolean },\n ): void {\n invariant(!this.#processes.has(Class), `Orchestrator: executor already registered for ${Class.name}`);\n const seal = options?.seal !== false;\n this.#processes.set(\n Class,\n autorun(() => {\n if (this.#disposed || !this.#activated.get()) return;\n for (const node of this.reachableJobs) {\n if (!(node instanceof Class)) continue;\n const job = node as T;\n if (job.completed || job.cancelled) continue;\n if (job.orchestrationResult === false) {\n job.markComplete();\n continue;\n }\n if (job.orchestrationResult === true) {\n this.#startExecute(job, execute, seal);\n continue;\n }\n if (this.#guardAbort.has(job) || this.#jobAbort.has(job)) continue;\n // Ordering is data on the job: wait here until every predecessor is released.\n if (!job.afterReleased) continue;\n this.#startGuard(job, license, execute, seal);\n }\n }),\n );\n }\n\n #startGuard<T extends Job>(\n job: T,\n license: (job: T, orchestrator: this) => boolean | Promise<boolean>,\n execute: (job: T, signal: AbortSignal, orchestrator: this) => void | Promise<void>,\n seal: boolean,\n ): void {\n const settle = action((ok: boolean) => {\n if (job.orchestrationResult !== null || job.completed || job.cancelled) return;\n job.orchestrationResult = ok;\n if (ok) {this.#startExecute(job, execute, seal);}\n else {job.markComplete();}\n });\n // A guard that threw never licensed the job: deny it with a crash receipt.\n const crashed = action((error: unknown) => {\n if (job.orchestrationResult !== null || job.completed || job.cancelled) return;\n this.#recordCrash(job, \"license\", error);\n job.orchestrationResult = false;\n job.markComplete();\n });\n try {\n const result = license(job, this);\n if (typeof result === \"boolean\") {\n settle(result);\n return;\n }\n const ac = new AbortController();\n this.#guardAbort.set(job, ac);\n void result.then(\n (ok) => {\n if (ac.signal.aborted) return;\n settle(ok);\n return ok;\n },\n (error: unknown) => {\n if (ac.signal.aborted) return;\n crashed(error);\n },\n ).finally(\n action(() => {\n this.#guardAbort.delete(job);\n }),\n );\n } catch (error) {\n crashed(error);\n }\n }\n\n #startExecute<T extends Job>(\n job: T,\n execute: (job: T, signal: AbortSignal, orchestrator: this) => void | Promise<void>,\n seal: boolean,\n ): void {\n if (this.#bodyStarted.has(job) || job.completed || job.cancelled) return;\n if (job.orchestrationResult !== true) return;\n this.#bodyStarted.add(job);\n action(() => {\n job.markStarted();\n })();\n const ac = new AbortController();\n this.#jobAbort.set(job, ac);\n void Promise.resolve()\n .then(() => execute(job, ac.signal, this))\n .then(\n () => false,\n (error: unknown) => {\n // An abort (cancel, park, leaving the graph) is not a crash: the aborter owns the ending.\n if (ac.signal.aborted || job.completed || job.cancelled) return false;\n action(() => this.#recordCrash(job, \"body\", error))();\n return true;\n },\n )\n .then(\n action((crashed: boolean) => {\n if (seal || crashed) job.markComplete();\n this.#jobAbort.delete(job);\n }),\n )\n .catch(() => {});\n }\n\n #recordCrash(job: Job, phase: \"license\" | \"body\", error: unknown): void {\n const detail = error instanceof Error ? error.message : String(error);\n job.crash = `${phase}: ${detail === \"\" ? \"unknown error\" : detail}`;\n try {\n this.stampCrash(job, phase, detail);\n } catch {\n /* the crash fact is already on the job; the receipt is best effort */\n }\n }\n\n /**\n * Host hook: a guard or body threw. `job.crash` is set; write the receipt\n * the job's joiners read (a tool outcome, a call failure). The orchestrator\n * completes the job right after.\n */\n protected stampCrash(_job: Job, _phase: \"license\" | \"body\", _detail: string): void {}\n\n /** In-flight claimed Jobs (handler has not `finally`'d). */\n protected inFlightJobs(): Iterable<Job> {\n return this.#jobAbort.keys();\n }\n\n /** Abort an in-flight executor. No-op if the job is not claimed here. */\n abortJob(job: Job, reason?: unknown): void {\n this.#jobAbort.get(job)?.abort(reason);\n }\n\n readonly #connections = new Map<string, PEWDriver>();\n readonly #classes = new DefaultedMap<string, Promise<DriverConnectionClass>>(this.#loadDriverClass.bind(this));\n readonly #ensured = new DefaultedMap<string, Promise<PEWDriver>>(this.#ensureConnection.bind(this));\n\n abstract loadDriverModule(driver: DriverSpec): Promise<DriverConnectionClass>;\n\n /**\n * Honor still `handle`s leftover attach PEW. Origin-dispatched completions\n * return false (PR4). Default true unless the node is in {@link originCompletions}.\n */\n protected shouldHonor(node: WorkExpectation): boolean {\n return !this.originCompletions.has(node);\n }\n\n /** Process-local. Secrets are never a Plexus field. */\n protected connectionSecrets(_connectionId: string): ConnectionSecretsView {\n return { get: () => undefined };\n }\n\n /** After bootstrap, before ensure settles. The session host binds the settings writer here. */\n protected attachConnection(_connectionId: string, _instance: PEWDriver): void {}\n\n connectionOf(expectation: WorkExpectation): PEWDriver | undefined {\n return this.#connections.get(expectation.connectionId);\n }\n\n actorOf<T extends AnyWorkExpectation>(expectation: T): ExpectationActor<T> | undefined {\n const connection = this.connectionOf(expectation);\n if (!connection?.has(expectation)) return undefined;\n return connection.resolveExpectation(expectation);\n }\n\n #loadDriverClass(driverName: string): Promise<DriverConnectionClass> {\n return (async () => {\n // JS: subclass fields (SessionOrchestrator.sessionDaemon) are unassigned during super().\n await Promise.resolve();\n const driver = this.drivers[driverName];\n invariant(driver !== undefined, `unknown driver ${driverName}`);\n try {\n const cls = await this.loadDriverModule(driver);\n invariant(isDriverConnectionClass(cls), \"loadDriverModule: result is not a PEWDriver class\");\n // Occupancy is kernel-plane: interned connections outlive a session wrap.\n cls.awareness = this.kernel.awareness;\n cls.driverName = driverName;\n const spec = this.drivers[driverName];\n if (spec !== undefined) {\n spec.stampLoad({\n readyState: \"ready\",\n error: \"\",\n offersJson: JSON.stringify(cls.offers),\n live: extraLiveFromState(cls.state),\n });\n // Offers are class state a driver may keep fresh (local detection). The\n // reaction also holds the observation that wakes a lazy `cls.offers`.\n this.#mirrorDisposers.push(\n reaction(\n () => toJS(cls.offers),\n (offers) => {\n if (!this.#disposed) spec.offers = offers;\n },\n { equals: comparer.structural },\n ),\n );\n }\n return cls;\n } catch (error) {\n const spec = this.drivers[driverName];\n if (spec !== undefined) spec.stampLoad({ readyState: \"failed\", error: String(error) });\n throw error;\n }\n })();\n }\n\n #ensureConnection(connectionId: string): Promise<PEWDriver> {\n const pending = (async () => {\n const driver = this.kernel.root.connections[connectionId]?.driver;\n invariant(driver !== undefined, `unknown driver for connection ${connectionId}`);\n const instance = await acquireConnection(this.kernel.root, this, connectionId, async () => {\n const cls = await this.#classes.get(driver.name);\n const minted = new cls(\n connectionId,\n // YAML: settings stamped onto the connection before ensure.\n this.kernel.root.connections[connectionId]?.configuration ?? {},\n this.connectionSecrets(connectionId),\n );\n action(() => {\n minted.awareness = this.kernel.awareness; // kernel occupancy, not session\n })();\n return minted;\n });\n action(() => {\n instance.awareness = this.kernel.awareness;\n })();\n this.#connections.set(connectionId, instance);\n await instance.ensureBootstrapStarted();\n this.attachConnection(connectionId, instance);\n return instance;\n })();\n void pending.then(undefined, () => {});\n return pending;\n }\n\n ensure(connectionId: string): Promise<PEWDriver> {\n return this.#ensured.get(connectionId);\n }\n\n /** True once the connection memo has been poked — without poking it. */\n protected isEnsured(connectionId: string): boolean {\n return this.#ensured.has(connectionId);\n }\n\n /** Intern-owner remint. Deletes the sticky `#ensured` memo. */\n forgetConnection(id: string): void {\n this.#ensured.delete(id);\n this.#connections.delete(id);\n releaseConnection(this.kernel.root, this, id);\n }\n\n /** True after {@link activate}; constructor and registerExecutor do not honor. */\n get activated(): boolean {\n return this.#activated.get();\n }\n\n /**\n * Start honor, Job claim, and driver discovery. Idempotent. No-op after\n * park/dispose — those already stopped admission.\n */\n activate(): void {\n if (this.#disposed || this.#admissionStopped) return;\n action(() => {\n this.#activated.set(true);\n })();\n }\n\n /**\n * Stop honor and new claim. In-flight BODY and live connections stay —\n * park waits dispatched MCP before {@link Symbol.dispose} releases them.\n */\n protected stopAdmission(): void {\n if (this.#admissionStopped) return;\n this.#admissionStopped = true;\n this.#disposeWork();\n for (const dispose of this.#processes.values()) dispose();\n this.#processes.clear();\n for (const ac of this.#guardAbort.values()) ac.abort(\"park\");\n }\n\n [Symbol.dispose](): void {\n if (this.#disposed) return;\n this.#disposed = true;\n this.stopAdmission();\n for (const ac of this.#jobAbort.values()) ac.abort();\n for (const ac of this.#guardAbort.values()) ac.abort();\n this.#disposeAborts();\n this.#jobAbort.clear();\n this.#guardAbort.clear();\n for (const id of this.#connections.keys()) releaseConnection(this.kernel.root, this, id);\n this.#connections.clear();\n for (const dispose of this.#mirrorDisposers.splice(0)) dispose();\n }\n\n get drivers() {\n return this.kernel.root.drivers;\n }\n\n get connections() {\n return this.kernel.root.connections;\n }\n}\n\nfunction collectReachable(root: unknown): Set<WorkExpectation> {\n if (!(root instanceof WorkContainer)) return new Set();\n const found = new Set<WorkExpectation>();\n for (const node of walkWork(root)) {\n if (node instanceof WorkExpectation) found.add(node);\n }\n return found;\n}\n"]}
@@ -0,0 +1,8 @@
1
+ export type Settlement<TResult> = {
2
+ readonly outcome: "complete";
3
+ readonly result: TResult;
4
+ } | {
5
+ readonly outcome: "fail";
6
+ readonly reason: unknown;
7
+ };
8
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/executor/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,OAAO,IAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/executor/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Settlement<TResult> =\n | { readonly outcome: \"complete\"; readonly result: TResult }\n | { readonly outcome: \"fail\"; readonly reason: unknown };\n"]}
@@ -0,0 +1,2 @@
1
+ export * from "./shared/index.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,2 @@
1
+ export * from "./shared/index.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"./shared/index.js\";\n"]}
@@ -0,0 +1,4 @@
1
+ import { z } from "zod";
2
+ export declare const pewConfigurationSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
3
+ export declare const pewSecretsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
4
+ //# sourceMappingURL=connection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/schemas/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,wCAAoC,CAAC;AACxE,eAAO,MAAM,gBAAgB,wCAAoC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { z } from "zod";
2
+ export const pewConfigurationSchema = z.record(z.string(), z.unknown());
3
+ export const pewSecretsSchema = z.record(z.string(), z.unknown());
4
+ //# sourceMappingURL=connection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/schemas/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nexport const pewConfigurationSchema = z.record(z.string(), z.unknown());\nexport const pewSecretsSchema = z.record(z.string(), z.unknown());\n"]}
@@ -0,0 +1,2 @@
1
+ export * from "./connection.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export * from "./connection.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC","sourcesContent":["export * from \"./connection.js\";\n"]}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Attention occupancy. Clients publish on kernel awareness; PEW reduces to
3
+ * none | ambient | focused. Interned connections outlive a session wrap, so
4
+ * occupancy is not session-plane. Drivers read the reduced token — never clientIds.
5
+ */
6
+ import { type PlexusAwareness } from "@here.build/plexus";
7
+ import { ConnectionSpec } from "./models/ConnectionSpec.js";
8
+ import { DriverSpec } from "./models/DriverSpec.js";
9
+ export type Attention = "none" | "ambient" | "focused";
10
+ export declare const ATTENTION_LANE = "attention";
11
+ export declare const ATTENTION_FOCUS_LANE = "attentionFocus";
12
+ export type AttentionRef = {
13
+ readonly kind: "driver";
14
+ readonly name: string;
15
+ } | {
16
+ readonly kind: "connection";
17
+ readonly id: string;
18
+ };
19
+ export type AttentionSubject = DriverSpec | ConnectionSpec;
20
+ export type AttentionSource = AttentionSubject | Iterable<AttentionSubject | null | undefined> | null | undefined;
21
+ export declare function attentionRefFromSpec(spec: AttentionSubject): AttentionRef;
22
+ export declare function collectAttentionRefs(source: AttentionSource): AttentionRef[];
23
+ export declare function publishAttention(hub: PlexusAwareness, refs: readonly AttentionRef[]): void;
24
+ export declare function publishAttentionFocus(hub: PlexusAwareness, ref: AttentionRef | null): void;
25
+ /** Union of every client's occupancy. Focused wins over ambient. */
26
+ export declare function attentionOf(hub: PlexusAwareness, target: AttentionRef): Attention;
27
+ //# sourceMappingURL=attention.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../src/shared/attention.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAElH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAGzE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,EAAE,CAc5E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAO1F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAO1F;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,CAYjF"}