create-cf-open-agents-api 0.2.0

package/dist/exec.d.ts

@@ -0,0 +1,16 @@
+export interface RunOptions {
+    cwd?: string;
+    input?: string;
+}
+export interface RunResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+/** Runs a command to completion; a failure is a result, not an exception. */
+export type Runner = (command: string, args: readonly string[], options?: RunOptions) => RunResult;
+export declare const run: Runner;
+export type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+/** The `<pm> exec`-style prefix that runs a project-local binary such as wrangler. */
+export declare function packageManagerExec(manager: PackageManager): readonly string[];
+export declare function installCommand(manager: PackageManager): string;

package/dist/exec.js

@@ -0,0 +1,33 @@
+import { execFileSync } from "node:child_process";
+export const run = (command, args, options = {}) => {
+    try {
+        const stdout = execFileSync(command, [...args], {
+            cwd: options.cwd,
+            input: options.input,
+            encoding: "utf8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return { ok: true, stdout, stderr: "" };
+    }
+    catch (error) {
+        const failure = error;
+        return { ok: false, stdout: failure.stdout ?? "", stderr: failure.stderr ?? String(error) };
+    }
+};
+/** The `<pm> exec`-style prefix that runs a project-local binary such as wrangler. */
+export function packageManagerExec(manager) {
+    switch (manager) {
+        case "pnpm":
+            return ["pnpm", "exec"];
+        case "yarn":
+            return ["yarn"];
+        case "bun":
+            return ["bunx"];
+        default:
+            return ["npx"];
+    }
+}
+export function installCommand(manager) {
+    return `${manager} install`;
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAclD,MAAM,CAAC,MAAM,GAAG,GAAW,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;YAC9C,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAA6C,CAAC;QAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9F,CAAC;AACH,CAAC,CAAC;AAIF,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACxD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB;YACE,OAAO,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,GAAG,OAAO,UAAU,CAAC;AAC9B,CAAC"}

package/dist/fs.d.ts

@@ -0,0 +1,24 @@
+import type { StepResult } from "./plan.js";
+export declare function readIfExists(path: string): string | undefined;
+/** Forward-slash path relative to the project, for the report. */
+export declare function display(root: string, path: string): string;
+/**
+ * The project's files. Writes happen only when content differs; a dry run keeps them in
+ * an overlay so later steps see what earlier steps would have written.
+ */
+export declare class Files {
+    readonly root: string;
+    readonly dryRun: boolean;
+    private readonly overlay;
+    constructor(root: string, dryRun: boolean);
+    read(path: string): string | undefined;
+    exists(path: string): boolean;
+    write(path: string, content: string, note?: string): StepResult;
+}
+export interface Formatting {
+    insertSpaces: boolean;
+    tabSize: number;
+    eol: "\n" | "\r\n";
+}
+/** Indentation and line endings of an existing file, so edits match it. */
+export declare function detectFormatting(text: string): Formatting;

package/dist/fs.js

@@ -0,0 +1,54 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, relative } from "node:path";
+export function readIfExists(path) {
+    return existsSync(path) ? readFileSync(path, "utf8") : undefined;
+}
+/** Forward-slash path relative to the project, for the report. */
+export function display(root, path) {
+    return relative(root, path).split("\\").join("/") || ".";
+}
+/**
+ * The project's files. Writes happen only when content differs; a dry run keeps them in
+ * an overlay so later steps see what earlier steps would have written.
+ */
+export class Files {
+    root;
+    dryRun;
+    overlay = new Map();
+    constructor(root, dryRun) {
+        this.root = root;
+        this.dryRun = dryRun;
+    }
+    read(path) {
+        return this.overlay.get(path) ?? readIfExists(path);
+    }
+    exists(path) {
+        return this.overlay.has(path) || existsSync(path);
+    }
+    write(path, content, note) {
+        const file = display(this.root, path);
+        const current = this.read(path);
+        if (current === content)
+            return { status: "skipped", file };
+        if (this.dryRun)
+            this.overlay.set(path, content);
+        else {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, content);
+        }
+        return {
+            status: current === undefined ? "created" : "updated",
+            file,
+            ...(note ? { note } : {}),
+        };
+    }
+}
+/** Indentation and line endings of an existing file, so edits match it. */
+export function detectFormatting(text) {
+    const eol = text.includes("\r\n") ? "\r\n" : "\n";
+    const indent = /^(?:\r?\n)*[^\n]*\r?\n( +|\t)\S/.exec(text)?.[1];
+    if (indent === "\t")
+        return { insertSpaces: false, tabSize: 2, eol };
+    return { insertSpaces: true, tabSize: indent ? indent.length : 2, eol };
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAI9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,KAAK;IAIL,IAAI;IACJ,MAAM;IAJA,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,YACW,IAAY,EACZ,MAAe;oBADf,IAAI;sBACJ,MAAM;IACd,CAAC;IAEJ,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aAC5C,CAAC;YACJ,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACrD,IAAI;YACJ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;CACF;AAOD,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACrE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/** Programmatic surface: what the commands call and what the tests drive. */
+export { collectAnswers, type InitAnswers, type InitPreferences } from "./answers.js";
+export { configChecks, devVarsCheck, renderReport, runDoctor, snapshotCheck } from "./doctor.js";
+export { Files } from "./fs.js";
+export { type InitOptions, type InitResult, runInit } from "./init.js";
+export { CliError, Plan, type StepResult } from "./plan.js";
+export { detectPackageManager, locateProject, workerNameFrom } from "./project.js";
+export { accountIds, runSetup, type SetupOptions } from "./setup.js";
+export { ensureDevVars, ensureDevVarsExample, parseDevVars } from "./steps/dev-vars.js";
+export { agentsSpecifier } from "./steps/entry.js";
+export { ensureVendor, readVendorManifest, type VendorManifest } from "./steps/vendor.js";
+export { upsertWranglerConfig, type WranglerInput } from "./steps/wrangler.js";
+export { type CompositionInput, describeSecret, type Harness, HARNESSES, type Provider, PROVIDERS, providerPackages, renderComposition, } from "./templates/agents.js";
+export { defaultPrompter, plainReporter, type Prompter, type Reporter } from "./ui.js";
+export { runVendor } from "./vendor.js";
+export * as versions from "./versions.js";

package/dist/index.js

@@ -0,0 +1,17 @@
+/** Programmatic surface: what the commands call and what the tests drive. */
+export { collectAnswers } from "./answers.js";
+export { configChecks, devVarsCheck, renderReport, runDoctor, snapshotCheck } from "./doctor.js";
+export { Files } from "./fs.js";
+export { runInit } from "./init.js";
+export { CliError, Plan } from "./plan.js";
+export { detectPackageManager, locateProject, workerNameFrom } from "./project.js";
+export { accountIds, runSetup } from "./setup.js";
+export { ensureDevVars, ensureDevVarsExample, parseDevVars } from "./steps/dev-vars.js";
+export { agentsSpecifier } from "./steps/entry.js";
+export { ensureVendor, readVendorManifest } from "./steps/vendor.js";
+export { upsertWranglerConfig } from "./steps/wrangler.js";
+export { describeSecret, HARNESSES, PROVIDERS, providerPackages, renderComposition, } from "./templates/agents.js";
+export { defaultPrompter, plainReporter } from "./ui.js";
+export { runVendor } from "./vendor.js";
+export * as versions from "./versions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAE,cAAc,EAA0C,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAqC,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAmB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAqB,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAsB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAEL,cAAc,EAEd,SAAS,EAET,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAgC,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,37 @@
+import { type InitAnswers, type InitPreferences } from "./answers.js";
+import { type Runner } from "./exec.js";
+import { Files } from "./fs.js";
+import { Plan } from "./plan.js";
+import { type Project, type WranglerConfig } from "./project.js";
+import { type Prompter, type Reporter } from "./ui.js";
+export interface InitOptions extends InitPreferences {
+    dir: string;
+    yes: boolean;
+    force: boolean;
+    dryRun: boolean;
+    /** Path of the composition module; the default sits next to the Wrangler entry. */
+    agentsFile?: string;
+    /** Pre-publication: a packed library tarball or package directory for a `file:` dependency. */
+    library?: string;
+    cliPackage?: string;
+    ref?: string;
+    source?: string;
+    prompter?: Prompter;
+    reporter?: Reporter;
+    runner?: Runner;
+    fetch?: typeof globalThis.fetch;
+    env?: NodeJS.ProcessEnv;
+    today?: string;
+    token?: () => string;
+}
+export interface InitResult {
+    project: Project;
+    answers: InitAnswers;
+    plan: Plan;
+    agentsPath: string;
+}
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+export declare function readConfig(files: Files, project: Project): {
+    text: string;
+    config: WranglerConfig;
+};

package/dist/init.js

@@ -0,0 +1,179 @@
+import { dirname, join, resolve } from "node:path";
+import { collectAnswers } from "./answers.js";
+import { installCommand, packageManagerExec, run } from "./exec.js";
+import { Files } from "./fs.js";
+import { parseJsonc } from "./jsonc.js";
+import { CliError, Plan } from "./plan.js";
+import { locateProject } from "./project.js";
+import { ensureAgentsFile } from "./steps/agents-file.js";
+import { ensureDevVars, ensureDevVarsExample } from "./steps/dev-vars.js";
+import { ensureEntryExports } from "./steps/entry.js";
+import { ensureGitignore } from "./steps/gitignore.js";
+import { ensurePackageJson, vendorScript } from "./steps/package-json.js";
+import { ensureStandaloneSkeleton } from "./steps/standalone.js";
+import { ensureTsconfigExclude } from "./steps/tsconfig.js";
+import { ensureVendor } from "./steps/vendor.js";
+import { upsertWranglerConfig } from "./steps/wrangler.js";
+import { describeSecret, PRESET_NAMES, providerPackages, } from "./templates/agents.js";
+import { clackPrompter, clackReporter, defaultPrompter, interactive, plainReporter, } from "./ui.js";
+import { CLI_NAME, CLI_VERSION, LIBRARY_NAME, PEER_VERSIONS, TOOLCHAIN_VERSIONS, } from "./versions.js";
+const today = () => new Date().toISOString().slice(0, 10);
+const fileDependency = (path, fallback) => path ? `file:${resolve(path)}` : fallback;
+function choosePrompter(options) {
+    if (options.prompter)
+        return options.prompter;
+    if (options.yes)
+        return defaultPrompter();
+    if (!interactive())
+        throw new CliError("Not a terminal; pass --yes to accept the defaults.");
+    return clackPrompter();
+}
+const chooseReporter = (options) => options.reporter ?? (interactive() && !options.yes ? clackReporter() : plainReporter());
+export async function runInit(options) {
+    const root = resolve(options.dir);
+    const project = locateProject(root);
+    const prompter = choosePrompter(options);
+    const reporter = chooseReporter(options);
+    const files = new Files(root, options.dryRun);
+    reporter.intro(`${CLI_NAME} ${CLI_VERSION}${options.dryRun ? " (dry run)" : ""}`);
+    await confirmNewProject(project, prompter);
+    const configName = project.mode === "retrofit" ? readConfig(files, project).config.name : undefined;
+    const answers = await collectAnswers(project, configName, options, prompter);
+    const plan = new Plan();
+    if (project.mode === "standalone")
+        for (const result of ensureStandaloneSkeleton({
+            files,
+            name: answers.name,
+            publicRoute: answers.publicRoute,
+            today: options.today ?? today(),
+        }))
+            plan.add(result);
+    plan.add(await vendor(options, root, reporter));
+    const config = readConfig(files, project).config;
+    const entryPath = resolve(root, config.main ?? "src/index.ts");
+    const inEntry = compositionInEntry(files, project, entryPath);
+    configureWrangler(files, project, answers, options, plan, !inEntry);
+    const { agentsPath, composition } = compose(files, entryPath, inEntry, answers, options, plan);
+    const secret = describeSecret(composition);
+    plan.add(ensureDevVars({ files, secret, token: options.token }));
+    plan.add(ensureDevVarsExample({ files, secret }));
+    plan.add(ensureGitignore(files));
+    plan.add(ensurePackageJson(manifestChanges(files, project, composition, options)));
+    if (project.mode === "retrofit")
+        plan.add(ensureTsconfigExclude(files));
+    if (!options.library)
+        plan.note(`${LIBRARY_NAME}@${CLI_VERSION} must be on npm for install to succeed; before that, pass --library <tarball>.`);
+    if (answers.install && !options.dryRun)
+        await install(project, reporter, options.runner ?? run);
+    reporter.note(nextSteps(project, answers, agentsPath), "Next steps");
+    reporter.plan(plan, options.dryRun ? "Dry run: nothing was written" : "Done");
+    return { project, answers, plan, agentsPath };
+}
+async function confirmNewProject(project, prompter) {
+    if (project.mode === "retrofit")
+        return;
+    const create = await prompter.confirm(`No Wrangler configuration in ${project.root}. Create a new Workers project here?`, true);
+    if (!create)
+        throw new CliError("Nothing to do: run inside a Workers project or let the CLI create one.");
+}
+/** A new project composes in its entry; so does a project this CLI created earlier. */
+function compositionInEntry(files, project, entryPath) {
+    if (project.mode === "standalone")
+        return true;
+    return /defineAgentWorker[<(]/.test(files.read(entryPath) ?? "");
+}
+function configureWrangler(files, project, answers, options, plan, agentsBinding) {
+    const { text } = readConfig(files, project);
+    const outcome = upsertWranglerConfig(text, {
+        name: answers.name,
+        agentsBinding,
+        workersAi: answers.workersAi || answers.provider === "workers-ai",
+        codeLoader: answers.codeLoader,
+        force: options.force,
+    }, project.configPath.slice(project.root.length + 1));
+    plan.add(files.write(project.configPath, outcome.text));
+    for (const note of outcome.notes)
+        plan.note(note);
+}
+function compose(files, entryPath, inEntry, answers, options, plan) {
+    const agentsPath = inEntry
+        ? entryPath
+        : resolve(files.root, options.agentsFile ?? join(dirname(entryPath), "agents.ts"));
+    const composition = {
+        provider: answers.provider,
+        harnesses: answers.harnesses,
+        workersAi: answers.workersAi,
+        baseURL: answers.baseURL,
+        model: answers.model,
+        standalone: inEntry,
+    };
+    plan.add(ensureAgentsFile(files, agentsPath, composition, options.force));
+    if (!inEntry)
+        plan.add(ensureEntryExports(files, entryPath, agentsPath));
+    return { agentsPath, composition };
+}
+function manifestChanges(files, project, composition, options) {
+    return {
+        files,
+        force: options.force,
+        dependencies: {
+            [LIBRARY_NAME]: fileDependency(options.library, CLI_VERSION),
+            ...PEER_VERSIONS,
+            ...providerPackages(composition),
+        },
+        devDependencies: {
+            [CLI_NAME]: fileDependency(options.cliPackage, CLI_VERSION),
+            ...(project.mode === "standalone" ? TOOLCHAIN_VERSIONS : {}),
+        },
+        scripts: { postinstall: vendorScript },
+    };
+}
+function vendor(options, root, reporter) {
+    return reporter.spin("Fetching the Docker image snapshot", () => ensureVendor({
+        root,
+        version: CLI_VERSION,
+        ref: options.ref,
+        source: options.source,
+        force: options.force,
+        dryRun: options.dryRun,
+        fetch: options.fetch,
+        runner: options.runner,
+        env: options.env,
+    }), (result) => `Image snapshot ${result.status}`);
+}
+export function readConfig(files, project) {
+    const text = files.read(project.configPath);
+    if (text === undefined)
+        throw new CliError(`${project.configPath} is missing`);
+    return { text, config: parseJsonc(text, project.configPath) };
+}
+async function install(project, reporter, runner) {
+    const [command = "npm", ...args] = installCommand(project.packageManager).split(" ");
+    const result = await reporter.spin(`Running ${installCommand(project.packageManager)}`, () => Promise.resolve(runner(command, args, { cwd: project.root })), (outcome) => (outcome.ok ? "Dependencies installed" : "Install failed"));
+    if (!result.ok)
+        throw new CliError(`${installCommand(project.packageManager)} failed:\n${result.stderr.trim()}`);
+}
+function firstPreset(answers) {
+    if (answers.workersAi)
+        return "workers";
+    return PRESET_NAMES[answers.harnesses[0] ?? "codex"];
+}
+function nextSteps(project, answers, agentsPath) {
+    const exec = packageManagerExec(project.packageManager).join(" ");
+    const composition = agentsPath.slice(project.root.length + 1);
+    const dev = project.mode === "standalone"
+        ? `${exec} wrangler dev`
+        : "your dev server (vite dev or wrangler dev)";
+    const use = project.mode === "retrofit"
+        ? `Forward the API from your Worker: app.all("/v1/*", (c) => c.env.AGENTS.fetch(c.req.raw)) with AGENTS: Fetcher & AgentRPC.`
+        : `curl -X POST http://localhost:8787/v1/agents/sessions -H "Authorization: Bearer <API_TOKEN from .dev.vars>" -H "Content-Type: application/json" -H "Idempotency-Key: first" -d '{"agent":{"model":"${firstPreset(answers)}"},"environment":{"type":"openai_hosted"},"input":"Write /workspace/outputs/hello.txt"}'`;
+    return [
+        `1. ${installCommand(project.packageManager)}  (postinstall keeps the image snapshot current)`,
+        `2. ${exec} wrangler login  (the AI binding and deployments need your account)`,
+        `3. Start Docker, then ${dev}; the first image build takes several minutes.`,
+        `4. ${use}`,
+        `5. Presets and models live in ${composition}; the API token and provider key in .dev.vars.`,
+        `6. Production: ${CLI_NAME} setup (R2 buckets and secrets), then ${exec} wrangler deploy.`,
+    ].join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/jsonc.d.ts

@@ -0,0 +1,17 @@
+import { type JSONPath } from "jsonc-parser";
+import { type Formatting } from "./fs.js";
+/** A JSONC file kept as text so comments and formatting survive every edit. */
+export interface JsoncDocument {
+    text: string;
+    formatting: Formatting;
+}
+export declare function openJsonc(text: string): JsoncDocument;
+export declare function parseJsonc<T>(text: string, file: string): T;
+/** Sets a value at a path, creating missing objects; `-1` on an array appends. */
+export declare function setValue(document: JsoncDocument, path: JSONPath, value: unknown, insert?: boolean): JsoncDocument;
+export declare function appendItem(document: JsoncDocument, path: JSONPath, value: unknown): JsoncDocument;
+/**
+ * `modify` expands every array in the range it reformats, including neighbours it did
+ * not change. Formatters put a short array of scalars on one line, so put those back.
+ */
+export declare function collapsePrimitiveArrays(document: JsoncDocument, width?: number): JsoncDocument;

package/dist/jsonc.js

@@ -0,0 +1,55 @@
+import { applyEdits, modify, parse, parseTree, printParseErrorCode, } from "jsonc-parser";
+import { detectFormatting } from "./fs.js";
+import { CliError } from "./plan.js";
+export function openJsonc(text) {
+    return { text, formatting: detectFormatting(text) };
+}
+export function parseJsonc(text, file) {
+    const errors = [];
+    const value = parse(text, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        const first = errors[0];
+        const reason = first ? printParseErrorCode(first.error) : "unknown";
+        throw new CliError(`${file} is not valid JSONC (${reason} at offset ${first?.offset ?? 0})`);
+    }
+    return value;
+}
+/** Sets a value at a path, creating missing objects; `-1` on an array appends. */
+export function setValue(document, path, value, insert = false) {
+    const edits = modify(document.text, path, value, {
+        isArrayInsertion: insert,
+        formattingOptions: {
+            insertSpaces: document.formatting.insertSpaces,
+            tabSize: document.formatting.tabSize,
+            eol: document.formatting.eol,
+        },
+    });
+    return { ...document, text: applyEdits(document.text, edits) };
+}
+export function appendItem(document, path, value) {
+    return setValue(document, [...path, -1], value, true);
+}
+const isPrimitiveArray = (node) => node.type === "array" &&
+    (node.children ?? []).every((child) => ["string", "number", "boolean", "null"].includes(child.type));
+const arrays = (node) => isPrimitiveArray(node) ? [node] : (node.children ?? []).flatMap(arrays);
+/**
+ * `modify` expands every array in the range it reformats, including neighbours it did
+ * not change. Formatters put a short array of scalars on one line, so put those back.
+ */
+export function collapsePrimitiveArrays(document, width = 100) {
+    const root = parseTree(document.text);
+    if (!root)
+        return document;
+    let text = document.text;
+    // Edit from the end so earlier offsets stay valid.
+    for (const node of arrays(root).sort((a, b) => b.offset - a.offset)) {
+        const items = (node.children ?? []).map((child) => text.slice(child.offset, child.offset + child.length));
+        const inline = `[${items.join(", ")}]`;
+        const lineStart = text.lastIndexOf("\n", node.offset) + 1;
+        if (node.offset - lineStart + inline.length > width)
+            continue;
+        text = text.slice(0, node.offset) + inline + text.slice(node.offset + node.length);
+    }
+    return { ...document, text };
+}
+//# sourceMappingURL=jsonc.js.map

package/dist/jsonc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.js","sourceRoot":"","sources":["../src/jsonc.ts"],"names":[],"mappings":"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"}

package/dist/plan.d.ts

@@ -0,0 +1,23 @@
+export type StepStatus = "created" | "updated" | "skipped";
+/** One idempotent change; `note` explains a skip or a decision the user should know about. */
+export interface StepResult {
+    status: StepStatus;
+    file: string;
+    note?: string;
+}
+/** An expected failure: printed as one line, exit code 1, no stack trace. */
+export declare class CliError extends Error {
+    readonly name = "CliError";
+}
+export declare class Plan {
+    readonly created: string[];
+    readonly updated: string[];
+    readonly skipped: string[];
+    readonly notes: string[];
+    /** A file touched twice is listed once, under its first status. */
+    add(result: StepResult): StepResult;
+    note(text: string): void;
+    /** The Created/Updated/Skipped/Notes report, one bullet per file. */
+    render(title: string): string;
+    body(): string;
+}

package/dist/plan.js

@@ -0,0 +1,36 @@
+/** An expected failure: printed as one line, exit code 1, no stack trace. */
+export class CliError extends Error {
+    name = "CliError";
+}
+export class Plan {
+    created = [];
+    updated = [];
+    skipped = [];
+    notes = [];
+    /** A file touched twice is listed once, under its first status. */
+    add(result) {
+        const listed = [...this.created, ...this.updated, ...this.skipped].includes(result.file);
+        if (!listed)
+            this[result.status].push(result.file);
+        if (result.note)
+            this.notes.push(result.note);
+        return result;
+    }
+    note(text) {
+        this.notes.push(text);
+    }
+    /** The Created/Updated/Skipped/Notes report, one bullet per file. */
+    render(title) {
+        return `${title}\n${this.body()}`;
+    }
+    body() {
+        const block = (heading, items) => items.length === 0 ? [] : [heading, ...items.map((item) => `  - ${item}`)];
+        return [
+            ...block("Created", this.created),
+            ...block("Updated", this.updated),
+            ...block("Skipped", this.skipped),
+            ...block("Notes", this.notes),
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AASA,6EAA6E;AAC7E,MAAM,OAAO,QAAS,SAAQ,KAAK;IACf,IAAI,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,OAAO,IAAI;IACN,OAAO,GAAa,EAAE,CAAC;IACvB,OAAO,GAAa,EAAE,CAAC;IACvB,OAAO,GAAa,EAAE,CAAC;IACvB,KAAK,GAAa,EAAE,CAAC;IAE9B,mEAAmE;IACnE,GAAG,CAAC,MAAkB;QACpB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzF,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,KAAa;QAClB,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;IAED,IAAI;QACF,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,KAAwB,EAAE,EAAE,CAC1D,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO;YACL,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;YACjC,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;YACjC,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;YACjC,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;SAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/project.d.ts

@@ -0,0 +1,62 @@
+import type { PackageManager } from "./exec.js";
+export type ProjectMode = "retrofit" | "standalone";
+export interface Project {
+    root: string;
+    mode: ProjectMode;
+    /** `wrangler.jsonc` or `wrangler.json`; the standalone skeleton creates `wrangler.jsonc`. */
+    configPath: string;
+    packageManager: PackageManager;
+}
+export interface WranglerBinding {
+    binding?: string;
+    name?: string;
+    class_name?: string;
+    script_name?: string;
+    bucket_name?: string;
+    service?: string;
+    entrypoint?: string;
+}
+export interface WranglerContainer {
+    class_name?: string;
+    name?: string;
+    image?: string;
+    image_build_context?: string;
+    instance_type?: string;
+    max_instances?: number;
+}
+export interface WranglerMigration {
+    tag?: string;
+    new_classes?: string[];
+    new_sqlite_classes?: string[];
+    renamed_classes?: {
+        from?: string;
+        to?: string;
+    }[];
+}
+/** The parts of a Wrangler configuration the CLI reads; everything else is left alone. */
+export interface WranglerConfig {
+    name?: string;
+    main?: string;
+    compatibility_date?: string;
+    compatibility_flags?: string[];
+    workers_dev?: boolean;
+    durable_objects?: {
+        bindings?: WranglerBinding[];
+    };
+    migrations?: WranglerMigration[];
+    containers?: WranglerContainer[];
+    r2_buckets?: WranglerBinding[];
+    services?: WranglerBinding[];
+    vars?: Record<string, unknown>;
+    ai?: {
+        binding?: string;
+    };
+    worker_loaders?: WranglerBinding[];
+    env?: Record<string, unknown>;
+}
+/** Finds the Wrangler configuration; a directory without one becomes a new project. */
+export declare function locateProject(root: string): Project;
+export declare function detectPackageManager(root: string): PackageManager;
+export declare function readManifest(root: string): Record<string, unknown> | undefined;
+/** A Worker name from a directory name: lowercase, dashes, no leading or trailing dash. */
+export declare function workerNameFrom(root: string): string;