create-cf-open-agents-api 0.2.0

package/dist/project.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { CliError } from "./plan.js";
+const CONFIG_FILES = ["wrangler.jsonc", "wrangler.json"];
+/** Finds the Wrangler configuration; a directory without one becomes a new project. */
+export function locateProject(root) {
+    const configPath = CONFIG_FILES.map((file) => join(root, file)).find((path) => existsSync(path));
+    if (!configPath && existsSync(join(root, "wrangler.toml")))
+        throw new CliError("wrangler.toml is not supported; convert it to wrangler.jsonc first (wrangler types can help).");
+    if (!configPath && existsSync(join(root, "packages", "supervisor", "package.json")))
+        throw new CliError(`${root} looks like the CF-Open-Agents-API repository; run the CLI in your own project (or pass a directory).`);
+    return {
+        root,
+        mode: configPath ? "retrofit" : "standalone",
+        configPath: configPath ?? join(root, "wrangler.jsonc"),
+        packageManager: detectPackageManager(root),
+    };
+}
+export function detectPackageManager(root) {
+    const manifest = readManifest(root);
+    const declared = typeof manifest?.packageManager === "string" ? manifest.packageManager : "";
+    for (const manager of ["pnpm", "yarn", "bun"])
+        if (declared.startsWith(manager))
+            return manager;
+    if (existsSync(join(root, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(root, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(root, "bun.lock")) || existsSync(join(root, "bun.lockb")))
+        return "bun";
+    return "npm";
+}
+export function readManifest(root) {
+    const path = join(root, "package.json");
+    if (!existsSync(path))
+        return;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new CliError("package.json is not valid JSON");
+    }
+}
+/** A Worker name from a directory name: lowercase, dashes, no leading or trailing dash. */
+export function workerNameFrom(root) {
+    const name = basename(root)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return name || "agents";
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,26 @@
+import { type Runner } from "./exec.js";
+import { Plan } from "./plan.js";
+import { type WranglerConfig } from "./project.js";
+import { type Prompter, type Reporter } from "./ui.js";
+export interface SetupOptions {
+    dir: string;
+    dryRun: boolean;
+    /** Read secret values from the environment instead of prompting. */
+    fromEnv: boolean;
+    skipSecrets: boolean;
+    skipBuckets: boolean;
+    prompter?: Prompter;
+    reporter?: Reporter;
+    runner?: Runner;
+    env?: NodeJS.ProcessEnv;
+}
+interface Wrangler {
+    (args: readonly string[], input?: string): ReturnType<Runner>;
+    describe(args: readonly string[]): string;
+}
+/** Creates the R2 buckets the configuration names; an existing bucket is a skip. */
+export declare function ensureBuckets(config: WranglerConfig, wrangler: Wrangler, plan: Plan, dryRun: boolean): void;
+/** The 32-hex account ids `wrangler whoami` prints. */
+export declare function accountIds(output: string): string[];
+export declare function runSetup(options: SetupOptions): Promise<Plan>;
+export {};

package/dist/setup.js

@@ -0,0 +1,139 @@
+import { join, resolve } from "node:path";
+import { packageManagerExec, run } from "./exec.js";
+import { readIfExists } from "./fs.js";
+import { parseJsonc } from "./jsonc.js";
+import { CliError, Plan } from "./plan.js";
+import { locateProject } from "./project.js";
+import { parseDevVars } from "./steps/dev-vars.js";
+import { MINIMUM_TOKEN_LENGTH, randomToken } from "./token.js";
+import { clackPrompter, clackReporter, defaultPrompter, interactive, plainReporter, } from "./ui.js";
+const PROVIDER_SECRETS = ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "MODEL_API_KEY"];
+const R2_SECRETS = ["R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"];
+const ACCOUNT_SECRET = "CLOUDFLARE_R2_ACCOUNT_ID";
+const R2_TOKEN_HELP = "R2 → Manage R2 API Tokens in the Cloudflare dashboard: create a token with Object Read & Write on the workspaces bucket.";
+function wranglerFor(project, runner) {
+    const exec = packageManagerExec(project.packageManager);
+    // wrangler runs with the project as cwd, so the configuration is named relative to it.
+    const configArgs = ["--config", project.configPath.slice(project.root.length + 1)];
+    const call = ((args, input) => runner(exec[0] ?? "npx", [...exec.slice(1), "wrangler", ...args, ...configArgs], {
+        cwd: project.root,
+        input,
+    }));
+    call.describe = (args) => [...exec, "wrangler", ...args, ...configArgs].join(" ");
+    return call;
+}
+/** Creates the R2 buckets the configuration names; an existing bucket is a skip. */
+export function ensureBuckets(config, wrangler, plan, dryRun) {
+    for (const bucket of config.r2_buckets ?? []) {
+        if (!bucket.bucket_name)
+            continue;
+        const args = ["r2", "bucket", "create", bucket.bucket_name];
+        if (dryRun) {
+            plan.add({
+                status: "created",
+                file: `r2 bucket ${bucket.bucket_name}`,
+                note: `Would run ${wrangler.describe(args)}`,
+            });
+            continue;
+        }
+        const result = wrangler(args);
+        const output = result.stdout + result.stderr;
+        if (result.ok)
+            plan.add({ status: "created", file: `r2 bucket ${bucket.bucket_name}` });
+        else if (/already exists/i.test(output))
+            plan.add({ status: "skipped", file: `r2 bucket ${bucket.bucket_name}` });
+        else
+            throw new CliError(`Creating bucket ${bucket.bucket_name} failed:\n${output.trim()}`);
+    }
+}
+/** The 32-hex account ids `wrangler whoami` prints. */
+export function accountIds(output) {
+    return [...new Set(output.match(/\b[0-9a-f]{32}\b/g) ?? [])];
+}
+async function resolveAccountId(wrangler, prompter, env) {
+    const fromEnv = env.CLOUDFLARE_R2_ACCOUNT_ID ?? env.CLOUDFLARE_ACCOUNT_ID;
+    if (fromEnv)
+        return fromEnv;
+    const whoami = wrangler(["whoami"]);
+    const ids = accountIds(whoami.stdout);
+    if (ids.length === 1 && ids[0])
+        return ids[0];
+    if (ids.length > 1)
+        return prompter.select("Cloudflare account", ids.map((id) => ({ value: id, label: id })), ids[0] ?? "");
+    return prompter.text("Cloudflare account id (dashboard → Workers & Pages → Account details)", "");
+}
+function secretNames(root) {
+    const devVars = parseDevVars(readIfExists(join(root, ".dev.vars")) ?? "");
+    const provider = PROVIDER_SECRETS.filter((name) => devVars.has(name));
+    return ["API_TOKEN", ...provider, ...R2_SECRETS, ACCOUNT_SECRET];
+}
+async function collectSecrets(names, root, wrangler, prompter, options) {
+    const env = options.env ?? process.env;
+    const devVars = parseDevVars(readIfExists(join(root, ".dev.vars")) ?? "");
+    const values = {};
+    for (const name of names) {
+        if (options.fromEnv) {
+            const value = env[name];
+            if (!value)
+                throw new CliError(`--from-env: ${name} is not set in the environment`);
+            values[name] = value;
+            continue;
+        }
+        values[name] = await promptSecret(name, devVars.get(name), wrangler, prompter, env);
+    }
+    return values;
+}
+async function promptSecret(name, local, wrangler, prompter, env) {
+    if (name === ACCOUNT_SECRET)
+        return resolveAccountId(wrangler, prompter, env);
+    if (name === "API_TOKEN") {
+        if (local &&
+            local.length >= MINIMUM_TOKEN_LENGTH &&
+            (await prompter.confirm("Use the API_TOKEN from .dev.vars in production?", true)))
+            return local;
+        if (await prompter.confirm("Generate a new API_TOKEN? (No = type one)", true))
+            return randomToken();
+    }
+    if (name === "R2_ACCESS_KEY_ID")
+        console.log(R2_TOKEN_HELP);
+    const value = await prompter.password(`${name}`);
+    if (name === "API_TOKEN" && value.length < MINIMUM_TOKEN_LENGTH)
+        throw new CliError(`API_TOKEN must be at least ${MINIMUM_TOKEN_LENGTH} characters`);
+    return value;
+}
+export async function runSetup(options) {
+    const root = resolve(options.dir);
+    const project = locateProject(root);
+    if (project.mode === "standalone")
+        throw new CliError("No Wrangler configuration here; run create-cf-open-agents-api init first.");
+    const text = readIfExists(project.configPath) ?? "";
+    const config = parseJsonc(text, project.configPath);
+    const prompter = options.prompter ?? (options.fromEnv || !interactive() ? defaultPrompter() : clackPrompter());
+    const reporter = options.reporter ?? (interactive() ? clackReporter() : plainReporter());
+    const wrangler = wranglerFor(project, options.runner ?? run);
+    const plan = new Plan();
+    reporter.intro(`Production setup for ${config.name ?? project.root}${options.dryRun ? " (dry run)" : ""}`);
+    if (!options.skipBuckets)
+        ensureBuckets(config, wrangler, plan, options.dryRun);
+    if (!options.skipSecrets) {
+        const names = secretNames(root);
+        if (options.dryRun)
+            plan.add({
+                status: "updated",
+                file: `secrets ${names.join(", ")}`,
+                note: `Would run ${wrangler.describe(["secret", "bulk"])} with the values on stdin`,
+            });
+        else {
+            const values = await collectSecrets(names, root, wrangler, prompter, options);
+            const result = wrangler(["secret", "bulk"], JSON.stringify(values));
+            if (!result.ok)
+                throw new CliError(`wrangler secret bulk failed:\n${(result.stdout + result.stderr).trim()}`);
+            plan.add({ status: "updated", file: `secrets ${names.join(", ")}` });
+        }
+    }
+    plan.note("LOCAL_BACKUPS stays out of production: the Sandbox SDK then signs presigned R2 URLs with the R2 secrets.");
+    plan.note(`Deploy with ${wrangler.describe(["deploy"])}; the first deploy pushes both images and takes several minutes.`);
+    reporter.plan(plan, options.dryRun ? "Dry run: nothing was changed" : "Done");
+    return plan;
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/steps/agents-file.d.ts

@@ -0,0 +1,5 @@
+import type { Files } from "../fs.js";
+import type { StepResult } from "../plan.js";
+import { type CompositionInput } from "../templates/agents.js";
+/** Writes the composition module; an edited file is kept unless `--force`. */
+export declare function ensureAgentsFile(files: Files, path: string, composition: CompositionInput, force: boolean): StepResult;

package/dist/steps/agents-file.js

@@ -0,0 +1,19 @@
+import { renderComposition } from "../templates/agents.js";
+/** Writes the composition module; an edited file is kept unless `--force`. */
+export function ensureAgentsFile(files, path, composition, force) {
+    const content = renderComposition(composition);
+    const existing = files.read(path);
+    if (existing !== undefined && existing !== content && !force) {
+        const file = path
+            .slice(files.root.length + 1)
+            .split("\\")
+            .join("/");
+        return {
+            status: "skipped",
+            file,
+            note: `${file} exists with different content and was kept; --force rewrites it from the template.`,
+        };
+    }
+    return files.write(path, content);
+}
+//# sourceMappingURL=agents-file.js.map

package/dist/steps/agents-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-file.js","sourceRoot":"","sources":["../../src/steps/agents-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAC9B,KAAY,EACZ,IAAY,EACZ,WAA6B,EAC7B,KAAc;IAEd,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI;aACd,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aAC5B,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,IAAI;YACJ,IAAI,EAAE,GAAG,IAAI,qFAAqF;SACnG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/steps/dev-vars.d.ts

@@ -0,0 +1,17 @@
+import type { Files } from "../fs.js";
+import type { StepResult } from "../plan.js";
+export interface DevVarsOptions {
+    files: Files;
+    /** The provider secret to add as an empty line, with the comment that explains it. */
+    secret?: {
+        name: string;
+        comment: string;
+    };
+    token?: () => string;
+}
+/** Parses `KEY=value` lines; comments and unknown lines keep their place. */
+export declare function parseDevVars(text: string): Map<string, string>;
+/** `.dev.vars` with a usable API token, the provider key line and local backups. */
+export declare function ensureDevVars(options: DevVarsOptions): StepResult;
+/** The committed example next to `.dev.vars`: existing lines stay, missing keys are appended. */
+export declare function ensureDevVarsExample(options: DevVarsOptions): StepResult;

package/dist/steps/dev-vars.js

@@ -0,0 +1,65 @@
+import { join } from "node:path";
+import { MINIMUM_TOKEN_LENGTH, randomToken } from "../token.js";
+const LOCAL_BACKUPS_COMMENT = "# Store sandbox backups on the local R2 emulator during `wrangler dev`; unset in production.";
+const TOKEN_COMMENT = "# Bearer token clients send; at least 32 characters. A caller must use the same value.";
+/** Parses `KEY=value` lines; comments and unknown lines keep their place. */
+export function parseDevVars(text) {
+    const values = new Map();
+    for (const line of text.split(/\r?\n/)) {
+        const match = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/.exec(line);
+        if (match?.[1] !== undefined)
+            values.set(match[1], (match[2] ?? "").trim());
+    }
+    return values;
+}
+function upsertLine(lines, key, value, comment) {
+    const index = lines.findIndex((line) => new RegExp(`^\\s*${key}\\s*=`).test(line));
+    if (index >= 0) {
+        lines[index] = `${key}=${value}`;
+        return;
+    }
+    if (lines.length > 0 && lines.at(-1) !== "")
+        lines.push("");
+    if (comment)
+        lines.push(comment);
+    lines.push(`${key}=${value}`);
+}
+const trimTrailing = (lines) => {
+    while (lines.length > 0 && lines.at(-1) === "")
+        lines.pop();
+    return lines;
+};
+/** `.dev.vars` with a usable API token, the provider key line and local backups. */
+export function ensureDevVars(options) {
+    const path = join(options.files.root, ".dev.vars");
+    const existing = options.files.read(path) ?? "";
+    const values = parseDevVars(existing);
+    const lines = trimTrailing(existing.split(/\r?\n/));
+    const notes = [];
+    const token = values.get("API_TOKEN") ?? "";
+    if (token.length < MINIMUM_TOKEN_LENGTH) {
+        upsertLine(lines, "API_TOKEN", (options.token ?? randomToken)(), TOKEN_COMMENT);
+        if (token)
+            notes.push(`.dev.vars: API_TOKEN was shorter than ${MINIMUM_TOKEN_LENGTH} characters and was replaced.`);
+    }
+    if (options.secret && !values.has(options.secret.name))
+        upsertLine(lines, options.secret.name, "", options.secret.comment);
+    if (!values.has("LOCAL_BACKUPS"))
+        upsertLine(lines, "LOCAL_BACKUPS", "true", LOCAL_BACKUPS_COMMENT);
+    return options.files.write(path, `${lines.join("\n")}\n`, notes.length > 0 ? notes.join(" ") : undefined);
+}
+/** The committed example next to `.dev.vars`: existing lines stay, missing keys are appended. */
+export function ensureDevVarsExample(options) {
+    const path = join(options.files.root, ".dev.vars.example");
+    const existing = options.files.read(path) ?? "";
+    const values = parseDevVars(existing);
+    const lines = trimTrailing(existing.split(/\r?\n/));
+    if (!values.has("API_TOKEN"))
+        lines.push("API_TOKEN=replace-with-at-least-32-random-characters");
+    if (options.secret && !values.has(options.secret.name))
+        lines.push(options.secret.comment, `${options.secret.name}=`);
+    if (!values.has("LOCAL_BACKUPS"))
+        lines.push(LOCAL_BACKUPS_COMMENT, "LOCAL_BACKUPS=true");
+    return options.files.write(path, `${lines.join("\n")}\n`);
+}
+//# sourceMappingURL=dev-vars.js.map

package/dist/steps/dev-vars.js.map

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

package/dist/steps/entry.d.ts

@@ -0,0 +1,7 @@
+import type { Files } from "../fs.js";
+import { type StepResult } from "../plan.js";
+export declare const EXPORTED_CLASSES: readonly ["Agents", "Models", "SessionDO", "TenantCatalogDO", "HarnessDO", "SandboxDO", "ContainerProxy"];
+/** The module specifier from the entry file to the composition, matching its import style. */
+export declare function agentsSpecifier(entryPath: string, agentsPath: string, entrySource: string): string;
+/** Appends the class re-export to the existing entry once. */
+export declare function ensureEntryExports(files: Files, entryPath: string, agentsPath: string): StepResult;

package/dist/steps/entry.js

@@ -0,0 +1,36 @@
+import { dirname, relative } from "node:path";
+import { CliError } from "../plan.js";
+export const EXPORTED_CLASSES = [
+    "Agents",
+    "Models",
+    "SessionDO",
+    "TenantCatalogDO",
+    "HarnessDO",
+    "SandboxDO",
+    "ContainerProxy",
+];
+/** The module specifier from the entry file to the composition, matching its import style. */
+export function agentsSpecifier(entryPath, agentsPath, entrySource) {
+    const raw = relative(dirname(entryPath), agentsPath).split("\\").join("/");
+    const bare = raw.replace(/\.ts$/, "");
+    const withDot = bare.startsWith(".") ? bare : `./${bare}`;
+    const extensioned = /from\s+["']\.{1,2}\/[^"']+\.js["']/.test(entrySource);
+    return extensioned ? `${withDot}.js` : withDot;
+}
+/** Appends the class re-export to the existing entry once. */
+export function ensureEntryExports(files, entryPath, agentsPath) {
+    const source = files.read(entryPath);
+    if (source === undefined)
+        throw new CliError(`The Wrangler entry ${entryPath} does not exist; point main at your Worker entry first.`);
+    const file = entryPath
+        .slice(files.root.length + 1)
+        .split("\\")
+        .join("/");
+    if (/export\s*\{[^}]*\bSessionDO\b[^}]*\}\s*from/.test(source))
+        return { status: "skipped", file };
+    const specifier = agentsSpecifier(entryPath, agentsPath, source);
+    const line = `export { ${EXPORTED_CLASSES.join(", ")} } from "${specifier}";`;
+    const separator = source.endsWith("\n") ? "" : "\n";
+    return files.write(entryPath, `${source}${separator}${line}\n`);
+}
+//# sourceMappingURL=entry.js.map

package/dist/steps/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/steps/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAEvD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,iBAAiB;IACjB,WAAW;IACX,WAAW;IACX,gBAAgB;CACR,CAAC;AAEX,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,UAAkB,EAClB,WAAmB;IAEnB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC1D,MAAM,WAAW,GAAG,oCAAoC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3E,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,SAAiB,EACjB,UAAkB;IAElB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS;QACtB,MAAM,IAAI,QAAQ,CAChB,sBAAsB,SAAS,yDAAyD,CACzF,CAAC;IACJ,MAAM,IAAI,GAAG,SAAS;SACnB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC5B,KAAK,CAAC,IAAI,CAAC;SACX,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,6CAA6C,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,YAAY,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,SAAS,IAAI,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/steps/gitignore.d.ts

@@ -0,0 +1,5 @@
+import type { Files } from "../fs.js";
+import type { StepResult } from "../plan.js";
+export declare const IGNORED: readonly [".cf-open-agents-api/", ".dev.vars"];
+/** Appends the snapshot directory and the local secrets file once. */
+export declare function ensureGitignore(files: Files): StepResult;

package/dist/steps/gitignore.js

@@ -0,0 +1,20 @@
+import { join } from "node:path";
+import { VENDOR_DIRECTORY } from "../versions.js";
+export const IGNORED = [`${VENDOR_DIRECTORY}/`, ".dev.vars"];
+/** Appends the snapshot directory and the local secrets file once. */
+export function ensureGitignore(files) {
+    const path = join(files.root, ".gitignore");
+    const existing = files.read(path) ?? "";
+    const lines = existing.split(/\r?\n/);
+    const present = new Set(lines.map((line) => line.trim()));
+    const missing = IGNORED.filter((entry) => !present.has(entry) && !present.has(entry.replace(/\/$/, "")));
+    if (missing.length === 0)
+        return { status: "skipped", file: ".gitignore" };
+    while (lines.length > 0 && lines.at(-1) === "")
+        lines.pop();
+    if (lines.length > 0)
+        lines.push("");
+    lines.push("# CF-Open-Agents-API image snapshot and local secrets", ...missing);
+    return files.write(path, `${lines.join("\n")}\n`);
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/steps/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/steps/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,GAAG,EAAE,WAAW,CAAU,CAAC;AAEtE,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CACzE,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC3E,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,uDAAuD,EAAE,GAAG,OAAO,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/steps/package-json.d.ts

@@ -0,0 +1,12 @@
+import type { Files } from "../fs.js";
+import { type StepResult } from "../plan.js";
+export interface PackageJsonOptions {
+    files: Files;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    force: boolean;
+}
+/** Adds pinned dependencies and the vendor hook; other versions are kept unless `--force`. */
+export declare function ensurePackageJson(options: PackageJsonOptions): StepResult;
+export declare const vendorScript = "create-cf-open-agents-api vendor";

package/dist/steps/package-json.js

@@ -0,0 +1,45 @@
+import { join } from "node:path";
+import { openJsonc, parseJsonc, setValue } from "../jsonc.js";
+import { CliError } from "../plan.js";
+import { CLI_NAME } from "../versions.js";
+const VENDOR_SCRIPT = `${CLI_NAME} vendor`;
+/** Adds pinned dependencies and the vendor hook; other versions are kept unless `--force`. */
+export function ensurePackageJson(options) {
+    const path = join(options.files.root, "package.json");
+    const text = options.files.read(path);
+    if (text === undefined)
+        throw new CliError("package.json is missing; run this in a Node project.");
+    let document = openJsonc(text);
+    const notes = [];
+    const kept = [];
+    const upsert = (field, wanted) => {
+        for (const [name, version] of Object.entries(wanted)) {
+            const current = parseJsonc(document.text, "package.json")[field]?.[name];
+            if (current === version)
+                continue;
+            if (current !== undefined && !options.force) {
+                kept.push(`${name}@${current} (wanted ${version})`);
+                continue;
+            }
+            document = setValue(document, [field, name], version);
+        }
+    };
+    upsert("dependencies", options.dependencies);
+    upsert("devDependencies", options.devDependencies);
+    for (const [name, command] of Object.entries(options.scripts)) {
+        const current = parseJsonc(document.text, "package.json").scripts?.[name];
+        if (current === command || current?.includes(command))
+            continue;
+        const next = name === "postinstall" && current ? `${current} && ${command}` : command;
+        if (current && next === command && !options.force) {
+            kept.push(`scripts.${name} (wanted ${command})`);
+            continue;
+        }
+        document = setValue(document, ["scripts", name], next);
+    }
+    if (kept.length > 0)
+        notes.push(`package.json kept existing entries: ${kept.join(", ")}; --force overwrites them.`);
+    return options.files.write(path, document.text, notes.length > 0 ? notes.join(" ") : undefined);
+}
+export const vendorScript = VENDOR_SCRIPT;
+//# sourceMappingURL=package-json.js.map

package/dist/steps/package-json.js.map

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

package/dist/steps/standalone.d.ts

@@ -0,0 +1,8 @@
+import type { Files } from "../fs.js";
+import type { StepResult } from "../plan.js";
+import { type SkeletonInput } from "../templates/standalone.js";
+export interface StandaloneOptions extends SkeletonInput {
+    files: Files;
+}
+/** The files a new Workers project needs before the shared upserts run; existing files are kept. */
+export declare function ensureStandaloneSkeleton(options: StandaloneOptions): StepResult[];

package/dist/steps/standalone.js

@@ -0,0 +1,18 @@
+import { join } from "node:path";
+import { gitignoreSkeleton, packageSkeleton, tsconfigSkeleton, wranglerSkeleton, } from "../templates/standalone.js";
+/** The files a new Workers project needs before the shared upserts run; existing files are kept. */
+export function ensureStandaloneSkeleton(options) {
+    const write = (file, content) => {
+        const path = join(options.files.root, file);
+        if (options.files.exists(path))
+            return { status: "skipped", file };
+        return options.files.write(path, content);
+    };
+    return [
+        write("package.json", packageSkeleton(options)),
+        write("tsconfig.json", tsconfigSkeleton()),
+        write("wrangler.jsonc", wranglerSkeleton(options)),
+        write(".gitignore", gitignoreSkeleton()),
+    ];
+}
+//# sourceMappingURL=standalone.js.map

package/dist/steps/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../src/steps/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EACL,iBAAiB,EACjB,eAAe,EAEf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAMpC,oGAAoG;AACpG,MAAM,UAAU,wBAAwB,CAAC,OAA0B;IACjE,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,OAAe,EAAc,EAAE;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC;QAC1C,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,KAAK,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/steps/tsconfig.d.ts

@@ -0,0 +1,4 @@
+import type { Files } from "../fs.js";
+import type { StepResult } from "../plan.js";
+/** Keeps the snapshot out of a tsconfig that would otherwise scan it. */
+export declare function ensureTsconfigExclude(files: Files): StepResult;

package/dist/steps/tsconfig.js

@@ -0,0 +1,18 @@
+import { join } from "node:path";
+import { appendItem, collapsePrimitiveArrays, openJsonc, parseJsonc } from "../jsonc.js";
+import { VENDOR_DIRECTORY } from "../versions.js";
+/** Keeps the snapshot out of a tsconfig that would otherwise scan it. */
+export function ensureTsconfigExclude(files) {
+    const path = join(files.root, "tsconfig.json");
+    const text = files.read(path);
+    if (text === undefined)
+        return { status: "skipped", file: "tsconfig.json" };
+    const config = parseJsonc(text, "tsconfig.json");
+    const broad = !config.include || config.include.some((pattern) => pattern.includes("**"));
+    const excluded = (config.exclude ?? []).some((pattern) => pattern.replace(/^\.\//, "").startsWith(VENDOR_DIRECTORY));
+    if (!broad || excluded)
+        return { status: "skipped", file: "tsconfig.json" };
+    const document = collapsePrimitiveArrays(appendItem(openJsonc(text), ["exclude"], VENDOR_DIRECTORY));
+    return files.write(path, document.text, `tsconfig.json now excludes ${VENDOR_DIRECTORY}; add it to your linter's ignore list too.`);
+}
+//# sourceMappingURL=tsconfig.js.map

package/dist/steps/tsconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.js","sourceRoot":"","sources":["../../src/steps/tsconfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOlD,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CAAC,KAAY;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,UAAU,CAAW,IAAI,EAAE,eAAe,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CACvD,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAC1D,CAAC;IACF,IAAI,CAAC,KAAK,IAAI,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,uBAAuB,CACtC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAC3D,CAAC;IACF,OAAO,KAAK,CAAC,KAAK,CAChB,IAAI,EACJ,QAAQ,CAAC,IAAI,EACb,8BAA8B,gBAAgB,4CAA4C,CAC3F,CAAC;AACJ,CAAC"}

package/dist/steps/vendor.d.ts

@@ -0,0 +1,30 @@
+import { type Runner } from "../exec.js";
+import { type StepResult } from "../plan.js";
+export interface VendorOptions {
+    root: string;
+    /** The CLI version; the snapshot tag is `v<version>` unless `ref` says otherwise. */
+    version: string;
+    ref?: string;
+    /** A local checkout to copy from instead of downloading the tag archive. */
+    source?: string;
+    force: boolean;
+    dryRun: boolean;
+    fetch?: typeof globalThis.fetch;
+    runner?: Runner;
+    env?: NodeJS.ProcessEnv;
+}
+export interface VendorManifest {
+    name: string;
+    version: string;
+    ref: string;
+    source: string;
+    createdAt: string;
+}
+export declare const SKIP_VENDOR_VARIABLE = "CF_OPEN_AGENTS_API_SKIP_VENDOR";
+export declare const SOURCE_VARIABLE = "CF_OPEN_AGENTS_API_SOURCE";
+export declare function vendorDirectory(root: string): string;
+export declare function readVendorManifest(root: string): VendorManifest | undefined;
+/** Ensures `.cf-open-agents-api/` holds the snapshot the Dockerfiles build from. */
+export declare function ensureVendor(options: VendorOptions): Promise<StepResult>;
+/** The package directories a snapshot holds, for `doctor`. */
+export declare function snapshotPackages(root: string): string[];