@302ai/media-studio-core 0.1.0-beta.0

package/dist/sessions/types.d.ts

@@ -0,0 +1,375 @@
+import { z } from "zod";
+/**
+ * Creation provenance of a session: which kind of client provisioned it.
+ * The upstream database is backfilled with `web` as the default, so the
+ * field is always present on stored sessions.
+ */
+export declare const SessionSourceSchema: z.ZodEnum<{
+    cli: "cli";
+    web: "web";
+}>;
+export type SessionSource = z.infer<typeof SessionSourceSchema>;
+declare const SessionListItemSchema: z.ZodPipe<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    titleCustomized: z.ZodOptional<z.ZodBoolean>;
+    title_customized: z.ZodOptional<z.ZodBoolean>;
+    lastActiveAt: z.ZodOptional<z.ZodString>;
+    last_active_at: z.ZodOptional<z.ZodString>;
+    pinnedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pinned_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<{
+        cli: "cli";
+        web: "web";
+    }>>;
+    status: z.ZodOptional<z.ZodObject<{
+        chat: z.ZodBoolean;
+        task: z.ZodBoolean;
+    }, z.core.$strip>>;
+    chatTasks: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        chatTaskId: z.ZodOptional<z.ZodString>;
+        chat_task_id: z.ZodOptional<z.ZodString>;
+        parentChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        parent_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        resultChildChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        result_child_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+            processing: "processing";
+            running: "running";
+        }>;
+    }, z.core.$strip>, z.ZodTransform<{
+        id: string;
+        chatTaskId: string;
+        parentChatTaskId: string | null;
+        resultChildChatTaskId: string | null;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }, {
+        id?: string | undefined;
+        chatTaskId?: string | undefined;
+        chat_task_id?: string | undefined;
+        parentChatTaskId?: string | null | undefined;
+        parent_chat_task_id?: string | null | undefined;
+        resultChildChatTaskId?: string | null | undefined;
+        result_child_chat_task_id?: string | null | undefined;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }>>>>;
+    chat_tasks: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        chatTaskId: z.ZodOptional<z.ZodString>;
+        chat_task_id: z.ZodOptional<z.ZodString>;
+        parentChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        parent_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        resultChildChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        result_child_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+            processing: "processing";
+            running: "running";
+        }>;
+    }, z.core.$strip>, z.ZodTransform<{
+        id: string;
+        chatTaskId: string;
+        parentChatTaskId: string | null;
+        resultChildChatTaskId: string | null;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }, {
+        id?: string | undefined;
+        chatTaskId?: string | undefined;
+        chat_task_id?: string | undefined;
+        parentChatTaskId?: string | null | undefined;
+        parent_chat_task_id?: string | null | undefined;
+        resultChildChatTaskId?: string | null | undefined;
+        result_child_chat_task_id?: string | null | undefined;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }>>>>;
+    ai302TaskCount: z.ZodOptional<z.ZodCatch<z.ZodNullable<z.ZodNumber>>>;
+    ai302_task_count: z.ZodOptional<z.ZodCatch<z.ZodNullable<z.ZodNumber>>>;
+}, z.core.$strip>, z.ZodTransform<{
+    id: string;
+    sessionId: string;
+    note: string | null;
+    titleCustomized: boolean;
+    lastActiveAt: string;
+    pinnedAt: string | null;
+    createdAt: string;
+    source: "cli" | "web";
+    status: {
+        chat: boolean;
+        task: boolean;
+    };
+    chatTasks: {
+        id: string;
+        chatTaskId: string;
+        parentChatTaskId: string | null;
+        resultChildChatTaskId: string | null;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }[];
+    ai302TaskCount: number | null;
+}, {
+    id?: string | undefined;
+    sessionId?: string | undefined;
+    session_id?: string | undefined;
+    note?: string | null | undefined;
+    titleCustomized?: boolean | undefined;
+    title_customized?: boolean | undefined;
+    lastActiveAt?: string | undefined;
+    last_active_at?: string | undefined;
+    pinnedAt?: string | null | undefined;
+    pinned_at?: string | null | undefined;
+    createdAt?: string | undefined;
+    created_at?: string | undefined;
+    source?: "cli" | "web" | undefined;
+    status?: {
+        chat: boolean;
+        task: boolean;
+    } | undefined;
+    chatTasks?: {
+        id: string;
+        chatTaskId: string;
+        parentChatTaskId: string | null;
+        resultChildChatTaskId: string | null;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }[] | undefined;
+    chat_tasks?: {
+        id: string;
+        chatTaskId: string;
+        parentChatTaskId: string | null;
+        resultChildChatTaskId: string | null;
+        status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+    }[] | undefined;
+    ai302TaskCount?: number | null | undefined;
+    ai302_task_count?: number | null | undefined;
+}>>;
+export type SessionListItem = z.infer<typeof SessionListItemSchema>;
+export declare const ListSessionsQuerySchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListSessionsQuery = z.input<typeof ListSessionsQuerySchema>;
+export declare const ListSessionsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    data: z.ZodArray<z.ZodPipe<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        session_id: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        titleCustomized: z.ZodOptional<z.ZodBoolean>;
+        title_customized: z.ZodOptional<z.ZodBoolean>;
+        lastActiveAt: z.ZodOptional<z.ZodString>;
+        last_active_at: z.ZodOptional<z.ZodString>;
+        pinnedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pinned_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<{
+            cli: "cli";
+            web: "web";
+        }>>;
+        status: z.ZodOptional<z.ZodObject<{
+            chat: z.ZodBoolean;
+            task: z.ZodBoolean;
+        }, z.core.$strip>>;
+        chatTasks: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            chatTaskId: z.ZodOptional<z.ZodString>;
+            chat_task_id: z.ZodOptional<z.ZodString>;
+            parentChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            parent_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            resultChildChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            result_child_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+                processing: "processing";
+                running: "running";
+            }>;
+        }, z.core.$strip>, z.ZodTransform<{
+            id: string;
+            chatTaskId: string;
+            parentChatTaskId: string | null;
+            resultChildChatTaskId: string | null;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }, {
+            id?: string | undefined;
+            chatTaskId?: string | undefined;
+            chat_task_id?: string | undefined;
+            parentChatTaskId?: string | null | undefined;
+            parent_chat_task_id?: string | null | undefined;
+            resultChildChatTaskId?: string | null | undefined;
+            result_child_chat_task_id?: string | null | undefined;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }>>>>;
+        chat_tasks: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            chatTaskId: z.ZodOptional<z.ZodString>;
+            chat_task_id: z.ZodOptional<z.ZodString>;
+            parentChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            parent_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            resultChildChatTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            result_child_chat_task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+                processing: "processing";
+                running: "running";
+            }>;
+        }, z.core.$strip>, z.ZodTransform<{
+            id: string;
+            chatTaskId: string;
+            parentChatTaskId: string | null;
+            resultChildChatTaskId: string | null;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }, {
+            id?: string | undefined;
+            chatTaskId?: string | undefined;
+            chat_task_id?: string | undefined;
+            parentChatTaskId?: string | null | undefined;
+            parent_chat_task_id?: string | null | undefined;
+            resultChildChatTaskId?: string | null | undefined;
+            result_child_chat_task_id?: string | null | undefined;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }>>>>;
+        ai302TaskCount: z.ZodOptional<z.ZodCatch<z.ZodNullable<z.ZodNumber>>>;
+        ai302_task_count: z.ZodOptional<z.ZodCatch<z.ZodNullable<z.ZodNumber>>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        id: string;
+        sessionId: string;
+        note: string | null;
+        titleCustomized: boolean;
+        lastActiveAt: string;
+        pinnedAt: string | null;
+        createdAt: string;
+        source: "cli" | "web";
+        status: {
+            chat: boolean;
+            task: boolean;
+        };
+        chatTasks: {
+            id: string;
+            chatTaskId: string;
+            parentChatTaskId: string | null;
+            resultChildChatTaskId: string | null;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }[];
+        ai302TaskCount: number | null;
+    }, {
+        id?: string | undefined;
+        sessionId?: string | undefined;
+        session_id?: string | undefined;
+        note?: string | null | undefined;
+        titleCustomized?: boolean | undefined;
+        title_customized?: boolean | undefined;
+        lastActiveAt?: string | undefined;
+        last_active_at?: string | undefined;
+        pinnedAt?: string | null | undefined;
+        pinned_at?: string | null | undefined;
+        createdAt?: string | undefined;
+        created_at?: string | undefined;
+        source?: "cli" | "web" | undefined;
+        status?: {
+            chat: boolean;
+            task: boolean;
+        } | undefined;
+        chatTasks?: {
+            id: string;
+            chatTaskId: string;
+            parentChatTaskId: string | null;
+            resultChildChatTaskId: string | null;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }[] | undefined;
+        chat_tasks?: {
+            id: string;
+            chatTaskId: string;
+            parentChatTaskId: string | null;
+            resultChildChatTaskId: string | null;
+            status: "cancelled" | "completed" | "failed" | "pending" | "processing" | "running";
+        }[] | undefined;
+        ai302TaskCount?: number | null | undefined;
+        ai302_task_count?: number | null | undefined;
+    }>>>;
+}, z.core.$strip>;
+export type ListSessionsResponse = z.infer<typeof ListSessionsResponseSchema>;
+export declare const DeleteSessionResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DeleteSessionResponse = z.infer<typeof DeleteSessionResponseSchema>;
+export declare const PrewarmSessionReadySchema: z.ZodPipe<z.ZodObject<{
+    session_id: z.ZodString;
+    note: z.ZodNullable<z.ZodString>;
+    title_customized: z.ZodBoolean;
+    is_new: z.ZodBoolean;
+}, z.core.$strip>, z.ZodTransform<{
+    note: string | null;
+    sessionId: string;
+    titleCustomized: boolean;
+    isNew: boolean;
+}, {
+    session_id: string;
+    note: string | null;
+    title_customized: boolean;
+    is_new: boolean;
+}>>;
+export type PrewarmSessionReady = z.infer<typeof PrewarmSessionReadySchema>;
+export declare const PrewarmSandboxReadySchema: z.ZodObject<{
+    cli_installed: z.ZodBoolean;
+    cli_version: z.ZodString;
+    sdk_installed: z.ZodBoolean;
+    sdk_version: z.ZodString;
+    restarted: z.ZodBoolean;
+    elapsed_s: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PrewarmSkillsReadySchema: z.ZodObject<{
+    total: z.ZodNumber;
+    elapsed_s: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PrewarmDoneSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    prewarmed: z.ZodLiteral<true>;
+    total_elapsed_s: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PrewarmErrorSchema: z.ZodObject<{
+    err_code: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Terminal result of a session prewarm. The boundary is the `session_ready`
+ * event (the upstream commit point): once it has been observed the session
+ * exists in the upstream database, so later failures degrade to `fallback`
+ * instead of `failed`.
+ */
+export type SessionPrewarmOutcome = {
+    status: "ready";
+    session: PrewarmSessionReady;
+} | {
+    status: "fallback";
+    session: PrewarmSessionReady;
+} | {
+    status: "failed";
+};
+export type SessionPrewarmStage = "creating" | "sandbox" | "skills" | "finishing";
+export {};

package/dist/sessions/types.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+/**
+ * Creation provenance of a session: which kind of client provisioned it.
+ * The upstream database is backfilled with `web` as the default, so the
+ * field is always present on stored sessions.
+ */
+export const SessionSourceSchema = z.enum(["web", "cli"]);
+const ApiResponseBaseSchema = z.object({
+    success: z.boolean(),
+    error: z
+        .object({
+        message: z.string(),
+        code: z.string().optional(),
+    })
+        .optional(),
+});
+const ChatTaskSummarySchema = z
+    .object({
+    id: z.string().optional(),
+    chatTaskId: z.string().optional(),
+    chat_task_id: z.string().optional(),
+    parentChatTaskId: z.string().nullable().optional(),
+    parent_chat_task_id: z.string().nullable().optional(),
+    resultChildChatTaskId: z.string().nullable().optional(),
+    result_child_chat_task_id: z.string().nullable().optional(),
+    status: z.enum([
+        "pending",
+        "running",
+        "processing",
+        "completed",
+        "failed",
+        "cancelled",
+    ]),
+})
+    .transform((data) => {
+    const id = data.id ?? data.chatTaskId ?? data.chat_task_id ?? "";
+    return {
+        id,
+        chatTaskId: id,
+        parentChatTaskId: data.parentChatTaskId ?? data.parent_chat_task_id ?? null,
+        resultChildChatTaskId: data.resultChildChatTaskId ?? data.result_child_chat_task_id ?? null,
+        status: data.status,
+    };
+});
+const SessionListItemSchema = z
+    .object({
+    id: z.string().optional(),
+    sessionId: z.string().optional(),
+    session_id: z.string().optional(),
+    note: z.string().nullable().optional(),
+    titleCustomized: z.boolean().optional(),
+    title_customized: z.boolean().optional(),
+    lastActiveAt: z.string().optional(),
+    last_active_at: z.string().optional(),
+    pinnedAt: z.string().nullable().optional(),
+    pinned_at: z.string().nullable().optional(),
+    createdAt: z.string().optional(),
+    created_at: z.string().optional(),
+    source: SessionSourceSchema.optional(),
+    status: z
+        .object({
+        chat: z.boolean(),
+        task: z.boolean(),
+    })
+        .optional(),
+    chatTasks: z.array(ChatTaskSummarySchema).optional(),
+    chat_tasks: z.array(ChatTaskSummarySchema).optional(),
+    ai302TaskCount: z.number().nullable().catch(null).optional(),
+    ai302_task_count: z.number().nullable().catch(null).optional(),
+})
+    .transform((data) => {
+    const id = data.id ?? data.sessionId ?? data.session_id ?? "";
+    return {
+        id,
+        sessionId: id,
+        note: data.note ?? null,
+        titleCustomized: data.titleCustomized ?? data.title_customized ?? false,
+        lastActiveAt: data.lastActiveAt ?? data.last_active_at ?? "",
+        pinnedAt: data.pinnedAt ?? data.pinned_at ?? null,
+        createdAt: data.createdAt ?? data.created_at ?? "",
+        source: data.source ?? "web",
+        status: data.status ?? { chat: true, task: true },
+        chatTasks: data.chatTasks ?? data.chat_tasks ?? [],
+        ai302TaskCount: data.ai302TaskCount ?? data.ai302_task_count ?? null,
+    };
+});
+export const ListSessionsQuerySchema = z.object({
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().nonnegative().optional(),
+    note: z.string().optional(),
+});
+export const ListSessionsResponseSchema = ApiResponseBaseSchema.extend({
+    data: z.array(SessionListItemSchema),
+});
+export const DeleteSessionResponseSchema = ApiResponseBaseSchema;
+export const PrewarmSessionReadySchema = z
+    .object({
+    session_id: z.string(),
+    note: z.string().nullable(),
+    title_customized: z.boolean(),
+    is_new: z.boolean(),
+})
+    .transform(({ session_id, title_customized, is_new, ...rest }) => ({
+    ...rest,
+    sessionId: session_id,
+    titleCustomized: title_customized,
+    isNew: is_new,
+}));
+export const PrewarmSandboxReadySchema = z.object({
+    cli_installed: z.boolean(),
+    cli_version: z.string(),
+    sdk_installed: z.boolean(),
+    sdk_version: z.string(),
+    restarted: z.boolean(),
+    elapsed_s: z.number(),
+});
+export const PrewarmSkillsReadySchema = z.object({
+    total: z.number().int().nonnegative(),
+    elapsed_s: z.number(),
+});
+export const PrewarmDoneSchema = z.object({
+    ok: z.literal(true),
+    prewarmed: z.literal(true),
+    total_elapsed_s: z.number(),
+});
+export const PrewarmErrorSchema = z.object({
+    err_code: z.union([z.number(), z.string()]),
+    message: z.string(),
+});

package/dist/stream/events.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+/** Text part delta in streaming turn. */
+export declare const TextDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text-delta">;
+    delta: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Reasoning / thinking part delta in streaming turn. */
+export declare const ReasoningDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"reasoning-delta">;
+    delta: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Tool invocation event emitted when assistant calls an external tool. */
+export declare const ToolCallEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool-call">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    args: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/** Tool result response emitted after tool execution finishes. */
+export declare const ToolResultEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool-result">;
+    toolCallId: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/** High-level media result event emitted when image/video generation completes. */
+export declare const MediaResultEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"media-result">;
+    result: z.ZodObject<{
+        status: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodString>;
+        modelUsed: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        resultUrl: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Terminal finish event indicating turn completion. */
+export declare const FinishEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"finish">;
+    finishReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Stream error event. Supports either error or message string. */
+export declare const StreamErrorEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    chatTaskId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Discriminated union of all possible streaming events yielded by ChatStream. */
+export declare const ChatStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text-delta">;
+    delta: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning-delta">;
+    delta: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool-call">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    args: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool-result">;
+    toolCallId: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"media-result">;
+    result: z.ZodObject<{
+        status: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodString>;
+        modelUsed: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        resultUrl: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"finish">;
+    finishReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    chatTaskId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type ChatStreamEvent = z.infer<typeof ChatStreamEventSchema>;

package/dist/stream/events.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { MediaResultSchema } from "../media/media-result.js";
+/** Text part delta in streaming turn. */
+export const TextDeltaEventSchema = z.object({
+    type: z.literal("text-delta"),
+    delta: z.string(),
+    id: z.string().optional(),
+});
+/** Reasoning / thinking part delta in streaming turn. */
+export const ReasoningDeltaEventSchema = z.object({
+    type: z.literal("reasoning-delta"),
+    delta: z.string(),
+    id: z.string().optional(),
+});
+/** Tool invocation event emitted when assistant calls an external tool. */
+export const ToolCallEventSchema = z.object({
+    type: z.literal("tool-call"),
+    toolCallId: z.string(),
+    toolName: z.string(),
+    args: z.unknown().optional(),
+});
+/** Tool result response emitted after tool execution finishes. */
+export const ToolResultEventSchema = z.object({
+    type: z.literal("tool-result"),
+    toolCallId: z.string(),
+    result: z.unknown().optional(),
+});
+/** High-level media result event emitted when image/video generation completes. */
+export const MediaResultEventSchema = z.object({
+    type: z.literal("media-result"),
+    result: MediaResultSchema,
+});
+/** Terminal finish event indicating turn completion. */
+export const FinishEventSchema = z.object({
+    type: z.literal("finish"),
+    finishReason: z.string().optional(),
+});
+/** Stream error event. Supports either error or message string. */
+export const StreamErrorEventSchema = z.object({
+    type: z.literal("error"),
+    error: z.string().optional(),
+    message: z.string().optional(),
+    chatTaskId: z.string().optional(),
+});
+/** Discriminated union of all possible streaming events yielded by ChatStream. */
+export const ChatStreamEventSchema = z.discriminatedUnion("type", [
+    TextDeltaEventSchema,
+    ReasoningDeltaEventSchema,
+    ToolCallEventSchema,
+    ToolResultEventSchema,
+    MediaResultEventSchema,
+    FinishEventSchema,
+    StreamErrorEventSchema,
+]);