@glubean/sdk 0.2.2 → 0.2.4

package/dist/runner-input-channel.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @module runner-input-channel
+ *
+ * Process-local channel for runner-supplied case inputs. The dispatcher
+ * (`contract-core.ts`) reads from this channel when applying the §5.1
+ * runnable resolution algorithm. The runner harness writes to it before
+ * importing the user module.
+ *
+ * Two independent slots per testId (per attachment-model §8):
+ *
+ * - `explicit input` — fed via CLI `--input-json` / MCP `inputJson` /
+ *   programmatic `input`. When present, the dispatcher runs the raw case
+ *   with this input AFTER validating against the case's `needs` schema
+ *   (§5.1 step 1). Bootstrap overlay is NOT invoked even if registered.
+ *
+ * - `bootstrap input` — fed via CLI `--bootstrap-json` /
+ *   MCP `bootstrapInput` / programmatic `bootstrapInput`. Passed to the
+ *   overlay's `run(ctx, params)` after validation against the overlay's
+ *   `params` schema. Only meaningful when an overlay is registered AND
+ *   the run uses overlay mode.
+ *
+ * - `force standalone` (debug) — for no-needs cases marked
+ *   `runnability.requireAttachment: true`, allows bypassing the
+ *   "requires attachment" guard. §6.3 escape valve. Author-debug only;
+ *   warning emitted at runtime.
+ *
+ * The channel is process-local (a plain Map). Subprocess boundaries are
+ * the harness's responsibility — it serializes runner options, spawns the
+ * subprocess with env vars / args, and the harness's `setRuntime`-time
+ * code populates this channel before the user module imports.
+ *
+ * @internal
+ */
+/**
+ * Set the explicit case input for a given testId. Subsequent dispatcher
+ * runs of that testId will take this path (§5.1 step 1) regardless of
+ * whether a bootstrap overlay is registered.
+ *
+ * @internal
+ */
+export declare function setExplicitInput(testId: string, input: unknown): void;
+/**
+ * Read the explicit case input for a given testId. Returns
+ * `{ has: true, value }` when present (including when value is
+ * `undefined` / `null` / `false`), `{ has: false }` otherwise.
+ *
+ * @internal
+ */
+export declare function getExplicitInput(testId: string): {
+    has: true;
+    value: unknown;
+} | {
+    has: false;
+};
+/**
+ * Set the bootstrap params for a given testId. Read by the dispatcher
+ * when invoking an overlay (§5.1 step 3a).
+ *
+ * @internal
+ */
+export declare function setBootstrapInput(testId: string, input: unknown): void;
+/**
+ * Read the bootstrap params for a given testId.
+ *
+ * @internal
+ */
+export declare function getBootstrapInput(testId: string): {
+    has: true;
+    value: unknown;
+} | {
+    has: false;
+};
+/**
+ * Mark a testId as force-standalone (§6.3 debug escape valve for
+ * `requireAttachment` no-needs cases). The dispatcher will bypass the
+ * `requireAttachment` guard for this testId; a runtime warning is
+ * emitted alongside.
+ *
+ * @internal
+ */
+export declare function setForceStandalone(testId: string): void;
+/**
+ * Check whether a testId is force-standalone.
+ *
+ * @internal
+ */
+export declare function isForceStandalone(testId: string): boolean;
+/**
+ * Clear all runner-supplied inputs. Test hook; not part of the public
+ * API. Called by harness teardown and by tests that want a clean slate.
+ *
+ * @internal
+ */
+export declare function clearRunnerInputs(): void;
+//# sourceMappingURL=runner-input-channel.d.ts.map

package/dist/runner-input-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-input-channel.d.ts","sourceRoot":"","sources":["../src/runner-input-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAcH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GACb;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,CAGhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GACb;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,CAGhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}

package/dist/runner-input-channel.js

@@ -0,0 +1,110 @@
+/**
+ * @module runner-input-channel
+ *
+ * Process-local channel for runner-supplied case inputs. The dispatcher
+ * (`contract-core.ts`) reads from this channel when applying the §5.1
+ * runnable resolution algorithm. The runner harness writes to it before
+ * importing the user module.
+ *
+ * Two independent slots per testId (per attachment-model §8):
+ *
+ * - `explicit input` — fed via CLI `--input-json` / MCP `inputJson` /
+ *   programmatic `input`. When present, the dispatcher runs the raw case
+ *   with this input AFTER validating against the case's `needs` schema
+ *   (§5.1 step 1). Bootstrap overlay is NOT invoked even if registered.
+ *
+ * - `bootstrap input` — fed via CLI `--bootstrap-json` /
+ *   MCP `bootstrapInput` / programmatic `bootstrapInput`. Passed to the
+ *   overlay's `run(ctx, params)` after validation against the overlay's
+ *   `params` schema. Only meaningful when an overlay is registered AND
+ *   the run uses overlay mode.
+ *
+ * - `force standalone` (debug) — for no-needs cases marked
+ *   `runnability.requireAttachment: true`, allows bypassing the
+ *   "requires attachment" guard. §6.3 escape valve. Author-debug only;
+ *   warning emitted at runtime.
+ *
+ * The channel is process-local (a plain Map). Subprocess boundaries are
+ * the harness's responsibility — it serializes runner options, spawns the
+ * subprocess with env vars / args, and the harness's `setRuntime`-time
+ * code populates this channel before the user module imports.
+ *
+ * @internal
+ */
+const _state = {
+    explicit: new Map(),
+    bootstrap: new Map(),
+    forceStandalone: new Set(),
+};
+/**
+ * Set the explicit case input for a given testId. Subsequent dispatcher
+ * runs of that testId will take this path (§5.1 step 1) regardless of
+ * whether a bootstrap overlay is registered.
+ *
+ * @internal
+ */
+export function setExplicitInput(testId, input) {
+    _state.explicit.set(testId, input);
+}
+/**
+ * Read the explicit case input for a given testId. Returns
+ * `{ has: true, value }` when present (including when value is
+ * `undefined` / `null` / `false`), `{ has: false }` otherwise.
+ *
+ * @internal
+ */
+export function getExplicitInput(testId) {
+    if (!_state.explicit.has(testId))
+        return { has: false };
+    return { has: true, value: _state.explicit.get(testId) };
+}
+/**
+ * Set the bootstrap params for a given testId. Read by the dispatcher
+ * when invoking an overlay (§5.1 step 3a).
+ *
+ * @internal
+ */
+export function setBootstrapInput(testId, input) {
+    _state.bootstrap.set(testId, input);
+}
+/**
+ * Read the bootstrap params for a given testId.
+ *
+ * @internal
+ */
+export function getBootstrapInput(testId) {
+    if (!_state.bootstrap.has(testId))
+        return { has: false };
+    return { has: true, value: _state.bootstrap.get(testId) };
+}
+/**
+ * Mark a testId as force-standalone (§6.3 debug escape valve for
+ * `requireAttachment` no-needs cases). The dispatcher will bypass the
+ * `requireAttachment` guard for this testId; a runtime warning is
+ * emitted alongside.
+ *
+ * @internal
+ */
+export function setForceStandalone(testId) {
+    _state.forceStandalone.add(testId);
+}
+/**
+ * Check whether a testId is force-standalone.
+ *
+ * @internal
+ */
+export function isForceStandalone(testId) {
+    return _state.forceStandalone.has(testId);
+}
+/**
+ * Clear all runner-supplied inputs. Test hook; not part of the public
+ * API. Called by harness teardown and by tests that want a clean slate.
+ *
+ * @internal
+ */
+export function clearRunnerInputs() {
+    _state.explicit.clear();
+    _state.bootstrap.clear();
+    _state.forceStandalone.clear();
+}
+//# sourceMappingURL=runner-input-channel.js.map

package/dist/runner-input-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-input-channel.js","sourceRoot":"","sources":["../src/runner-input-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAQH,MAAM,MAAM,GAAiB;IAC3B,QAAQ,EAAE,IAAI,GAAG,EAAE;IACnB,SAAS,EAAE,IAAI,GAAG,EAAE;IACpB,eAAe,EAAE,IAAI,GAAG,EAAE;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAc;IAC7D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc;IAEd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACxD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAAc;IAC9D,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc;IAEd,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACzD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glubean/sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "exports": {
     ".": {