@hraness/slopcamera 3.3.4 → 3.3.5

package/README.md

@@ -44,14 +44,14 @@ the rendered output with source, runtime requirements and reproduction steps.
 
 ## Install Slopcamera
 
-Slopcamera v3.3.3 corrects wall openings, arched crowns, and Boolean surfaces, and documents [film integration](docs/how-to/parametric-design.md#integrate-a-design-into-an-existing-film).
+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.3 release](https://github.com/hraness/slopcamera/releases/tag/v3.3.3)
+[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.3/hraness-slopcamera-3.3.3.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
 ```
 
@@ -219,6 +219,13 @@ the Vercel CLI is optional. Generate images from text and references, add a voic
 transcribe sound, or create video shots using the selected model's supported
 inputs. Availability and pricing come from the live catalog.
 
+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
@@ -307,7 +314,10 @@ declarative graphs, approvals, and resuming work.
 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

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.4" 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));
@@ -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/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":