experimental-ash 0.1.0-alpha.1

package/dist/src/internal/nitro/routes/index.js

@@ -0,0 +1,45 @@
+import { useRuntimeConfig } from "nitro/runtime-config";
+import { buildHomePageViewModel } from "./home-page/build-home-page-view-model.js";
+import { loadHomePageData, resolveHomePageCompiledArtifactsSource, } from "./home-page/load-home-page-data.js";
+import { renderHomePage } from "./home-page/render-home-page.js";
+function resolveConfiguredRuntimeConfig() {
+    return useRuntimeConfig();
+}
+function resolveConfiguredAppRoot() {
+    const runtimeConfig = resolveConfiguredRuntimeConfig();
+    return typeof runtimeConfig.ash?.appRoot === "string" ? runtimeConfig.ash.appRoot : undefined;
+}
+function resolveConfiguredHomePageTemplate() {
+    const runtimeConfig = resolveConfiguredRuntimeConfig();
+    if (typeof runtimeConfig.ash?.homePageTemplate !== "string") {
+        throw new Error("Missing Ash home page template in Nitro runtime config.");
+    }
+    return runtimeConfig.ash.homePageTemplate;
+}
+async function createHomePageHtml(input = {}) {
+    const template = resolveConfiguredHomePageTemplate();
+    const data = await loadHomePageData({
+        compiledArtifactsSource: resolveHomePageCompiledArtifactsSource({
+            appRoot: input.appRoot ?? resolveConfiguredAppRoot(),
+        }),
+    });
+    const viewModel = buildHomePageViewModel(data);
+    return renderHomePage(template, viewModel);
+}
+/**
+ * Builds the package-owned home page response for one resolved application.
+ */
+export async function handleHomePageRequest(input = {}) {
+    return new Response(await createHomePageHtml(input), {
+        headers: {
+            "content-type": "text/html; charset=utf-8",
+        },
+    });
+}
+/**
+ * Nitro route for Ash's package-owned home page.
+ */
+export default async () => {
+    return await handleHomePageRequest();
+};
+//# sourceMappingURL=index.js.map

package/dist/src/internal/nitro/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/internal/nitro/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,sCAAsC,GACvC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AASjE,SAAS,8BAA8B;IACrC,OAAO,gBAAgB,EAA2B,CAAC;AACrD,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,aAAa,GAAG,8BAA8B,EAAE,CAAC;IAEvD,OAAO,OAAO,aAAa,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAChG,CAAC;AAED,SAAS,iCAAiC;IACxC,MAAM,aAAa,GAAG,8BAA8B,EAAE,CAAC;IAEvD,IAAI,OAAO,aAAa,CAAC,GAAG,EAAE,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAA8B,EAAE;IAChE,MAAM,QAAQ,GAAG,iCAAiC,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;QAClC,uBAAuB,EAAE,sCAAsC,CAAC;YAC9D,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,wBAAwB,EAAE;SACrD,CAAC;KACH,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE/C,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAA8B,EAAE;IAC1E,OAAO,IAAI,QAAQ,CAAC,MAAM,kBAAkB,CAAC,KAAK,CAAC,EAAE;QACnD,OAAO,EAAE;YACP,cAAc,EAAE,0BAA0B;SAC3C;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,eAAe,KAAK,IAAuB,EAAE;IAC3C,OAAO,MAAM,qBAAqB,EAAE,CAAC;AACvC,CAAC,CAAC"}

package/dist/src/internal/nitro/routes/message.d.ts

@@ -0,0 +1,9 @@
+interface NitroRouteContext {
+    req: Request;
+}
+/**
+ * Nitro route for Ash's vendored message workflow endpoint.
+ */
+declare const _default: (event: NitroRouteContext) => Promise<Response>;
+export default _default;
+//# sourceMappingURL=message.d.ts.map

package/dist/src/internal/nitro/routes/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../src/internal/nitro/routes/message.ts"],"names":[],"mappings":"AAEA,UAAU,iBAAiB;IACzB,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;yBACmB,OAAO,iBAAiB;AAA9C,wBAEE"}

package/dist/src/internal/nitro/routes/message.js

@@ -0,0 +1,8 @@
+import { handleMessageRequest } from "../../message/handler.js";
+/**
+ * Nitro route for Ash's vendored message workflow endpoint.
+ */
+export default async (event) => {
+    return await handleMessageRequest(event.req);
+};
+//# sourceMappingURL=message.js.map

package/dist/src/internal/nitro/routes/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../../../src/internal/nitro/routes/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMhE;;GAEG;AACH,eAAe,KAAK,EAAE,KAAwB,EAAE,EAAE;IAChD,OAAO,MAAM,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC,CAAC"}

package/dist/src/internal/nitro/routes/run-stream.d.ts

@@ -0,0 +1,14 @@
+interface NitroRouteContext {
+    context: {
+        params?: {
+            runId?: string;
+        };
+    };
+    req: Request;
+}
+/**
+ * Nitro route for reading one durable message workflow stream.
+ */
+declare const _default: (event: NitroRouteContext) => Promise<Response>;
+export default _default;
+//# sourceMappingURL=run-stream.d.ts.map

package/dist/src/internal/nitro/routes/run-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../../../../src/internal/nitro/routes/run-stream.ts"],"names":[],"mappings":"AAEA,UAAU,iBAAiB;IACzB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE;YACP,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;yBACmB,OAAO,iBAAiB,KAAG,OAAO,CAAC,QAAQ,CAAC;AAAlE,wBAcE"}

package/dist/src/internal/nitro/routes/run-stream.js

@@ -0,0 +1,15 @@
+import { handleRunStreamRequest } from "../../message/handler.js";
+/**
+ * Nitro route for reading one durable message workflow stream.
+ */
+export default async (event) => {
+    const runId = event.context.params?.runId;
+    if (!runId) {
+        return Response.json({
+            error: "Missing run id.",
+            ok: false,
+        }, { status: 400 });
+    }
+    return await handleRunStreamRequest(event.req, runId);
+};
+//# sourceMappingURL=run-stream.js.map

package/dist/src/internal/nitro/routes/run-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stream.js","sourceRoot":"","sources":["../../../../../src/internal/nitro/routes/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAWlE;;GAEG;AACH,eAAe,KAAK,EAAE,KAAwB,EAAqB,EAAE;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;IAE1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC,IAAI,CAClB;YACE,KAAK,EAAE,iBAAiB;YACxB,EAAE,EAAE,KAAK;SACV,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC,CAAC"}

package/dist/src/internal/nitro/shims/schedule-task-handler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Creates the generated Nitro task shim that dispatches compiled authored
+ * schedules into Ash's durable schedule workflow.
+ */
+export declare function createScheduleTaskHandlerShimSource(input: {
+    nitroTaskModulePath: string;
+    schedules: Record<string, {
+        message: string;
+        scheduleId: string;
+    }>;
+    workflowApiModulePath: string;
+    workflowReference: {
+        workflowId: string;
+    };
+}): string;
+//# sourceMappingURL=schedule-task-handler.d.ts.map

package/dist/src/internal/nitro/shims/schedule-task-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-task-handler.d.ts","sourceRoot":"","sources":["../../../../../src/internal/nitro/shims/schedule-task-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CACf,MAAM,EACN;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CACF,CAAC;IACF,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,GAAG,MAAM,CAiCT"}

package/dist/src/internal/nitro/shims/schedule-task-handler.js

@@ -0,0 +1,39 @@
+/**
+ * Creates the generated Nitro task shim that dispatches compiled authored
+ * schedules into Ash's durable schedule workflow.
+ */
+export function createScheduleTaskHandlerShimSource(input) {
+    return `import { defineTask } from ${JSON.stringify(input.nitroTaskModulePath)};
+import { start } from ${JSON.stringify(input.workflowApiModulePath)};
+
+const schedules = Object.freeze(${JSON.stringify(input.schedules, null, 2)});
+
+export default defineTask({
+  meta: {
+    description: "Dispatch one compiled Ash authored schedule.",
+  },
+  async run(event) {
+    const schedule = schedules[event.name];
+
+    if (schedule === undefined) {
+      throw new Error("No compiled authored schedule is registered for Nitro task \\"" + String(event.name) + "\\".");
+    }
+
+    const run = await start(${JSON.stringify(input.workflowReference)}, [
+      {
+        message: schedule.message,
+        scheduleId: schedule.scheduleId,
+      },
+    ]);
+
+    return {
+      result: {
+        runId: run.runId,
+        scheduleId: schedule.scheduleId,
+      },
+    };
+  },
+});
+`;
+}
+//# sourceMappingURL=schedule-task-handler.js.map

package/dist/src/internal/nitro/shims/schedule-task-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-task-handler.js","sourceRoot":"","sources":["../../../../../src/internal/nitro/shims/schedule-task-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAanD;IACC,OAAO,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mBAAmB,CAAC;wBACxD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC;;kCAEjC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;8BAa5C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;CAepE,CAAC;AACF,CAAC"}

package/dist/src/internal/object.d.ts

@@ -0,0 +1,18 @@
+type KeysWithUndefined<T extends object> = {
+    [Key in keyof T]-?: undefined extends T[Key] ? Key : never;
+}[keyof T];
+type OptionalizeUndefinedProperties<T extends object> = {
+    [Key in keyof T as Key extends KeysWithUndefined<T> ? never : Key]: T[Key];
+} & {
+    [Key in keyof T as Key extends KeysWithUndefined<T> ? Key : never]?: Exclude<T[Key], undefined>;
+};
+/**
+ * Returns a shallow copy with every own string-keyed property whose value is
+ * `undefined` removed.
+ *
+ * This keeps object literals readable while still satisfying
+ * `exactOptionalPropertyTypes`.
+ */
+export declare function omitUndefinedProperties<const T extends object>(value: T): OptionalizeUndefinedProperties<T>;
+export {};
+//# sourceMappingURL=object.d.ts.map

package/dist/src/internal/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/internal/object.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI;KACxC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK;CAC3D,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,KAAK,8BAA8B,CAAC,CAAC,SAAS,MAAM,IAAI;KACrD,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;CAC3E,GAAG;KACD,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAChG,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5D,KAAK,EAAE,CAAC,GACP,8BAA8B,CAAC,CAAC,CAAC,CAUnC"}

package/dist/src/internal/object.js

@@ -0,0 +1,17 @@
+/**
+ * Returns a shallow copy with every own string-keyed property whose value is
+ * `undefined` removed.
+ *
+ * This keeps object literals readable while still satisfying
+ * `exactOptionalPropertyTypes`.
+ */
+export function omitUndefinedProperties(value) {
+    const result = {};
+    for (const [key, propertyValue] of Object.entries(value)) {
+        if (propertyValue !== undefined) {
+            result[key] = propertyValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=object.js.map

package/dist/src/internal/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../src/internal/object.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAQ;IAER,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,MAA2C,CAAC;AACrD,CAAC"}

package/dist/src/internal/runtime-model.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default real model id used when an authored agent does not override the
+ * runtime model in `agent.ts`.
+ */
+export declare const DEFAULT_RUNTIME_MODEL_ID = "openai/gpt-5.4";
+//# sourceMappingURL=runtime-model.d.ts.map

package/dist/src/internal/runtime-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.d.ts","sourceRoot":"","sources":["../../../src/internal/runtime-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mBAAmB,CAAC"}

package/dist/src/internal/runtime-model.js

@@ -0,0 +1,6 @@
+/**
+ * Default real model id used when an authored agent does not override the
+ * runtime model in `agent.ts`.
+ */
+export const DEFAULT_RUNTIME_MODEL_ID = "openai/gpt-5.4";
+//# sourceMappingURL=runtime-model.js.map

package/dist/src/internal/runtime-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.js","sourceRoot":"","sources":["../../../src/internal/runtime-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC"}

package/dist/src/internal/source-ref.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Stable reference to an authored source discovered from disk.
+ */
+export interface SourceRef {
+    /**
+     * Stable source id used across manifests, compiler artifacts, and runtime
+     * loaders.
+     */
+    sourceId: string;
+    /**
+     * Agent-root-relative logical path for the authored source.
+     */
+    logicalPath: string;
+}
+/**
+ * Inline source reference for markdown-authored definitions.
+ */
+export interface MarkdownSourceRef<TDefinition> extends SourceRef {
+    /**
+     * Discriminator for markdown-backed authored sources.
+     */
+    kind: "markdown";
+    /**
+     * Lowered public definition derived from the markdown source.
+     */
+    definition: TDefinition;
+}
+/**
+ * Deferred source reference for module-authored definitions discovered from
+ * disk.
+ */
+export interface ModuleSourceRef extends SourceRef {
+    /**
+     * Discriminator for module-backed authored sources.
+     */
+    kind: "module";
+    /**
+     * Optional module export name. Omitted values default to the module's default
+     * export.
+     */
+    exportName?: string;
+}
+/**
+ * Shared authored source reference for markdown-backed and module-backed
+ * definitions.
+ */
+export type AuthoredSourceRef<TDefinition> = MarkdownSourceRef<TDefinition> | ModuleSourceRef;
+//# sourceMappingURL=source-ref.d.ts.map

package/dist/src/internal/source-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-ref.d.ts","sourceRoot":"","sources":["../../../src/internal/source-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,WAAW,CAAE,SAAQ,SAAS;IAC/D;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,WAAW,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,WAAW,IAAI,iBAAiB,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC"}

package/dist/src/internal/source-ref.js

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

package/dist/src/internal/source-ref.js.map

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

package/dist/src/protocol/message.d.ts

@@ -0,0 +1,356 @@
+import type { RuntimeActionRequest, RuntimeActionResult } from "../runtime/actions/types.js";
+import type { JsonObject } from "../runtime/json.js";
+export declare const ASH_RUN_ID_HEADER = "x-ash-run-id";
+export declare const ASH_STREAM_FORMAT_HEADER = "x-ash-stream-format";
+export declare const ASH_STREAM_VERSION_HEADER = "x-ash-stream-version";
+export declare const ASH_WORKFLOW_ID_HEADER = "x-ash-workflow-id";
+export declare const ASH_MESSAGE_STREAM_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
+export declare const ASH_MESSAGE_STREAM_FORMAT = "ndjson";
+export declare const ASH_MESSAGE_STREAM_VERSION = "4";
+/**
+ * Supported session-message actions for the canonical message route.
+ */
+export declare const MessageSessionAction: {
+    readonly NextMessage: "next-message";
+};
+/**
+ * Supported actions accepted by the canonical message route.
+ */
+export type MessageSessionAction = (typeof MessageSessionAction)[keyof typeof MessageSessionAction];
+/**
+ * Invocation metadata attached to the `run.started` event for one child
+ * subagent workflow run.
+ */
+export interface SubagentRunInvocationMetadata {
+    readonly kind: "subagent";
+    readonly parentCallId: string;
+    readonly parentRunId: string;
+    readonly parentTurnId: string;
+    readonly subagentId: string;
+}
+/**
+ * JSON request accepted by the canonical message route.
+ */
+export type HandleMessageRequestBody = {
+    readonly message: string;
+} | {
+    readonly action: MessageSessionAction;
+    readonly message: string;
+    readonly runId: string;
+};
+/**
+ * JSON response returned when the message route accepts a start or resume
+ * request.
+ */
+export interface HandleMessageStartResponse {
+    readonly ok: true;
+    readonly runId: string;
+}
+/**
+ * Stream event emitted when the durable message workflow starts.
+ */
+export interface RunStartedStreamEvent {
+    data: {
+        invocation?: SubagentRunInvocationMetadata;
+        runId: string;
+        sessionId: string;
+    };
+    type: "run.started";
+}
+/**
+ * Stream event emitted when one runtime turn starts.
+ */
+export interface TurnStartedStreamEvent {
+    data: {
+        sequence: number;
+        turnId: string;
+    };
+    type: "turn.started";
+}
+/**
+ * Stream event emitted when the runtime receives one normalized user message.
+ */
+export interface MessageReceivedStreamEvent {
+    data: {
+        message: string;
+        sequence: number;
+        turnId: string;
+    };
+    type: "message.received";
+}
+/**
+ * Stream event emitted when one authored sandbox session is initialized for
+ * the current turn.
+ */
+export interface SandboxInitializedStreamEvent {
+    data: {
+        adapter: "docker" | "local" | "vercel";
+        sandboxName: string;
+        sequence: number;
+        turnId: string;
+    };
+    type: "sandbox.initialized";
+}
+/**
+ * Stream event emitted when one authored sandbox session is restored for the
+ * current turn.
+ */
+export interface SandboxRestoredStreamEvent {
+    data: {
+        adapter: "docker" | "local" | "vercel";
+        sandboxName: string;
+        sequence: number;
+        turnId: string;
+    };
+    type: "sandbox.restored";
+}
+/**
+ * Stream event emitted immediately before one authored sandbox command runs.
+ */
+export interface SandboxCommandStreamEvent {
+    data: {
+        adapter: "docker" | "local" | "vercel";
+        command: string;
+        context: "bootstrap" | "on-session" | "tool";
+        sandboxName: string;
+        sequence: number;
+        turnId: string;
+    };
+    type: "sandbox.command";
+}
+/**
+ * Stream event emitted when the harness requests runtime action execution.
+ */
+export interface ActionsRequestedStreamEvent {
+    data: {
+        actions: readonly RuntimeActionRequest[];
+        sequence: number;
+        turnId: string;
+    };
+    type: "actions.requested";
+}
+/**
+ * Stream event emitted for each runtime action result projected back into the
+ * session loop.
+ */
+export interface ActionResultStreamEvent {
+    data: {
+        result: RuntimeActionResult;
+        sequence: number;
+        turnId: string;
+    };
+    type: "action.result";
+}
+/**
+ * Stream event emitted when the parent workflow starts a child subagent run.
+ */
+export interface SubagentCalledStreamEvent {
+    data: {
+        callId: string;
+        childRunId: string;
+        runId: string;
+        sequence: number;
+        subagentId: string;
+        toolName: string;
+        turnId: string;
+        workflowId: string;
+    };
+    type: "subagent.called";
+}
+/**
+ * Stream event emitted after the harness finishes one turn.
+ */
+export interface MessageCompletedStreamEvent {
+    data: {
+        message: string | null;
+        sequence: number;
+        turnId: string;
+    };
+    type: "message.completed";
+}
+/**
+ * Stream event emitted when one turn reaches a terminal per-turn outcome.
+ */
+export interface TurnCompletedStreamEvent {
+    data: {
+        sequence: number;
+        status: "completed" | "failed";
+        turnId: string;
+    };
+    type: "turn.completed";
+}
+/**
+ * Stream event emitted when the session parks waiting for the next user
+ * message.
+ */
+export interface SessionWaitingStreamEvent {
+    data: {
+        runId: string;
+        sessionId: string;
+        wait: "next-user-message";
+    };
+    type: "session.waiting";
+}
+/**
+ * Stream event emitted when the workflow run fails.
+ */
+export interface RunFailedStreamEvent {
+    data: {
+        code: string;
+        details?: JsonObject;
+        message: string;
+        runId: string;
+        sessionId: string;
+    };
+    type: "run.failed";
+}
+/**
+ * Stream event emitted when the workflow run completes-final.
+ */
+export interface RunCompletedStreamEvent {
+    data: {
+        runId: string;
+        sessionId: string;
+    };
+    type: "run.completed";
+}
+/**
+ * Serializable stream event union for the durable message session flow.
+ */
+export type HandleMessageStreamEvent = MessageCompletedStreamEvent | MessageReceivedStreamEvent | RunCompletedStreamEvent | RunFailedStreamEvent | RunStartedStreamEvent | SandboxCommandStreamEvent | SandboxInitializedStreamEvent | SandboxRestoredStreamEvent | SessionWaitingStreamEvent | SubagentCalledStreamEvent | ActionsRequestedStreamEvent | ActionResultStreamEvent | TurnCompletedStreamEvent | TurnStartedStreamEvent;
+/**
+ * Returns the stable stream route path for one message workflow run.
+ */
+export declare function createMessageRunStreamPath(runId: string): string;
+/**
+ * Returns true when the current stream has reached a turn boundary or terminal
+ * run outcome.
+ */
+export declare function isCurrentTurnBoundaryEvent(event: HandleMessageStreamEvent): boolean;
+/**
+ * Creates the `run.started` event for one session run.
+ */
+export declare function createRunStartedEvent(input: {
+    readonly invocation?: SubagentRunInvocationMetadata;
+    readonly runId: string;
+    readonly sessionId: string;
+}): RunStartedStreamEvent;
+/**
+ * Creates the `turn.started` event for one prepared runtime turn.
+ */
+export declare function createTurnStartedEvent(input: {
+    readonly sequence: number;
+    readonly turnId: string;
+}): TurnStartedStreamEvent;
+/**
+ * Creates the `message.received` event for one normalized user message.
+ */
+export declare function createMessageReceivedEvent(input: {
+    readonly message: string;
+    readonly sequence: number;
+    readonly turnId: string;
+}): MessageReceivedStreamEvent;
+/**
+ * Creates the `sandbox.initialized` event for one authored sandbox session.
+ */
+export declare function createSandboxInitializedEvent(input: {
+    readonly adapter: SandboxInitializedStreamEvent["data"]["adapter"];
+    readonly sandboxName: string;
+    readonly sequence: number;
+    readonly turnId: string;
+}): SandboxInitializedStreamEvent;
+/**
+ * Creates the `sandbox.restored` event for one authored sandbox session.
+ */
+export declare function createSandboxRestoredEvent(input: {
+    readonly adapter: SandboxRestoredStreamEvent["data"]["adapter"];
+    readonly sandboxName: string;
+    readonly sequence: number;
+    readonly turnId: string;
+}): SandboxRestoredStreamEvent;
+/**
+ * Creates the `sandbox.command` event for one authored sandbox command.
+ */
+export declare function createSandboxCommandEvent(input: {
+    readonly adapter: SandboxCommandStreamEvent["data"]["adapter"];
+    readonly command: string;
+    readonly context: SandboxCommandStreamEvent["data"]["context"];
+    readonly sandboxName: string;
+    readonly sequence: number;
+    readonly turnId: string;
+}): SandboxCommandStreamEvent;
+/**
+ * Creates the `actions.requested` event for one paused harness outcome.
+ */
+export declare function createActionsRequestedEvent(input: {
+    readonly actions: readonly RuntimeActionRequest[];
+    readonly sequence: number;
+    readonly turnId: string;
+}): ActionsRequestedStreamEvent;
+/**
+ * Creates the `action.result` event for one runtime action result.
+ */
+export declare function createActionResultEvent(input: {
+    readonly result: RuntimeActionResult;
+    readonly sequence: number;
+    readonly turnId: string;
+}): ActionResultStreamEvent;
+/**
+ * Creates the `subagent.called` event for one started child workflow run.
+ */
+export declare function createSubagentCalledEvent(input: {
+    readonly callId: string;
+    readonly childRunId: string;
+    readonly runId: string;
+    readonly sequence: number;
+    readonly subagentId: string;
+    readonly toolName: string;
+    readonly turnId: string;
+    readonly workflowId: string;
+}): SubagentCalledStreamEvent;
+/**
+ * Creates the `message.completed` event for one per-turn assistant output.
+ */
+export declare function createMessageCompletedEvent(input: {
+    readonly message: string | null;
+    readonly sequence: number;
+    readonly turnId: string;
+}): MessageCompletedStreamEvent;
+/**
+ * Creates the `turn.completed` event for one terminal per-turn outcome.
+ */
+export declare function createTurnCompletedEvent(input: {
+    readonly sequence: number;
+    readonly status: "completed" | "failed";
+    readonly turnId: string;
+}): TurnCompletedStreamEvent;
+/**
+ * Creates the `session.waiting` event for the only supported between-turn
+ * wait.
+ */
+export declare function createSessionWaitingEvent(input: {
+    readonly runId: string;
+    readonly sessionId: string;
+}): SessionWaitingStreamEvent;
+/**
+ * Creates the `run.failed` event for one terminal workflow failure.
+ */
+export declare function createRunFailedEvent(input: {
+    readonly code: string;
+    readonly details?: JsonObject;
+    readonly message: string;
+    readonly runId: string;
+    readonly sessionId: string;
+}): RunFailedStreamEvent;
+/**
+ * Creates the `run.completed` event for one terminal workflow completion.
+ */
+export declare function createRunCompletedEvent(input: {
+    readonly runId: string;
+    readonly sessionId: string;
+}): RunCompletedStreamEvent;
+/**
+ * Encodes one stream event as newline-delimited JSON.
+ */
+export declare function encodeMessageStreamEvent(event: HandleMessageStreamEvent): Uint8Array;
+//# sourceMappingURL=message.d.ts.map