experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/sandboxes/types.d.ts

@@ -0,0 +1,136 @@
+import type { SandboxCommandResult } from "../../public/definitions/sandbox.js";
+import type { JsonObject } from "../json.js";
+/**
+ * Supported internal sandbox adapter kinds.
+ */
+export type RuntimeSandboxAdapterType = "docker" | "local" | "vercel";
+/**
+ * Minimal bash-tool-compatible sandbox surface exposed to the harness.
+ */
+export interface RuntimeSandboxToolSandbox {
+    executeCommand(command: string): Promise<SandboxCommandResult>;
+    readFile(path: string): Promise<string>;
+    writeFiles(files: Array<{
+        path: string;
+        content: string | Buffer;
+    }>): Promise<void>;
+}
+/**
+ * Runtime-owned sandbox command contexts observed during one turn.
+ */
+export type RuntimeSandboxCommandContext = "bootstrap" | "on-session" | "tool";
+/**
+ * Runtime-owned observed sandbox event emitted while preparing or using one
+ * authored sandbox during a turn.
+ */
+export type RuntimeSandboxObservedEvent = RuntimeSandboxInitializedEvent | RuntimeSandboxRestoredEvent | RuntimeSandboxCommandEvent;
+/**
+ * Callback used to project observed sandbox events into higher-level runtime
+ * diagnostics such as the durable message stream.
+ */
+export type RuntimeSandboxEventSink = (event: RuntimeSandboxObservedEvent) => Promise<void> | void;
+/**
+ * Observed event emitted when one authored sandbox session is initialized for
+ * the current runtime session.
+ */
+export interface RuntimeSandboxInitializedEvent {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly kind: "initialized";
+    readonly sandboxName: string;
+}
+/**
+ * Observed event emitted when one authored sandbox session is restored for the
+ * current runtime session.
+ */
+export interface RuntimeSandboxRestoredEvent {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly kind: "restored";
+    readonly sandboxName: string;
+}
+/**
+ * Observed event emitted immediately before one sandbox command runs.
+ */
+export interface RuntimeSandboxCommandEvent {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly command: string;
+    readonly context: RuntimeSandboxCommandContext;
+    readonly kind: "command";
+    readonly sandboxName: string;
+}
+/**
+ * One live sandbox session owned by the runtime.
+ */
+export interface RuntimeSandboxLiveSession extends RuntimeSandboxToolSandbox {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly cwd: string;
+    readonly sessionKey: string;
+    captureState?(): Promise<JsonObject | null>;
+    dispose?(): Promise<void>;
+}
+/**
+ * Stable reusable template state tracked by one backend adapter.
+ */
+export interface RuntimeSandboxTemplate {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly metadata: JsonObject;
+    readonly templateKey: string;
+}
+/**
+ * Result returned after one live sandbox session is created or reattached.
+ */
+export interface RuntimeSandboxSessionUpsertResult {
+    readonly liveSandbox: RuntimeSandboxLiveSession;
+    readonly status: "initialized" | "restored";
+}
+/**
+ * Serializable per-session sandbox reconnect record stored in runtime session
+ * state.
+ */
+export interface RuntimeSandboxSessionState {
+    readonly adapter: RuntimeSandboxAdapterType;
+    readonly metadata: JsonObject;
+    readonly sandboxName: string;
+    readonly sessionKey: string;
+}
+/**
+ * Durable sandbox state carried across runtime turns.
+ */
+export interface RuntimeSandboxState {
+    readonly initializedSandboxNames: readonly string[];
+    readonly sessions: readonly RuntimeSandboxSessionState[];
+}
+/**
+ * Bash-like live tool injected into the ToolLoop harness for one sandbox.
+ */
+export interface RuntimeHarnessSandboxTool {
+    readonly cwd: string;
+    readonly description: string | null;
+    readonly name: string;
+    readonly sandbox: RuntimeSandboxToolSandbox;
+    readonly toolName: string;
+}
+/**
+ * One managed live sandbox retained by the runtime between turns.
+ */
+export interface ManagedRuntimeSandbox {
+    captureState(): Promise<RuntimeSandboxSessionState>;
+    dispose(): Promise<void>;
+    readonly live: RuntimeSandboxLiveSession;
+    readonly tool: RuntimeHarnessSandboxTool;
+}
+/**
+ * One backend binding used by the runtime-owned sandbox provider.
+ */
+export interface RuntimeSandboxBinding {
+    readonly type: RuntimeSandboxAdapterType;
+    upsertTemplate(input: {
+        readonly bootstrap?: (sandbox: RuntimeSandboxLiveSession) => Promise<void>;
+        readonly templateKey: string;
+    }): Promise<RuntimeSandboxTemplate>;
+    upsertSession(input: {
+        readonly existingMetadata?: JsonObject;
+        readonly sessionKey: string;
+        readonly template: RuntimeSandboxTemplate;
+    }): Promise<RuntimeSandboxSessionUpsertResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/runtime/sandboxes/types.d.ts.map

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

package/dist/src/runtime/sandboxes/types.js

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

package/dist/src/runtime/sandboxes/types.js.map

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

package/dist/src/runtime/schedules/register.d.ts

@@ -0,0 +1,45 @@
+import type { Nitro } from "nitro/types";
+import type { ResolvedSchedule } from "../types.js";
+/**
+ * Stable Nitro task-name prefix for framework-owned authored schedules.
+ */
+export declare const ASH_SCHEDULE_TASK_NAME_PREFIX = "ash.schedule.";
+/**
+ * One compiled schedule registration input consumed by the Nitro host.
+ */
+export interface ScheduleRegistration {
+    readonly cron: string;
+    readonly description: string;
+    readonly logicalPath: string;
+    readonly scheduleId: string;
+    readonly sourceId: string;
+    readonly taskName: string;
+}
+/**
+ * Error raised when authored schedules cannot be converted into stable runtime
+ * registrations.
+ */
+export declare class ScheduleRegistrationError extends Error {
+    readonly scheduleId?: string;
+    readonly sourceId?: string;
+    readonly taskName?: string;
+    constructor(message: string, input?: {
+        scheduleId?: string;
+        sourceId?: string;
+        taskName?: string;
+    });
+}
+/**
+ * Creates stable registration inputs for Nitro's task and cron surfaces from
+ * resolved authored schedules.
+ */
+export declare function createScheduleRegistrations(schedules: readonly ResolvedSchedule[]): ScheduleRegistration[];
+/**
+ * Registers compiled schedules with Nitro's experimental task and cron
+ * surfaces.
+ */
+export declare function registerScheduleTasks(nitro: Nitro, input: {
+    handlerPath: string;
+    registrations: readonly ScheduleRegistration[];
+}): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/src/runtime/schedules/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/runtime/schedules/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd;CAiBT;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,oBAAoB,EAAE,CAexB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE;IACL,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAChD,GACA,IAAI,CAgCN"}

package/dist/src/runtime/schedules/register.js

@@ -0,0 +1,94 @@
+/**
+ * Stable Nitro task-name prefix for framework-owned authored schedules.
+ */
+export const ASH_SCHEDULE_TASK_NAME_PREFIX = "ash.schedule.";
+/**
+ * Error raised when authored schedules cannot be converted into stable runtime
+ * registrations.
+ */
+export class ScheduleRegistrationError extends Error {
+    scheduleId;
+    sourceId;
+    taskName;
+    constructor(message, input = {}) {
+        super(message);
+        this.name = "ScheduleRegistrationError";
+        if (input.scheduleId !== undefined) {
+            this.scheduleId = input.scheduleId;
+        }
+        if (input.sourceId !== undefined) {
+            this.sourceId = input.sourceId;
+        }
+        if (input.taskName !== undefined) {
+            this.taskName = input.taskName;
+        }
+    }
+}
+/**
+ * Creates stable registration inputs for Nitro's task and cron surfaces from
+ * resolved authored schedules.
+ */
+export function createScheduleRegistrations(schedules) {
+    const registrations = schedules
+        .map((schedule) => ({
+        cron: schedule.cron,
+        description: `Run Ash schedule "${schedule.id}" from "${schedule.logicalPath}".`,
+        logicalPath: schedule.logicalPath,
+        scheduleId: schedule.id,
+        sourceId: schedule.sourceId,
+        taskName: createScheduleTaskName(schedule.sourceId),
+    }))
+        .sort((left, right) => left.sourceId.localeCompare(right.sourceId));
+    assertUniqueScheduleIds(registrations);
+    return registrations;
+}
+/**
+ * Registers compiled schedules with Nitro's experimental task and cron
+ * surfaces.
+ */
+export function registerScheduleTasks(nitro, input) {
+    if (input.registrations.length === 0) {
+        return;
+    }
+    nitro.options.experimental.tasks = true;
+    for (const registration of input.registrations) {
+        nitro.options.tasks[registration.taskName] = {
+            description: registration.description,
+            handler: input.handlerPath,
+        };
+        const existingScheduleTasks = nitro.options.scheduledTasks[registration.cron];
+        if (existingScheduleTasks === undefined) {
+            nitro.options.scheduledTasks[registration.cron] = registration.taskName;
+            continue;
+        }
+        if (typeof existingScheduleTasks === "string") {
+            nitro.options.scheduledTasks[registration.cron] = [
+                existingScheduleTasks,
+                registration.taskName,
+            ];
+            continue;
+        }
+        if (!existingScheduleTasks.includes(registration.taskName)) {
+            existingScheduleTasks.push(registration.taskName);
+        }
+    }
+}
+function assertUniqueScheduleIds(registrations) {
+    const registrationByScheduleId = new Map();
+    for (const registration of registrations) {
+        const previousRegistration = registrationByScheduleId.get(registration.scheduleId);
+        if (previousRegistration === undefined) {
+            registrationByScheduleId.set(registration.scheduleId, registration);
+            continue;
+        }
+        throw new ScheduleRegistrationError(`Duplicate authored schedule id "${registration.scheduleId}" found in "${previousRegistration.logicalPath}" and "${registration.logicalPath}".`, {
+            scheduleId: registration.scheduleId,
+            sourceId: registration.sourceId,
+            taskName: registration.taskName,
+        });
+    }
+}
+function createScheduleTaskName(sourceId) {
+    return `${ASH_SCHEDULE_TASK_NAME_PREFIX}${Buffer.from(sourceId, "utf8").toString("base64url")}`;
+}
+//# sourceMappingURL=register.js.map

package/dist/src/runtime/schedules/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/runtime/schedules/register.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC;AAc7D;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,UAAU,CAAU;IACpB,QAAQ,CAAU;IAClB,QAAQ,CAAU;IAE3B,YACE,OAAe,EACf,QAII,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QAExC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACrC,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAsC;IAEtC,MAAM,aAAa,GAAG,SAAS;SAC5B,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,qBAAqB,QAAQ,CAAC,EAAE,WAAW,QAAQ,CAAC,WAAW,IAAI;QAChF,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACpD,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtE,uBAAuB,CAAC,aAAa,CAAC,CAAC;IAEvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAY,EACZ,KAGC;IAED,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC;IAExC,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG;YAC3C,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,OAAO,EAAE,KAAK,CAAC,WAAW;SAC3B,CAAC;QAEF,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAE9E,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;YACxC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC;YACxE,SAAS;QACX,CAAC;QAED,IAAI,OAAO,qBAAqB,KAAK,QAAQ,EAAE,CAAC;YAC9C,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG;gBAChD,qBAAqB;gBACrB,YAAY,CAAC,QAAQ;aACtB,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,aAA8C;IAC7E,MAAM,wBAAwB,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEzE,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAEnF,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACvC,wBAAwB,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QAED,MAAM,IAAI,yBAAyB,CACjC,mCAAmC,YAAY,CAAC,UAAU,eAAe,oBAAoB,CAAC,WAAW,UAAU,YAAY,CAAC,WAAW,IAAI,EAC/I;YACE,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,GAAG,6BAA6B,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;AAClG,CAAC"}

package/dist/src/runtime/schedules/resolve-schedule.d.ts

@@ -0,0 +1,41 @@
+import type { CompiledAgentManifest } from "../../compiler/manifest.js";
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { ResolvedSchedule } from "../types.js";
+/**
+ * Input for resolving authored schedules from the compiled manifest.
+ */
+export interface ResolveSchedulesInput {
+    manifest: CompiledAgentManifest;
+}
+/**
+ * Explicit compiled-artifact source used to resolve schedules from runtime
+ * artifacts.
+ */
+export interface LoadResolvedCompiledSchedulesInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+}
+/**
+ * Error raised when compiled authored schedules cannot be hydrated into one
+ * runtime-owned schedule model.
+ */
+export declare class ResolveScheduleError extends Error {
+    readonly taskName?: string;
+    constructor(message: string, input?: {
+        taskName?: string;
+    });
+}
+/**
+ * Resolves runtime-owned schedules from the compiled manifest.
+ */
+export declare function resolveSchedules(input: ResolveSchedulesInput): Promise<ResolvedSchedule[]>;
+/**
+ * Loads the compiled manifest, then resolves authored schedules into
+ * runtime-owned schedule models.
+ */
+export declare function loadResolvedCompiledSchedules(input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedSchedule[]>;
+/**
+ * Loads and resolves one compiled authored schedule from its registered Nitro
+ * task name.
+ */
+export declare function loadResolvedCompiledScheduleByTaskName(taskName: string, input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedSchedule>;
+//# sourceMappingURL=resolve-schedule.d.ts.map

package/dist/src/runtime/schedules/resolve-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-schedule.d.ts","sourceRoot":"","sources":["../../../../src/runtime/schedules/resolve-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAEtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;CAClE;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd;CAST;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAShG;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAQ7B;AAED;;;GAGG;AACH,wBAAsB,sCAAsC,CAC1D,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}

package/dist/src/runtime/schedules/resolve-schedule.js

@@ -0,0 +1,61 @@
+import { loadCompiledManifest } from "../loaders/manifest.js";
+import { createScheduleRegistrations } from "./register.js";
+/**
+ * Error raised when compiled authored schedules cannot be hydrated into one
+ * runtime-owned schedule model.
+ */
+export class ResolveScheduleError extends Error {
+    taskName;
+    constructor(message, input = {}) {
+        super(message);
+        this.name = "ResolveScheduleError";
+        if (input.taskName !== undefined) {
+            this.taskName = input.taskName;
+        }
+    }
+}
+/**
+ * Resolves runtime-owned schedules from the compiled manifest.
+ */
+export async function resolveSchedules(input) {
+    return [...input.manifest.schedules].map((schedule) => ({
+        cron: schedule.cron,
+        id: schedule.id,
+        logicalPath: schedule.logicalPath,
+        markdown: schedule.markdown,
+        sourceId: schedule.sourceId,
+        sourceKind: schedule.sourceKind,
+    }));
+}
+/**
+ * Loads the compiled manifest, then resolves authored schedules into
+ * runtime-owned schedule models.
+ */
+export async function loadResolvedCompiledSchedules(input) {
+    const manifest = await loadCompiledManifest({
+        compiledArtifactsSource: input.compiledArtifactsSource,
+    });
+    return await resolveSchedules({
+        manifest,
+    });
+}
+/**
+ * Loads and resolves one compiled authored schedule from its registered Nitro
+ * task name.
+ */
+export async function loadResolvedCompiledScheduleByTaskName(taskName, input) {
+    const schedules = await loadResolvedCompiledSchedules(input);
+    const scheduleBySourceId = new Map(schedules.map((schedule) => [schedule.sourceId, schedule]));
+    for (const registration of createScheduleRegistrations(schedules)) {
+        if (registration.taskName === taskName) {
+            const schedule = scheduleBySourceId.get(registration.sourceId);
+            if (schedule !== undefined) {
+                return schedule;
+            }
+        }
+    }
+    throw new ResolveScheduleError(`No compiled authored schedule is registered for Nitro task "${taskName}".`, {
+        taskName,
+    });
+}
+//# sourceMappingURL=resolve-schedule.js.map

package/dist/src/runtime/schedules/resolve-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-schedule.js","sourceRoot":"","sources":["../../../../src/runtime/schedules/resolve-schedule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAiB5D;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,QAAQ,CAAU;IAE3B,YACE,OAAe,EACf,QAEI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QAEnC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA4B;IACjE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAyC;IAEzC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC;QAC1C,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;KACvD,CAAC,CAAC;IAEH,OAAO,MAAM,gBAAgB,CAAC;QAC5B,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,QAAgB,EAChB,KAAyC;IAEzC,MAAM,SAAS,GAAG,MAAM,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/F,KAAK,MAAM,YAAY,IAAI,2BAA2B,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,IAAI,YAAY,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE/D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,oBAAoB,CAC5B,+DAA+D,QAAQ,IAAI,EAC3E;QACE,QAAQ;KACT,CACF,CAAC;AACJ,CAAC"}

package/dist/src/runtime/session-context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stable turn metadata describing the active authored execution scope.
+ */
+export interface SessionTurn {
+    readonly id: string;
+    readonly sequence: number;
+}
+/**
+ * Stable lineage metadata describing the immediate Ash parent execution that
+ * delegated the current session.
+ */
+export interface SessionParent {
+    readonly runId: string;
+    readonly sessionId: string;
+    readonly turn: SessionTurn;
+}
+/**
+ * Public runtime session metadata exposed to authored code during active Ash
+ * execution.
+ */
+export interface Session {
+    readonly parent?: SessionParent;
+    readonly sessionId: string;
+    readonly runId: string;
+    readonly turn: SessionTurn;
+}
+/**
+ * Runs one authored execution boundary with the provided session bound to the
+ * current async call chain.
+ */
+export declare function runWithActiveSession<T>(session: Session, callback: () => T): T;
+/**
+ * Returns the active Ash session for the current authored async execution
+ * chain.
+ *
+ * Throws when called outside authored runtime execution, such as top-level
+ * module evaluation.
+ */
+export declare function getSession(): Session;
+//# sourceMappingURL=session-context.d.ts.map

package/dist/src/runtime/session-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../src/runtime/session-context.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AASD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAUpC"}

package/dist/src/runtime/session-context.js

@@ -0,0 +1,55 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const ashRuntimeSessionGlobal = globalThis;
+const runtimeSessionStorage = getOrCreateRuntimeSessionStorage();
+/**
+ * Runs one authored execution boundary with the provided session bound to the
+ * current async call chain.
+ */
+export function runWithActiveSession(session, callback) {
+    return runtimeSessionStorage.run(createSessionSnapshot(session), callback);
+}
+/**
+ * Returns the active Ash session for the current authored async execution
+ * chain.
+ *
+ * Throws when called outside authored runtime execution, such as top-level
+ * module evaluation.
+ */
+export function getSession() {
+    const session = runtimeSessionStorage.getStore();
+    if (session === undefined) {
+        throw new Error("Ash session metadata is unavailable in the current async context. Call getSession() only from authored runtime functions such as tools, steps, and model callbacks.");
+    }
+    return session;
+}
+function createSessionSnapshot(session) {
+    const snapshot = {
+        sessionId: session.sessionId,
+        runId: session.runId,
+        turn: createSessionTurnSnapshot(session.turn),
+    };
+    if (session.parent !== undefined) {
+        snapshot.parent = Object.freeze({
+            runId: session.parent.runId,
+            sessionId: session.parent.sessionId,
+            turn: createSessionTurnSnapshot(session.parent.turn),
+        });
+    }
+    return Object.freeze(snapshot);
+}
+function createSessionTurnSnapshot(turn) {
+    return Object.freeze({
+        id: turn.id,
+        sequence: turn.sequence,
+    });
+}
+function getOrCreateRuntimeSessionStorage() {
+    const existingStorage = ashRuntimeSessionGlobal.__ashRuntimeSessionStorage__;
+    if (existingStorage !== undefined) {
+        return existingStorage;
+    }
+    const createdStorage = new AsyncLocalStorage();
+    ashRuntimeSessionGlobal.__ashRuntimeSessionStorage__ = createdStorage;
+    return createdStorage;
+}
+//# sourceMappingURL=session-context.js.map

package/dist/src/runtime/session-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context.js","sourceRoot":"","sources":["../../../src/runtime/session-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAmCrD,MAAM,uBAAuB,GAAG,UAAyD,CAAC;AAC1F,MAAM,qBAAqB,GAAG,gCAAgC,EAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAI,OAAgB,EAAE,QAAiB;IACzE,OAAO,qBAAqB,CAAC,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,EAAE,CAAC;IAEjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,qKAAqK,CACtK,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,MAAM,QAAQ,GAKV;QACF,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC;KAC9C,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;YAC3B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACnC,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAiB;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gCAAgC;IACvC,MAAM,eAAe,GAAG,uBAAuB,CAAC,4BAA4B,CAAC;IAE7E,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAW,CAAC;IACxD,uBAAuB,CAAC,4BAA4B,GAAG,cAAc,CAAC;IACtE,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/src/runtime/sessions/compiled-agent-cache.d.ts

@@ -0,0 +1,25 @@
+import type { RuntimeTurnAgent } from "../agent/bootstrap.js";
+import { type RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { ResolvedAgentGraphBundle } from "../graph.js";
+import type { RuntimeSubagentRegistry } from "../subagents/registry.js";
+import type { RuntimeToolRegistry } from "../tools/registry.js";
+import type { ResolvedAgent } from "../types.js";
+/**
+ * Returns one cached prepared runtime agent bundle for the requested compiled
+ * artifact source.
+ */
+export declare function getCompiledRuntimeAgentBundle(input: {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+}): Promise<{
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    readonly graph: ResolvedAgentGraphBundle;
+    readonly resolvedAgent: ResolvedAgent;
+    readonly subagentRegistry: RuntimeSubagentRegistry;
+    readonly toolRegistry: RuntimeToolRegistry;
+    readonly turnAgent: RuntimeTurnAgent;
+}>;
+/**
+ * Clears all cached compiled runtime agent bundles.
+ */
+export declare function clearCompiledRuntimeAgentBundleCache(): void;
+//# sourceMappingURL=compiled-agent-cache.d.ts.map

package/dist/src/runtime/sessions/compiled-agent-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-agent-cache.d.ts","sourceRoot":"","sources":["../../../../src/runtime/sessions/compiled-agent-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoCjD;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;CAClE,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC,CAAC,CAsBD;AAED;;GAEG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/src/runtime/sessions/compiled-agent-cache.js

@@ -0,0 +1,48 @@
+import { getRuntimeCompiledArtifactsCacheKey, } from "../compiled-artifacts-source.js";
+import { loadResolvedCompiledAgentGraph } from "../loaders/resolved-agent.js";
+const compiledRuntimeAgentBundleCache = new Map();
+/**
+ * Runtime option for disabling the compiled-turn cache when debugging local state changes.
+ */
+const isCacheDisabled = process.env.ASH_DISABLE_AGENT_CACHE === "1";
+async function loadCompiledRuntimeAgentBundle(compiledArtifactsSource) {
+    const graph = await loadResolvedCompiledAgentGraph({
+        compiledArtifactsSource,
+    });
+    const rootNode = graph.root;
+    return {
+        compiledArtifactsSource,
+        graph,
+        resolvedAgent: rootNode.agent,
+        subagentRegistry: rootNode.subagentRegistry,
+        toolRegistry: rootNode.toolRegistry,
+        turnAgent: rootNode.turnAgent,
+    };
+}
+/**
+ * Returns one cached prepared runtime agent bundle for the requested compiled
+ * artifact source.
+ */
+export async function getCompiledRuntimeAgentBundle(input) {
+    if (isCacheDisabled) {
+        return loadCompiledRuntimeAgentBundle(input.compiledArtifactsSource);
+    }
+    const cacheKey = getRuntimeCompiledArtifactsCacheKey(input.compiledArtifactsSource);
+    const cachedBundle = compiledRuntimeAgentBundleCache.get(cacheKey);
+    if (cachedBundle !== undefined) {
+        return cachedBundle;
+    }
+    const bundlePromise = loadCompiledRuntimeAgentBundle(input.compiledArtifactsSource).catch((error) => {
+        compiledRuntimeAgentBundleCache.delete(cacheKey);
+        throw error;
+    });
+    compiledRuntimeAgentBundleCache.set(cacheKey, bundlePromise);
+    return bundlePromise;
+}
+/**
+ * Clears all cached compiled runtime agent bundles.
+ */
+export function clearCompiledRuntimeAgentBundleCache() {
+    compiledRuntimeAgentBundleCache.clear();
+}
+//# sourceMappingURL=compiled-agent-cache.js.map

package/dist/src/runtime/sessions/compiled-agent-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-agent-cache.js","sourceRoot":"","sources":["../../../../src/runtime/sessions/compiled-agent-cache.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mCAAmC,GAEpC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAc9E,MAAM,+BAA+B,GAAG,IAAI,GAAG,EAA+C,CAAC;AAE/F;;GAEG;AACH,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;AAEpE,KAAK,UAAU,8BAA8B,CAC3C,uBAAuD;IAEvD,MAAM,KAAK,GAAG,MAAM,8BAA8B,CAAC;QACjD,uBAAuB;KACxB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;IAE5B,OAAO;QACL,uBAAuB;QACvB,KAAK;QACL,aAAa,EAAE,QAAQ,CAAC,KAAK;QAC7B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,KAEnD;IAQC,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,8BAA8B,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,mCAAmC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACpF,MAAM,YAAY,GAAG,+BAA+B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEnE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,aAAa,GAAG,8BAA8B,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,KAAK,CACvF,CAAC,KAAK,EAAE,EAAE;QACR,+BAA+B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IAEF,+BAA+B,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE7D,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC;IAClD,+BAA+B,CAAC,KAAK,EAAE,CAAC;AAC1C,CAAC"}