@usecontextlayer/cli 0.15.0 → 0.16.1

package/dist/auth.mjs

@@ -1,2 +1,2 @@
-import { i as listOrganizations, n as getAccessToken, r as getCurrentUser, t as LoginRequiredError } from "./auth-CMrKVwsH.mjs";
+import { i as listOrganizations, n as getAccessToken, r as getCurrentUser, t as LoginRequiredError } from "./auth-DOsE8GwJ.mjs";
 export { LoginRequiredError, getAccessToken, getCurrentUser, listOrganizations };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as __commonJSMin } from "./rolldown-runtime-EAsCxrDo.mjs";
-import { S as uuid, a as login, b as unknown, c as array, d as hostname, f as literal, g as record, h as object, i as listOrganizations, l as boolean, n as getAccessToken, p as looseObject, r as getCurrentUser, t as LoginRequiredError, v as string, x as url, y as union } from "./auth-CMrKVwsH.mjs";
-import { c as resourcesForConsumer, f as execa, i as ownerSchema, l as secretNameSchema, n as saveLocalConnection, o as joinApp, r as appResourceConfigurationSchema, s as env, t as prepareLocalResourceConfiguration, u as databaseQuerySchema } from "./resources-5FTDu19i.mjs";
+import { S as uuid, a as login, b as unknown, c as array, d as hostname, f as literal, g as record, h as object, i as listOrganizations, l as boolean, n as getAccessToken, p as looseObject, r as getCurrentUser, t as LoginRequiredError, v as string, x as url, y as union } from "./auth-DOsE8GwJ.mjs";
+import { a as env, c as resourcesForConsumer, f as execa, i as joinSlate, l as secretNameSchema, n as saveLocalConnection, o as slateResourceConfigurationSchema, s as ownerSchema, t as prepareLocalResourceConfiguration, u as databaseQuerySchema } from "./resources-B-EYHG1j.mjs";
 import { cp, readFile, writeFile } from "node:fs/promises";
 import path, { join } from "node:path";
 import { EventEmitter } from "node:events";
@@ -2967,7 +2967,7 @@ function useColor() {
 new Command();
 //#endregion
 //#region agents.ts
-const platformInstructions = "You are a ContextLayer app agent. The user message is the task for this run. Work in the app directory and return the task's result. Use database_query to read and save persistent data in declared databases. Files are scratch data; schema changes belong in explicitly authored SQL migrations.";
+const platformInstructions = "You are an agent of a ContextLayer slate.The user message is the task for this run. Work in the checkout and return the task's result. Use database_query to read and save persistent data in declared databases. Files are scratch data; schema changes belong in explicitly authored SQL migrations.";
 async function runLocalAgent(name, prompt) {
 	const instructions = await readFile(join("agents", name, "instructions.md"), "utf8");
 	const { createServer } = await import("vite");
@@ -3880,10 +3880,6 @@ ${f}
 };
 `${styleText("gray", S_BAR)}`;
 //#endregion
-//#region ../shared/dist/app-connections.mjs
-const appConnectionSchema = appResourceConfigurationSchema.shape.connections.valueType.extend({ slug: string() });
-const appConnectionsSchema = object({ connections: array(appConnectionSchema) });
-//#endregion
 //#region ../shared/dist/connections.mjs
 const connectionSchema = object({
 	alias: string().nullable(),
@@ -3894,12 +3890,16 @@ const connectionSchema = object({
 });
 const connectionsSchema = object({ connections: array(connectionSchema) });
 //#endregion
+//#region ../shared/dist/slate-connections.mjs
+const slateConnectionSchema = slateResourceConfigurationSchema.shape.connections.valueType.extend({ slug: string() });
+const slateConnectionsSchema = object({ connections: array(slateConnectionSchema) });
+//#endregion
 //#region owner.ts
 const ownerOptionsSchema = object({ org: string().min(1).optional() });
 async function resolveOwner(org, headers) {
 	if (!org) return {
 		id: (await getCurrentUser(env, headers)).id,
-		type: "user"
+		type: "personal"
 	};
 	const organization = (await listOrganizations(env, headers)).find((organization) => organization.slug === org);
 	if (!organization) throw new Error("Organization is not in your memberships");
@@ -3909,7 +3909,7 @@ async function resolveOwner(org, headers) {
 	};
 }
 function ownerPath(owner) {
-	return `${owner.type === "organization" ? "org" : "user"}/${encodeURIComponent(owner.id)}`;
+	return `${owner.type === "organization" ? "org" : "personal"}/${encodeURIComponent(owner.id)}`;
 }
 //#endregion
 //#region connections.ts
@@ -3924,7 +3924,7 @@ const connectionAssignmentSchema = object({
 		path: ["connection_id"]
 	});
 });
-async function assignAppConnection(target, slug, connectionId) {
+async function assignSlateConnection(target, slug, connectionId) {
 	if (target === "local") {
 		const configuration = await prepareLocalResourceConfiguration();
 		const requirement = new Map(Object.entries(configuration.connections)).get(slug);
@@ -3933,31 +3933,31 @@ async function assignAppConnection(target, slug, connectionId) {
 		const url = new URL("/api/connections", env.CTX_PLATFORM_URL);
 		url.searchParams.set("toolkit", requirement.toolkit);
 		const response = await fetch(url, { headers: { authorization: `Bearer ${await getAccessToken(env)}` } });
-		if (!response.ok) throw new Error(`Personal connection list failed: HTTP ${response.status}`);
+		if (!response.ok) throw new Error(`Personal connected account list failed: HTTP ${response.status}`);
 		const { connections } = connectionsSchema.parse(await response.json());
-		if (connections.length === 0) throw new Error(`No personal ${requirement.toolkit} accounts. Run npx @usecontextlayer/cli connections add ${requirement.toolkit}, approve access in your browser, then rerun this assignment.`);
+		if (connections.length === 0) throw new Error(`No personal connected accounts for ${requirement.toolkit}. Run npx @usecontextlayer/cli connections add ${requirement.toolkit} to connect an account in your browser, then rerun this assignment.`);
 		if (connectionId === void 0) {
-			const selected = await select({
-				message: `Your ${requirement.toolkit} account for ${slug}`,
+			const accountId = await select({
+				message: `Assign a connected ${requirement.toolkit} account to ${slug}`,
 				options: connections.map((connection) => ({
 					label: `${connection.display_name ?? connection.alias ?? connection.id} (${connection.id}; ${connection.status})`,
 					value: connection.id
 				})),
 				output: process.stderr
 			});
-			if (isCancel(selected)) {
+			if (isCancel(accountId)) {
 				process.exitCode = 130;
 				return;
 			}
-			connectionId = selected;
+			connectionId = accountId;
 		}
-		if (!connections.some(({ id }) => id === connectionId)) throw new Error(`Account ${connectionId} is not one of your ${requirement.toolkit} accounts`);
+		if (!connections.some(({ id }) => id === connectionId)) throw new Error(`Connected account ${connectionId} is not one of your connected ${requirement.toolkit} accounts`);
 		await saveLocalConnection(slug, connectionId);
 		console.log(`${slug} → ${connectionId}`);
 		console.log("Start or restart pnpm dev to use this assignment.");
 		return;
 	}
-	const response = await fetch(new URL(`/api/apps/${encodeURIComponent(target)}/connections/assign`, env.CTX_PLATFORM_URL), {
+	const response = await fetch(new URL(`/api/slates/${encodeURIComponent(target)}/connections/assign`, env.CTX_PLATFORM_URL), {
 		body: JSON.stringify({
 			connection_id: connectionId,
 			slug
@@ -3975,7 +3975,7 @@ async function assignAppConnection(target, slug, connectionId) {
 	}).parse(await response.json());
 	console.log(`${assignment.slug} → ${assignment.connection_id}`);
 }
-async function listAppConnections(target) {
+async function listSlateConnections(target) {
 	if (target === "local") {
 		const { connections } = await prepareLocalResourceConfiguration();
 		if (Object.keys(connections).length === 0) {
@@ -3983,7 +3983,7 @@ async function listAppConnections(target) {
 			return;
 		}
 		console.table(Object.entries(connections).map(([slug, { connection_id, consumers, mode, toolkit }]) => ({
-			connection: connection_id ?? "unassigned",
+			connected_account: connection_id ?? "unassigned",
 			consumers: consumers.map((consumer) => consumer.type === "app" ? "app" : `agent:${consumer.name}`).join(", "),
 			mode,
 			slug,
@@ -3991,7 +3991,7 @@ async function listAppConnections(target) {
 		})));
 		return;
 	}
-	const response = await fetch(new URL(`/api/apps/${encodeURIComponent(target)}/connections/list`, env.CTX_PLATFORM_URL), {
+	const response = await fetch(new URL(`/api/slates/${encodeURIComponent(target)}/connections/list`, env.CTX_PLATFORM_URL), {
 		body: JSON.stringify({}),
 		headers: {
 			authorization: `Bearer ${await getAccessToken(env)}`,
@@ -3999,18 +3999,18 @@ async function listAppConnections(target) {
 		},
 		method: "POST"
 	});
-	if (!response.ok) throw new Error(`App connections request failed: HTTP ${response.status}`);
-	const { connections } = appConnectionsSchema.parse(await response.json());
+	if (!response.ok) throw new Error(`Slate connections request failed: HTTP ${response.status}`);
+	const { connections } = slateConnectionsSchema.parse(await response.json());
 	if (!connections.length) {
 		console.log("No connection requirements.");
 		return;
 	}
 	console.table(connections.map(({ connection_id, ...requirement }) => ({
 		...requirement,
-		connection: connection_id ?? "unassigned"
+		connected_account: connection_id ?? "unassigned"
 	})));
 }
-async function addConnection(toolkit, org) {
+async function connectAccount(toolkit, org) {
 	const headers = { authorization: `Bearer ${await getAccessToken(env)}` };
 	const owner = await resolveOwner(org, headers);
 	const response = await fetch(new URL(`/api/connections/${ownerPath(owner)}`, env.CTX_PLATFORM_URL), {
@@ -4021,18 +4021,18 @@ async function addConnection(toolkit, org) {
 		},
 		method: "POST"
 	});
-	if (!response.ok) throw new Error(`Connection authorization failed: HTTP ${response.status}`);
+	if (!response.ok) throw new Error(`Connecting account failed: HTTP ${response.status}`);
 	const { redirect_url } = object({ redirect_url: url() }).parse(await response.json());
-	console.log(`Open this link to authorize the Owner's account:\n${redirect_url}`);
-	console.log("After approving access in your browser, assign the account to an app's declared connection slug.");
-	if (!org) console.log("From your app directory, choose your account for a slug in public/slate.json:\n  npx @usecontextlayer/cli connection local assign <slug>");
-	console.log(`For a hosted app, get the account ID and assign it:\n  npx @usecontextlayer/cli connections${org ? ` --org '${org.replaceAll("'", "'\\''")}'` : ""} list\n  npx @usecontextlayer/cli connection <AppID-or-hostname> assign <slug> <connection_id>`);
+	console.log(`Open this link to connect the Owner's account:\n${redirect_url}`);
+	console.log("After connecting in your browser, assign the connected account to a slate's declared connection.");
+	if (!org) console.log("From your checkout, assign your connected account to a connection declared in slate.json:\n  npx @usecontextlayer/cli connection local assign <slug>");
+	console.log(`For a hosted slate, get the connected account ID and assign it:\n  npx @usecontextlayer/cli connections${org ? ` --org '${org.replaceAll("'", "'\\''")}'` : ""} list\n  npx @usecontextlayer/cli connection <SlateID-or-hostname> assign <slug> <connection_id>`);
 }
 async function listConnections(org) {
 	const headers = { authorization: `Bearer ${await getAccessToken(env)}` };
 	const owner = await resolveOwner(org, headers);
 	const response = await fetch(new URL(`/api/connections/${ownerPath(owner)}`, env.CTX_PLATFORM_URL), { headers });
-	if (!response.ok) throw new Error(`Connection list failed: HTTP ${response.status}`);
+	if (!response.ok) throw new Error(`Connected account list failed: HTTP ${response.status}`);
 	const { connections } = connectionsSchema.parse(await response.json());
 	if (connections.length === 0) {
 		console.log("No connected accounts.");
@@ -4042,7 +4042,7 @@ async function listConnections(org) {
 }
 //#endregion
 //#region git-credential.ts
-async function setupGit(cli) {
+async function configureGit(cli) {
 	const key = `credential.${new URL("/git", env.CTX_PLATFORM_URL).href}.helper`;
 	const command = [
 		process.execPath,
@@ -4082,7 +4082,7 @@ async function gitCredential(operation) {
 }
 //#endregion
 //#region package.json
-var version = "0.15.0";
+var version = "0.16.1";
 //#endregion
 //#region secrets.ts
 const secretOptionsSchema = ownerOptionsSchema.extend({ stdin: boolean().default(false) });
@@ -4151,7 +4151,7 @@ async function authenticate(command) {
 async function requireLogin(command) {
 	await authenticate(command);
 }
-program.command("init <directory>").description("Create a private ContextLayer app on main with React Router, Tailwind, and shadcn; requires login, Node.js 24+, pnpm, and Git author identity; sets the Git remote and prints how to start and publish the app").option("--org <slug>", "Create the app under an organization you belong to").hook("preAction", requireLogin).action(async (directory, options) => {
+program.command("init <directory>").description("Create a private ContextLayer slate on main with React Router, Tailwind, and shadcn; requires login, Node.js 24+, pnpm, and Git author identity; sets the Git remote and prints how to start and deploy the slate").option("--org <slug>", "Create the slate under an organization you belong to").hook("preAction", requireLogin).action(async (directory, options) => {
 	const input = object({ organization_slug: string().min(1).optional() }).parse({ organization_slug: options.org });
 	const accessToken = await getAccessToken(env);
 	const gitIdentity = await execa("git", ["var", "GIT_AUTHOR_IDENT"], {
@@ -4256,10 +4256,10 @@ program.command("init <directory>").description("Create a private ContextLayer a
 	process.exitCode = migrationTool.exitCode;
 	if (migrationTool.exitCode !== 0) return;
 	const packagePath = join(directory, "package.json");
-	const projectPackage = looseObject({ scripts: record(string(), string()) }).parse(JSON.parse(await readFile(packagePath, "utf8")));
-	projectPackage.scripts["db:migration"] = "drizzle-kit generate --custom";
-	await writeFile(packagePath, `${JSON.stringify(projectPackage, null, 2)}\n`);
-	const response = await fetch(new URL("/api/apps", env.CTX_PLATFORM_URL), {
+	const checkoutPackage = looseObject({ scripts: record(string(), string()) }).parse(JSON.parse(await readFile(packagePath, "utf8")));
+	checkoutPackage.scripts["db:migration"] = "drizzle-kit generate --custom";
+	await writeFile(packagePath, `${JSON.stringify(checkoutPackage, null, 2)}\n`);
+	const response = await fetch(new URL("/api/slates", env.CTX_PLATFORM_URL), {
 		body: JSON.stringify(input),
 		headers: {
 			authorization: `Bearer ${accessToken}`,
@@ -4267,12 +4267,12 @@ program.command("init <directory>").description("Create a private ContextLayer a
 		},
 		method: "POST"
 	});
-	if (!response.ok) throw new Error(`App creation failed: HTTP ${response.status}`);
-	const app = object({
+	if (!response.ok) throw new Error(`Slate creation failed: HTTP ${response.status}`);
+	const slate = object({
 		id: uuid(),
 		public_hostname: hostname()
 	}).parse(await response.json());
-	const remote = new URL(`/git/${app.id}`, env.CTX_PLATFORM_URL);
+	const remote = new URL(`/git/${slate.id}`, env.CTX_PLATFORM_URL);
 	const git = await execa("git", [
 		"remote",
 		"add",
@@ -4286,16 +4286,16 @@ program.command("init <directory>").description("Create a private ContextLayer a
 	process.exitCode = git.exitCode;
 	if (git.exitCode !== 0) return;
 	console.log(`
-ContextLayer app created: ${app.id}
-Dashboard: ${new URL(`/dashboard/apps/${app.id}`, env.CTX_PLATFORM_URL).href}
-Hosted URL: https://${app.public_hostname}/ (available after deployment)
+ContextLayer slate created: ${slate.id}
+Dashboard: ${new URL(`/dashboard/slates/${slate.id}`, env.CTX_PLATFORM_URL).href}
+Hosted URL: https://${slate.public_hostname}/ (available after deployment)
 
 Start locally:
   cd '${directory.replaceAll("'", "'\\''")}'
   pnpm dev
 Open the local URL printed by the development server.
 
-Publish your changes:
+Deploy your changes:
   git add .
   git commit
   git push -u origin main
@@ -4305,7 +4305,7 @@ See README.md for the development and connection workflow.
 });
 program.command("login").description("Sign in by approving a browser code and configure Git credentials for ContextLayer repositories").action(async () => {
 	await login(env);
-	await setupGit(new URL(import.meta.url));
+	await configureGit(new URL(import.meta.url));
 	console.log("Git credentials configured for ContextLayer.");
 });
 program.command("git-credential <operation>").description("Git credential helper using the saved login; invoked automatically by Git").hook("preAction", async (command) => {
@@ -4314,35 +4314,35 @@ program.command("git-credential <operation>").description("Git credential helper
 program.command("whoami").description("Show your ContextLayer user ID verified by the auth server").action(async (_options, command) => {
 	console.log((await authenticate(command)).id);
 });
-program.command("join").argument("<target>", "AppID, public hostname, or local (run from the app root)").description("Join a private app you can view using ctx login, enabling member-scoped unattended work; returns app and user IDs").hook("preAction", requireLogin).action(async (target) => {
-	await joinApp(union([
+program.command("join").argument("<target>", "SlateID, public hostname, or local (run from the checkout root)").description("Join a private slate you can view using ctx login, enabling member-scoped unattended work; returns slate and user IDs").hook("preAction", requireLogin).action(async (target) => {
+	await joinSlate(union([
 		literal("local"),
 		uuid(),
 		hostname()
 	]).parse(target));
 });
-const connections = program.command("connections").description("Manage Owner-owned connected accounts or list app and agent connection requirements; local reads only the current folder and its saved development choices").option("--org <org_slug>", "Manage this organization's connections; defaults to the signed-in user").argument("[target]", "AppID or public hostname (pushed requirements), or local (current folder; no platform request)").addArgument(new Argument("[operation]", "App connection operation").choices(["list"])).hook("preAction", async (command, actionCommand) => {
+const connections = program.command("connections").description("Manage Owner-owned connected accounts or list app and agent connections and assignments; local reads only the current checkout and its saved development assignments").option("--org <slug>", "Manage this organization's connected accounts; defaults to the signed-in user").argument("[target]", "SlateID or public hostname (pushed requirements), or local (current checkout; no platform request)").addArgument(new Argument("[operation]", "Slate connection operation").choices(["list"])).hook("preAction", async (command, actionCommand) => {
 	if (actionCommand !== command || command.args[0] !== "local") await requireLogin(actionCommand);
 }).action(async (target, operation) => {
 	if (!target || !operation) connections.error("Expected: ctx connections <target> list");
-	await listAppConnections(target);
+	await listSlateConnections(target);
 });
-connections.command("list").description("List the selected Owner's Composio accounts with their toolkit, identity, and status").action(async (_options, command) => {
+connections.command("list").description("List the selected Owner's connected accounts with their toolkit, identity, and status").action(async (_options, command) => {
 	await listConnections(ownerOptionsSchema.parse(command.optsWithGlobals()).org);
 });
-connections.command("add <toolkit>").description("Authorize the selected Owner's account in your browser (for example, gmail), then assign it to an app's declared connection slug with ctx connection").action(async (toolkit, _options, command) => {
+connections.command("add <toolkit>").description("Connect the selected Owner's account in your browser (for example, gmail), then assign the connected account to a slate's declared connection with ctx connection").action(async (toolkit, _options, command) => {
 	const options = ownerOptionsSchema.parse(command.optsWithGlobals());
-	await addConnection(string().min(1).parse(toolkit), options.org);
+	await connectAccount(string().min(1).parse(toolkit), options.org);
 });
-program.command("connection").description("Bind a declared slug: local saves your personal account in .contextlayer/connections.json; AppID/hostname saves a hosted assignment under its declared Owner").argument("<target>", "AppID, public hostname, or local (run from the app root)").addArgument(new Argument("<operation>").choices(["assign"])).argument("<slug>", "Connection slug declared in your Slate (for example, work-email)").argument("[connection_id]", "Connected account ID; omit locally to choose your accounts for the declared toolkit; required for hosted targets").hook("preAction", requireLogin).action(async (target, _operation, slug, connectionId) => {
+program.command("connection").description("Assign a connected account to a declared connection: local saves a personal connected account assignment in .contextlayer/connections.json; SlateID/hostname saves a hosted assignment under its declared Owner").argument("<target>", "SlateID, public hostname, or local (run from the checkout root)").addArgument(new Argument("<operation>").choices(["assign"])).argument("<slug>", "Connection slug declared in slate.json (for example, work-email)").argument("[connection_id]", "Connected account ID; omit locally to assign a connected account for the declared toolkit interactively; required for hosted targets").hook("preAction", requireLogin).action(async (target, _operation, slug, connectionId) => {
 	const input = connectionAssignmentSchema.parse({
 		connection_id: connectionId,
 		slug,
 		target
 	});
-	await assignAppConnection(input.target, input.slug, input.connection_id);
+	await assignSlateConnection(input.target, input.slug, input.connection_id);
 });
-program.command("agent").addArgument(new Argument("<target>", "Run from the app root").choices(["local"])).addArgument(new Argument("<operation>").choices(["run"])).argument("<name>", "Agent directory under agents/").argument("<prompt>", "Task to send as the user message").description("Run agents/<name>/instructions.md locally with Claude Agent SDK and native Claude authentication; no platform server or ctx login required").action(async (_target, _operation, name, prompt) => {
+program.command("agent").addArgument(new Argument("<target>", "Run from the checkout root").choices(["local"])).addArgument(new Argument("<operation>").choices(["run"])).argument("<name>", "Agent directory under agents/").argument("<prompt>", "Task to send as the user message").description("Run agents/<name>/instructions.md locally with Claude Agent SDK and native Claude authentication; Vite startup also requires ctx login when the app declares connections").action(async (_target, _operation, name, prompt) => {
 	const input = object({
 		name: string().min(1),
 		prompt: string().min(1)
@@ -4352,7 +4352,7 @@ program.command("agent").addArgument(new Argument("<target>", "Run from the app
 	});
 	console.log(await runLocalAgent(input.name, input.prompt));
 });
-const secrets = program.command("secrets").description("Save or drop Owner-owned shared secrets through the authenticated platform").option("--org <org_slug>", "Use this organization's Owner; defaults to the signed-in user").hook("preAction", requireLogin);
+const secrets = program.command("secrets").description("Save or drop Owner-owned shared secrets through the authenticated platform").option("--org <slug>", "Use this organization's Owner; defaults to the signed-in user").hook("preAction", requireLogin);
 secrets.command("set").argument("<name>", "Secret name: uppercase letters, digits, and underscores; cannot start with a digit").description("Save a secret with a masked password prompt; returns only Owner and name").option("--stdin", "Read the exact UTF-8 value from stdin instead of prompting; preserves whitespace and newlines").action(async (name, _options, command) => {
 	await setSecret(secretNameSchema.parse(name), secretOptionsSchema.parse(command.optsWithGlobals()));
 });