@agent-native/core 0.85.6 → 0.86.0

package/corpus/templates/videos/.builder/skills/remotion/rules/trimming.md

@@ -1,38 +0,0 @@
----
-name: trimming
-description: Trimming patterns for Remotion - cut the beginning or end of animations
-metadata:
-  tags: sequence, trim, clip, cut, offset
----
-
-Use `<Sequence>` with a negative `from` value to trim the start of an animation.
-
-## Trim the Beginning
-
-```tsx
-const { fps } = useVideoConfig();
-
-<Sequence from={-0.5 * fps}>
-  <MyAnimation />
-</Sequence>;
-```
-
-## Trim the End
-
-```tsx
-<Sequence durationInFrames={1.5 * fps}>
-  <MyAnimation />
-</Sequence>
-```
-
-## Trim and Delay
-
-Nest sequences to both trim the beginning and delay:
-
-```tsx
-<Sequence from={30}>
-  <Sequence from={-15}>
-    <MyAnimation />
-  </Sequence>
-</Sequence>
-```

package/corpus/templates/videos/.builder/skills/remotion/rules/videos.md

@@ -1,54 +0,0 @@
----
-name: videos
-description: Embedding videos in Remotion - trimming, volume, speed, looping, pitch
-metadata:
-  tags: video, media, trim, volume, speed, loop, pitch
----
-
-# Using videos in Remotion
-
-## Prerequisites
-
-The @remotion/media package needs to be installed:
-
-```bash
-pnpm exec remotion add @remotion/media
-```
-
-## Basic Usage
-
-```tsx
-import { Video } from "@remotion/media";
-import { staticFile } from "remotion";
-
-export const MyComposition = () => {
-  return <Video src={staticFile("video.mp4")} />;
-};
-```
-
-## Trimming
-
-```tsx
-const { fps } = useVideoConfig();
-<Video
-  src={staticFile("video.mp4")}
-  trimBefore={2 * fps}
-  trimAfter={10 * fps}
-/>;
-```
-
-## Delaying
-
-```tsx
-<Sequence from={1 * fps}>
-  <Video src={staticFile("video.mp4")} />
-</Sequence>
-```
-
-## Volume, Speed, Looping, Pitch
-
-- `volume={0.5}` or `volume={(f) => interpolate(f, [0, fps], [0, 1])}`
-- `playbackRate={2}` for 2x speed
-- `loop` for looping
-- `toneFrequency={1.5}` for higher pitch (server-side only)
-- `muted` to silence

package/corpus/templates/videos/.dockerignore

@@ -1,62 +0,0 @@
-node_modules
-dist
-.git
-.gitignore
-README.md
-.env
-.env.local
-.env.development
-.env.test
-.env.production
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.DS_Store
-.vscode
-.idea
-*.swp
-*.swo
-*~
-.cursor
-coverage
-.nyc_output
-.eslintcache
-*.log
-*.lock
-*.tmp
-*.tmp.*
-log.txt
-
-.DS_Store
-node_modules
-**/node_modules/**
-build
-data
-.env
-load-ids.txt
-
-server
-tmp
-types
-.git
-.gitignore
-dist
-service
-tests
-fixtures-pages
-fixtures-apps
-
-# Netlify
-.netlify
-packages/ml-air/lib
-packages/ml-air/bin
-packages/ml-air/project
-packages/ml-air/share
-packages/ml-air/random_forest_classification/
-packages/ml-air/__pycache__/
-packages/ml-air/app/__pycache__/
-packages/vcp-common/native-bridge/build
-packages/vcp-common/_tests_/dataset-ranking.csv
-node_modules/
-Dockerfile
-.gitignore

package/corpus/templates/videos/.env.example

@@ -1,4 +0,0 @@
-# Database — defaults to local SQLite (file:./data/app.db)
-# Set to a remote URL for cloud database (e.g. libsql://your-db.turso.io)
-# DATABASE_URL=
-# DATABASE_AUTH_TOKEN=

package/corpus/templates/videos/.oxfmtrc.json

@@ -1,8 +0,0 @@
-{
-  "tabWidth": 2,
-  "useTabs": false,
-  "printWidth": 80,
-  "trailingComma": "all",
-  "proseWrap": "preserve",
-  "sortImports": true
-}

package/corpus/templates/videos/AGENTS.md

@@ -1,46 +0,0 @@
-# Videos — Agent Guide
-
-Videos is an agent-native animation/composition studio. The agent creates and
-edits compositions, timelines, animation tracks, design-system styling, folders,
-exports, and sharing through actions and SQL-backed application state.
-
-Keep this file short. Detailed animation, composition, and implementation rules
-live in `.agents/skills/`.
-
-## Core Rules
-
-- Never hardcode API keys, tokens, webhook URLs, signing secrets, private Builder/internal data, customer data, or credential-looking literals. Use secrets/OAuth/runtime configuration and obvious placeholders in examples.
-- Use actions for composition lifecycle, files, tracks, folders, design systems,
-  export, and sharing. Do not mutate composition tables directly.
-- In dev, call actions with `pnpm action <name>`; in production, call the native
-  tool. Read the action schema when a parameter is unclear.
-- Use `view-screen` before editing a specific composition if the active
-  composition/scene/timeline is not clear.
-- For linked design systems, fetch and follow tokens plus custom instructions
-  before generating visuals.
-- Treat timeline data as the source of truth. Document animated properties in
-  track metadata and use the established track helpers instead of hard-coded
-  animated values.
-- Keep generated showcase animations polished: purposeful motion, registered
-  interactive elements, natural cursor paths, and responsive framing.
-- Compositions are private by default. Use framework sharing actions for
-  visibility and share grants.
-- TypeScript only for source changes. Use existing Remotion/React patterns.
-
-## Application State
-
-- `navigation` describes the current view, composition id, folder, selected
-  element, and playback/editor state.
-- `navigate` moves the UI and is consumed by the client.
-- Use app actions or `view-screen` for refreshed timeline/editor snapshots.
-
-## Skills
-
-Read the relevant skill before deeper work:
-
-- `composition-management` for creating, editing, folders, exports, and sharing.
-- `animation-tracks` for track schemas, expressions, timeline behavior, and
-  animated property metadata.
-- `frontend-design` and `shadcn-ui` for UI changes.
-- `actions`, `delegate-to-agent`, `security`, and `self-modifying-code` for
-  framework patterns.

package/corpus/templates/videos/CHANGELOG.md

@@ -1,10 +0,0 @@
-# Changelog
-
-All notable user-facing changes to Agent-Native Videos are documented here. Open it any
-time from the command menu (Cmd+K → "What's new").
-
-## 2026-06-23
-
-### Added
-
-- See what's new right inside Agent-Native Videos — a changelog now lives in the command menu (Cmd+K).

package/corpus/templates/videos/DEVELOPING.md

@@ -1,143 +0,0 @@
-# Videos — Development Guide
-
-This guide is for development-mode agents editing this app's source code. For app operations and tools, see AGENTS.md.
-
-## Tech Stack
-
-- **PNPM**: Prefer pnpm
-- **Frontend**: React 19 + React Router 8 (spa) + TypeScript + Vite + TailwindCSS 3
-- **Backend**: Nitro (via @agent-native/core) — file-based API routing
-- **Testing**: Vitest
-- **UI**: Radix UI + TailwindCSS 3 + Lucide React icons
-- **Video**: Remotion for programmatic video compositions
-
-## Project Structure
-
-```
-app/                      # React SPA frontend
-├── pages/                # Route components (Index.tsx = home)
-├── components/ui/        # Pre-built UI component library
-├── remotion/             # Remotion compositions, registry, helpers
-│   ├── registry.ts       # Single source of truth for all compositions
-│   ├── trackAnimation.ts # Pure helpers: trackProgress(), getPropValue(), findTrack()
-│   ├── compositions/     # Individual Remotion composition components
-│   └── hooks/            # Interactive composition helpers
-├── root.tsx              # HTML shell + global providers setup
-└── global.css            # TailwindCSS 3 theming and global styles
-
-server/                   # Nitro API server
-├── routes/               # File-based route-only endpoints (auto-discovered by Nitro)
-├── plugins/              # Server plugins (startup logic)
-└── lib/                  # Shared server modules
-
-shared/                   # Types used by both client & server
-└── api.ts                # Shared API interfaces
-```
-
-## Framework Basics (Nitro + @agent-native/core)
-
-This app uses **Nitro** (via `@agent-native/core`) for the server. All server code lives in `server/`.
-
-### Server Directory
-
-```
-server/
-  routes/     # File-based route-only endpoints (auto-discovered by Nitro)
-  handlers/   # Route handler logic modules
-  plugins/    # Server plugins — run at startup (auth, SSE, etc.)
-  lib/        # Shared server modules (watcher instance, helpers)
-```
-
-### Adding App Data
-
-Normal app data starts as an action, not a custom route. Add `actions/<verb>-<resource>.ts` with `defineAction`, mark reads with `http: { method: "GET" }`, and call reads/writes from React with `useActionQuery` / `useActionMutation` from `@agent-native/core/client`. This keeps the UI and agent on one contract and lets mutating actions refresh action-backed queries automatically.
-
-### Adding a Route-Only Endpoint
-
-Use `server/routes/api/` only for protocols that cannot be modeled as JSON actions: multipart uploads, streaming/SSE/WebSocket, webhooks, OAuth callbacks/redirects, public SEO/OG endpoints, or binary/static asset serving. Do not add `/api/*` routes for normal CRUD, data queries, or pass-through wrappers around actions; the action endpoint already exists at `/_agent-native/actions/:name`.
-
-Each route-only endpoint still exports a default `defineEventHandler`, but keep shared app logic in actions or server libraries so agent and UI behavior do not fork.
-
-### Server Plugins
-
-Startup logic (auth, SSE, etc.) lives in `server/plugins/`. Use `defineNitroPlugin` from core:
-
-```ts
-import { defineNitroPlugin } from "@agent-native/core";
-
-export default defineNitroPlugin(async (nitroApp) => {
-  // Runs once at server startup
-});
-```
-
-### Key Imports from `@agent-native/core`
-
-| Import                                       | Purpose                                                                    |
-| -------------------------------------------- | -------------------------------------------------------------------------- |
-| `defineNitroPlugin`                          | Define a server plugin (re-exported from Nitro)                            |
-| `createDefaultSSEHandler`                    | Create SSE endpoint for DB change events (server)                          |
-| `readAppState`, `writeAppState`              | Read/write application state (from `@agent-native/core/application-state`) |
-| `readSetting`, `writeSetting`                | Read/write settings (from `@agent-native/core/settings`)                   |
-| `defineEventHandler`, `readBody`, `getQuery` | H3 route handler utilities (re-exported)                                   |
-| `sendToAgentChat`                            | Send messages to agent from UI (client-side)                               |
-| `agentChat`                                  | Send messages to agent from scripts (server-side)                          |
-
-## Routing System
-
-The routing system uses React Router v8 framework mode with file-based routing:
-
-- Routes are auto-discovered from `app/routes/` via `flatRoutes()`.
-- `app/routes/_index.tsx` is the home page (`/`).
-- Create a file to add a route (e.g. `app/routes/settings.tsx` → `/settings`).
-- Dynamic params use `$` prefix (e.g. `app/routes/c.$compositionId.tsx` → `/c/:compositionId`).
-
-### Styling System
-
-- **Primary**: TailwindCSS 3 utility classes
-- **Theme and design tokens**: Configure in `app/global.css`
-- **UI components**: Pre-built library in `app/components/ui/`
-- **Utility**: `cn()` combines `clsx` + `tailwind-merge` for conditional classes
-
-### Path Aliases
-
-- `@shared/*` — Shared folder
-- `@/*` — Client folder
-
-### Database (Cloud Deployment)
-
-Local development defaults to a SQLite file at `data/app.db`. That local file is for development; containers, previews, and serverless deploys can reset their filesystem. For production/cloud deployment, set `DATABASE_URL` to point to a persistent SQL database. Turso is optional, not required; common choices include Neon, Supabase, Turso/libSQL, plain Postgres, durable SQLite, D1 bindings, and Builder.io-managed environments when available.
-
-Real credential values belong only in local `.env` files, deployment configuration, or registered secrets/settings UI. Never commit, document, log, return, paste, or include real keys, tokens, webhook URLs, signing secrets, or private data in examples; use empty values or obvious placeholders.
-
-**Environment variables:**
-
-| Variable              | Required                        | Description                                                                |
-| --------------------- | ------------------------------- | -------------------------------------------------------------------------- |
-| `DATABASE_URL`        | Production yes, local dev no    | Persistent SQL connection string (local dev default: `file:./data/app.db`) |
-| `DATABASE_AUTH_TOKEN` | Only when the provider needs it | Auth token for providers such as Turso/libSQL                              |
-
-## Build & Dev Commands
-
-```bash
-pnpm dev        # Start dev server (client + server)
-pnpm build      # Production build
-pnpm start      # Start production server
-pnpm typecheck  # TypeScript validation
-pnpm test       # Run Vitest tests
-```
-
-## TypeScript Everywhere
-
-All code in this project must be TypeScript (`.ts`). Never create `.js`, `.cjs`, or `.mjs` files. Node 22+ runs `.ts` files natively, so no compilation step is needed for scripts. Use ESM imports (`import`), not CommonJS (`require`).
-
-## Extensions (Framework Feature)
-
-The framework provides **Extensions** — mini sandboxed Alpine.js apps that run inside iframes. Extensions let users (or the agent) create interactive widgets, dashboards, and utilities without modifying the app's source code. They appear in the sidebar under an "Extensions" section. (Distinct from LLM tools — the function-calling primitives the agent invokes.)
-
-- **Creating extensions**: Via the sidebar "+" button, agent chat, or `POST /_agent-native/extensions`
-- **API calls**: Extensions use `extensionFetch()` (legacy alias `toolFetch`) which proxies requests through the server with `${keys.NAME}` secret injection
-- **Styling**: Extensions inherit the main app's Tailwind v4 theme automatically
-- **Sharing**: Private by default, shareable with org or specific users (same model as other ownable resources)
-- **Security**: Iframe sandbox + CSP + SSRF protection on the proxy
-
-See the `extensions` skill in `.agents/skills/extensions/SKILL.md` for full implementation details.

package/corpus/templates/videos/README.md

@@ -1,33 +0,0 @@
-# Video
-
-An agent-native, Remotion-based video composition studio. Describe a video in
-plain English and the agent generates animated React compositions with camera
-moves, interactive cursor animations, and a full timeline editor.
-
-**Live app: [videos.agent-native.com](https://videos.agent-native.com)**
-
-Compositions are code-driven and yours to own. Generate with AI or build manually
-with the same track system, then refine keyframes, easing, and cursor
-interactions on the timeline.
-
-## Features
-
-- Describe videos in natural language and get React components + animation tracks.
-- Camera system with animatable translate, scale, rotate, and perspective.
-- Interactive cursor with hover/click detection and component-type interactions.
-- Advanced timeline: multi-keyframe editing, easing curves, and view ranges.
-- Built-in components: kinetic text, logo reveal/explode, slideshows, and more.
-- Standardized 1920×1080 @ 30fps compositions.
-
-## Develop locally
-
-Scaffold your own copy and run it:
-
-```bash
-npx @agent-native/core@latest create my-videos --standalone --template videos
-cd my-videos
-pnpm install
-pnpm dev
-```
-
-Full docs: [agent-native.com/docs/template-videos](https://agent-native.com/docs/template-videos).

package/corpus/templates/videos/actions/analyze-brand-assets.ts

@@ -1,151 +0,0 @@
-import { defineAction } from "@agent-native/core";
-import { ssrfSafeFetch } from "@agent-native/core/extensions/url-safety";
-import { resolveAccess } from "@agent-native/core/sharing";
-import { z } from "zod";
-
-import "../server/db/index.js"; // ensure registerShareableResource runs
-
-export function normalizeBrandWebsiteUrl(input: string): string {
-  const trimmed = input.trim();
-  if (!trimmed) throw new Error("Website URL is required");
-
-  const hasScheme = /^[a-z][a-z\d+.-]*:/i.test(trimmed);
-  const candidate = hasScheme ? trimmed : `https://${trimmed}`;
-  const parsed = new URL(candidate);
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw new Error("Only http and https URLs are allowed");
-  }
-  return parsed.href;
-}
-
-export default defineAction({
-  description:
-    "Gather brand data from various sources for agent analysis. " +
-    "If a websiteUrl is provided, fetches the page HTML and extracts: " +
-    "meta theme-color, CSS custom properties, font-face declarations. " +
-    "If a designSystemId is provided, includes its existing data. " +
-    "Returns structured data the agent can use to build or refine a design system.",
-  schema: z.object({
-    designSystemId: z
-      .string()
-      .optional()
-      .describe("Existing design system ID to include its data"),
-    companyName: z.string().optional().describe("Company or brand name"),
-    brandNotes: z
-      .string()
-      .optional()
-      .describe("Free-form notes about the brand style"),
-    websiteUrl: z
-      .string()
-      .optional()
-      .describe("URL to fetch and extract brand signals from"),
-  }),
-  readOnly: true,
-  http: { method: "GET" },
-  run: async ({ designSystemId, companyName, brandNotes, websiteUrl }) => {
-    const result: Record<string, unknown> = {};
-
-    if (companyName) {
-      result.companyName = companyName;
-    }
-    if (brandNotes) {
-      result.brandNotes = brandNotes;
-    }
-
-    // Include existing design system data if provided
-    if (designSystemId) {
-      const access = await resolveAccess("design-system", designSystemId);
-      if (access) {
-        const row = access.resource;
-        result.existingDesignSystem = {
-          id: row.id,
-          title: row.title,
-          data: row.data ? JSON.parse(row.data) : null,
-          assets: row.assets ? JSON.parse(row.assets) : null,
-        };
-      }
-    }
-
-    // Fetch and analyze website if URL provided
-    if (websiteUrl) {
-      try {
-        const url = normalizeBrandWebsiteUrl(websiteUrl);
-        const response = await ssrfSafeFetch(
-          url,
-          {
-            headers: {
-              "User-Agent":
-                "Mozilla/5.0 (compatible; AgentNative/1.0; +https://agent-native.com)",
-            },
-            signal: AbortSignal.timeout(10000),
-          },
-          { maxRedirects: 3 },
-        );
-        const html = await response.text();
-
-        const extracted: Record<string, unknown> = { url };
-
-        // Extract meta theme-color
-        const themeColorMatch = html.match(
-          /<meta[^>]*name=["']theme-color["'][^>]*content=["']([^"']+)["']/i,
-        );
-        if (themeColorMatch) {
-          extracted.themeColor = themeColorMatch[1];
-        }
-
-        // Extract CSS custom properties (--var-name: value)
-        const cssVarMatches = html.matchAll(/--([\w-]+)\s*:\s*([^;}\n]+)/g);
-        const cssVars: Record<string, string> = {};
-        for (const match of cssVarMatches) {
-          cssVars[`--${match[1]}`] = match[2].trim();
-        }
-        if (Object.keys(cssVars).length > 0) {
-          // Limit to first 50 to avoid overwhelming output
-          const entries = Object.entries(cssVars).slice(0, 50);
-          extracted.cssCustomProperties = Object.fromEntries(entries);
-        }
-
-        // Extract @font-face declarations
-        const fontFaceMatches = html.matchAll(/@font-face\s*\{([^}]+)\}/g);
-        const fonts: { family?: string; src?: string }[] = [];
-        for (const match of fontFaceMatches) {
-          const block = match[1];
-          const familyMatch = block.match(
-            /font-family\s*:\s*["']?([^"';]+)["']?/,
-          );
-          const srcMatch = block.match(/src\s*:\s*([^;]+)/);
-          fonts.push({
-            family: familyMatch?.[1]?.trim(),
-            src: srcMatch?.[1]?.trim()?.slice(0, 200),
-          });
-        }
-        if (fonts.length > 0) {
-          extracted.fontFaces = fonts.slice(0, 20);
-        }
-
-        // Extract title
-        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
-        if (titleMatch) {
-          extracted.pageTitle = titleMatch[1].trim();
-        }
-
-        // Extract meta description
-        const descMatch = html.match(
-          /<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["']/i,
-        );
-        if (descMatch) {
-          extracted.metaDescription = descMatch[1];
-        }
-
-        result.websiteAnalysis = extracted;
-      } catch (err) {
-        result.websiteAnalysis = {
-          url: websiteUrl,
-          error: `Failed to fetch: ${err instanceof Error ? err.message : String(err)}`,
-        };
-      }
-    }
-
-    return result;
-  },
-});

package/corpus/templates/videos/actions/apply-design-system.ts

@@ -1,35 +0,0 @@
-import { defineAction } from "@agent-native/core";
-import { assertAccess } from "@agent-native/core/sharing";
-import { eq } from "drizzle-orm";
-import { z } from "zod";
-
-import { getDb, schema } from "../server/db/index.js";
-
-export default defineAction({
-  description:
-    "Link a design system to a composition. The composition will use this design system's " +
-    "colors, typography, and styling. Requires editor access on the composition.",
-  schema: z.object({
-    compositionId: z
-      .string()
-      .describe("Composition ID to apply the design system to"),
-    designSystemId: z
-      .string()
-      .describe("Design system ID to link to the composition"),
-  }),
-  run: async ({ compositionId, designSystemId }) => {
-    // Verify access to both the composition and the design system
-    await assertAccess("composition", compositionId, "editor");
-    await assertAccess("design-system", designSystemId, "viewer");
-
-    const db = getDb();
-    const now = new Date().toISOString();
-
-    await db
-      .update(schema.compositions)
-      .set({ designSystemId, updatedAt: now })
-      .where(eq(schema.compositions.id, compositionId));
-
-    return { compositionId, designSystemId, applied: true };
-  },
-});

package/corpus/templates/videos/actions/create-design-system.ts

@@ -1,84 +0,0 @@
-import { defineAction } from "@agent-native/core";
-import {
-  getRequestUserEmail,
-  getRequestOrgId,
-} from "@agent-native/core/server/request-context";
-import { accessFilter } from "@agent-native/core/sharing";
-import { z } from "zod";
-
-import { getDb, schema } from "../server/db/index.js";
-
-export default defineAction({
-  description:
-    "Create a new design system with brand colors, typography, spacing, and other design tokens. " +
-    "If this is the first design system for the user, it is automatically set as the default.",
-  schema: z.object({
-    title: z.string().describe("Design system name (e.g. 'Acme Corp Brand')"),
-    description: z
-      .string()
-      .optional()
-      .describe("Short description of the design system"),
-    data: z
-      .string()
-      .describe(
-        "JSON string of DesignSystemData (colors, typography, spacing, etc.)",
-      ),
-    assets: z
-      .string()
-      .optional()
-      .describe("JSON string of DesignSystemAsset[] (logos, fonts, images)"),
-    customInstructions: z
-      .string()
-      .optional()
-      .describe(
-        "Free-form guidance the agent should follow whenever it generates compositions using this design system (tone, motion preferences, dos and don'ts).",
-      ),
-  }),
-  run: async ({ title, description, data, assets, customInstructions }) => {
-    // Validate that data is valid JSON
-    try {
-      JSON.parse(data);
-    } catch {
-      throw new Error("data must be a valid JSON string");
-    }
-    if (assets) {
-      try {
-        JSON.parse(assets);
-      } catch {
-        throw new Error("assets must be a valid JSON string");
-      }
-    }
-
-    const db = getDb();
-    const id = crypto.randomUUID();
-    const now = new Date().toISOString();
-    const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
-    const orgId = getRequestOrgId();
-
-    // Check if user has any existing design systems to determine default
-    const existing = await db
-      .select({ id: schema.designSystems.id })
-      .from(schema.designSystems)
-      .where(accessFilter(schema.designSystems, schema.designSystemShares))
-      .limit(1);
-
-    const isDefault = existing.length === 0;
-
-    await db.insert(schema.designSystems).values({
-      id,
-      title,
-      description: description ?? null,
-      data,
-      assets: assets ?? null,
-      customInstructions: customInstructions ?? "",
-      isDefault,
-      ownerEmail,
-      orgId,
-      createdAt: now,
-      updatedAt: now,
-    });
-
-    return { id, title, isDefault };
-  },
-});