@usecontextlayer/cli 0.14.3 → 0.15.0

package/dist/rolldown-runtime-EAsCxrDo.mjs

@@ -0,0 +1,14 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as n, __commonJSMin as t };

package/dist/template/AGENTS.md

@@ -0,0 +1,13 @@
+# ContextLayer app
+
+The interactive app declares resources in public/slate.json. Each agent declares its resources in agents/<name>/slate.json. All declarations share one namespace: matching database slugs select the same database, and repeated declarations must agree on owner/viewer mode. Connections and secrets follow the same namespace rule.
+
+## Databases and migrations
+
+Persistent app data belongs in declared SQLite databases. Each database keeps its Drizzle configuration, query schema and migration history under databases/<name>. The updates directory is an example; declare it in the relevant Slates to use it, or create the corresponding directory for your own database.
+
+Write SQL migrations explicitly. Run pnpm db:migration --config databases/<name>/drizzle.config.ts --name <change> to scaffold a blank migration with Drizzle Kit's native metadata, then author its SQL. Separate statements with Drizzle's --> statement-breakpoint marker. Commit the SQL and generated metadata. Never generate migrations from schema changes, run drizzle-kit push, or change deployed schemas ad hoc. Update schema.ts for typed queries alongside the SQL; the schema does not create tables.
+
+Platform applies pending migrations when publishing the app and when a member joins. Local Vite startup applies current-checkout migrations to ignored .contextlayer/databases before the app runs. Local agents use that same native local storage. Owner/viewer modes select hosted ownership; both use developer-local storage during development. No database selector or assignment is needed.
+
+Loaders and actions receive the request-scoped databasesContext from @usecontextlayer/sdk. Use database(context.get(databasesContext), "updates", schema) for native Drizzle queries, or call the capability's query(slug, sql, params) for SQL. Import the query schema through the app’s @/databases alias. Authored code selects declared slugs; platform owns physical instances and credentials. Agent database_query writes persist immediately. Sandbox files are scratch data.

package/dist/template/README.md

@@ -0,0 +1,44 @@
+# Your ContextLayer app
+
+This React Router app uses ContextLayer for connected services and is published through its Git remote.
+
+## Develop locally
+
+From this directory, run:
+
+```sh
+pnpm dev
+```
+
+Open the local URL printed by the development server. Edit `app/routes/home.tsx` to build your first page. Use `pnpm typecheck` and `pnpm build` for the app's normal TypeScript and production-build commands.
+
+## Use connected services
+
+Declare the services your app needs in `public/slate.json`. Authorization connects your account to ContextLayer; assignment binds that account to one of your app's declared connection slugs. Approve authorization in your browser, then use the local assignment chooser to select the account. An already connected account can go directly to assignment. Command help supplies the supported operations:
+
+```sh
+npx @usecontextlayer/cli connections --help
+npx @usecontextlayer/cli connection --help
+```
+
+The installed SDK guide at `node_modules/@usecontextlayer/sdk/README.md` gives the complete Gmail sequence: copy its route and declaration, authorize Gmail when needed, assign `work-email`, and start development. Local account choices are saved in ignored `.contextlayer/connections.json`. Restart `pnpm dev` after changing declarations or local assignments.
+
+## Store app data
+
+Declare database slugs in `public/slate.json` or `agents/<name>/slate.json`. Matching declarations within this app share data; each declaration selects hosted `owner` or `viewer` mode. Local development persists SQLite state in ignored `.contextlayer/databases`.
+
+Keep each database’s Drizzle configuration, query schema and migrations under `databases/<name>`. Run `pnpm db:migration --config databases/<name>/drizzle.config.ts --name <change>`, then write the blank SQL migration explicitly and update the query schema. Commit the SQL and native journal together. The query schema supplies types and does not generate the deployed database schema. The installed SDK guide documents `databasesContext` and the native Drizzle query client.
+
+Local startup applies the checkout’s migrations before queries. Hosted publication applies pending committed migrations for existing members, and joining applies the full history for a new member. Viewer-mode hosted execution requires joining; account configuration is available before joining. Agent filesystem files are scratch; use `database_query` for persistent data.
+
+## Publish
+
+Commit your changes and push the generated `main` branch:
+
+```sh
+git add .
+git commit
+git push -u origin main
+```
+
+ContextLayer builds and deploys the app through its native Git remote. Your dashboard and hosted URL were printed by initialization. The hosted URL becomes usable after deployment succeeds. The app starts private; sign in with your ContextLayer account to open it. Hosted account selection uses the app's ContextLayer header.

package/dist/template/app/root.tsx

@@ -1,3 +1,4 @@
+import { connectionRequiredSchema } from "@usecontextlayer/sdk"
 import { isRouteErrorResponse, Outlet } from "react-router"
 import type { Route } from "./+types/root"
 import "~/app.css"
@@ -9,6 +10,33 @@ export default function App() {
 }
 
 export function ErrorBoundary({ error }: Route.ErrorBoundaryProps) {
+	if (isRouteErrorResponse(error) && error.status === 409) {
+		const setup = connectionRequiredSchema.safeParse(error.data)
+		if (setup.success) {
+			return (
+				<main className="container mx-auto p-4 pt-16">
+					<h1 className="text-2xl font-semibold">Connect an account to continue</h1>
+					{import.meta.env.DEV ? (
+						<>
+							<p className="mt-3">
+								From your app directory, assign an account, then restart{" "}
+								<code>pnpm dev</code>:
+							</p>
+							<pre className="mt-4 overflow-x-auto">
+								<code>{`npx @usecontextlayer/cli connection local assign ${setup.data.slug}`}</code>
+							</pre>
+						</>
+					) : (
+						<p className="mt-3">
+							Open the connections menu above and choose an account, then refresh this
+							page.
+						</p>
+					)}
+				</main>
+			)
+		}
+	}
+
 	let message = "Oops!"
 	let details = "An unexpected error occurred."
 	let stack: string | undefined

package/dist/template/app/routes/home.tsx

@@ -1,11 +1,24 @@
 export function meta() {
-	return [{ title: "let's get cooking!" }]
+	return [{ title: "Your ContextLayer app" }]
 }
 
 export default function Home() {
 	return (
-		<main className="flex justify-center px-4 py-16">
-			<h1 className="text-2xl font-semibold">let&apos;s get cooking!</h1>
+		<main className="mx-auto max-w-2xl space-y-6 px-4 py-16">
+			<h1 className="text-2xl font-semibold">Your ContextLayer app is ready</h1>
+			<p>
+				Edit <code>app/routes/home.tsx</code> to build your first page.
+			</p>
+			<p>
+				To read from a connected service, declare it in <code>public/slate.json</code>,
+				assign your account through the CLI, and call its tools from a route loader.
+				Follow the Gmail example in the SDK guide to get started.
+			</p>
+			<p>
+				Your project&apos;s <code>README.md</code> explains development, connections, and
+				publishing. The SDK guide is in{" "}
+				<code>node_modules/@usecontextlayer/sdk/README.md</code>.
+			</p>
 		</main>
 	)
 }

package/dist/template/databases/updates/drizzle.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "drizzle-kit"
+
+export default defineConfig({
+	dialect: "sqlite",
+	driver: "durable-sqlite",
+	out: "./databases/updates/migrations",
+	schema: "./databases/updates/schema.ts",
+})

package/dist/template/databases/updates/migrations/0000_create_updates.sql

@@ -0,0 +1,6 @@
+CREATE TABLE updates (
+	id TEXT PRIMARY KEY NOT NULL,
+	kind TEXT NOT NULL,
+	body TEXT NOT NULL,
+	created_at INTEGER NOT NULL
+);

package/dist/template/databases/updates/migrations/meta/0000_snapshot.json

@@ -0,0 +1,14 @@
+{
+	"_meta": {
+		"columns": {},
+		"schemas": {},
+		"tables": {}
+	},
+	"dialect": "sqlite",
+	"enums": {},
+	"id": "54e1d4df-48db-4b80-9190-11f5dbd99d64",
+	"prevId": "00000000-0000-0000-0000-000000000000",
+	"tables": {},
+	"version": "6",
+	"views": {}
+}

package/dist/template/databases/updates/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+	"dialect": "sqlite",
+	"entries": [
+		{
+			"breakpoints": true,
+			"idx": 0,
+			"tag": "0000_create_updates",
+			"version": "6",
+			"when": 1791353847685
+		}
+	],
+	"version": "7"
+}

package/dist/template/databases/updates/migrations/migrations.js

@@ -0,0 +1,10 @@
+import journal from './meta/_journal.json';
+import m0000 from './0000_create_updates.sql';
+
+  export default {
+    journal,
+    migrations: {
+      m0000
+    }
+  }
+  

package/dist/template/databases/updates/schema.ts

@@ -0,0 +1,8 @@
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core"
+
+export const updates = sqliteTable("updates", {
+	body: text("body").notNull(),
+	createdAt: integer("created_at").notNull(),
+	id: text("id").primaryKey(),
+	kind: text("kind").notNull(),
+})

package/dist/template/workers/app.ts

@@ -1,7 +1,8 @@
-import { createApp } from "@usecontextlayer/sdk/worker"
+import { createApp, type McpToolModule } from "@usecontextlayer/sdk/worker"
 
 export default createApp({
 	build: () => import("virtual:react-router/server-build"),
 	development: import.meta.env.DEV,
+	mcp: import.meta.glob<McpToolModule>("/mcp/*/index.ts", { eager: true }),
 	mode: import.meta.env.MODE,
 })

package/dist/template/workers/local-resources/index.ts

@@ -0,0 +1 @@
+export { AppDatabase, DatabaseSetup, Databases, Tools } from "@usecontextlayer/sdk/local"

package/dist/template/workers/local-resources/wrangler.jsonc

@@ -0,0 +1,19 @@
+{
+	"compatibility_date": "2026-09-26",
+	"durable_objects": {
+		"bindings": [
+			{
+				"class_name": "AppDatabase",
+				"name": "DATABASE_STORAGE"
+			}
+		]
+	},
+	"main": "index.ts",
+	"migrations": [
+		{
+			"new_sqlite_classes": ["AppDatabase"],
+			"tag": "v1"
+		}
+	],
+	"name": "ctx-local-resources"
+}