@hraness/slopcamera 3.2.8 → 3.3.1

package/dist/index.js

@@ -1,227 +1,2 @@
 // @bun
-import {
-  SLOPCAMERA_VERSION,
-  STUDIO_LIMITS,
-  SlopcameraMcpToolRuntime,
-  StudioCapabilityNameSchema,
-  StudioDigestSchema,
-  StudioEngineOptionsSchema,
-  StudioEngineSchema,
-  StudioExecutionProfileSchema,
-  StudioJobSchema,
-  StudioOutputArtifactSchema,
-  StudioOutputFormatSchema,
-  StudioOutputInterpretationSchema,
-  StudioOutputRoleSchema,
-  StudioOutputSpecSchema,
-  StudioPathSchema,
-  StudioPlanSchema,
-  StudioReceiptSchema,
-  StudioRenderSchema,
-  StudioRuntimeIdentitySchema,
-  StudioSourceBundleSchema,
-  StudioSourceSpaceSchema,
-  WorkspaceBoundary,
-  WorkspaceBoundaryError,
-  artifactSummary,
-  checkDiagramFile,
-  diagramApi,
-  inspectStudioBundle,
-  inspectStudioPlan,
-  mcpMaximumRenderedPixels,
-  mcpMaximumScale,
-  mcpSourceByteLimit,
-  parseStudioJob,
-  parseStudioPlan,
-  parseStudioReceipt,
-  parseStudioRuntimeIdentity,
-  parseStudioSourceBundle,
-  planStudioJob,
-  readDiagramFile,
-  renderDiagramFile,
-  runMcpServer,
-  slopcameraApi,
-  slopcameraMcpProtocolVersion,
-  slopcameraMcpServerName,
-  slopcameraMcpTools,
-  studioJobSha256,
-  studioOutputPath,
-  studioRuntimeSha256,
-  studioSourceBundleSha256,
-  validateStudioReceipt
-} from "./index-7131pg1c.js";
-import {
-  bundledSkillPath,
-  installSkill
-} from "./index-7308egqr.js";
-import"./index-8txs6fkn.js";
-import {
-  SlopcameraWorkflowError,
-  defineSlopcameraWorkflow,
-  runSlopcameraWorkflow
-} from "./index-fava6pge.js";
-import {
-  DiagramValidationError,
-  SlopcameraOperationError,
-  StackLayoutError,
-  builtInIcons,
-  executeSlopcameraOperation,
-  executeSlopcameraOperationWithLease,
-  isSlopcameraOperationCode,
-  lintDiagram,
-  parseDiagramSource,
-  parseDiagramSpec,
-  parseSlopcameraOperationInput,
-  renderPng,
-  renderSvg,
-  resolveDiagramSource,
-  resolveEdge,
-  resolveStackLayout,
-  searchSlopcameraOperations,
-  serializeTldr,
-  slopcameraOperationCodes,
-  slopcameraOperationHostResourceClaims,
-  slopcameraOperationRegistry,
-  stackLayoutDefaults,
-  withSlopcameraOperationHostAdmission
-} from "./index-h1k0fnjq.js";
-import {
-  VTRACER_VERSION,
-  VectorizeError,
-  vectorizeDefaultLimits,
-  vectorizeHardLimits,
-  vectorizeImage,
-  vectorizeProfileNames,
-  vtracerReleases
-} from "./index-zfnddgay.js";
-import {
-  SlopcameraCloudError,
-  createFixedGatewayFetch,
-  generateSlopcameraImage,
-  generateSlopcameraImageFile,
-  slopcameraGatewayApiBaseUrl,
-  slopcameraGatewayCredentialStatus,
-  slopcameraImageModels,
-  slopcameraMaximumPromptBytes,
-  slopcameraMaximumRawImageBytes,
-  slopcameraResponseMediaTypes
-} from "./index-r7gdhmsp.js";
-import {
-  HOST_RESOURCE_MAX_WAIT_MILLISECONDS,
-  HostResourceError,
-  createDefaultHostResourceCoordinator,
-  createHostResourceCoordinator,
-  createProcessLocalHostResourceCoordinator,
-  defaultSlopcameraHostResourceProfile,
-  defaultSlopcameraHostResourceStateRoot,
-  normalizeHostResourceClaims,
-  normalizeHostResourceProfile,
-  slopcameraHostResourceNames
-} from "./index-sh6xbav6.js";
-import"./index-z1w83f81.js";
-export {
-  withSlopcameraOperationHostAdmission,
-  vtracerReleases,
-  vectorizeProfileNames,
-  vectorizeImage,
-  vectorizeHardLimits,
-  vectorizeDefaultLimits,
-  validateStudioReceipt,
-  studioSourceBundleSha256,
-  studioRuntimeSha256,
-  studioOutputPath,
-  studioJobSha256,
-  stackLayoutDefaults,
-  slopcameraResponseMediaTypes,
-  slopcameraOperationRegistry,
-  slopcameraOperationHostResourceClaims,
-  slopcameraOperationCodes,
-  slopcameraMcpTools,
-  slopcameraMcpServerName,
-  slopcameraMcpProtocolVersion,
-  slopcameraMaximumRawImageBytes,
-  slopcameraMaximumPromptBytes,
-  slopcameraImageModels,
-  slopcameraHostResourceNames,
-  slopcameraGatewayCredentialStatus,
-  slopcameraGatewayApiBaseUrl,
-  slopcameraApi,
-  serializeTldr,
-  searchSlopcameraOperations,
-  runSlopcameraWorkflow,
-  runMcpServer,
-  resolveStackLayout,
-  resolveEdge,
-  resolveDiagramSource,
-  renderSvg,
-  renderPng,
-  renderDiagramFile,
-  readDiagramFile,
-  planStudioJob,
-  parseStudioSourceBundle,
-  parseStudioRuntimeIdentity,
-  parseStudioReceipt,
-  parseStudioPlan,
-  parseStudioJob,
-  parseSlopcameraOperationInput,
-  parseDiagramSpec,
-  parseDiagramSource,
-  normalizeHostResourceProfile,
-  normalizeHostResourceClaims,
-  mcpSourceByteLimit,
-  mcpMaximumScale,
-  mcpMaximumRenderedPixels,
-  lintDiagram,
-  isSlopcameraOperationCode,
-  installSkill,
-  inspectStudioPlan,
-  inspectStudioBundle,
-  generateSlopcameraImageFile,
-  generateSlopcameraImage,
-  executeSlopcameraOperationWithLease,
-  executeSlopcameraOperation,
-  diagramApi,
-  defineSlopcameraWorkflow,
-  defaultSlopcameraHostResourceStateRoot,
-  defaultSlopcameraHostResourceProfile,
-  createProcessLocalHostResourceCoordinator,
-  createHostResourceCoordinator,
-  createFixedGatewayFetch,
-  createDefaultHostResourceCoordinator,
-  checkDiagramFile,
-  bundledSkillPath,
-  builtInIcons,
-  artifactSummary,
-  WorkspaceBoundaryError,
-  WorkspaceBoundary,
-  VectorizeError,
-  VTRACER_VERSION,
-  StudioSourceSpaceSchema,
-  StudioSourceBundleSchema,
-  StudioRuntimeIdentitySchema,
-  StudioRenderSchema,
-  StudioReceiptSchema,
-  StudioPlanSchema,
-  StudioPathSchema,
-  StudioOutputSpecSchema,
-  StudioOutputRoleSchema,
-  StudioOutputInterpretationSchema,
-  StudioOutputFormatSchema,
-  StudioOutputArtifactSchema,
-  StudioJobSchema,
-  StudioExecutionProfileSchema,
-  StudioEngineSchema,
-  StudioEngineOptionsSchema,
-  StudioDigestSchema,
-  StudioCapabilityNameSchema,
-  StackLayoutError,
-  SlopcameraWorkflowError,
-  SlopcameraOperationError,
-  SlopcameraMcpToolRuntime,
-  SlopcameraCloudError,
-  STUDIO_LIMITS,
-  SLOPCAMERA_VERSION,
-  HostResourceError,
-  HOST_RESOURCE_MAX_WAIT_MILLISECONDS,
-  DiagramValidationError
-};
+import{SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS,SLOPCAMERA_PORTABLE_CAPABILITY_VERSION,SLOPCAMERA_VERSION,STUDIO_LIMITS,SlopcameraCapabilityCommandSchema,SlopcameraCapabilityEffectSchema,SlopcameraCapabilityManifestSchema,SlopcameraCapabilityModuleDeclarationSchema,SlopcameraCapabilityModuleSchema,SlopcameraCapabilityOperationSchema,SlopcameraCapabilityPreparationSchema,SlopcameraCapabilityProfileSchema,SlopcameraCapabilityQualificationSchema,SlopcameraCapabilityResourceSchema,SlopcameraCapabilityResumeSchema,SlopcameraCapabilityToolSchema,SlopcameraCapabilityWorkflowSchema,SlopcameraMcpToolRuntime,SlopcameraSceneVariantsSchema,StudioCapabilityNameSchema,StudioDigestSchema,StudioEngineOptionsSchema,StudioEngineSchema,StudioExecutionProfileSchema,StudioJobSchema,StudioOutputArtifactSchema,StudioOutputFormatSchema,StudioOutputInterpretationSchema,StudioOutputRoleSchema,StudioOutputSpecSchema,StudioPathSchema,StudioPlanSchema,StudioReceiptSchema,StudioRenderSchema,StudioRuntimeIdentitySchema,StudioSourceBundleSchema,StudioSourceSpaceSchema,WorkspaceBoundary,WorkspaceBoundaryError,artifactSummary,checkDiagramFile,compileSlopcameraCapabilityManifest,createPortableSlopcameraCapabilityManifest,defineSlopcameraCapabilityModule,diagramApi,inspectStudioBundle,inspectStudioPlan,mcpMaximumRenderedPixels,mcpMaximumScale,mcpSourceByteLimit,parseSlopcameraCapabilityManifest,parseSlopcameraSceneVariants,parseStudioJob,parseStudioPlan,parseStudioReceipt,parseStudioRuntimeIdentity,parseStudioSourceBundle,planSlopcameraSceneGallery,planStudioJob,readDiagramFile,renderDiagramFile,runMcpServer,slopcameraApi,slopcameraMcpProtocolVersion,slopcameraMcpServerName,slopcameraMcpTools,slopcameraPortableCapabilityManifest,slopcameraSceneGalleryLimits,studioJobSha256,studioOutputPath,studioRuntimeSha256,studioSourceBundleSha256,summarizeSceneVariantPatch,validateStudioReceipt}from"./index-f0ptv8dm.js";import{bundledSkillPath,installSkill}from"./index-grk47tgs.js";import"./index-cgpkyjqa.js";import"./index-3cxf2c58.js";import{SlopcameraWorkflowError,defineSlopcameraWorkflow,runSlopcameraWorkflow}from"./index-296qhpf2.js";import{DiagramValidationError,SlopcameraOperationError,StackLayoutError,builtInIcons,composeSlopcameraImageGallery,critiqueIconRaster,executeSlopcameraOperation,executeSlopcameraOperationWithLease,extractIconLineArt,galleryCandidateId,galleryPromptFor,generateSlopcameraIcon,generateSlopcameraImageGallery,iconPromptFor,iconVisualGateProblems,isSlopcameraOperationCode,lintDiagram,parseDiagramSource,parseDiagramSpec,parseSlopcameraGalleryVary,parseSlopcameraOperationInput,planSlopcameraGallery,renderPng,renderSvg,resolveDiagramSource,resolveEdge,resolveStackLayout,searchSlopcameraOperations,serializeTldr,slopcameraGalleryAxes,slopcameraGalleryKinds,slopcameraGalleryLimits,slopcameraIconCritiqueDefaultModel,slopcameraIconCritiqueTimeoutMs,slopcameraIconDefaultInk,slopcameraIconDefaultRounds,slopcameraIconMaximumRounds,slopcameraIconPanel,slopcameraIconSubjectMaximumBytes,slopcameraOperationCodes,slopcameraOperationHostResourceClaims,slopcameraOperationRegistry,stackLayoutDefaults,withSlopcameraOperationHostAdmission}from"./index-0bbesn4m.js";import{VTRACER_VERSION,VectorizeError,vectorizeDefaultLimits,vectorizeHardLimits,vectorizeImage,vectorizeProfileNames,vtracerReleases}from"./index-qry58nj2.js";import{SlopcameraCloudError,createFixedGatewayFetch,generateSlopcameraImage,generateSlopcameraImageFile,resolveSlopcameraGatewayCredential,slopcameraGatewayApiBaseUrl,slopcameraGatewayCredentialStatus,slopcameraImageModels,slopcameraMaximumPromptBytes,slopcameraMaximumRawImageBytes,slopcameraResponseMediaTypes}from"./index-77fjfg9f.js";import{HOST_RESOURCE_MAX_WAIT_MILLISECONDS,HostResourceError,createDefaultHostResourceCoordinator,createHostResourceCoordinator,createProcessLocalHostResourceCoordinator,defaultSlopcameraHostResourceProfile,defaultSlopcameraHostResourceStateRoot,normalizeHostResourceClaims,normalizeHostResourceProfile,slopcameraHostResourceNames}from"./index-b3geqczn.js";import"./index-80a36bc0.js";export{withSlopcameraOperationHostAdmission,vtracerReleases,vectorizeProfileNames,vectorizeImage,vectorizeHardLimits,vectorizeDefaultLimits,validateStudioReceipt,summarizeSceneVariantPatch,studioSourceBundleSha256,studioRuntimeSha256,studioOutputPath,studioJobSha256,stackLayoutDefaults,slopcameraSceneGalleryLimits,slopcameraResponseMediaTypes,slopcameraPortableCapabilityManifest,slopcameraOperationRegistry,slopcameraOperationHostResourceClaims,slopcameraOperationCodes,slopcameraMcpTools,slopcameraMcpServerName,slopcameraMcpProtocolVersion,slopcameraMaximumRawImageBytes,slopcameraMaximumPromptBytes,slopcameraImageModels,slopcameraIconSubjectMaximumBytes,slopcameraIconPanel,slopcameraIconMaximumRounds,slopcameraIconDefaultRounds,slopcameraIconDefaultInk,slopcameraIconCritiqueTimeoutMs,slopcameraIconCritiqueDefaultModel,slopcameraHostResourceNames,slopcameraGatewayCredentialStatus,slopcameraGatewayApiBaseUrl,slopcameraGalleryLimits,slopcameraGalleryKinds,slopcameraGalleryAxes,slopcameraApi,serializeTldr,searchSlopcameraOperations,runSlopcameraWorkflow,runMcpServer,resolveStackLayout,resolveSlopcameraGatewayCredential,resolveEdge,resolveDiagramSource,renderSvg,renderPng,renderDiagramFile,readDiagramFile,planStudioJob,planSlopcameraSceneGallery,planSlopcameraGallery,parseStudioSourceBundle,parseStudioRuntimeIdentity,parseStudioReceipt,parseStudioPlan,parseStudioJob,parseSlopcameraSceneVariants,parseSlopcameraOperationInput,parseSlopcameraGalleryVary,parseSlopcameraCapabilityManifest,parseDiagramSpec,parseDiagramSource,normalizeHostResourceProfile,normalizeHostResourceClaims,mcpSourceByteLimit,mcpMaximumScale,mcpMaximumRenderedPixels,lintDiagram,isSlopcameraOperationCode,installSkill,inspectStudioPlan,inspectStudioBundle,iconVisualGateProblems,iconPromptFor,generateSlopcameraImageGallery,generateSlopcameraImageFile,generateSlopcameraImage,generateSlopcameraIcon,galleryPromptFor,galleryCandidateId,extractIconLineArt,executeSlopcameraOperationWithLease,executeSlopcameraOperation,diagramApi,defineSlopcameraWorkflow,defineSlopcameraCapabilityModule,defaultSlopcameraHostResourceStateRoot,defaultSlopcameraHostResourceProfile,critiqueIconRaster,createProcessLocalHostResourceCoordinator,createPortableSlopcameraCapabilityManifest,createHostResourceCoordinator,createFixedGatewayFetch,createDefaultHostResourceCoordinator,composeSlopcameraImageGallery,compileSlopcameraCapabilityManifest,checkDiagramFile,bundledSkillPath,builtInIcons,artifactSummary,WorkspaceBoundaryError,WorkspaceBoundary,VectorizeError,VTRACER_VERSION,StudioSourceSpaceSchema,StudioSourceBundleSchema,StudioRuntimeIdentitySchema,StudioRenderSchema,StudioReceiptSchema,StudioPlanSchema,StudioPathSchema,StudioOutputSpecSchema,StudioOutputRoleSchema,StudioOutputInterpretationSchema,StudioOutputFormatSchema,StudioOutputArtifactSchema,StudioJobSchema,StudioExecutionProfileSchema,StudioEngineSchema,StudioEngineOptionsSchema,StudioDigestSchema,StudioCapabilityNameSchema,StackLayoutError,SlopcameraWorkflowError,SlopcameraSceneVariantsSchema,SlopcameraOperationError,SlopcameraMcpToolRuntime,SlopcameraCloudError,SlopcameraCapabilityWorkflowSchema,SlopcameraCapabilityToolSchema,SlopcameraCapabilityResumeSchema,SlopcameraCapabilityResourceSchema,SlopcameraCapabilityQualificationSchema,SlopcameraCapabilityProfileSchema,SlopcameraCapabilityPreparationSchema,SlopcameraCapabilityOperationSchema,SlopcameraCapabilityModuleSchema,SlopcameraCapabilityModuleDeclarationSchema,SlopcameraCapabilityManifestSchema,SlopcameraCapabilityEffectSchema,SlopcameraCapabilityCommandSchema,STUDIO_LIMITS,SLOPCAMERA_VERSION,SLOPCAMERA_PORTABLE_CAPABILITY_VERSION,SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS,HostResourceError,HOST_RESOURCE_MAX_WAIT_MILLISECONDS,DiagramValidationError};

package/dist/operations.js

@@ -1,29 +1,2 @@
 // @bun
-import {
-  SlopcameraOperationError,
-  executeSlopcameraOperation,
-  executeSlopcameraOperationWithLease,
-  isSlopcameraOperationCode,
-  parseSlopcameraOperationInput,
-  searchSlopcameraOperations,
-  slopcameraOperationCodes,
-  slopcameraOperationHostResourceClaims,
-  slopcameraOperationRegistry,
-  withSlopcameraOperationHostAdmission
-} from "./index-h1k0fnjq.js";
-import"./index-zfnddgay.js";
-import"./index-r7gdhmsp.js";
-import"./index-sh6xbav6.js";
-import"./index-z1w83f81.js";
-export {
-  withSlopcameraOperationHostAdmission,
-  slopcameraOperationRegistry,
-  slopcameraOperationHostResourceClaims,
-  slopcameraOperationCodes,
-  searchSlopcameraOperations,
-  parseSlopcameraOperationInput,
-  isSlopcameraOperationCode,
-  executeSlopcameraOperationWithLease,
-  executeSlopcameraOperation,
-  SlopcameraOperationError
-};
+import{SlopcameraOperationError,executeSlopcameraOperation,executeSlopcameraOperationWithLease,isSlopcameraOperationCode,parseSlopcameraOperationInput,searchSlopcameraOperations,slopcameraOperationCodes,slopcameraOperationHostResourceClaims,slopcameraOperationRegistry,withSlopcameraOperationHostAdmission}from"./index-0bbesn4m.js";import"./index-qry58nj2.js";import"./index-77fjfg9f.js";import"./index-b3geqczn.js";import"./index-80a36bc0.js";export{withSlopcameraOperationHostAdmission,slopcameraOperationRegistry,slopcameraOperationHostResourceClaims,slopcameraOperationCodes,searchSlopcameraOperations,parseSlopcameraOperationInput,isSlopcameraOperationCode,executeSlopcameraOperationWithLease,executeSlopcameraOperation,SlopcameraOperationError};

package/dist/skill-install-gx7afxsd.js

@@ -0,0 +1,2 @@
+// @bun
+import{bundledSkillPath,installSkill}from"./index-grk47tgs.js";import"./index-80a36bc0.js";export{installSkill,bundledSkillPath};

package/dist/vectorize/worker.js

@@ -1,142 +1,2 @@
 // @bun
-import {
-  MAX_VECTORIZE_REQUEST_BYTES,
-  MAX_VECTORIZE_RESPONSE_BYTES,
-  VECTORIZE_WORKER_PROTOCOL,
-  VectorizeError,
-  configureVectorizeSharpConcurrency,
-  forwardVectorizeWorkerTermination,
-  vectorizeImageInProcess,
-  withInheritedCommandFileDescriptors
-} from "../index-zfnddgay.js";
-import"../index-z1w83f81.js";
-
-// src/vectorize/worker.ts
-import { lstat, realpath } from "fs/promises";
-import { tmpdir } from "os";
-import { basename, dirname } from "path";
-var errorCodes = new Set([
-  "input_limit",
-  "invalid_input",
-  "output_limit",
-  "quality_limit",
-  "timeout",
-  "tool_download",
-  "tool_integrity",
-  "tool_platform",
-  "tool_version",
-  "trace_failed",
-  "unsafe_svg"
-]);
-forwardVectorizeWorkerTermination();
-await main();
-async function main() {
-  let response;
-  try {
-    configureVectorizeSharpConcurrency();
-    const requestText = await readBoundedInput();
-    const request = parseRequest(requestText);
-    const input = decodeInput(request.input);
-    const temporaryRoot = await validateTemporaryRoot(request.temporaryRoot);
-    const result = await withInheritedCommandFileDescriptors(request.options.inheritedFileDescriptors, async () => await vectorizeImageInProcess(input, request.options, temporaryRoot));
-    response = {
-      ok: true,
-      protocol: VECTORIZE_WORKER_PROTOCOL,
-      result
-    };
-  } catch (error) {
-    response = {
-      error: serializeError(error),
-      ok: false,
-      protocol: VECTORIZE_WORKER_PROTOCOL
-    };
-  }
-  let encoded = JSON.stringify(response);
-  if (Buffer.byteLength(encoded) > MAX_VECTORIZE_RESPONSE_BYTES) {
-    encoded = JSON.stringify({
-      error: {
-        code: "output_limit",
-        details: { maximumBytes: MAX_VECTORIZE_RESPONSE_BYTES },
-        message: "The vectorization worker response exceeds its IPC limit."
-      },
-      ok: false,
-      protocol: VECTORIZE_WORKER_PROTOCOL
-    });
-  }
-  await Bun.write(Bun.stdout, encoded);
-}
-async function readBoundedInput() {
-  const reader = Bun.stdin.stream().getReader();
-  const chunks = [];
-  let bytes = 0;
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done)
-        break;
-      bytes += value.byteLength;
-      if (bytes > MAX_VECTORIZE_REQUEST_BYTES) {
-        await reader.cancel();
-        throw new VectorizeError("input_limit", "The vectorization worker request exceeds its IPC limit.", { bytes, maximumBytes: MAX_VECTORIZE_REQUEST_BYTES });
-      }
-      chunks.push(value);
-    }
-  } finally {
-    reader.releaseLock();
-  }
-  return Buffer.concat(chunks, bytes).toString("utf8");
-}
-function parseRequest(text) {
-  let parsed;
-  try {
-    parsed = JSON.parse(text);
-  } catch (error) {
-    throw new VectorizeError("invalid_input", "The vectorization worker request is malformed.", {}, { cause: error });
-  }
-  if (!isRecord(parsed) || parsed.protocol !== VECTORIZE_WORKER_PROTOCOL || !isRecord(parsed.input) || !isRecord(parsed.options) || typeof parsed.temporaryRoot !== "string" || parsed.temporaryRoot.length === 0 || typeof parsed.input.kind !== "string" || typeof parsed.input.value !== "string" || !["bytes", "path"].includes(parsed.input.kind)) {
-    throw new VectorizeError("invalid_input", "The vectorization worker request is invalid.");
-  }
-  return parsed;
-}
-function decodeInput(input) {
-  if (input.kind === "path")
-    return input.value;
-  if (input.value.length > Math.ceil(MAX_VECTORIZE_REQUEST_BYTES / 3) * 4 || input.value.length % 4 !== 0) {
-    throw new VectorizeError("input_limit", "Encoded raster input exceeds its IPC limit.");
-  }
-  const bytes = Buffer.from(input.value, "base64");
-  if (bytes.toString("base64") !== input.value) {
-    throw new VectorizeError("invalid_input", "Encoded raster input is not canonical base64.");
-  }
-  return bytes;
-}
-async function validateTemporaryRoot(path) {
-  let realRoot;
-  let realTemporaryDirectory;
-  try {
-    const resolved = await Promise.all([
-      realpath(path),
-      realpath(tmpdir())
-    ]);
-    realRoot = resolved[0];
-    realTemporaryDirectory = resolved[1];
-    const metadata = await lstat(path);
-    if (!metadata.isDirectory() || metadata.isSymbolicLink() || dirname(realRoot) !== realTemporaryDirectory || !/^slopcamera-vectorize-[A-Za-z0-9_-]{6,}$/u.test(basename(realRoot))) {
-      throw new VectorizeError("invalid_input", "The supervisor temporary directory is invalid.");
-    }
-  } catch (error) {
-    if (error instanceof VectorizeError)
-      throw error;
-    throw new VectorizeError("invalid_input", "The supervisor temporary directory could not be verified.", {}, { cause: error });
-  }
-  return realRoot;
-}
-function serializeError(error) {
-  const code = error instanceof VectorizeError && errorCodes.has(error.code) ? error.code : "trace_failed";
-  const message = error instanceof Error ? error.message : "The vectorization worker failed.";
-  const details = error instanceof VectorizeError && Buffer.byteLength(JSON.stringify(error.details)) <= 64 * 1024 ? error.details : {};
-  return { code, details, message };
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
+import{MAX_VECTORIZE_REQUEST_BYTES,MAX_VECTORIZE_RESPONSE_BYTES,VECTORIZE_WORKER_PROTOCOL,VectorizeError,configureVectorizeSharpConcurrency,forwardVectorizeWorkerTermination,vectorizeImageInProcess,withInheritedCommandFileDescriptors}from"../index-qry58nj2.js";import"../index-80a36bc0.js";import{lstat,realpath}from"fs/promises";import{tmpdir}from"os";import{basename,dirname}from"path";var errorCodes=new Set(["input_limit","invalid_input","output_limit","quality_limit","timeout","tool_download","tool_integrity","tool_platform","tool_version","trace_failed","unsafe_svg"]);forwardVectorizeWorkerTermination();await main();async function main(){let response;try{configureVectorizeSharpConcurrency();const requestText=await readBoundedInput();const request=parseRequest(requestText);const input=decodeInput(request.input);const temporaryRoot=await validateTemporaryRoot(request.temporaryRoot);const result=await withInheritedCommandFileDescriptors(request.options.inheritedFileDescriptors,async()=>await vectorizeImageInProcess(input,request.options,temporaryRoot));response={ok:true,protocol:VECTORIZE_WORKER_PROTOCOL,result}}catch(error){response={error:serializeError(error),ok:false,protocol:VECTORIZE_WORKER_PROTOCOL}}let encoded=JSON.stringify(response);if(Buffer.byteLength(encoded)>MAX_VECTORIZE_RESPONSE_BYTES){encoded=JSON.stringify({error:{code:"output_limit",details:{maximumBytes:MAX_VECTORIZE_RESPONSE_BYTES},message:"The vectorization worker response exceeds its IPC limit."},ok:false,protocol:VECTORIZE_WORKER_PROTOCOL})}await Bun.write(Bun.stdout,encoded)}async function readBoundedInput(){const reader=Bun.stdin.stream().getReader();const chunks=[];let bytes=0;try{while(true){const{done,value}=await reader.read();if(done)break;bytes+=value.byteLength;if(bytes>MAX_VECTORIZE_REQUEST_BYTES){await reader.cancel();throw new VectorizeError("input_limit","The vectorization worker request exceeds its IPC limit.",{bytes,maximumBytes:MAX_VECTORIZE_REQUEST_BYTES})}chunks.push(value)}}finally{reader.releaseLock()}return Buffer.concat(chunks,bytes).toString("utf8")}function parseRequest(text){let parsed;try{parsed=JSON.parse(text)}catch(error){throw new VectorizeError("invalid_input","The vectorization worker request is malformed.",{},{cause:error})}if(!isRecord(parsed)||parsed.protocol!==VECTORIZE_WORKER_PROTOCOL||!isRecord(parsed.input)||!isRecord(parsed.options)||typeof parsed.temporaryRoot!=="string"||parsed.temporaryRoot.length===0||typeof parsed.input.kind!=="string"||typeof parsed.input.value!=="string"||!["bytes","path"].includes(parsed.input.kind)){throw new VectorizeError("invalid_input","The vectorization worker request is invalid.")}return parsed}function decodeInput(input){if(input.kind==="path")return input.value;if(input.value.length>Math.ceil(MAX_VECTORIZE_REQUEST_BYTES/3)*4||input.value.length%4!==0){throw new VectorizeError("input_limit","Encoded raster input exceeds its IPC limit.")}const bytes=Buffer.from(input.value,"base64");if(bytes.toString("base64")!==input.value){throw new VectorizeError("invalid_input","Encoded raster input is not canonical base64.")}return bytes}async function validateTemporaryRoot(path){let realRoot;let realTemporaryDirectory;try{const resolved=await Promise.all([realpath(path),realpath(tmpdir())]);realRoot=resolved[0];realTemporaryDirectory=resolved[1];const metadata=await lstat(path);if(!metadata.isDirectory()||metadata.isSymbolicLink()||dirname(realRoot)!==realTemporaryDirectory||!/^slopcamera-vectorize-[A-Za-z0-9_-]{6,}$/u.test(basename(realRoot))){throw new VectorizeError("invalid_input","The supervisor temporary directory is invalid.")}}catch(error){if(error instanceof VectorizeError)throw error;throw new VectorizeError("invalid_input","The supervisor temporary directory could not be verified.",{},{cause:error})}return realRoot}function serializeError(error){const code=error instanceof VectorizeError&&errorCodes.has(error.code)?error.code:"trace_failed";const message=error instanceof Error?error.message:"The vectorization worker failed.";const details=error instanceof VectorizeError&&Buffer.byteLength(JSON.stringify(error.details))<=64*1024?error.details:{};return{code,details,message}}function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}

package/dist/workflow.js

@@ -1,16 +1,2 @@
 // @bun
-import {
-  SlopcameraWorkflowError,
-  defineSlopcameraWorkflow,
-  runSlopcameraWorkflow
-} from "./index-fava6pge.js";
-import"./index-h1k0fnjq.js";
-import"./index-zfnddgay.js";
-import"./index-r7gdhmsp.js";
-import"./index-sh6xbav6.js";
-import"./index-z1w83f81.js";
-export {
-  runSlopcameraWorkflow,
-  defineSlopcameraWorkflow,
-  SlopcameraWorkflowError
-};
+import{SlopcameraWorkflowError,defineSlopcameraWorkflow,runSlopcameraWorkflow}from"./index-296qhpf2.js";import"./index-0bbesn4m.js";import"./index-qry58nj2.js";import"./index-77fjfg9f.js";import"./index-b3geqczn.js";import"./index-80a36bc0.js";export{runSlopcameraWorkflow,defineSlopcameraWorkflow,SlopcameraWorkflowError};

package/docs/README.md

@@ -2,7 +2,7 @@
 
 Slopcamera retains editable source, renders local or generated media, and assembles it into inspectable video projects. Choose a guide for the work you want to do.
 
-These pages describe Slopcamera from current source. [Install that source](how-to/use-current-source.md) to use the CLI, SDK and matching Agent Skill; no Slopcamera release archive is available yet. Historical Atet archives retain their original package and commands. The CLI also has an optional unbundled macOS menu-bar companion; the [menu-bar release contract](menubar-release.md) covers its prebuilt binary and LaunchAgent. The [capability reference](reference/capabilities.md) distinguishes them and lists local runtime requirements.
+These pages describe Slopcamera from current source. [Install that source](how-to/use-current-source.md) to use the newest CLI, SDK and matching Agent Skill. The [installation guide](../README.md#install-slopcamera) also links the currently verified release archive. Historical Atet archives retain their original package and commands. The CLI also has an optional unbundled macOS menu-bar companion; the [menu-bar release contract](menubar-release.md) covers its prebuilt binary and LaunchAgent. The [capability reference](reference/capabilities.md) distinguishes them and lists local runtime requirements.
 
 ## Learn by making something
 
@@ -18,7 +18,10 @@ These pages describe Slopcamera from current source. [Install that source](how-t
 - [Generate images, video, or narration](how-to/generate-media.md): discover Gateway capabilities, acknowledge selected uploads, and retain the result.
 - [Direct short generated clips](directing-video.md): budget, review takes, preserve endpoint continuity, and recover uncertain work.
 - [Author a native film](studio.md): use Blender, CadQuery, or Manim; retain caches; share assets and calibrated cameras.
+- [Build and revise a parametric design](how-to/parametric-design.md): generate architectural models from retained parameters, inspect dependencies and render alternatives.
 - [Render and edit spatial scenes](spatial-scenes.md): patch named entities, use hardware rendering, import a saved world, or prepare a V2 shot composition.
+- [Build a directed cinematic character world](how-to/cinematic-character-worlds.md): admit a rigged world, direct it semantically, plan effects and galleries, and audit temporal evidence.
+- [Direct a cinematic world end to end](how-to/direct-cinematic-worlds.md): author an inert recipe pack and run the `cinematic-world` planning-and-review workflow.
 - [Make an educational video](how-to/educational-video.md): keep mathematical visuals, narration, and timing evidence revisable.
 - [Run or recover a workflow](how-to/run-workflows.md): use a built-in recipe or trusted Bun module and inspect its durable run.
 - [Configure Vercel](vercel.md) or [publish Slopcamera](publishing.md): provider and maintainer procedures.
@@ -32,6 +35,7 @@ These pages describe Slopcamera from current source. [Install that source](how-t
 ## Understand the design
 
 - [Source, representations, and projects](architecture.md): what stays editable, what a receipt proves, and how local and cloud work fit together.
+- [Extension architecture](extension-architecture.md): the closed registry, inert recipe packs, trusted workflows, and where authored code can and cannot go.
 - [Choose an HTML authoring surface](html-overlay-creative-toolkit.md): why DOM, vector, Three.js, and explicit GPU profiles serve different jobs. Its ecosystem research is dated separately from its supported locks.
 
 ## Work with an agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/slopcamera",
-  "version": "3.2.8",
+  "version": "3.3.1",
   "description": "A local visual studio for coding agents: author scenes, combine generated and recorded media, and export images, diagrams, animation, and video from retained sources.",
   "license": "MIT",
   "type": "module",
@@ -197,7 +197,7 @@
   ],
   "scripts": {
     "build": "bun run build:sdk && bun run build:desktop && bun run build:web",
-    "build:sdk": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.ts ./src/cli.ts ./src/code/index.ts ./src/code/advanced.ts ./src/generate.ts ./src/host-resources.ts ./src/operations.ts ./src/workflow.ts ./src/vectorize/worker.ts --outdir ./dist --root ./src --target bun --format esm --splitting --packages external",
+    "build:sdk": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.ts ./src/cli.ts ./src/code/index.ts ./src/code/advanced.ts ./src/generate.ts ./src/host-resources.ts ./src/operations.ts ./src/workflow.ts ./src/vectorize/worker.ts --outdir ./dist --root ./src --target bun --format esm --splitting --packages external --minify-whitespace --emit-dce-annotations",
     "build:desktop": "bun run build:desktop:cli",
     "build:desktop:cli": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./apps/desktop/dist/cli\", { recursive: true, force: true })' && bun build --target=bun --minify --sourcemap=none --packages external --external @hraness/slopcamera/cli apps/desktop/cli/main.ts --outdir apps/desktop/dist/cli",
     "build:web": "bun run --cwd apps/web build",
@@ -226,7 +226,7 @@
     "benchmark:code-concurrency": "bun run ./apps/desktop/code/concurrency-benchmark.ts",
     "check:release-workflows": "bun test ./scripts/release-workflow.test.ts ./scripts/github-release.test.ts",
     "check:schema": "bun run ./scripts/validate-schema.ts",
-    "check:skill": "bun run ./scripts/validate-skill.ts",
+    "check:skill": "bun run ./scripts/validate-skill.ts && bun test ./scripts/social-collage-compositor.test.ts",
     "check:standalone": "bun test ./scripts/standalone-support-fixture.test.ts && bun run ./scripts/check-standalone.ts",
     "test:vectorize:official": "bun run ./scripts/official-vectorizer-smoke.ts",
     "test:package": "bun run ./scripts/package-smoke.ts",
@@ -237,13 +237,15 @@
     "kb:check:lane": "bunx --bun github:hraness/kb#v0.15.2 check --root kb --no-catalog",
     "kb:check": "bunx --bun github:hraness/kb#v0.15.2 check --root kb && bunx --bun github:hraness/kb#v0.15.2 agents check --root kb --repo .",
     "kb:catalog": "bunx --bun github:hraness/kb#v0.15.2 catalog --root kb",
-    "check": "bun run check:standalone && bun run check:sdk && bun run check:desktop && bun run check:web && bun run check:standalone && bun run test:package",
+    "check:cost-surfaces": "bun ./scripts/check-cost-surfaces.mjs",
+    "check": "bun run check:cost-surfaces && bun run check:standalone && bun run check:sdk && bun run check:desktop && bun run check:web && bun run check:standalone && bun run test:package",
     "prepack": "bun run check",
     "check:effect": "bun run ./scripts/check-effect-policy.ts && bun test ./scripts/check-effect-architecture.test.ts"
   },
   "dependencies": {
-    "@hraness/support-foundation": "github:hraness/support-foundation#b32c1c81bb2444f50509ed54388758ecfab1f1c0",
     "@ai-sdk/gateway-v4": "npm:@ai-sdk/gateway@^4.0.27",
+    "@hraness/algal": "github:hraness/algal#c46264a",
+    "@hraness/support-foundation": "github:hraness/support-foundation#b32c1c81bb2444f50509ed54388758ecfab1f1c0",
     "@noble/hashes": "2.2.0",
     "@paper-design/shaders": "0.0.77",
     "@resvg/resvg-js": "2.6.2",

package/skills/slopcamera/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: slopcamera
-description: Create, inspect, edit and render visual media with the Slopcamera CLI and SDK. Use for diagrams, raster-to-SVG conversion, screen or camera recordings, video editing and captions, music videos from authored scenes and local tracks, AI images/video/speech/transcription, Three.js scenes and world-space media, Blender rigs and simulation, CadQuery models, Manim educational films, HTML/WGSL motion graphics, and durable agent workflows.
+description: Create, inspect, edit and render visual media with the Slopcamera CLI and SDK. Use for diagrams, raster-to-SVG conversion, screen or camera recordings, video editing and captions, social collage banners, music videos from authored scenes and local tracks, AI images/video/speech/transcription, Three.js scenes and world-space media, Blender rigs and simulation, CadQuery models, parametric architectural designs, Manim educational films, HTML/WGSL motion graphics, and durable agent workflows.
 ---
 
 # Create visual media with Slopcamera
@@ -24,8 +24,13 @@ Slopcamera installs from its verified release archive or from source. Historical
 | Music video, dancing mascot or timed HTML scene with a local soundtrack | [Music videos](references/music-video.md) |
 | Authorized YouTube or other public web-media excerpt (`yt-dlp` / `youtube-dl`) | [Web-media excerpts](references/web-media-excerpts.md) |
 | Generate images, clips, narration or transcripts | [Gateway media](references/gateway-media.md) |
+| Compose an editorial or social banner from generated layers, local type and diagrams | [Social collage banners](references/social-collage-banners.md) |
+| Review alternative textures, skyboxes, backdrops, design candidates or whole-scene variants | [Image galleries](references/image-galleries.md) |
 | Budgeted short clips, reviewed takes and continuity | [Directing video](references/directing-video.md) |
 | Editable Three/Spark scene, saved world, named-part edits or shared camera | [Directed scenes](references/directed-scenes.md) |
+| Semantic direction, galleries, bounded effects, temporal audit or the cinematic-world recipe pack | [Directed scenes](references/directed-scenes.md#direct-cinematic-worlds) |
+| Author a scene from code, generate procedural entities, or audit framing | [Scene building](references/scene-building.md) |
+| Parametric architecture, furniture, dimensions, repeated structures or editable design variants | [Parametric design](references/parametric-design.md) |
 | Blender, rigs, bakes, CAD, shared native assets or production frames | [Native studio](references/native-studio.md) |
 | Manim lesson, narrated explanation or mathematical animation | [Educational video](references/educational-video.md) |
 | Typed Bun SDK, built-in workflow, durable resume or MCP | [Workflows and SDK](references/workflows-sdk.md) |

package/skills/slopcamera/references/directed-scenes.md

@@ -2,7 +2,7 @@
 
 Use `slopcamera scene --help` to check that the installed CLI includes the directed-scene foundation. The initial renderer uses Three.js and supports explicit scene JSON, semantic edits, calibrated cameras, native media surfaces, contact sheets, and transparent video.
 
-Start with `slopcamera scene init scene.json --json`, then `slopcamera scene inspect scene.json --json`. Retain the original source. Use its stable entity IDs and exact `sceneSha256` in typed patches; save each edit with `--output` to a new file. Inspect `editableControls` before changing generated parts or imported materials. Do not replace named scene parts with opaque regenerated source merely to change one color or camera.
+To author a scene from code — builder helpers, procedural generator modules, glTF admission, or geometric audit — read [scene building](scene-building.md) first. Start interactive work with `slopcamera scene init scene.json --json`, then `slopcamera scene inspect scene.json --json`. Retain the original source. Use its stable entity IDs and exact `sceneSha256` in typed patches; save each edit with `--output` to a new file. Inspect `editableControls` before changing generated parts or imported materials. Do not replace named scene parts with opaque regenerated source merely to change one color or camera.
 
 Use `slopcamera scene plan scene.json --request request.json --json` before rendering. A frame request is:
 
@@ -22,15 +22,35 @@ For a media project, finish ordinary timeline/audio edits before V2 migration. R
 
 Use `scene project restore` to select an earlier retained scene for explicit shots in a new project revision. Use `add-asset`/`replace-asset` and `set-mesh-geometry` for authored representation changes. Preserve the entity ID and explicitly readdress GLB node/clip indices after a payload replacement; inspect available controls again afterward.
 
+Generated raster assets enter the scene the same way: declare the image as an `add-asset` payload with `provenance.source: "generated"`, then apply it explicitly — `set-material` with `material.map` on an authored procedural mesh for a texture, or `add-entity` a `kind: "environment"` entity (`role` plus bounded `intensity`) for a skybox. When alternatives matter, review them through [an image gallery](image-galleries.md) first and promote only the selected candidate; a frame renders at most one visible environment entity.
+
 Prepare a camera program with `slopcamera scene project prepare-render <project-id> --input prepare.json --output prepared-render.json --json`. The input declares the exact basis, calibrated output profile, straight-alpha full-frame scene policy, and delivery output/sync policy/tier. Then run `slopcamera workflows plan directed-scene --input prepared-render.json --json` and `slopcamera workflows run directed-scene --input prepared-render.json --json`. Use `slopcamera workflows show directed-scene --json` for the complete prepared-input schema.
 
 Use `--profile three-webgl2-hardware-v1` on scene rendering or project preparation to require the qualified macOS Metal backend. Missing or software GPU evidence rejects; no silent fallback occurs. A profile already in the request must agree with the CLI. Omit both fields for the historical software renderer. GPU identity and retained artifact hashes serve different purposes: cross-driver regeneration need not be pixel-identical.
 
-Import saved SPZ and an optional approximate collider with `scene world import --input import.json --source-root <directory> --output-root artifacts/slopcamera/generated/<name> --json`. Declare exact payload hashes, stable IDs, scale, source up axis and uniform transform. Historical World Labs provenance remains supported for offline replay and requires the matching world ID, approximate collider and retained provider receipt. Import needs no provider credential; paid world-generation commands were removed from current source (they remain in the historical Atet v3.2.3 release). Keep all returned assets and the splat entity, and save the consuming scene JSON inside that import output directory so its asset paths resolve relative to the scene file. Metadata dependencies preserve provenance through source-gone replay. Do not invent scale or relabel a collider as verified physics. Use `three-spark-webgl2-hardware-v1` for non-AA SPZ v2/v3, perspective cameras and at most 500,000 splats across the rendered world. This profile renders beauty only; splat depth/ID products and interleaved transparent world surfaces are unsupported. Materials and internal objects inside a splat are not ordinary editable mesh parts.
+Import saved SPZ and an optional approximate collider with `scene world import --input import.json --source-root <directory> --output-root artifacts/slopcamera/generated/<name> --json`. Declare exact payload hashes, stable IDs, scale, source up axis and uniform transform. An optional `providerMetadata` payload reference (for example a Marble `semantics_metadata` JSON export) surfaces recognized scale/ground/up-axis fields as an advisory `suggestedNormalization` in the output manifest; normalization still comes only from the explicit input fields. Historical World Labs provenance remains supported for offline replay and requires the matching world ID, approximate collider and retained provider receipt. Import needs no provider credential; paid world-generation commands were removed from current source (they remain in the historical Atet v3.2.3 release). Keep all returned assets and the splat entity, and save the consuming scene JSON inside that import output directory so its asset paths resolve relative to the scene file. Metadata dependencies preserve provenance through source-gone replay. Do not invent scale or relabel a collider as verified physics. Use `three-spark-webgl2-hardware-v1` for non-AA SPZ v2/v3, perspective cameras and at most 500,000 splats across the rendered world. This profile renders beauty only; splat depth/ID products and interleaved transparent world surfaces are unsupported. Materials and internal objects inside a splat are not ordinary editable mesh parts.
 
 Keep receipts and the original run ID after interruption. Inspect `slopcamera runs` and reconcile the exact attempt instead of blindly repeating a possibly published operation. Candidate records preserve derivation and staleness; candidate selection does not yet replace authored footage in the V2 scene compositor. Interactive scene editing and portable simulation remain deferred; native Blender jobs retain their own simulation caches. Use the separate [directing workflow](directing-video.md) to generate and review short clips before assembling an ordinary media project.
 
 
+## Direct cinematic worlds
+
+A `slopcamera.spatial-direction` document describes beats, actions, camera coverage, and look intents semantically; its `projectDigest` must equal the scene's `sceneSha256` from `scene inspect`. Check it with `slopcamera scene direction check direction.json --scene scene.json --json`, compile proposals with `scene direction plan ... --camera <camera-id> --output plan.json`, and plan bounded variants with `scene direction gallery ... --axis performance|camera|lighting|materials|effects|sequence`. Compiled direction stays `verified: false` — it is review evidence, not applied state.
+
+Bind declared effects through `scene effects plan` and `scene effects check` against the same scene, and bake planned simulation through `scene effects bake` when the plan calls for it. `scene temporal-audit` and `scene render-audit` report sampled evidence over explicit `--times-us` without inventing quality claims.
+
+## Author character behaviors
+
+A `slopcamera.spatial-behavior` document describes deterministic character behavior programs as ALGAL organism graphs — inert manifests of typed cells (`input`/`const`/`fn`/`repeat`/`each`/`organism` only for bake-safe behaviors), declared channels, scene binding, and explicit initial state. The organism closure is a content-addressed map of manifest digests to manifests; the `entry` field selects the top-level organism.
+
+Check a behavior against a scene with `slopcamera scene behavior check behavior.json --scene scene.json --json`. The checker validates the organism closure (digest consistency, fn references against the admitted catalog, wiring, carry bindings, interface completeness, entity and range against the scene). Bake it with `slopcamera scene behavior bake behavior.json --scene scene.json --output bake.json --json`; the bake runs through the real ALGAL runtime and produces a deterministic emitted trace with a bound receipt. Plan seeded gallery variants with `slopcamera scene behavior gallery behavior.json --scene scene.json --json`. Audit a baked trace with `slopcamera scene behavior audit bake.json --json`; the audit reports state thrash, exact periodicity, dead channels, and unreachable states as advisory findings.
+
+Four standard-library organisms are available for composition: locomotion FSM (`behavior.fsm.v1` — state machines with after/chance/flag/clear/always guards), expression layer (`behavior.expression.v1` — blink, gaze, mood), interaction sequence (`behavior.interact.v1` — phase sequencer with emit-on-entry), and a combined organism that merges all three via pairwise `emitted.append`. Each follows the `repeat`+`carry`+`window.advance` accumulation pattern. Use the stdlib organisms as templates; compose them into a behavior document with explicit initial states and scene-bound args.
+
+The authoring loop: (1) assemble a behavior doc from stdlib organisms with scene-bound args, (2) check it with `scene behavior check`, (3) bake it with `scene behavior bake`, (4) audit the trace with `scene behavior audit`, (5) plan gallery variants and review. Identical behavior doc + seed + scene produce byte-identical bakes. The `seed` interface input auto-binds from `behavior.seed` for gallery diversity. A channel map (`--channel-map`) binds emitted channels to clip runs, attach/release pairs, or trajectory waypoints for performance directives. Behaviors never execute source, contact providers, or access the filesystem; organisms are data.
+
+The `cinematic-world` built-in workflow composes exactly these operations for one admitted scene. Its input is an inert `slopcamera.spatial-recipe-pack` — one scene digest, one direction document, bounded gallery axes, up to 4 named preview render requests, optional declared effects, and optional temporal-audit inputs — wrapped with the scene document and its repository path. Plan it with `slopcamera workflows plan cinematic-world --input input.json --json`; run it with `workflows run`. The workflow never selects or promotes a candidate: registration uses `scene project add-candidate <project-id> --input <request.json>`, and selection uses `scene project select-candidate <project-id> --input <request.json>`, both after review. A recipe pack is data — it cannot register executors, source paths beyond the declared render source, permissions, secrets, or URLs.
+
 ## Direct short generated clips
 
 Use [short-video directing](directing-video.md) for retained paid takes and accepted-shot assembly. Use the matching Slopcamera source build for those commands.

package/skills/slopcamera/references/gateway-media.md

@@ -109,6 +109,12 @@ Never automatically retry an interrupted or failed paid generation. Slopcamera u
 zero client retries because an ambiguous request may still have been charged.
 Report the failure receipt and reconcile the exact attempt. A deliberate new paid command needs authority within the user’s budget; do not infer that an ambiguous failure was free.
 
+When the request leaves alternatives open — texture maps, skyboxes,
+backdrops, sprites, or competing design directions — prefer `slopcamera ai
+image gallery`, which runs one tracked job per candidate and composes a
+labelled contact sheet for one review pass. [Image galleries](image-galleries.md)
+covers the candidate grammar, receipt, and explicit promotion steps.
+
 ## Finish the task
 
 Report:
@@ -123,7 +129,9 @@ Report:
 
 Use [directing video](directing-video.md) for budgeted takes, accepted predecessor frames and local recovery. URL-only models can use its explicit private Blob path; do not paste short-lived signed URLs into CLI arguments or project files. Blob charges and authority are separate from Gateway.
 
-The small portable `slopcamera image generate '<prompt>' --output image.webp` command defaults to `recraft/recraft-v4.1-utility` and admits PNG/JPEG/WebP output. It is distinct from the local `ai` catalog workflow. Preserve literal prompts when requested, keep its output inside the intended workspace and never automatically retry a failed paid call.
+The small portable `slopcamera image generate '<prompt>' --output image.webp` command defaults to `recraft/recraft-v4.1-utility` and admits PNG/JPEG/WebP output. It is distinct from the local `ai` catalog workflow. Preserve literal prompts when requested, keep its output inside the intended workspace and never automatically retry a failed paid call. Its sibling `slopcamera image gallery '<subject>' --output-dir <directory>` shares that bounded model contract and composes several candidates into one review sheet; see [image galleries](image-galleries.md).
+
+For product identity SVGs, `slopcamera image icon '<subject>' --purpose <mark|illustration> --output icon.svg` is the canned pipeline. `mark` produces a compact favicon/app/header mark: one to three bold masses in one ink, gated for 16–32 px recognition and low path count. `illustration` (the compatibility default) produces the related marketing illustration: simple isometric structure in one ink, gated against hairlines, dense fills, and detail lost at 64 px. Both run one style-locked Gateway raster through ink normalization, local tracing, and deterministic geometry gates. `--rounds 2` (the default) adds a purpose-specific vision critique that revises the prompt between attempts; `--rounds 1` is a single paid generation with no critique call. `--ink` overrides the ink color and `--keep-raster` retains the normalized line-art PNG beside the SVG.
 
 ## Style recipes
 
@@ -132,3 +140,9 @@ vignette and typewriter notes on paper right), do not ask Gateway to redraw the
 whole poster. Follow [rubber-stamp-field-notes.md](rubber-stamp-field-notes.md):
 generate only the stamp with a reference-capable model, then assemble with the
 local compositor.
+
+For an editorial or social banner made from an opaque plate, transparent
+characters, motif clusters, local type, annotations, and diagram clippings,
+follow [social-collage-banners.md](social-collage-banners.md). Generate each
+semantic role independently, inspect its pixels, and compose the selected files
+with the packaged manifest-driven compositor.