summer-engine 4.3.0 → 4.6.0

package/dist/core/capabilities/content-make/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * content.make on the person's computer: one finished piece for a game,
+ * copied beat for beat from a reference in Summer's library, from the
+ * team's own footage, into the team's Review.
+ *
+ *   pick -> study -> footage -> plan -> voice -> render -> checks -> compare -> upload
+ *
+ * It runs directly (an agent's "clip what we just built"), or it claims the
+ * oldest make request Summer's server queued for the team (the daily
+ * scheduler, a Change pressed on Today) and reports every stage to it. A
+ * make that names revisePieceId revises that piece instead of saving a new one.
+ *
+ * Every stage leaves its record in the piece's work folder, so a run that
+ * stops (missing words, a missing voice-over, a network drop) continues
+ * from there with the same workDir. Words are the one thing it never makes
+ * up: our lines come from the caller (an agent, or the person), and the
+ * reference's own words never reach the piece.
+ */
+/** The stage names Summer's server shows live on Today (content.update_make). */
+export type Stage = "pick" | "study" | "footage" | "plan" | "voice" | "render" | "checks" | "compare" | "upload";
+export interface ContentMakeInput {
+    teamId?: string;
+    contentGameId?: string;
+    referenceId?: string;
+    referenceFile?: string;
+    /** What to make it about (the commits since the last piece, "the new boss"): weighs the pick. */
+    note?: string;
+    /** Claim a queued make request (the named one, else the team's oldest) and make it. */
+    claim?: boolean;
+    /** The make request to claim, from content.make. */
+    requestId?: string;
+    /** The kit learnings (content.get_kit) the words and choices applied. */
+    learningIds?: string[];
+    footage?: string[];
+    voiceFile?: string;
+    lines?: string[];
+    title?: string;
+    caption?: string;
+    hashtags?: string[];
+    music?: string;
+    font?: string;
+    workDir?: string;
+    out?: string;
+    repo?: string;
+    stage?: "plan" | "all";
+    upload?: boolean;
+    replan?: boolean;
+    status?: "draft" | "in_review";
+    face?: "cli" | "mcp";
+}
+/** One operation on Summer's server: its answer envelope. */
+export type CloudCall = (op: string, input: Record<string, unknown>) => Promise<{
+    ok: boolean;
+    status?: string;
+    result?: unknown;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}>;
+export interface ContentMakeDeps {
+    cloud: CloudCall;
+    put: (url: string, file: string, contentType: string) => Promise<void>;
+    progress: (stage: Stage, message: string) => void;
+    now: () => Date;
+    cwd: string;
+}
+export declare function defaultDeps(face?: "cli" | "mcp"): ContentMakeDeps;
+export interface ContentMakeResult {
+    ok: true;
+    status: "saved" | "planned" | "needs_words" | "needs_changes" | "needs_voice" | "rendered" | "nothing_queued" | "cannot_make";
+    workDir?: string;
+    referenceId?: string;
+    next?: string;
+    [key: string]: unknown;
+}
+/** The input from a tool call's arguments (MCP or CLI), unknown fields left out. */
+export declare function contentMakeInput(args: Record<string, unknown>): ContentMakeInput;
+/** Makes one piece; see the header of this file. */
+export declare function contentMake(input: ContentMakeInput, deps?: ContentMakeDeps): Promise<ContentMakeResult>;