summer-engine 4.0.0 → 4.3.0

package/dist/cli/commands/status.js

@@ -4,52 +4,67 @@ import { resolveGatewayUrl } from "../../core/config.js";
 import { getApiToken, getApiPort, checkEngineHealth } from "../../core/engine.js";
 export const statusCommand = new Command("status")
     .description("Check Summer Engine status, connection, and auth state")
-    .action(async () => {
-    await runStatus(console.log);
+    .option("--json", "Print the status as JSON")
+    .action(async (opts) => {
+    if (opts.json)
+        console.log(JSON.stringify(await readStatus()));
+    else
+        await runStatus(console.log);
 });
+export async function readStatus() {
+    const authToken = await getAuthToken();
+    // The env credential is what every gateway call uses; a stored identity
+    // (if any) is not the one in effect, so it is not reported.
+    const auth = !authToken
+        ? { signedIn: false, loginUrl: await loginPageHint() }
+        : hasEnvAuthToken()
+            ? { signedIn: true, source: "env" }
+            : { signedIn: true, source: "stored", ...(await storedIdentity()) };
+    if (!(await getApiToken()))
+        return { auth, engine: { state: "not_running" } };
+    const port = await getApiPort();
+    const health = await checkEngineHealth(port);
+    // /api/health carries no project name/path/scene (see EngineHealth in
+    // core/engine.ts); summer_get_project_context is the read for those.
+    return { auth, engine: health ? { state: "running", port, version: health.version } : { state: "not_responding", port } };
+}
 export async function runStatus(log) {
+    const { auth, engine } = await readStatus();
     log("Summer Engine Status\n");
-    const authToken = await getAuthToken();
-    if (!authToken) {
+    if (!auth.signedIn) {
         log("  Auth: Not logged in");
         log("        Run: npx -y summer-engine@latest login");
-        log(`        Or: ${await loginPageHint()}`);
+        log(`        Or: ${auth.loginUrl}`);
     }
-    else if (hasEnvAuthToken()) {
-        // The env credential is what every gateway call uses; a stored identity
-        // (if any) is not the one in effect, so it is not printed.
+    else if (auth.source === "env") {
         log("  Auth: SUMMER_TOKEN (env) — logout does not affect it");
     }
     else {
-        log(`  Auth: Logged in${await storedIdentitySuffix()}`);
+        const identity = auth.identityError ? ` (identity unreadable: ${auth.identityError})` : auth.email ? ` as ${auth.email}` : "";
+        log(`  Auth: Logged in${identity}`);
     }
-    const apiToken = await getApiToken();
-    const port = await getApiPort();
-    if (!apiToken) {
+    if (engine.state === "not_running") {
         log("  Engine: Not running (no api-token found)");
         log("\n  To start: summer run");
         return;
     }
     log("  API Token: Found (~/.summer/api-token)");
-    log(`  Port: ${port}`);
-    const health = await checkEngineHealth(port);
-    if (!health) {
+    log(`  Port: ${engine.port}`);
+    if (engine.state === "not_responding") {
         log("  Engine: Not responding (may have closed since last launch)");
         log("\n  To start: summer run");
         return;
     }
-    // /api/health carries no project name/path/scene (see EngineHealth in
-    // core/engine.ts); summer_get_project_context is the read for those.
-    log(`  Engine: Running (v${health.version})`);
+    log(`  Engine: Running (v${engine.version})`);
 }
 /** A corrupt user.json must not take `summer status` down with it. */
-async function storedIdentitySuffix() {
+async function storedIdentity() {
     try {
         const userInfo = await getUserInfo();
-        return userInfo?.email ? ` as ${userInfo.email}` : "";
+        return userInfo?.email ? { email: userInfo.email } : {};
     }
     catch (error) {
-        return ` (identity unreadable: ${error instanceof Error ? error.message : String(error)})`;
+        return { identityError: error instanceof Error ? error.message : String(error) };
     }
 }
 async function loginPageHint() {

package/dist/cli/commands/tool.js

@@ -14,6 +14,7 @@ import { PACKAGE_ROOT } from "../../core/package-root.js";
 import { Command, Option } from "commander";
 import { ToolDispatchError, ToolResultError, dispatchTool, listToolDispatches, resolveToolDispatch, } from "../../core/capabilities/tool-dispatch.js";
 import { c } from "../../core/format.js";
+import { noteCliHosted, noteCliTool } from "../../core/cli-usage.js";
 import { callHostedToolForCli, hostedResultPayload, listHostedToolsForCli, } from "../../core/hosted-mcp.js";
 /** The hosted store and publishing tools (Summer Engine MCP); replaceable in tests. */
 export const hostedCli = { list: listHostedToolsForCli, call: callHostedToolForCli };
@@ -116,6 +117,8 @@ export const toolCommand = new Command("tool")
     const entry = resolveToolForCli(name);
     if (!entry) {
         // Not a local tool: the hosted store and publishing tools, with the store sign-in.
+        // Summer's server records the call itself (X-Summer-Client-Surface: cli).
+        noteCliHosted();
         const hosted = await hostedCli.call(name, parseJsonArgs(options.args ?? options.json));
         if (hosted.status === "called") {
             const payload = hostedResultPayload(hosted.result);
@@ -135,6 +138,7 @@ export const toolCommand = new Command("tool")
         console.error("Note: 'summer tool --json <args>' is deprecated; use --args <json>.");
     }
     const args = parseJsonArgs(options.args ?? options.json);
+    noteCliTool(entry.name);
     let result;
     try {
         result = await dispatchTool(entry.slug, args);

package/dist/cli/index.js

@@ -21,6 +21,7 @@ import { getBanner } from "./banner.js";
 import { runRootAction } from "./root-action.js";
 import { c, sym } from "../core/format.js";
 import { resolveSurface } from "../core/tool-profiles.js";
+import { trackCommandUsage } from "./command-usage.js";
 import { TOOLKIT_VERSION as version } from "../core/version.js";
 /**
  * Build and run the summer CLI. The `mcp` command is injected by the bin
@@ -58,6 +59,7 @@ export function runCli(mcpCommand) {
         for (const command of opsCliCommands())
             program.addCommand(command);
     }
+    trackCommandUsage(program);
     program.parseAsync().catch((err) => {
         console.error(err instanceof Error ? err.message : String(err));
         process.exit(1);

package/dist/core/agent-host.d.ts

@@ -36,6 +36,7 @@ export interface McpClientInfo {
 }
 type Env = Record<string, string | undefined>;
 /** The opt-out switches, the same two the library feedback mailbox honors. */
+/** SUMMER_NO_TELEMETRY or DO_NOT_TRACK set to 1, true, yes or on. */
 export declare function isTelemetryDisabled(env?: Env): boolean;
 /** Lowercase `[a-z0-9-]`, at most 40 characters: the server's host id shape. */
 export declare function sanitizeHostId(raw: string): string;
@@ -43,6 +44,8 @@ export declare function sanitizeHostId(raw: string): string;
 export declare function hostFromClientName(name: string | undefined | null): string | null;
 /** AI_AGENT ("<name>_<version>_<mode>") first, then the per-host variables. */
 export declare function hostFromEnv(env: Env): string | null;
+/** `mcp` inside `summer mcp` (it registers its handshake), `cli` for every other command. */
+export declare function processSurface(): ClientSurface;
 export declare function registerMcpClientSource(source: (() => McpClientInfo | undefined) | null): void;
 export declare function currentMcpClient(): McpClientInfo | undefined;
 export declare function resolveAgentHost(env?: Env, client?: McpClientInfo | undefined): AgentHost;

package/dist/core/agent-host.js

@@ -27,8 +27,10 @@ export const AGENT_HOST_VERSION_HEADER = "X-Summer-Agent-Host-Version";
 export const MCP_TOOL_HEADER = "X-Summer-MCP-Tool";
 export const AGENT_HOST_OVERRIDE_ENV = "SUMMER_AGENT_HOST";
 /** The opt-out switches, the same two the library feedback mailbox honors. */
+/** SUMMER_NO_TELEMETRY or DO_NOT_TRACK set to 1, true, yes or on. */
 export function isTelemetryDisabled(env = process.env) {
-    return env.SUMMER_NO_TELEMETRY === "1" || env.DO_NOT_TRACK === "1";
+    const on = (value) => value !== undefined && /^(1|true|yes|on)$/i.test(value.trim());
+    return on(env.SUMMER_NO_TELEMETRY) || on(env.DO_NOT_TRACK);
 }
 const set = (env, key) => {
     const value = env[key];
@@ -128,6 +130,10 @@ export function hostFromEnv(env) {
 // The MCP server registers a getter; it is read at request time, after the
 // initialize handshake has given the client's name and version.
 let mcpClientSource = null;
+/** `mcp` inside `summer mcp` (it registers its handshake), `cli` for every other command. */
+export function processSurface() {
+    return mcpClientSource ? "mcp" : "cli";
+}
 export function registerMcpClientSource(source) {
     mcpClientSource = source;
 }
@@ -168,7 +174,7 @@ const headerValue = (value, max) => value.replace(/[^\x20-\x7e]/g, "").trim().sl
  */
 export function summerRequestHeaders(options = {}, env = process.env) {
     const context = toolContext.getStore();
-    const surface = context?.surface ?? options.surface ?? (mcpClientSource ? "mcp" : "cli");
+    const surface = context?.surface ?? options.surface ?? processSurface();
     const headers = {
         "X-Summer-Client": "summer-cli",
         "X-Summer-Client-Version": TOOLKIT_VERSION,

package/dist/core/capabilities/apps.d.ts

@@ -18,9 +18,9 @@ export declare const APP_DOCK_SLOTS: readonly ["left", "right", "bottom"];
 export declare const appGuideArgsSchema: z.ZodObject<{
     section: z.ZodDefault<z.ZodEnum<["all", "overview", "manifest", "sdk", "kit", "layout", "design", "examples", "types"]>>;
 }, "strip", z.ZodTypeAny, {
-    section: "all" | "kit" | "layout" | "examples" | "manifest" | "overview" | "sdk" | "design" | "types";
+    section: "all" | "examples" | "kit" | "layout" | "manifest" | "overview" | "sdk" | "design" | "types";
 }, {
-    section?: "all" | "kit" | "layout" | "examples" | "manifest" | "overview" | "sdk" | "design" | "types" | undefined;
+    section?: "all" | "examples" | "kit" | "layout" | "manifest" | "overview" | "sdk" | "design" | "types" | undefined;
 }>;
 export declare const appListArgsSchema: z.ZodObject<{
     workspaceId: z.ZodOptional<z.ZodString>;
@@ -80,8 +80,8 @@ export declare const appPublishArgsSchema: z.ZodObject<{
         path: string;
         content: string;
     }[] | undefined;
-    idempotencyKey?: string | undefined;
     dir?: string | undefined;
+    idempotencyKey?: string | undefined;
     layout?: Record<string, unknown> | undefined;
 }, {
     manifest: Record<string, unknown>;
@@ -92,8 +92,8 @@ export declare const appPublishArgsSchema: z.ZodObject<{
         content: string;
         encoding?: "utf8" | "base64" | undefined;
     }[] | undefined;
-    idempotencyKey?: string | undefined;
     dir?: string | undefined;
+    idempotencyKey?: string | undefined;
     layout?: Record<string, unknown> | undefined;
 }>;
 export declare const appGetArgsSchema: z.ZodObject<{
@@ -109,15 +109,15 @@ export declare const appEventsArgsSchema: z.ZodObject<{
     timeoutSeconds: z.ZodDefault<z.ZodNumber>;
     kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["agent", "error", "feedback", "tool"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    timeoutSeconds: number;
     after: number;
+    timeoutSeconds: number;
     appId: string;
     kinds?: ("error" | "agent" | "tool" | "feedback")[] | undefined;
 }, {
     appId: string;
     kinds?: ("error" | "agent" | "tool" | "feedback")[] | undefined;
-    timeoutSeconds?: number | undefined;
     after?: number | undefined;
+    timeoutSeconds?: number | undefined;
 }>;
 export declare const appPageArgsSchema: z.ZodObject<{
     appId: z.ZodString;
@@ -156,13 +156,13 @@ export declare const appUpdateArgsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     appId: string;
     name?: string | undefined;
-    status?: "scratch" | "kept" | "archived" | undefined;
+    status?: "kept" | "scratch" | "archived" | undefined;
     folder?: string | null | undefined;
     purpose?: string | undefined;
 }, {
     appId: string;
     name?: string | undefined;
-    status?: "scratch" | "kept" | "archived" | undefined;
+    status?: "kept" | "scratch" | "archived" | undefined;
     folder?: string | null | undefined;
     purpose?: string | undefined;
 }>;
@@ -228,16 +228,16 @@ export declare const appDataArgsSchema: z.ZodObject<{
     limit: number;
     appId: string;
     ops?: Record<string, unknown>[] | undefined;
-    after?: string | undefined;
     as?: "seed" | "agent" | undefined;
     collection?: string | undefined;
+    after?: string | undefined;
 }, {
     appId: string;
     ops?: Record<string, unknown>[] | undefined;
     limit?: number | undefined;
-    after?: string | undefined;
     as?: "seed" | "agent" | undefined;
     collection?: string | undefined;
+    after?: string | undefined;
 }>;
 export declare const appToolsArgsSchema: z.ZodObject<{
     appId: z.ZodString;

package/dist/core/capabilities/audit/args.d.ts

@@ -71,10 +71,10 @@ export declare const sceneAuditArgsSchema: z.ZodObject<{
     limit?: number | undefined;
     root?: string | undefined;
     scenePath?: string | undefined;
-    render?: "none" | "sheet" | undefined;
-    checks?: ("resource" | "through_hole" | "floor_gap" | "floating" | "sunken" | "interpenetration" | "exposed_edge" | "open_fixture_end" | "orientation" | "uv_stretch" | "duplicate" | "z_fight" | "depth_step" | "lights" | "transform")[] | undefined;
-    min_severity?: "error" | "warn" | "look" | undefined;
     offset?: number | undefined;
+    min_severity?: "error" | "warn" | "look" | undefined;
+    render?: "none" | "sheet" | undefined;
+    checks?: ("resource" | "transform" | "through_hole" | "floor_gap" | "floating" | "sunken" | "interpenetration" | "exposed_edge" | "open_fixture_end" | "orientation" | "uv_stretch" | "duplicate" | "z_fight" | "depth_step" | "lights")[] | undefined;
     budget_ms?: number | undefined;
     show_accepted?: boolean | undefined;
 }, {
@@ -85,10 +85,10 @@ export declare const sceneAuditArgsSchema: z.ZodObject<{
     limit?: number | undefined;
     root?: string | undefined;
     scenePath?: string | undefined;
-    render?: "none" | "sheet" | undefined;
-    checks?: ("resource" | "through_hole" | "floor_gap" | "floating" | "sunken" | "interpenetration" | "exposed_edge" | "open_fixture_end" | "orientation" | "uv_stretch" | "duplicate" | "z_fight" | "depth_step" | "lights" | "transform")[] | undefined;
-    min_severity?: "error" | "warn" | "look" | undefined;
     offset?: number | undefined;
+    min_severity?: "error" | "warn" | "look" | undefined;
+    render?: "none" | "sheet" | undefined;
+    checks?: ("resource" | "transform" | "through_hole" | "floor_gap" | "floating" | "sunken" | "interpenetration" | "exposed_edge" | "open_fixture_end" | "orientation" | "uv_stretch" | "duplicate" | "z_fight" | "depth_step" | "lights")[] | undefined;
     budget_ms?: number | undefined;
     show_accepted?: boolean | undefined;
 }>;

package/dist/core/capabilities/fabricate-mesh.d.ts

@@ -58,8 +58,8 @@ export declare const fabricateArgsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     source: string;
-    out_path?: string | undefined;
     target_size?: number | undefined;
+    out_path?: string | undefined;
     import_to_scene?: {
         parent: string;
         position?: string | undefined;
@@ -70,8 +70,8 @@ export declare const fabricateArgsSchema: z.ZodObject<{
 }, {
     name: string;
     source: string;
-    out_path?: string | undefined;
     target_size?: number | undefined;
+    out_path?: string | undefined;
     import_to_scene?: {
         parent: string;
         position?: string | undefined;

package/dist/core/capabilities/game-task-plan.d.ts

@@ -15,14 +15,14 @@ export declare const gameTaskPlanInputSchema: z.ZodObject<{
     assetPolicy: z.ZodDefault<z.ZodEnum<["reuse-first", "ask-before-paid-generation", "no-paid-generation", "generate-when-clearly-needed"]>>;
     verification: z.ZodDefault<z.ZodEnum<["none", "fast", "full"]>>;
 }, "strip", z.ZodTypeAny, {
-    mode: "auto" | "ship" | "debug" | "new-game" | "feature" | "asset" | "playtest" | "polish";
+    mode: "auto" | "ship" | "debug" | "asset" | "new-game" | "feature" | "playtest" | "polish";
     target: "auto" | "audio" | "level" | "npc" | "ui" | "2d" | "3d" | "animation" | "multiplayer";
     goal: string;
     assetPolicy: "reuse-first" | "ask-before-paid-generation" | "no-paid-generation" | "generate-when-clearly-needed";
     verification: "none" | "full" | "fast";
 }, {
     goal: string;
-    mode?: "auto" | "ship" | "debug" | "new-game" | "feature" | "asset" | "playtest" | "polish" | undefined;
+    mode?: "auto" | "ship" | "debug" | "asset" | "new-game" | "feature" | "playtest" | "polish" | undefined;
     target?: "auto" | "audio" | "level" | "npc" | "ui" | "2d" | "3d" | "animation" | "multiplayer" | undefined;
     assetPolicy?: "reuse-first" | "ask-before-paid-generation" | "no-paid-generation" | "generate-when-clearly-needed" | undefined;
     verification?: "none" | "full" | "fast" | undefined;

package/dist/core/capabilities/hdri-import.d.ts

@@ -25,14 +25,14 @@ export declare const importHdriArgsSchema: z.ZodObject<{
     resolution: z.ZodDefault<z.ZodEnum<["1k", "2k", "4k"]>>;
     allow_large: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    resolution: "1k" | "2k" | "4k";
+    resolution: "2k" | "1k" | "4k";
     allow_large: boolean;
     query?: string | undefined;
     assetId?: string | undefined;
 }, {
     query?: string | undefined;
+    resolution?: "2k" | "1k" | "4k" | undefined;
     assetId?: string | undefined;
-    resolution?: "1k" | "2k" | "4k" | undefined;
     allow_large?: boolean | undefined;
 }>;
 export interface ImportHdriArgs {

package/dist/core/capabilities/motion-generation.d.ts

@@ -27,24 +27,24 @@ export declare const motionGenerationArgsSchema: z.ZodObject<{
     backend: "meshy-library" | "text-to-motion";
     options?: Record<string, any> | undefined;
     prompt?: string | undefined;
+    idempotencyKey?: string | undefined;
     motionName?: string | undefined;
     prompts?: string[] | undefined;
     takes?: number | undefined;
     lockJoints?: string[] | undefined;
     cfgScale?: number | undefined;
-    idempotencyKey?: string | undefined;
 }, {
     rigAssetId: string;
     options?: Record<string, any> | undefined;
     wait?: boolean | undefined;
     prompt?: string | undefined;
+    idempotencyKey?: string | undefined;
     backend?: "meshy-library" | "text-to-motion" | undefined;
     motionName?: string | undefined;
     prompts?: string[] | undefined;
     takes?: number | undefined;
     lockJoints?: string[] | undefined;
     cfgScale?: number | undefined;
-    idempotencyKey?: string | undefined;
 }>;
 export type MotionGenerationArgs = z.input<typeof motionGenerationArgsSchema>;
 /** Validate the backend-specific rules zod cannot express on a flat shape and

package/dist/core/capabilities/placement.d.ts

@@ -151,20 +151,20 @@ export declare const measureArgsSchema: z.ZodObject<{
     space: "local" | "world";
     tolerance: number;
     a?: string | undefined;
-    axis?: "y" | "x" | "z" | undefined;
-    nodes?: string[] | undefined;
     b?: string | undefined;
-    face?: "-y" | "+x" | "-x" | "+y" | "+z" | "-z" | undefined;
+    nodes?: string[] | undefined;
+    axis?: "y" | "z" | "x" | undefined;
+    face?: "-y" | "-z" | "+x" | "-x" | "+y" | "+z" | undefined;
 }, {
     scenePath: string;
     mode?: "pair" | "plane" | undefined;
     a?: string | undefined;
     space?: "local" | "world" | undefined;
-    axis?: "y" | "x" | "z" | undefined;
-    nodes?: string[] | undefined;
     b?: string | undefined;
+    nodes?: string[] | undefined;
+    axis?: "y" | "z" | "x" | undefined;
     tolerance?: number | undefined;
-    face?: "-y" | "+x" | "-x" | "+y" | "+z" | "-z" | undefined;
+    face?: "-y" | "-z" | "+x" | "-x" | "+y" | "+z" | undefined;
 }>;
 export type MeasureArgs = z.output<typeof measureArgsSchema>;
 export declare function measure(client: PlacementClient, args: MeasureArgs): Promise<PlacementResult>;
@@ -213,39 +213,39 @@ export declare const placeAdjacentArgsSchema: z.ZodObject<{
         z: z.ZodOptional<z.ZodEnum<["min", "center", "max", "none"]>>;
     }, "strip", z.ZodTypeAny, {
         y?: "none" | "min" | "max" | "center" | undefined;
-        x?: "none" | "min" | "max" | "center" | undefined;
         z?: "none" | "min" | "max" | "center" | undefined;
+        x?: "none" | "min" | "max" | "center" | undefined;
     }, {
         y?: "none" | "min" | "max" | "center" | undefined;
-        x?: "none" | "min" | "max" | "center" | undefined;
         z?: "none" | "min" | "max" | "center" | undefined;
+        x?: "none" | "min" | "max" | "center" | undefined;
     }>]>>>;
     space: z.ZodDefault<z.ZodOptional<z.ZodEnum<["world", "local"]>>>;
 }, "strip", z.ZodTypeAny, {
     scenePath: string;
     space: "local" | "world";
-    gap: number;
-    axis: "y" | "x" | "z";
-    subject: string;
     reference: string;
+    subject: string;
+    axis: "y" | "z" | "x";
     side: "min" | "max";
+    gap: number;
     alignOtherAxes: "none" | "min" | "max" | "center" | {
         y?: "none" | "min" | "max" | "center" | undefined;
-        x?: "none" | "min" | "max" | "center" | undefined;
         z?: "none" | "min" | "max" | "center" | undefined;
+        x?: "none" | "min" | "max" | "center" | undefined;
     };
 }, {
     scenePath: string;
-    axis: "y" | "x" | "z";
-    subject: string;
     reference: string;
+    subject: string;
+    axis: "y" | "z" | "x";
     side: "min" | "max";
     space?: "local" | "world" | undefined;
     gap?: number | undefined;
     alignOtherAxes?: "none" | "min" | "max" | "center" | {
         y?: "none" | "min" | "max" | "center" | undefined;
-        x?: "none" | "min" | "max" | "center" | undefined;
         z?: "none" | "min" | "max" | "center" | undefined;
+        x?: "none" | "min" | "max" | "center" | undefined;
     } | undefined;
 }>;
 export type PlaceAdjacentArgs = z.output<typeof placeAdjacentArgsSchema>;
@@ -277,12 +277,12 @@ export declare const attachToSurfaceArgsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     scenePath: string;
     subject: string;
+    backAxis: "-y" | "-z" | "+x" | "-x" | "+y" | "+z";
     maxDistance: number;
     collisionMask: number;
     placeAt: "current" | "hit";
     maxMove: number;
-    backAxis: "-y" | "+x" | "-x" | "+y" | "+z" | "-z";
-    upAxis: "-y" | "+x" | "-x" | "+y" | "+z" | "-z";
+    upAxis: "-y" | "-z" | "+x" | "-x" | "+y" | "+z";
     worldUp: [number, number, number];
     standoff: number;
     surface?: string | undefined;
@@ -294,6 +294,7 @@ export declare const attachToSurfaceArgsSchema: z.ZodObject<{
     scenePath: string;
     subject: string;
     surface?: string | undefined;
+    backAxis?: "-y" | "-z" | "+x" | "-x" | "+y" | "+z" | undefined;
     ray?: {
         origin: [number, number, number];
         direction: [number, number, number];
@@ -302,8 +303,7 @@ export declare const attachToSurfaceArgsSchema: z.ZodObject<{
     collisionMask?: number | undefined;
     placeAt?: "current" | "hit" | undefined;
     maxMove?: number | undefined;
-    backAxis?: "-y" | "+x" | "-x" | "+y" | "+z" | "-z" | undefined;
-    upAxis?: "-y" | "+x" | "-x" | "+y" | "+z" | "-z" | undefined;
+    upAxis?: "-y" | "-z" | "+x" | "-x" | "+y" | "+z" | undefined;
     worldUp?: [number, number, number] | undefined;
     standoff?: number | undefined;
 }>;
@@ -378,9 +378,9 @@ export declare const repeatAlongArgsSchema: z.ZodObject<{
     align: "end" | "start" | "center";
     end?: [number, number, number] | undefined;
     count?: number | undefined;
-    scale?: [number, number, number] | undefined;
     direction?: [number, number, number] | undefined;
     spacing?: number | undefined;
+    scale?: [number, number, number] | undefined;
     rotationDegrees?: [number, number, number] | undefined;
     namePrefix?: string | undefined;
 }, {
@@ -390,9 +390,9 @@ export declare const repeatAlongArgsSchema: z.ZodObject<{
     start: [number, number, number];
     end?: [number, number, number] | undefined;
     count?: number | undefined;
-    scale?: [number, number, number] | undefined;
     direction?: [number, number, number] | undefined;
     spacing?: number | undefined;
+    scale?: [number, number, number] | undefined;
     align?: "end" | "start" | "center" | undefined;
     rotationDegrees?: [number, number, number] | undefined;
     namePrefix?: string | undefined;
@@ -422,11 +422,11 @@ export declare const connectPortsArgsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     scenePath: string;
     target: string;
-    gap: number;
     subject: string;
-    maxTriangles: number;
     subjectPort: string | number;
     targetPort: string | number;
+    gap: number;
+    maxTriangles: number;
     rollDegrees: number;
     maxTiltDegrees: number;
     allowTilt: boolean;