@nebutra/video-pipeline 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/video-pipeline",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Storyboard-first video planning, rendering manifests, and cost previews",
   "private": false,
   "license": "MIT",
@@ -23,17 +23,21 @@
     "category": "ai",
     "summary": "Storyboard-first brand video planning, cost, preview, and composition surface"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/generation-context": "0.1.2",
-    "@nebutra/image-pipeline": "0.1.2",
-    "@nebutra/errors": "0.1.2",
-    "@nebutra/reel": "1.0.2"
+    "@nebutra/generation-context": "0.1.3",
+    "@nebutra/capability-kit": "0.2.4",
+    "@nebutra/reel": "1.0.4",
+    "@nebutra/image-pipeline": "0.1.3",
+    "@nebutra/errors": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -54,6 +58,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/video-pipeline@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/video-pipeline
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/video-pipeline/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/chunk-YOKTCRLB.js     4.78 KB
-ESM dist/cli.js                1.18 KB
-ESM dist/index.js              152.00 B
-ESM dist/chunk-YOKTCRLB.js.map 9.72 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/cli.js.map            2.10 KB
-ESM ⚡️ Build success in 14ms
-DTS Build start
-DTS ⚡️ Build success in 5890ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 1.94 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/video-pipeline@0.1.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/video-pipeline
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/video-pipeline
-
- ✓ src/index.test.ts (2 tests) 29ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  09:41:00
-   Duration  1.05s (transform 255ms, setup 0ms, import 403ms, tests 29ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/video-pipeline@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/video-pipeline
-> tsc --noEmit
-

package/examples/cost.ts

@@ -1,10 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { VideoPipeline } from "../src/index";
-
-const pipeline = new VideoPipeline();
-const storyboard = await pipeline.plan(
-  { type: "brand-film", durationS: 60, theme: "debugging launch" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.cost(storyboard), null, 2)}\n`);

package/examples/plan.ts

@@ -1,9 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { VideoPipeline } from "../src/index";
-
-const storyboard = await new VideoPipeline().plan(
-  { type: "brand-film", durationS: 24, theme: "indie developer journey" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${JSON.stringify(storyboard.scenes, null, 2)}\n`);

package/examples/preview.ts

@@ -1,10 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { VideoPipeline } from "../src/index";
-
-const pipeline = new VideoPipeline();
-const storyboard = await pipeline.plan(
-  { type: "turntable", durationS: 8, subject: "product mockup" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.preview(storyboard), null, 2)}\n`);

package/src/cli.ts

@@ -1,31 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { readVideoDebug, VideoPipeline } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const pipeline = new VideoPipeline();
-const brand = createDemoBrandContext();
-const storyboard = await pipeline.plan(
-  { type: "brand-film", durationS: 16, theme: "indie developer journey" },
-  brand,
-);
-
-if (command === "doctor") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "video-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
-  );
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "video-pipeline", entries: await readVideoDebug() }, null, 2)}\n`,
-  );
-} else if (command === "cost") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "video-pipeline", cost: await pipeline.cost(storyboard) }, null, 2)}\n`,
-  );
-} else if (command === "preview") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "video-pipeline", preview: await pipeline.preview(storyboard) }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown video-pipeline command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,34 +0,0 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { afterEach, describe, expect, it } from "vitest";
-import { VideoPipeline } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("VideoPipeline", () => {
-  it("requires storyboard before render", async () => {
-    root = await mkdtemp(join(tmpdir(), "video-pipeline-"));
-    const pipeline = new VideoPipeline({ root });
-    const brand = createDemoBrandContext();
-    const storyboard = await pipeline.plan(
-      { type: "brand-film", durationS: 20, theme: "launch" },
-      brand,
-    );
-    expect(storyboard.scenes.length).toBeGreaterThan(1);
-    const asset = await pipeline.render(storyboard, brand);
-    expect(await readFile(asset.path, "utf8")).toContain(storyboard.id);
-  });
-
-  it("requires BrandContext", async () => {
-    await expect(
-      new VideoPipeline().plan({ type: "clip", durationS: 4, prompt: "ship" }, undefined),
-    ).rejects.toMatchObject({ capability: "video-pipeline" });
-  });
-});

package/src/index.ts

@@ -1,180 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
-import {
-  assetId,
-  type BrandContext,
-  type GeneratedAsset,
-  requireBrandContext,
-  summarizeBrandContext,
-} from "@nebutra/generation-context";
-import {
-  type StoryboardPlan,
-  type StoryboardScene,
-  storyboardTotalDuration,
-} from "@nebutra/reel/storyboard";
-
-export type VideoIntent =
-  | { type: "brand-film"; durationS: number; theme: string }
-  | { type: "turntable"; durationS: number; subject: string }
-  | { type: "clip"; durationS: number; prompt: string };
-
-export type Storyboard = StoryboardPlan<VideoIntent>;
-
-export interface VideoAsset extends GeneratedAsset {
-  readonly kind: "video";
-  readonly durationS: number;
-  readonly format: "manifest-json" | "mp4";
-  readonly storyboardId: string;
-}
-
-export interface SyncedVideoOutput {
-  readonly videoTrack: readonly VideoAsset[];
-  readonly audioTrack?: readonly GeneratedAsset[];
-  readonly voiceTrack?: readonly GeneratedAsset[];
-  readonly captionTrack?: readonly { startS: number; endS: number; text: string }[];
-}
-
-export interface VideoHealth {
-  readonly provider: string;
-  readonly ok: boolean;
-  readonly suggestion?: string;
-}
-
-export interface VideoPipelineOptions {
-  readonly root?: string;
-}
-
-export async function readVideoDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
-  return readCapabilityDebug("video-pipeline", { root, limit });
-}
-
-function sceneCount(durationS: number): number {
-  return Math.max(1, Math.min(8, Math.ceil(durationS / 8)));
-}
-
-export class VideoPipeline {
-  readonly #root: string;
-
-  constructor(options: VideoPipelineOptions = {}) {
-    this.#root = options.root ?? process.cwd();
-  }
-
-  async plan(intent: VideoIntent, brandInput: BrandContext | undefined): Promise<Storyboard> {
-    const brand = requireBrandContext(brandInput, "video-pipeline");
-    const count = sceneCount(intent.durationS);
-    const baseDuration = Math.max(1, Math.floor(intent.durationS / count));
-    const scenes = Array.from({ length: count }, (_, index): StoryboardScene => {
-      const sceneNumber = index + 1;
-      const durationS =
-        index === count - 1 ? intent.durationS - baseDuration * index : baseDuration;
-      const prompt = `${brand.name} ${intent.type} scene ${sceneNumber}: ${summarizeBrandContext(brand)}`;
-      return {
-        id: `scene_${sceneNumber}`,
-        sceneIndex: sceneNumber,
-        prompt,
-        description: prompt,
-        duration: durationS,
-        durationS,
-        status: "draft",
-        outputEnabled: true,
-        selectedImageIndex: -1,
-        outputHistory: [],
-        outputHistoryCursor: -1,
-        referenceImages: brand.referenceImages.map((reference) => reference.path),
-        transition: index === 0 ? "cut" : "fade",
-        musicCue: brand.toneKeywords.join(", "),
-        voiceCue: sceneNumber === 1 ? "introduce the product promise" : "advance the story",
-      };
-    });
-    return {
-      id: assetId("storyboard", `${intent.type}_${brand.brandId}`),
-      tenantId: brand.tenantId,
-      brandId: brand.brandId,
-      intent,
-      scenes,
-      totalDurationS: storyboardTotalDuration(scenes),
-    };
-  }
-
-  async render(storyboard: Storyboard, brandInput: BrandContext | undefined): Promise<VideoAsset> {
-    const brand = requireBrandContext(brandInput, "video-pipeline");
-    const id = assetId("video", storyboard.id);
-    const path = join(this.#root, ".nebutra", "generated", "video-pipeline", `${id}.video.json`);
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(
-      path,
-      `${JSON.stringify({ storyboard, brand: summarizeBrandContext(brand), renderer: "manifest-local" }, null, 2)}\n`,
-      "utf8",
-    );
-    const asset: VideoAsset = {
-      id,
-      tenantId: brand.tenantId,
-      kind: "video",
-      path,
-      brandId: brand.brandId,
-      provider: "manifest-local",
-      model: "storyboard-manifest-v1",
-      createdAt: new Date().toISOString(),
-      license: { status: "commercial-ok", source: "deterministic local manifest" },
-      durationS: storyboard.totalDurationS,
-      format: "manifest-json",
-      storyboardId: storyboard.id,
-      metadata: { scenes: storyboard.scenes.length },
-    };
-    await appendCapabilityDebug("video-pipeline", { type: "render", asset }, { root: this.#root });
-    return asset;
-  }
-
-  async create(intent: VideoIntent, brand: BrandContext | undefined): Promise<VideoAsset> {
-    return this.render(await this.plan(intent, brand), brand);
-  }
-
-  async compose(output: SyncedVideoOutput): Promise<VideoAsset> {
-    const first = output.videoTrack[0];
-    if (!first) {
-      throw new Error("compose requires at least one video track");
-    }
-    const id = assetId("composition", first.id);
-    const path = join(this.#root, ".nebutra", "generated", "video-pipeline", `${id}.compose.json`);
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, `${JSON.stringify(output, null, 2)}\n`, "utf8");
-    return { ...first, id, path, storyboardId: first.storyboardId };
-  }
-
-  async cost(storyboard: Storyboard): Promise<{ estimatedUsd: number; durationS: number }> {
-    return {
-      estimatedUsd: Number((storyboard.totalDurationS * 0.003).toFixed(4)),
-      durationS: storyboard.totalDurationS,
-    };
-  }
-
-  async preview(storyboard: Storyboard): Promise<{ path: string }> {
-    const path = join(
-      this.#root,
-      ".nebutra",
-      "generated",
-      "video-pipeline",
-      `${storyboard.id}.preview.json`,
-    );
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, `${JSON.stringify(storyboard, null, 2)}\n`, "utf8");
-    return { path };
-  }
-
-  async doctor(): Promise<VideoHealth[]> {
-    return [
-      { provider: "manifest-local", ok: true },
-      {
-        provider: "local-video-model",
-        ok: Boolean(process.env.VIDEO_LOCAL_MODEL_PATH),
-        suggestion: "Set VIDEO_LOCAL_MODEL_PATH to enable local clip rendering.",
-      },
-      {
-        provider: "remote-video",
-        ok: Boolean(process.env.VIDEO_REMOTE_API_KEY),
-        suggestion: "Set VIDEO_REMOTE_API_KEY to enable remote video fallback.",
-      },
-    ];
-  }
-}

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "target": "esnext",
-    "types": ["node"],
-    "incremental": false
-  },
-  "include": ["src", "examples"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,17 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts"],
-  format: ["esm"],
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  target: "es2022",
-  external: [
-    "@nebutra/capability-kit/debug",
-    "@nebutra/errors",
-    "@nebutra/generation-context",
-    "@nebutra/image-pipeline",
-    "@nebutra/reel/storyboard",
-  ],
-});