@prestyj/cli 5.27.0 → 5.28.1

package/dist/motion-agent/motion-agent.d.ts

@@ -0,0 +1,35 @@
+import { AgentSession, type AgentSessionOptions } from "../core/agent-session.js";
+import { type MotionBundle } from "../core/skills.js";
+/**
+ * Motion's skill-catalog budget: double the default. The 16 KB default guards
+ * against bloated untrusted skills; Motion only ever loads its own bundled
+ * set. Retain headroom for future skills without loading their bodies.
+ */
+export declare const MOTION_SKILL_CATALOG_BYTES: number;
+/** Reserved `chatAgent` query value the app uses to list Motion sessions. */
+export declare const MOTION_SESSIONS_QUERY = "motion";
+/** Direct video work and sourcing only; no delegation, developer catalogs or MCP. */
+export declare const MOTION_TOOL_NAMES: readonly ["read", "write", "edit", "bash", "find", "grep", "ls", "skill", "ask_user", "task_output", "task_send", "task_stop", "web_search", "web_fetch", "screenshot", "generate_image", "motion_check"];
+/** Motion's private session store, beside coder's `sessions/` and chat's `chat-sessions/`. */
+export declare function motionSessionsDir(coderSessionsDir: string): string;
+export type MotionAgentOptions = Omit<AgentSessionOptions, "systemPrompt" | "agentPrompt" | "agentRole" | "agentContext" | "promptCacheKeyPrefix" | "sessionRootDir" | "coderSlashCommands" | "selfCorrectionHooks" | "projectCustomization" | "skills" | "contextLimits" | "globalSubagents" | "loadExtensions" | "orchestrationPrompt" | "completionReview" | "allowedTools" | "allowedMcpServers"> & {
+    /** Coder's sessions dir; Motion's store is derived beside it. */
+    sessionsDir: string;
+};
+/**
+ * The exact launcher invocation the agent must use for HyperFrames. Uses the
+ * Node running this sidecar, so Motion works without a system Node install.
+ */
+export declare function motionCliCommand(bundle: MotionBundle, nodePath?: string): string;
+/** Motion's prompt with this install's concrete launcher paths filled in. */
+export declare function buildMotionAgentPrompt(bundle: MotionBundle, nodePath?: string): string;
+/** Shared licensed music, independent of the creative skill catalog. */
+export declare function motionMusicDir(bundle: MotionBundle): string;
+/** Shared CC0 sound effects, independent of the creative skill catalog. */
+export declare function motionSfxDir(bundle: MotionBundle): string;
+/**
+ * Create a Motion session: focused tools, Motion's own prompt, and only
+ * the bundled Motion skills. Project/global skills, extensions and coder
+ * slash commands stay out so the mode is predictable for every user.
+ */
+export declare function createMotionAgentSession(options: MotionAgentOptions): Promise<AgentSession>;

package/dist/motion-agent/motion-agent.js

@@ -0,0 +1,117 @@
+import path from "node:path";
+import { AgentSession } from "../core/agent-session.js";
+import { findMotionBundle, loadMotionSkills } from "../core/skills.js";
+import { MOTION_SYSTEM_PROMPT } from "./motion-prompt.js";
+import { createMotionCheckTool } from "./motion-check-tool.js";
+import { motionStudioPrompt, readMotionStudioContext } from "./motion-studio-context.js";
+/**
+ * Motion's skill-catalog budget: double the default. The 16 KB default guards
+ * against bloated untrusted skills; Motion only ever loads its own bundled
+ * set. Retain headroom for future skills without loading their bodies.
+ */
+export const MOTION_SKILL_CATALOG_BYTES = 32 * 1024;
+/** Reserved `chatAgent` query value the app uses to list Motion sessions. */
+export const MOTION_SESSIONS_QUERY = "motion";
+/** Direct video work and sourcing only; no delegation, developer catalogs or MCP. */
+export const MOTION_TOOL_NAMES = [
+    "read",
+    "write",
+    "edit",
+    "bash",
+    "find",
+    "grep",
+    "ls",
+    "skill",
+    "ask_user",
+    "task_output",
+    "task_send",
+    "task_stop",
+    "web_search",
+    "web_fetch",
+    "screenshot",
+    "generate_image",
+    "motion_check",
+];
+/** Motion's private session store, beside coder's `sessions/` and chat's `chat-sessions/`. */
+export function motionSessionsDir(coderSessionsDir) {
+    return path.resolve(coderSessionsDir, "..", "motion-sessions");
+}
+/**
+ * Quote a path for the prompt's shell examples. POSIX single quotes on
+ * macOS/Linux; double quotes on Windows (paths there cannot contain `"`).
+ */
+function shellQuote(value) {
+    if (process.platform === "win32")
+        return `"${value}"`;
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/**
+ * The exact launcher invocation the agent must use for HyperFrames. Uses the
+ * Node running this sidecar, so Motion works without a system Node install.
+ */
+export function motionCliCommand(bundle, nodePath = process.execPath) {
+    return `${shellQuote(nodePath)} ${shellQuote(bundle.launcher)}`;
+}
+/** Motion's prompt with this install's concrete launcher paths filled in. */
+export function buildMotionAgentPrompt(bundle, nodePath = process.execPath) {
+    return MOTION_SYSTEM_PROMPT.replaceAll("{{HF}}", motionCliCommand(bundle, nodePath))
+        .replaceAll("{{NODE}}", shellQuote(nodePath))
+        .replaceAll("{{MOTION_BIN}}", path.join(bundle.root, "bin"))
+        .replaceAll("{{MUSIC_DIR}}", motionMusicDir(bundle))
+        .replaceAll("{{SFX_DIR}}", motionSfxDir(bundle))
+        .replaceAll("{{HF_VERSION}}", bundle.version);
+}
+/** Shared licensed music, independent of the creative skill catalog. */
+export function motionMusicDir(bundle) {
+    return path.join(bundle.root, "assets", "music");
+}
+/** Shared CC0 sound effects, independent of the creative skill catalog. */
+export function motionSfxDir(bundle) {
+    return path.join(bundle.root, "assets", "sfx");
+}
+/**
+ * Create a Motion session: focused tools, Motion's own prompt, and only
+ * the bundled Motion skills. Project/global skills, extensions and coder
+ * slash commands stay out so the mode is predictable for every user.
+ */
+export async function createMotionAgentSession(options) {
+    const bundle = await findMotionBundle();
+    if (!bundle) {
+        throw new Error("Motion mode is unavailable: this EZ install is missing its Motion bundle.");
+    }
+    const skills = await loadMotionSkills(bundle);
+    const { sessionsDir, ...sessionOptions } = options;
+    const sessionRootDir = motionSessionsDir(sessionsDir);
+    const requestedSession = sessionOptions.sessionId ? path.resolve(sessionOptions.sessionId) : null;
+    const resumableSession = requestedSession?.startsWith(`${sessionRootDir}${path.sep}`) === true
+        ? requestedSession
+        : undefined;
+    const studio = await readMotionStudioContext(options.cwd, options.signal);
+    const studioPrompt = motionStudioPrompt(studio);
+    return new AgentSession({
+        ...sessionOptions,
+        completionReview: undefined,
+        additionalTools: [
+            ...(sessionOptions.additionalTools ?? []),
+            createMotionCheckTool(options.cwd, bundle),
+        ],
+        allowedTools: [...MOTION_TOOL_NAMES],
+        allowedMcpServers: [],
+        sessionId: resumableSession,
+        agentPrompt: buildMotionAgentPrompt(bundle) + studioPrompt,
+        agentRole: "primary",
+        // Motion folders hold videos, not codebases; coder conventions do not apply.
+        agentContext: "none",
+        skills,
+        contextLimits: { skillCatalogBytes: MOTION_SKILL_CATALOG_BYTES },
+        promptCacheKeyPrefix: "ggmotion",
+        sessionRootDir,
+        coderSlashCommands: false,
+        selfCorrectionHooks: false,
+        projectCustomization: false,
+        globalSubagents: false,
+        loadExtensions: false,
+        orchestrationPrompt: false,
+    });
+}
+//# sourceMappingURL=motion-agent.js.map

package/dist/motion-agent/motion-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-agent.js","sourceRoot":"","sources":["../../src/motion-agent/motion-agent.ts"],"names":[],"mappings":"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"}

package/dist/motion-agent/motion-check-tool.d.ts

@@ -0,0 +1,35 @@
+import type { AgentTool } from "@prestyj/agent";
+import { z } from "zod";
+import type { MotionBundle } from "../core/skills.js";
+declare const parameters: z.ZodObject<{
+    project: z.ZodString;
+    output: z.ZodString;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>>;
+    windows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>>;
+    holds: z.ZodOptional<z.ZodString>;
+    slideshowRequested: z.ZodOptional<z.ZodBoolean>;
+    spot: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * Times of every frame the export contains inside `windows`, so a spot check audits what
+ * viewers see. Never a thinned set: across several samples the layout audit reports a
+ * collision seen only once as info, so skipped frames would hide the brief collisions a
+ * spot check exists to catch.
+ */
+export declare function spotSampleTimes(windows: readonly {
+    start: number;
+    end: number;
+}[], fps: number, duration: number): number[];
+/** One explicit check; the working agent sees the frames, with no separate model or approval loop. */
+export declare function createMotionCheckTool(cwd: string, bundle: MotionBundle, limits?: {
+    sourceCheckMs?: number;
+    spotMaxFrames?: number;
+}): AgentTool<typeof parameters>;
+export {};