@cueframe/kernel 0.1.1 → 0.1.3

package/dist/_members/director/ai-sdk/messages.d.ts

@@ -0,0 +1,292 @@
+import { z } from "zod";
+import type { UIMessage } from "ai";
+import { ChatErrorView } from "../domain/chat.js";
+import { GenerationArtifact } from "../domain/generation.js";
+export declare const CueFrameMessageMetadata: z.ZodOptional<z.ZodObject<{
+    createdAt: z.ZodNumber;
+    runId: z.ZodOptional<z.ZodString>;
+    backend: z.ZodOptional<z.ZodEnum<["cli", "ts-agent", "convex-agent", "direct"]>>;
+    context: z.ZodOptional<z.ZodObject<{
+        location: z.ZodString;
+        project: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            home: z.ZodEnum<["local", "cloud"]>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            home: "local" | "cloud";
+        }, {
+            id: string;
+            home: "local" | "cloud";
+        }>>>;
+        selectedMediaIds: z.ZodDefault<z.ZodArray<z.ZodBranded<z.ZodString, "Id<media>">, "many">>;
+        fastMode: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        location: string;
+        project: {
+            id: string;
+            home: "local" | "cloud";
+        } | null;
+        selectedMediaIds: (string & z.BRAND<"Id<media>">)[];
+        fastMode: boolean;
+    }, {
+        location: string;
+        project?: {
+            id: string;
+            home: "local" | "cloud";
+        } | null | undefined;
+        selectedMediaIds?: string[] | undefined;
+        fastMode?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: number;
+    context?: {
+        location: string;
+        project: {
+            id: string;
+            home: "local" | "cloud";
+        } | null;
+        selectedMediaIds: (string & z.BRAND<"Id<media>">)[];
+        fastMode: boolean;
+    } | undefined;
+    runId?: string | undefined;
+    backend?: "cli" | "ts-agent" | "convex-agent" | "direct" | undefined;
+}, {
+    createdAt: number;
+    context?: {
+        location: string;
+        project?: {
+            id: string;
+            home: "local" | "cloud";
+        } | null | undefined;
+        selectedMediaIds?: string[] | undefined;
+        fastMode?: boolean | undefined;
+    } | undefined;
+    runId?: string | undefined;
+    backend?: "cli" | "ts-agent" | "convex-agent" | "direct" | undefined;
+}>>;
+export type CueFrameMessageMetadata = z.infer<typeof CueFrameMessageMetadata>;
+export declare const CueFramePhase: z.ZodObject<{
+    phase: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    phase: string;
+    detail?: string | undefined;
+}, {
+    phase: string;
+    detail?: string | undefined;
+}>;
+export declare const CueFrameIteration: z.ZodObject<{
+    iteration: z.ZodNumber;
+    maxIterations: z.ZodNumber;
+    agent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent: string;
+    iteration: number;
+    maxIterations: number;
+}, {
+    agent: string;
+    iteration: number;
+    maxIterations: number;
+}>;
+export declare const CueFrameSuggestions: z.ZodObject<{
+    items: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: string[];
+}, {
+    items: string[];
+}>;
+export declare const CueFramePlan: z.ZodObject<{
+    plan: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    plan: string;
+}, {
+    plan: string;
+}>;
+export declare const CueFrameRunOutcome: z.ZodObject<{
+    outcome: z.ZodEnum<["aborted", "error"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    wrote: z.ZodBoolean;
+    phase: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    outcome: "aborted" | "error";
+    wrote: boolean;
+    phase?: string | undefined;
+    reason?: string | undefined;
+}, {
+    outcome: "aborted" | "error";
+    wrote: boolean;
+    phase?: string | undefined;
+    reason?: string | undefined;
+}>;
+export type CueFrameUIData = {
+    phase: z.infer<typeof CueFramePhase>;
+    iteration: z.infer<typeof CueFrameIteration>;
+    suggestions: z.infer<typeof CueFrameSuggestions>;
+    plan: z.infer<typeof CueFramePlan>;
+    run: z.infer<typeof CueFrameRunOutcome>;
+    generation: z.infer<typeof GenerationArtifact>;
+    error: z.infer<typeof ChatErrorView>;
+};
+export type CueFrameUIMessage = UIMessage<CueFrameMessageMetadata, CueFrameUIData>;
+export declare const cueFrameDataPartSchemas: {
+    phase: z.ZodObject<{
+        phase: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        phase: string;
+        detail?: string | undefined;
+    }, {
+        phase: string;
+        detail?: string | undefined;
+    }>;
+    iteration: z.ZodObject<{
+        iteration: z.ZodNumber;
+        maxIterations: z.ZodNumber;
+        agent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agent: string;
+        iteration: number;
+        maxIterations: number;
+    }, {
+        agent: string;
+        iteration: number;
+        maxIterations: number;
+    }>;
+    suggestions: z.ZodObject<{
+        items: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        items: string[];
+    }, {
+        items: string[];
+    }>;
+    plan: z.ZodObject<{
+        plan: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        plan: string;
+    }, {
+        plan: string;
+    }>;
+    run: z.ZodObject<{
+        outcome: z.ZodEnum<["aborted", "error"]>;
+        reason: z.ZodOptional<z.ZodString>;
+        wrote: z.ZodBoolean;
+        phase: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        outcome: "aborted" | "error";
+        wrote: boolean;
+        phase?: string | undefined;
+        reason?: string | undefined;
+    }, {
+        outcome: "aborted" | "error";
+        wrote: boolean;
+        phase?: string | undefined;
+        reason?: string | undefined;
+    }>;
+    generation: z.ZodObject<{
+        artifactVersion: z.ZodLiteral<1>;
+        clientRequestId: z.ZodBranded<z.ZodString, "Id<generationRequest>">;
+        generationId: z.ZodBranded<z.ZodString, "Id<generation>">;
+        mediaId: z.ZodBranded<z.ZodString, "Id<media>">;
+        generationGroupId: z.ZodBranded<z.ZodString, "Id<generationGroup>">;
+        version: z.ZodNumber;
+        kind: z.ZodEnum<["image", "video", "audio"]>;
+        requestSummary: z.ZodString;
+        status: z.ZodEnum<["draft", "submitting", "queued", "generating", "provider_complete", "materialising", "processing", "ready", "cancelling", "cancelled", "failed"]>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        placementReady: z.ZodDefault<z.ZodBoolean>;
+        parentMediaId: z.ZodOptional<z.ZodBranded<z.ZodString, "Id<media>">>;
+        estimateUsd: z.ZodOptional<z.ZodNumber>;
+        failure: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            recovery: z.ZodOptional<z.ZodString>;
+            retryable: z.ZodBoolean;
+            correlationId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        }>>;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string & z.BRAND<"Id<media>">;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string & z.BRAND<"Id<generationRequest>">;
+        generationGroupId: string & z.BRAND<"Id<generationGroup>">;
+        generationId: string & z.BRAND<"Id<generation>">;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        placementReady: boolean;
+        parentMediaId?: (string & z.BRAND<"Id<media>">) | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    }, {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string;
+        generationGroupId: string;
+        generationId: string;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        parentMediaId?: string | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        placementReady?: boolean | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    }>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        title: z.ZodString;
+        recovery: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodBoolean;
+        source: z.ZodOptional<z.ZodEnum<["provider", "generation", "materialisation", "agent", "transport"]>>;
+        correlationId: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    }, {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    }>;
+};

package/dist/_members/director/domain/chat.d.ts

@@ -0,0 +1,357 @@
+import { z } from "zod";
+import { type Envelope } from "../../errors/index.js";
+export declare const ConversationId: z.ZodBranded<z.ZodString, "Id<conversation>">;
+export type ConversationId = z.infer<typeof ConversationId>;
+export declare const DirectorRunId: z.ZodBranded<z.ZodString, "Id<directorRun>">;
+export type DirectorRunId = z.infer<typeof DirectorRunId>;
+export declare const ProjectRef: z.ZodObject<{
+    id: z.ZodString;
+    home: z.ZodEnum<["local", "cloud"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    home: "local" | "cloud";
+}, {
+    id: string;
+    home: "local" | "cloud";
+}>;
+export type ProjectRef = z.infer<typeof ProjectRef>;
+export declare const DirectorTurnContext: z.ZodObject<{
+    location: z.ZodString;
+    project: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        home: z.ZodEnum<["local", "cloud"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        home: "local" | "cloud";
+    }, {
+        id: string;
+        home: "local" | "cloud";
+    }>>>;
+    selectedMediaIds: z.ZodDefault<z.ZodArray<z.ZodBranded<z.ZodString, "Id<media>">, "many">>;
+    fastMode: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    location: string;
+    project: {
+        id: string;
+        home: "local" | "cloud";
+    } | null;
+    selectedMediaIds: (string & z.BRAND<"Id<media>">)[];
+    fastMode: boolean;
+}, {
+    location: string;
+    project?: {
+        id: string;
+        home: "local" | "cloud";
+    } | null | undefined;
+    selectedMediaIds?: string[] | undefined;
+    fastMode?: boolean | undefined;
+}>;
+export type DirectorTurnContext = z.infer<typeof DirectorTurnContext>;
+export declare const DirectorTurnEnvelope: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    context: z.ZodObject<{
+        location: z.ZodString;
+        project: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            home: z.ZodEnum<["local", "cloud"]>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            home: "local" | "cloud";
+        }, {
+            id: string;
+            home: "local" | "cloud";
+        }>>>;
+        selectedMediaIds: z.ZodDefault<z.ZodArray<z.ZodBranded<z.ZodString, "Id<media>">, "many">>;
+        fastMode: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        location: string;
+        project: {
+            id: string;
+            home: "local" | "cloud";
+        } | null;
+        selectedMediaIds: (string & z.BRAND<"Id<media>">)[];
+        fastMode: boolean;
+    }, {
+        location: string;
+        project?: {
+            id: string;
+            home: "local" | "cloud";
+        } | null | undefined;
+        selectedMediaIds?: string[] | undefined;
+        fastMode?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    context: {
+        location: string;
+        project: {
+            id: string;
+            home: "local" | "cloud";
+        } | null;
+        selectedMediaIds: (string & z.BRAND<"Id<media>">)[];
+        fastMode: boolean;
+    };
+}, {
+    version: 1;
+    context: {
+        location: string;
+        project?: {
+            id: string;
+            home: "local" | "cloud";
+        } | null | undefined;
+        selectedMediaIds?: string[] | undefined;
+        fastMode?: boolean | undefined;
+    };
+}>;
+export type DirectorTurnEnvelope = z.infer<typeof DirectorTurnEnvelope>;
+export declare const ChatErrorView: z.ZodObject<{
+    code: z.ZodString;
+    title: z.ZodString;
+    recovery: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodBoolean;
+    source: z.ZodOptional<z.ZodEnum<["provider", "generation", "materialisation", "agent", "transport"]>>;
+    correlationId: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    title: string;
+    retryable: boolean;
+    recovery?: string | undefined;
+    source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+    correlationId?: string | undefined;
+    details?: string | undefined;
+}, {
+    code: string;
+    title: string;
+    retryable: boolean;
+    recovery?: string | undefined;
+    source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+    correlationId?: string | undefined;
+    details?: string | undefined;
+}>;
+export type ChatErrorView = z.infer<typeof ChatErrorView>;
+export declare function chatErrorViewFromEnvelope(envelope: Envelope, source?: ChatErrorView["source"]): ChatErrorView;
+export declare function chatErrorViewFromUnknown(error: unknown, source?: ChatErrorView["source"]): ChatErrorView;
+export declare const DirectorEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text-delta">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text-delta";
+    text: string;
+}, {
+    type: "text-delta";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning-delta">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "reasoning-delta";
+    text: string;
+}, {
+    type: "reasoning-delta";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"phase">;
+    phase: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "phase";
+    phase: string;
+    detail?: string | undefined;
+}, {
+    type: "phase";
+    phase: string;
+    detail?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"generation">;
+    artifact: z.ZodObject<{
+        artifactVersion: z.ZodLiteral<1>;
+        clientRequestId: z.ZodBranded<z.ZodString, "Id<generationRequest>">;
+        generationId: z.ZodBranded<z.ZodString, "Id<generation>">;
+        mediaId: z.ZodBranded<z.ZodString, "Id<media>">;
+        generationGroupId: z.ZodBranded<z.ZodString, "Id<generationGroup>">;
+        version: z.ZodNumber;
+        kind: z.ZodEnum<["image", "video", "audio"]>;
+        requestSummary: z.ZodString;
+        status: z.ZodEnum<["draft", "submitting", "queued", "generating", "provider_complete", "materialising", "processing", "ready", "cancelling", "cancelled", "failed"]>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        placementReady: z.ZodDefault<z.ZodBoolean>;
+        parentMediaId: z.ZodOptional<z.ZodBranded<z.ZodString, "Id<media>">>;
+        estimateUsd: z.ZodOptional<z.ZodNumber>;
+        failure: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            recovery: z.ZodOptional<z.ZodString>;
+            retryable: z.ZodBoolean;
+            correlationId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        }>>;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string & z.BRAND<"Id<media>">;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string & z.BRAND<"Id<generationRequest>">;
+        generationGroupId: string & z.BRAND<"Id<generationGroup>">;
+        generationId: string & z.BRAND<"Id<generation>">;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        placementReady: boolean;
+        parentMediaId?: (string & z.BRAND<"Id<media>">) | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    }, {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string;
+        generationGroupId: string;
+        generationId: string;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        parentMediaId?: string | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        placementReady?: boolean | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "generation";
+    artifact: {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string & z.BRAND<"Id<media>">;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string & z.BRAND<"Id<generationRequest>">;
+        generationGroupId: string & z.BRAND<"Id<generationGroup>">;
+        generationId: string & z.BRAND<"Id<generation>">;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        placementReady: boolean;
+        parentMediaId?: (string & z.BRAND<"Id<media>">) | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    };
+}, {
+    type: "generation";
+    artifact: {
+        kind: "video" | "audio" | "image";
+        status: "generating" | "processing" | "cancelled" | "ready" | "failed" | "draft" | "submitting" | "queued" | "provider_complete" | "materialising" | "cancelling";
+        mediaId: string;
+        createdAt: number;
+        updatedAt: number;
+        clientRequestId: string;
+        generationGroupId: string;
+        generationId: string;
+        version: number;
+        artifactVersion: 1;
+        requestSummary: string;
+        parentMediaId?: string | undefined;
+        estimateUsd?: number | undefined;
+        progress?: number | undefined;
+        placementReady?: boolean | undefined;
+        failure?: {
+            code: string;
+            title: string;
+            retryable: boolean;
+            recovery?: string | undefined;
+            correlationId?: string | undefined;
+        } | undefined;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        title: z.ZodString;
+        recovery: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodBoolean;
+        source: z.ZodOptional<z.ZodEnum<["provider", "generation", "materialisation", "agent", "transport"]>>;
+        correlationId: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    }, {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    error: {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    };
+}, {
+    type: "error";
+    error: {
+        code: string;
+        title: string;
+        retryable: boolean;
+        recovery?: string | undefined;
+        source?: "provider" | "generation" | "materialisation" | "agent" | "transport" | undefined;
+        correlationId?: string | undefined;
+        details?: string | undefined;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"finish">;
+}, "strip", z.ZodTypeAny, {
+    type: "finish";
+}, {
+    type: "finish";
+}>]>;
+export type DirectorEvent = z.infer<typeof DirectorEvent>;

package/dist/_members/director/domain/generation.d.ts

@@ -0,0 +1 @@
+export * from "../../media-model/generation.js";

package/dist/_members/director/domain/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./generation.js";
+export * from "./chat.js";
+export * from "./ports.js";

package/dist/_members/director/domain/ports.d.ts

@@ -0,0 +1,32 @@
+import type { GenerationArtifact, GenerateMediaCommand, GenerationCapabilities, GenerationId, GenerationReceipt, MediaId } from "./generation.js";
+import type { DirectorEvent, DirectorTurnContext } from "./chat.js";
+export interface DirectorRuntimeRequest {
+    conversationId: string;
+    context: DirectorTurnContext;
+    messages: Array<{
+        role: "user" | "assistant" | "system";
+        content: string;
+    }>;
+}
+export interface DirectorRuntime {
+    run(request: DirectorRuntimeRequest, signal?: AbortSignal): AsyncIterable<DirectorEvent>;
+}
+export interface GenerationGateway {
+    capabilities(context: DirectorTurnContext): Promise<GenerationCapabilities>;
+    enqueue(command: GenerateMediaCommand, context: DirectorTurnContext): Promise<GenerationReceipt>;
+    resolveByClientRequestId(clientRequestId: string, context: DirectorTurnContext): Promise<GenerationReceipt | null>;
+    cancel(generationId: GenerationId, context: DirectorTurnContext): Promise<void>;
+    retryMaterialisation(mediaId: MediaId, context: DirectorTurnContext): Promise<void>;
+    subscribe(generationId: GenerationId, listener: (artifact: GenerationArtifact) => void): () => void;
+}
+export interface ConversationRecord<MESSAGE> {
+    id: string;
+    messages: MESSAGE[];
+    context: DirectorTurnContext;
+    updatedAt: number;
+}
+export interface ConversationRepository<MESSAGE> {
+    load(id: string, context: DirectorTurnContext): Promise<ConversationRecord<MESSAGE> | null>;
+    save(record: ConversationRecord<MESSAGE>): Promise<void>;
+    remove(id: string): Promise<void>;
+}

package/dist/_members/director/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./domain/index.js";
+export * from "./ai-sdk/index.js";