@hraness/slopcamera 3.3.3 → 3.3.5

package/README.md

@@ -9,10 +9,21 @@ from retained sources.**
 Describe a finished result to Codex, Claude, or another coding agent. Slopcamera gives
 it a Bun CLI, TypeScript SDK, and version-matched Agent Skill to inspect sources,
 direct cameras, edit a composition, and render the result. A separate MCP server
-exposes a fixed diagram and image toolset. There is no Slopcamera account or hosted
+exposes fixed tools for diagrams, images, and scene inspection and planning. There is no Slopcamera account or hosted
 project database.
 
-[Install](#install-slopcamera) · [Make a first diagram](#make-your-first-diagram) · [Capabilities](#what-slopcamera-does) · [Documentation](docs/README.md) · [slopcamera.com](https://slopcamera.com)
+[Install](#install-slopcamera) · [Make a first diagram](#make-your-first-diagram) · [Capabilities](#what-slopcamera-does) · [Documentation](https://slopcamera.com/docs) · [slopcamera.com](https://slopcamera.com)
+
+## Made with Slopcamera
+
+[![An original brass optical instrument rendered in Blender](apps/web/media/native-product-poster-51b1658c46d3.webp)](https://slopcamera.com/docs/tutorials/first-native-film#inspect-the-finished-example)
+
+Watch the [six-second product film](https://slopcamera.com/docs/tutorials/first-native-film#inspect-the-finished-example),
+then change its [geometry, materials and camera](examples/showcase/native/product).
+For 2D motion, try the [editable editorial animation](https://slopcamera.com/docs/tutorials/first-animation).
+The [portrait geometry lesson](https://slopcamera.com/docs/how-to/educational-video#inspect-the-finished-example)
+adds mathematical typesetting, a presenter and authored captions. Each guide pairs
+the rendered output with source, runtime requirements and reproduction steps.
 
 ## Why Slopcamera
 
@@ -33,14 +44,14 @@ project database.
 
 ## Install Slopcamera
 
-Slopcamera v3.3.2 fixes prop reattachment, canonical scene bindings, and saved behavior-bake auditing.
+Slopcamera v3.3.4 admits image and video references in directing shots, adds a hosted tool API for agent platforms, and shows reproducible workflows across the site and docs.
 
 Install [Bun 1.3.14 or newer](https://bun.sh), then install the verified
-[Slopcamera v3.3.2 release](https://github.com/hraness/slopcamera/releases/tag/v3.3.2)
+[Slopcamera v3.3.4 release](https://github.com/hraness/slopcamera/releases/tag/v3.3.4)
 from its canonical archive:
 
 ```sh
-bun add --global https://github.com/hraness/slopcamera/releases/download/v3.3.2/hraness-slopcamera-3.3.2.tgz
+bun add --global https://github.com/hraness/slopcamera/releases/download/v3.3.4/hraness-slopcamera-3.3.4.tgz
 slopcamera skill install --target agents
 ```
 
@@ -98,7 +109,7 @@ change an existing release.
 
 ## Make your first diagram
 
-After the source build above, this local task needs no model account. In a new directory,
+After installing Slopcamera, this local task needs no model account. In a new directory,
 create the included diagram, check it, and render it:
 
 ```sh
@@ -115,10 +126,11 @@ You now have `example-flow.tldr`, `example-flow.light.svg`,
 editable, and the `.tldr` file is editable tldraw interchange. Rendering again
 replaces those five derived files.
 
-Follow [Your first diagram](docs/tutorials/first-diagram.md) to change a label and
-see the result. For a moving 3D subject, use [Directed scenes](docs/spatial-scenes.md).
-For detailed native 3D from the current source build, follow
-[Your first native film](docs/tutorials/first-native-film.md).
+Follow [Your first diagram](https://slopcamera.com/docs/tutorials/first-diagram) to change a label and
+see the result. To animate type and SVG, [make your first animation](https://slopcamera.com/docs/tutorials/first-animation). For a moving 3D subject, use [Directed scenes](docs/spatial-scenes.md).
+For detailed native 3D, follow
+[Your first native film](docs/tutorials/first-native-film.md). To generate editable
+architecture from dimensions, [build a parametric design](https://slopcamera.com/docs/how-to/parametric-design).
 
 ## What Slopcamera does
 
@@ -134,12 +146,12 @@ GPU path. Spark admits saved splat worlds for local camera direction.
 > mount the product diagram on a screen in the scene, and show me contact frames
 > before rendering the video.
 
-The portable GLB profile has a defined geometry and material subset; the
-additive rigged profile admits bounded skins and morph targets. Saved splats
+The portable GLB profiles have defined geometry and material subsets. The
+rigged/morph profile in v3.3.1 admits bounded skins and morph targets. Saved splats
 capture appearance; they do not establish collision geometry or editable native
 meshes. See [Directed scenes](docs/spatial-scenes.md).
 
-Current source adds the cinematic planning loop: a `slopcamera.spatial-direction`
+Slopcamera v3.3.1 includes the cinematic planning loop: a `slopcamera.spatial-direction`
 document describes beats, actions, camera coverage, and look intents, compiles
 into proposed performance/camera/cinema/material-lighting/shot documents, and
 fans out into bounded galleries per axis. Declared effects bind into renders,
@@ -160,7 +172,7 @@ See [Direct a cinematic world](docs/how-to/direct-cinematic-worlds.md) and the
 
 ### Film native worlds and educational animation
 
-The current source build can direct Blender for detailed sets, materials,
+Slopcamera can direct Blender for detailed sets, materials,
 lighting, skinned characters, cloth and liquid caches; CadQuery for parametric
 solids and STEP; and Manim Community for mathematical animation. Seven editable
 starters include a product, character, shaded street, cloth, liquid, CAD bracket,
@@ -181,11 +193,19 @@ and [Make an educational video](docs/how-to/educational-video.md).
 ### Build diagrams and motion graphics
 
 Create editable diagrams with tldraw, SVG, and PNG outputs, or turn raster artwork
-into SVG locally with VTracer. Animate graphic layers with HTML, SVG, Motion,
+into SVG locally with VTracer. [Compare a color trace and duotone](https://slopcamera.com/docs/how-to/vectorize-images)
+from the same original raster. Animate graphic layers with HTML, SVG, Motion,
 p5, Two, Paper Shaders, or Three.js. Outputs can stand alone or join a video
 project. The optional vgpu example renders programmable WebGPU passes into
 retained raster frames for use on a world-space screen.
 
+[Render motion graphics from HTML](https://slopcamera.com/docs/how-to/render-motion-graphics)
+connects original examples across all seven profiles to editable source and exact
+render requests. Try the [editorial title](examples/showcase/html/editorial.json),
+[kinetic typography](examples/showcase/html/kinetic-title.json), or
+[Three.js island with original music](examples/showcase/html/island-pulse.json).
+These source examples live in the current repository; `html render` ships in v3.2.8.
+
 Use `slopcamera html catalog` to inspect the admitted local creative tools. The
 [creative toolkit reference](docs/html-overlay-creative-toolkit.md) distinguishes
 available profiles from upstream possibilities. vgpu does not enable shared GPU
@@ -194,11 +214,19 @@ textures or a Three WebGPU renderer inside the current WebGL2/Spark profile.
 ### Generate and direct media
 
 Discover image, video, speech, and transcription models through your own Vercel
-AI Gateway access. Generate images from text and references, add a voiceover,
+AI Gateway access. Set `AI_GATEWAY_API_KEY` in the local process environment;
+the Vercel CLI is optional. Generate images from text and references, add a voiceover,
 transcribe sound, or create video shots using the selected model's supported
 inputs. Availability and pricing come from the live catalog.
 
-The current source build also provides `direct` shot recipes: retain a film
+Without a Gateway credential, prepaid Hraness Credits run prompt-only image
+generation through the hosted API: `slopcamera credits topup` prints a hosted
+checkout, `slopcamera credits wait` installs the returned device token, and
+`slopcamera ai image generate --hosted` bills that wallet instead of your own
+Gateway key. A stored token also routes `ai image generate` to the hosted API
+automatically when no Gateway credential is configured.
+
+The released CLI also provides `direct` shot recipes: retain a film
 budget across attempts, review each take before accepting it, and use an accepted
 clip's last decoded frame as the next shot's reference. Changed predecessors
 invalidate affected continuations while earlier paid results remain retained.
@@ -220,8 +248,11 @@ from the same edit.
 > Edit my product demo: cut the pauses, zoom into each important click, keep the
 > speaker framed, add captions and `logo.svg`, and show a preview before export.
 
-Recording bundles can carry clicks, cursor movement, key activity, and
-focused-input information. Read [`PRIVACY.md`](PRIVACY.md) before editing
+The released and current CLIs edit existing recording bundles; they do not
+capture new recordings. Bundles can carry clicks, cursor movement, key activity,
+and focused-input information. Automatic screen-action zooms need this metadata.
+Standalone media imports need an existing project; `html render`, `studio assemble`,
+or `direct assemble` can create one. Read [`PRIVACY.md`](PRIVACY.md) before editing
 sensitive material.
 
 Start with [Edit a video](docs/how-to/edit-video.md) or inspect a reusable recipe:
@@ -236,7 +267,7 @@ slopcamera workflows show social-variants --json
 Keep the source that owns each creative decision. A native scene owns a rig or
 simulation; a portable scene owns supported geometry, cameras, and media surfaces;
 a diagram owns its objects and labels; a video project owns cuts and delivery.
-SLOPCAMERA connects these through explicit assets and rendered derivatives.
+Slopcamera connects these through explicit assets and rendered derivatives.
 
 1. **Prepare the sources.** Import footage and assets or author a scene, diagram,
    or native program. Inspect available tools before choosing an engine.
@@ -274,16 +305,19 @@ declarative graphs, approvals, and resuming work.
 - **Trusted code is not sandboxed.** Native Python and caller-authored Bun
   workflows run with the current user's access. Hashes and receipts identify
   observed inputs and outputs; they do not make arbitrary code hermetic.
-- **MCP is a subset.** Its fixed tools check and render diagrams, plan and audit
-  scenes, and run the bounded portable operations. It does not expose every
-  local CLI operation and never mutates project state.
+- **MCP is a subset.** Its 17 fixed tools check and render diagrams, plan and audit
+  scenes, and run six bounded portable operation codes in v3.3.1. It does not
+  expose every local CLI operation and never mutates project state.
 
 ## Design and trust
 
 There is no Slopcamera account, hosted project database, or browser generation service.
 Ordinary editing and rendering remain local. Gateway generation and selected
 cloud analysis use credentials from the local process and request explicit
-acknowledgement before uploading named media. This website never accepts a
+acknowledgement before uploading named media. The optional hosted API runs each
+paid image call in an ephemeral workspace against a Hraness Credits device token
+and keeps no credentials or projects; the device token lives in owner-only files
+under the CLI state root and never reaches argv or receipts. This website never accepts a
 Gateway credential. Native Python requires separate authorization. Custom Bun
 workflow modules execute when loaded, including during check and plan; review
 their source first. Both have the current user's access, including potential
@@ -295,7 +329,7 @@ Native tools, providers, codecs, and GPU drivers can affect results, so retained
 source identity alone does not promise identical pixels on another machine.
 
 See [Architecture](docs/architecture.md), [`SECURITY.md`](SECURITY.md),
-[`PRIVACY.md`](PRIVACY.md), and [`NOTICE`](NOTICE) for the detailed boundaries.
+[`PRIVACY.md`](PRIVACY.md), and [`NOTICE.md`](NOTICE.md) for the detailed boundaries.
 
 ## Documentation
 
@@ -347,7 +381,7 @@ changing a package or runtime boundary. Report vulnerabilities through
 
 ## License
 
-[MIT](LICENSE), with third-party notices in [`NOTICE`](NOTICE).
+[MIT](LICENSE), with third-party notices in [`NOTICE.md`](NOTICE.md).
 
 ## Optional support
 

package/apps/desktop/application/directing-contract.ts

@@ -20,6 +20,10 @@ const MoneySchema = z.number().int().safe().positive();
 const TextSchema = z.string().min(1).max(100_000).refine(value => value.trim().length > 0 && !/[\u0000-\u0008\u000b\u000c\u000e-\u001f]/u.test(value), "Text must be nonempty and contain no disallowed control characters.");
 const ImageSchema = GatewayMediaSourceReferenceSchema.refine(source => source.mediaType.startsWith("image/") && source.bytes <= 50 * 1024 * 1024, "A directing frame must be an image of at most 50 MiB.");
 const VideoSourceSchema = GatewayMediaSourceReferenceSchema.refine(source => source.mediaType.startsWith("video/") && source.facts?.durationSeconds !== undefined, "Endpoint video sources require a measured duration.");
+const ReferenceSchema = GatewayMediaSourceReferenceSchema.refine(source =>
+  (source.mediaType.startsWith("image/") && source.bytes <= 50 * 1024 * 1024)
+  || (source.mediaType.startsWith("video/") && source.bytes <= 256 * 1024 * 1024), "A directing reference must be an image of at most 50 MiB or a video of at most 256 MiB.");
+const DIRECTING_REFERENCE_LIMITS = Object.freeze({ count: 8, totalBytes: 512 * 1024 * 1024 });
 
 function capture(input: unknown, name: string, maximumBytes: number): unknown {
   return createBoundedJsonValueSnapshot(input, maximumBytes, name, { maximumDepth: 32, maximumValues: 1_000_000 }).value;
@@ -39,8 +43,13 @@ export const DirectingShotSchema = z.strictObject({
     z.strictObject({ kind: z.literal("shot-end"), shotId: SlugSchema }),
   ]).optional(),
   lastFrame: ImageSchema.optional(),
+  references: z.array(ReferenceSchema).min(1).max(DIRECTING_REFERENCE_LIMITS.count).optional(),
 }).superRefine((shot, context) => {
   if (shot.lastFrame !== undefined && shot.firstFrame === undefined) context.addIssue({ code: "custom", message: "A last frame requires an authored first-frame reference." });
+  const references = shot.references ?? [];
+  if (references.length > 0 && (shot.firstFrame !== undefined || shot.lastFrame !== undefined)) context.addIssue({ code: "custom", message: "Directing references are mutually exclusive with frame conditioning." });
+  if (references.reduce((total, reference) => total + reference.bytes, 0) > DIRECTING_REFERENCE_LIMITS.totalBytes) context.addIssue({ code: "custom", message: "Directing references exceed the 512 MiB aggregate bound." });
+  if (new Set(references.map(reference => `${reference.path}${reference.sha256}`)).size !== references.length) context.addIssue({ code: "custom", message: "Directing references must be distinct retained media." });
 });
 
 export const DirectingRecipeSchema = z.preprocess(input => capture(input, "directing recipe", 8 * 1024 * 1024), z.strictObject({
@@ -101,7 +110,7 @@ const ReviewSchema = z.strictObject({ decision: z.enum(["accepted", "rejected"])
 const FailureSchema = z.string().regex(/^[a-z][a-z0-9-]{0,63}$/u);
 const VideoRequestSchema = z.strictObject({ operation: z.literal("video"), request: GatewayVideoOperationInputSchema }).superRefine((input, context) => {
   const request = input.request;
-  if (request.providerOptions !== undefined || request.references !== undefined || request.generateAudio !== undefined || (request.n ?? 1) !== 1 || (request.maxVideosPerCall ?? 1) !== 1) context.addIssue({ code: "custom", message: "Directing uses exactly one video with authored frame conditioning and no provider options." });
+  if (request.providerOptions !== undefined || request.generateAudio !== undefined || (request.n ?? 1) !== 1 || (request.maxVideosPerCall ?? 1) !== 1) context.addIssue({ code: "custom", message: "Directing uses exactly one video with authored conditioning and no provider options." });
 });
 const AttemptBase = {
   id: AttemptIdSchema,
@@ -149,7 +158,7 @@ export function directingRequestId(input: {
   return `gateway_${canonicalJsonSha256({ domain: "slopcamera.directing-request/v1", id, attemptId, recipeSha256, shotSha256, request })}`;
 }
 
-/** Verify the submitted request against the authored recipe and retained frames. */
+/** Verify the submitted request against the authored recipe and retained conditioning. */
 export function directingRequestMatchesShot(attempt: DirectingAttempt, shot: DirectingShot, firstFrame: GatewayMediaSourceReference | undefined): boolean {
   const request = attempt.request.request;
   for (const key of ["prompt", "model", "durationSeconds", "resolution", "aspectRatio", "fps", "seed"] as const) if (request[key] !== shot[key]) return false;
@@ -157,7 +166,10 @@ export function directingRequestMatchesShot(attempt: DirectingAttempt, shot: Dir
   const actualFirst = request.promptImage ?? frames.find(frame => frame.frameType === "first_frame")?.source;
   const actualLast = frames.find(frame => frame.frameType === "last_frame")?.source;
   const equal = (left: GatewayMediaSourceReference | undefined, right: GatewayMediaSourceReference | undefined) => left === undefined || right === undefined ? left === right : sameDirectingSource(left, right);
-  return equal(firstFrame, actualFirst) && equal(shot.lastFrame, actualLast);
+  const actualReferences = request.references ?? [];
+  return equal(firstFrame, actualFirst) && equal(shot.lastFrame, actualLast)
+    && actualReferences.length === (shot.references ?? []).length
+    && (shot.references ?? []).every((reference, index) => sameDirectingSource(reference, actualReferences[index]!));
 }
 
 export const DirectingStateSchema = z.preprocess(input => capture(input, "directing state", DIRECTING_LIMITS.stateBytes), z.strictObject({

package/apps/desktop/application/directing-plan.ts

@@ -28,6 +28,7 @@ export interface ResolvedDirectingShot {
   readonly dependencies: DirectingDependency[];
   readonly firstFrame?: GatewayMediaSourceReference;
   readonly lastFrame?: GatewayMediaSourceReference;
+  readonly references?: readonly GatewayMediaSourceReference[];
 }
 
 function resolveShot(shot: DirectingShot, accepted: ReadonlyMap<string, CompletedDirectingAttempt>): ResolvedDirectingShot | undefined {
@@ -43,7 +44,7 @@ function resolveShot(shot: DirectingShot, accepted: ReadonlyMap<string, Complete
     boundDependencies.push({ ...dependency, shotSha256: predecessor.shotSha256 });
     firstFrame = predecessor.endpoint.image;
   }
-  return { shot, shotSha256: directingBoundShotSha256(shot, boundDependencies), dependencies, ...(firstFrame === undefined ? {} : { firstFrame }), ...(shot.lastFrame === undefined ? {} : { lastFrame: shot.lastFrame }) };
+  return { shot, shotSha256: directingBoundShotSha256(shot, boundDependencies), dependencies, ...(firstFrame === undefined ? {} : { firstFrame }), ...(shot.lastFrame === undefined ? {} : { lastFrame: shot.lastFrame }), ...(shot.references === undefined ? {} : { references: shot.references }) };
 }
 
 function acceptedSelections(state: DirectingState): Map<string, CompletedDirectingAttempt> {

package/apps/desktop/application/operation.ts

@@ -4,7 +4,7 @@ import type { z } from "zod";
 
 import type { ApplicationContext } from "./context";
 
-export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.3.3" as const;
+export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.3.5" as const;
 
 export const OPERATION_KINDS = [
   "scene.audit",

package/apps/desktop/cli/args.ts

@@ -217,6 +217,7 @@ export type CliCommand =
       readonly allowCloudUpload: boolean;
       readonly aspectRatio: string | undefined;
       readonly count: number;
+      readonly hosted: boolean;
       readonly images: readonly string[];
       readonly kind: "ai-image-generate";
       readonly mask: string | undefined;
@@ -334,6 +335,14 @@ export type CliCommand =
     } & JsonOption)
   | ({ readonly kind: "menubar"; readonly action: "run" | "install" | "uninstall" | "status"; readonly mode: "foreground" | "background" } & JsonOption)
   | ({ readonly kind: "outputs" } & JsonOption)
+  | ({ readonly kind: "credits-status" } & JsonOption)
+  | ({
+      readonly email: string | undefined;
+      readonly kind: "credits-topup";
+      readonly pack: string | undefined;
+    } & JsonOption)
+  | ({ readonly kind: "credits-wait"; readonly timeout: string } & JsonOption)
+  | ({ readonly kind: "credits-forget" } & JsonOption)
   | ({ readonly kind: "recordings-list"; readonly limit: number } & JsonOption)
   | ({ readonly kind: "projects-list"; readonly limit: number } & JsonOption)
   | ({
@@ -997,6 +1006,7 @@ function parseAiImage(argv: readonly string[]): CliCommand {
     "--allow-cloud-upload": "flag",
     "--aspect-ratio": "value",
     "--count": "value",
+    "--hosted": "flag",
     "--image": "repeat",
     "--mask": "value",
     "--max-per-call": "value",
@@ -1031,6 +1041,7 @@ function parseAiImage(argv: readonly string[]): CliCommand {
     allowCloudUpload: optionFlag(parsed, "--allow-cloud-upload"),
     aspectRatio: optionString(parsed, "--aspect-ratio"),
     count,
+    hosted: optionFlag(parsed, "--hosted"),
     images,
     json: optionFlag(parsed, "--json"),
     kind: "ai-image-generate",
@@ -1345,6 +1356,55 @@ function parseAiTranscribe(argv: readonly string[]): CliCommand {
   };
 }
 
+function parseCredits(argv: readonly string[]): CliCommand {
+  const action = argv[0];
+  if (action === "status") {
+    const parsed = parseOptions(argv.slice(1), JSON_SPEC);
+    exactPositionals(parsed, 0, "slopcamera credits status [--json]");
+    return { kind: "credits-status", json: optionFlag(parsed, "--json") };
+  }
+  if (action === "topup") {
+    const parsed = parseOptions(argv.slice(1), {
+      ...JSON_SPEC,
+      "--email": "value",
+      "--pack": "value",
+    });
+    exactPositionals(parsed, 0, "slopcamera credits topup [--pack <id>] [--email <address>] [--json]");
+    const email = optionString(parsed, "--email");
+    if (email !== undefined && (email.length > 320 || /[\s\u0000-\u001f\u007f]/u.test(email))) {
+      fail("--email must be a nonempty email address without whitespace or control characters.");
+    }
+    const pack = optionString(parsed, "--pack");
+    if (pack !== undefined && !/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(pack)) {
+      fail("--pack must be a pack id such as p10, p25, p50, or p100.");
+    }
+    return {
+      email,
+      json: optionFlag(parsed, "--json"),
+      kind: "credits-topup",
+      pack,
+    };
+  }
+  if (action === "wait") {
+    const parsed = parseOptions(argv.slice(1), {
+      ...JSON_SPEC,
+      "--timeout": "value",
+    });
+    exactPositionals(parsed, 0, "slopcamera credits wait [--timeout <time>] [--json]");
+    return {
+      kind: "credits-wait",
+      json: optionFlag(parsed, "--json"),
+      timeout: optionString(parsed, "--timeout") ?? "30m",
+    };
+  }
+  if (action === "forget") {
+    const parsed = parseOptions(argv.slice(1), JSON_SPEC);
+    exactPositionals(parsed, 0, "slopcamera credits forget [--json]");
+    return { kind: "credits-forget", json: optionFlag(parsed, "--json") };
+  }
+  fail("Usage: slopcamera credits <status|topup|wait|forget> [options]");
+}
+
 function parseAi(argv: readonly string[]): CliCommand {
   switch (argv[0]) {
     case "models": return parseAiModels(argv.slice(1));
@@ -3231,7 +3291,7 @@ function parseDirectingArgs(argv: readonly string[]): DirectingCommand {
   const required = (name: string): string => optionString(parsed, name) ?? fail(`direct ${action} requires ${name}.`);
   const common = { kind: "directing" as const, json: optionFlag(parsed, "--json") };
   if (action === "anchor") {
-    exactPositionals(parsed, 0, "slopcamera direct anchor --input <image>");
+    exactPositionals(parsed, 0, "slopcamera direct anchor --input <media>");
     return { ...common, action, input: required("--input") };
   }
   const [value] = exactPositionals(parsed, 1, `slopcamera direct ${action} <${["init", "plan", "start"].includes(action) ? "recipe.json" : "direct-id"}>`);
@@ -3589,6 +3649,7 @@ export function parseCliArgs(argv: readonly string[]): CliCommand {
     case "runs": return parseRuns(argv.slice(1));
     case "doctor": return parseDoctor(argv.slice(1));
     case "ai": return parseAi(argv.slice(1));
+    case "credits": return parseCredits(argv.slice(1));
     case "media": return parseMedia(argv.slice(1));
     case "recordings": return parseRecordings(argv.slice(1));
     case "projects": return parseProjects(argv.slice(1));

package/apps/desktop/cli/capability-manifest.ts

@@ -110,9 +110,12 @@ const capabilityModules = Object.freeze([
       { effect: "pure", name: "capabilities" },
       { effect: "local-read", name: "diagram check" },
       { effect: "local-derived-write", name: "diagram render" },
+      { effect: "local-derived-write", name: "diagram sheets init" },
+      { effect: "local-read", name: "diagram sheets check" },
+      { effect: "local-derived-write", name: "diagram sheets render" },
       { effect: "local-derived-write", name: "image vectorize" },
     ],
-    description: "Portable diagrams, local vectorization, and the bounded semantic operation projection.",
+    description: "Portable diagrams, CLI/SDK drawing sheets, local vectorization, and the bounded semantic operation projection.",
     moduleId: "slopcamera.capability.diagram-image",
     operationKeys: diagramImageOperations,
     profiles: [{

package/apps/desktop/cli/cinema-renderer.ts

@@ -142,11 +142,11 @@ function sliceChain(slice: CinemaMediaSlice, inputIndex: ReadonlyMap<string, num
   const inputDurationUs = slice.fileRange.endUs - slice.fileRange.startUs;
   const outputDurationUs = slice.outputRange.endUs - slice.outputRange.startUs;
   return [
-    `[${inputSpecifier(input, slice.streamIndex)}]`,
-    `trim=start=${seconds(slice.fileRange.startUs)}:end=${seconds(slice.fileRange.endUs)}`,
+    `[${inputSpecifier(input, slice.streamIndex)}]trim=start=${seconds(slice.fileRange.startUs)}:end=${seconds(slice.fileRange.endUs)}`,
     "settb=AVTB",
-    // Source clocks may be coarse; cinema offsets stay in integer microseconds.
-    `setpts=(PTS-STARTPTS)*${decimal(outputDurationUs / inputDurationUs)}+${seconds(slice.outputRange.startUs)}/TB`,
+    // Concat requires each member to start at zero. Position the complete
+    // window once after joining, so internal slice boundaries stay contiguous.
+    `setpts=(PTS-STARTPTS)*${decimal(outputDurationUs / inputDurationUs)}`,
     "format=rgba",
   ].join(",");
 }
@@ -173,7 +173,7 @@ function windowChain(
     : `scale=w=${outputWidth}:h=${outputHeight}:force_original_aspect_ratio=decrease,pad=${outputWidth}:${outputHeight}:(ow-iw)/2:(oh-ih)/2:color=black@0`;
   const joined = label(context, prefix);
   parts.push(
-    `${members.map(member => `[${member}]`).join("")}concat=n=${members.length}:v=1:a=0,${geometry},format=rgba${gradeFilter === undefined ? "" : `,${gradeFilter}`}[${joined}]`,
+    `${members.map(member => `[${member}]`).join("")}concat=n=${members.length}:v=1:a=0,setpts=PTS+${seconds(slices[0]!.outputRange.startUs)}/TB,${geometry},format=rgba${gradeFilter === undefined ? "" : `,${gradeFilter}`}[${joined}]`,
   );
   context.filters.push(...parts);
   return joined;
@@ -255,8 +255,11 @@ function transitionWindowChain(
       stream = windowChain(context, slices, shot.fit, grade, outputWidth, outputHeight, prefix);
     }
     const zeroed = label(context, `${prefix}_zero`);
+    // A dip/flash reveals only the tail of the incoming handle. Its hidden
+    // prefix still consumes source time, so the tail must meet the shot body
+    // without skipping the last part of the handle at the transition boundary.
     context.filters.push(
-      `[${stream}]setpts=PTS-STARTPTS,fps=${context.rate}${limitUs === undefined ? "" : `,trim=end=${seconds(limitUs)},setpts=PTS-STARTPTS`}[${zeroed}]`,
+      `[${stream}]setpts=PTS-STARTPTS${limitUs === undefined ? "" : `,trim=start=${seconds(durationUs - limitUs)}:end=${seconds(durationUs)},setpts=PTS-STARTPTS`},fps=${context.rate}[${zeroed}]`,
     );
     return zeroed;
   };

package/apps/desktop/cli/command-host-resources.ts

@@ -239,6 +239,13 @@ export function commandHostResourceClaims(
     case "ai-models-list":
     case "ai-models-show":
       return claims(coordinator, ["network"]);
+    case "credits-status":
+    case "credits-topup":
+    case "credits-wait":
+      // Bounded hosted-service calls; `wait` polls one claim until payment.
+      return claims(coordinator, ["network"]);
+    case "credits-forget":
+      return [];
     case "ai-provider-options-inspect":
     case "align-apply":
     case "code-init":