@hraness/slopcamera 3.3.3 → 3.3.5

package/apps/desktop/html-overlay/spatial-splat-runtime.ts

@@ -18,6 +18,12 @@ renderer.readRenderTargetPixelsAsync=async(target,x,y,width,height,buffer,face,a
 const spark=new SparkRenderer({renderer,autoUpdate:false,preUpdate:false,enableLod:false,enableDriveLod:false,enableLodFetching:false,
   maxPagedSplats:65536,numLodFetchers:0,lodRaycast:0,accumExtSplats:true,premultipliedAlpha:true,encodeLinear:true,sortRadial:false,minSortIntervalMs:0,depthTest:true,depthWrite:false,
   preBlurAmount:input.splatKernel.preBlurAmount,blurAmount:input.splatKernel.blurAmount});
+// SPZ preserves signed SH radiance; fractional gamma is undefined below zero.
+// Guard the physical radiance domain after SH reconstruction and before blending.
+// Keep positive HDR values and the pinned Spark transfer function unchanged.
+const linearRgbAnchor="rgba.rgb = srgbToLinear(rgba.rgb);";
+if(spark.material.fragmentShader.split(linearRgbAnchor).length!==2)throw new Error("Spark linear-RGB shader anchor changed; review the pinned renderer adapter.");
+spark.material.fragmentShader=spark.material.fragmentShader.replace(linearRgbAnchor,"rgba.rgb = srgbToLinear(max(rgba.rgb, vec3(0.0)));");
 spark.readPause=0;spark.sortPause=0;spark.sortDelay=0;
 const splatMeshes=new Map();
 const disposeSplats=()=>{for(const mesh of splatMeshes.values())mesh.dispose();splatMeshes.clear();spark.dispose();};

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-import{SLOPCAMERA_VERSION,artifactSummary,checkDiagramFile,renderDiagramFile,runMcpServer}from"./index-3e1pcxb5.js";import{installSkill,pathExists}from"./index-grk47tgs.js";import"./index-z1kd1x8j.js";import"./index-3cxf2c58.js";import"./index-296qhpf2.js";import{executeSlopcameraOperation,generateSlopcameraIcon,generateSlopcameraImageGallery,isSlopcameraOperationCode,parseSlopcameraGalleryVary,searchSlopcameraOperations,slopcameraGalleryKinds,slopcameraGalleryLimits,slopcameraIconMaximumRounds,slopcameraOperationCodes,withSlopcameraOperationHostAdmission}from"./index-0bbesn4m.js";import{vectorizeImage}from"./index-qry58nj2.js";import{generateSlopcameraImageFile,slopcameraGatewayCredentialStatus,slopcameraImageModels}from"./index-77fjfg9f.js";import"./index-b3geqczn.js";import{__require}from"./index-80a36bc0.js";import{readFile,writeFile}from"fs/promises";import{resolve}from"path";function reportUsefulResult(observer){try{if(observer!==undefined)Promise.resolve(observer()).catch(()=>{return})}catch{}}import{maybeShowSupportInvitation,runSupportCommand}from"@hraness/support-foundation/node";var supportProfile={id:"slopcamera",name:"Slopcamera",valueProposition:"Support ongoing development of local visual tools for agents.",updates:false};function standaloneSupportEnvironment(){const env={...process.env};process.env.HRANESS_SUPPORT_AUDIENCE="off";process.env.HRANESS_SUPPORT_EMAIL="off";return env}async function runProductSupportCommand(args,options={}){const result=await runSupportCommand(supportProfile,args,{command:["slopcamera"],...options,gitEmail:false});if(result.stdout!=="")process.stdout.write(result.stdout);if(result.stderr!=="")process.stderr.write(result.stderr);return result.exitCode}async function showProductSupportInvitation(options={}){try{await maybeShowSupportInvitation(supportProfile,{usefulResult:true,command:["slopcamera"],...options,gitEmail:false})}catch{}}var slopcameraCliVersion=SLOPCAMERA_VERSION;var help=`slopcamera ${slopcameraCliVersion}
+import{SLOPCAMERA_VERSION,artifactSummary,checkDiagramFile,checkDrawingFile,renderDiagramFile,renderDrawingFile,runMcpServer,starterDrawingSource}from"./index-11cb717y.js";import{installSkill,pathExists}from"./index-grk47tgs.js";import"./index-z1kd1x8j.js";import"./index-3cxf2c58.js";import"./index-qtn3s421.js";import{executeSlopcameraOperation,generateSlopcameraIcon,generateSlopcameraImageGallery,isSlopcameraOperationCode,parseSlopcameraGalleryVary,searchSlopcameraOperations,slopcameraGalleryKinds,slopcameraGalleryLimits,slopcameraIconMaximumRounds,slopcameraOperationCodes,withSlopcameraOperationHostAdmission}from"./index-sy1n4zfy.js";import{vectorizeImage}from"./index-qry58nj2.js";import{generateSlopcameraImageFile,slopcameraGatewayCredentialStatus,slopcameraImageModels}from"./index-77fjfg9f.js";import"./index-b3geqczn.js";import{__require}from"./index-80a36bc0.js";import{readFile,writeFile}from"fs/promises";import{resolve}from"path";function reportUsefulResult(observer){try{if(observer!==undefined)Promise.resolve(observer()).catch(()=>{return})}catch{}}import{maybeShowSupportInvitation,runSupportCommand}from"@hraness/support-foundation/node";var supportProfile={id:"slopcamera",name:"Slopcamera",valueProposition:"Support ongoing development of local visual tools for agents.",updates:false};function standaloneSupportEnvironment(){const env={...process.env};process.env.HRANESS_SUPPORT_AUDIENCE="off";process.env.HRANESS_SUPPORT_EMAIL="off";return env}async function runProductSupportCommand(args,options={}){const result=await runSupportCommand(supportProfile,args,{command:["slopcamera"],...options,gitEmail:false});if(result.stdout!=="")process.stdout.write(result.stdout);if(result.stderr!=="")process.stderr.write(result.stderr);return result.exitCode}async function showProductSupportInvitation(options={}){try{await maybeShowSupportInvitation(supportProfile,{usefulResult:true,command:["slopcamera"],...options,gitEmail:false})}catch{}}var slopcameraCliVersion=SLOPCAMERA_VERSION;var help=`slopcamera ${slopcameraCliVersion}
 
 Turn source material into deterministic diagrams, images, and canvas assets.
 
@@ -8,6 +8,9 @@ Usage:
   slopcamera diagram init [file]
   slopcamera diagram check <file> [--config <file>] [--strict]
   slopcamera diagram render <file> [--out-dir <directory>] [--config <file>] [--scale <number>]
+  slopcamera diagram sheets init <file.drawing.json> [--json]
+  slopcamera diagram sheets check <file.drawing.json> [--json]
+  slopcamera diagram sheets render <file.drawing.json> [--out-dir <directory>] [--json]
   slopcamera image vectorize <image> --output <file.svg> [--json] [--duotone <#rgb,#rgb>]
   slopcamera image generate <prompt> --output <file.png|jpg|webp> [--model <provider/model>] [--json]
   slopcamera image icon <subject> --output <file.svg> [--purpose <mark|illustration>]
@@ -24,7 +27,7 @@ Usage:
   slopcamera skill path
   slopcamera skill install [--target codex|claude|agents] [--scope user|project] [--force]
 
-Render writes the same five replaceable artifacts on every run:
+Diagram render writes the same five replaceable artifacts on every run:
   <name>.tldr
   <name>.light.svg
   <name>.dark.svg
@@ -34,6 +37,11 @@ Render writes the same five replaceable artifacts on every run:
   The .tldr file is editable interchange for browser-based canvas tooling.
   Rendering does not require a desktop application or a bundled UI runtime.
 
+Diagram sheets creates bounded black-and-white drawing sheets from a separate
+.drawing.json source: one vector PDF, one outlined SVG per sheet, and a receipt.
+Check is read-only; init never overwrites. Geometry checks do not certify legal
+compliance. This surface is available through the CLI and root SDK.
+
 Vectorize adaptively traces a raster with a checksum-pinned VTracer binary.
 It enforces bounded input, decode, time, path, and output budgets and emits a
 safe path-only SVG (plus an internal vector alpha mask when fidelity requires).
@@ -66,9 +74,11 @@ MCP preserves root-relative check_diagram/render_diagram and adds closed
 search_slopcamera/execute_slopcamera registry tools. It uses built-in assets, never
 executes workspace config or caller code, and writes protocol messages only to
 stdout.
-`;function parseArguments(args,valueOptions){const positionals=[];const options={};const flags=new Set;for(let index=0;index<args.length;index+=1){const argument=args[index];if(argument===undefined)continue;if(!argument.startsWith("--")){positionals.push(argument);continue}const name=argument.slice(2);if(!valueOptions.has(name)){flags.add(name);continue}const value=args[index+1];if(value===undefined||value.startsWith("--")){throw new Error(`--${name} requires a value`)}options[name]=value;index+=1}return{positionals,options,flags}}function requiredPositional(parsed,index,label){const value=parsed.positionals[index];if(value===undefined)throw new Error(`Missing ${label}`);return value}function requiredOption(parsed,name){const value=parsed.options[name];if(value===undefined)throw new Error(`--${name} is required`);return value}function parsePositiveInteger(value,name){if(value===undefined)return;const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<1){throw new Error(`--${name} must be a positive integer`)}return parsed}function parseDuotone(value){if(value===undefined)return;const colors=value.split(",").map((color)=>color.trim());if(colors.length!==2||colors.some((color)=>!/^#[a-f0-9]{3}(?:[a-f0-9]{3})?$/iu.test(color))){throw new Error("--duotone must contain two #rgb or #rrggbb colors separated by a comma")}return[colors[0],colors[1]]}function parseGalleryVary(value){if(value===undefined)return;return parseSlopcameraGalleryVary(value)}async function readGalleryCandidates(path){const text=await readFile(resolve(path),"utf8");if(Buffer.byteLength(text,"utf8")>64*1024){throw new Error("--candidates JSON must be no more than 65536 UTF-8 bytes")}try{return JSON.parse(text)}catch{throw new Error("--candidates must be valid JSON")}}function printFindings(findings){if(findings.length===0){console.log("No diagram lint findings.");return}console.warn(`${findings.length} diagram lint finding${findings.length===1?"":"s"}:`);for(const finding of findings){console.warn(`  [${finding.code}] ${finding.message}`)}}var starter={$schema:"https://raw.githubusercontent.com/hraness/slopcamera/main/schema/diagram.schema.json",version:1,name:"example-flow",canvas:{width:960,height:540,padding:64},layout:{type:"stack",direction:"horizontal",gap:160,align:"center"},shapes:[{id:"source",type:"rect",width:240,height:160,label:"Source",icon:"document",tone:"blue"},{id:"result",type:"rect",width:240,height:160,label:"Result",icon:"check",tone:"green"}],edges:[{id:"source-result",from:"source",to:"result"}]};function hostAdmissionOptions(dependencies){return dependencies.hostResourceCoordinator===undefined?{}:{hostResourceCoordinator:dependencies.hostResourceCoordinator}}function canonicalArguments(args){const[surface,subcommand,...rest]=args;if(surface==="diagram"){if(subcommand==="init"||subcommand==="check"||subcommand==="render"){return[subcommand,...rest]}throw new Error("Use slopcamera diagram init, check, or render")}if(surface==="image"){if(subcommand==="vectorize"||subcommand==="generate"||subcommand==="icon"||subcommand==="gallery"){return[subcommand,...rest]}throw new Error("Use slopcamera image vectorize, generate, icon, or gallery")}if(surface==="init"||surface==="check"||surface==="render"||surface==="vectorize"||surface==="generate"){throw new Error(`The flat \`${surface}\` command moved to a namespaced Slopcamera surface.
+`;function parseArguments(args,valueOptions){const positionals=[];const options={};const flags=new Set;for(let index=0;index<args.length;index+=1){const argument=args[index];if(argument===undefined)continue;if(!argument.startsWith("--")){positionals.push(argument);continue}const name=argument.slice(2);if(!valueOptions.has(name)){flags.add(name);continue}const value=args[index+1];if(value===undefined||value.startsWith("--")){throw new Error(`--${name} requires a value`)}options[name]=value;index+=1}return{positionals,options,flags}}function requiredPositional(parsed,index,label){const value=parsed.positionals[index];if(value===undefined)throw new Error(`Missing ${label}`);return value}function requiredOption(parsed,name){const value=parsed.options[name];if(value===undefined)throw new Error(`--${name} is required`);return value}function parsePositiveInteger(value,name){if(value===undefined)return;const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<1){throw new Error(`--${name} must be a positive integer`)}return parsed}function parseDuotone(value){if(value===undefined)return;const colors=value.split(",").map((color)=>color.trim());if(colors.length!==2||colors.some((color)=>!/^#[a-f0-9]{3}(?:[a-f0-9]{3})?$/iu.test(color))){throw new Error("--duotone must contain two #rgb or #rrggbb colors separated by a comma")}return[colors[0],colors[1]]}function parseGalleryVary(value){if(value===undefined)return;return parseSlopcameraGalleryVary(value)}async function readGalleryCandidates(path){const text=await readFile(resolve(path),"utf8");if(Buffer.byteLength(text,"utf8")>64*1024){throw new Error("--candidates JSON must be no more than 65536 UTF-8 bytes")}try{return JSON.parse(text)}catch{throw new Error("--candidates must be valid JSON")}}function printFindings(findings){if(findings.length===0){console.log("No diagram lint findings.");return}console.warn(`${findings.length} diagram lint finding${findings.length===1?"":"s"}:`);for(const finding of findings){console.warn(`  [${finding.code}] ${finding.message}`)}}var starter={$schema:"https://raw.githubusercontent.com/hraness/slopcamera/main/schema/diagram.schema.json",version:1,name:"example-flow",canvas:{width:960,height:540,padding:64},layout:{type:"stack",direction:"horizontal",gap:160,align:"center"},shapes:[{id:"source",type:"rect",width:240,height:160,label:"Source",icon:"document",tone:"blue"},{id:"result",type:"rect",width:240,height:160,label:"Result",icon:"check",tone:"green"}],edges:[{id:"source-result",from:"source",to:"result"}]};function hostAdmissionOptions(dependencies){return dependencies.hostResourceCoordinator===undefined?{}:{hostResourceCoordinator:dependencies.hostResourceCoordinator}}async function runDrawingSheets(args,dependencies){const[command,...rest]=args;if(command!=="init"&&command!=="check"&&command!=="render"){throw new Error("Use slopcamera diagram sheets init, check, or render <file.drawing.json>")}const positionals=[];const seen=new Set;let outDirectory;let json=false;for(let index=0;index<rest.length;index+=1){const argument=rest[index];if(!argument.startsWith("-")){positionals.push(argument);continue}if(argument!=="--json"&&!(command==="render"&&argument==="--out-dir")){throw new Error(`Unknown diagram sheets ${command} option: ${argument}`)}if(seen.has(argument))throw new Error(`${argument} may be supplied at most once`);seen.add(argument);if(argument==="--json"){json=true}else{const value=rest[index+1];if(value===undefined||value.startsWith("-")||value.trim().length===0){throw new Error("--out-dir requires a directory")}outDirectory=value;index+=1}}if(positionals.length!==1||positionals[0].trim().length===0){throw new Error(`slopcamera diagram sheets ${command} requires exactly one drawing file`)}const filePath=resolve(positionals[0]);if(!filePath.endsWith(".drawing.json"))throw new Error("Drawing source must end in .drawing.json");const log=dependencies.log??console.log;if(command==="init"){try{await writeFile(filePath,`${JSON.stringify(starterDrawingSource(),null,2)}
+`,{flag:"wx"})}catch(error){if(error instanceof Error&&"code"in error&&error.code==="EEXIST"){throw new Error(`Refusing to overwrite existing file: ${filePath}`)}throw error}log(json?JSON.stringify({command:"diagram.sheets.init",source:filePath}):`Created ${filePath}`);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="check"){const checks=await withSlopcameraOperationHostAdmission("slopcamera.diagram.check",async()=>await checkDrawingFile({filePath}),hostAdmissionOptions(dependencies));log(json?JSON.stringify({command:"diagram.sheets.check",source:filePath,...checks}):`Valid drawing: ${checks.sheetCount} sheet${checks.sheetCount===1?"":"s"} (${checks.paper}, ${checks.profile}).`);return}const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.render",async()=>await renderDrawingFile({filePath,...outDirectory===undefined?{}:{outDirectory}}),hostAdmissionOptions(dependencies));log(json?JSON.stringify({command:"diagram.sheets.render",artifacts:result.artifacts,checks:result.checks}):[result.artifacts.pdf,...result.artifacts.sheets,result.artifacts.receipt].join(`
+`));reportUsefulResult(dependencies.onUsefulResult)}function canonicalArguments(args){const[surface,subcommand,...rest]=args;if(surface==="diagram"){if(subcommand==="init"||subcommand==="check"||subcommand==="render"){return[subcommand,...rest]}throw new Error("Use slopcamera diagram init, check, render, or sheets")}if(surface==="image"){if(subcommand==="vectorize"||subcommand==="generate"||subcommand==="icon"||subcommand==="gallery"){return[subcommand,...rest]}throw new Error("Use slopcamera image vectorize, generate, icon, or gallery")}if(surface==="init"||surface==="check"||surface==="render"||surface==="vectorize"||surface==="generate"){throw new Error(`The flat \`${surface}\` command moved to a namespaced Slopcamera surface.
 
-${help}`)}return args}async function main(args,dependencies={}){if(args[0]==="support"){process.exitCode=await runProductSupportCommand(args.slice(1),dependencies.supportEnvironment===undefined?{}:{env:dependencies.supportEnvironment});return}const[command,...rest]=canonicalArguments(args);if(command===undefined||command==="help"||command==="--help"||command==="-h"){console.log(help);return}if(command==="version"||command==="--version"||command==="-v"){console.log(slopcameraCliVersion);return}if(command==="init"){const parsed=parseArguments(rest,new Set);const filePath=resolve(parsed.positionals[0]??"diagram.diagram.json");if(await pathExists(filePath))throw new Error(`Refusing to overwrite existing file: ${filePath}`);await writeFile(filePath,`${JSON.stringify(starter,null,2)}
+${help}`)}return args}async function main(args,dependencies={}){if(args[0]==="diagram"&&args[1]==="sheets"){await runDrawingSheets(args.slice(2),dependencies);return}if(args[0]==="support"){process.exitCode=await runProductSupportCommand(args.slice(1),dependencies.supportEnvironment===undefined?{}:{env:dependencies.supportEnvironment});return}const[command,...rest]=canonicalArguments(args);if(command===undefined||command==="help"||command==="--help"||command==="-h"){console.log(help);return}if(command==="version"||command==="--version"||command==="-v"){console.log(slopcameraCliVersion);return}if(command==="init"){const parsed=parseArguments(rest,new Set);const filePath=resolve(parsed.positionals[0]??"diagram.diagram.json");if(await pathExists(filePath))throw new Error(`Refusing to overwrite existing file: ${filePath}`);await writeFile(filePath,`${JSON.stringify(starter,null,2)}
 `);console.log(`Created ${filePath}`);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="check"){const parsed=parseArguments(rest,new Set(["config"]));const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.check",async()=>await checkDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options.config===undefined?{}:{configPath:parsed.options.config}}),hostAdmissionOptions(dependencies));console.log(`Valid diagram${result.configPath===null?"":` with ${result.configPath}`}.`);printFindings(result.findings);if(parsed.flags.has("strict")&&result.findings.length>0)process.exitCode=2;return}if(command==="render"){const parsed=parseArguments(rest,new Set(["out-dir","config","scale"]));const scale=parsed.options.scale===undefined?undefined:Number.parseFloat(parsed.options.scale);const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.render",async()=>await renderDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options["out-dir"]===undefined?{}:{outDirectory:parsed.options["out-dir"]},...parsed.options.config===undefined?{}:{configPath:parsed.options.config},...scale===undefined?{}:{scale}}),hostAdmissionOptions(dependencies));console.log(artifactSummary(result.artifacts));printFindings(result.findings);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="vectorize"){const parsed=parseArguments(rest,new Set(["output","duotone","alpha-cutoff","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown vectorize option: --${unknownFlags[0]}`)}if(parsed.positionals.length>1){throw new Error("slopcamera image vectorize accepts exactly one raster input")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const alphaCutoff=parsePositiveInteger(parsed.options["alpha-cutoff"],"alpha-cutoff");const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const duotone=parseDuotone(parsed.options.duotone);const result=await withSlopcameraOperationHostAdmission("slopcamera.image.vectorize",async(lease)=>await(dependencies.vectorize??vectorizeImage)(requiredPositional(parsed,0,"raster image"),{...alphaCutoff===undefined?{}:{alphaCutoff},...duotone===undefined?{}:{duotone},...timeoutMs===undefined?{}:{limits:{maxDurationMs:timeoutMs}},inheritedFileDescriptors:[lease.inheritedFileDescriptor],outputPath:output}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify({...result.receipt,outputPath:result.outputPath},null,2))}else{(dependencies.log??console.log)(`Vectorized ${result.receipt.width}\xD7${result.receipt.height} with `+`${result.receipt.profile}/${result.receipt.representation}: ${result.outputPath}`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="generate"){const parsed=parseArguments(rest,new Set(["model","output"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown generate option: --${unknownFlags[0]}`)}if(parsed.positionals.length!==1){throw new Error("slopcamera image generate accepts exactly one prompt")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.generate",async()=>await(dependencies.generate??generateSlopcameraImageFile)({model,prompt:requiredPositional(parsed,0,"prompt"),outputPath:requiredOption(parsed,"output")}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{(dependencies.log??console.log)(`Generated ${result.mediaType} with ${result.model}: ${result.outputPath} (${result.bytes} bytes, request ${result.requestId})`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="icon"){const parsed=parseArguments(rest,new Set(["model","output","ink","purpose","rounds","critique-model"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="keep-raster");if(unknownFlags.length>0){throw new Error(`Unknown icon option: --${unknownFlags[0]}`)}if(parsed.positionals.length!==1){throw new Error("slopcamera image icon accepts exactly one subject")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const critiqueModel=parsed.options["critique-model"];if(critiqueModel!==undefined&&(critiqueModel.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(critiqueModel))){throw new Error("--critique-model must be a bounded Vercel AI Gateway provider/model id")}const ink=parsed.options.ink;if(ink!==undefined&&!/^#[a-f0-9]{3}(?:[a-f0-9]{3})?$/iu.test(ink)){throw new Error("--ink must be a #rgb or #rrggbb color")}const purpose=parsed.options.purpose;if(purpose!==undefined&&purpose!=="mark"&&purpose!=="illustration"){throw new Error("--purpose must be mark or illustration")}const rounds=parsePositiveInteger(parsed.options.rounds,"rounds");if(rounds!==undefined&&rounds>slopcameraIconMaximumRounds){throw new Error(`--rounds must be at most ${slopcameraIconMaximumRounds}`)}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.icon",async(lease)=>await(dependencies.icon??generateSlopcameraIcon)({keepRaster:parsed.flags.has("keep-raster"),model,outputPath:output,subject:requiredPositional(parsed,0,"subject"),inheritedFileDescriptors:[lease.inheritedFileDescriptor],...critiqueModel===undefined?{}:{critiqueModel},...ink===undefined?{}:{ink},...purpose===undefined?{}:{purpose},...rounds===undefined?{}:{rounds}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const scored=result.attempts.map((attempt)=>attempt.score===undefined?`#${attempt.round}`:`#${attempt.round}=${attempt.score}`).join(" ");(dependencies.log??console.log)(`Icon ${result.svgSha256.slice(0,12)} round ${result.selectedRound}/${result.attempts.length} (${scored}): ${result.outputPath}`)}return}if(command==="gallery"){const parsed=parseArguments(rest,new Set(["model","output-dir","kind","count","vary","candidates","cell","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="tile"&&flag!=="no-tile");if(unknownFlags.length>0){throw new Error(`Unknown gallery option: --${unknownFlags[0]}`)}if(parsed.flags.has("tile")&&parsed.flags.has("no-tile")){throw new Error("--tile and --no-tile are mutually exclusive")}if(parsed.positionals.length!==1){throw new Error("slopcamera image gallery accepts exactly one subject")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const kind=parsed.options.kind;if(kind!==undefined&&!slopcameraGalleryKinds.includes(kind)){throw new Error(`--kind must be one of: ${slopcameraGalleryKinds.join(", ")}`)}const count=parsePositiveInteger(parsed.options.count,"count");if(count!==undefined&&count>slopcameraGalleryLimits.candidates){throw new Error(`--count must be at most ${slopcameraGalleryLimits.candidates}`)}const cell=parsePositiveInteger(parsed.options.cell,"cell");if(cell!==undefined&&(cell<slopcameraGalleryLimits.cellEdgeMin||cell>slopcameraGalleryLimits.cellEdgeMax)){throw new Error(`--cell must be between ${slopcameraGalleryLimits.cellEdgeMin} and ${slopcameraGalleryLimits.cellEdgeMax}`)}const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const vary=parseGalleryVary(parsed.options.vary);const candidates=parsed.options.candidates===undefined?undefined:await readGalleryCandidates(parsed.options.candidates);if(candidates!==undefined&&!Array.isArray(candidates)){throw new Error("--candidates JSON must be an array of {id, prompt|variant} entries")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.gallery",async()=>await(dependencies.gallery??generateSlopcameraImageGallery)({subject:requiredPositional(parsed,0,"subject"),outputDir:requiredOption(parsed,"output-dir"),model,...kind===undefined?{}:{kind},...count===undefined?{}:{count},...vary===undefined?{}:{vary},...candidates===undefined?{}:{candidates},...cell===undefined?{}:{cellEdge:cell},...timeoutMs===undefined?{}:{timeoutMs},...parsed.flags.has("tile")?{tiled:true}:parsed.flags.has("no-tile")?{tiled:false}:{}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const rows=result.candidates.map((candidate)=>candidate.status==="generated"?`#${candidate.index} ${candidate.id}	${candidate.path}`:`#${candidate.index} ${candidate.id}	failed`);(dependencies.log??console.log)(`Gallery ${result.counts.generated}/${result.counts.requested} generated (${result.model}): ${result.gallery.path}
 `+`${rows.join(`
 `)}

package/dist/index-11cb717y.js

@@ -0,0 +1,28 @@
+// @bun
+import{bundledSkillPath,installSkill,pathExists}from"./index-grk47tgs.js";import{SPATIAL_AUDIT_LIMITS,SPATIAL_SCENE_LIMITS,SPATIAL_TEMPORAL_AUDIT_LIMITS,SpatialBehaviorBakeSchema,SpatialDigestSchema,SpatialGalleryAxisSchema,SpatialPatchOperationSchema,SpatialSceneError,SpatialTemporalContactsFileSchema,applySpatialScenePatch,auditSpatialBehaviorTrace,auditSpatialScene,auditSpatialTemporalEvidence,checkSpatialBehavior,checkSpatialDirection,checkSpatialRenderEffects,compileSpatialDirection,createSpatialEvaluationContext,diffSpatialScenes,evaluateSpatialScene,evaluateSpatialSceneInContext,inspectSpatialScene,normalizeSpatialAuditAssetBounds,parseSpatialScene,parseSpatialValue,planSpatialDirectionGallery,planSpatialRenderEffects,spatialBehaviorFnSignatures,spatialSceneSha256,spatialValueSha256}from"./index-z1kd1x8j.js";import{PORTABLE_SLOPCAMERA_OPERATION_CONTRACTS,PORTABLE_SLOPCAMERA_OPERATION_KINDS,SlopcameraCodeError,boundedCanonicalJsonSha256,canonicalJson,canonicalJsonSha256,compareUtf16Strings,createBoundedJsonValueSnapshot,deepFreezeJson}from"./index-3cxf2c58.js";import{SlopcameraWorkflowError,defineSlopcameraWorkflow,runSlopcameraWorkflow}from"./index-qtn3s421.js";import{DiagramValidationError,NebulaSans_Bold_default,NebulaSans_Book_default,SlopcameraOperationError,StackLayoutError,builtInIcons,executeSlopcameraOperation,generateSlopcameraIcon,generateSlopcameraImageGallery,layoutBoxContent,lintDiagram,parseDiagramSource,parseDiagramSpec,parseSlopcameraOperationInput,renderPng,renderSvg,resolveDiagramSource,resolveEdge,resolveStackLayout,sanitizeIcon,searchSlopcameraOperations,serializeTldr,slopcameraOperationCodes,slopcameraOperationRegistry,stackLayoutDefaults,withSlopcameraOperationHostAdmission}from"./index-sy1n4zfy.js";import{VectorizeError,vectorizeHardLimits,vectorizeImage}from"./index-qry58nj2.js";import{SlopcameraCloudError,generateSlopcameraImage,generateSlopcameraImageFile,slopcameraGatewayCredentialStatus}from"./index-77fjfg9f.js";import{HostResourceError,createDefaultHostResourceCoordinator}from"./index-b3geqczn.js";import{mkdir,readFile as readFile2,rename,rm,writeFile}from"fs/promises";import{basename,dirname as dirname2,join,resolve as resolve2}from"path";import{readFile}from"fs/promises";import{dirname,extname,isAbsolute,resolve}from"path";import{pathToFileURL}from"url";var configNames=[{current:"slopcamera.config.ts",retired:"diagram.config.ts"},{current:"slopcamera.config.mjs",retired:"diagram.config.mjs"},{current:"slopcamera.config.js",retired:"diagram.config.js"},{current:"slopcamera.config.json",retired:"diagram.config.json"}];function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function parseFont(value,at){if(!isRecord(value)||typeof value.family!=="string"||value.family.trim()===""){throw new Error(`${at} must have a non-empty family`)}if(value.files!==undefined&&!Array.isArray(value.files)){throw new Error(`${at}.files must be an array`)}if(value.monoFamily!==undefined&&(typeof value.monoFamily!=="string"||value.monoFamily.trim()==="")){throw new Error(`${at}.monoFamily must be a non-empty string when present`)}const files=(value.files??[]).map((file,index)=>{if(!isRecord(file)||typeof file.path!=="string"||file.path.trim()===""){throw new Error(`${at}.files[${index}].path must be a non-empty string`)}if(file.weight!==undefined&&(typeof file.weight!=="number"||!Number.isFinite(file.weight))){throw new Error(`${at}.files[${index}].weight must be a finite number`)}if(file.style!==undefined&&file.style!=="normal"&&file.style!=="italic"){throw new Error(`${at}.files[${index}].style must be normal or italic`)}if(file.embed!==undefined&&typeof file.embed!=="boolean"){throw new Error(`${at}.files[${index}].embed must be a boolean`)}const style=file.style;return{path:file.path,...file.weight===undefined?{}:{weight:file.weight},...style===undefined?{}:{style},...file.embed===undefined?{}:{embed:file.embed}}});return{family:value.family,...value.monoFamily===undefined?{}:{monoFamily:value.monoFamily},...files.length===0?{}:{files}}}function parseIcons(value,at){if(!isRecord(value))throw new Error(`${at} must be an object`);return Object.fromEntries(Object.entries(value).map(([name,icon])=>{if(!isRecord(icon)||typeof icon.viewBox!=="string"||typeof icon.body!=="string"){throw new Error(`${at}.${name} must have string viewBox and body fields`)}return[name,sanitizeIcon({viewBox:icon.viewBox,body:icon.body})]}))}function parseTheme(value,at){if(!isRecord(value))throw new Error(`${at} must be an object`);const scalarKeys=["background","foreground","muted","stroke"];for(const key of scalarKeys){if(value[key]!==undefined&&typeof value[key]!=="string"){throw new Error(`${at}.${key} must be a CSS color string`)}}if(value.tones!==undefined&&!isRecord(value.tones)){throw new Error(`${at}.tones must be an object`)}return value}function parseConfig(value){if(!isRecord(value))throw new Error("Slopcamera config must export an object");const font=value.font===undefined?undefined:parseFont(value.font,"font");const icons=value.icons===undefined?undefined:parseIcons(value.icons,"icons");let theme;if(value.theme!==undefined){if(!isRecord(value.theme))throw new Error("theme must be an object");theme={...value.theme.light===undefined?{}:{light:parseTheme(value.theme.light,"theme.light")},...value.theme.dark===undefined?{}:{dark:parseTheme(value.theme.dark,"theme.dark")}}}return{...font===undefined?{}:{font},...icons===undefined?{}:{icons:{...builtInIcons,...icons}},...theme===undefined?{}:{theme}}}async function discoverConfig(directory){let current=null;for(const names of configNames){const candidate=resolve(directory,names.current);if(await pathExists(candidate)){current=candidate;break}}if(current!==null)return current;for(const names of configNames){const candidate=resolve(directory,names.retired);if(await pathExists(candidate)){const replacement=resolve(directory,names.current);throw new Error(`Legacy Slopcamera config found at ${candidate}. Rename it to ${replacement}; Slopcamera does not auto-load diagram.config.*.`)}}return null}async function loadDiagramConfig(options){const filePath=options.explicitPath===undefined?await discoverConfig(options.searchDirectory):resolve(options.explicitPath);if(filePath===null){return{filePath:null,baseDirectory:options.searchDirectory,value:{icons:builtInIcons}}}if(!await pathExists(filePath))throw new Error(`Config does not exist: ${filePath}`);const raw=extname(filePath)===".json"?JSON.parse(await readFile(filePath,"utf8")):(await import(`${pathToFileURL(filePath).href}?v=${Date.now()}`)).default;const value=parseConfig(raw);const baseDirectory=dirname(filePath);const font=value.font===undefined?undefined:{...value.font,...value.font.files===undefined?{}:{files:value.font.files.map((file)=>({...file,path:isAbsolute(file.path)?file.path:resolve(baseDirectory,file.path)}))}};return{filePath,baseDirectory,value:{...value,icons:{...builtInIcons,...value.icons},...font===undefined?{}:{font}}}}async function atomicWrite(filePath,data){const temporary=`${filePath}.tmp-${process.pid}-${crypto.randomUUID()}`;try{await writeFile(temporary,data);await rename(temporary,filePath)}catch(error){await rm(temporary,{force:true});throw error}}async function readDiagramFile(filePath){const absolutePath=resolve2(filePath);let parsed;try{parsed=JSON.parse(await readFile2(absolutePath,"utf8"))}catch(error){throw new Error(`Could not read diagram JSON at ${absolutePath}`,{cause:error})}return{absolutePath,spec:parseDiagramSpec(parsed)}}async function checkDiagramFile(options){const{absolutePath,spec}=await readDiagramFile(options.filePath);const config=await loadDiagramConfig({...options.configPath===undefined?{}:{explicitPath:options.configPath},searchDirectory:dirname2(absolutePath)});for(const shape of spec.shapes){if((shape.type==="rect"||shape.type==="ellipse")&&shape.icon!==undefined&&config.value.icons?.[shape.icon]===undefined){throw new Error(`Unknown icon "${shape.icon}" on shape ${shape.id}`)}}return{findings:lintDiagram(spec),configPath:config.filePath}}async function renderDiagramFile(options){const{absolutePath,spec}=await readDiagramFile(options.filePath);const outDirectory=resolve2(options.outDirectory??dirname2(absolutePath));const config=await loadDiagramConfig({...options.configPath===undefined?{}:{explicitPath:options.configPath},searchDirectory:dirname2(absolutePath)});const scale=options.scale??2;if(!Number.isFinite(scale)||scale<=0||scale>8){throw new Error("PNG scale must be greater than zero and no more than 8")}const[light,dark]=await Promise.all([renderSvg(spec,"light",config.value),renderSvg(spec,"dark",config.value)]);const[lightPng,darkPng]=[renderPng(light,config.value,scale),renderPng(dark,config.value,scale)];const artifacts={spec:absolutePath,tldr:join(outDirectory,`${spec.name}.tldr`),lightSvg:join(outDirectory,`${spec.name}.light.svg`),darkSvg:join(outDirectory,`${spec.name}.dark.svg`),lightPng:join(outDirectory,`${spec.name}.light.png`),darkPng:join(outDirectory,`${spec.name}.dark.png`)};await mkdir(outDirectory,{recursive:true});await Promise.all([atomicWrite(artifacts.tldr,serializeTldr(spec,config.value)),atomicWrite(artifacts.lightSvg,light.svg),atomicWrite(artifacts.darkSvg,dark.svg),atomicWrite(artifacts.lightPng,lightPng),atomicWrite(artifacts.darkPng,darkPng)]);return{artifacts,findings:lintDiagram(spec),configPath:config.filePath}}function artifactSummary(artifacts){return[`Rendered ${basename(artifacts.spec)}`,`  ${artifacts.tldr}`,`  ${artifacts.lightSvg}`,`  ${artifacts.darkSvg}`,`  ${artifacts.lightPng}`,`  ${artifacts.darkPng}`].join(`
+`)}import{createHash}from"crypto";import{constants}from"fs";import{mkdir as mkdir2,open,rename as rename2,rm as rm2,writeFile as writeFile2}from"fs/promises";import{dirname as dirname3,isAbsolute as isAbsolute2,join as join2,resolve as resolve3}from"path";import{fileURLToPath}from"url";import{Resvg}from"@resvg/resvg-js";function fail(message){throw new Error(`Unsupported drawing SVG: ${message}`)}var maximumSvgBytes=2*1024*1024;function attributes(value){const attrs={};let rest=value;while(rest.trim().length>0){const match=/^\s+([A-Za-z][A-Za-z0-9:-]*)="([^"<>]*)"/u.exec(rest);if(match===null)fail("malformed attribute");const name=match[1];if(Object.hasOwn(attrs,name))fail("duplicate attribute");attrs[name]=match[2];rest=rest.slice(match[0].length)}return attrs}function parseSvg(svg){if(Buffer.byteLength(svg)>maximumSvgBytes)fail("sheet exceeds byte limit");const roots=[];const stack=[];let cursor=0;let count=0;for(const token of svg.matchAll(/<[^>]*>/gu)){if(svg.slice(cursor,token.index).trim()!=="")fail("text outside a path");cursor=token.index+token[0].length;const raw=token[0];const closing=/^<\/([A-Za-z]+)>$/u.exec(raw);if(closing!==null){if(stack.pop()?.tag!==closing[1])fail("unbalanced tags");continue}const match=/^<([A-Za-z]+)([\s\S]*?)(\/?)>$/u.exec(raw);if(match===null)fail("unsupported markup");const tag=match[1];if(!["svg","defs","clipPath","g","path"].includes(tag))fail(`element ${tag}`);if(++count>50000||stack.length>32)fail("tree limit exceeded");const node={tag,attrs:attributes(match[2]),children:[]};const parent=stack.at(-1);if(parent===undefined)roots.push(node);else parent.children.push(node);if(match[3]!=="/")stack.push(node)}if(svg.slice(cursor).trim()!==""||stack.length!==0||roots.length!==1||roots[0]?.tag!=="svg")fail("invalid document");return roots[0]}function only(node,allowed){for(const key of Object.keys(node.attrs))if(!allowed.includes(key))fail(`${node.tag}.${key}`)}function number(value){if(!/^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/u.test(value))fail("invalid number");const parsed=Number(value);if(!Number.isFinite(parsed)||Math.abs(parsed)>1e7)fail("number outside bounds");return parsed}var decimal=(value)=>Number(value.toFixed(6)).toString();function pathCommands(data){const tokens=data.match(/[MLCQZ]|[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/gu)??[];if(data.replace(/[MLCQZ]|[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?|[\s,]/gu,"")!=="")fail("path command");if(tokens.length>500000)fail("path limit");const result=[];let cursor=0;let x=0;let y=0;let startX=0;let startY=0;const take=()=>{const token=tokens[cursor++];if(token===undefined)fail("truncated path");return number(token)};while(cursor<tokens.length){const command=tokens[cursor++];if(command==="M"||command==="L"){x=take();y=take();if(command==="M"){startX=x;startY=y}result.push(`${decimal(x)} ${decimal(y)} ${command==="M"?"m":"l"}`)}else if(command==="C"){const values=[take(),take(),take(),take(),take(),take()];x=values[4];y=values[5];result.push(`${values.map(decimal).join(" ")} c`)}else if(command==="Q"){const qx=take();const qy=take();const nextX=take();const nextY=take();result.push(`${[x+2*(qx-x)/3,y+2*(qy-y)/3,nextX+2*(qx-nextX)/3,nextY+2*(qy-nextY)/3,nextX,nextY].map(decimal).join(" ")} c`);x=nextX;y=nextY}else if(command==="Z"){result.push("h");x=startX;y=startY}else fail("non-absolute path command")}return result.join(`
+`)}function color(value){if(value==="none")return;if(value===undefined||value==="#000000")return"0";if(value==="#ffffff")return"1";return fail("non-monochrome paint")}function svgStream(svg,width,height){const root=parseSvg(svg);only(root,["width","height","viewBox","xmlns"]);if(number((root.attrs.width??"").replace(/pt$/u,""))!==width||number((root.attrs.height??"").replace(/pt$/u,""))!==height||root.attrs.viewBox!==`0 0 ${width} ${height}`||root.attrs.xmlns!=="http://www.w3.org/2000/svg")fail("page geometry");const clips=new Map;for(const defs of root.children.filter((node)=>node.tag==="defs")){only(defs,[]);for(const clip of defs.children){only(clip,["id"]);if(clip.tag!=="clipPath"||clip.attrs.id===undefined||clips.has(clip.attrs.id)||clip.children.some((child)=>child.tag!=="path"))fail("clip definition");clips.set(clip.attrs.id,clip)}}const output=[`q
+1 0 0 -1 0 ${decimal(height)} cm`];const emit=(node)=>{if(node.tag==="defs")return;if(node.tag==="g"){only(node,["transform","clip-path"]);output.push("q");if(node.attrs.transform!==undefined){const match=/^matrix\(([^)]+)\)$/u.exec(node.attrs.transform);if(match===null)fail("transform");const values=match[1].trim().split(/[\s,]+/u).map(number);if(values.length!==6)fail("matrix");output.push(`${values.map(decimal).join(" ")} cm`)}if(node.attrs["clip-path"]!==undefined){const id=/^url\(#([A-Za-z0-9_-]+)\)$/u.exec(node.attrs["clip-path"])?.[1];const clip=id===undefined?undefined:clips.get(id);if(clip===undefined)fail("missing clip");for(const path2 of clip.children){only(path2,["d","fill","stroke","fill-rule","clip-rule"]);if(path2.children.length>0)fail("path children");output.push(pathCommands(path2.attrs.d??""))}const rules=new Set(clip.children.map((path2)=>path2.attrs["clip-rule"]??path2.attrs["fill-rule"]??"nonzero"));if(rules.size!==1||!["nonzero","evenodd"].includes([...rules][0]))fail("clip rule");output.push(rules.has("evenodd")?"W* n":"W n")}node.children.forEach(emit);output.push("Q");return}if(node.tag!=="path")fail("nested non-path element");only(node,["d","fill","stroke","stroke-width","stroke-linecap","stroke-linejoin","stroke-miterlimit","fill-rule","paint-order"]);if(node.children.length>0)fail("path children");const fill=color(node.attrs.fill);const stroke=color(node.attrs.stroke??"none");const cap=["butt","round","square"].indexOf(node.attrs["stroke-linecap"]??"butt");const join2=["miter","round","bevel"].indexOf(node.attrs["stroke-linejoin"]??"miter");const strokeWidth=number(node.attrs["stroke-width"]??"1");const miter=number(node.attrs["stroke-miterlimit"]??"4");if(cap<0||join2<0||strokeWidth<=0||miter<1)fail("stroke style");const rule=node.attrs["fill-rule"]??"nonzero";if(rule!=="nonzero"&&rule!=="evenodd")fail("fill rule");const paintOrder=node.attrs["paint-order"]??"normal";if(!["normal","stroke","stroke fill","fill stroke","stroke fill markers","fill stroke markers"].includes(paintOrder))fail("paint order");output.push("q",`${strokeWidth} w`,`${cap} J`,`${join2} j`,`${miter} M`);if(fill!==undefined)output.push(`${fill} g`);if(stroke!==undefined)output.push(`${stroke} G`);const path=pathCommands(node.attrs.d??"");const fillOperator=rule==="evenodd"?"f*":"f";if(paintOrder.startsWith("stroke")&&stroke!==undefined&&fill!==undefined)output.push(path,"S",path,fillOperator);else output.push(path,fill===undefined?stroke===undefined?"n":"S":stroke===undefined?fillOperator:rule==="evenodd"?"B*":"B");output.push("Q")};root.children.forEach(emit);output.push("Q");return output.join(`
+`)}var pdfString=(value)=>`<FEFF${Buffer.from(value,"utf16le").swap16().toString("hex")}>`;function drawingSheetsPdf(sheets,metadata){if(sheets.length<1||sheets.length>20||!/^[a-f0-9]{64}$/u.test(metadata.sourceSha256))throw new Error("Invalid drawing PDF input");const objects=["",""];const pages=[];for(const sheet of sheets){const stream=svgStream(sheet.svg,sheet.width,sheet.height);const streamId=objects.push(`<< /Length ${Buffer.byteLength(stream)} >>
+stream
+${stream}
+endstream`);pages.push(objects.push(`<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${decimal(sheet.width)} ${decimal(sheet.height)}] /Resources << >> /Contents ${streamId} 0 R >>`))}objects[0]="<< /Type /Catalog /Pages 2 0 R >>";objects[1]=`<< /Type /Pages /Count ${pages.length} /Kids [${pages.map((id)=>`${id} 0 R`).join(" ")}] >>`;const infoId=objects.push(`<< /Title ${pdfString(metadata.title)} /Producer ${pdfString(`Slopcamera ${metadata.rendererVersion}`)} /Subject ${pdfString(`source-sha256:${metadata.sourceSha256}; profile:patent-line-art-v1`)} >>`);const chunks=[`%PDF-1.7
+%Slopcamera vector drawings
+`];const offsets=[0];let offset=Buffer.byteLength(chunks[0]);for(const[index,object]of objects.entries()){offsets.push(offset);const chunk=`${index+1} 0 obj
+${object}
+endobj
+`;chunks.push(chunk);offset+=Buffer.byteLength(chunk)}const freeEntry="0000000000 65535 f".padEnd(19," ")+`
+`;const usedEntries=offsets.slice(1).map((value)=>`${String(value).padStart(10,"0")} 00000 n`.padEnd(19," ")+`
+`).join("");chunks.push(`xref
+0 ${objects.length+1}
+${freeEntry}${usedEntries}trailer
+<< /Size ${objects.length+1} /Root 1 0 R /Info ${infoId} 0 R >>
+startxref
+${offset}
+%%EOF
+`);const bytes=Buffer.from(chunks.join(""));if(bytes.length>32*1024*1024)throw new Error("Drawing PDF exceeds output byte limit");return bytes}var SLOPCAMERA_VERSION="3.3.5";var drawingProfile="patent-line-art-v1";var drawingSourceByteLimit=1024*1024;var drawingMinimumGlyphHeightPt=3.2*72/25.4;class DrawingValidationError extends Error{constructor(message){super(`Invalid drawing source: ${message}`);this.name="DrawingValidationError"}}function fail2(message){throw new DrawingValidationError(message)}var sha256=(value)=>createHash("sha256").update(value).digest("hex");var assetPath=(asset)=>isAbsolute2(asset)?asset:fileURLToPath(new URL(asset,import.meta.url));var fontFiles=[assetPath(NebulaSans_Book_default),assetPath(NebulaSans_Bold_default)];var monochrome={background:"#ffffff",foreground:"#000000",muted:"#000000",stroke:"#000000",tones:Object.fromEntries(["neutral","blue","orange","green","red","purple","yellow"].map((tone)=>[tone,{fill:"#ffffff",stroke:"#000000",text:"#000000"}]))};var config={font:{family:"Nebula Sans",files:[{path:fontFiles[0],weight:400},{path:fontFiles[1],weight:700}]},theme:{light:monochrome}};var escapeXml=(value)=>value.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;");function drawingPageGeometry(paper){if(paper!=="us-letter"&&paper!=="a4")fail2("paper must be us-letter or a4");const width=paper==="us-letter"?612:210*72/25.4;const height=paper==="us-letter"?792:297*72/25.4;const margins={left:25*72/25.4,top:25*72/25.4,right:15*72/25.4,bottom:10*72/25.4};return{width,height,margins,numberingHeight:30,body:{x:margins.left,y:margins.top+30,width:width-margins.left-margins.right,height:height-margins.top-margins.bottom-60}}}function record(value,keys,at){if(typeof value!=="object"||value===null||Array.isArray(value))fail2(`${at} must be an object`);const result=value;for(const key of Object.keys(result))if(!keys.includes(key))fail2(`${at}.${key} is unsupported`);return result}function checkDiagramEnvelope(value){const diagram=record(value,["$schema","version","name","canvas","layout","shapes","edges"],"diagram");const bounded=(object)=>{for(const value2 of Object.values(object)){if(typeof value2==="number"&&(!Number.isFinite(value2)||Math.abs(value2)>1e4))fail2("numeric drawing values must be finite and within 10000 points");if(typeof value2==="string"&&value2.length>1024)fail2("drawing strings exceed the bounded text limit")}};bounded(diagram);bounded(record(diagram.canvas,["width","height","padding"],"canvas"));if(diagram.layout!==undefined)bounded(record(diagram.layout,["type","direction","gap","align"],"layout"));if(!Array.isArray(diagram.shapes)||diagram.shapes.length<1||diagram.shapes.length>100)fail2("each sheet needs 1 to 100 shapes");for(const value2 of diagram.shapes){const shape=record(value2,["id","type","x","y","tone","opacity","width","height","radius","icon","iconSize","strokeWidth","fill","label","labelFontSize","labelFontFamily","labelWeight","labelRows","labelRowGap","text","fontSize","fontFamily","weight","align","x2","y2"],"shape");bounded(shape);const common=["id","type","x","y","tone","opacity"];const extras=shape.type==="text"?["text","width","fontSize","fontFamily","weight","align"]:shape.type==="line"?["x2","y2","strokeWidth"]:["width","height","radius","icon","iconSize","strokeWidth","fill","label","labelFontSize","labelFontFamily","labelWeight","labelRows","labelRowGap"];record(value2,[...common,...extras],"shape");if(shape.labelRows!==undefined){if(!Array.isArray(shape.labelRows)||shape.labelRows.length>4)fail2("labelRows must be bounded");for(const row of shape.labelRows)bounded(record(row,["text","fontSize","fontFamily","weight"],"label row"))}for(const key of["label","text"])if(typeof shape[key]==="string"&&shape[key].length>500)fail2("label exceeds text limit")}if(diagram.edges!==undefined){if(!Array.isArray(diagram.edges)||diagram.edges.length>150)fail2("at most 150 edges are supported");for(const edge of diagram.edges)bounded(record(edge,["id","from","to","label","tone","start","end","bend","arrowhead","startPosition","endPosition","labelFontSize","labelFontFamily","labelWeight","labelPosition","labelOffset"],"edge"))}}function parseDrawingSource(value){const raw=record(value,["$schema","version","name","title","paper","sheets"],"drawing");if(raw.version!==1)fail2("version must be 1");if(typeof raw.name!=="string"||raw.name.length>100||!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(raw.name))fail2("name must be a bounded lowercase hyphenated name");if(raw.paper!=="us-letter"&&raw.paper!=="a4")fail2("paper must be us-letter or a4");if(raw.title!==undefined&&(typeof raw.title!=="string"||raw.title.length<1||Buffer.byteLength(raw.title)>1024||/[\u0000-\u001f]/u.test(raw.title)))fail2("title must be a bounded metadata string");if(raw.$schema!==undefined&&typeof raw.$schema!=="string")fail2("$schema must be a string");if(!Array.isArray(raw.sheets)||raw.sheets.length<1||raw.sheets.length>20)fail2("sheets must contain 1 to 20 sheets");const sheets=raw.sheets.map((sheet,index)=>{const entry=record(sheet,["figure","diagram"],`sheets[${index}]`);if(entry.figure!==index+1)fail2("figure numbers must be consecutive beginning at 1");checkDiagramEnvelope(entry.diagram);const diagram=parseDiagramSource(entry.diagram);const spec=parseDiagramSpec(diagram);if(spec.shapes.length<1||spec.shapes.length>100||(spec.edges?.length??0)>150)fail2("each sheet needs 1 to 100 shapes and at most 150 edges");return{figure:index+1,diagram}});const source={version:1,name:raw.name,paper:raw.paper,sheets,...raw.title===undefined?{}:{title:raw.title},...raw.$schema===undefined?{}:{$schema:raw.$schema}};if(Buffer.byteLength(JSON.stringify(source))>drawingSourceByteLimit)fail2("source exceeds 1MiB byte limit");return source}function renderer(svg){return new Resvg(svg,{font:{fontFiles,loadSystemFonts:false,defaultFontFamily:"Nebula Sans"},logLevel:"off"})}function bounds(engine){const box=engine.getBBox();if(box===undefined)fail2("empty drawing ink");return{x:box.x,y:box.y,width:box.width,height:box.height}}function inside(ink,box,label){const epsilon=0.01;if(ink.x<box.x-epsilon||ink.y<box.y-epsilon||ink.x+ink.width>box.x+box.width+epsilon||ink.y+ink.height>box.y+box.height+epsilon)fail2(`${label} ink extends beyond its bounds`)}async function sceneSvg(spec){return(await renderSvg(spec,"light",config,{edgeStrokeWidth:1})).svg.replace('<rect width="100%" height="100%" fill="#ffffff"/>',"")}function glyphHeight(character,fontSize,weight){const svg=`<svg xmlns="http://www.w3.org/2000/svg" width="1000" height="1000"><text x="100" y="500" font-family="Nebula Sans" font-size="${fontSize}" font-weight="${weight}">${escapeXml(character)}</text></svg>`;return bounds(renderer(svg)).height}function inspectLabels(spec,glyphCache){let minimum=Infinity;const inspect=(text,fontSize,weight,family)=>{if(text.length<1||text.length>500||!Array.from(text).every((character)=>/^[A-Z0-9 \n]$/u.test(character)||".,:;()[]/+=_*'!?%-".includes(character)))fail2("visible labels must be uppercase ASCII letters, numbers, spaces, or supported punctuation; labels are never rewritten");if(family!==undefined&&family!=="default")fail2("only the bundled default font is supported");if(!Number.isFinite(fontSize)||fontSize<=0||fontSize>18)fail2("authored font size must be positive and at most 18 points, below the 20 point sheet numbering");for(const character of new Set(text.match(/[A-Z0-9]/gu)??[])){const key=`${character}:${fontSize}:${weight}`;const measured=glyphCache.get(key)??glyphHeight(character,fontSize,weight);glyphCache.set(key,measured);if(glyphCache.size>4096)fail2("glyph measurement limit exceeded");minimum=Math.min(minimum,measured);if(measured+0.001<drawingMinimumGlyphHeightPt)fail2(`glyph ${character} has ${measured.toFixed(3)}pt ink height; minimum is ${drawingMinimumGlyphHeightPt.toFixed(3)}pt (3.2mm)`)}};for(const shape of spec.shapes){if(shape.tone!==undefined&&shape.tone!=="neutral")fail2("colored tones are unsupported; author monochrome relationships explicitly");if(shape.opacity!==undefined&&shape.opacity!==1)fail2("transparency is unsupported");if(shape.type==="rect"||shape.type==="ellipse"){if(shape.icon!==undefined)fail2("icons are unsupported");if((shape.strokeWidth??2)<0.5||(shape.strokeWidth??2)>4)fail2("stroke width must be 0.5 to 4 points");for(const row of layoutBoxContent(shape).rows)inspect(row.text,row.fontSize,row.weight,row.fontFamily)}else if(shape.type==="text")inspect(shape.text,shape.fontSize??24,shape.weight??500,shape.fontFamily);else if((shape.strokeWidth??3)<0.5||(shape.strokeWidth??3)>4)fail2("stroke width must be 0.5 to 4 points")}for(const edge of spec.edges??[]){if(edge.tone!==undefined&&edge.tone!=="neutral")fail2("colored edge tones are unsupported");if(edge.label!==undefined)inspect(edge.label,edge.labelFontSize??18,edge.labelWeight??600,edge.labelFontFamily)}return minimum}async function renderDrawing(input,sourceSha256){const source=parseDrawingSource(input);const sourceDigest=sourceSha256??sha256(JSON.stringify(source));if(!/^[a-f0-9]{64}$/u.test(sourceDigest))fail2("source SHA-256 is invalid");const geometry=drawingPageGeometry(source.paper);const sheets=[];const cache=new Map;let minGlyphHeightPt=Infinity;for(const sheet of source.sheets){const spec=parseDiagramSpec(sheet.diagram);if(spec.canvas.width>geometry.body.width+0.001||spec.canvas.height>geometry.body.height+0.001)fail2(`figure ${sheet.figure} canvas exceeds ${geometry.body.width.toFixed(3)} by ${geometry.body.height.toFixed(3)}pt body; no automatic scaling is performed`);minGlyphHeightPt=Math.min(minGlyphHeightPt,inspectLabels(spec,cache));const sourceSvg=await sceneSvg(spec);inside(bounds(renderer(sourceSvg)),{x:0,y:0,width:spec.canvas.width,height:spec.canvas.height},`figure ${sheet.figure}`);for(const shape of spec.shapes){if((shape.type==="rect"||shape.type==="ellipse")&&(shape.label!==undefined||shape.labelRows!==undefined)){const inset=(shape.strokeWidth??2)/2;const single=await sceneSvg({...spec,shapes:[shape],edges:[]});inside(bounds(renderer(single)),{x:shape.x-inset,y:shape.y-inset,width:shape.width+inset*2,height:shape.height+inset*2},`shape ${shape.id} label`)}}const diagramBody=sourceSvg.replace(/^<svg[^>]*>/u,"").replace(/<\/svg>$/u,"");const x=geometry.body.x+(geometry.body.width-spec.canvas.width)/2;const counter=`${sheet.figure}/${source.sheets.length}`;const figureLabel=source.sheets.length===1?"":`<text x="${geometry.width/2}" y="${geometry.height-geometry.margins.bottom-8}" text-anchor="middle" font-size="20" font-family="Nebula Sans" font-weight="400">FIG. ${sheet.figure}</text>`;const page=`<svg xmlns="http://www.w3.org/2000/svg" width="${geometry.width}" height="${geometry.height}" viewBox="0 0 ${geometry.width} ${geometry.height}"><rect width="100%" height="100%" fill="#ffffff"/><text x="${geometry.width/2}" y="${geometry.margins.top+21}" text-anchor="middle" font-size="20" font-family="Nebula Sans" font-weight="400">${counter}</text><g transform="translate(${x} ${geometry.body.y})">${diagramBody}</g>${figureLabel}</svg>`;const outlined=renderer(page).toString().replace(/width="[^"]+" height="[^"]+" viewBox="[^"]+"/u,`width="${geometry.width}pt" height="${geometry.height}pt" viewBox="0 0 ${geometry.width} ${geometry.height}"`);if(Buffer.byteLength(outlined)>2*1024*1024)fail2("sheet SVG exceeds output byte limit");sheets.push({svg:outlined,width:geometry.width,height:geometry.height,figure:sheet.figure})}for(const character of"FIG0123456789")minGlyphHeightPt=Math.min(minGlyphHeightPt,glyphHeight(character,20,400));if(minGlyphHeightPt+0.001<drawingMinimumGlyphHeightPt)fail2("sheet numbering falls below minimum glyph height");const checks={profile:drawingProfile,paper:source.paper,sheetCount:source.sheets.length,minGlyphHeightPt,findings:[]};return{sheets,checks,pdf:drawingSheetsPdf(sheets,{title:source.title??source.name,sourceSha256:sourceDigest,rendererVersion:SLOPCAMERA_VERSION})}}async function readDrawingFile(filePath){const absolutePath=resolve3(filePath);if(!absolutePath.endsWith(".drawing.json"))fail2("source filename must end in .drawing.json");const descriptor=await open(absolutePath,constants.O_RDONLY|constants.O_NOFOLLOW|constants.O_NONBLOCK);let bytes;try{const info=await descriptor.stat();if(!info.isFile())fail2("source must be a regular file");if(info.size>drawingSourceByteLimit)fail2("source exceeds 1MiB byte limit");const buffer=Buffer.alloc(drawingSourceByteLimit+1);let cursor=0;while(cursor<buffer.length){const result=await descriptor.read(buffer,cursor,buffer.length-cursor,cursor);if(result.bytesRead===0)break;cursor+=result.bytesRead}if(cursor>drawingSourceByteLimit)fail2("source exceeds 1MiB byte limit");bytes=buffer.subarray(0,cursor)}finally{await descriptor.close()}const raw=JSON.parse(new TextDecoder("utf-8",{fatal:true}).decode(bytes));return{absolutePath,source:parseDrawingSource(raw),sourceSha256:sha256(bytes)}}async function checkDrawingFile(options){const{source,sourceSha256}=await readDrawingFile(options.filePath);return(await renderDrawing(source,sourceSha256)).checks}async function atomicWrite2(filePath,data){const temporary=`${filePath}.tmp-${process.pid}-${crypto.randomUUID()}`;try{await writeFile2(temporary,data);await rename2(temporary,filePath)}catch(error){await rm2(temporary,{force:true});throw error}}async function renderDrawingFile(options){const{absolutePath,source,sourceSha256}=await readDrawingFile(options.filePath);const result=await renderDrawing(source,sourceSha256);const outDirectory=resolve3(options.outDirectory??dirname3(absolutePath));const artifacts={source:absolutePath,pdf:join2(outDirectory,`${source.name}.pdf`),sheets:result.sheets.map((_,index)=>join2(outDirectory,`${source.name}.sheet-${String(index+1).padStart(3,"0")}.svg`)),receipt:join2(outDirectory,`${source.name}.drawing-receipt.json`)};const receipt={version:1,profile:drawingProfile,rendererVersion:SLOPCAMERA_VERSION,sourceSha256,paper:source.paper,minGlyphHeightPt:result.checks.minGlyphHeightPt,sheets:result.sheets.map((sheet)=>({figure:sheet.figure,widthPt:sheet.width,heightPt:sheet.height,sha256:sha256(sheet.svg)})),pdfSha256:sha256(result.pdf)};await mkdir2(outDirectory,{recursive:true});for(const[index,sheet]of result.sheets.entries())await atomicWrite2(artifacts.sheets[index],sheet.svg);await atomicWrite2(artifacts.pdf,result.pdf);await atomicWrite2(artifacts.receipt,`${JSON.stringify(receipt,null,2)}
+`);return{artifacts,checks:result.checks,receipt}}function starterDrawingSource(){return{$schema:"https://raw.githubusercontent.com/hraness/slopcamera/main/schema/drawing.schema.json",version:1,name:"sensor-control",title:"Fictional sensor and controller drawings",paper:"us-letter",sheets:[{figure:1,diagram:{version:1,name:"sensor-system",canvas:{width:480,height:500},shapes:[{id:"sensor",type:"rect",x:105,y:40,width:280,height:100,radius:0,label:"SENSOR 100",labelFontSize:16},{id:"controller",type:"rect",x:105,y:280,width:280,height:100,radius:0,label:"CONTROLLER 200",labelFontSize:16}],edges:[{id:"signal",from:"sensor",to:"controller",label:"SIGNAL",labelFontSize:16}]}},{figure:2,diagram:{version:1,name:"control-flow",canvas:{width:480,height:500},shapes:[{id:"receive",type:"rect",x:105,y:40,width:280,height:100,radius:0,label:"RECEIVE SIGNAL 210",labelFontSize:16},{id:"actuate",type:"rect",x:105,y:280,width:280,height:100,radius:0,label:"SET OUTPUT 220",labelFontSize:16}],edges:[{id:"next",from:"receive",to:"actuate"}]}}]}}import{rename as rename3,rm as rm3,writeFile as writeFile3}from"fs/promises";import{dirname as dirname5,join as join4}from"path";import{open as open2,mkdir as mkdir3,realpath,stat}from"fs/promises";import{basename as basename2,dirname as dirname4,isAbsolute as isAbsolute3,join as join3,relative,resolve as resolve4,win32}from"path";var mcpSourceByteLimit=1024*1024;class WorkspaceBoundaryError extends Error{code;constructor(code,message){super(message);this.name="WorkspaceBoundaryError";this.code=code}}function filesystemCode(error){if(typeof error==="object"&&error!==null&&"code"in error&&typeof error.code==="string"){return error.code}return}function normalizeRelativePath(value,options){if(value.length===0||value.includes("\x00")){throw new WorkspaceBoundaryError("INVALID_PATH","Path must be a non-empty root-relative path.")}if(isAbsolute3(value)||win32.isAbsolute(value)||/^[A-Za-z]:/.test(value)){throw new WorkspaceBoundaryError("INVALID_PATH","Absolute paths are not allowed.")}const segments=value.split(/[\\/]/).filter((segment)=>segment!==""&&segment!==".");if(segments.includes("..")){throw new WorkspaceBoundaryError("INVALID_PATH","Parent-directory traversal is not allowed.")}if(segments.length===0){if(!options.allowRoot){throw new WorkspaceBoundaryError("INVALID_PATH","Path must identify a file below the root.")}return{native:".",portable:"."}}return{native:segments.join("/"),portable:segments.join("/")}}function isConfined(rootDirectory,target){const fromRoot=relative(rootDirectory,target);return fromRoot===""||!fromRoot.startsWith("..")&&!isAbsolute3(fromRoot)}async function readUtf8WithCap(filePath,sourceLabel){let handle;try{handle=await open2(filePath,"r");const metadata=await handle.stat();if(!metadata.isFile()){throw new WorkspaceBoundaryError("SOURCE_NOT_FILE",`${sourceLabel} must be a regular file.`)}if(metadata.size>mcpSourceByteLimit){throw new WorkspaceBoundaryError("SOURCE_TOO_LARGE",`${sourceLabel} exceeds the ${mcpSourceByteLimit}-byte limit.`)}const buffer=Buffer.allocUnsafe(mcpSourceByteLimit+1);let bytesRead=0;while(bytesRead<=mcpSourceByteLimit){const next=await handle.read(buffer,bytesRead,mcpSourceByteLimit+1-bytesRead,null);if(next.bytesRead===0)break;bytesRead+=next.bytesRead}if(bytesRead>mcpSourceByteLimit){throw new WorkspaceBoundaryError("SOURCE_TOO_LARGE",`${sourceLabel} exceeds the ${mcpSourceByteLimit}-byte limit.`)}try{return new TextDecoder("utf-8",{fatal:true}).decode(buffer.subarray(0,bytesRead))}catch{throw new WorkspaceBoundaryError("SOURCE_ENCODING",`${sourceLabel} must contain valid UTF-8.`)}}catch(error){if(error instanceof WorkspaceBoundaryError)throw error;const code=filesystemCode(error);if(code==="ENOENT"){throw new WorkspaceBoundaryError("SOURCE_NOT_FOUND",`${sourceLabel} does not exist.`)}throw new WorkspaceBoundaryError("FILESYSTEM_ERROR",`${sourceLabel} could not be read.`)}finally{await handle?.close()}}class WorkspaceBoundary{rootDirectory;constructor(rootDirectory){this.rootDirectory=rootDirectory}static async create(rootDirectory){let resolvedRoot;try{resolvedRoot=await realpath(resolve4(rootDirectory));if(!(await stat(resolvedRoot)).isDirectory()){throw new WorkspaceBoundaryError("OUTPUT_NOT_DIRECTORY","MCP root must be a directory.")}}catch(error){if(error instanceof WorkspaceBoundaryError)throw error;throw new WorkspaceBoundaryError("FILESYSTEM_ERROR","MCP root could not be opened.")}return new WorkspaceBoundary(resolvedRoot)}assertConfined(target){if(!isConfined(this.rootDirectory,target)){throw new WorkspaceBoundaryError("PATH_OUTSIDE_ROOT","Path resolves outside the MCP root.")}}toRelativePath(absolutePath){this.assertConfined(absolutePath);const fromRoot=relative(this.rootDirectory,absolutePath);return fromRoot===""?".":fromRoot.split("\\").join("/")}async readSource(value,sourceLabel="Diagram source"){const normalized=normalizeRelativePath(value,{allowRoot:false});const lexicalPath=resolve4(this.rootDirectory,normalized.native);this.assertConfined(lexicalPath);let canonicalPath;try{canonicalPath=await realpath(lexicalPath)}catch(error){if(filesystemCode(error)==="ENOENT"){throw new WorkspaceBoundaryError("SOURCE_NOT_FOUND",`${sourceLabel} does not exist.`)}throw new WorkspaceBoundaryError("FILESYSTEM_ERROR",`${sourceLabel} could not be resolved.`)}this.assertConfined(canonicalPath);return{absolutePath:canonicalPath,relativePath:this.toRelativePath(canonicalPath),text:await readUtf8WithCap(canonicalPath,sourceLabel)}}async resolveInputFile(value,maximumBytes){const normalized=normalizeRelativePath(value,{allowRoot:false});const lexicalPath=resolve4(this.rootDirectory,normalized.native);this.assertConfined(lexicalPath);let canonicalPath;try{canonicalPath=await realpath(lexicalPath);this.assertConfined(canonicalPath);const metadata=await stat(canonicalPath);if(!metadata.isFile()){throw new WorkspaceBoundaryError("SOURCE_NOT_FILE","Input must be a regular file.")}if(!Number.isSafeInteger(maximumBytes)||maximumBytes<1||metadata.size>maximumBytes){throw new WorkspaceBoundaryError("SOURCE_TOO_LARGE",`Input exceeds the ${maximumBytes}-byte limit.`)}}catch(error){if(error instanceof WorkspaceBoundaryError)throw error;if(filesystemCode(error)==="ENOENT"){throw new WorkspaceBoundaryError("SOURCE_NOT_FOUND","Input does not exist.")}throw new WorkspaceBoundaryError("FILESYSTEM_ERROR","Input could not be resolved.")}return{absolutePath:canonicalPath,relativePath:this.toRelativePath(canonicalPath)}}async prepareOutputFile(value){const normalized=normalizeRelativePath(value,{allowRoot:false});const fileName=basename2(normalized.native);if(fileName==="."||fileName===".."||fileName.length===0){throw new WorkspaceBoundaryError("INVALID_PATH","Output path must identify a file below the root.")}const directory=await this.prepareOutputDirectory(dirname4(normalized.native));const absolutePath=join3(directory.absolutePath,fileName);this.assertConfined(absolutePath);return{absolutePath,relativePath:this.toRelativePath(absolutePath)}}async prepareOutputDirectory(value){const normalized=normalizeRelativePath(value,{allowRoot:true});const lexicalPath=resolve4(this.rootDirectory,normalized.native);this.assertConfined(lexicalPath);let ancestor=lexicalPath;for(;;){try{const canonicalAncestor=await realpath(ancestor);this.assertConfined(canonicalAncestor);break}catch(error){if(error instanceof WorkspaceBoundaryError)throw error;if(filesystemCode(error)!=="ENOENT"){throw new WorkspaceBoundaryError("FILESYSTEM_ERROR","Output directory could not be resolved.")}const parent=dirname4(ancestor);if(parent===ancestor){throw new WorkspaceBoundaryError("PATH_OUTSIDE_ROOT","Output directory resolves outside the MCP root.")}ancestor=parent}}try{await mkdir3(lexicalPath,{recursive:true});const canonicalPath=await realpath(lexicalPath);this.assertConfined(canonicalPath);if(!(await stat(canonicalPath)).isDirectory()){throw new WorkspaceBoundaryError("OUTPUT_NOT_DIRECTORY","Output path must be a directory.")}return{absolutePath:canonicalPath,relativePath:this.toRelativePath(canonicalPath)}}catch(error){if(error instanceof WorkspaceBoundaryError)throw error;throw new WorkspaceBoundaryError("FILESYSTEM_ERROR","Output directory could not be created.")}}}var mcpMaximumScale=4;var mcpMaximumRenderedPixels=16777216;var mcpMaximumShapes=64;var mcpMaximumEdges=128;var mcpMaximumReturnedFindings=40;var mcpMaximumReturnedEntities=256;var mcpMaximumReturnedAuditSamples=8192;var mcpMaximumReturnedDiffEntries=1024;var defaultScale=2;var maximumShapeIdsPerFinding=12;var builtInConfig=Object.freeze({icons:builtInIcons});var findingSchema={type:"object",additionalProperties:false,required:["code","message","shapeIds"],properties:{code:{type:"string"},message:{type:"string"},shapeIds:{type:"array",items:{type:"string"}}}};var scenePathSchema={type:"string",description:"Root-relative path to a spatial scene JSON source (1 MiB maximum)."};var sceneCameraIdSchema={type:"string",maxLength:128,pattern:"^camera_[a-zA-Z0-9][a-zA-Z0-9_-]*$",description:"Identifier of a camera declared by the scene (camera_\u2026)."};var entityTruncationSummarySchema={type:"object",additionalProperties:false,required:["entityCount","returnedEntityCount","entitiesTruncated"],properties:{entityCount:{type:"integer",minimum:0},returnedEntityCount:{type:"integer",minimum:0},entitiesTruncated:{type:"boolean"}}};function deepFreeze(value){if(typeof value!=="object"||value===null||Object.isFrozen(value)){return value}for(const nested of Object.values(value))deepFreeze(nested);return Object.freeze(value)}var slopcameraMcpTools=deepFreeze([{name:"check_diagram",title:"Check diagram",description:"Parse and lint one root-relative Slopcamera diagram source without changing files. Uses only built-in icons and themes.",inputSchema:{type:"object",additionalProperties:false,required:["path"],properties:{path:{type:"string",description:"Root-relative path to a diagram JSON source (1 MiB maximum)."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","findings","summary"],properties:{ok:{const:true},source:{type:"string"},findings:{type:"array",items:findingSchema},summary:{type:"object",additionalProperties:false,required:["shapeCount","edgeCount","findingCount","returnedFindingCount","findingsTruncated"],properties:{shapeCount:{type:"integer",minimum:0},edgeCount:{type:"integer",minimum:0},findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"}}}}},annotations:{title:"Check diagram",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"render_diagram",title:"Render diagram",description:"Render one root-relative Slopcamera diagram source with built-in icons and themes, overwriting its paired .tldr, light/dark SVG, and light/dark PNG artifacts.",inputSchema:{type:"object",additionalProperties:false,required:["path"],properties:{path:{type:"string",description:"Root-relative path to a diagram JSON source (1 MiB maximum)."},out_dir:{type:"string",description:"Optional root-relative output directory. Defaults to the source directory."},scale:{type:"number",exclusiveMinimum:0,maximum:mcpMaximumScale,default:defaultScale,description:"PNG scale. The scaled canvas may contain at most 16,777,216 pixels."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","scale","findings","artifacts","summary"],properties:{ok:{const:true},source:{type:"string"},scale:{type:"number"},findings:{type:"array",items:findingSchema},artifacts:{type:"object",additionalProperties:false,required:["tldr","lightSvg","darkSvg","lightPng","darkPng"],properties:{tldr:{type:"string"},lightSvg:{type:"string"},darkSvg:{type:"string"},lightPng:{type:"string"},darkPng:{type:"string"}}},summary:{type:"object",additionalProperties:false,required:["shapeCount","edgeCount","findingCount","returnedFindingCount","findingsTruncated"],properties:{shapeCount:{type:"integer",minimum:0},edgeCount:{type:"integer",minimum:0},findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"}}}}},annotations:{title:"Render diagram",readOnlyHint:false,destructiveHint:true,idempotentHint:true,openWorldHint:false}},{name:"search_slopcamera",title:"Search Slopcamera operations",description:"Search the fixed semantic Slopcamera operation registry by bounded text. This never executes code or changes files.",inputSchema:{type:"object",additionalProperties:false,properties:{query:{type:"string",maxLength:200,description:"Optional terms matched against operation codes and descriptions."},limit:{type:"integer",minimum:1,maximum:20,default:4}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","operations"],properties:{ok:{const:true},operations:{type:"array",maxItems:20,items:{type:"object",required:["code","title","description","execution","authentication","inputSchema"]}}}},annotations:{title:"Search Slopcamera operations",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"execute_slopcamera",title:"Execute Slopcamera operation",description:"Execute one exact operation code with typed JSON input. Never accepts or evaluates source code. Local paths remain confined to the configured workspace root.",inputSchema:{type:"object",additionalProperties:false,required:["operation","input"],properties:{operation:{type:"string",enum:slopcameraOperationCodes},input:{type:"object",description:"Typed input matching the selected operation's registry schema."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","operation","result"],properties:{ok:{const:true},operation:{type:"string",enum:slopcameraOperationCodes},result:{type:"object"}}},annotations:{title:"Execute Slopcamera operation",readOnlyHint:false,destructiveHint:true,idempotentHint:false,openWorldHint:true}},{name:"check_scene",title:"Check scene",description:"Parse and validate one root-relative Slopcamera spatial scene JSON source without changing files.",inputSchema:{type:"object",additionalProperties:false,required:["path"],properties:{path:scenePathSchema}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","sceneId","sceneSha256","summary"],properties:{ok:{const:true},source:{type:"string"},sceneId:{type:"string"},sceneSha256:{type:"string"},summary:{type:"object",additionalProperties:false,required:["durationUs","entityCount","cameraCount","assetCount","animationCount","generatorCount","overrideCount"],properties:{durationUs:{type:"integer",minimum:0},entityCount:{type:"integer",minimum:0},cameraCount:{type:"integer",minimum:0},assetCount:{type:"integer",minimum:0},animationCount:{type:"integer",minimum:0},generatorCount:{type:"integer",minimum:0},overrideCount:{type:"integer",minimum:0}}}}},annotations:{title:"Check scene",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"inspect_scene",title:"Inspect scene",description:"Snapshot one root-relative spatial scene's entities, editable controls, placements, assets, and generators without changing files.",inputSchema:{type:"object",additionalProperties:false,required:["path"],properties:{path:scenePathSchema}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","inspection","summary"],properties:{ok:{const:true},source:{type:"string"},inspection:{type:"object"},summary:entityTruncationSummarySchema}},annotations:{title:"Inspect scene",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"audit_scene",title:"Audit scene",description:"Sample one root-relative spatial scene against a camera and report per-entity geometric coverage, visibility findings, and bounds gaps. Optional asset_bounds accepts a Record<assetId,{min,max}> map, a slopcamera.spatial-asset-admission document, a {manifest,facts} pair, or an array of those.",inputSchema:{type:"object",additionalProperties:false,required:["path","camera_id"],properties:{path:scenePathSchema,camera_id:sceneCameraIdSchema,times_us:{type:"array",items:{type:"integer",minimum:0,maximum:SPATIAL_SCENE_LIMITS.durationUs},minItems:1,maxItems:SPATIAL_AUDIT_LIMITS.samples,description:"Optional sample times in microseconds. Defaults to evenly spaced coverage of the scene duration."},asset_bounds:{description:"Optional decoded scene-space asset bounds: a Record<assetId,{min,max}> map, a slopcamera.spatial-asset-admission document, a {manifest,facts} pair, or an array of those documents."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","returnedFindingCount","findingsTruncated","entityCount","returnedEntityCount","entitiesTruncated"],properties:{findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"},entityCount:{type:"integer",minimum:0},returnedEntityCount:{type:"integer",minimum:0},entitiesTruncated:{type:"boolean"}}}}},annotations:{title:"Audit scene",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"diff_scenes",title:"Diff scenes",description:"Compare two root-relative spatial scene JSON sources and report added, removed, and changed collection entries without changing files.",inputSchema:{type:"object",additionalProperties:false,required:["path","other"],properties:{path:scenePathSchema,other:{type:"string",description:"Root-relative path to the second spatial scene JSON source (1 MiB maximum)."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","other","sceneSha256","otherSha256","diff","summary"],properties:{ok:{const:true},source:{type:"string"},other:{type:"string"},sceneSha256:{type:"string"},otherSha256:{type:"string"},diff:{type:"array"},summary:{type:"object",additionalProperties:false,required:["entryCount","returnedEntryCount","diffTruncated"],properties:{entryCount:{type:"integer",minimum:0},returnedEntryCount:{type:"integer",minimum:0},diffTruncated:{type:"boolean"}}}}},annotations:{title:"Diff scenes",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"evaluate_scene",title:"Evaluate scene",description:"Evaluate one root-relative spatial scene at one camera and integer microsecond time into an immutable snapshot without changing files.",inputSchema:{type:"object",additionalProperties:false,required:["path","camera_id","time_us"],properties:{path:scenePathSchema,camera_id:sceneCameraIdSchema,time_us:{type:"integer",minimum:0,maximum:SPATIAL_SCENE_LIMITS.durationUs,description:"Evaluation time in integer microseconds."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","snapshot","summary"],properties:{ok:{const:true},source:{type:"string"},snapshot:{type:"object"},summary:entityTruncationSummarySchema}},annotations:{title:"Evaluate scene",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"check_scene_direction",title:"Check scene direction",description:"Validate one authored direction document against one root-relative spatial scene: stale project digests, unresolved entity references, and intervals outside scene duration report as errors without compiling or changing files.",inputSchema:{type:"object",additionalProperties:false,required:["scene","direction"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},direction:{type:"string",description:"Root-relative path to the slopcamera.spatial-direction JSON document."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","returnedFindingCount","findingsTruncated","errorCount","warningCount"],properties:{findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"},errorCount:{type:"integer",minimum:0},warningCount:{type:"integer",minimum:0}}}}},annotations:{title:"Check scene direction",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"plan_scene_direction",title:"Plan scene direction",description:"Compile one authored direction document into a deterministic, unverified proposal document \u2014 performance actions, camera rigs, shots and looks bound to the actual scene digest. Proposals are advisory only; nothing is applied to the scene.",inputSchema:{type:"object",additionalProperties:false,required:["scene","direction"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},direction:{type:"string",description:"Root-relative path to the slopcamera.spatial-direction JSON document."},camera_id:{...sceneCameraIdSchema,description:"Optional camera used to resolve coverage; defaults to the sole or first sorted scene camera."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","compilation","summary"],properties:{ok:{const:true},source:{type:"string"},compilation:{type:"object"},summary:{type:"object",additionalProperties:false,required:["advisoryCount","unresolvedIntentCount","proposalCounts"],properties:{advisoryCount:{type:"integer",minimum:0},unresolvedIntentCount:{type:"integer",minimum:0},proposalCounts:{type:"object",additionalProperties:false,required:["performance","cameraRigs","shots","lookIntents"],properties:{performance:{type:"integer",minimum:0},cameraRigs:{type:"integer",minimum:0},shots:{type:"integer",minimum:0},lookIntents:{type:"integer",minimum:0}}}}}}},annotations:{title:"Plan scene direction",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"plan_scene_gallery",title:"Plan scene gallery",description:"Compile a bounded set of single-axis direction variants into separate content-addressed candidate compilations plus a preview-reel plan. The planner never selects or promotes a candidate.",inputSchema:{type:"object",additionalProperties:false,required:["scene","direction","axis"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},direction:{type:"string",description:"Root-relative path to the slopcamera.spatial-direction JSON document."},axis:{type:"string",enum:[...SpatialGalleryAxisSchema.options],description:"Variation axis for the bounded candidate set."},camera_id:{...sceneCameraIdSchema,description:"Optional camera used to resolve coverage."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","gallery","summary"],properties:{ok:{const:true},source:{type:"string"},gallery:{type:"object"},summary:{type:"object",additionalProperties:false,required:["axis","candidateCount","selected"],properties:{axis:{type:"string"},candidateCount:{type:"integer",minimum:0},selected:{const:false}}}}},annotations:{title:"Plan scene gallery",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"check_scene_effects",title:"Check scene effects",description:"Validate one slopcamera.spatial-render-effects document or {document, documentSha256} binding against one scene: scene-digest bindings, entity and asset closure, and nested plan/particle/simulation digests report as findings before any host work.",inputSchema:{type:"object",additionalProperties:false,required:["scene","effects"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},effects:{type:"string",description:"Root-relative path to the render-effects document or binding JSON."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","returnedFindingCount","findingsTruncated","errorCount","warningCount"],properties:{findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"},errorCount:{type:"integer",minimum:0},warningCount:{type:"integer",minimum:0}}}}},annotations:{title:"Check scene effects",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"plan_scene_effects",title:"Plan scene effects",description:"Assemble a canonical {document, documentSha256} render-effects binding for one scene from a draft JSON naming renderPlan, particleSystems and simulationBakes. Entity and asset closure rejects before the document is formed; the scene digest binds here, never by caller assertion.",inputSchema:{type:"object",additionalProperties:false,required:["scene","draft"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},draft:{type:"string",description:"Root-relative path to the effects draft JSON ({renderPlan, particleSystems?, simulationBakes?})."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","binding","summary"],properties:{ok:{const:true},source:{type:"string"},binding:{type:"object"},summary:{type:"object",additionalProperties:false,required:["documentSha256","particleSystemCount","simulationBakeCount"],properties:{documentSha256:{type:"string"},particleSystemCount:{type:"integer",minimum:0},simulationBakeCount:{type:"integer",minimum:0}}}}},annotations:{title:"Plan scene effects",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"check_scene_behavior",title:"Check scene behavior",description:"Validate one slopcamera.spatial-behavior document against one scene: bake-safe organism profile (input/const/fn/repeat/each/organism cells only), manifest-closure digests, entity and scene-digest bindings, channel declarations, fn-catalog resolution, wiring, and budget bounds report as findings before any host work.",inputSchema:{type:"object",additionalProperties:false,required:["scene","behavior"],properties:{scene:{...scenePathSchema,description:"Root-relative path to the spatial scene JSON source (1 MiB maximum)."},behavior:{type:"string",description:"Root-relative path to the spatial behavior document JSON."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","returnedFindingCount","findingsTruncated","errorCount","warningCount"],properties:{findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"},errorCount:{type:"integer",minimum:0},warningCount:{type:"integer",minimum:0}}}}},annotations:{title:"Check scene behavior",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"audit_scene_behavior",title:"Audit scene behavior trace",description:"Analyze a baked behavior trace for pathological patterns: state thrash (rapid transitions), exact periodicity (trivially cyclic channels), dead channels (constant-valued), and unreachable states (declared in transitions but never visited). Advisory findings for gallery review \u2014 never selects or promotes.",inputSchema:{type:"object",additionalProperties:false,required:["bake"],properties:{bake:{type:"string",description:"Root-relative path to the behavior bake JSON (slopcamera.spatial-behavior-bake)."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","channelCount","emittedCount"],properties:{findingCount:{type:"integer",minimum:0},channelCount:{type:"integer",minimum:0},emittedCount:{type:"integer",minimum:0}}}}},annotations:{title:"Audit scene behavior trace",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},{name:"audit_scene_temporal",title:"Audit scene temporal evidence",description:"Evaluate one root-relative spatial scene at bounded sample times under one camera and report deterministic temporal findings: visibility flicker, transform discontinuity, foot-slide against declared contact windows, camera acceleration/jerk/angular velocity, exposure and focus jumps, and resource spikes.",inputSchema:{type:"object",additionalProperties:false,required:["path","camera_id"],properties:{path:scenePathSchema,camera_id:sceneCameraIdSchema,times_us:{type:"array",items:{type:"integer",minimum:0,maximum:SPATIAL_SCENE_LIMITS.durationUs},minItems:2,maxItems:SPATIAL_TEMPORAL_AUDIT_LIMITS.samples,description:"Optional sample times in microseconds (2\u2013256). Defaults to evenly spaced coverage of the scene duration."},contacts:{type:"string",description:"Optional root-relative path to a {contacts: [...]} ground-contact evidence JSON."},cut_before_us:{type:"array",items:{type:"integer",minimum:0,maximum:SPATIAL_SCENE_LIMITS.durationUs},maxItems:SPATIAL_TEMPORAL_AUDIT_LIMITS.cutBoundaries,description:"Optional intentional cut boundaries; discontinuities exactly at a cut are not findings."}}},outputSchema:{type:"object",additionalProperties:false,required:["ok","source","report","summary"],properties:{ok:{const:true},source:{type:"string"},report:{type:"object"},summary:{type:"object",additionalProperties:false,required:["findingCount","returnedFindingCount","findingsTruncated","sampleCount"],properties:{findingCount:{type:"integer",minimum:0},returnedFindingCount:{type:"integer",minimum:0},findingsTruncated:{type:"boolean"},sampleCount:{type:"integer",minimum:2}}}}},annotations:{title:"Audit scene temporal evidence",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}}]);class ToolFailure extends Error{code;issues;constructor(code,message,issues){super(message);this.name="ToolFailure";this.code=code;if(issues!==undefined)this.issues=issues}}function isRecord2(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function safeFragment(value,maximumLength=160){return value.replace(/[\u0000-\u001f\u007f]/g," ").replace(/\s+/g," ").trim().slice(0,maximumLength)}function safeIssues(issues){return issues.slice(0,24).map((issue)=>safeFragment(issue,240))}function rejectUnknownKeys(value,allowed){const unknown=Object.keys(value).filter((key)=>!allowed.has(key));if(unknown.length>0){throw new ToolFailure("INVALID_ARGUMENTS",`Unsupported argument: ${safeFragment(unknown[0]??"unknown")}.`)}}function parsePath(value){if(typeof value!=="string"||value.length===0){throw new ToolFailure("INVALID_ARGUMENTS","path must be a non-empty root-relative string.")}if(!value.toLowerCase().endsWith(".diagram.json")){throw new ToolFailure("INVALID_ARGUMENTS","path must end in .diagram.json.")}return value}function parseCheckArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path"]));return{path:parsePath(value.path)}}function parseRenderArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path","out_dir","scale"]));const outDirectory=value.out_dir;if(outDirectory!==undefined&&(typeof outDirectory!=="string"||outDirectory.length===0)){throw new ToolFailure("INVALID_ARGUMENTS","out_dir must be a non-empty root-relative string when present.")}const scale=value.scale??defaultScale;if(typeof scale!=="number"||!Number.isFinite(scale)||scale<=0||scale>mcpMaximumScale){throw new ToolFailure("RENDER_LIMIT",`scale must be greater than zero and no more than ${mcpMaximumScale}.`)}return{path:parsePath(value.path),...outDirectory===undefined?{}:{outDirectory},scale}}function parseSearchArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["query","limit"]));const query=value.query??"";const limit=value.limit??slopcameraOperationCodes.length;if(typeof query!=="string"||query.length>200||/[\u0000-\u001f\u007f]/u.test(query)||!Number.isInteger(limit)||limit<1||limit>20){throw new ToolFailure("INVALID_ARGUMENTS","query must be a bounded string and limit must be an integer from 1 through 20.")}return{query,limit}}function parseExecuteArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["operation","input"]));if(typeof value.operation!=="string"||!slopcameraOperationCodes.includes(value.operation)||!isRecord2(value.input)){throw new ToolFailure("INVALID_ARGUMENTS","operation must be an exact Slopcamera operation code and input must be an object.")}return{operation:value.operation,input:value.input}}var sceneCameraIdPattern=/^camera_[a-zA-Z0-9][a-zA-Z0-9_-]*$/u;function parseScenePath(value,label){if(typeof value!=="string"||value.length===0){throw new ToolFailure("INVALID_ARGUMENTS",`${label} must be a non-empty root-relative string.`)}if(!value.toLowerCase().endsWith(".json")){throw new ToolFailure("INVALID_ARGUMENTS",`${label} must end in .json.`)}return value}function parseSceneCameraId(value){if(typeof value!=="string"||value.length>128||!sceneCameraIdPattern.test(value)){throw new ToolFailure("INVALID_ARGUMENTS","camera_id must be a scene camera identifier (camera_ followed by letters, digits, _ or -).")}return value}function parseSceneSourceArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path"]));return{path:parseScenePath(value.path,"path")}}function parseAuditSceneArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path","camera_id","times_us","asset_bounds"]));let timesUs;if(value.times_us!==undefined){if(!Array.isArray(value.times_us)||value.times_us.length===0||value.times_us.length>SPATIAL_AUDIT_LIMITS.samples||value.times_us.some((timeUs)=>!Number.isSafeInteger(timeUs)||timeUs<0||timeUs>SPATIAL_SCENE_LIMITS.durationUs)){throw new ToolFailure("INVALID_ARGUMENTS",`times_us must be an array of 1\u2013${SPATIAL_AUDIT_LIMITS.samples} integer microsecond times within the scene duration bound.`)}timesUs=[...value.times_us]}return{path:parseScenePath(value.path,"path"),cameraId:parseSceneCameraId(value.camera_id),...timesUs===undefined?{}:{timesUs},..."asset_bounds"in value?{assetBounds:value.asset_bounds}:{}}}function parseDiffScenesArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path","other"]));return{path:parseScenePath(value.path,"path"),other:parseScenePath(value.other,"other")}}function parseEvaluateSceneArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path","camera_id","time_us"]));const timeUs=value.time_us;if(typeof timeUs!=="number"||!Number.isSafeInteger(timeUs)||timeUs<0||timeUs>SPATIAL_SCENE_LIMITS.durationUs){throw new ToolFailure("INVALID_ARGUMENTS",`time_us must be an integer microsecond time from 0 through ${SPATIAL_SCENE_LIMITS.durationUs}.`)}return{path:parseScenePath(value.path,"path"),cameraId:parseSceneCameraId(value.camera_id),timeUs}}function parseSceneDirectionArguments(value,requireAxis){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["scene","direction","camera_id","axis"]));if(requireAxis&&!SpatialGalleryAxisSchema.safeParse(value.axis).success){throw new ToolFailure("INVALID_ARGUMENTS",`axis must be one of ${SpatialGalleryAxisSchema.options.join(", ")}.`)}if(!requireAxis&&value.axis!==undefined){throw new ToolFailure("INVALID_ARGUMENTS","axis is only valid for plan_scene_gallery.")}return{scene:parseScenePath(value.scene,"scene"),direction:parseScenePath(value.direction,"direction"),...value.camera_id===undefined?{}:{cameraId:parseSceneCameraId(value.camera_id)},...value.axis===undefined?{}:{axis:value.axis}}}function parseSceneEffectsArguments(value,effectsKey){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["scene",effectsKey]));return{scene:parseScenePath(value.scene,"scene"),effects:parseScenePath(value[effectsKey],effectsKey)}}function parseSceneBehaviorArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["scene","behavior"]));return{scene:parseScenePath(value.scene,"scene"),behavior:parseScenePath(value.behavior,"behavior")}}function parseSceneBehaviorAuditArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["bake"]));return{bake:parseScenePath(value.bake,"bake")}}function parseSceneTemporalArguments(value){if(!isRecord2(value)){throw new ToolFailure("INVALID_ARGUMENTS","Tool arguments must be an object.")}rejectUnknownKeys(value,new Set(["path","camera_id","times_us","contacts","cut_before_us"]));const boundedTimes=(key,maximum)=>{const entries=value[key];if(entries===undefined)return;if(!Array.isArray(entries)||entries.length===0||entries.length>maximum||entries.some((timeUs)=>!Number.isSafeInteger(timeUs)||timeUs<0||timeUs>SPATIAL_SCENE_LIMITS.durationUs)){throw new ToolFailure("INVALID_ARGUMENTS",`${key} must be an array of 1\u2013${maximum} integer microsecond times within the scene duration bound.`)}return[...entries]};const timesUs=boundedTimes("times_us",SPATIAL_TEMPORAL_AUDIT_LIMITS.samples);const cutBeforeUs=boundedTimes("cut_before_us",SPATIAL_TEMPORAL_AUDIT_LIMITS.cutBoundaries);if(timesUs!==undefined&&timesUs.length<2){throw new ToolFailure("INVALID_ARGUMENTS","times_us must contain at least 2 sample times.")}return{path:parseScenePath(value.path,"path"),cameraId:parseSceneCameraId(value.camera_id),...timesUs===undefined?{}:{timesUs},...value.contacts===undefined?{}:{contacts:parseScenePath(value.contacts,"contacts")},...cutBeforeUs===undefined?{}:{cutBeforeUs}}}function assertBuiltInIcons(spec){for(const shape of spec.shapes){if((shape.type==="rect"||shape.type==="ellipse")&&shape.icon!==undefined&&!Object.hasOwn(builtInIcons,shape.icon)){throw new ToolFailure("UNKNOWN_ICON",`Shape ${safeFragment(shape.id)} requests unavailable built-in icon ${safeFragment(shape.icon)}.`)}}}function assertComplexityLimits(spec){const edgeCount=spec.edges?.length??0;if(spec.shapes.length>mcpMaximumShapes||edgeCount>mcpMaximumEdges){throw new ToolFailure("COMPLEXITY_LIMIT",`Diagram may contain at most ${mcpMaximumShapes} shapes and ${mcpMaximumEdges} edges in MCP mode.`)}}function assertRawComplexityLimits(value){if(!isRecord2(value))return;const shapeCount=Array.isArray(value.shapes)?value.shapes.length:0;const edgeCount=Array.isArray(value.edges)?value.edges.length:0;if(shapeCount>mcpMaximumShapes||edgeCount>mcpMaximumEdges){throw new ToolFailure("COMPLEXITY_LIMIT",`Diagram may contain at most ${mcpMaximumShapes} shapes and ${mcpMaximumEdges} edges in MCP mode.`)}}function assertRenderLimits(spec,scale){const scaledWidth=spec.canvas.width*scale;const scaledHeight=spec.canvas.height*scale;const pixels=Math.ceil(scaledWidth)*Math.ceil(scaledHeight);if(!Number.isFinite(pixels)||scaledWidth<1||scaledHeight<1||pixels>mcpMaximumRenderedPixels){throw new ToolFailure("RENDER_LIMIT",`Scaled canvas must be at least 1 pixel on each axis and no more than ${mcpMaximumRenderedPixels.toLocaleString("en-US")} pixels total.`)}}function boundedSlice(items,maximum){return items.length>maximum?items.slice(0,maximum):items}function publicFinding(finding){return{code:safeFragment(finding.code,64),message:safeFragment(finding.message,240),shapeIds:finding.shapeIds.slice(0,maximumShapeIdsPerFinding).map((shapeId)=>safeFragment(shapeId,120))}}function publicFindings(findings){return findings.slice(0,mcpMaximumReturnedFindings).map(publicFinding)}function diagramSummary(spec,findingCount,returnedFindingCount){return{shapeCount:spec.shapes.length,edgeCount:spec.edges?.length??0,findingCount,returnedFindingCount,findingsTruncated:returnedFindingCount<findingCount}}function successResult(text,structuredContent){return{content:[{type:"text",text}],structuredContent}}function failureResult(error){let code="INTERNAL_ERROR";let message="The tool failed safely.";let issues;if(error instanceof ToolFailure){code=error.code;message=safeFragment(error.message,320);issues=error.issues}else if(error instanceof WorkspaceBoundaryError){code=error.code;message=safeFragment(error.message,320)}else if(error instanceof SlopcameraCloudError){code=error.code;message=safeFragment(error.message.replace(/^\[[A-Z_]+\]\s*/u,""),320)}else if(error instanceof SlopcameraOperationError){code=error.code;message=safeFragment(error.message.replace(/^\[[A-Z_]+\]\s*/u,""),320)}else if(error instanceof VectorizeError){code=`VECTORIZE_${error.code.toUpperCase()}`;message="Local vectorization failed safely."}else if(error instanceof DiagramValidationError){code="INVALID_DIAGRAM";message="Diagram source did not pass validation.";issues=safeIssues(error.issues)}else if(error instanceof SlopcameraCodeError){code=error.code.toUpperCase().replace(/-/g,"_");message=safeFragment(error.message,320)}else if(error instanceof HostResourceError){code=`HOST_RESOURCE_${error.code}`;message="Host-resource admission failed safely."}else if(typeof error==="object"&&error!==null&&"issues"in error&&Array.isArray(error.issues)&&error.issues.every((issue)=>typeof issue==="string")){code="INVALID_LAYOUT";message="Diagram layout could not be resolved.";issues=safeIssues(error.issues)}const issueText=issues===undefined||issues.length===0?"":`
+${issues.map((issue)=>`- ${issue}`).join(`
+`)}`;return{content:[{type:"text",text:`[${code}] ${message}${issueText}`}],isError:true}}function portableDirectory(filePath){const separator=filePath.lastIndexOf("/");return separator===-1?".":filePath.slice(0,separator)}async function atomicOverwrite(filePath,data){const temporaryPath=join4(dirname5(filePath),`.${crypto.randomUUID()}.slopcamera-mcp.tmp`);try{await writeFile3(temporaryPath,data,{flag:"wx"});try{await rename3(temporaryPath,filePath)}catch(error){const code=typeof error==="object"&&error!==null&&"code"in error&&typeof error.code==="string"?error.code:undefined;if(code!=="EEXIST"&&code!=="EPERM")throw error;await rm3(filePath,{force:true});await rename3(temporaryPath,filePath)}}finally{await rm3(temporaryPath,{force:true})}}async function loadDiagram(boundary,path){const source=await boundary.readSource(path);let parsed;try{parsed=JSON.parse(source.text)}catch{throw new ToolFailure("INVALID_JSON","Diagram source is not valid JSON.")}assertRawComplexityLimits(parsed);const spec=parseDiagramSpec(parsed);assertComplexityLimits(spec);assertBuiltInIcons(spec);return{source,spec}}async function loadScene(boundary,path){const source=await boundary.readSource(path,"Scene source");const parsed=parseJsonText(source.text);try{return{source,scene:parseSpatialScene(parsed)}}catch(error){if(error instanceof SpatialSceneError){const where=error.path==="scene"?"":` at ${error.path}`;throw new ToolFailure("INVALID_SCENE",`Scene source did not pass validation${where}: ${safeFragment(error.message,240)}`)}throw error}}function parseJsonText(text){try{return JSON.parse(text)}catch{throw new ToolFailure("INVALID_JSON","Source is not valid JSON.")}}async function loadJson(boundary,path,label){const source=await boundary.readSource(path,label);return{source,value:parseJsonText(source.text)}}class SlopcameraMcpToolRuntime{boundary;generateDependencies;hostResourceCoordinator;renderQueue=Promise.resolve();constructor(boundary,generateDependencies,hostResourceCoordinator){this.boundary=boundary;this.generateDependencies=generateDependencies;this.hostResourceCoordinator=hostResourceCoordinator}static async create(rootDirectory,generateDependencies={},hostResourceCoordinator){return new SlopcameraMcpToolRuntime(await WorkspaceBoundary.create(rootDirectory),generateDependencies,hostResourceCoordinator??createDefaultHostResourceCoordinator())}async withHostAdmission(operation,callback){return await withSlopcameraOperationHostAdmission(operation,callback,{hostResourceCoordinator:this.hostResourceCoordinator})}async withSceneAdmission(callback){return await this.hostResourceCoordinator.withLease([{resource:"cpu",amount:1},{resource:"local-io",amount:1}],async(lease)=>{await lease.assertOwned();return await callback(lease)})}enqueueRender(operation){const result=this.renderQueue.then(operation,operation);this.renderQueue=result.then(()=>{return},()=>{return});return result}async call(name,argumentsValue){try{if(name==="check_diagram"){const options=parseCheckArguments(argumentsValue);return await this.withHostAdmission("slopcamera.diagram.check",async()=>await this.check(options))}if(name==="render_diagram"){const options=parseRenderArguments(argumentsValue);return await this.enqueueRender(async()=>await this.withHostAdmission("slopcamera.diagram.render",async()=>await this.render(options)))}if(name==="search_slopcamera"){const options=parseSearchArguments(argumentsValue);const operations=searchSlopcameraOperations(options.query,options.limit);return successResult(`Found ${operations.length} Slopcamera operation${operations.length===1?"":"s"}.`,{ok:true,operations})}if(name==="execute_slopcamera"){const options=parseExecuteArguments(argumentsValue);return await this.execute(options)}if(name==="check_scene"){const options=parseSceneSourceArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.checkScene(options))}if(name==="inspect_scene"){const options=parseSceneSourceArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.inspectScene(options))}if(name==="audit_scene"){const options=parseAuditSceneArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.auditScene(options))}if(name==="diff_scenes"){const options=parseDiffScenesArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.diffScenes(options))}if(name==="evaluate_scene"){const options=parseEvaluateSceneArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.evaluateScene(options))}if(name==="check_scene_direction"){const options=parseSceneDirectionArguments(argumentsValue,false);return await this.withSceneAdmission(async()=>await this.checkSceneDirection(options))}if(name==="plan_scene_direction"){const options=parseSceneDirectionArguments(argumentsValue,false);return await this.withSceneAdmission(async()=>await this.planSceneDirection(options))}if(name==="plan_scene_gallery"){const options=parseSceneDirectionArguments(argumentsValue,true);return await this.withSceneAdmission(async()=>await this.planSceneGallery(options))}if(name==="check_scene_effects"){const options=parseSceneEffectsArguments(argumentsValue,"effects");return await this.withSceneAdmission(async()=>await this.checkSceneEffects(options))}if(name==="plan_scene_effects"){const options=parseSceneEffectsArguments(argumentsValue,"draft");return await this.withSceneAdmission(async()=>await this.planSceneEffects(options))}if(name==="check_scene_behavior"){const options=parseSceneBehaviorArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.checkSceneBehavior(options))}if(name==="audit_scene_behavior"){const options=parseSceneBehaviorAuditArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.auditSceneBehavior(options))}if(name==="audit_scene_temporal"){const options=parseSceneTemporalArguments(argumentsValue);return await this.withSceneAdmission(async()=>await this.auditSceneTemporal(options))}throw new ToolFailure("UNKNOWN_TOOL","Requested tool is not available.")}catch(error){return failureResult(error)}}wrapSemanticResult(operation,result){if(result.isError===true)return result;return{content:result.content,structuredContent:{ok:true,operation,result:result.structuredContent??{}}}}async execute(options){if(options.operation==="slopcamera.diagram.check"){const input=parseSlopcameraOperationInput(options.operation,options.input);return this.wrapSemanticResult(options.operation,await this.withHostAdmission(options.operation,async()=>await this.check({path:input.path})))}if(options.operation==="slopcamera.diagram.render"){const input=parseSlopcameraOperationInput(options.operation,options.input);return this.enqueueRender(async()=>await this.withHostAdmission(options.operation,async()=>this.wrapSemanticResult(options.operation,await this.render({path:input.path,...input.outDirectory===undefined?{}:{outDirectory:input.outDirectory},scale:input.scale??defaultScale}))))}if(options.operation==="slopcamera.image.vectorize"){const input=parseSlopcameraOperationInput(options.operation,options.input);return this.enqueueRender(async()=>await this.withHostAdmission(options.operation,async(lease)=>{const source=await this.boundary.resolveInputFile(input.inputPath,vectorizeHardLimits.maxInputBytes);const output=await this.boundary.prepareOutputFile(input.outputPath);const result=await vectorizeImage(source.absolutePath,{outputPath:output.absolutePath,...input.duotone===undefined?{}:{duotone:input.duotone},...input.alphaCutoff===undefined?{}:{alphaCutoff:input.alphaCutoff},...input.timeoutMs===undefined?{}:{limits:{maxDurationMs:input.timeoutMs}},inheritedFileDescriptors:[lease.inheritedFileDescriptor]});return successResult(`Executed ${options.operation}: ${output.relativePath}`,{ok:true,operation:options.operation,result:{inputPath:source.relativePath,outputPath:output.relativePath,receipt:result.receipt}})}))}if(options.operation==="slopcamera.image.gallery"){const input=parseSlopcameraOperationInput(options.operation,options.input);return await this.withHostAdmission(options.operation,async()=>{const output=await this.boundary.prepareOutputDirectory(input.outputDir);const receipt=await generateSlopcameraImageGallery({...input,outputDir:output.absolutePath},this.generateDependencies);return successResult(`Executed ${options.operation}: ${receipt.counts.generated}/${receipt.counts.requested} candidates in ${output.relativePath}.`,{ok:true,operation:options.operation,result:{...receipt,outputDir:output.relativePath}})})}return await this.withHostAdmission(options.operation,async()=>{const input=parseSlopcameraOperationInput(options.operation,options.input);const output=await this.boundary.prepareOutputFile(input.outputPath);const generated=await generateSlopcameraImageFile({...input,outputPath:output.absolutePath},this.generateDependencies);return successResult(`Executed ${options.operation}: ${output.relativePath} (request ${safeFragment(generated.requestId,256)}).`,{ok:true,operation:options.operation,result:{bytes:generated.bytes,mediaType:generated.mediaType,model:generated.model,outputPath:output.relativePath,provider:generated.provider,requestId:generated.requestId,sha256:generated.sha256,warnings:generated.warnings}})})}async check(options){const{source,spec}=await loadDiagram(this.boundary,options.path);const allFindings=lintDiagram(spec);const findings=publicFindings(allFindings);const summary=diagramSummary(spec,allFindings.length,findings.length);const text=allFindings.length===0?`Checked ${source.relativePath}: no findings.`:`Checked ${source.relativePath}: ${allFindings.length} finding${allFindings.length===1?"":"s"}; ${findings.length} returned in structured content${findings.length<allFindings.length?" (truncated)":""}.`;return successResult(text,{ok:true,source:source.relativePath,findings,summary})}async render(options){const{source,spec}=await loadDiagram(this.boundary,options.path);assertRenderLimits(spec,options.scale);const outputDirectory=await this.boundary.prepareOutputDirectory(options.outDirectory??portableDirectory(source.relativePath));const tldr=serializeTldr(spec,builtInConfig);const[light,dark]=await Promise.all([renderSvg(spec,"light",builtInConfig),renderSvg(spec,"dark",builtInConfig)]);const lightPng=renderPng(light,builtInConfig,options.scale);const darkPng=renderPng(dark,builtInConfig,options.scale);const absoluteArtifacts={spec:source.absolutePath,tldr:join4(outputDirectory.absolutePath,`${spec.name}.tldr`),lightSvg:join4(outputDirectory.absolutePath,`${spec.name}.light.svg`),darkSvg:join4(outputDirectory.absolutePath,`${spec.name}.dark.svg`),lightPng:join4(outputDirectory.absolutePath,`${spec.name}.light.png`),darkPng:join4(outputDirectory.absolutePath,`${spec.name}.dark.png`)};await Promise.all([atomicOverwrite(absoluteArtifacts.tldr,tldr),atomicOverwrite(absoluteArtifacts.lightSvg,light.svg),atomicOverwrite(absoluteArtifacts.darkSvg,dark.svg),atomicOverwrite(absoluteArtifacts.lightPng,lightPng),atomicOverwrite(absoluteArtifacts.darkPng,darkPng)]);const artifacts={tldr:this.boundary.toRelativePath(absoluteArtifacts.tldr),lightSvg:this.boundary.toRelativePath(absoluteArtifacts.lightSvg),darkSvg:this.boundary.toRelativePath(absoluteArtifacts.darkSvg),lightPng:this.boundary.toRelativePath(absoluteArtifacts.lightPng),darkPng:this.boundary.toRelativePath(absoluteArtifacts.darkPng)};const allFindings=lintDiagram(spec);const findings=publicFindings(allFindings);const summary=diagramSummary(spec,allFindings.length,findings.length);const text=[`Rendered ${source.relativePath} with built-in assets:`,...Object.values(artifacts).map((artifact)=>`- ${artifact}`)].join(`
+`);return successResult(text,{ok:true,source:source.relativePath,scale:options.scale,findings,artifacts,summary})}async checkScene(options){const{source,scene}=await loadScene(this.boundary,options.path);const summary={durationUs:scene.durationUs,entityCount:scene.entities.length,cameraCount:scene.cameras.length,assetCount:scene.assets.length,animationCount:scene.animations.length,generatorCount:scene.generators.length,overrideCount:scene.overrides.length};return successResult(`Checked ${source.relativePath}: scene ${safeFragment(scene.sceneId,128)} is valid (${summary.entityCount} entities, ${summary.cameraCount} cameras).`,{ok:true,source:source.relativePath,sceneId:scene.sceneId,sceneSha256:spatialValueSha256(scene),summary})}async inspectScene(options){const{source,scene}=await loadScene(this.boundary,options.path);const inspection=inspectSpatialScene(scene);const entities=boundedSlice(inspection.entities,mcpMaximumReturnedEntities);const summary={entityCount:inspection.entities.length,returnedEntityCount:entities.length,entitiesTruncated:entities.length<inspection.entities.length};return successResult(`Inspected ${source.relativePath}: ${summary.entityCount} entities${summary.entitiesTruncated?`, first ${summary.returnedEntityCount} returned in structured content`:""}.`,{ok:true,source:source.relativePath,inspection:{...inspection,entities},summary})}async auditScene(options){const{source,scene}=await loadScene(this.boundary,options.path);const report=auditSpatialScene(scene,{cameraId:options.cameraId,...options.timesUs===undefined?{}:{timesUs:options.timesUs},...options.assetBounds===undefined?{}:{assetBounds:normalizeSpatialAuditAssetBounds(options.assetBounds)}});let sampleBudget=mcpMaximumReturnedAuditSamples;const entities=[];for(const entity of report.entities){if(entities.length>=mcpMaximumReturnedEntities||entity.samples.length>sampleBudget){break}sampleBudget-=entity.samples.length;entities.push(entity)}const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const findingCount=report.findings.length+report.omittedFindings;const summary={findingCount,returnedFindingCount:findings.length,findingsTruncated:findings.length<findingCount,entityCount:report.entities.length,returnedEntityCount:entities.length,entitiesTruncated:entities.length<report.entities.length};return successResult(`Audited ${source.relativePath} under ${options.cameraId}: ${findingCount} finding${findingCount===1?"":"s"} across ${report.entities.length} entities and ${report.timesUs.length} samples${summary.findingsTruncated||summary.entitiesTruncated?" (truncated)":""}.`,{ok:true,source:source.relativePath,report:{...report,entities,findings},summary})}async diffScenes(options){const{source,scene}=await loadScene(this.boundary,options.path);const other=await loadScene(this.boundary,options.other);const entries=diffSpatialScenes(scene,other.scene);const diff=boundedSlice(entries,mcpMaximumReturnedDiffEntries);const summary={entryCount:entries.length,returnedEntryCount:diff.length,diffTruncated:diff.length<entries.length};return successResult(`Diffed ${source.relativePath} against ${other.source.relativePath}: ${summary.entryCount} entr${summary.entryCount===1?"y":"ies"}${summary.diffTruncated?`, first ${summary.returnedEntryCount} returned in structured content`:""}.`,{ok:true,source:source.relativePath,other:other.source.relativePath,sceneSha256:spatialValueSha256(scene),otherSha256:spatialValueSha256(other.scene),diff,summary})}async evaluateScene(options){const{source,scene}=await loadScene(this.boundary,options.path);const snapshot=evaluateSpatialScene(scene,{timeUs:options.timeUs,cameraId:options.cameraId});const entities=boundedSlice(snapshot.entities,mcpMaximumReturnedEntities);const summary={entityCount:snapshot.entities.length,returnedEntityCount:entities.length,entitiesTruncated:entities.length<snapshot.entities.length};return successResult(`Evaluated ${source.relativePath} at timeUs ${options.timeUs} under ${options.cameraId}: ${summary.entityCount} entities${summary.entitiesTruncated?`, first ${summary.returnedEntityCount} returned in structured content`:""}.`,{ok:true,source:source.relativePath,snapshot:{...snapshot,entities},summary})}async checkSceneDirection(options){const{source,scene}=await loadScene(this.boundary,options.scene);const direction=await loadJson(this.boundary,options.direction,"Direction source");const report=checkSpatialDirection({direction:direction.value,scene});const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const summary={findingCount:report.findings.length,returnedFindingCount:findings.length,findingsTruncated:findings.length<report.findings.length,errorCount:report.counts.errors,warningCount:report.counts.warnings};return successResult(`Checked direction ${direction.source.relativePath} against ${source.relativePath}: ${summary.findingCount} finding${summary.findingCount===1?"":"s"} (${summary.errorCount} errors).`,{ok:summary.errorCount===0,source:source.relativePath,report:{...report,findings},summary})}async planSceneDirection(options){const{source,scene}=await loadScene(this.boundary,options.scene);const direction=await loadJson(this.boundary,options.direction,"Direction source");const compilation=compileSpatialDirection({direction:direction.value,scene,...options.cameraId===undefined?{}:{cameraId:options.cameraId}});const summary={advisoryCount:compilation.advisories.length,unresolvedIntentCount:compilation.unresolvedIntents.length,proposalCounts:{performance:compilation.proposals.performance.length,cameraRigs:compilation.proposals.cameraRigs.length,shots:compilation.proposals.shots.length,lookIntents:compilation.proposals.lookIntents.length}};return successResult(`Compiled direction ${direction.source.relativePath}: ${compilation.proposals.shots.length} shot proposals, ${compilation.advisories.length} advisories; all proposals remain unverified.`,{ok:true,source:source.relativePath,compilation,summary})}async planSceneGallery(options){const{source,scene}=await loadScene(this.boundary,options.scene);const direction=await loadJson(this.boundary,options.direction,"Direction source");const gallery=planSpatialDirectionGallery({axis:options.axis,direction:direction.value,scene,...options.cameraId===undefined?{}:{cameraId:options.cameraId}});const summary={axis:gallery.axis,candidateCount:gallery.candidates.length,selected:false};return successResult(`Planned a ${gallery.axis} gallery from ${direction.source.relativePath}: ${gallery.candidates.length} content-addressed candidates; none selected.`,{ok:true,source:source.relativePath,gallery,summary})}async checkSceneEffects(options){const{source,scene}=await loadScene(this.boundary,options.scene);const effects=await loadJson(this.boundary,options.effects,"Effects source");const report=checkSpatialRenderEffects({effects:effects.value,scene});const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const summary={findingCount:report.findings.length,returnedFindingCount:findings.length,findingsTruncated:findings.length<report.findings.length,errorCount:report.counts.errors,warningCount:report.counts.warnings};return successResult(`Checked effects ${effects.source.relativePath} against ${source.relativePath}: ${summary.findingCount} finding${summary.findingCount===1?"":"s"} (${summary.errorCount} errors).`,{ok:summary.errorCount===0,source:source.relativePath,report:{...report,findings},summary})}async planSceneEffects(options){const{source,scene}=await loadScene(this.boundary,options.scene);const draft=await loadJson(this.boundary,options.effects,"Effects draft");if(!isRecord2(draft.value)){throw new ToolFailure("INVALID_ARGUMENTS","Effects draft must be a JSON object with renderPlan, particleSystems and simulationBakes fields.")}const binding=planSpatialRenderEffects({...draft.value,scene});const summary={documentSha256:binding.documentSha256,particleSystemCount:binding.document.particleSystems.length,simulationBakeCount:binding.document.simulationBakes.length};return successResult(`Bound effects draft ${draft.source.relativePath} to scene ${summary.documentSha256.slice(0,16)}\u2026: ${summary.particleSystemCount} particle systems, ${summary.simulationBakeCount} simulation bakes.`,{ok:true,source:source.relativePath,binding,summary})}async checkSceneBehavior(options){const{source,scene}=await loadScene(this.boundary,options.scene);const behavior=await loadJson(this.boundary,options.behavior,"Behavior source");const report=checkSpatialBehavior({behavior:behavior.value,scene},spatialBehaviorFnSignatures());const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const summary={findingCount:report.findings.length,returnedFindingCount:findings.length,findingsTruncated:findings.length<report.findings.length,errorCount:report.counts.errors,warningCount:report.counts.warnings};return successResult(`Checked behavior ${behavior.source.relativePath} against ${source.relativePath}: ${summary.findingCount} finding${summary.findingCount===1?"":"s"} (${summary.errorCount} errors).`,{ok:summary.errorCount===0,source:source.relativePath,report:{...report,findings},summary})}async auditSceneBehavior(options){const bake=await loadJson(this.boundary,options.bake,"Behavior bake source");const document=parseSpatialValue(SpatialBehaviorBakeSchema,bake.value,"behavior bake");const report=auditSpatialBehaviorTrace({behaviorSha256:document.behaviorSha256,emittedSha256:document.receipt.emittedSha256,emitted:document.emitted,rangeUs:document.rangeUs});const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const summary={findingCount:report.findings.length,channelCount:report.channelCount,emittedCount:report.emittedCount};return successResult(`Audited behavior bake ${bake.source.relativePath}: ${summary.findingCount} finding${summary.findingCount===1?"":"s"} across ${summary.channelCount} channel${summary.channelCount===1?"":"s"}.`,{ok:true,source:bake.source.relativePath,report:{...report,findings},summary})}async auditSceneTemporal(options){const{source,scene}=await loadScene(this.boundary,options.path);const times=options.timesUs??(()=>{const count=Math.min(17,Math.max(2,Math.ceil(scene.durationUs/1e6)+1));return Array.from({length:count},(_value,index)=>Math.floor(scene.durationUs*index/(count-1)))})();const contacts=options.contacts===undefined?[]:parseSpatialValue(SpatialTemporalContactsFileSchema,(await loadJson(this.boundary,options.contacts,"Contacts source")).value,"temporal contacts").contacts;const context=createSpatialEvaluationContext(scene);const snapshots=[...times].sort((left,right)=>left-right).map((timeUs)=>evaluateSpatialSceneInContext(context,{cameraId:options.cameraId,timeUs}));const report=auditSpatialTemporalEvidence({snapshots,options:{contacts,...options.cutBeforeUs===undefined?{}:{cutBeforeUs:[...options.cutBeforeUs]}}});const findings=boundedSlice(report.findings,mcpMaximumReturnedFindings);const findingCount=report.findings.length+report.omittedFindings;const summary={findingCount,returnedFindingCount:findings.length,findingsTruncated:findings.length<findingCount,sampleCount:report.sampleCount};return successResult(`Audited ${source.relativePath} over ${report.sampleCount} samples under ${options.cameraId}: ${findingCount} temporal finding${findingCount===1?"":"s"}${summary.findingsTruncated?" (truncated)":""}.`,{ok:true,source:source.relativePath,report:{...report,findings},summary})}}var slopcameraMcpProtocolVersion="2025-11-25";var slopcameraMcpServerName="hraness-slopcamera";var maximumMessageBytes=1024*1024;function isRecord3(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function isJsonRpcId(value){return typeof value==="string"||typeof value==="number"&&Number.isSafeInteger(value)}function isInitializeParams(value){return isRecord3(value)&&typeof value.protocolVersion==="string"&&isRecord3(value.capabilities)&&isRecord3(value.clientInfo)&&typeof value.clientInfo.name==="string"&&typeof value.clientInfo.version==="string"}function parseRequest(value){if(!isRecord3(value)||value.jsonrpc!=="2.0"||typeof value.method!=="string"||value.method.length===0||"id"in value&&!isJsonRpcId(value.id)){throw new Error("invalid request")}return{jsonrpc:"2.0",..."id"in value?{id:value.id}:{},method:value.method,..."params"in value?{params:value.params}:{}}}function success(id,result){return{jsonrpc:"2.0",id,result}}function failure(id,code,message){return{jsonrpc:"2.0",id,error:{code,message}}}function parseToolCall(params){if(!isRecord3(params)||typeof params.name!=="string"||params.arguments!==undefined&&!isRecord3(params.arguments)){throw new Error("invalid params")}const unknownKeys=Object.keys(params).filter((key)=>key!=="name"&&key!=="arguments");if(unknownKeys.length>0)throw new Error("invalid params");return{name:params.name,argumentsValue:params.arguments??{}}}class SlopcameraMcpSession{runtime;serverVersion;state="new";constructor(runtime,serverVersion){this.runtime=runtime;this.serverVersion=serverVersion}async handle(value){let request;try{request=parseRequest(value)}catch{return failure(null,-32600,"Invalid Request")}const notification=request.id===undefined;if(request.method==="notifications/initialized"){if(!notification){return failure(request.id,-32600,"Invalid Request")}if(this.state==="initializing")this.state="ready";return null}if(notification)return null;const id=request.id;if(request.method==="initialize"){if(this.state!=="new"||!isInitializeParams(request.params)){return failure(id,-32602,"Invalid initialize parameters")}this.state="initializing";return success(id,{protocolVersion:slopcameraMcpProtocolVersion,capabilities:{tools:{listChanged:false}},serverInfo:{name:slopcameraMcpServerName,version:this.serverVersion},instructions:"Use check_diagram/render_diagram, the read-only scene tools (check_scene, inspect_scene, audit_scene, diff_scenes, evaluate_scene), or search_slopcamera followed by execute_slopcamera with an exact registry code and typed JSON. Local paths are root-relative; source code is never accepted or evaluated."})}if(this.state!=="ready"){return failure(id,-32002,"Server is not initialized")}if(request.method==="ping")return success(id,{});if(request.method==="tools/list"){if(request.params!==undefined&&(!isRecord3(request.params)||Object.keys(request.params).length>0)){return failure(id,-32602,"Invalid tools/list parameters")}return success(id,{tools:slopcameraMcpTools})}if(request.method==="tools/call"){try{const toolCall=parseToolCall(request.params);if(!slopcameraMcpTools.some((tool)=>tool.name===toolCall.name)){return failure(id,-32602,"Unknown tool")}return success(id,await this.runtime.call(toolCall.name,toolCall.argumentsValue))}catch{return failure(id,-32602,"Invalid tools/call parameters")}}return failure(id,-32601,"Method not found")}}async function defaultWriteLine(line){await new Promise((resolve5,reject)=>{process.stdout.write(`${line}
+`,(error)=>{if(error===null||error===undefined)resolve5();else reject(error)})})}function defaultInput(){return process.stdin}async function emitResponse(writeLine,response){await writeLine(JSON.stringify(response))}async function processLine(line,session,writeLine){if(line.byteLength===0)return;let value;try{const text=new TextDecoder("utf-8",{fatal:true}).decode(line);if(text.trim()==="")return;value=JSON.parse(text)}catch{await emitResponse(writeLine,failure(null,-32700,"Parse error"));return}if(Array.isArray(value)){await emitResponse(writeLine,failure(null,-32600,"Invalid Request"));return}const response=await session.handle(value);if(response!==null)await emitResponse(writeLine,response)}async function runMcpServer(options={}){const runtime=await SlopcameraMcpToolRuntime.create(options.rootDirectory??process.cwd(),options.generateDependencies,options.hostResourceCoordinator);const session=new SlopcameraMcpSession(runtime,options.serverVersion??SLOPCAMERA_VERSION);const writeLine=options.writeLine??defaultWriteLine;let buffered=Buffer.alloc(0);for await(const chunk of options.input??defaultInput()){const bytes=typeof chunk==="string"?Buffer.from(chunk,"utf8"):Buffer.from(chunk);buffered=Buffer.concat([buffered,bytes]);if(buffered.byteLength>maximumMessageBytes&&!buffered.includes(10)){buffered=Buffer.alloc(0);await emitResponse(writeLine,failure(null,-32700,"Parse error"));continue}for(;;){const newline=buffered.indexOf(10);if(newline===-1)break;let line=buffered.subarray(0,newline);buffered=buffered.subarray(newline+1);if(line.at(-1)===13)line=line.subarray(0,-1);if(line.byteLength>maximumMessageBytes){await emitResponse(writeLine,failure(null,-32700,"Parse error"))}else{await processLine(line,session,writeLine)}}}if(buffered.byteLength>0){if(buffered.byteLength>maximumMessageBytes){await emitResponse(writeLine,failure(null,-32700,"Parse error"))}else{await processLine(buffered,session,writeLine)}}}import{z}from"zod";var SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS=Object.freeze({bytes:4*1024*1024,commands:256,evidence:64,modules:64,operations:512,profiles:128,requirements:32,tools:128,workflows:128});var identifier=z.string().min(1).max(192).regex(/^[a-z][a-z0-9]*(?:[-_.:/@][a-z0-9]+)*$/u);var commandName=z.string().min(1).max(128).regex(/^[a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*){0,3}$/u);var digest=z.string().regex(/^[a-f0-9]{64}$/u);var positiveSafeInteger=z.number().int().safe().positive();var nonnegativeSafeInteger=z.number().int().safe().nonnegative();var SlopcameraCapabilityEffectSchema=z.enum(["pure","local-read","local-derived-write","project-mutation","paid-cloud","live-control"]);var SlopcameraCapabilityResumeSchema=z.enum(["deterministic","verified-receipt","recoverable-transaction","ambiguous-after-dispatch","non-resumable-live"]);var SlopcameraCapabilityResourceSchema=z.enum(["cpu","local-io","ffmpeg","vision","whisper","network","paid-call","project-render","project-publication","output-publication","capture-device","browser"]);var SlopcameraCapabilityPreparationSchema=z.enum(["project-state","recording-metadata","screen-capture","camera","microphone","system-audio","typed-text","window-metadata","local-media","provider-options"]);var SlopcameraCapabilityOperationSchema=z.strictObject({cache:z.enum(["none","exact-run","content-addressed"]),cancellable:z.boolean(),effect:SlopcameraCapabilityEffectSchema,inputSchemaId:identifier,key:z.string().min(3).max(256).regex(/^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*@[1-9][0-9]*$/u),kind:z.string().min(3).max(192).regex(/^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*(?:\.[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*)+$/u),lifecycle:z.enum(["pure","local-artifact","project-transaction","paid-dispatch","live-control"]),maxDurationMs:positiveSafeInteger,maxFanOut:nonnegativeSafeInteger,maxInputBytes:nonnegativeSafeInteger,maxOutputBytes:nonnegativeSafeInteger,outputSchemaId:identifier,preparation:z.array(SlopcameraCapabilityPreparationSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.requirements),resources:z.array(z.strictObject({amount:positiveSafeInteger,resource:SlopcameraCapabilityResourceSchema})).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.requirements),resume:SlopcameraCapabilityResumeSchema,version:positiveSafeInteger}).superRefine((operation,context)=>{if(operation.key!==`${operation.kind}@${operation.version}`){context.addIssue({code:"custom",path:["key"],message:"Operation key must match kind and version."})}if(new Set(operation.preparation).size!==operation.preparation.length){context.addIssue({code:"custom",path:["preparation"],message:"Operation preparation entries must be unique."})}const resources=operation.resources.map((claim)=>claim.resource);if(new Set(resources).size!==resources.length){context.addIssue({code:"custom",path:["resources"],message:"Operation resource claims must be unique by resource."})}});var SlopcameraCapabilityWorkflowSchema=z.strictObject({id:identifier,inputSchemaId:identifier,key:z.string().min(3).max(256).regex(/^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*@[1-9][0-9]*$/u),version:positiveSafeInteger}).superRefine((workflow,context)=>{if(workflow.key!==`${workflow.id}@${workflow.version}`){context.addIssue({code:"custom",path:["key"],message:"Workflow key must match id and version."})}});var SlopcameraCapabilityToolSchema=z.strictObject({destructive:z.boolean(),idempotent:z.boolean(),name:z.string().min(1).max(128).regex(/^[a-z][a-z0-9_]*$/u),openWorld:z.boolean(),readOnly:z.boolean()}).superRefine((tool,context)=>{if(tool.readOnly&&tool.destructive){context.addIssue({code:"custom",message:"A read-only tool cannot be destructive."})}});var SlopcameraCapabilityCommandSchema=z.strictObject({effect:SlopcameraCapabilityEffectSchema,name:commandName});var SlopcameraCapabilityQualificationSchema=z.strictObject({evidence:z.array(z.string().min(1).max(512)).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.evidence),level:z.enum(["unit","fixture","browser","native","provider"]),status:z.enum(["qualified","conditional","not-qualified"])}).superRefine((qualification,context)=>{if(qualification.status!=="not-qualified"&&qualification.evidence.length===0){context.addIssue({code:"custom",path:["evidence"],message:"Qualified or conditional profiles require evidence references."})}});var SlopcameraCapabilityProfileSchema=z.strictObject({id:identifier,kind:z.enum(["renderer","native-adapter","provider","authoring","interchange"]),qualification:SlopcameraCapabilityQualificationSchema,requirements:z.array(z.strictObject({description:z.string().min(1).max(256),id:identifier,optional:z.boolean()})).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.requirements)});var SlopcameraCapabilityModuleDeclarationSchema=z.strictObject({commands:z.array(SlopcameraCapabilityCommandSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.commands),description:z.string().min(1).max(1024),moduleId:z.string().min(1).max(128).regex(/^slopcamera\.capability\.[a-z][a-z0-9-]*$/u),operationKeys:z.array(z.string().min(3).max(256)).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.operations),profiles:z.array(SlopcameraCapabilityProfileSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.profiles),stability:z.enum(["stable","experimental"]),title:z.string().min(1).max(160),toolNames:z.array(z.string().min(1).max(128)).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.tools),trust:z.enum(["portable","local-effects","trusted-authoring","native-adapter","paid-provider"]),version:positiveSafeInteger,workflowKeys:z.array(z.string().min(3).max(256)).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.workflows)}).superRefine((module,context)=>{if(module.commands.length+module.operationKeys.length+module.profiles.length+module.toolNames.length+module.workflowKeys.length===0){context.addIssue({code:"custom",message:"A capability module must expose at least one command, operation, profile, tool, or workflow."})}for(const[name,values]of[["operationKeys",module.operationKeys],["toolNames",module.toolNames],["workflowKeys",module.workflowKeys]]){if(new Set(values).size!==values.length){context.addIssue({code:"custom",path:[name],message:`${name} must be unique within a capability module.`})}}});var SlopcameraCapabilityModuleSchema=z.strictObject({commands:z.array(SlopcameraCapabilityCommandSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.commands),description:z.string().min(1).max(1024),moduleId:z.string().min(1).max(128).regex(/^slopcamera\.capability\.[a-z][a-z0-9-]*$/u),operations:z.array(SlopcameraCapabilityOperationSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.operations),profiles:z.array(SlopcameraCapabilityProfileSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.profiles),stability:z.enum(["stable","experimental"]),title:z.string().min(1).max(160),tools:z.array(SlopcameraCapabilityToolSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.tools),trust:z.enum(["portable","local-effects","trusted-authoring","native-adapter","paid-provider"]),version:positiveSafeInteger,workflows:z.array(SlopcameraCapabilityWorkflowSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.workflows)}).superRefine((module,context)=>{const identities=[["commands",module.commands.map((value)=>value.name)],["operations",module.operations.map((value)=>value.key)],["profiles",module.profiles.map((value)=>value.id)],["tools",module.tools.map((value)=>value.name)],["workflows",module.workflows.map((value)=>value.key)]];if(identities.every(([,values])=>values.length===0)){context.addIssue({code:"custom",message:"A capability module must expose at least one command, operation, profile, tool, or workflow."})}for(const[name,values]of identities){if(new Set(values).size!==values.length)context.addIssue({code:"custom",path:[name],message:`${name} must be unique within a capability module.`})}});var manifestBodyBaseSchema=z.strictObject({host:z.enum(["portable","local"]),kind:z.literal("slopcamera.capability-manifest"),modules:z.array(SlopcameraCapabilityModuleSchema).min(1).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.modules),schemaVersion:z.literal(1),toolVersion:z.string().min(1).max(128)});function validateManifestOwnership(manifest,context){const ownership=new Map;for(const[moduleIndex,module]of manifest.modules.entries()){for(const identity of[module.moduleId,...module.commands.map((value)=>`command:${value.name}`),...module.operations.map((value)=>`operation:${value.key}`),...module.profiles.map((value)=>`profile:${value.id}`),...module.tools.map((value)=>`tool:${value.name}`),...module.workflows.map((value)=>`workflow:${value.key}`)]){const owner=ownership.get(identity);if(owner!==undefined)context.addIssue({code:"custom",path:["modules",moduleIndex],message:`${identity} is owned by both ${owner} and ${module.moduleId}.`});ownership.set(identity,module.moduleId)}if(manifest.host==="portable"&&module.trust!=="portable"){context.addIssue({code:"custom",path:["modules",moduleIndex,"trust"],message:"Portable manifests may contain only portable capability modules."})}}}var manifestBodySchema=manifestBodyBaseSchema.superRefine(validateManifestOwnership);var SlopcameraCapabilityManifestSchema=manifestBodyBaseSchema.extend({manifestSha256:digest}).superRefine(validateManifestOwnership);var compilerInputSchema=z.strictObject({host:z.enum(["portable","local"]),modules:z.array(SlopcameraCapabilityModuleDeclarationSchema).min(1).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.modules),operations:z.array(SlopcameraCapabilityOperationSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.operations),tools:z.array(SlopcameraCapabilityToolSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.tools),toolVersion:z.string().min(1).max(128),workflows:z.array(SlopcameraCapabilityWorkflowSchema).max(SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.workflows)});function compareBy(key){return(left,right)=>left[key].localeCompare(right[key])}function indexed(values,key,label){const result=new Map;for(const value of values){const identity=key(value);if(result.has(identity))throw new TypeError(`Duplicate ${label}: ${identity}.`);result.set(identity,value)}return result}function assertExactOwnership(label,available,owners){for(const key of available.keys()){if(!owners.has(key))throw new TypeError(`Unowned ${label}: ${key}.`)}for(const key of owners.keys()){if(!available.has(key))throw new TypeError(`Unknown ${label} declared by a capability module: ${key}.`)}}function defineSlopcameraCapabilityModule(input){return deepFreezeJson(SlopcameraCapabilityModuleDeclarationSchema.parse(createBoundedJsonValueSnapshot(input,SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.bytes,"capability module").value))}function compileSlopcameraCapabilityManifest(input){const parsed=compilerInputSchema.parse(createBoundedJsonValueSnapshot(input,SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.bytes,"capability manifest compiler input").value);const operations=indexed(parsed.operations,(value)=>value.key,"operation inventory key");const workflows=indexed(parsed.workflows,(value)=>value.key,"workflow inventory key");const tools=indexed(parsed.tools,(value)=>value.name,"tool inventory name");const operationOwners=new Map;const workflowOwners=new Map;const toolOwners=new Map;const moduleIds=new Set;const commandOwners=new Map;const profileOwners=new Map;const claim=(owners,key,moduleId,label)=>{const owner=owners.get(key);if(owner!==undefined)throw new TypeError(`${label} ${key} is owned by both ${owner} and ${moduleId}.`);owners.set(key,moduleId)};const modules=[...parsed.modules].sort(compareBy("moduleId")).map((module)=>{if(moduleIds.has(module.moduleId))throw new TypeError(`Duplicate capability module: ${module.moduleId}.`);moduleIds.add(module.moduleId);for(const command of module.commands)claim(commandOwners,command.name,module.moduleId,"Command");for(const profile of module.profiles)claim(profileOwners,profile.id,module.moduleId,"Profile");const resolvedOperations=module.operationKeys.map((key)=>{claim(operationOwners,key,module.moduleId,"Operation");const value=operations.get(key);if(value===undefined)throw new TypeError(`Unknown operation declared by ${module.moduleId}: ${key}.`);return value}).sort(compareBy("key"));const resolvedWorkflows=module.workflowKeys.map((key)=>{claim(workflowOwners,key,module.moduleId,"Workflow");const value=workflows.get(key);if(value===undefined)throw new TypeError(`Unknown workflow declared by ${module.moduleId}: ${key}.`);return value}).sort(compareBy("key"));const resolvedTools=module.toolNames.map((name)=>{claim(toolOwners,name,module.moduleId,"Tool");const value=tools.get(name);if(value===undefined)throw new TypeError(`Unknown tool declared by ${module.moduleId}: ${name}.`);return value}).sort(compareBy("name"));const{operationKeys:_operationKeys,toolNames:_toolNames,workflowKeys:_workflowKeys,...metadata}=module;return{...metadata,commands:[...module.commands].sort(compareBy("name")),operations:resolvedOperations,profiles:[...module.profiles].sort(compareBy("id")),tools:resolvedTools,workflows:resolvedWorkflows}});assertExactOwnership("operation",operations,operationOwners);assertExactOwnership("workflow",workflows,workflowOwners);assertExactOwnership("tool",tools,toolOwners);const body=manifestBodySchema.parse({host:parsed.host,kind:"slopcamera.capability-manifest",modules,schemaVersion:1,toolVersion:parsed.toolVersion});return deepFreezeJson(SlopcameraCapabilityManifestSchema.parse({...body,manifestSha256:canonicalJsonSha256(body)}))}function parseSlopcameraCapabilityManifest(input){const manifest=SlopcameraCapabilityManifestSchema.parse(createBoundedJsonValueSnapshot(input,SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS.bytes,"capability manifest").value);const{manifestSha256,...body}=manifest;const actual=canonicalJsonSha256(body);if(actual!==manifestSha256)throw new TypeError(`Capability manifest digest mismatch: expected ${manifestSha256}, received ${actual}.`);return deepFreezeJson(manifest)}var SLOPCAMERA_PORTABLE_CAPABILITY_VERSION="slopcamera-portable-v1";var portableModule=defineSlopcameraCapabilityModule({commands:[],description:"The fixed portable diagram and image operation projection for Bun SDK consumers.",moduleId:"slopcamera.capability.portable-diagram-image",operationKeys:PORTABLE_SLOPCAMERA_OPERATION_KINDS.map((kind)=>`${kind}@2`),profiles:[{id:"portable-bun-v1",kind:"authoring",qualification:{evidence:["src/code/public-operations.ts"],level:"unit",status:"qualified"},requirements:[{description:"Bun 1.3.14 or newer.",id:"bun",optional:false}]}],stability:"stable",title:"Portable diagrams and images",toolNames:[],trust:"portable",version:1,workflowKeys:[]});function operationProjection(kind){const operation=PORTABLE_SLOPCAMERA_OPERATION_CONTRACTS[kind];return{cache:operation.policy.cache,cancellable:operation.policy.cancellable,effect:operation.policy.effect,inputSchemaId:operation.inputSchemaId,key:`${operation.kind}@${operation.version}`,kind:operation.kind,lifecycle:operation.lifecycle,maxDurationMs:operation.policy.maxDurationMs,maxFanOut:operation.policy.maxFanOut,maxInputBytes:operation.policy.maxInputBytes,maxOutputBytes:operation.policy.maxOutputBytes,outputSchemaId:operation.outputSchemaId,preparation:[...operation.policy.preparation],resources:operation.policy.resources.map((claim)=>({...claim})),resume:operation.policy.resume,version:operation.version}}function createPortableSlopcameraCapabilityManifest(){return compileSlopcameraCapabilityManifest({host:"portable",modules:[portableModule],operations:PORTABLE_SLOPCAMERA_OPERATION_KINDS.map(operationProjection),tools:[],toolVersion:SLOPCAMERA_PORTABLE_CAPABILITY_VERSION,workflows:[]})}var slopcameraPortableCapabilityManifest=createPortableSlopcameraCapabilityManifest();import{z as z2}from"zod";var slopcameraSceneGalleryLimits=Object.freeze({variants:16,variantsBytes:1024*1024,idEdge:64,labelEdge:256,summaryEdge:256});var variantId=z2.string().min(1).max(slopcameraSceneGalleryLimits.idEdge).regex(/^[a-z0-9][a-z0-9-]*$/u,"Variant ids are lowercase slugs like dusk or golden-hour-2.");var SceneVariantPatchSchema=z2.strictObject({kind:z2.literal("slopcamera.spatial-scene-patch"),schemaVersion:z2.literal(1),expectedSceneSha256:SpatialDigestSchema.optional(),operations:z2.array(SpatialPatchOperationSchema).min(1).max(SPATIAL_SCENE_LIMITS.patchOperations)});var SceneGalleryVariantSchema=z2.strictObject({id:variantId,label:z2.string().min(1).max(slopcameraSceneGalleryLimits.labelEdge).optional(),patch:SceneVariantPatchSchema});var SlopcameraSceneVariantsSchema=z2.strictObject({kind:z2.literal("slopcamera.scene-variants"),schemaVersion:z2.literal(1),variants:z2.array(SceneGalleryVariantSchema).min(1).max(slopcameraSceneGalleryLimits.variants)});function summarizeSceneVariantPatch(operations){const parts=operations.map((operation)=>{const target=("entityId"in operation?operation.entityId:undefined)??("camera"in operation?operation.camera.cameraId:undefined)??("channel"in operation?operation.channel.channelId:undefined)??("asset"in operation?operation.asset.assetId:undefined)??("generator"in operation?operation.generator.generatorId:undefined)??("entity"in operation?operation.entity.entityId:undefined)??("override"in operation?operation.override.entityId:undefined);return target===undefined?operation.kind:`${operation.kind} ${target}`});const summary=parts.join("; ");return summary.length<=slopcameraSceneGalleryLimits.summaryEdge?summary:`${summary.slice(0,slopcameraSceneGalleryLimits.summaryEdge-1)}\u2026`}function parseSlopcameraSceneVariants(input){const value=createBoundedJsonValueSnapshot(input,slopcameraSceneGalleryLimits.variantsBytes,"scene variants").value;const document=parseSpatialValue(SlopcameraSceneVariantsSchema,value,"scene variants");const ids=new Set;for(const variant of document.variants){if(ids.has(variant.id)){throw new SpatialSceneError("invalid-data",`Duplicate scene variant id ${variant.id}.`,"variants")}ids.add(variant.id)}return document.variants}function planSlopcameraSceneGallery(input){const scene=parseSpatialScene(input.scene);const baseSceneSha256=spatialSceneSha256(scene);const specs=parseSlopcameraSceneVariants(input.variants);const variants=specs.map((spec,offset)=>{const expected=spec.patch.expectedSceneSha256??baseSceneSha256;if(expected!==baseSceneSha256){throw new SpatialSceneError("conflict",`Variant ${spec.id} was authored against a different scene revision.`,"variants")}const patch={...spec.patch,expectedSceneSha256:expected};const result=applySpatialScenePatch(scene,patch);return{diff:result.diff,id:spec.id,index:offset+1,label:spec.label??spec.id,patchSha256:spatialValueSha256(patch),prompt:summarizeSceneVariantPatch(patch.operations),scene:result.scene,sceneSha256:result.sceneSha256}});return{baseSceneSha256,scene,variants}}import{z as z4}from"zod";import{z as z3}from"zod";var STUDIO_LIMITS=Object.freeze({documentBytes:32*1024*1024,documentDepth:32,documentValues:500000,sourceFiles:512,sourceBytes:4*1024**3,outputSpecifications:32,outputFiles:25000,outputBytes:64*1024**3,timeoutSeconds:6*60*60,frames:25000,frameIndexExclusive:1e6,dimension:8192,pixels:33554432,parameterBytes:256*1024,parameterDepth:16,parameterValues:20000});function studioDocument(schema,name){return z3.preprocess((value)=>value===undefined?undefined:createBoundedJsonValueSnapshot(value,STUDIO_LIMITS.documentBytes,name,{maximumDepth:STUDIO_LIMITS.documentDepth,maximumValues:STUDIO_LIMITS.documentValues}).value,schema)}function parseStudioValue(schema,input){try{return deepFreezeJson(schema.parse(input))}catch(error){if(error instanceof SlopcameraCodeError)throw error;throw new SlopcameraCodeError("invalid-data",error instanceof z3.ZodError?error.issues[0]?.message??"Invalid studio document.":"Invalid studio document.")}}function studioHash(domain,value){return boundedCanonicalJsonSha256({domain,value},{maximumBytes:STUDIO_LIMITS.documentBytes,maximumDepth:STUDIO_LIMITS.documentDepth+2,maximumValues:STUDIO_LIMITS.documentValues+4})}var studioCompare=compareUtf16Strings;function studioRequire(condition,message){if(!condition)throw new SlopcameraCodeError("invalid-data",message)}function pathKey(path){return path.toLowerCase()}function assertDistinctPaths(paths){const names=new Set(paths.map(pathKey));studioRequire(names.size===paths.length,"Studio paths collide.");for(const name of names){for(let offset=name.indexOf("/");offset!==-1;offset=name.indexOf("/",offset+1)){studioRequire(!names.has(name.slice(0,offset)),"Studio paths use a file as an ancestor.")}}}var StudioDigestSchema=z4.string().regex(/^[a-f0-9]{64}$/u);var StudioEngineSchema=z4.enum(["blender","manim","cadquery"]);var StudioPathSchema=z4.string().min(1).max(1024).refine((path)=>path.normalize("NFC")===path&&!path.startsWith("/")&&!/[\\:\u0000-\u001f\u007f]/u.test(path)&&path.split("/").every((part)=>part!==""&&part!=="."&&part!==".."&&!/[. ]$/u.test(part)),"Studio paths must be normalized, contained POSIX-relative names.");var identifier2=z4.string().regex(/^[A-Za-z_][A-Za-z0-9_]{0,127}$/u);var stableId=z4.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/u);var sourceFile=z4.strictObject({path:StudioPathSchema,sha256:StudioDigestSchema,bytes:z4.number().int().safe().nonnegative().max(STUDIO_LIMITS.sourceBytes)});var sourceBundleShape=z4.strictObject({kind:z4.literal("slopcamera.studio-source-bundle"),schemaVersion:z4.literal(1),engine:StudioEngineSchema,entrypoint:z4.discriminatedUnion("kind",[z4.strictObject({kind:z4.literal("python"),path:StudioPathSchema.refine((path)=>path.endsWith(".py"))}),z4.strictObject({kind:z4.literal("blend"),path:StudioPathSchema.refine((path)=>path.endsWith(".blend"))})]),files:z4.array(sourceFile).min(1).max(STUDIO_LIMITS.sourceFiles)}).superRefine((value,context)=>{const issue=(message)=>context.addIssue({code:"custom",message});try{assertDistinctPaths(value.files.map((file)=>file.path))}catch{issue("Source paths must be distinct and cannot have file ancestors.")}if(value.files.reduce((total,file)=>total+file.bytes,0)>STUDIO_LIMITS.sourceBytes)issue("Source bundle exceeds four GiB.");if(!value.files.some((file)=>file.path===value.entrypoint.path&&file.bytes>0))issue("Entrypoint must name a declared nonempty source file.");if(value.entrypoint.kind==="blend"&&value.engine!=="blender")issue("Blend entrypoints require Blender.")});var sourceBundle=sourceBundleShape.transform((value)=>({...value,files:[...value.files].sort((a,b)=>studioCompare(a.path,b.path))})).pipe(sourceBundleShape);var StudioSourceBundleSchema=studioDocument(sourceBundle,"studio source bundle");var parseStudioSourceBundle=(input)=>parseStudioValue(StudioSourceBundleSchema,input);var StudioSourceSpaceSchema=z4.strictObject({units:z4.enum(["meters","millimeters","centimeters"]),upAxis:z4.enum(["x","y","z"]),handedness:z4.enum(["right","left"])});var StudioOutputRoleSchema=z4.enum(["native-source","model","beauty","auxiliary","simulation-cache","audio"]);var StudioOutputFormatSchema=z4.enum(["py","blend","usd","usda","usdc","glb","step","png","exr","mp4","mov","webm","wav","flac","mp3","cache"]);var raster=z4.strictObject({kind:z4.literal("raster"),colorSpace:z4.enum(["srgb","linear-rec709","data","unspecified"]),alpha:z4.enum(["opaque","straight","premultiplied","none"]),dataType:z4.enum(["uint8","uint16","float16","float32"]),channels:z4.array(z4.string().regex(/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/u)).min(1).max(32),semantic:z4.enum(["color","depth","normal","object-id","mask","custom"]),unit:z4.enum(["unitless","meters","millimeters","centimeters"])}).superRefine((value,context)=>{if(new Set(value.channels).size!==value.channels.length)context.addIssue({code:"custom",message:"Raster channels must be unique."});if(value.semantic!=="color"&&value.colorSpace!=="data")context.addIssue({code:"custom",message:"Non-color raster passes must declare data color space."});if(value.semantic==="color"&&value.colorSpace==="data")context.addIssue({code:"custom",message:"Color output cannot declare data color space."});if(value.semantic!=="depth"&&value.unit!=="unitless")context.addIssue({code:"custom",message:"Only depth passes declare distance units."})});var StudioOutputInterpretationSchema=z4.discriminatedUnion("kind",[raster,z4.strictObject({kind:z4.literal("model"),sourceSpace:StudioSourceSpaceSchema}),z4.strictObject({kind:z4.literal("native-source")}),z4.strictObject({kind:z4.literal("cache"),semantics:z4.literal("opaque-native")}),z4.strictObject({kind:z4.literal("audio"),sampleRate:z4.number().int().min(8000).max(384000),channels:z4.number().int().min(1).max(32)})]);var outputCommon={id:stableId,role:StudioOutputRoleSchema,format:StudioOutputFormatSchema,interpretation:StudioOutputInterpretationSchema};var pattern=z4.string().max(1024).refine((value)=>value.split("%06d").length===2&&!value.replace("%06d","").includes("%")&&StudioPathSchema.safeParse(value.replace("%06d","000000")).success,"Sequence paths require exactly one %06d placeholder in a safe relative path.");function compatibleOutput(value){if(value.role==="native-source")return["py","blend"].includes(value.format)&&value.interpretation.kind==="native-source";if(value.role==="model")return["blend","usd","usda","usdc","glb","step"].includes(value.format)&&value.interpretation.kind==="model";if(value.role==="simulation-cache")return value.format==="cache"&&value.interpretation.kind==="cache";if(value.role==="audio")return["wav","flac","mp3"].includes(value.format)&&value.interpretation.kind==="audio";return["png","exr","mp4","mov","webm"].includes(value.format)&&value.interpretation.kind==="raster"&&(value.role!=="beauty"||value.interpretation.semantic==="color")}var StudioOutputSpecSchema=z4.discriminatedUnion("kind",[z4.strictObject({...outputCommon,kind:z4.literal("file"),path:StudioPathSchema}),z4.strictObject({...outputCommon,kind:z4.literal("sequence"),pathPattern:pattern}),z4.strictObject({...outputCommon,kind:z4.literal("directory"),path:StudioPathSchema})]).superRefine((value,context)=>{const issue=(message)=>context.addIssue({code:"custom",message});if(!compatibleOutput(value))issue("Output role, format, and interpretation disagree.");if(value.kind==="directory"!==(value.format==="cache"))issue("Only native cache outputs use directory declarations.");if(value.kind==="sequence"&&!["png","exr"].includes(value.format))issue("Numbered sequences support PNG or EXR only.");if(value.kind!=="directory"){const path=value.kind==="sequence"?value.pathPattern:value.path;if(!path.endsWith(`.${value.format}`)&&!(value.format==="step"&&path.endsWith(".stp")))issue("Output extension must agree with its declared format.")}if(value.interpretation.kind==="raster"){if(value.format==="png"&&!["uint8","uint16"].includes(value.interpretation.dataType))issue("PNG declares integer sample data.");if(value.format==="exr"&&!["float16","float32"].includes(value.interpretation.dataType))issue("The admitted EXR profile declares floating point sample data.")}});var frameRateShape=z4.strictObject({numerator:z4.number().int().min(1).max(1e6),denominator:z4.number().int().min(1).max(1e6)}).refine((value)=>value.numerator/value.denominator<=240,"Studio cadence exceeds 240 fps.");var frameRate=frameRateShape.transform((value)=>{let{numerator:a,denominator:b}=value;while(b!==0){const remainder=a%b;a=b;b=remainder}return{numerator:value.numerator/a,denominator:value.denominator/a}}).pipe(frameRateShape);var StudioRenderSchema=z4.strictObject({width:z4.number().int().min(1).max(STUDIO_LIMITS.dimension),height:z4.number().int().min(1).max(STUDIO_LIMITS.dimension),frameRate,startFrame:z4.number().int().nonnegative().max(STUDIO_LIMITS.frameIndexExclusive-1),endFrameExclusive:z4.number().int().positive().max(STUDIO_LIMITS.frameIndexExclusive)}).refine((value)=>value.endFrameExclusive>value.startFrame&&value.endFrameExclusive-value.startFrame<=STUDIO_LIMITS.frames&&value.width*value.height<=STUDIO_LIMITS.pixels,"Render requires a bounded, nonempty half-open frame interval and pixel area.");var StudioEngineOptionsSchema=z4.discriminatedUnion("engine",[z4.strictObject({engine:z4.literal("blender"),renderer:z4.enum(["cycles","eevee"]),device:z4.enum(["cpu","gpu"]),samples:z4.number().int().min(1).max(4096),transparent:z4.boolean(),viewTransform:z4.enum(["AgX","Standard"]),denoise:z4.boolean(),seed:z4.number().int().min(0).max(4294967295)}),z4.strictObject({engine:z4.literal("manim"),scene:identifier2,renderer:z4.literal("cairo"),transparent:z4.boolean()}),z4.strictObject({engine:z4.literal("cadquery"),exportVariable:identifier2,tolerance:z4.number().finite().positive().max(1),angularTolerance:z4.number().finite().positive().max(Math.PI)})]);var parameters=z4.preprocess((value)=>value===undefined?undefined:createBoundedJsonValueSnapshot(value,STUDIO_LIMITS.parameterBytes,"studio parameters",{maximumDepth:STUDIO_LIMITS.parameterDepth,maximumValues:STUDIO_LIMITS.parameterValues}).value,z4.record(z4.string(),z4.unknown()));var StudioExecutionProfileSchema=z4.strictObject({trust:z4.literal("trusted-current-user"),isolation:z4.literal("none"),hermetic:z4.literal(false)});var jobShape=z4.strictObject({kind:z4.literal("slopcamera.studio-job"),schemaVersion:z4.literal(1),jobId:z4.string().regex(/^studio_[a-zA-Z0-9][a-zA-Z0-9_-]{0,120}$/u),bundleSha256:StudioDigestSchema,stage:z4.enum(["build","bake","render"]),parameters,engine:StudioEngineOptionsSchema,render:StudioRenderSchema.optional(),outputs:z4.array(StudioOutputSpecSchema).min(1).max(STUDIO_LIMITS.outputSpecifications),limits:z4.strictObject({timeoutSeconds:z4.number().int().min(1).max(STUDIO_LIMITS.timeoutSeconds),maximumOutputBytes:z4.number().int().safe().min(1).max(STUDIO_LIMITS.outputBytes),maximumOutputFiles:z4.number().int().min(1).max(STUDIO_LIMITS.outputFiles)}),execution:StudioExecutionProfileSchema}).superRefine((value,context)=>{if(value.render===undefined&&(value.stage==="render"&&value.engine.engine!=="cadquery"||value.outputs.some((output)=>output.kind==="sequence"||output.interpretation.kind==="raster")))context.addIssue({code:"custom",message:"Raster outputs, render stage, and numbered sequences require explicit dimensions and a frame interval."});if(new Set(value.outputs.map((output)=>output.id)).size!==value.outputs.length)context.addIssue({code:"custom",message:"Output IDs must be unique."});const count=value.outputs.reduce((sum,output)=>sum+(output.kind==="sequence"&&value.render!==undefined?value.render.endFrameExclusive-value.render.startFrame:1),0);if(count>value.limits.maximumOutputFiles)context.addIssue({code:"custom",message:"Declared outputs exceed the job's output-file limit."})});var job=jobShape.transform((value)=>({...value,outputs:[...value.outputs].sort((a,b)=>studioCompare(a.id,b.id))})).pipe(jobShape);var StudioJobSchema=studioDocument(job,"studio job");var parseStudioJob=(input)=>parseStudioValue(StudioJobSchema,input);var StudioCapabilityNameSchema=z4.enum(["python-authoring","blend-authoring","build","bake","render","gpu-render","image-sequence","beauty-video","model-export","auxiliary-passes","native-cache","audio-output"]);var capability=z4.strictObject({name:StudioCapabilityNameSchema,support:z4.enum(["available","unavailable","unverified"]),evidence:z4.enum(["probe","qualification"]),receiptSha256:StudioDigestSchema.optional()}).refine((value)=>value.evidence!=="qualification"||value.receiptSha256!==undefined,"Qualification evidence requires a retained receipt digest.");var runtimeShape=z4.strictObject({kind:z4.literal("slopcamera.studio-runtime"),schemaVersion:z4.literal(1),engine:StudioEngineSchema,tool:z4.strictObject({name:z4.string().min(1).max(128),version:z4.string().min(1).max(512),executableSha256:StudioDigestSchema}),driverSha256:StudioDigestSchema,environment:z4.strictObject({fingerprintSha256:StudioDigestSchema,evidence:z4.literal("observed-package-environment"),hermetic:z4.literal(false)}),capabilities:z4.array(capability).max(12)}).refine((value)=>new Set(value.capabilities.map((item)=>item.name)).size===value.capabilities.length,"Runtime capability names must be unique.");var runtime=runtimeShape.transform((value)=>({...value,capabilities:[...value.capabilities].sort((a,b)=>studioCompare(a.name,b.name))})).pipe(runtimeShape);var StudioRuntimeIdentitySchema=studioDocument(runtime,"studio runtime identity");var parseStudioRuntimeIdentity=(input)=>parseStudioValue(StudioRuntimeIdentitySchema,input);var StudioOutputArtifactSchema=z4.strictObject({outputId:stableId,path:StudioPathSchema,sha256:StudioDigestSchema,bytes:z4.number().int().safe().positive().max(STUDIO_LIMITS.outputBytes),role:StudioOutputRoleSchema,format:StudioOutputFormatSchema,frame:z4.number().int().nonnegative().max(STUDIO_LIMITS.frameIndexExclusive-1).optional()});import{z as z5}from"zod";var studioSourceBundleSha256=(input)=>studioHash("slopcamera.studio-source-bundle/v1",parseStudioSourceBundle(input));var studioJobSha256=(input)=>studioHash("slopcamera.studio-job/v1",parseStudioJob(input));var studioRuntimeSha256=(input)=>studioHash("slopcamera.studio-runtime/v1",parseStudioRuntimeIdentity(input));function studioOutputPath(output,frame){if(output.kind==="sequence"){studioRequire(Number.isInteger(frame)&&frame>=0&&frame<STUDIO_LIMITS.frameIndexExclusive,"Sequence output requires an admitted frame index.");return output.pathPattern.replace("%06d",String(frame).padStart(6,"0"))}studioRequire(frame===undefined,"Only sequence outputs have a frame index.");return output.path}function declaration(job2){const files=[];const directories=[];for(const output of job2.outputs){if(output.kind==="directory")directories.push({id:output.id,path:output.path});else if(output.kind==="file")files.push({id:output.id,path:output.path});else{studioRequire(job2.render!==undefined,"Sequence requires a render interval.");for(let frame=job2.render.startFrame;frame<job2.render.endFrameExclusive;frame++)files.push({id:output.id,path:studioOutputPath(output,frame),frame})}}studioRequire(files.length+directories.length<=job2.limits.maximumOutputFiles,"Declared outputs exceed the output-file budget.");assertDistinctPaths([...files,...directories].map((item)=>item.path));return{files,directories}}function requiredCapabilities(bundle,job2){const values=new Set([bundle.entrypoint.kind==="blend"?"blend-authoring":"python-authoring",job2.stage]);if(job2.engine.engine==="blender"&&job2.engine.device==="gpu"&&job2.stage==="render")values.add("gpu-render");for(const output of job2.outputs){if(output.kind==="sequence")values.add("image-sequence");if(output.role==="beauty"&&["mov","mp4","webm"].includes(output.format))values.add("beauty-video");if(output.role==="model")values.add("model-export");if(output.role==="auxiliary")values.add("auxiliary-passes");if(output.role==="simulation-cache")values.add("native-cache");if(output.role==="audio")values.add("audio-output")}return[...values].sort(studioCompare)}function derivePlan(input){const{bundle,job:job2,runtime:runtime2}=input;const bundleSha256=studioSourceBundleSha256(bundle),jobSha256=studioJobSha256(job2);studioRequire(bundleSha256===job2.bundleSha256,"Job does not bind the exact source bundle.");studioRequire(bundle.engine===job2.engine.engine&&(runtime2===undefined||runtime2.engine===bundle.engine),"Bundle, job, and runtime must use one engine.");studioRequire(bundle.entrypoint.kind!=="blend"||job2.stage==="render","Blend entrypoints support render stage only; explicit Python authoring owns builds and bakes.");const declared=declaration(job2),required=requiredCapabilities(bundle,job2);const capabilityChecks=required.map((name)=>({name,support:runtime2===undefined?"unbound":runtime2.capabilities.find((item)=>item.name===name)?.support??"unverified"}));const readiness=runtime2===undefined?"runtime-unbound":capabilityChecks.some((item)=>item.support==="unavailable")?"capability-unavailable":capabilityChecks.some((item)=>item.support==="unverified")?"capability-unverified":"authorization-required";const body={kind:"slopcamera.studio-plan",schemaVersion:1,bundle,job:job2,...runtime2===undefined?{}:{runtime:runtime2,runtimeSha256:studioRuntimeSha256(runtime2)},bundleSha256,jobSha256,sourceBytes:bundle.files.reduce((total,file)=>total+file.bytes,0),frameCount:job2.render===undefined?0:job2.render.endFrameExclusive-job2.render.startFrame,outputCount:{minimum:declared.files.length+declared.directories.length,maximum:declared.directories.length===0?declared.files.length:job2.limits.maximumOutputFiles},requiredCapabilities:required,capabilityChecks,readiness};return{...body,planSha256:studioHash("slopcamera.studio-plan/v1",body)}}var plan=z5.strictObject({kind:z5.literal("slopcamera.studio-plan"),schemaVersion:z5.literal(1),bundle:StudioSourceBundleSchema,job:StudioJobSchema,runtime:StudioRuntimeIdentitySchema.optional(),runtimeSha256:StudioDigestSchema.optional(),bundleSha256:StudioDigestSchema,jobSha256:StudioDigestSchema,planSha256:StudioDigestSchema,sourceBytes:z5.number().int().safe().nonnegative().max(STUDIO_LIMITS.sourceBytes),frameCount:z5.number().int().nonnegative().max(STUDIO_LIMITS.frames),outputCount:z5.strictObject({minimum:z5.number().int().positive().max(STUDIO_LIMITS.outputFiles),maximum:z5.number().int().positive().max(STUDIO_LIMITS.outputFiles)}),requiredCapabilities:z5.array(StudioCapabilityNameSchema).min(1).max(12),capabilityChecks:z5.array(z5.strictObject({name:StudioCapabilityNameSchema,support:z5.enum(["available","unavailable","unverified","unbound"])})).min(1).max(12),readiness:z5.enum(["runtime-unbound","capability-unavailable","capability-unverified","authorization-required"])}).superRefine((value,context)=>{try{const derived=derivePlan({bundle:value.bundle,job:value.job,...value.runtime===undefined?{}:{runtime:value.runtime}});if(canonicalJson(derived)!==canonicalJson(value))context.addIssue({code:"custom",message:"Studio plan differs from its canonical source, job, runtime, or admission derivation."})}catch(error){context.addIssue({code:"custom",message:error instanceof Error?error.message:"Invalid studio plan."})}});var StudioPlanSchema=studioDocument(plan,"studio plan");var parseStudioPlan=(input)=>parseStudioValue(StudioPlanSchema,input);function planStudioJob(input){const captured=parseStudioValue(studioDocument(z5.strictObject({bundle:StudioSourceBundleSchema,job:StudioJobSchema,runtime:StudioRuntimeIdentitySchema.optional()}),"studio planning input"),input);return parseStudioPlan(derivePlan(captured))}var failure2=z5.strictObject({code:z5.enum(["subprocess","cancelled","deadline","validation","custody","publication","unavailable"]),message:z5.string().min(1).max(2048)});var receiptCommon={kind:z5.literal("slopcamera.studio-receipt"),schemaVersion:z5.literal(1),jobId:z5.string().regex(/^studio_[a-zA-Z0-9][a-zA-Z0-9_-]{0,120}$/u),attemptId:z5.string().regex(/^attempt_[a-zA-Z0-9][a-zA-Z0-9_-]{0,120}$/u),planSha256:StudioDigestSchema,bundleSha256:StudioDigestSchema,jobSha256:StudioDigestSchema,runtime:StudioRuntimeIdentitySchema,runtimeSha256:StudioDigestSchema,startedAt:z5.iso.datetime({offset:true}),finishedAt:z5.iso.datetime({offset:true}),outputs:z5.array(StudioOutputArtifactSchema).max(STUDIO_LIMITS.outputFiles)};var receiptShape=z5.discriminatedUnion("state",[z5.strictObject({...receiptCommon,state:z5.literal("succeeded"),custody:z5.literal("closed"),exitCode:z5.literal(0)}),z5.strictObject({...receiptCommon,state:z5.literal("failed"),custody:z5.literal("closed"),exitCode:z5.number().int().min(-255).max(255).nullable(),failure:failure2}),z5.strictObject({...receiptCommon,state:z5.literal("unknown-custody"),custody:z5.literal("unknown"),exitCode:z5.number().int().min(-255).max(255).nullable(),failure:failure2})]).superRefine((value,context)=>{if(studioRuntimeSha256(value.runtime)!==value.runtimeSha256)context.addIssue({code:"custom",message:"Receipt runtime digest differs from its evidence."});if(Date.parse(value.finishedAt)<Date.parse(value.startedAt))context.addIssue({code:"custom",message:"Receipt finishes before it starts."});try{assertDistinctPaths(value.outputs.map((item)=>item.path))}catch{context.addIssue({code:"custom",message:"Receipt output paths collide."})}if(value.outputs.reduce((sum,item)=>sum+item.bytes,0)>STUDIO_LIMITS.outputBytes)context.addIssue({code:"custom",message:"Receipt exceeds the global output byte bound."})});var receipt=receiptShape.transform((value)=>({...value,outputs:[...value.outputs].sort((a,b)=>studioCompare(a.path,b.path))})).pipe(receiptShape);var StudioReceiptSchema=studioDocument(receipt,"studio receipt");var parseStudioReceipt=(input)=>parseStudioValue(StudioReceiptSchema,input);function validateStudioReceipt(input){const captured=parseStudioValue(studioDocument(z5.strictObject({plan:StudioPlanSchema,receipt:StudioReceiptSchema}),"studio receipt validation input"),input);const{plan:plan2,receipt:receipt2}=captured;studioRequire(receipt2.jobId===plan2.job.jobId&&receipt2.planSha256===plan2.planSha256&&receipt2.jobSha256===plan2.jobSha256&&receipt2.bundleSha256===plan2.bundleSha256,"Receipt identity differs from the exact planned job.");studioRequire(plan2.runtime!==undefined&&receipt2.runtimeSha256===plan2.runtimeSha256&&canonicalJson(receipt2.runtime)===canonicalJson(plan2.runtime),"Execution receipt requires the exact planned runtime binding.");if(receipt2.state==="succeeded")studioRequire(plan2.readiness==="authorization-required","A successful receipt requires available observed runtime capabilities; consent remains host-owned.");studioRequire(receipt2.outputs.length<=plan2.job.limits.maximumOutputFiles&&receipt2.outputs.reduce((total,output)=>total+output.bytes,0)<=plan2.job.limits.maximumOutputBytes,"Receipt exceeds the planned output budget.");const declared=declaration(plan2.job),expected=new Map(declared.files.map((file)=>[file.path,file]));const counts=new Map;for(const artifact of receipt2.outputs){const specification=plan2.job.outputs.find((output)=>output.id===artifact.outputId);studioRequire(specification!==undefined,"Receipt contains an undeclared output ID.");studioRequire(artifact.role===specification.role&&artifact.format===specification.format,"Receipt output role or format differs from its declaration.");if(specification.kind==="directory"){studioRequire(artifact.path.startsWith(`${specification.path}/`)&&artifact.frame===undefined,"Cache artifact must be a file inside its declared directory.")}else{const wanted=expected.get(artifact.path);studioRequire(wanted!==undefined&&wanted.id===artifact.outputId&&artifact.frame===wanted.frame,"Receipt contains an undeclared file or incorrect frame index.");expected.delete(artifact.path)}counts.set(artifact.outputId,(counts.get(artifact.outputId)??0)+1)}if(receipt2.state==="succeeded"){studioRequire(expected.size===0&&declared.directories.every((directory)=>(counts.get(directory.id)??0)>0),"Successful receipt must cover every declared file, frame, and cache directory.")}return deepFreezeJson(receipt2)}function inspectStudioBundle(input){const bundle=parseStudioSourceBundle(input);return deepFreezeJson({engine:bundle.engine,entrypoint:bundle.entrypoint,bundleSha256:studioSourceBundleSha256(bundle),files:bundle.files.length,sourceBytes:bundle.files.reduce((total,file)=>total+file.bytes,0),executed:false,dependencyDiscovery:"explicit-files-only"})}function inspectStudioPlan(input){const plan2=parseStudioPlan(input);return deepFreezeJson({jobId:plan2.job.jobId,stage:plan2.job.stage,engine:plan2.job.engine.engine,planSha256:plan2.planSha256,sourceBytes:plan2.sourceBytes,frameCount:plan2.frameCount,outputCount:plan2.outputCount,readiness:plan2.readiness,capabilityChecks:plan2.capabilityChecks,execution:plan2.job.execution,limits:plan2.job.limits,executed:false,outputs:plan2.job.outputs.map((output)=>({id:output.id,role:output.role,format:output.format,kind:output.kind,path:output.kind==="sequence"?output.pathPattern:output.path}))})}var slopcameraApi=Object.freeze({artifactSummary,builtInIcons,bundledSkillPath,checkDiagramFile,checkDrawingFile,drawingPageGeometry,DrawingValidationError,defineSlopcameraWorkflow,DiagramValidationError,generateSlopcameraImage,generateSlopcameraImageFile,generateSlopcameraImageGallery,generateSlopcameraIcon,slopcameraGatewayCredentialStatus,slopcameraMcpProtocolVersion,slopcameraMcpServerName,slopcameraMcpTools,slopcameraOperationRegistry,SlopcameraMcpToolRuntime,installSkill,lintDiagram,mcpMaximumRenderedPixels,mcpMaximumScale,mcpSourceByteLimit,parseDiagramSource,parseDiagramSpec,parseDrawingSource,readDiagramFile,readDrawingFile,renderDiagramFile,renderDrawing,renderDrawingFile,renderPng,renderSvg,resolveEdge,resolveDiagramSource,resolveStackLayout,runSlopcameraWorkflow,runMcpServer,searchSlopcameraOperations,serializeTldr,stackLayoutDefaults,starterDrawingSource,StackLayoutError,SlopcameraWorkflowError,vectorizeImage,WorkspaceBoundary,WorkspaceBoundaryError,executeSlopcameraOperation});var diagramApi=slopcameraApi;export{readDiagramFile,checkDiagramFile,renderDiagramFile,artifactSummary,SLOPCAMERA_VERSION,drawingProfile,drawingSourceByteLimit,drawingMinimumGlyphHeightPt,DrawingValidationError,drawingPageGeometry,parseDrawingSource,renderDrawing,readDrawingFile,checkDrawingFile,renderDrawingFile,starterDrawingSource,mcpSourceByteLimit,WorkspaceBoundaryError,WorkspaceBoundary,mcpMaximumScale,mcpMaximumRenderedPixels,slopcameraMcpTools,SlopcameraMcpToolRuntime,slopcameraMcpProtocolVersion,slopcameraMcpServerName,runMcpServer,SLOPCAMERA_CAPABILITY_MANIFEST_LIMITS,SlopcameraCapabilityEffectSchema,SlopcameraCapabilityResumeSchema,SlopcameraCapabilityResourceSchema,SlopcameraCapabilityPreparationSchema,SlopcameraCapabilityOperationSchema,SlopcameraCapabilityWorkflowSchema,SlopcameraCapabilityToolSchema,SlopcameraCapabilityCommandSchema,SlopcameraCapabilityQualificationSchema,SlopcameraCapabilityProfileSchema,SlopcameraCapabilityModuleDeclarationSchema,SlopcameraCapabilityModuleSchema,SlopcameraCapabilityManifestSchema,defineSlopcameraCapabilityModule,compileSlopcameraCapabilityManifest,parseSlopcameraCapabilityManifest,SLOPCAMERA_PORTABLE_CAPABILITY_VERSION,createPortableSlopcameraCapabilityManifest,slopcameraPortableCapabilityManifest,slopcameraSceneGalleryLimits,SlopcameraSceneVariantsSchema,summarizeSceneVariantPatch,parseSlopcameraSceneVariants,planSlopcameraSceneGallery,STUDIO_LIMITS,StudioDigestSchema,StudioEngineSchema,StudioPathSchema,StudioSourceBundleSchema,parseStudioSourceBundle,StudioSourceSpaceSchema,StudioOutputRoleSchema,StudioOutputFormatSchema,StudioOutputInterpretationSchema,StudioOutputSpecSchema,StudioRenderSchema,StudioEngineOptionsSchema,StudioExecutionProfileSchema,StudioJobSchema,parseStudioJob,StudioCapabilityNameSchema,StudioRuntimeIdentitySchema,parseStudioRuntimeIdentity,StudioOutputArtifactSchema,studioSourceBundleSha256,studioJobSha256,studioRuntimeSha256,studioOutputPath,StudioPlanSchema,parseStudioPlan,planStudioJob,StudioReceiptSchema,parseStudioReceipt,validateStudioReceipt,inspectStudioBundle,inspectStudioPlan,slopcameraApi,diagramApi};

package/dist/{index-296qhpf2.js → index-qtn3s421.js}

@@ -1,3 +1,3 @@
 // @bun
-import{executeSlopcameraOperationWithLease,isSlopcameraOperationCode,parseSlopcameraOperationInput,slopcameraOperationHostResourceClaims}from"./index-0bbesn4m.js";import{createDefaultHostResourceCoordinator}from"./index-b3geqczn.js";var workflowIdPattern=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;var workflowStepIdPattern=/^[A-Za-z0-9]+(?:[._:-][A-Za-z0-9]+)*$/u;var defaultMaximumSteps=64;var hardMaximumSteps=256;class SlopcameraWorkflowError extends Error{code;completedSteps;failedStep;constructor(code,message,options={}){super(`[${code}] ${message}`,{cause:options.cause});this.name="SlopcameraWorkflowError";this.code=code;this.completedSteps=Object.freeze([...options.completedSteps??[]].sort((left,right)=>left.index-right.index));if(options.failedStep!==undefined){this.failedStep=Object.freeze({...options.failedStep})}}}function workflowError(code,message){throw new SlopcameraWorkflowError(code,message)}function validateWorkflowId(id){if(typeof id!=="string"||id.length<1||id.length>80||!workflowIdPattern.test(id)){workflowError("INVALID_WORKFLOW","Workflow id must be 1 through 80 lowercase letters, numbers, dots, underscores, or hyphens.")}}function validateStepId(id,completedSteps=[]){if(typeof id!=="string"||id.length<1||id.length>80||!workflowStepIdPattern.test(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Step id must be 1 through 80 letters, numbers, dots, underscores, colons, or hyphens.",{completedSteps})}}function defineSlopcameraWorkflow(options){if(typeof options!=="object"||options===null){workflowError("INVALID_WORKFLOW","Workflow definition must be an object.")}validateWorkflowId(options.id);if(!Number.isSafeInteger(options.version)||options.version<1){workflowError("INVALID_WORKFLOW","Workflow version must be a positive safe integer.")}if(typeof options.parseInput!=="function"||typeof options.run!=="function"){workflowError("INVALID_WORKFLOW","Workflow definition requires parseInput and run functions.")}return Object.freeze({id:options.id,version:options.version,parseInput:options.parseInput,run:options.run})}function maximumSteps(value){const resolved=value??defaultMaximumSteps;if(!Number.isSafeInteger(resolved)||resolved<1||resolved>hardMaximumSteps){workflowError("INVALID_WORKFLOW",`maximumSteps must be an integer from 1 through ${hardMaximumSteps}.`)}return resolved}function aborted(completedSteps,cause){return new SlopcameraWorkflowError("WORKFLOW_ABORTED","Workflow execution was aborted.",{cause,completedSteps})}async function runSlopcameraWorkflow(definition,value,options={}){const normalized=defineSlopcameraWorkflow(definition);const limit=maximumSteps(options.maximumSteps);const signal=options.signal??options.dependencies?.signal??new AbortController().signal;const invoked=new Set;const completed=[];const dispatched=[];let acceptingOperations=true;let nextIndex=0;if(signal.aborted)throw aborted(completed);let input;try{input=normalized.parseInput(value)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_INPUT","Workflow input did not satisfy its parser.",{cause})}const executor=options.executor??((code,operationInput,context2)=>executeSlopcameraOperationWithLease(code,operationInput,context2.hostResourceLease,options.dependencies));const hostResourceCoordinator=options.hostResourceCoordinator??options.dependencies?.hostResourceCoordinator??createDefaultHostResourceCoordinator();const waitTimeoutMilliseconds=options.waitTimeoutMilliseconds??options.dependencies?.waitTimeoutMilliseconds;async function dispatchOperation(id,code,operationInput){if(signal.aborted)throw aborted(completed);validateStepId(id,completed);if(!isSlopcameraOperationCode(code)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} names an unknown Slopcamera operation.`,{completedSteps:completed})}if(invoked.has(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Duplicate workflow step id: ${id}.`,{completedSteps:completed})}if(nextIndex>=limit){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow exceeds its ${String(limit)}-step limit.`,{completedSteps:completed})}const index=nextIndex;nextIndex+=1;invoked.add(id);let normalizedInput;try{normalizedInput=parseSlopcameraOperationInput(code,operationInput)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} has invalid input for ${code}.`,{cause,completedSteps:completed})}try{const result=await hostResourceCoordinator.withLease(slopcameraOperationHostResourceClaims(code),async(hostResourceLease)=>await executor(code,normalizedInput,{hostResourceLease,signal,stepId:id}),{signal,...waitTimeoutMilliseconds===undefined?{}:{waitTimeoutMilliseconds}});completed.push(Object.freeze({id,index,operation:code}));if(signal.aborted)throw aborted(completed);return result}catch(cause){if(cause instanceof SlopcameraWorkflowError&&cause.code==="WORKFLOW_ABORTED"){throw cause}if(signal.aborted)throw aborted(completed,cause);throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED",`Workflow step ${id} (${code}) failed.`,{cause,completedSteps:completed,failedStep:{id,operation:code}})}}const context=Object.freeze({signal,operation(id,code,operationInput){if(!acceptingOperations){const closed=Promise.reject(new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Workflow operations cannot start after authored workflow code has settled.",{completedSteps:completed}));closed.catch(()=>{return});return closed}const operation=dispatchOperation(id,code,operationInput);dispatched.push(operation);operation.catch(()=>{return});return operation}});let output;let runFailed=false;let runFailure;try{output=await normalized.run(context,input)}catch(cause){runFailed=true;runFailure=cause}finally{acceptingOperations=false}const operationResults=await Promise.allSettled(dispatched);if(signal.aborted)throw aborted(completed,runFailed?runFailure:undefined);if(runFailed){if(runFailure instanceof SlopcameraWorkflowError)throw runFailure;throw new SlopcameraWorkflowError("WORKFLOW_FAILED",`Workflow ${normalized.id} failed in authored code.`,{cause:runFailure,completedSteps:completed})}const operationFailure=operationResults.find((result)=>result.status==="rejected");if(operationFailure!==undefined){const cause=operationFailure.reason;if(cause instanceof SlopcameraWorkflowError)throw cause;throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED","A dispatched workflow operation failed.",{cause,completedSteps:completed})}return Object.freeze({workflow:Object.freeze({id:normalized.id,version:normalized.version}),output,steps:Object.freeze([...completed].sort((left,right)=>left.index-right.index))})}
+import{executeSlopcameraOperationWithLease,isSlopcameraOperationCode,parseSlopcameraOperationInput,slopcameraOperationHostResourceClaims}from"./index-sy1n4zfy.js";import{createDefaultHostResourceCoordinator}from"./index-b3geqczn.js";var workflowIdPattern=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;var workflowStepIdPattern=/^[A-Za-z0-9]+(?:[._:-][A-Za-z0-9]+)*$/u;var defaultMaximumSteps=64;var hardMaximumSteps=256;class SlopcameraWorkflowError extends Error{code;completedSteps;failedStep;constructor(code,message,options={}){super(`[${code}] ${message}`,{cause:options.cause});this.name="SlopcameraWorkflowError";this.code=code;this.completedSteps=Object.freeze([...options.completedSteps??[]].sort((left,right)=>left.index-right.index));if(options.failedStep!==undefined){this.failedStep=Object.freeze({...options.failedStep})}}}function workflowError(code,message){throw new SlopcameraWorkflowError(code,message)}function validateWorkflowId(id){if(typeof id!=="string"||id.length<1||id.length>80||!workflowIdPattern.test(id)){workflowError("INVALID_WORKFLOW","Workflow id must be 1 through 80 lowercase letters, numbers, dots, underscores, or hyphens.")}}function validateStepId(id,completedSteps=[]){if(typeof id!=="string"||id.length<1||id.length>80||!workflowStepIdPattern.test(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Step id must be 1 through 80 letters, numbers, dots, underscores, colons, or hyphens.",{completedSteps})}}function defineSlopcameraWorkflow(options){if(typeof options!=="object"||options===null){workflowError("INVALID_WORKFLOW","Workflow definition must be an object.")}validateWorkflowId(options.id);if(!Number.isSafeInteger(options.version)||options.version<1){workflowError("INVALID_WORKFLOW","Workflow version must be a positive safe integer.")}if(typeof options.parseInput!=="function"||typeof options.run!=="function"){workflowError("INVALID_WORKFLOW","Workflow definition requires parseInput and run functions.")}return Object.freeze({id:options.id,version:options.version,parseInput:options.parseInput,run:options.run})}function maximumSteps(value){const resolved=value??defaultMaximumSteps;if(!Number.isSafeInteger(resolved)||resolved<1||resolved>hardMaximumSteps){workflowError("INVALID_WORKFLOW",`maximumSteps must be an integer from 1 through ${hardMaximumSteps}.`)}return resolved}function aborted(completedSteps,cause){return new SlopcameraWorkflowError("WORKFLOW_ABORTED","Workflow execution was aborted.",{cause,completedSteps})}async function runSlopcameraWorkflow(definition,value,options={}){const normalized=defineSlopcameraWorkflow(definition);const limit=maximumSteps(options.maximumSteps);const signal=options.signal??options.dependencies?.signal??new AbortController().signal;const invoked=new Set;const completed=[];const dispatched=[];let acceptingOperations=true;let nextIndex=0;if(signal.aborted)throw aborted(completed);let input;try{input=normalized.parseInput(value)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_INPUT","Workflow input did not satisfy its parser.",{cause})}const executor=options.executor??((code,operationInput,context2)=>executeSlopcameraOperationWithLease(code,operationInput,context2.hostResourceLease,options.dependencies));const hostResourceCoordinator=options.hostResourceCoordinator??options.dependencies?.hostResourceCoordinator??createDefaultHostResourceCoordinator();const waitTimeoutMilliseconds=options.waitTimeoutMilliseconds??options.dependencies?.waitTimeoutMilliseconds;async function dispatchOperation(id,code,operationInput){if(signal.aborted)throw aborted(completed);validateStepId(id,completed);if(!isSlopcameraOperationCode(code)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} names an unknown Slopcamera operation.`,{completedSteps:completed})}if(invoked.has(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Duplicate workflow step id: ${id}.`,{completedSteps:completed})}if(nextIndex>=limit){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow exceeds its ${String(limit)}-step limit.`,{completedSteps:completed})}const index=nextIndex;nextIndex+=1;invoked.add(id);let normalizedInput;try{normalizedInput=parseSlopcameraOperationInput(code,operationInput)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} has invalid input for ${code}.`,{cause,completedSteps:completed})}try{const result=await hostResourceCoordinator.withLease(slopcameraOperationHostResourceClaims(code),async(hostResourceLease)=>await executor(code,normalizedInput,{hostResourceLease,signal,stepId:id}),{signal,...waitTimeoutMilliseconds===undefined?{}:{waitTimeoutMilliseconds}});completed.push(Object.freeze({id,index,operation:code}));if(signal.aborted)throw aborted(completed);return result}catch(cause){if(cause instanceof SlopcameraWorkflowError&&cause.code==="WORKFLOW_ABORTED"){throw cause}if(signal.aborted)throw aborted(completed,cause);throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED",`Workflow step ${id} (${code}) failed.`,{cause,completedSteps:completed,failedStep:{id,operation:code}})}}const context=Object.freeze({signal,operation(id,code,operationInput){if(!acceptingOperations){const closed=Promise.reject(new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Workflow operations cannot start after authored workflow code has settled.",{completedSteps:completed}));closed.catch(()=>{return});return closed}const operation=dispatchOperation(id,code,operationInput);dispatched.push(operation);operation.catch(()=>{return});return operation}});let output;let runFailed=false;let runFailure;try{output=await normalized.run(context,input)}catch(cause){runFailed=true;runFailure=cause}finally{acceptingOperations=false}const operationResults=await Promise.allSettled(dispatched);if(signal.aborted)throw aborted(completed,runFailed?runFailure:undefined);if(runFailed){if(runFailure instanceof SlopcameraWorkflowError)throw runFailure;throw new SlopcameraWorkflowError("WORKFLOW_FAILED",`Workflow ${normalized.id} failed in authored code.`,{cause:runFailure,completedSteps:completed})}const operationFailure=operationResults.find((result)=>result.status==="rejected");if(operationFailure!==undefined){const cause=operationFailure.reason;if(cause instanceof SlopcameraWorkflowError)throw cause;throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED","A dispatched workflow operation failed.",{cause,completedSteps:completed})}return Object.freeze({workflow:Object.freeze({id:normalized.id,version:normalized.version}),output,steps:Object.freeze([...completed].sort((left,right)=>left.index-right.index))})}
 export{SlopcameraWorkflowError,defineSlopcameraWorkflow,runSlopcameraWorkflow};