@hraness/slopcamera 3.3.5 → 3.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![Slopcamera: a visual studio for coding agents](https://slopcamera.com/og.png)](https://slopcamera.com)
 
-**Slopcamera is a local visual studio for coding agents. Author scenes, combine
+**Slopcamera (formerly Atet) is a local visual studio for coding agents. Author scenes, combine
 generated and recorded media, and export images, diagrams, animation, and video
 from retained sources.**
 
@@ -44,14 +44,14 @@ the rendered output with source, runtime requirements and reproduction steps.
 
 ## Install Slopcamera
 
-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.
+Slopcamera v3.3.6 fixes `credits wait` dropping the issued device token on pickup, on top of v3.3.5's paid hosted image generation through Hraness Credits top-up (`slopcamera credits`, `ai image --hosted`), public hosted model discovery, and checked patent-style vector drawing sheets.
 
 Install [Bun 1.3.14 or newer](https://bun.sh), then install the verified
-[Slopcamera v3.3.4 release](https://github.com/hraness/slopcamera/releases/tag/v3.3.4)
+[Slopcamera v3.3.6 release](https://github.com/hraness/slopcamera/releases/tag/v3.3.6)
 from its canonical archive:
 
 ```sh
-bun add --global https://github.com/hraness/slopcamera/releases/download/v3.3.4/hraness-slopcamera-3.3.4.tgz
+bun add --global https://github.com/hraness/slopcamera/releases/download/v3.3.6/hraness-slopcamera-3.3.6.tgz
 slopcamera skill install --target agents
 ```
 
@@ -134,6 +134,8 @@ architecture from dimensions, [build a parametric design](https://slopcamera.com
 
 ## What Slopcamera does
 
+Slopcamera is a local visual studio for coding agents.
+
 ### Author scenes and direct cameras
 
 Place geometry, images, video, diagrams, and text in a portable scene. Inspect

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.5" as const;
+export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.4.0" as const;
 
 export const OPERATION_KINDS = [
   "scene.audit",

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

@@ -104,6 +104,19 @@ const gatewayOperations = [
 ] as const;
 
 const capabilityModules = Object.freeze([
+  defineSlopcameraCapabilityModule({
+    commands: [{ effect: "pure", name: "style list" }, { effect: "pure", name: "style show" }],
+    description: "Renderer-independent visual direction, delivery recommendations, and deterministic exposure timing for film and animation.",
+    moduleId: "slopcamera.capability.visual-style",
+    operationKeys: [],
+    profiles: [{
+      id: "visual-style-direction-v1", kind: "authoring",
+      qualification: { evidence: ["src/visual-style.test.ts", "src/visual-style.property.test.ts"], level: "unit", status: "qualified" },
+      requirements: [],
+    }],
+    stability: "stable", title: "Visual style direction", toolNames: [],
+    trust: "portable", version: 1, workflowKeys: [],
+  }),
   defineSlopcameraCapabilityModule({
     commands: [
       { effect: "pure", name: "operations list" },

package/apps/desktop/cli/commands.ts

@@ -362,7 +362,7 @@ import {
   workflowRunStore,
 } from "./workflow-runs";
 
-export const SLOPCAMERA_VERSION = "3.3.5";
+export const SLOPCAMERA_VERSION = "3.4.0";
 
 // Legacy direct renders predate per-target output contracts. Keep them
 // bounded generously enough for long-form production while preventing one
@@ -5722,26 +5722,28 @@ async function handleCreditsWait(
     } catch (error) {
       throw creditsErrorToCli(error);
     }
+    // The issuing poll reports state "consumed" alongside the one-time token,
+    // so the token check must precede state matching.
+    if (status.deviceToken !== undefined) {
+      // The token is returned exactly once; persist before reporting.
+      await store.writeDeviceToken(status.deviceToken);
+      await store.clearPendingClaim();
+      const view = {
+        claimId: pending.claimId,
+        configured: true,
+        state: "paid" as const,
+        next: ["slopcamera credits status", "slopcamera ai image generate --hosted --model <id> --prompt <text>"],
+      };
+      writeValue(context.io, command.json, view, () => [
+        "paid\tcredits wallet is configured on this device",
+        "",
+        "Next:",
+        "  slopcamera credits status",
+        "  slopcamera ai image generate --hosted --model <id> --prompt <text>",
+      ].join("\n"));
+      return;
+    }
     if (status.state === "paid") {
-      if (status.deviceToken !== undefined) {
-        // The token is returned exactly once; persist before reporting.
-        await store.writeDeviceToken(status.deviceToken);
-        await store.clearPendingClaim();
-        const view = {
-          claimId: pending.claimId,
-          configured: true,
-          state: "paid" as const,
-          next: ["slopcamera credits status", "slopcamera ai image generate --hosted --model <id> --prompt <text>"],
-        };
-        writeValue(context.io, command.json, view, () => [
-          "paid\tcredits wallet is configured on this device",
-          "",
-          "Next:",
-          "  slopcamera credits status",
-          "  slopcamera ai image generate --hosted --model <id> --prompt <text>",
-        ].join("\n"));
-        return;
-      }
       await store.clearPendingClaim();
       const view = {
         claimId: pending.claimId,

package/apps/desktop/cli/help.ts

@@ -24,6 +24,7 @@ Commands:
   image vectorize|generate|gallery|icon
                                  Create local SVGs, generated images, or review galleries
   html catalog|scaffold|render   Author HTML scenes and export video with local audio
+  style list|show                Discover reusable art direction and review criteria
   workflows list|show|plan|run   Plan or run a reviewed reusable workflow
   code init|check|plan|run       Author, preflight, and run trusted TypeScript workflows
   runs list|show|resume|approve|cancel
@@ -293,6 +294,15 @@ composes a labelled contact sheet plus receipt for agent review. Texture cells r
 candidate 2×2 so seams are inspectable (--tile/--no-tile overrides). It never replaces existing
 outputs and never promotes a candidate into authored source; review the sheet and select
 explicitly.`,
+  style: `Usage:
+  slopcamera style list [--json]
+  slopcamera style show <id> [--json]
+
+Styles describe palette, shape, materials, camera, exposure cadence, finishing targets,
+recommended delivery, and visual review criteria. They work across authored scenes and
+generation prompts, independently of the seven HTML library profiles. Discovery is local
+and read-only: it does not render, select a model, or apply an effect. A profile is art
+direction, not proof of visual quality or historically authentic footage.`,
   html: `Usage:
   slopcamera html catalog [--json]
   slopcamera html scaffold <${HTML_OVERLAY_SCAFFOLD_KIND_HELP}> --output <file.html>
@@ -673,12 +683,13 @@ export function commandHelp(topic: readonly string[]): string {
 
 export function completions(words: readonly string[]): readonly string[] {
   const topLevel = [
-    "capabilities", "operations", "diagram", "direct", "studio", "image", "html", "workflows", "code", "runs", "doctor", "ai", "credits", "media", "menubar", "support", "outputs", "recordings", "projects", "project", "scene", "inspect", "events", "edit", "analyze", "align", "faces", "fillers", "render", "assets",
+    "capabilities", "operations", "diagram", "direct", "studio", "image", "html", "style", "workflows", "code", "runs", "doctor", "ai", "credits", "media", "menubar", "support", "outputs", "recordings", "projects", "project", "scene", "inspect", "events", "edit", "analyze", "align", "faces", "fillers", "render", "assets",
   ];
   if (words.length <= 1) return topLevel;
   const command = words[0];
   if (command === "support") return ["protocol", "offer", "shown", "release", "dismiss", "snooze", "enable", "status"];
   if (command === "html") return ["catalog", "scaffold", "render"];
+  if (command === "style") return ["list", "show"];
   if (command === "direct") return ["init", "anchor", "plan", "start", "inspect", "revise", "generate", "resume", "review", "assemble", "cleanup"];
   if (command === "studio") return words[2] === "assets" || words[1] === "assets" ? ["search", "describe", "plan", "import"] : ["init", "bundle", "plan", "probe", "run", "encode", "asset", "assemble", "inspect", "reconcile", "assets"];
   if (command === "operations") return ["list", "show"];

package/apps/desktop/cli/html-overlay-renderer.ts

@@ -135,6 +135,7 @@ type BrowserRuntimeSnapshotLease = Readonly<
 interface HtmlOverlayHostController {
   renderFrame(frame: HtmlOverlayRuntimeFrame): Promise<void>;
   securityViolationCount(): number;
+  settlePresentation(): Promise<void>;
 }
 
 interface PreparedRoute {
@@ -2332,6 +2333,21 @@ export class PlaywrightHtmlOverlayRenderer implements HtmlOverlayRenderer {
                 );
               }
               await inspectGpu();
+              // Wait for the compositor to present the frame the callbacks
+              // just produced. renderFrame resolves when authored work returns,
+              // not when the new surface reaches the screen; under heavy GPU
+              // load a screenshot taken immediately can capture the previous
+              // presented frame. Two animation frames bound the wait: the draw
+              // is committed before the first callback fires and presented
+              // before the second.
+              await boundedBrowserStep(
+                async () => await host.evaluate(
+                  async (controller) => await controller.settlePresentation(),
+                ),
+                signal,
+                this.#browserStepTimeoutMs,
+                `frame ${String(frameIndex)} presentation settle`,
+              );
               await boundedBrowserStep(
                 async () => await page.screenshot({
                   omitBackground: HTML_OVERLAY_RENDERER_CONTRACT.screenshot.omitBackground,

package/apps/desktop/cli/portable-surface.ts

@@ -220,12 +220,14 @@ export async function runPortableSurface(
   dependencies: PortableSurfaceDependencies = {},
 ): Promise<number | undefined> {
   const argv = canonicalizeUnifiedCliArgs(argvInput);
+  if (argv[0] === "style" && (argv.includes("--help") || argv.includes("-h"))) return undefined;
   if (argv[0] === "html") {
     if (argv[1] === "render" || argv.includes("--help") || argv.includes("-h")) return undefined;
     if (argv[1] === "catalog") return runHtmlCatalog(argv, dependencies);
     return await runHtmlScaffold(argv, dependencies);
   }
   const delegatesToHeadless = argv[0] === "diagram"
+    || argv[0] === "style"
     || argv[0] === "mcp"
     || argv[0] === "canvas"
     || argv[0] === "skill"

package/apps/desktop/code/public.ts

@@ -10,6 +10,7 @@ export {
 } from "./define-workflow";
 export * from "../../../src/spatial-scene/index";
 export * from "../../../src/studio/index";
+export { createVisualStyleVideoLook, VisualStyleVideoLookOptionsSchema } from "../core/visual-style-look";
 export { StudioRunInputSchema, BoundStudioRunInputSchema, StudioRunOutputSchema, type StudioRunInput, type BoundStudioRunInput, type StudioRunOutput } from "../application/studio-port";
 export type { SpatialRenderInput, BoundSpatialRenderInput } from "../application/operations/spatial-render";
 export type { SpatialRenderRequest, SpatialRenderResult } from "../application/spatial-render";

package/apps/desktop/core/visual-style-look.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { getVisualStyleProfile } from "../../../src/visual-style";
+import type { VideoEffectInput, VideoLookV1 } from "../contracts/video-effects";
+import { createVideoLook } from "./video-effects";
+
+export const VisualStyleVideoLookOptionsSchema = z.strictObject({
+  height: z.number().int().min(64).max(4320).default(1080),
+  seed: z.number().int().safe().min(0).max(2_147_483_647).default(20260923),
+});
+
+/**
+ * Translate only supported finishing controls into the existing ordered look
+ * graph. Scene construction, motion, gate weave, grain size, and true halation
+ * remain authoring decisions; screen diffusion is not a film-stock simulation.
+ */
+export function createVisualStyleVideoLook(style: unknown, options: unknown = {}): VideoLookV1 {
+  const profile = getVisualStyleProfile(style);
+  const settings = VisualStyleVideoLookOptionsSchema.parse(options);
+  const finish = profile.finishing;
+  const effects: VideoEffectInput[] = [{
+    kind: "color-grade", amount: 1,
+    grade: { kind: "custom", controls: { saturation: finish.saturation, contrast: finish.contrast } },
+  }];
+  if (finish.halation > 0) effects.push({
+    kind: "diffusion", amount: finish.halation,
+    radiusPx: Math.max(0.25, 1.8 * settings.height / 1080), blendMode: "screen",
+  });
+  if (finish.grain > 0) effects.push({
+    kind: "film-grain", amount: finish.grain, seed: settings.seed,
+    cadence: "frame-varying", chroma: finish.saturation === 0 ? 0 : 0.12,
+  });
+  if (finish.vignette > 0) effects.push({ kind: "vignette", amount: finish.vignette });
+  return createVideoLook(effects);
+}