@invinite-org/chartlang-runtime 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Invinite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @invinite-org/chartlang-runtime
+
+`experimental`
+
+Execution engine, Series ring buffers, primitive implementations, state slots,
+views, inputs, request fallback, and emission buffering.
+
+## Install
+
+```bash
+pnpm add @invinite-org/chartlang-runtime
+```
+
+## Public surface
+
+- `createScriptRunner({ compiled, capabilities, stateStore?, symInfo?,
+  inputOverrides? })` -> `ScriptRunner` with `onHistory`, `onBarClose`,
+  `onBarTick`, `drain`, and `dispose`.
+- Data structures: `RingBuffer<T>`, `Float64RingBuffer`,
+  `makeSeriesView(buf)`, `createStreamState(...)`.
+- State: `inMemoryStateStore()` plus runtime `state.*` slots with
+  committed/tentative semantics; `state.tick.*` commits immediately during
+  ticks.
+- Views: per-step `barstate`, `timeframe`, and per-mount `syminfo` snapshots
+  are wired into `ComputeContext`.
+- Inputs: manifest input descriptors resolve through adapter/host overrides
+  before `compute({ inputs })` runs.
+- Request: `request.security({ interval })` returns a cached all-NaN
+  `SecurityBar` when multi-timeframe support is unavailable and emits deduped
+  capability diagnostics.
+- Emissions: `plot`, `hline`, `alert`, `draw`, drawing handles, budget checks,
+  and validation-backed diagnostic drops.
+- Context: `ACTIVE_RUNTIME_CONTEXT` is set only around script steps.
+
+## Minimum-viable API call
+
+```ts
+import { createScriptRunner, inMemoryStateStore } from "@invinite-org/chartlang-runtime";
+
+const runner = createScriptRunner({
+    compiled,
+    capabilities,
+    stateStore: inMemoryStateStore(),
+});
+
+await runner.onHistory(bars);
+const emissions = runner.drain();
+```
+
+## Docs
+
+See [`docs/spec/semantics.md`](../../docs/spec/semantics.md) and
+[`PLAN.md` §6.6](../../PLAN.md).
+
+## License
+
+MIT

package/dist/buildComputeContext.d.ts

@@ -0,0 +1,21 @@
+import type { ComputeContext } from "@invinite-org/chartlang-core";
+import type { RunnerState } from "./createScriptRunner.js";
+/**
+ * Build the `ComputeContext` the runner hands the compiled script on
+ * every step. Phase 1 returns the runtime's stable `BarView` (identity
+ * preserved across bars per PLAN §6.7), the mount-resolved frozen
+ * `inputs` record, and the runtime primitive implementations.
+ *
+ * The `bar` field is the mutable `BarView` typed-narrowed to the
+ * readonly `Bar` surface the script sees. Identity is stable, so a
+ * `const { bar } = ctx` at the top of `compute` keeps seeing the live
+ * scalars without re-binding per bar.
+ *
+ * @since 0.1
+ * @example
+ *     // import { buildComputeContext } from "@invinite-org/chartlang-runtime";
+ *     // const ctx = buildComputeContext(state);
+ *     // void ctx.bar.close;
+ */
+export declare function buildComputeContext(state: RunnerState): ComputeContext;
+//# sourceMappingURL=buildComputeContext.d.ts.map

package/dist/buildComputeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildComputeContext.d.ts","sourceRoot":"","sources":["../src/buildComputeContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAO3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAsBtE"}

package/dist/buildComputeContext.js

@@ -0,0 +1,48 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { alert, draw, hline, plot, ta } from "./primitives.js";
+import { emitAlertCondition } from "./emit/alertConditionEmission.js";
+import { buildRuntimeNamespace } from "./emit/logEmission.js";
+import { buildRequestNamespace } from "./request/index.js";
+import { buildStateNamespace } from "./state/index.js";
+/**
+ * Build the `ComputeContext` the runner hands the compiled script on
+ * every step. Phase 1 returns the runtime's stable `BarView` (identity
+ * preserved across bars per PLAN §6.7), the mount-resolved frozen
+ * `inputs` record, and the runtime primitive implementations.
+ *
+ * The `bar` field is the mutable `BarView` typed-narrowed to the
+ * readonly `Bar` surface the script sees. Identity is stable, so a
+ * `const { bar } = ctx` at the top of `compute` keeps seeing the live
+ * scalars without re-binding per bar.
+ *
+ * @since 0.1
+ * @example
+ *     // import { buildComputeContext } from "@invinite-org/chartlang-runtime";
+ *     // const ctx = buildComputeContext(state);
+ *     // void ctx.bar.close;
+ */
+export function buildComputeContext(state) {
+    const base = {
+        bar: state.mainStream.bar,
+        inputs: state.runtimeContext.resolvedInputs,
+        ta,
+        plot,
+        hline,
+        alert,
+        draw,
+        state: buildStateNamespace(),
+        barstate: state.runtimeContext.views.barstate,
+        syminfo: state.runtimeContext.views.syminfo,
+        timeframe: state.runtimeContext.views.timeframe,
+        request: buildRequestNamespace(),
+        runtime: buildRuntimeNamespace(state.runtimeContext),
+    };
+    if (state.manifest.kind !== "alertCondition")
+        return base;
+    return {
+        ...base,
+        signal: (conditionId, fired) => emitAlertCondition(state.runtimeContext, conditionId, fired),
+    };
+}
+//# sourceMappingURL=buildComputeContext.js.map

package/dist/buildComputeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildComputeContext.js","sourceRoot":"","sources":["../src/buildComputeContext.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IAClD,MAAM,IAAI,GAAG;QACT,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG;QACzB,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc;QAC3C,EAAE;QACF,IAAI;QACJ,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK,EAAE,mBAAmB,EAAE;QAC5B,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ;QAC7C,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO;QAC3C,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS;QAC/C,OAAO,EAAE,qBAAqB,EAAE;QAChC,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC;KACvD,CAAC;IACF,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO;QACH,GAAG,IAAI;QACP,MAAM,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAC3B,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC;KACnE,CAAC;AACN,CAAC"}

package/dist/createScriptRunner.d.ts

@@ -0,0 +1,111 @@
+import type { CandleEvent, Capabilities, RunnerEmissions } from "@invinite-org/chartlang-adapter-kit";
+import type { Bar, CompiledScriptObject, ComputeFn, ScriptManifest } from "@invinite-org/chartlang-core";
+import type { PersistentStateStore } from "./persistentStateStore.js";
+import type { MutableRunnerEmissions, RuntimeContext } from "./runtimeContext.js";
+import { type StateStore } from "./stateStore.js";
+import { type StreamState } from "./streamState.js";
+import { type AdapterSymInfo } from "./views/index.js";
+/**
+ * Internal handle the execution functions read and mutate per step. Lives
+ * inside `createScriptRunner`'s closure; never exposed on the public
+ * barrel. `barIndex` is the only mutable field — `onBarClose` increments
+ * it; `onBarTick` does not.
+ *
+ * @since 0.1
+ * @example
+ *     // RunnerState is internal — execution functions accept it as
+ *     // their first argument:
+ *     //   await onBarClose(state, rawBar);
+ */
+export type RunnerState = {
+    readonly manifest: ScriptManifest;
+    readonly compute: ComputeFn;
+    readonly capabilities: Capabilities;
+    readonly stateStore: StateStore;
+    readonly persistenceIntervalMs: number;
+    readonly now: () => number;
+    readonly mainStream: StreamState;
+    readonly runtimeContext: RuntimeContext;
+    readonly emissions: MutableRunnerEmissions;
+    barIndex: number;
+};
+/**
+ * The user-facing handle `createScriptRunner` returns. Hosts (Worker,
+ * QuickJS, conformance harness) drive a `ScriptRunner` through the
+ * standard lifecycle: `load → onHistory → onBarClose × N → onBarTick × M
+ * → drain → dispose`. PLAN §6.1 fixes this shape; consumer-repo hosts
+ * pin against it.
+ *
+ * `onHistory` / `onBarClose` / `onBarTick` return `Promise<void>` — the
+ * runtime allows compute bodies to `await` (Phase 1 doesn't, but the
+ * surface is forward-compatible with Phase-5 `request.security` warmup).
+ *
+ * @since 0.1
+ * @example
+ *     // import { createScriptRunner }
+ *     //     from "@invinite-org/chartlang-runtime";
+ *     // const runner = createScriptRunner({ compiled, capabilities });
+ *     // await runner.onHistory(historicalBars);
+ *     // const emissions = runner.drain();
+ *     // runner.dispose();
+ */
+export type ScriptRunner = {
+    onHistory(bars: ReadonlyArray<Bar>): Promise<void>;
+    onBarClose(bar: Bar): Promise<void>;
+    onBarTick(bar: Bar): Promise<void>;
+    push(event: CandleEvent): Promise<void>;
+    warmStart(currentMainBarTime: number): Promise<void>;
+    drain(): RunnerEmissions;
+    dispose(): Promise<void>;
+};
+/**
+ * Constructor arguments for {@link createScriptRunner}. `stateStore`
+ * defaults to {@link inMemoryStateStore} so callers without persistence
+ * needs can omit it. `symInfo` defaults to empty sentinels and is gated
+ * by `capabilities.symInfoFields` at mount. `resolveInputs` is called
+ * once at mount with `manifest.name`; worker-backed callers can pass an
+ * already structured-cloned `inputOverrides` record instead.
+ * `persistentStateStore` is the PLAN §6.9 cross-mount snapshot store;
+ * `persistenceIntervalMs` defaults to 60 seconds.
+ *
+ * @since 0.1
+ * @example
+ *     // const args: CreateScriptRunnerArgs = {
+ *     //     compiled,
+ *     //     capabilities,
+ *     //     stateStore: inMemoryStateStore(),
+ *     // };
+ */
+export type CreateScriptRunnerArgs = {
+    readonly compiled: CompiledScriptObject;
+    readonly capabilities: Capabilities;
+    readonly stateStore?: StateStore;
+    readonly persistentStateStore?: PersistentStateStore;
+    readonly persistenceIntervalMs?: number;
+    readonly now?: () => number;
+    readonly symInfo?: AdapterSymInfo;
+    readonly resolveInputs?: (scriptId: string) => Readonly<Record<string, unknown>>;
+    readonly inputOverrides?: Readonly<Record<string, unknown>>;
+};
+/**
+ * Build a `ScriptRunner` for a compiled chartlang script. The runner
+ * owns one `StreamState`, one `MutableRunnerEmissions` queue set, and
+ * the `RuntimeContext` Task 7-8 primitives read through
+ * `ACTIVE_RUNTIME_CONTEXT`. Phase 1 ships a single-stream model; the
+ * `requestedIntervals` field on the manifest is always empty.
+ *
+ * Capacity sizing follows PLAN §6.6: prefer
+ * `manifest.seriesCapacities.ohlcv` (compiler-emitted per-series
+ * lookback) and fall back to `manifest.maxLookback + 1`, clamped to a
+ * minimum of 1 so an empty-history script still has a valid head slot.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createScriptRunner } from "@invinite-org/chartlang-runtime";
+ *     // const runner = createScriptRunner({ compiled, capabilities });
+ *     // await runner.onHistory([]);
+ *     // runner.drain();
+ *     // runner.dispose();
+ */
+export declare function createScriptRunner(args: CreateScriptRunnerArgs): ScriptRunner;
+//# sourceMappingURL=createScriptRunner.d.ts.map

package/dist/createScriptRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createScriptRunner.d.ts","sourceRoot":"","sources":["../src/createScriptRunner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACR,GAAG,EACH,oBAAoB,EACpB,SAAS,EACT,cAAc,EACjB,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,KAAK,cAAc,EAAuC,MAAM,kBAAkB,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,IAAI,eAAe,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/D,CAAC;AAiEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,YAAY,CAsJ7E"}

package/dist/createScriptRunner.js

@@ -0,0 +1,234 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic } from "./emit/index.js";
+import { dispose as disposeImpl, drain as drainImpl, onBarClose as onBarCloseImpl, onBarTick as onBarTickImpl, onHistory as onHistoryImpl, } from "./execution/index.js";
+import { appendSecondaryBar, appendSecondaryHistory, replaceSecondaryHead, } from "./execution/secondaryStream.js";
+import { resolveInputs } from "./inputs/index.js";
+import { PERSISTENCE_INTERVAL_MS, maybeSaveStateSnapshot, restoreStateSnapshot, saveStateSnapshot, } from "./persistentStateStore.runtime.js";
+import { validateSnapshot } from "./persistentStateStore.validate.js";
+import { inMemoryStateStore } from "./stateStore.js";
+import { createStreamState } from "./streamState.js";
+import { createRuntimeViews, makeSymInfoView } from "./views/index.js";
+function resolveCapacity(manifest) {
+    const requested = manifest.seriesCapacities.ohlcv;
+    const fallback = manifest.maxLookback + 1;
+    return Math.max(1, requested ?? fallback);
+}
+function createSecondaryStreams(manifest, capacity) {
+    const streams = new Map();
+    for (const interval of manifest.requestedIntervals) {
+        if (streams.has(interval))
+            continue;
+        streams.set(interval, createStreamState({ interval, capacity, symbol: "" }));
+    }
+    return streams;
+}
+async function pushMainEvent(state, event) {
+    switch (event.kind) {
+        case "history":
+            await onHistoryImpl(state, event.bars);
+            return;
+        case "close":
+            await onBarCloseImpl(state, event.bar);
+            await maybeSaveStateSnapshot(state, state.now(), state.persistenceIntervalMs);
+            return;
+        case "tick":
+            await onBarTickImpl(state, event.bar);
+            return;
+    }
+}
+function pushUnknownSecondaryDiagnostic(state, streamKey) {
+    pushDiagnostic(state.emissions, {
+        kind: "diagnostic",
+        severity: "warning",
+        code: "unknown-secondary-stream",
+        message: `Secondary stream "${streamKey}" was not registered by the script manifest`,
+        slotId: null,
+        bar: state.barIndex,
+    });
+}
+function pushSecondaryEvent(state, streamKey, event) {
+    const stream = state.runtimeContext.secondaryStreams.get(streamKey);
+    if (stream === undefined) {
+        pushUnknownSecondaryDiagnostic(state, streamKey);
+        return;
+    }
+    switch (event.kind) {
+        case "history":
+            appendSecondaryHistory(stream, event.bars);
+            return;
+        case "close":
+            appendSecondaryBar(stream, event.bar);
+            return;
+        case "tick":
+            replaceSecondaryHead(stream, event.bar);
+            return;
+    }
+}
+/**
+ * Build a `ScriptRunner` for a compiled chartlang script. The runner
+ * owns one `StreamState`, one `MutableRunnerEmissions` queue set, and
+ * the `RuntimeContext` Task 7-8 primitives read through
+ * `ACTIVE_RUNTIME_CONTEXT`. Phase 1 ships a single-stream model; the
+ * `requestedIntervals` field on the manifest is always empty.
+ *
+ * Capacity sizing follows PLAN §6.6: prefer
+ * `manifest.seriesCapacities.ohlcv` (compiler-emitted per-series
+ * lookback) and fall back to `manifest.maxLookback + 1`, clamped to a
+ * minimum of 1 so an empty-history script still has a valid head slot.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createScriptRunner } from "@invinite-org/chartlang-runtime";
+ *     // const runner = createScriptRunner({ compiled, capabilities });
+ *     // await runner.onHistory([]);
+ *     // runner.drain();
+ *     // runner.dispose();
+ */
+export function createScriptRunner(args) {
+    const capacity = resolveCapacity(args.compiled.manifest);
+    const mainStream = createStreamState({ interval: "", capacity, symbol: "" });
+    const secondaryStreams = createSecondaryStreams(args.compiled.manifest, capacity);
+    const stateStore = args.stateStore ?? inMemoryStateStore();
+    const now = args.now ?? Date.now;
+    const views = createRuntimeViews({
+        syminfo: makeSymInfoView(args.symInfo ?? {}, args.capabilities.symInfoFields),
+    });
+    const emissions = {
+        plots: [],
+        drawings: [],
+        alerts: [],
+        alertConditions: [],
+        logs: [],
+        diagnostics: [],
+        fromBar: 0,
+        toBar: 0,
+    };
+    const alertConditions = new Map((args.compiled.manifest.alertConditions ?? []).map((condition) => [
+        condition.id,
+        condition,
+    ]));
+    const state = {
+        manifest: args.compiled.manifest,
+        compute: args.compiled.compute,
+        capabilities: args.capabilities,
+        stateStore,
+        persistenceIntervalMs: args.persistenceIntervalMs ?? PERSISTENCE_INTERVAL_MS,
+        now,
+        mainStream,
+        runtimeContext: {
+            stream: mainStream,
+            stateStore,
+            ...(args.persistentStateStore === undefined
+                ? {}
+                : { persistentStateStore: args.persistentStateStore }),
+            lastPersistTime: 0,
+            capabilities: args.capabilities,
+            emissions,
+            barIndex: () => state.barIndex,
+            isTick: false,
+            drawingSlots: new Map(),
+            drawingSubIdCounters: new Map(),
+            drawingBucketCounters: {
+                lines: 0,
+                labels: 0,
+                boxes: 0,
+                polylines: 0,
+                other: 0,
+            },
+            scriptMaxDrawings: args.compiled.manifest.maxDrawings ?? null,
+            stateSlots: new Map(),
+            secondaryStreams,
+            requestSecurityBars: new Map(),
+            requestSecurityAlignments: new Map(),
+            requestSecurityAscendingBars: new Map(),
+            requestLowerTfViews: new Map(),
+            diagnosedRequestKeys: new Set(),
+            alertConditions,
+            diagnosedAlertConditionKeys: new Set(),
+            logBudget: 0,
+            logBudgetExceededDiagnosed: false,
+            resolvedInputs: Object.freeze({}),
+            diagnosedInputKeys: new Set(),
+            views,
+        },
+        emissions,
+        barIndex: 0,
+    };
+    const overrides = args.inputOverrides ??
+        args.resolveInputs?.(args.compiled.manifest.name) ??
+        Object.freeze({});
+    state.runtimeContext.resolvedInputs = resolveInputs(args.compiled.manifest, overrides, state.runtimeContext);
+    return Object.freeze({
+        async onHistory(bars) {
+            await onHistoryImpl(state, bars);
+        },
+        async onBarClose(bar) {
+            await onBarCloseImpl(state, bar);
+            await maybeSaveStateSnapshot(state, state.now(), state.persistenceIntervalMs);
+        },
+        async onBarTick(bar) {
+            await onBarTickImpl(state, bar);
+        },
+        async push(event) {
+            if (event.streamKey === undefined) {
+                await pushMainEvent(state, event);
+                return;
+            }
+            pushSecondaryEvent(state, event.streamKey, event);
+        },
+        async warmStart(currentMainBarTime) {
+            const store = state.runtimeContext.persistentStateStore;
+            if (store === undefined)
+                return;
+            const snap = await store.load();
+            if (snap === null)
+                return;
+            if (!validateSnapshot(snap))
+                return;
+            if (snap.lastBarTime >= currentMainBarTime) {
+                pushDiagnostic(state.emissions, {
+                    kind: "diagnostic",
+                    severity: "warning",
+                    code: "state-snapshot-future-dated",
+                    message: "persistent state snapshot is ahead of the current bar cursor",
+                    slotId: null,
+                    bar: state.barIndex,
+                });
+                try {
+                    await store.clear();
+                }
+                catch (err) {
+                    pushDiagnostic(state.emissions, {
+                        kind: "diagnostic",
+                        severity: "warning",
+                        code: "state-snapshot-save-failed",
+                        message: err instanceof Error ? err.message : String(err),
+                        slotId: null,
+                        bar: state.barIndex,
+                    });
+                }
+                return;
+            }
+            restoreStateSnapshot(state, snap);
+            state.runtimeContext.lastPersistTime = snap.savedAt;
+            pushDiagnostic(state.emissions, {
+                kind: "diagnostic",
+                severity: "info",
+                code: "state-snapshot-restored",
+                message: `persistent state snapshot restored through bar ${snap.lastBarTime}`,
+                slotId: null,
+                bar: state.barIndex,
+            });
+        },
+        drain() {
+            return drainImpl(state);
+        },
+        async dispose() {
+            const finalSave = saveStateSnapshot(state, state.now());
+            disposeImpl(state);
+            await finalSave;
+        },
+    });
+}
+//# sourceMappingURL=createScriptRunner.js.map

package/dist/createScriptRunner.js.map

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

package/dist/emit/alert.d.ts

@@ -0,0 +1,46 @@
+import type { AlertOpts } from "@invinite-org/chartlang-core";
+/**
+ * Emit an `AlertEmission` for the current bar (script-facing overload).
+ *
+ * Same dual-signature contract as {@link plot}: scripts call
+ * `alert(message, opts?)`; the compiler injects the slot id as the
+ * leading argument (see the sibling `alert(slotId, message, opts?)`
+ * overload). Direct invocation without a slot id throws the sentinel
+ * error.
+ *
+ * `dedupeKey` is computed as
+ * `${slotId}::${bar}::FNV1a(message + JSON.stringify(meta))` and is
+ * stable across machines — adapters that dispatch via async channels
+ * use it for idempotency. `channels` is a snapshot of
+ * `capabilities.alerts` at emission time; adapters that gate on
+ * specific channels filter downstream.
+ *
+ * @since 0.1
+ * @example
+ *     import { defineIndicator, alert, ta } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "EMA cross",
+ *         apiVersion: 1,
+ *         compute({ bar }) {
+ *             const fast = ta.ema(bar.close, 12);
+ *             const slow = ta.ema(bar.close, 26);
+ *             if (ta.crossover(fast, slow).current) {
+ *                 alert("Fast EMA crossed above slow EMA", { severity: "info" });
+ *             }
+ *         },
+ *     });
+ */
+export declare function alert(message: string, opts?: AlertOpts): void;
+/**
+ * Emit an `AlertEmission` (compiler-injected overload). Task 2's
+ * transformer rewrites script-side `alert(msg)` into
+ * `alert(slotId, msg)`.
+ *
+ * @since 0.1
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof alert = alert;
+ *     // void fn;
+ */
+export declare function alert(slotId: string, message: string, opts?: AlertOpts): void;
+//# sourceMappingURL=alert.d.ts.map

package/dist/emit/alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/emit/alert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,8BAA8B,CAAC;AAoEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;AAC/D;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC"}

package/dist/emit/alert.js

@@ -0,0 +1,71 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { pushAlert, pushDiagnostic } from "./emissionsQueue.js";
+import { hashStringStable } from "./hash.js";
+const OUTSIDE_CTX_MESSAGE = "alert called outside an active script step";
+function computeDedupeKey(slotId, bar, message, meta) {
+    return `${slotId}::${bar}::${hashStringStable(message + JSON.stringify(meta))}`;
+}
+function snapshotUnknown(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => snapshotUnknown(item));
+    }
+    if (typeof value === "object" && value !== null) {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, snapshotUnknown(item)]));
+    }
+    return value;
+}
+function snapshotMeta(meta) {
+    return snapshotUnknown(meta);
+}
+function alertImpl(ctx, slotId, message, opts) {
+    if (ctx.capabilities.alerts.size === 0) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-alert-channel",
+            message: "Adapter declares no alert channels; alert dropped.",
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return;
+    }
+    const channels = Array.from(ctx.capabilities.alerts);
+    const bar = ctx.barIndex();
+    const meta = snapshotMeta(opts.meta ?? {});
+    const emission = {
+        kind: "alert",
+        slotId,
+        severity: opts.severity ?? "info",
+        message,
+        bar,
+        time: ctx.stream.bar.time,
+        meta,
+        channels: Object.freeze(channels.slice()),
+        dedupeKey: computeDedupeKey(slotId, bar, message, meta),
+    };
+    pushAlert(ctx.emissions, emission);
+}
+/**
+ * Implementation signature for {@link alert}. Branches on
+ * `typeof arg2 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.1
+ * @example
+ *     // const fn: typeof alert = alert;
+ *     // void fn;
+ */
+export function alert(arg1, arg2, arg3) {
+    if (typeof arg2 !== "string") {
+        // No slot id present — direct script-author invocation or
+        // missing compiler injection. Surface the sentinel.
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (!ctx)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    alertImpl(ctx, arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=alert.js.map

package/dist/emit/alert.js.map

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