@tonbo/cli 0.0.3 → 0.0.5

package/README.md

@@ -7,25 +7,32 @@ npm install --global @tonbo/cli
 tonbo --version
 ```
 
-The V1 CLI deploys a PI-based Agent directly from a local directory without requiring Git or Tonbo calls in the Agent source. Add one JSON declaration at the directory root:
-
-```json
-{
-  "version": 1,
-  "execution": {
-    "mode": "managed",
-    "runtime": "pi"
-  },
-  "inference": {
-    "model": "claude-sonnet-4-5"
-  },
-  "session_capture": {
-    "adapter": "pi-jsonl-v3"
-  }
-}
+The V1 CLI deploys a PI-based Agent directly from a local directory without requiring Git or Tonbo calls in the Agent source. Initialize the current directory interactively:
+
+```console
+tonbo init
+? Inference model [claude-sonnet-4-5]:
+Created .tonbo.
+Next: tonbo project create <slug>
+```
+
+The generated `.tonbo` is TOML:
+
+```toml
+version = 1
+
+[execution]
+mode = "managed"
+runtime = "pi"
+
+[inference]
+model = "claude-sonnet-4-5"
+
+[session_capture]
+adapter = "pi-jsonl-v3"
 ```
 
-Then authenticate, bind the directory and deploy its current contents:
+For automation, use `tonbo init --model <model>`; an existing declaration requires interactive confirmation or `--force`. Then authenticate, bind the directory and deploy its current contents:
 
 ```console
 tonbo login

package/dist/src/app.js

@@ -2,10 +2,12 @@ import { Command } from "commander";
 import { readFileSync } from "node:fs";
 import { TonboApi } from "./api.js";
 import { AuthClient } from "./auth.js";
-import { deployCommand, runCommand, loginCommand, projectCreateCommand, projectUseCommand, sshCommand, sshKeyAddCommand, sshKeyRemoveCommand, secretListCommand, secretRemoveCommand, secretSetCommand, } from "./commands.js";
+import { deployCommand, initCommand, runCommand, loginCommand, projectCreateCommand, projectUseCommand, sshCommand, sshKeyAddCommand, sshKeyRemoveCommand, secretListCommand, secretRemoveCommand, secretSetCommand, } from "./commands.js";
 import { FileConfigStore } from "./config.js";
 import { FileCredentialStore } from "./credentials.js";
+import { DECLARATION_FILENAME } from "./declaration.js";
 import { silentProgress, TerminalProgress } from "./progress.js";
+import { terminalPrompt } from "./prompt.js";
 import { readDefaultSshPublicKeys } from "./ssh-key.js";
 const packageVersion = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
 export function createDependencies(json = false) {
@@ -17,6 +19,7 @@ export function createDependencies(json = false) {
         config: new FileConfigStore(),
         cwd: () => process.cwd(),
         defaultSshPublicKeys: readDefaultSshPublicKeys,
+        interactive: () => !json && process.stdin.isTTY === true && process.stderr.isTTY === true,
         output: (value) => {
             if (json)
                 console.log(JSON.stringify(value));
@@ -24,6 +27,7 @@ export function createDependencies(json = false) {
                 console.log(value.message ?? value);
         },
         progress: json ? silentProgress : new TerminalProgress(process.stderr),
+        prompt: terminalPrompt,
         secretValue: async (name, fromEnvironment) => {
             const environmentName = fromEnvironment ?? name;
             const value = process.env[environmentName];
@@ -39,6 +43,12 @@ export function createProgram(dependencies = createDependencies) {
         .description("Deploy a persistent Project Agent to Tonbo.")
         .version(packageVersion.version)
         .option("--json", "print machine-readable JSON");
+    program
+        .command("init")
+        .description("interactively create a Tonbo Agent declaration in this directory")
+        .option("--model <model>", "inference model")
+        .option("--force", `replace an existing ${DECLARATION_FILENAME}`)
+        .action(async (options) => initCommand(dependencies(program.opts().json), options));
     program
         .command("login")
         .description("sign in through the browser and store the session in the user config")

package/dist/src/commands.d.ts

@@ -10,8 +10,10 @@ export interface CommandDependencies {
     config: ConfigStore;
     cwd: () => string;
     defaultSshPublicKeys: typeof readDefaultSshPublicKeys;
+    interactive: () => boolean;
     output: (value: unknown) => void;
     progress: ProgressReporter;
+    prompt: (question: string) => Promise<string>;
     executable?: () => string;
     secretValue: (name: string, fromEnvironment?: string) => Promise<string>;
 }
@@ -20,6 +22,10 @@ export declare function resolveProject(deps: CommandDependencies, selector?: str
     project: ProjectSummary;
 }>;
 export declare function selectProject(projects: ProjectSummary[], selector: string): ProjectSummary;
+export declare function initCommand(deps: CommandDependencies, options: {
+    force?: boolean;
+    model?: string;
+}): Promise<void>;
 export declare function loginCommand(deps: CommandDependencies): Promise<void>;
 export declare function sshKeyAddCommand(deps: CommandDependencies, path: string): Promise<void>;
 export declare function sshKeyRemoveCommand(deps: CommandDependencies, fingerprint: string): Promise<void>;

package/dist/src/commands.js

@@ -1,4 +1,5 @@
-import { buildRevision, loadDeclaration } from "./declaration.js";
+import path from "node:path";
+import { buildRevision, createDeclaration, declarationExists, DECLARATION_FILENAME, DEFAULT_INFERENCE_MODEL, loadDeclaration, saveDeclaration, } from "./declaration.js";
 import { buildSourceBundle, findDeclarationRoot } from "./source.js";
 import { readSshPublicKey } from "./ssh-key.js";
 import { launchProjectSsh } from "./ssh.js";
@@ -36,6 +37,35 @@ export function selectProject(projects, selector) {
         throw new Error(`Project ${selector} is not active.`);
     return matches[0];
 }
+export async function initCommand(deps, options) {
+    const root = deps.cwd();
+    const exists = await declarationExists(root);
+    let overwrite = options.force === true;
+    if (exists && !overwrite) {
+        if (!deps.interactive())
+            throw new Error(`${DECLARATION_FILENAME} already exists. Pass --force to replace it.`);
+        const answer = (await deps.prompt(`Replace existing ${DECLARATION_FILENAME}? [y/N] `))
+            .trim()
+            .toLowerCase();
+        if (answer !== "y" && answer !== "yes") {
+            deps.output({ message: `Kept existing ${DECLARATION_FILENAME}.` });
+            return;
+        }
+        overwrite = true;
+    }
+    let model = options.model?.trim();
+    if (!model && deps.interactive()) {
+        model = (await deps.prompt(`Inference model [${DEFAULT_INFERENCE_MODEL}]: `)).trim();
+    }
+    model ||= DEFAULT_INFERENCE_MODEL;
+    const declaration = createDeclaration(model);
+    await saveDeclaration(root, declaration, overwrite);
+    deps.output({
+        message: `${exists ? "Updated" : "Created"} ${DECLARATION_FILENAME}.\nNext: tonbo project create <slug>`,
+        declaration,
+        path: path.join(root, DECLARATION_FILENAME),
+    });
+}
 export async function loginCommand(deps) {
     try {
         const tokens = await deps.auth.login((event) => reportLoginProgress(deps.progress, event));

package/dist/src/contracts.js

@@ -13,7 +13,7 @@ function validationMessage(label, errors) {
 export function parseDeclaration(value) {
     const candidate = structuredClone(value);
     if (!validateDeclaration(candidate)) {
-        throw new Error(validationMessage(".tonbo", validateDeclaration.errors));
+        throw new Error(validationMessage(".tonbo TOML", validateDeclaration.errors));
     }
     return candidate;
 }

package/dist/src/declaration.d.ts

@@ -1,4 +1,10 @@
 import { parseDeclaration } from "./contracts.js";
-import type { ManagedRevisionSpec, SourceBundle } from "./types.js";
-export declare function loadDeclaration(declarationRoot: string): Promise<import("./types.js").TonboDeclaration>;
+import type { ManagedRevisionSpec, SourceBundle, TonboDeclaration } from "./types.js";
+export declare const DECLARATION_FILENAME = ".tonbo";
+export declare const DEFAULT_INFERENCE_MODEL = "claude-sonnet-4-5";
+export declare function createDeclaration(model?: string): TonboDeclaration;
+export declare function renderDeclaration(declaration: TonboDeclaration): string;
+export declare function declarationExists(root: string): Promise<boolean>;
+export declare function saveDeclaration(root: string, declaration: TonboDeclaration, overwrite: boolean): Promise<void>;
+export declare function loadDeclaration(declarationRoot: string): Promise<TonboDeclaration>;
 export declare function buildRevision(declaration: ReturnType<typeof parseDeclaration>, source: SourceBundle): ManagedRevisionSpec;

package/dist/src/declaration.js

@@ -1,16 +1,82 @@
-import { readFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { lstat, open, readFile, rename, rm } from "node:fs/promises";
 import path from "node:path";
+import { parse, stringify } from "smol-toml";
 import { assertManagedRevision, parseDeclaration } from "./contracts.js";
+export const DECLARATION_FILENAME = ".tonbo";
+export const DEFAULT_INFERENCE_MODEL = "claude-sonnet-4-5";
+export function createDeclaration(model = DEFAULT_INFERENCE_MODEL) {
+    return parseDeclaration({
+        version: 1,
+        execution: { mode: "managed", runtime: "pi" },
+        inference: { model: model.trim() },
+        session_capture: { adapter: "pi-jsonl-v3" },
+    });
+}
+export function renderDeclaration(declaration) {
+    return `# Tonbo Project Agent configuration.\n${stringify(declaration)}`;
+}
+export async function declarationExists(root) {
+    const filename = path.join(root, DECLARATION_FILENAME);
+    try {
+        const metadata = await lstat(filename);
+        if (metadata.isSymbolicLink() || !metadata.isFile())
+            throw new Error(`${filename} must be a regular file.`);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export async function saveDeclaration(root, declaration, overwrite) {
+    const filename = path.join(root, DECLARATION_FILENAME);
+    const exists = await declarationExists(root);
+    if (exists && !overwrite)
+        throw new Error(`${DECLARATION_FILENAME} already exists. Pass --force to replace it.`);
+    const contents = renderDeclaration(declaration);
+    if (!overwrite) {
+        const handle = await open(filename, "wx", 0o644).catch((error) => {
+            if (error.code === "EEXIST")
+                throw new Error(`${DECLARATION_FILENAME} already exists. Pass --force to replace it.`);
+            throw error;
+        });
+        try {
+            await handle.writeFile(contents, "utf8");
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        return;
+    }
+    const temporary = path.join(root, `.${DECLARATION_FILENAME}.${process.pid}.${randomUUID()}.tmp`);
+    let handle;
+    try {
+        handle = await open(temporary, "wx", 0o644);
+        await handle.writeFile(contents, "utf8");
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await rename(temporary, filename);
+    }
+    catch (error) {
+        await handle?.close().catch(() => undefined);
+        await rm(temporary, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
 export async function loadDeclaration(declarationRoot) {
-    const filename = path.join(declarationRoot, ".tonbo");
+    const filename = path.join(declarationRoot, DECLARATION_FILENAME);
     let parsed;
     try {
-        parsed = JSON.parse(await readFile(filename, "utf8"));
+        parsed = parse(await readFile(filename, "utf8"));
     }
     catch (error) {
         if (error.code === "ENOENT")
-            throw new Error(`No .tonbo declaration found at ${filename}.`);
-        throw new Error(`Could not read ${filename} as JSON.`, { cause: error });
+            throw new Error(`No ${DECLARATION_FILENAME} declaration found at ${filename}.`);
+        throw new Error(`Could not read ${filename} as TOML.`, { cause: error });
     }
     return parseDeclaration(parsed);
 }

package/dist/src/generated/contracts.d.ts

@@ -184,4 +184,5 @@ export declare const piSessionContract: {
     readonly durable_completion_timeout_seconds: 30;
     readonly session_directory: "/sessions";
     readonly path_template: "/sessions/{session_id}.jsonl";
+    readonly preflight_command: readonly ["/usr/local/bin/artifacts", "runtime", "session-preflight"];
 };

package/dist/src/generated/contracts.js

@@ -217,5 +217,10 @@ export const piSessionContract = {
     "format_version": 3,
     "durable_completion_timeout_seconds": 30,
     "session_directory": "/sessions",
-    "path_template": "/sessions/{session_id}.jsonl"
+    "path_template": "/sessions/{session_id}.jsonl",
+    "preflight_command": [
+        "/usr/local/bin/artifacts",
+        "runtime",
+        "session-preflight"
+    ]
 };

package/dist/src/prompt.d.ts

@@ -0,0 +1 @@
+export declare function terminalPrompt(question: string): Promise<string>;

package/dist/src/prompt.js

@@ -0,0 +1,10 @@
+import { createInterface } from "node:readline/promises";
+export async function terminalPrompt(question) {
+    const prompt = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await prompt.question(`? ${question}`);
+    }
+    finally {
+        prompt.close();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonbo/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Deploy one persistent Agent per Project from the command line.",
   "homepage": "https://tonbo.dev",
   "bugs": {
@@ -33,6 +33,7 @@
     "ajv": "8.20.0",
     "commander": "^14.0.3",
     "ignore": "^7.0.5",
+    "smol-toml": "1.6.1",
     "tar-stream": "^3.1.7"
   },
   "devDependencies": {