@kybernesis/create 0.5.1 → 0.5.2

package/dist/init.js

@@ -131,7 +131,7 @@ export async function init(rawName, options = {}) {
         }
     }
     console.log(bold("\n5/6  Env template + hermetic eval script …"));
-    writeFileSync(join(dir, ".env.example"), envExample(name, depts, issuer, plan.env));
+    writeFileSync(join(dir, ".env.example"), envExample(name, depts, issuer, plan.env, host, DEFAULT_MODEL));
     const pkgPath = join(dir, "package.json");
     const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
     pkg.scripts = { ...pkg.scripts, eval: evalScript(name, depts) };

package/dist/templates.d.ts

@@ -7,7 +7,7 @@ export declare function subagentInstructionsMd(dept: string): string;
 export declare function subagentArcanaTs(dept: string): string;
 export declare function rootArcanaTs(): string;
 export declare function evalFileTs(displayName: string, depts: string[]): string;
-export declare function envExample(name: string, depts: string[], issuer: string, channelEnv?: string[]): string;
+export declare function envExample(name: string, depts: string[], issuer: string, channelEnv?: string[], host?: "vercel" | "exe", model?: string): string;
 export declare function evalScript(name: string, depts: string[]): string;
 export type ChannelKind = "none" | "slack" | "imessage" | "telegram" | "discord" | "web";
 export declare const CHANNEL_KINDS: ChannelKind[];

package/dist/templates.js

@@ -120,22 +120,46 @@ export default kybernesisBaseline({
 ${depts.length ? `  routing: [\n${routing}\n  ],\n` : ""}});
 `;
 }
-export function envExample(name, depts, issuer, channelEnv = []) {
+/**
+ * Env every self-hosted agent needs and cannot infer.
+ *
+ * Both of these have bitten a real deployment. EXE_MODEL must match the LLM
+ * integration actually attached — a ChatGPT subscription serves OpenAI models,
+ * so an Anthropic code default fails against it. EXE_VM_NAME has no default at
+ * all by design: guessing a host would hand a user a working link into another
+ * agent's machine.
+ */
+function exeEnvBlock(name, model) {
+    return `# Self-hosted host + model (@kybernesis/exe)
+# EXE_MODEL must match the LLM integration you attached to the VM. A ChatGPT
+# subscription serves OpenAI models; the code default will fail against one.
+# Set it explicitly rather than relying on ${model}.
+EXE_MODEL="${model}"
+# Preview URLs are built from this. There is no default on purpose.
+EXE_VM_NAME="${name}"
+
+`;
+}
+export function envExample(name, depts, issuer, channelEnv = [], host = "vercel", model = "") {
     const deptVars = depts
         .map((d) => {
         const upper = d.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
         return `# ARCANA_${upper}_API_KEY="kb_..."\n# ARCANA_${upper}_WORKSPACE="${name}-${d}"`;
     })
         .join("\n");
+    const header = host === "exe"
+        ? `# Real values live in .env.local ON THE HOST. \`eve start\` does NOT read it the
+# way \`eve dev\` does — scripts/eve-server.sh exports it into the process.`
+        : `# Real values belong in Vercel envs (prod/preview Sensitive); \`eve deploy\`
+# overwrites .env.local from the development environment on every deploy.`;
     return `# ── Kybernesis agent environment ─────────────────────────────────────
-# Real values belong in Vercel envs (prod/preview Sensitive); \`eve deploy\`
-# overwrites .env.local from the development environment on every deploy.
+${header}
 
 # Control-plane governance (@kybernesis/enterprise)
 KYBERNESIS_ISSUER="${issuer}"
 KYBERNESIS_AGENT="${name}"
 
-${channelEnv.length ? `# Channel\n${channelEnv.join("\n")}\n\n` : ""}# Arcana memory (@kybernesis/arcana) — one workspace + scoped kb_ key per brain
+${host === "exe" ? exeEnvBlock(name, model) : ""}${channelEnv.length ? `# Channel\n${channelEnv.join("\n")}\n\n` : ""}# Arcana memory (@kybernesis/arcana) — one workspace + scoped kb_ key per brain
 # ARCANA_API_KEY="kb_..."
 # ARCANA_COMPANY_WORKSPACE="${name}-company"
 # ARCANA_DM_WORKSPACE="${name}-company"
@@ -360,8 +384,11 @@ export default defineSandbox({
   revalidationKey: () => "kybernesis-workshop-v5-docker",
   async bootstrap({ use }) {
     const sandbox = await use();
+    // Base image is Debian-family; refresh indexes before installing browser deps.
     await sandbox.run({ command: "apt-get update" });
     await sandbox.run({ command: "npm install -g pnpm" });
+    // Explicit package.json rather than \`npm init -y\`: init derives the name from
+    // the directory, and npm rejects names starting with a dot (".shot").
     await sandbox.run({
       command:
         "mkdir -p /workspace/.shot && cd /workspace/.shot && echo '{\\"name\\":\\"kyb-shot\\",\\"private\\":true}' > package.json && npm install playwright",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/create",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "The Kybernesis agent scaffolder and FDE toolkit: one command to a governed, remembering, multiplayer, self-testing eve agent — plus doctor and upgrade.",
   "license": "Apache-2.0",
   "type": "module",