@kazzle/app 0.1.945 → 0.1.946

package/templates/ai-app/kazzle.config.ts

@@ -1,11 +1,19 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'component', component: 'ui' },
   icon: 'components/ui/public/favicon.svg',
   components: [
     { name: 'ui', type: 'ui', path: './components/ui' },
     { name: 'server', type: 'process', path: './components/server/index.ts', runtime: { dev: { command: 'bun run dev' }, prod: { command: 'bun run start' } } },
   ],
+  tools: [],
+  skills: [],
 });

package/templates/empty-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/empty-app/kazzle.config.ts

@@ -1,10 +1,18 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'none' },
   /** Path to the app icon relative to the repo root. Uploaded to CDN on publish. */
   icon: 'icon.svg',
   /** App components — each entry defines a deployable unit. */
   components: [],
+  tools: [],
+  skills: [],
 });

package/templates/login-app/KAZZLE.md

@@ -15,4 +15,4 @@ Login rules — these keep sign-in working:
 - Server routes that touch user data start with `await kazzleAuth.getAppUser(c.req.raw)`; null → return 401.
 - New backend routes the browser calls must be added to `proxyPaths` in `components/ui/vite.config.ts`. `/api/auth` must stay in that list.
 
-Do not rerun `db.connect`, rewrite manifest env refs, recreate server boilerplate, or reinstall dependencies as setup repair after `app.create` reports template setup complete. Change these files only when the user asks for behavior beyond this template.
+Do not rerun `db.connect`, rewrite app definition env refs, recreate server boilerplate, or reinstall dependencies as setup repair after `app.create` reports template setup complete. Change these files only when the user asks for behavior beyond this template.

package/templates/login-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/login-app/kazzle.config.ts

@@ -1,8 +1,14 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'component', component: 'ui' },
   icon: 'components/ui/public/favicon.svg',
   /** End-user login (Google via Kazzle). Users live in this app's own database. */
   appLogin: true,
@@ -10,4 +16,6 @@ export default defineConfig({
     { name: 'ui', type: 'ui', path: './components/ui' },
     { name: 'server', type: 'process', path: './components/server/index.ts', runtime: { dev: { command: 'bun run dev' }, prod: { command: 'bun run start' } } },
   ],
+  tools: [],
+  skills: [],
 });

package/templates/process-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/process-app/components/process/index.ts

@@ -8,7 +8,7 @@
  *   - `Authorization: Bearer ${KAZZLE_TRIGGER_SECRET}` — validate this
  *     before doing any work. Calls without the header are external traffic
  *     and should be handled with your own auth (or rejected).
- *   - `x-kazzle-trigger-name` — the trigger's `name` from the manifest.
+ *   - `x-kazzle-trigger-name` — the trigger's `name` from the app definition.
  *   - `x-kazzle-trigger-run-id` — opaque ID for log correlation.
  *   - `x-kazzle-triggered-by` — 'cron' | 'webhook' | 'manual'.
  *

package/templates/process-app/kazzle.config.ts

@@ -1,8 +1,14 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'none' },
   /** Path to the app icon relative to the repo root. Uploaded to CDN on publish. */
   icon: 'icon.svg',
   /** App components — each entry defines a deployable unit. */
@@ -25,10 +31,10 @@ export default defineConfig({
       ],
     },
   ],
-  // Skills = what the AI knows + can do with this app. Each skill is a folder
-  // (SKILL.md + optional tools.ts). The tools in tools.ts are backed by
-  // `POST /tools/<name>` routes in the process component above (the "kitchen").
+  tools: [
+    { name: '{{APP_NAME}}', type: 'file', path: './skills/tools/tools.ts' },
+  ],
   skills: [
-    { name: '{{APP_NAME}}', path: './skills/tools/SKILL.md' },
+    { name: '{{APP_NAME}}', source: { type: 'file', path: './skills/tools/SKILL.md' } },
   ],
 });

package/templates/realtime-app/KAZZLE.md

@@ -8,4 +8,4 @@ Template-owned setup:
 - `components/ui/src/` owns the realtime UI and client logic.
 - `components/ui/package.json` and `components/server/package.json` already contain install, build, and check scripts.
 
-Do not rerun `db.connect`, rewrite manifest env refs, or replace realtime setup after `app.create` reports template setup complete. Change template-owned files only when requirements actually change app behavior.
+Do not rerun `db.connect`, rewrite app definition env refs, or replace realtime setup after `app.create` reports template setup complete. Change template-owned files only when requirements actually change app behavior.

package/templates/realtime-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/realtime-app/kazzle.config.ts

@@ -1,8 +1,14 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'component', component: 'ui' },
   /** Path to the app icon relative to the repo root. Uploaded to CDN on publish. */
   icon: 'components/ui/public/favicon.svg',
   /** App components — each entry defines a deployable unit. Max 1 UI component. */
@@ -10,4 +16,6 @@ export default defineConfig({
     { name: 'ui', type: 'ui', path: './components/ui' },
     { name: 'server', type: 'process', path: './components/server/index.ts', runtime: { dev: { command: 'bun run dev' }, prod: { command: 'bun run start' } } },
   ],
+  tools: [],
+  skills: [],
 });

package/templates/ui-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/ui-app/kazzle.config.ts

@@ -1,12 +1,20 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'component', component: '{{APP_NAME}}' },
   /** Path to the app icon relative to the repo root. Uploaded to CDN on publish. */
   icon: 'components/ui/public/favicon.svg',
   /** App components — each entry defines a deployable unit. Max 1 UI component. */
   components: [
     { name: '{{APP_NAME}}', type: 'ui', path: './components/ui' },
   ],
+  tools: [],
+  skills: [],
 });

package/templates/ui-db-app/KAZZLE.md

@@ -9,4 +9,4 @@ Template-owned setup:
 - `components/ui/package.json` and `components/server/package.json` already contain the install, build, and check scripts.
 - The database schema is bootstrapped by template setup before the app is handed back.
 
-Do not rerun `db.connect`, rewrite manifest env refs, recreate server boilerplate, or reinstall dependencies as setup repair after `app.create` reports template setup complete. Change these files only when the user asks for behavior beyond this template.
+Do not rerun `db.connect`, rewrite app definition env refs, recreate server boilerplate, or reinstall dependencies as setup repair after `app.create` reports template setup complete. Change these files only when the user asks for behavior beyond this template.

package/templates/ui-db-app/README.md

@@ -0,0 +1,3 @@
+# {{APP_NAME}}
+
+Describe what this app does and how people use it.

package/templates/ui-db-app/kazzle.config.ts

@@ -1,11 +1,19 @@
-import { defineConfig } from '@kazzle/app';
+import { defineApp } from '@kazzle/app';
 
-export default defineConfig({
+export default defineApp({
+  schemaVersion: 1,
+  name: '{{APP_NAME}}',
   /** One-line catalog tagline. Required to publish. */
   subtitle: '{{APP_NAME}}',
+  description: { type: 'markdown', path: 'README.md' },
+  maxInstallations: 1,
+  setup: { type: 'none' },
+  launch: { type: 'component', component: 'ui' },
   icon: 'components/ui/public/favicon.svg',
   components: [
     { name: 'ui', type: 'ui', path: './components/ui' },
     { name: 'server', type: 'process', path: './components/server/index.ts', runtime: { dev: { command: 'bun run dev' }, prod: { command: 'bun run start' } } },
   ],
+  tools: [],
+  skills: [],
 });

package/dist/connections.d.ts

@@ -1,11 +0,0 @@
-export declare class ConnectionNotConnectedError extends Error {
-    readonly connectionId: string;
-    constructor(connectionId: string, message?: string);
-}
-/**
- * A fresh vendor access token for a connection, e.g.
- * `new Stripe(await getConnectionToken('8f2a…'))`.
- */
-export declare function getConnectionToken(connectionId: string): Promise<string>;
-/** Forget cached tokens (tests, or after a reconnect). */
-export declare function clearConnectionTokenCache(): void;

package/dist/connections.js

@@ -1,56 +0,0 @@
-// @kazzle/app/connections — use the accounts a person connected in Kazzle
-// (Stripe, Gmail, Slack, …) from app code.
-//
-// Kazzle keeps the OAuth tokens; this asks Kazzle for a fresh one and caches it
-// until it expires. Identify the connection by its vault secret id (the AI that
-// built the app has it from the vault). Requires KAZZLE_API_KEY and
-// KAZZLE_API_URL, both injected into every component at deploy and `kazzle run`.
-//
-// Dependency-free on purpose (uses global fetch). Do not add zod/vite here.
-import { kazzleApiUrl } from './client';
-export class ConnectionNotConnectedError extends Error {
-    connectionId;
-    constructor(connectionId, message) {
-        super(message ?? `Connection ${connectionId} is not connected. Connect it on the Integrations page in Kazzle.`);
-        this.connectionId = connectionId;
-        this.name = 'ConnectionNotConnectedError';
-    }
-}
-const DEFAULT_TTL_MS = 60 * 60_000;
-const REFRESH_MARGIN_MS = 60_000;
-const cache = new Map();
-function apiKey() {
-    const key = process.env['KAZZLE_API_KEY'];
-    if (!key) {
-        throw new Error('KAZZLE_API_KEY is not set — connection tokens are only available to deployed Kazzle app components.');
-    }
-    return key;
-}
-/**
- * A fresh vendor access token for a connection, e.g.
- * `new Stripe(await getConnectionToken('8f2a…'))`.
- */
-export async function getConnectionToken(connectionId) {
-    const hit = cache.get(connectionId);
-    if (hit && hit.expiresAt - Date.now() > REFRESH_MARGIN_MS)
-        return hit.token;
-    const res = await fetch(`${kazzleApiUrl()}/connections/${encodeURIComponent(connectionId)}/token`, {
-        headers: { authorization: `Bearer ${apiKey()}` },
-    });
-    if (res.status === 404 || res.status === 409) {
-        const body = await res.json().catch(() => ({}));
-        cache.delete(connectionId);
-        throw new ConnectionNotConnectedError(connectionId, body.message);
-    }
-    if (!res.ok) {
-        throw new Error(`Kazzle connection token request failed: HTTP ${res.status}`);
-    }
-    const body = await res.json();
-    const expiresAt = body.expiresAt ? Date.parse(body.expiresAt) : Date.now() + DEFAULT_TTL_MS;
-    cache.set(connectionId, { token: body.token, expiresAt: Number.isFinite(expiresAt) ? expiresAt : Date.now() + DEFAULT_TTL_MS });
-    return body.token;
-}
-/** Forget cached tokens (tests, or after a reconnect). */
-export function clearConnectionTokenCache() {
-    cache.clear();
-}