@hraness/slopcamera 3.2.4

package/dist/index.js

@@ -0,0 +1,241 @@
+// @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,
+  desktopDownloadPage,
+  desktopStatus,
+  diagramApi,
+  findDesktopApplication,
+  getLatestDesktopRelease,
+  inspectStudioBundle,
+  inspectStudioPlan,
+  installDesktop,
+  mcpMaximumRenderedPixels,
+  mcpMaximumScale,
+  mcpSourceByteLimit,
+  openInDesktop,
+  parseStudioJob,
+  parseStudioPlan,
+  parseStudioReceipt,
+  parseStudioRuntimeIdentity,
+  parseStudioSourceBundle,
+  planStudioJob,
+  readDiagramFile,
+  renderDiagramFile,
+  runMcpServer,
+  selectDesktopAsset,
+  slopcameraApi,
+  slopcameraMcpProtocolVersion,
+  slopcameraMcpServerName,
+  slopcameraMcpTools,
+  studioJobSha256,
+  studioOutputPath,
+  studioRuntimeSha256,
+  studioSourceBundleSha256,
+  validateStudioReceipt
+} from "./index-zfeg9hmw.js";
+import {
+  bundledSkillPath,
+  installSkill
+} from "./index-7308egqr.js";
+import"./index-8txs6fkn.js";
+import {
+  SlopcameraWorkflowError,
+  defineSlopcameraWorkflow,
+  runSlopcameraWorkflow
+} from "./index-mcy8z0br.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-z7239b4h.js";
+import {
+  VTRACER_VERSION,
+  VectorizeError,
+  vectorizeDefaultLimits,
+  vectorizeHardLimits,
+  vectorizeImage,
+  vectorizeProfileNames,
+  vtracerReleases
+} from "./index-p63wavx0.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,
+  selectDesktopAsset,
+  searchSlopcameraOperations,
+  runSlopcameraWorkflow,
+  runMcpServer,
+  resolveStackLayout,
+  resolveEdge,
+  resolveDiagramSource,
+  renderSvg,
+  renderPng,
+  renderDiagramFile,
+  readDiagramFile,
+  planStudioJob,
+  parseStudioSourceBundle,
+  parseStudioRuntimeIdentity,
+  parseStudioReceipt,
+  parseStudioPlan,
+  parseStudioJob,
+  parseSlopcameraOperationInput,
+  parseDiagramSpec,
+  parseDiagramSource,
+  openInDesktop,
+  normalizeHostResourceProfile,
+  normalizeHostResourceClaims,
+  mcpSourceByteLimit,
+  mcpMaximumScale,
+  mcpMaximumRenderedPixels,
+  lintDiagram,
+  isSlopcameraOperationCode,
+  installSkill,
+  installDesktop,
+  inspectStudioPlan,
+  inspectStudioBundle,
+  getLatestDesktopRelease,
+  generateSlopcameraImageFile,
+  generateSlopcameraImage,
+  findDesktopApplication,
+  executeSlopcameraOperationWithLease,
+  executeSlopcameraOperation,
+  diagramApi,
+  desktopStatus,
+  desktopDownloadPage,
+  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
+};

package/dist/operations.js

@@ -0,0 +1,29 @@
+// @bun
+import {
+  SlopcameraOperationError,
+  executeSlopcameraOperation,
+  executeSlopcameraOperationWithLease,
+  isSlopcameraOperationCode,
+  parseSlopcameraOperationInput,
+  searchSlopcameraOperations,
+  slopcameraOperationCodes,
+  slopcameraOperationHostResourceClaims,
+  slopcameraOperationRegistry,
+  withSlopcameraOperationHostAdmission
+} from "./index-z7239b4h.js";
+import"./index-p63wavx0.js";
+import"./index-r7gdhmsp.js";
+import"./index-sh6xbav6.js";
+import"./index-z1w83f81.js";
+export {
+  withSlopcameraOperationHostAdmission,
+  slopcameraOperationRegistry,
+  slopcameraOperationHostResourceClaims,
+  slopcameraOperationCodes,
+  searchSlopcameraOperations,
+  parseSlopcameraOperationInput,
+  isSlopcameraOperationCode,
+  executeSlopcameraOperationWithLease,
+  executeSlopcameraOperation,
+  SlopcameraOperationError
+};

package/dist/skill-install-dh0ntqba.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  bundledSkillPath,
+  installSkill
+} from "./index-7308egqr.js";
+import"./index-z1w83f81.js";
+export {
+  installSkill,
+  bundledSkillPath
+};

package/dist/vectorize/worker.js

@@ -0,0 +1,142 @@
+// @bun
+import {
+  MAX_VECTORIZE_REQUEST_BYTES,
+  MAX_VECTORIZE_RESPONSE_BYTES,
+  VECTORIZE_WORKER_PROTOCOL,
+  VectorizeError,
+  configureVectorizeSharpConcurrency,
+  forwardVectorizeWorkerTermination,
+  vectorizeImageInProcess,
+  withInheritedCommandFileDescriptors
+} from "../index-p63wavx0.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);
+}

package/dist/workflow.js

@@ -0,0 +1,16 @@
+// @bun
+import {
+  SlopcameraWorkflowError,
+  defineSlopcameraWorkflow,
+  runSlopcameraWorkflow
+} from "./index-mcy8z0br.js";
+import"./index-z7239b4h.js";
+import"./index-p63wavx0.js";
+import"./index-r7gdhmsp.js";
+import"./index-sh6xbav6.js";
+import"./index-z1w83f81.js";
+export {
+  runSlopcameraWorkflow,
+  defineSlopcameraWorkflow,
+  SlopcameraWorkflowError
+};

package/docs/README.md

@@ -0,0 +1,38 @@
+# Slopcamera documentation
+
+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 [capability reference](reference/capabilities.md) distinguishes them and lists local runtime requirements.
+
+## Learn by making something
+
+- [Create and revise your first diagram](tutorials/first-diagram.md): make a two-node diagram, inspect its five exports, then change its source.
+- [Render your first native film](tutorials/first-native-film.md): retain a Blender source, render a small shot, and export an ordinary Slopcamera project.
+
+## Complete a task
+
+- [Run current-source commands](how-to/use-current-source.md): build an exact checkout of Slopcamera.
+
+- [Edit and deliver video](how-to/edit-video.md): import footage, align related tracks, place overlays, and check a delivery.
+- [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.
+- [Render and edit spatial scenes](spatial-scenes.md): patch named entities, use hardware rendering, import a saved world, or prepare a V2 shot composition.
+- [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.
+
+## Look up a contract
+
+- [Capabilities, versions, and platforms](reference/capabilities.md): current Slopcamera capabilities, historical Atet versions, and supported runtime boundaries.
+- [SDK surfaces](reference/sdk.md): portable and local imports, operation projections, and execution contracts.
+- [CLI help](reference/capabilities.md#discover-the-installed-contract): exact grammar and JSON schemas from the installed host.
+
+## Understand the design
+
+- [Source, representations, and projects](architecture.md): what stays editable, what a receipt proves, and how local and cloud work fit together.
+- [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
+
+The [Slopcamera Agent Skill](../skills/slopcamera/SKILL.md) routes an agent to the relevant task reference. Install the skill from the same source build as your CLI; installing a skill alone does not install the CLI or native tools. See the [installation instructions](../README.md#install-slopcamera).