@hypit/hypit 0.1.4 → 0.1.6

package/packages/video-cli/src/studio-distribution.ts

@@ -11,9 +11,10 @@ export const videoStudioCompanionPackages = [
   "@hypit/deck-track-studio",
   "@hypit/film-studio",
   "@hypit/media-track-studio",
+  "@hypit/performance-studio",
   "@hypit/ranking-studio",
   "@hypit/screen-overlay-studio",
   "@hypit/script-studio",
-  "@hypit/speech-track-studio",
+  "@hypit/sound-studio",
   "@hypit/typography-track-studio",
 ] as const;

package/packages/volcengine-matting/README.md

@@ -30,20 +30,20 @@ formats. The service's flat-background MP4 option is a different output treatmen
 This excerpt assumes the performance and Script exist. Normalize keeps the transparent picture
 and prepares the selected embedded audio on the program clock. WhisperX and semantic alignment
 associate that prepared performance with the Script. Use `opening-semantic.take` in
-[Speech Track](../speech-track/README.md); its screen position and stack order are independent
+[Timeline assembly](../timeline-author/README.md); its screen position and stack order are independent
 of its role as A-roll.
 
 For B-roll, normalize `cutout.video` with `audio="none"` when its sound is unwanted, then use
 `cutout-media.media` in [Media Track](../media-track/README.md). No SemanticTake is needed for
 that overlay. Existing transparency can enter Normalize directly.
 
-For example, this alternative uses the existing program's SemanticTrack and an authored Selection:
+For example, this alternative uses the existing program's Timeline and an authored Selection:
 
 ```svml
 <import as="media-track" from="@hypit/media-track@1"/>
 <pipeline:Normalize id="overlay-media" source={cutout.video} clock={clock}
   video="primary-moving" audio="none" span-authority="video"/>
-<media-track:Track id="overlay" semantic={speech.semantic} canvas={canvas}>
+<media-track:Track id="overlay" timeline={speech.timeline} canvas={canvas}>
   <media-track:Item media={overlay-media.media} during={story.selection.example}
     frame={overlay-frame} appearance={look.media.overlay}/>
 </media-track:Track>

package/packages/whisperx/README.md

@@ -33,7 +33,7 @@ so this branch requests no evidence audio and no WhisperX capability:
   segment={story.segment.pause} media={pause-media.media}/>
 ```
 
-There is no whole-program WhisperX pass. Speech Track only receives already-semantic Takes and later
+There is no whole-program WhisperX pass. Timeline assembly only receives already-semantic Takes and later
 translates their local frames when assembling the final ProgramSpace and complete semantic map.
 
 `@hypit/provider-hypihub` is the default concrete adapter; it uploads the canonical evidence audio

package/services/whisperx/README.md

@@ -71,6 +71,14 @@ Configuration is deployment state:
 The Node Provider must configure the same model, device, compute, batch size, service version and
 WhisperX version. A mismatch fails before transcription results are accepted.
 
+## Package preparation
+
+Local package preparation includes `src/**/*.py` in uv's package cache inputs. Updating service code
+therefore rebuilds its small wheel instead of reusing one selected only by an unchanged
+`pyproject.toml`. This leaves dependency and speech-model caches intact. See
+[uv's local dependency caching](https://docs.astral.sh/uv/concepts/cache/#dynamic-metadata).
+This governs package installation; an already running service continues using its loaded code.
+
 ## Queue and concurrency
 
 The SVML Runtime Scheduler decides how many WhisperX Needs may enter this Provider lane. One service
@@ -80,3 +88,9 @@ second direct request receives `503 BUSY` instead of entering a hidden service q
 
 Run multiple service processes on different devices/ports only when the Runtime registers and
 locks them as distinct Provider instances.
+
+The local Provider reconciles this packaged project through `uv sync` before a cold service start.
+A passing version probe alone cannot establish that same-version checkout edits were installed;
+the declared uv source cache keys decide whether the service wheel needs rebuilding. A healthy
+running service remains untouched. To adopt edited service code, stop that selected helper when idle
+and start it again through its Profile; restarting only the Build Worker does not reinstall Python.

package/services/whisperx/pyproject.toml

@@ -24,3 +24,5 @@ where = ["src"]
 
 [tool.uv]
 package = true
+# Rebuild this small service wheel when its packaged Python implementation changes.
+cache-keys = [{ file = "pyproject.toml" }, { file = "src/**/*.py" }]

package/services/whisperx/uv.lock

@@ -867,6 +867,23 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a8/af/48ac8483240de756d2438c380746e7130d1c6f75802ef22f3c6d49982787/huggingface_hub-0.36.2-py3-none-any.whl", hash = "sha256:48f0c8eac16145dfce371e9d2d7772854a4f591bcb56c9cf548accf531d54270", size = 566395, upload-time = "2026-02-06T09:24:11.133Z" },
 ]
 
+[[package]]
+name = "hypit-whisperx-service"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "numpy", version = "2.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "whisperx" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "numpy", specifier = ">=2.1,<3" },
+    { name = "whisperx", specifier = "==3.8.6" },
+]
+
 [[package]]
 name = "idna"
 version = "3.18"
@@ -1410,7 +1427,7 @@ wheels = [
 
 [[package]]
 name = "nltk"
-version = "3.10.2"
+version = "3.10.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
@@ -1419,9 +1436,9 @@ dependencies = [
     { name = "regex" },
     { name = "tqdm" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/72/16/24d639531e73cbc6884fb251d116dfe469df9c595e0dcf24668c54d0e8d3/nltk-3.10.2.tar.gz", hash = "sha256:fcfd80fb77931868cea8357573c79838b8abc609942ef9914d1c9f6070d4645c", size = 3101716, upload-time = "2026-08-05T09:56:20.657Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/e6/fe51d2bb1a3b446f59c5c8165999a9fee208bc346af90a7cbf7657bc0d75/nltk-3.10.3.tar.gz", hash = "sha256:bb9327a461c3811c2fa4900e03840401f2126adfb30c0072827c433bd2444ea4", size = 5137152, upload-time = "2026-08-12T23:46:37.258Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1f/2b/bf677eb32ca6684b270c0d19ab133c2271e9f3375997e5a8dd2b08e3152d/nltk-3.10.2-py3-none-any.whl", hash = "sha256:2c7ccacb765c5e26b0cb60fb1b57080af522c6924d12a714a243305ba3637412", size = 1725815, upload-time = "2026-08-05T09:56:09.657Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/6d/ebd2af4640b12168fdf0cb74b6118df2f32a2f62ec7e0c06fbfd80706639/nltk-3.10.3-py3-none-any.whl", hash = "sha256:ff9598a8e20518ee0d557745890cc4435b9578489e2dcbc69c4f81fa060caf7c", size = 1798643, upload-time = "2026-08-12T23:44:13.478Z" },
 ]
 
 [[package]]
@@ -2907,23 +2924,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e2/22/dbf013a12ec759e54a34a119e9e217435b3f71b2dd5c61a7ade0a25dae87/sqlalchemy-2.0.51-py3-none-any.whl", hash = "sha256:bb024d8b621d0be75f4f44ecc7c950450026e76d66dc8f791bb5331d7fed59d5", size = 1944334, upload-time = "2026-06-15T16:09:22.418Z" },
 ]
 
-[[package]]
-name = "hypit-whisperx-service"
-version = "0.1.0"
-source = { editable = "." }
-dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
-    { name = "numpy", version = "2.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
-    { name = "whisperx" },
-]
-
-[package.metadata]
-requires-dist = [
-    { name = "numpy", specifier = ">=2.1,<3" },
-    { name = "whisperx", specifier = "==3.8.6" },
-]
-
 [[package]]
 name = "sympy"
 version = "1.14.0"

package/packages/provider-hyperframes-aws-lambda/README.md

@@ -1,30 +0,0 @@
-# `@hypit/provider-hyperframes-aws-lambda`
-
-Asynchronous AWS Step Functions/Lambda implementation of the exact
-`@hypit/render-hyperframes#render-visual` capability.
-
-The Endpoint stages the immutable `HyperframesDocument` with the shared
-`stageHyperframesProject()` layout, uploads that operation-scoped site, starts one distributed
-render and persists its execution ARN in the Operation checkpoint. Its Step Functions execution name is derived from the
-Runtime Operation id, so recovery cannot accidentally submit the same attempt twice.
-Cancellation uses that same identity to stop the remote Step Functions execution, including the
-crash window before the first checkpoint was saved.
-
-This Provider accepts whole-document requests at integer 24, 30 and 60 fps; it currently declines
-requests containing a frame range. Its chunk settings partition a whole render across Lambda workers,
-whereas the local Provider also accepts a selected interval. Unsupported Needs
-are declined by `supports()` so another Endpoint may satisfy them; no frame rate or GPU intent is
-silently changed. The Provider always requests strict SDR H.264, exact CFR assembly, software
-browser rendering and plan protocol v2. It also declines Surface-bearing documents until the
-remote route owns the same byte verifier as the local Endpoint. Chunking remains deployment
-configuration.
-
-On success the Endpoint requires HyperFrames' plan and completed-frame counts to equal the source
-document, then streams the returned S3 object into the current Build's working byte area.
-The Endpoint's Runtime Profile entry selects the AWS state machine and deployment settings. The Provider does not repeat
-the request or selected endpoint as vendor metadata. Container and stream conformance stays in the explicit media
-inspection/mux capabilities, so the orchestrating machine does not acquire a hidden FFmpeg
-dependency.
-
-The production client uses the AWS SDK default credential chain. No access key is accepted by the
-package configuration or written into Build state.

package/packages/provider-hyperframes-aws-lambda/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "@hypit/provider-hyperframes-aws-lambda",
-  "version": "0.0.0-dev",
-  "license": "SEE LICENSE IN LICENSE",
-  "private": true,
-  "type": "module",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "hypit": {
-    "activation": "./src/activation.ts"
-  },
-  "dependencies": {
-    "@aws-sdk/client-s3": "3.1103.0",
-    "@aws-sdk/client-sfn": "3.1103.0",
-    "@hyperframes/aws-lambda": "0.7.101",
-    "@hypit/endpoint-kit": "workspace:*",
-    "@hypit/hyperframes": "workspace:*",
-    "@hypit/media": "workspace:*",
-    "@hypit/protocol": "workspace:*",
-    "@hypit/render-hyperframes": "workspace:*",
-    "@hypit/runtime": "workspace:*",
-    "@hypit/runtime-kit": "workspace:*"
-  },
-  "devDependencies": {
-    "@hypit/composition": "workspace:*",
-    "@hypit/driver-node": "workspace:*",
-    "@hypit/program-space": "workspace:*"
-  }
-}

package/packages/provider-hyperframes-aws-lambda/src/activation.ts

@@ -1,97 +0,0 @@
-import type { CanonicalValue } from "@hypit/protocol";
-import {
-  createRuntimeEndpointAdapterFacet,
-  runtimeConfigExact,
-  runtimeConfigObject,
-  runtimeConfigPositiveInteger,
-  runtimeConfigString,
-} from "@hypit/runtime-kit";
-import type { RuntimeAdapterFactoryContext } from "@hypit/runtime-kit";
-
-import { createAwsLambdaHyperframesProvider } from "./provider.js";
-import type {
-  CreateAwsLambdaHyperframesProviderOptions,
-  HyperframesLambdaQuality,
-} from "./provider.js";
-
-const CONFIG_KEYS = [
-  "stateMachineArn", "bucketName", "quality", "chunkSize", "maxParallelChunks",
-  "targetChunkFrames", "defaultMemorySizeMb", "defaultConcurrency", "pollIntervalMs",
-  "maxOperationMs", "maxRenderedBytes",
-] as const;
-
-type RuntimeProviderOptions = Omit<
-  CreateAwsLambdaHyperframesProviderOptions,
-  "client" | "now"
->;
-
-function optionalInteger(
-  config: Record<string, CanonicalValue>,
-  name: string,
-): number | undefined {
-  return runtimeConfigPositiveInteger(config[name], `HyperFrames ${name}`);
-}
-
-function providerOptions(context: RuntimeAdapterFactoryContext): RuntimeProviderOptions {
-  if (context.pool === undefined) throw new Error("AWS Lambda HyperFrames Provider Pool is required");
-  const config = runtimeConfigObject(context.config, "AWS Lambda HyperFrames");
-  runtimeConfigExact(config, CONFIG_KEYS, "AWS Lambda HyperFrames");
-  const stateMachineArn = runtimeConfigString(config.stateMachineArn, "HyperFrames stateMachineArn");
-  if (stateMachineArn === undefined) throw new Error("AWS Lambda HyperFrames stateMachineArn is required");
-  const machine = /^(arn:aws(?:-[a-z]+)*:states):([a-z0-9-]+):(\d{12}):stateMachine:([A-Za-z0-9_-]+)$/u
-    .exec(stateMachineArn);
-  if (machine === null) {
-    throw new Error(`HyperFrames stateMachineArn must be an unqualified AWS Step Functions state-machine ARN; got ${stateMachineArn}`);
-  }
-  const bucketName = runtimeConfigString(config.bucketName, "HyperFrames bucketName");
-  if (bucketName === undefined) throw new Error("AWS Lambda HyperFrames bucketName is required");
-  if (!/^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/u.test(bucketName)
-    || bucketName.includes("..") || bucketName.includes(".-") || bucketName.includes("-.")
-    || /^\d{1,3}(?:\.\d{1,3}){3}$/u.test(bucketName)) {
-    throw new Error("HyperFrames bucketName is invalid");
-  }
-  const quality = runtimeConfigString(config.quality, "HyperFrames quality");
-  if (quality !== undefined && quality !== "draft" && quality !== "standard" && quality !== "high") {
-    throw new Error("HyperFrames quality is invalid");
-  }
-  const chunkSize = optionalInteger(config, "chunkSize");
-  const maxParallelChunks = optionalInteger(config, "maxParallelChunks");
-  const targetChunkFrames = optionalInteger(config, "targetChunkFrames");
-  if (chunkSize !== undefined && targetChunkFrames !== undefined) {
-    throw new Error("HyperFrames chunkSize and targetChunkFrames are mutually exclusive");
-  }
-  const defaultMemorySizeMb = optionalInteger(config, "defaultMemorySizeMb");
-  const defaultConcurrency = optionalInteger(config, "defaultConcurrency");
-  const pollIntervalMs = optionalInteger(config, "pollIntervalMs");
-  const maxOperationMs = optionalInteger(config, "maxOperationMs");
-  const maxRenderedBytes = optionalInteger(config, "maxRenderedBytes");
-  return {
-    instance: context.instance,
-    pool: context.pool,
-    stateMachineArn,
-    bucketName,
-    ...(quality === undefined ? {} : { quality: quality as HyperframesLambdaQuality }),
-    ...(chunkSize === undefined ? {} : { chunkSize }),
-    ...(maxParallelChunks === undefined ? {} : { maxParallelChunks }),
-    ...(targetChunkFrames === undefined ? {} : { targetChunkFrames }),
-    ...(defaultMemorySizeMb === undefined ? {} : { defaultMemorySizeMb }),
-    ...(defaultConcurrency === undefined ? {} : { defaultConcurrency }),
-    ...(pollIntervalMs === undefined ? {} : { pollIntervalMs }),
-    ...(maxOperationMs === undefined ? {} : { maxOperationMs }),
-    ...(maxRenderedBytes === undefined ? {} : { maxRenderedBytes }),
-  };
-}
-
-const awsLambdaHyperframesRuntimeAdapter = createRuntimeEndpointAdapterFacet({
-  use: "@hypit/provider-hyperframes-aws-lambda",
-  activate(context) {
-    return { endpoint: createAwsLambdaHyperframesProvider(providerOptions(context)) };
-  },
-});
-
-export const hypitPackage = {
-  format: "hypit.node-package@1" as const,
-  hostFacets: [awsLambdaHyperframesRuntimeAdapter],
-};
-
-export default hypitPackage;

package/packages/provider-hyperframes-aws-lambda/src/client.ts

@@ -1,114 +0,0 @@
-import { GetObjectCommand, S3Client } from "@aws-sdk/client-s3";
-import { SFNClient, StopExecutionCommand } from "@aws-sdk/client-sfn";
-import {
-  deploySite,
-  getRenderProgress,
-  renderToLambda,
-} from "@hyperframes/aws-lambda/sdk";
-import type {
-  RenderHandle,
-  RenderProgress,
-  SerializableDistributedRenderConfig,
-  SiteHandle,
-} from "@hyperframes/aws-lambda/sdk";
-
-export type HyperframesLambdaSite = SiteHandle;
-export type HyperframesLambdaRender = RenderHandle;
-export type HyperframesLambdaProgress = RenderProgress;
-export type HyperframesLambdaRenderConfig = SerializableDistributedRenderConfig;
-
-export type HyperframesLambdaOutput = {
-  readonly chunks: AsyncIterable<Uint8Array>;
-  readonly contentLength?: number;
-};
-
-export interface HyperframesAwsLambdaClient {
-  deploySite(input: {
-    readonly projectDir: string;
-    readonly bucketName: string;
-    readonly region: string;
-  }): Promise<HyperframesLambdaSite>;
-  render(input: {
-    readonly siteHandle: HyperframesLambdaSite;
-    readonly config: HyperframesLambdaRenderConfig;
-    readonly bucketName: string;
-    readonly stateMachineArn: string;
-    readonly region: string;
-    readonly outputKey: string;
-    readonly executionName: string;
-  }): Promise<HyperframesLambdaRender>;
-  progress(input: {
-    readonly executionArn: string;
-    readonly defaultMemorySizeMb: number;
-    readonly region: string;
-  }): Promise<HyperframesLambdaProgress>;
-  stop(input: {
-    readonly executionArn: string;
-    readonly region: string;
-    readonly reason: string;
-  }): Promise<void>;
-  openOutput(input: {
-    readonly s3Uri: string;
-    readonly region: string;
-  }): Promise<HyperframesLambdaOutput>;
-}
-
-function assert(condition: unknown, message: string): asserts condition {
-  if (!condition) throw new Error(message);
-}
-
-export function parseS3Uri(uri: string): { readonly bucket: string; readonly key: string } {
-  let parsed: URL;
-  try {
-    parsed = new URL(uri);
-  } catch {
-    throw new Error(`HyperFrames output URI is invalid: ${uri}`);
-  }
-  assert(parsed.protocol === "s3:" && parsed.hostname.length > 0 && parsed.pathname.length > 1,
-    `HyperFrames output URI must be s3://bucket/key; got ${uri}`);
-  assert(parsed.search.length === 0 && parsed.hash.length === 0,
-    "HyperFrames output URI must not contain a query or fragment");
-  return { bucket: parsed.hostname, key: decodeURIComponent(parsed.pathname.slice(1)) };
-}
-
-async function* byteChunks(body: unknown): AsyncIterable<Uint8Array> {
-  assert(body !== null && typeof body === "object" && Symbol.asyncIterator in body,
-    "HyperFrames S3 output has no streaming body");
-  for await (const chunk of body as AsyncIterable<unknown>) {
-    if (typeof chunk === "string") yield Buffer.from(chunk);
-    else if (chunk instanceof Uint8Array) yield chunk;
-    else throw new Error("HyperFrames S3 output emitted a non-byte chunk");
-  }
-}
-
-/** Uses only the AWS SDK default credential chain. No credential bytes enter this package. */
-export function createHyperframesAwsLambdaClient(region: string): HyperframesAwsLambdaClient {
-  const s3 = new S3Client({ region });
-  const sfn = new SFNClient({ region });
-  return {
-    deploySite: async (input) => await deploySite({ ...input, s3 }),
-    render: async (input) => await renderToLambda({
-      ...input,
-      planProtocol: "v2",
-      s3,
-      sfn,
-    }),
-    progress: async (input) => await getRenderProgress({ ...input, sfn }),
-    async stop(input) {
-      await sfn.send(new StopExecutionCommand({
-        executionArn: input.executionArn,
-        error: "HypitBuildCancelled",
-        cause: input.reason,
-      }));
-    },
-    async openOutput(input) {
-      const target = parseS3Uri(input.s3Uri);
-      const output = await s3.send(new GetObjectCommand({ Bucket: target.bucket, Key: target.key }));
-      if (output.Body === undefined) throw new Error(`HyperFrames output ${input.s3Uri} has no body`);
-      return {
-        chunks: byteChunks(output.Body),
-        ...(output.ContentLength === undefined ? {} : { contentLength: output.ContentLength }),
-      };
-    },
-  };
-}

package/packages/provider-hyperframes-aws-lambda/src/index.ts

@@ -1,21 +0,0 @@
-export {
-  createHyperframesAwsLambdaClient,
-  parseS3Uri,
-} from "./client.js";
-export type {
-  HyperframesAwsLambdaClient,
-  HyperframesLambdaOutput,
-  HyperframesLambdaProgress,
-  HyperframesLambdaRender,
-  HyperframesLambdaRenderConfig,
-  HyperframesLambdaSite,
-} from "./client.js";
-export {
-  awsLambdaHyperframesProviderModuleRef,
-  createAwsLambdaHyperframesProvider,
-  supportsAwsLambdaHyperframes,
-} from "./provider.js";
-export type {
-  CreateAwsLambdaHyperframesProviderOptions,
-  HyperframesLambdaQuality,
-} from "./provider.js";