@glubean/engine 0.7.0

package/dist/types.d.ts

@@ -0,0 +1,378 @@
+/**
+ * @glubean/engine (Stage 1 spike) — environment-agnostic run-loop core.
+ *
+ * Lives in packages/engine during the isolation gate; both hosts reference it:
+ * @glubean/runner (NodeHost) and lite's BrowserHost. Hosts implement the ports
+ * and drive RunnerCore; the run-loop semantics live here, written once.
+ *
+ * HTTP architecture (Decision B, codex-reviewed): run REAL ky in BOTH hosts. The
+ * host seam is the web-standard `fetch`; the engine builds a per-run ky instance
+ * with the injected fetch + scope-bound trace hooks and exposes it as
+ * `scope.runtime.http`. ky (extend/hooks/retry/timeout/configure().http) is then
+ * shared, written once — no hand-rolled HttpFacade.
+ *
+ * Stage 1 goal (headline go/no-go): prove per-run isolation is delegated entirely
+ * to the injected Carrier port via an explicit ExecutionScope, with NO module-
+ * global coupling. Narrow run-loop only (simple / linear steps); branch / poll /
+ * retry / timeout / workflow are Stage 2.
+ */
+import type { KyInstance, Options } from "ky";
+import type { InternalRuntime, RuntimeCarrier } from "@glubean/sdk/internal";
+import type { GlubeanAction, GlubeanEvent, HttpSchemaOptions, MetricOptions, PollUntilOptions, SchemaIssue, SchemaLike, Trace, ValidateOptions } from "@glubean/sdk";
+/** ky request options plus Glubean's retained public `prefixUrl` (the engine maps
+ *  it to ky 2's `prefix` at the boundary) and the `schema` option for automatic
+ *  request/response validation (node parity: harness KyOptionsWithSchema). */
+export type GlubeanHttpOptions = Options & {
+    prefixUrl?: string;
+    schema?: HttpSchemaOptions;
+};
+/**
+ * The http client both hosts expose as `ctx.http` / `runtime.http`: a ky instance
+ * whose call / method / `.extend()` options also accept the public `prefixUrl`
+ * (codex P2-3 — typing it as raw KyInstance would reject `extend({ prefixUrl })`
+ * at compile time even though the runtime proxy maps it).
+ */
+type KyResponsePromise = ReturnType<KyInstance["get"]>;
+export interface GlubeanHttp {
+    (url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    get(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    post(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    put(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    patch(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    delete(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    head(url: string | URL | Request, options?: GlubeanHttpOptions): KyResponsePromise;
+    extend(options: GlubeanHttpOptions | ((parentOptions: Options) => GlubeanHttpOptions)): GlubeanHttp;
+}
+/**
+ * Host port: the only HTTP egress, as the web-standard `fetch`. node = node fetch
+ * (undici) / browser = a fetch wrapping the CORS-bypass extension or direct fetch.
+ * The browser wrapper MUST honor the real fetch contract (Request/URL + init,
+ * AbortSignal, clone-before-read) — see fetch-conformance tests. (codex P1-3)
+ */
+export type FetchImpl = (input: Request | string | URL, init?: RequestInit) => Promise<Response>;
+/** Host port: vars are available everywhere; secrets are node-only (never browser). */
+export interface EnvProvider {
+    vars(): Record<string, string>;
+    secrets(): Record<string, string>;
+    /** Optional RAW vars snapshot for ctx.vars.all() (node parity: {...rawVars}). The
+     *  `vars()` accessor a host returns may be a fallback Proxy (.env→process.env) whose
+     *  spread would resolve empty values to the fallback / drop them; varsAll() returns
+     *  the un-proxied map so all() matches legacy exactly. Falls back to spreading vars()
+     *  when absent (codex Phase-8 P2). */
+    varsAll?(): Record<string, string>;
+}
+export type ExecutionEvent = {
+    type: "start";
+    id: string;
+    name: string;
+    tags: string[];
+    retryCount?: number;
+} | {
+    type: "assertion";
+    id: string;
+    passed: boolean;
+    message?: string;
+    actual?: unknown;
+    expected?: unknown;
+    stepIndex?: number;
+} | {
+    type: "trace";
+    id: string;
+    data: Trace;
+    stepIndex?: number;
+} | {
+    type: "log";
+    id: string;
+    message: string;
+    data?: unknown;
+    stepIndex?: number;
+} | {
+    type: "warning";
+    id: string;
+    condition: boolean;
+    message: string;
+    stepIndex?: number;
+} | {
+    type: "schema_validation";
+    id: string;
+    label: string;
+    success: boolean;
+    severity: "error" | "warn" | "fatal";
+    issues?: SchemaIssue[];
+    stepIndex?: number;
+} | {
+    type: "metric";
+    id: string;
+    name: string;
+    value: number;
+    unit?: string;
+    tags?: Record<string, string>;
+    stepIndex?: number;
+} | {
+    type: "action";
+    id: string;
+    data: GlubeanAction;
+    stepIndex?: number;
+} | {
+    type: "event";
+    id: string;
+    data: GlubeanEvent;
+    stepIndex?: number;
+} | {
+    type: "step_start";
+    id: string;
+    index: number;
+    name: string;
+    total: number;
+} | {
+    type: "step_end";
+    id: string;
+    index: number;
+    name: string;
+    status: "passed" | "failed" | "skipped";
+    durationMs: number;
+    assertions: number;
+    failedAssertions: number;
+    attempts?: number;
+    retriesUsed?: number;
+    error?: string;
+    returnState?: unknown;
+} | {
+    type: "branch";
+    id: string;
+    index: number;
+    name: string;
+    takenIndex: number | "default";
+    takenValue?: string | number | boolean | null;
+    message?: string;
+    total: number;
+    error?: string;
+} | {
+    type: "poll";
+    id: string;
+    index: number;
+    name: string;
+    attempts: number;
+    elapsedMs: number;
+    satisfied: boolean;
+    exhausted: boolean;
+    error?: string;
+} | {
+    type: "timeout_update";
+    id: string;
+    timeout: number;
+} | {
+    type: "session_set";
+    id: string;
+    key: string;
+    value: unknown;
+} | {
+    type: "status";
+    id: string;
+    status: "ok" | "error" | "skipped";
+    error?: string;
+};
+/** Host port: where execution events go. node = stdout stream / browser = collector. */
+export interface EventSink {
+    emit(e: ExecutionEvent): void;
+}
+/** Host port: clock / timers. Stage 1 uses now() only (trace timing). */
+export interface Scheduler {
+    now(): number;
+}
+/**
+ * Host ports wired in Stage 1. `carrier` is the SDK RuntimeCarrier the engine
+ * installs so getRuntime() consumers (configure() / session / configured-http)
+ * resolve to the active scope's runtime. node provides an ALS carrier (true
+ * cross-await isolation); browser provides its own (single-flight today,
+ * AsyncContext-style propagation later — an open decision, not this gate).
+ */
+export interface RunnerServices {
+    fetch: FetchImpl;
+    env: EnvProvider;
+    events: EventSink;
+    scheduler: Scheduler;
+    carrier: RuntimeCarrier;
+    /** HTTP trace policy (host-injected from ExecutorOptions, all default OFF): full
+     *  request/response capture, response-body schema inference, and aggressive array
+     *  truncation. Node parity: harness emitFullTrace / inferSchema / truncateArrays. */
+    http?: {
+        emitFullTrace?: boolean;
+        inferSchema?: boolean;
+        truncateArrays?: boolean;
+    };
+}
+export interface ModuleLoader {
+    provide(source: string): Promise<Record<string, unknown>>;
+}
+export interface DataProvider {
+    read(name: string): Promise<string>;
+}
+export interface FeaturePolicy {
+    supports(feature: string): boolean;
+}
+/** Per-run runtime input (vars/secrets/session) layered over the host EnvProvider. */
+export interface ScopeInput {
+    vars?: Record<string, string>;
+    secrets?: Record<string, string>;
+    session?: Record<string, unknown>;
+    /** Test-level retry attempt (the host re-runs a failed test); surfaced on
+     *  ctx.retryCount + the start event, like the node harness. 0/undefined = first run. */
+    retryCount?: number;
+}
+export interface TestResult {
+    id: string;
+    name: string;
+    /** The engine's verdict: "error" if it threw OR a soft assertion failed. */
+    status: "ok" | "error" | "skipped";
+    /** True only if user code threw (vs a soft assertion failure). Lets a host
+     *  distinguish "completed but failed an assertion" from "threw" when deciding
+     *  status/exit semantics (the runner re-raises a throw; a soft fail completed). */
+    threw?: boolean;
+    /** True if a STEP failed (assertion or throw) in a steps run. Node parity: a
+     *  steps test with any failed step is reported as a failure ("One or more steps
+     *  failed"), unlike a simple test's soft assertion failure which "completes". */
+    stepsFailed?: boolean;
+    /** The message a host should throw for `stepsFailed` — usually "One or more steps
+     *  failed", or a branch-decision-specific message when a branch decision failed. */
+    stepsFailMessage?: string;
+    /** When `status === "skipped"` because user code called ctx.skip(reason?): the
+     *  reason. A host re-raises its own SkipError(reason) so the dispatcher emits the
+     *  same skipped status (with `reason`) as the legacy path (plan 0005 / codex). */
+    skipReason?: string;
+    error?: string;
+    /** The original throw's stack (only when `threw`), so a host can re-raise with
+     *  the user's stack instead of a host-rooted one (diagnostics parity). */
+    errorStack?: string;
+    /** The original throw's error name (e.g. "TypeError", ky's "TimeoutError"), so a
+     *  host can re-raise with it and keep failure classification (diagnostics parity). */
+    errorName?: string;
+    assertions: {
+        total: number;
+        passed: number;
+    };
+}
+export type TestFn = (ctx: EngineContext, state?: unknown) => unknown | Promise<unknown>;
+export interface StepDef {
+    meta: {
+        name: string;
+    };
+    fn: TestFn;
+}
+export interface TestDef {
+    meta: {
+        id: string;
+        name?: string;
+        tags?: string[];
+        skip?: boolean;
+        only?: boolean;
+    };
+    type: "simple" | "steps";
+    fn?: TestFn;
+    setup?: TestFn;
+    steps?: StepDef[];
+    teardown?: TestFn;
+}
+/**
+ * The narrow ctx surface Stage 1 exercises — scope-bound, never module globals.
+ * Structurally a subset of the SDK TestContext (http/expect/assert/warn/vars/
+ * secrets/session/log), enough to run real simple / builder / each tests. The
+ * Stage-2 surface (validate/skip/fail/setTimeout/metric/attach) is not here yet.
+ */
+export interface EngineContext {
+    /** ky instance for this run (the same shared ky both hosts use), accepting the
+     *  public `prefixUrl` option. */
+    http: GlubeanHttp;
+    expect(actual: unknown): unknown;
+    assert(condition: unknown, message?: string, details?: unknown): void;
+    warn(condition: unknown, message?: string): void;
+    vars: {
+        get(k: string): string | undefined;
+        require(k: string, validate?: (value: string) => boolean | string | void | null): string;
+        /** A copy of all vars for diagnostics/logging (node parity: harness ctx.vars.all). */
+        all(): Record<string, string>;
+    };
+    secrets: {
+        get(k: string): string | undefined;
+        require(k: string, validate?: (value: string) => boolean | string | void | null): string;
+    };
+    session: {
+        get(k: string): unknown;
+        require(k: string): unknown;
+        set(k: string, v: unknown): void;
+        entries(): Record<string, unknown>;
+    };
+    log(message: string, data?: unknown): void;
+    /** Validate `data` against a SchemaLike (zod or any safeParse/parse object); emits
+     *  a schema_validation event and routes a failure by severity (error→failed
+     *  assertion, warn→warning, fatal→failed assertion + abort). Returns the parsed
+     *  value on success, else undefined (node parity: harness ctx.validate). */
+    validate<T>(data: unknown, schema: SchemaLike<T>, label?: string, options?: ValidateOptions): T | undefined;
+    /** Report a numeric metric (node parity: harness ctx.metric). */
+    metric(name: string, value: number, options?: MetricOptions): void;
+    /** Record a typed interaction (node parity: harness ctx.action). */
+    action(a: GlubeanAction): void;
+    /** Emit a protocol trace (node parity: harness ctx.trace) — emits a trace event
+     *  AND a derived `action` ({protocol}:request). The HTTP auto-trace routes through
+     *  this too. */
+    trace(request: Trace): void;
+    /** Emit a generic structured event (node parity: harness ctx.event — the workflow
+     *  first-class unwrap stays node-legacy; the engine always emits generic). */
+    event(ev: GlubeanEvent): void;
+    /** Set a custom test timeout (ms) — emits a timeout_update control event the parent
+     *  uses to re-arm its deadline (node parity: harness ctx.setTimeout). */
+    setTimeout(ms: number): void;
+    /** Poll `fn` until it returns truthy or `timeoutMs` elapses; on timeout call
+     *  `onTimeout` (silent) or throw (node parity: harness ctx.pollUntil). */
+    pollUntil(options: PollUntilOptions, fn: () => Promise<boolean | unknown>): Promise<void>;
+    /** Skip the current test with an optional reason (node parity: throws a SkipError
+     *  the run-loop turns into a `skipped` verdict; a step/branch-predicate skip skips
+     *  the whole test unless a failure was already recorded). */
+    skip(reason?: string): never;
+    /** Immediately fail + abort: emit a failed assertion (counted even if caught) then
+     *  throw, so a steps/branch leg records the failure (node parity: harness ctx.fail). */
+    fail(message: string): never;
+    /** Test-level retry attempt for this run (0 on the first run). */
+    retryCount: number;
+    /** Process memory snapshot (node parity: harness ctx.getMemoryUsage → process
+     *  .memoryUsage()); null where unavailable (browser) — browser-safe via globalThis. */
+    getMemoryUsage(): {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    } | null;
+}
+/**
+ * Per-run state. THE headline invariant: every piece of per-run state lives here
+ * (or in scope.runtime), never in a module-level variable. Two concurrent runs
+ * hold two scopes; isolation is whatever the injected Carrier provides.
+ */
+export interface ExecutionScope {
+    runtime: InternalRuntime;
+    testMeta: {
+        id: string;
+        tags: string[];
+    };
+    stepIndex: number;
+    /** 0-based index of the step currently running (null outside a step) — events
+     *  emitted during a step carry it as `stepIndex`, like the node harness. */
+    currentStepIndex: number | null;
+    retryCount: number;
+    assertions: {
+        total: number;
+        passed: number;
+    };
+    http: GlubeanHttp;
+    session: Record<string, unknown>;
+    /** Raw merged vars snapshot for ctx.vars.all() — host raw vars + per-run input.vars,
+     *  WITHOUT the fallback-proxy resolution (node parity: {...rawVars}; codex Phase-8 P2). */
+    varsAll: Record<string, string>;
+    /** The run's ctx, back-filled once makeCtx runs. The scope-bound ky hooks (built
+     *  in createScope, BEFORE makeCtx) read it lazily at request time so the HTTP
+     *  auto-trace can route through ctx.trace / ctx.metric (→ derived action,
+     *  http_duration_ms) + the schema hooks through ctx.assert / ctx.warn. */
+    ctxRef?: EngineContext;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@glubean/engine",
+  "version": "0.7.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "description": "Environment-agnostic run-loop core shared by the Node runner and the browser host.",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ky": "^2.0.2",
+    "@glubean/sdk": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/glubean/glubean.git",
+    "directory": "packages/engine"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "pretest": "node -e \"const fs=require('fs'),p=require('path');const bad=fs.readdirSync('src',{recursive:true}).filter(f=>(/\\.(js|d\\.ts)$/.test(f)&&!f.endsWith('.mjs'))).map(f=>p.join('src',f));if(bad.length){console.error('ERROR: Stale build artifacts in src/ — delete them:',bad);process.exit(1)}\"",
+    "test": "vitest run",
+    "smoke": "pnpm --filter @glubean/sdk --filter @glubean/engine build && node browser-smoke/build-smoke.mjs",
+    "smoke:serve": "pnpm --filter @glubean/sdk --filter @glubean/engine build && node browser-smoke/serve-smoke.mjs"
+  }
+}