@nebutra/image-pipeline 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @nebutra/image-pipeline
 
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @nebutra/capability-kit@2.0.0
+  - @nebutra/errors@2.0.0
+  - @nebutra/generation-context@0.1.4
+
 ## 0.1.2
 
 ### Patch Changes

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@nebutra/image-pipeline",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "BrandContext-first image generation and workflow routing surface",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "labs",
     "status": "wip",
     "productionReady": false,
     "surface": "generation-capability",
@@ -22,15 +23,19 @@
     "category": "ai",
     "summary": "BrandContext-first image/logo/poster/icon generation 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/errors": "0.1.2",
-    "@nebutra/generation-context": "0.1.2"
+    "@nebutra/capability-kit": "2.0.0",
+    "@nebutra/generation-context": "0.1.4",
+    "@nebutra/errors": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -51,6 +56,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/image-pipeline@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/image-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/image-pipeline/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/chunk-CYXB6GKX.js     4.76 KB
-ESM dist/index.js              152.00 B
-ESM dist/cli.js                1.29 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/cli.js.map            2.31 KB
-ESM dist/chunk-CYXB6GKX.js.map 9.26 KB
-ESM ⚡️ Build success in 22ms
-DTS Build start
-DTS ⚡️ Build success in 2047ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 1.47 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/image-pipeline@0.1.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/image-pipeline
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/image-pipeline
-
- ✓ src/index.test.ts (2 tests) 31ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  09:38:39
-   Duration  1.42s (transform 374ms, setup 0ms, import 524ms, tests 31ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

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

package/examples/logo.ts

@@ -1,9 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { ImagePipeline } from "../src/index";
-
-const asset = await new ImagePipeline().generate(
-  { type: "logo", company: "Loop", oneLiner: "AI debugging for indie devs" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${asset.path}\n`);

package/examples/poster.ts

@@ -1,9 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { ImagePipeline } from "../src/index";
-
-const asset = await new ImagePipeline().generate(
-  { type: "poster", title: "Ship with context", subtitle: "A founder operating system" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${asset.path}\n`);

package/examples/workflow.ts

@@ -1,10 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { ImagePipeline } from "../src/index";
-
-const asset = await new ImagePipeline().runWorkflow(
-  "hero",
-  { headline: "Debug the loop" },
-  createDemoBrandContext(),
-);
-
-process.stdout.write(`${asset.path}\n`);

package/src/cli.ts

@@ -1,32 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { ImagePipeline, readImageDebug } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const pipeline = new ImagePipeline();
-
-if (command === "doctor") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "image-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
-  );
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "image-pipeline", entries: await readImageDebug() }, null, 2)}\n`,
-  );
-} else if (command === "warmup") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "image-pipeline", result: await pipeline.warmup() }, null, 2)}\n`,
-  );
-} else if (command === "workflows") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "image-pipeline", workflows: await pipeline.workflows() }, null, 2)}\n`,
-  );
-} else if (command === "quickstart") {
-  const asset = await pipeline.generate(
-    { type: "logo", company: "Loop", oneLiner: "AI debugging for indie devs" },
-    createDemoBrandContext(),
-  );
-  process.stdout.write(`${JSON.stringify({ capability: "image-pipeline", asset }, null, 2)}\n`);
-} else {
-  process.stderr.write(`Unknown image-pipeline command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,33 +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 { ImagePipeline, readImageDebug } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("ImagePipeline", () => {
-  it("requires BrandContext", async () => {
-    const pipeline = new ImagePipeline();
-    await expect(
-      pipeline.generate({ type: "icon", subject: "debugger" }, undefined),
-    ).rejects.toMatchObject({ capability: "image-pipeline", suggestion: expect.any(String) });
-  });
-
-  it("writes a deterministic SVG asset with brand metadata", async () => {
-    root = await mkdtemp(join(tmpdir(), "image-pipeline-"));
-    const asset = await new ImagePipeline({ root }).generate(
-      { type: "logo", company: "Loop", oneLiner: "AI debugging" },
-      createDemoBrandContext(),
-    );
-    expect(asset.format).toBe("svg");
-    expect(await readFile(asset.path, "utf8")).toContain("Loop");
-    expect(await readImageDebug(root)).toHaveLength(1);
-  });
-});

package/src/index.ts

@@ -1,177 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
-import { CapabilityError } from "@nebutra/errors";
-import {
-  assetId,
-  type BrandContext,
-  type GeneratedAsset,
-  requireBrandContext,
-  summarizeBrandContext,
-} from "@nebutra/generation-context";
-
-export type ImageIntent =
-  | { type: "logo"; company: string; oneLiner: string }
-  | { type: "poster"; title: string; subtitle?: string }
-  | { type: "icon"; subject: string }
-  | { type: "hero"; headline: string }
-  | { type: "style-transfer"; sourcePath: string; instruction: string };
-
-export interface ImageAsset extends GeneratedAsset {
-  readonly kind: "image";
-  readonly width: number;
-  readonly height: number;
-  readonly format: "svg" | "png" | "jpg" | "webp";
-}
-
-export interface ImageHealth {
-  readonly provider: string;
-  readonly ok: boolean;
-  readonly suggestion?: string;
-}
-
-export interface ImagePipelineOptions {
-  readonly root?: string;
-  readonly provider?: "svg-local" | "comfy" | "remote";
-  readonly comfyUrl?: string;
-}
-
-export async function readImageDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
-  return readCapabilityDebug("image-pipeline", { root, limit });
-}
-
-function intentLabel(intent: ImageIntent): string {
-  switch (intent.type) {
-    case "logo":
-      return `${intent.company}: ${intent.oneLiner}`;
-    case "poster":
-      return `${intent.title}${intent.subtitle ? ` — ${intent.subtitle}` : ""}`;
-    case "icon":
-      return intent.subject;
-    case "hero":
-      return intent.headline;
-    case "style-transfer":
-      return `${intent.sourcePath}: ${intent.instruction}`;
-  }
-}
-
-function escapeXml(value: string): string {
-  return value
-    .replaceAll("&", "&amp;")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll('"', "&quot;");
-}
-
-function svgFor(intent: ImageIntent, brand: BrandContext): string {
-  const primary = brand.palette[0]?.hex ?? "#111111";
-  const accent = brand.palette.find((color) => color.role === "accent")?.hex ?? "#F3C14B";
-  const label = intentLabel(intent);
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="800" viewBox="0 0 1200 800">
-  <rect width="1200" height="800" fill="${escapeXml(primary)}"/>
-  <circle cx="960" cy="160" r="96" fill="${escapeXml(accent)}" opacity="0.9"/>
-  <text x="80" y="360" fill="#ffffff" font-family="${escapeXml(brand.typography.heading)}" font-size="78" font-weight="700">${escapeXml(brand.name)}</text>
-  <text x="84" y="440" fill="#ffffff" font-family="${escapeXml(brand.typography.body)}" font-size="34">${escapeXml(label)}</text>
-  <text x="84" y="520" fill="#ffffff" opacity="0.72" font-family="${escapeXml(brand.typography.body)}" font-size="24">${escapeXml(summarizeBrandContext(brand))}</text>
-</svg>`;
-}
-
-export class ImagePipeline {
-  readonly #root: string;
-  readonly #provider: "svg-local" | "comfy" | "remote";
-  readonly #comfyUrl: string;
-
-  constructor(options: ImagePipelineOptions = {}) {
-    this.#root = options.root ?? process.cwd();
-    this.#provider = options.provider ?? "svg-local";
-    this.#comfyUrl = options.comfyUrl ?? process.env.COMFYUI_URL ?? "http://127.0.0.1:8188";
-  }
-
-  async generate(intent: ImageIntent, brandInput: BrandContext | undefined): Promise<ImageAsset> {
-    const brand = requireBrandContext(brandInput, "image-pipeline");
-    if (this.#provider !== "svg-local") {
-      throw new CapabilityError("image-pipeline", `${this.#provider} provider is not configured`, {
-        suggestion:
-          "Use the zero-config svg-local provider or configure a sidecar adapter before selecting model-backed image generation.",
-        statusCode: 503,
-      });
-    }
-
-    const id = assetId("image", `${intent.type}_${intentLabel(intent)}`);
-    const path = join(this.#root, ".nebutra", "generated", "image-pipeline", `${id}.svg`);
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, svgFor(intent, brand), "utf8");
-
-    const asset: ImageAsset = {
-      id,
-      tenantId: brand.tenantId,
-      kind: "image",
-      path,
-      brandId: brand.brandId,
-      provider: "svg-local",
-      model: "brand-context-svg-v1",
-      createdAt: new Date().toISOString(),
-      license: { status: "commercial-ok", source: "deterministic local renderer" },
-      width: 1200,
-      height: 800,
-      format: "svg",
-      metadata: { intent, brandSource: brand.sourcePath },
-    };
-    await appendCapabilityDebug(
-      "image-pipeline",
-      { type: "generate", asset },
-      { root: this.#root },
-    );
-    return asset;
-  }
-
-  async runWorkflow(
-    workflowName: string,
-    inputs: Record<string, unknown>,
-    brand: BrandContext | undefined,
-  ): Promise<ImageAsset> {
-    requireBrandContext(brand, "image-pipeline");
-    return this.generate(
-      {
-        type: "poster",
-        title: workflowName,
-        subtitle: Object.keys(inputs).join(", ") || "workflow",
-      },
-      brand,
-    );
-  }
-
-  async doctor(): Promise<ImageHealth[]> {
-    const comfyConfigured = Boolean(process.env.COMFYUI_URL);
-    return [
-      { provider: "svg-local", ok: true },
-      comfyConfigured
-        ? { provider: "comfy", ok: true }
-        : {
-            provider: "comfy",
-            ok: false,
-            suggestion: `Set COMFYUI_URL to enable model-backed workflow execution. Default probe target is ${this.#comfyUrl}.`,
-          },
-      {
-        provider: "remote",
-        ok: Boolean(process.env.IMAGE_REMOTE_API_KEY),
-        suggestion: "Set IMAGE_REMOTE_API_KEY to enable remote image fallback.",
-      },
-    ];
-  }
-
-  async workflows(): Promise<readonly string[]> {
-    return ["logo", "poster", "icon", "hero", "style-transfer"];
-  }
-
-  async warmup(): Promise<ImageHealth> {
-    if (this.#provider === "svg-local") {
-      return { provider: this.#provider, ok: true };
-    }
-    return {
-      provider: this.#provider,
-      ok: false,
-      suggestion: "Start the image sidecar before warming model weights.",
-    };
-  }
-}

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,11 +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"],
-});