@nebutra/audio-pipeline 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @nebutra/audio-pipeline
 
+## 0.1.2
+
+### Patch Changes
+
+- Ship the MIT LICENSE file these packages have always declared but never included.
+
+  Every one of these declares `"license": "MIT"` in its manifest, and npm shows
+  that on the registry page — but the tarball carried no licence text at all.
+  MIT's own terms require the notice to accompany "all copies or substantial
+  portions of the Software", so a consumer vendoring one of these packages had
+  nothing to comply with.
+
+  No code changes. This is the licence text only, published so the tarballs
+  match what the manifests have been claiming.
+
+  `tests/architecture/release-surface.test.ts` now asserts the LICENSE _file_
+  exists and is MIT, not just the manifest _field_ — the field-only check is how
+  this went unnoticed, and is also how `create-sailor` shipped the full AGPL-3.0
+  text under an MIT declaration for its entire published history.
+
+- Updated dependencies []:
+  - @nebutra/generation-context@0.1.2
+  - @nebutra/capability-kit@0.2.2
+  - @nebutra/errors@0.1.2
+
 ## 0.1.1
 
 ### Patch Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wuxi Nebutra Intelligence Technology Co., Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/audio-pipeline",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "BrandContext-first audio generation, license metadata, and loudness utilities",
   "private": false,
   "license": "MIT",
@@ -22,18 +22,22 @@
     "category": "ai",
     "summary": "License-aware BGM, SFX, and song 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.1",
-    "@nebutra/errors": "0.1.1",
-    "@nebutra/generation-context": "0.1.1"
+    "@nebutra/capability-kit": "0.2.4",
+    "@nebutra/errors": "0.1.2",
+    "@nebutra/generation-context": "0.1.3"
   },
   "devDependencies": {
-    "@types/node": "^22.19.15",
+    "@types/node": "^25.9.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
@@ -51,6 +55,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/audio-pipeline@0.1.1 build /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/audio-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: /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/audio-pipeline/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/cli.js                1.32 KB
-ESM dist/index.js              186.00 B
-ESM dist/chunk-32LVUMTP.js     4.46 KB
-ESM dist/cli.js.map            2.35 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/chunk-32LVUMTP.js.map 8.83 KB
-ESM ⚡️ Build success in 79ms
-DTS Build start
-DTS ⚡️ Build success in 11452ms
-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/audio-pipeline@0.1.1 test /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/audio-pipeline
-> vitest run
-
-
- RUN  v4.1.4 /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/audio-pipeline
-
- ✓ src/index.test.ts (2 tests) 93ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  08:15:06
-   Duration  1.66s (transform 647ms, setup 0ms, import 774ms, tests 93ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/audio-pipeline@0.1.1 typecheck /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/audio-pipeline
-> tsc --noEmit
-

package/examples/bgm.ts

@@ -1,10 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const asset = await new AudioPipeline().generate(
-  { type: "bgm", durationS: 5, mood: "uplifting tech", bpm: 110 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${asset.path}\n`);

package/examples/license.ts

@@ -1,11 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const pipeline = new AudioPipeline();
-const asset = await pipeline.generate(
-  { type: "sfx", description: "keyboard typing", durationS: 2 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.license(asset), null, 2)}\n`);

package/examples/loudness.ts

@@ -1,11 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const pipeline = new AudioPipeline();
-const asset = await pipeline.generate(
-  { type: "song", lyricsPrompt: "indie developer anthem", durationS: 8 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.loudness(asset), null, 2)}\n`);

package/src/cli.ts

@@ -1,36 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline, readAudioDebug } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const pipeline = new AudioPipeline();
-
-if (command === "doctor") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
-  );
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", entries: await readAudioDebug() }, null, 2)}\n`,
-  );
-} else if (command === "license") {
-  const asset = await pipeline.generate(
-    { type: "bgm", durationS: 3, mood: "uplifting technical" },
-    createDemoBrandContext(),
-    true,
-  );
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", license: await pipeline.license(asset) }, null, 2)}\n`,
-  );
-} else if (command === "loudness") {
-  const asset = await pipeline.generate(
-    { type: "sfx", description: "keyboard typing", durationS: 1 },
-    createDemoBrandContext(),
-    true,
-  );
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", loudness: await pipeline.loudness(asset) }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown audio-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 { AudioPipeline, readAudioDebug } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("AudioPipeline", () => {
-  it("requires BrandContext", async () => {
-    await expect(
-      new AudioPipeline().generate({ type: "sfx", description: "click" }, undefined, true),
-    ).rejects.toMatchObject({ capability: "audio-pipeline" });
-  });
-
-  it("writes a valid WAV header with commercial metadata", async () => {
-    root = await mkdtemp(join(tmpdir(), "audio-pipeline-"));
-    const asset = await new AudioPipeline({ root }).generate(
-      { type: "bgm", durationS: 4, mood: "calm technical" },
-      createDemoBrandContext(),
-      true,
-    );
-    expect((await readFile(asset.path)).subarray(0, 4).toString()).toBe("RIFF");
-    expect(asset.license.status).toBe("commercial-ok");
-    expect(await readAudioDebug(root)).toHaveLength(1);
-  });
-});

package/src/index.ts

@@ -1,176 +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,
-  type LicenseMetadata,
-  requireBrandContext,
-} from "@nebutra/generation-context";
-
-export type AudioIntent =
-  | { type: "bgm"; durationS: number; mood: string; bpm?: number }
-  | { type: "sfx"; description: string; durationS?: number }
-  | { type: "song"; lyricsPrompt: string; durationS: number };
-
-export interface AudioAsset extends GeneratedAsset {
-  readonly kind: "audio";
-  readonly durationS: number;
-  readonly format: "wav";
-  readonly loudnessLufs: number;
-}
-
-export interface AudioHealth {
-  readonly provider: string;
-  readonly ok: boolean;
-  readonly suggestion?: string;
-}
-
-export interface AudioPipelineOptions {
-  readonly root?: string;
-  readonly provider?: "tone-local" | "local-model" | "remote";
-}
-
-export async function readAudioDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
-  return readCapabilityDebug("audio-pipeline", { root, limit });
-}
-
-function intentLabel(intent: AudioIntent): string {
-  switch (intent.type) {
-    case "bgm":
-      return intent.mood;
-    case "sfx":
-      return intent.description;
-    case "song":
-      return intent.lyricsPrompt;
-  }
-}
-
-function durationFor(intent: AudioIntent): number {
-  if (intent.type === "sfx") return Math.max(1, Math.min(intent.durationS ?? 3, 8));
-  return Math.max(1, Math.min(intent.durationS, 12));
-}
-
-export function createToneWav(durationS: number, frequency = 440, sampleRate = 24_000): Buffer {
-  const samples = Math.max(1, Math.floor(durationS * sampleRate));
-  const dataBytes = samples * 2;
-  const buffer = Buffer.alloc(44 + dataBytes);
-  buffer.write("RIFF", 0);
-  buffer.writeUInt32LE(36 + dataBytes, 4);
-  buffer.write("WAVE", 8);
-  buffer.write("fmt ", 12);
-  buffer.writeUInt32LE(16, 16);
-  buffer.writeUInt16LE(1, 20);
-  buffer.writeUInt16LE(1, 22);
-  buffer.writeUInt32LE(sampleRate, 24);
-  buffer.writeUInt32LE(sampleRate * 2, 28);
-  buffer.writeUInt16LE(2, 32);
-  buffer.writeUInt16LE(16, 34);
-  buffer.write("data", 36);
-  buffer.writeUInt32LE(dataBytes, 40);
-  for (let index = 0; index < samples; index += 1) {
-    const fade = Math.min(index / 1200, (samples - index) / 1200, 1);
-    const sample = Math.round(
-      Math.sin((2 * Math.PI * frequency * index) / sampleRate) * 9000 * fade,
-    );
-    buffer.writeInt16LE(sample, 44 + index * 2);
-  }
-  return buffer;
-}
-
-function frequencyFor(brand: BrandContext, intent: AudioIntent): number {
-  const base = brand.toneKeywords.join("").length + intentLabel(intent).length;
-  return 220 + (base % 9) * 55;
-}
-
-function licenseFor(requireCommercial: boolean, provider: string): LicenseMetadata {
-  if (requireCommercial && provider !== "tone-local") {
-    return {
-      status: "unknown",
-      source: provider,
-      suggestion: "Verify the provider plan and model terms before commercial use.",
-    };
-  }
-  return { status: "commercial-ok", source: "deterministic local renderer" };
-}
-
-export class AudioPipeline {
-  readonly #root: string;
-  readonly #provider: "tone-local" | "local-model" | "remote";
-
-  constructor(options: AudioPipelineOptions = {}) {
-    this.#root = options.root ?? process.cwd();
-    this.#provider = options.provider ?? "tone-local";
-  }
-
-  async generate(
-    intent: AudioIntent,
-    brandInput: BrandContext | undefined,
-    requireCommercial = true,
-  ): Promise<AudioAsset> {
-    const brand = requireBrandContext(brandInput, "audio-pipeline");
-    if (requireCommercial && this.#provider !== "tone-local") {
-      throw new CapabilityError(
-        "audio-pipeline",
-        "Selected audio provider lacks verified license",
-        {
-          suggestion: "Use tone-local or wire a provider with commercial license metadata.",
-          statusCode: 409,
-        },
-      );
-    }
-    const durationS = durationFor(intent);
-    const id = assetId("audio", `${intent.type}_${intentLabel(intent)}`);
-    const path = join(this.#root, ".nebutra", "generated", "audio-pipeline", `${id}.wav`);
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, createToneWav(durationS, frequencyFor(brand, intent)));
-
-    const asset: AudioAsset = {
-      id,
-      tenantId: brand.tenantId,
-      kind: "audio",
-      path,
-      brandId: brand.brandId,
-      provider: this.#provider,
-      model: "brand-context-tone-v1",
-      createdAt: new Date().toISOString(),
-      license: licenseFor(requireCommercial, this.#provider),
-      durationS,
-      format: "wav",
-      loudnessLufs: -18,
-      metadata: { intent, brandSource: brand.sourcePath },
-    };
-    await appendCapabilityDebug(
-      "audio-pipeline",
-      { type: "generate", asset },
-      { root: this.#root },
-    );
-    return asset;
-  }
-
-  async doctor(): Promise<AudioHealth[]> {
-    return [
-      { provider: "tone-local", ok: true },
-      {
-        provider: "local-model",
-        ok: Boolean(process.env.AUDIO_LOCAL_MODEL_PATH),
-        suggestion: "Set AUDIO_LOCAL_MODEL_PATH to enable local model generation.",
-      },
-      {
-        provider: "remote",
-        ok: Boolean(process.env.AUDIO_REMOTE_API_KEY),
-        suggestion: "Set AUDIO_REMOTE_API_KEY to enable remote audio fallback.",
-      },
-    ];
-  }
-
-  async license(asset: Pick<AudioAsset, "license">): Promise<LicenseMetadata> {
-    return asset.license;
-  }
-
-  async loudness(asset: Pick<AudioAsset, "loudnessLufs">): Promise<{ lufs: number }> {
-    return { lufs: asset.loudnessLufs };
-  }
-}

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