create-loopengine 0.1.59 → 0.1.61

package/README.md

@@ -16,7 +16,7 @@ clone of loopengine's own source repo.
 npx create-loopengine@latest my-agents
 cd my-agents
 npm install
-cp .env.example .env   # fill in ANTHROPIC_API_KEY
+cp .env.example .env   # fill in OPENAI_API_KEY (or set it later on the Models page)
 npm run dev             # HTTP server on :8787
 ```
 

package/dist/cli.d.ts

@@ -6,7 +6,10 @@ export interface ScaffoldOptions {
     templateDir?: string;
 }
 export declare function scaffold(options: ScaffoldOptions): string;
-export type UpgradeFileStatus = 'updated' | 'unchanged' | 'conflict' | 'skipped';
+/** `kept`: the project edited a file the template also changed, and
+ * `keepEdited` was set, so it was left exactly as it was (no merge, no
+ * conflict markers). */
+export type UpgradeFileStatus = 'updated' | 'unchanged' | 'conflict' | 'skipped' | 'kept';
 export interface UpgradeFileResult {
     file: string;
     status: UpgradeFileStatus;
@@ -57,6 +60,11 @@ export interface UpgradeOptions {
     /** Runs `npm install` in projectDir — defaults to a real one. Test-only
      * seam to avoid actually installing anything during tests. */
     runNpmInstall?: (projectDir: string) => void;
+    /** Leave a file the project edited untouched (status `kept`) instead of
+     * three-way merging it, so nothing ever gets conflict markers. For
+     * unattended upgrades (the console's Upgrade button): a half-merged
+     * adapters/http.ts would stop the server from starting at all. */
+    keepEdited?: boolean;
 }
 export declare function upgradeProject(options?: UpgradeOptions): UpgradeResult;
 export declare function main(argv?: string[]): void;

package/dist/cli.js

@@ -116,7 +116,7 @@ function threeWayMerge(minePath, basePath, theirsPath) {
     }
     return { merged: readFileSync(minePath, 'utf8'), conflicted };
 }
-function upgradeFile(candidate, baseTemplateDir, currentTemplateDir, projectDir) {
+function upgradeFile(candidate, baseTemplateDir, currentTemplateDir, projectDir, keepEdited = false) {
     const projectFilePath = join(projectDir, candidate.projectPath);
     const baseFilePath = join(baseTemplateDir, candidate.templatePath);
     const theirsFilePath = join(currentTemplateDir, candidate.templatePath);
@@ -132,6 +132,17 @@ function upgradeFile(candidate, baseTemplateDir, currentTemplateDir, projectDir)
         return { file: candidate.projectPath, status: 'unchanged' };
     }
     const mine = readFileSync(projectFilePath, 'utf8');
+    // The common cases need no merge (and so no git): a file the project
+    // never edited takes the new template as is, and one that already
+    // matches it has nothing to do.
+    if (mine === theirs)
+        return { file: candidate.projectPath, status: 'unchanged' };
+    if (mine === base) {
+        writeFileSync(projectFilePath, theirs);
+        return { file: candidate.projectPath, status: 'updated' };
+    }
+    if (keepEdited)
+        return { file: candidate.projectPath, status: 'kept' };
     const scratchDir = mkdtempSync(join(tmpdir(), 'create-loopengine-merge-'));
     const mineTmp = join(scratchDir, 'mine');
     const baseTmp = join(scratchDir, 'base');
@@ -162,7 +173,7 @@ export function upgradeProject(options = {}) {
     }
     const resolveBase = options.resolveBaseTemplateDir ?? fetchPublishedTemplateDir;
     const baseTemplateDir = resolveBase(fromVersion);
-    const files = UPGRADE_CANDIDATE_FILES.map((candidate) => upgradeFile(candidate, baseTemplateDir, currentTemplateDir, projectDir));
+    const files = UPGRADE_CANDIDATE_FILES.map((candidate) => upgradeFile(candidate, baseTemplateDir, currentTemplateDir, projectDir, options.keepEdited));
     const resolveLatestVersion = options.resolveLatestVersion ?? resolveLatestVersionFromNpm;
     const dependencies = bumpDependencies(projectDir, resolveLatestVersion);
     let npmInstall;
@@ -236,17 +247,23 @@ function bumpDependencies(projectDir, resolveLatestVersion) {
 }
 function parseUpgradeArgs(argv) {
     let from;
+    let json = false;
+    let keepEdited = false;
     for (let i = 0; i < argv.length; i++) {
         if (argv[i] === '--from')
             from = argv[++i];
+        else if (argv[i] === '--json')
+            json = true;
+        else if (argv[i] === '--keep-edited')
+            keepEdited = true;
     }
-    return { from };
+    return { from, json, keepEdited };
 }
 function printUpgradeSummary(result) {
     console.log(`Upgrading create-loopengine@${result.fromVersion} -> @${result.toVersion}`);
     console.log();
     for (const f of result.files) {
-        const label = f.status === 'updated' ? 'updated  ' : f.status === 'conflict' ? 'conflict ' : f.status === 'unchanged' ? 'unchanged' : 'skipped  ';
+        const label = f.status === 'updated' ? 'updated  ' : f.status === 'conflict' ? 'conflict ' : f.status === 'unchanged' ? 'unchanged' : f.status === 'kept' ? 'kept     ' : 'skipped  ';
         console.log(`  ${label}  ${f.file}`);
     }
     console.log();
@@ -275,8 +292,20 @@ function parseArgs(argv) {
 export function main(argv = process.argv.slice(2)) {
     try {
         if (argv[0] === 'upgrade') {
-            const { from } = parseUpgradeArgs(argv.slice(1));
-            printUpgradeSummary(upgradeProject({ from }));
+            const { from, json, keepEdited } = parseUpgradeArgs(argv.slice(1));
+            if (json) {
+                // One JSON object on stdout, for a program driving the upgrade
+                // (loopengine's console); errors become { error } with exit 1.
+                try {
+                    console.log(JSON.stringify(upgradeProject({ from, keepEdited })));
+                }
+                catch (err) {
+                    console.log(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
+                    process.exitCode = 1;
+                }
+                return;
+            }
+            printUpgradeSummary(upgradeProject({ from, keepEdited }));
             return;
         }
         const { name } = parseArgs(argv);
@@ -285,7 +314,7 @@ export function main(argv = process.argv.slice(2)) {
         console.log();
         console.log(`  cd ${destination}`);
         console.log('  npm install');
-        console.log('  cp .env.example .env   # fill in ANTHROPIC_API_KEY');
+        console.log('  cp .env.example .env   # fill in OPENAI_API_KEY (or set it on the Models page)');
         console.log('  npm run dev');
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "description": "Scaffold a new loopengine agent project — a runnable HTTP server with one example agent, in your own repo.",
   "license": "MIT",
   "type": "module",

package/template/.env.example

@@ -1,7 +1,8 @@
-ANTHROPIC_API_KEY=
-# Using OpenAI instead? Swap agents/example-agent/index.ts's createModelCall
-# for createOpenAIModelCall({ model: '...' }) and set this instead:
-# OPENAI_API_KEY=
+# The example agent uses OpenAI (agents/example-agent/index.ts's `model`).
+# Set the key here, or on the console's Models page once the server runs.
+OPENAI_API_KEY=
+# Switching the agent to another provider? Set its key instead, e.g.:
+# ANTHROPIC_API_KEY=
 
 PORT=8787
 

package/template/README.md

@@ -6,7 +6,7 @@ An agent server built with [loopengine](https://www.npmjs.com/package/loopengine
 
 ```bash
 npm install
-cp .env.example .env   # fill in ANTHROPIC_API_KEY
+cp .env.example .env   # fill in OPENAI_API_KEY (or set it later on the Models page)
 ```
 
 ## Run

package/template/_gitignore

@@ -6,3 +6,5 @@ dist
 .env
 *.log
 .DS_Store
+# Backups the console Upgrade button keeps of the files it changed.
+.upgrade-backups

package/template/adapters/http.ts

@@ -153,6 +153,10 @@ import {
   searchPublicAbilities,
   fetchLatestAbilityVersion,
   describeModelProviders,
+  loopengineVersion,
+  describeUpgrade,
+  runUpgrade,
+  UpgradeError,
   setModelProviderKey,
   clearModelProviderKey,
   ModelKeyError,
@@ -2984,6 +2988,52 @@ const server = createServer(async (req, res) => {
       res.writeHead(200, { 'content-type': 'text/html' }).end(globalConfigPageHtml)
       return
     }
+    // What the sidebar's sign-in line and the Settings section show. In
+    // hosted mode the email and dashboard link come from the router's
+    // signed identity, so they can't be set by the caller.
+    if (req.method === 'GET' && pathname === '/config/settings') {
+      const identity = trustedProxySecret ? verifyProxyIdentity(req.headers[TRUSTED_PROXY_IDENTITY_HEADER], trustedProxySecret) : undefined
+      const signIn = identity
+        ? {
+            mode: 'hosted',
+            email: identity.email ?? null,
+            dashboardUrl: identity.dashboardUrl && /^https?:\/\//.test(identity.dashboardUrl) ? identity.dashboardUrl : null,
+          }
+        : { mode: adminAuth ? 'basic' : 'open' }
+      res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' }).end(
+        JSON.stringify({
+          signIn,
+          version: loopengineVersion(),
+          environment: process.env.LOOPENGINE_ENV ?? 'production',
+          publicUrl: process.env.LOOPENGINE_PUBLIC_URL ?? null,
+          scheduler: process.env.LOOPENGINE_SCHEDULER === 'off' ? 'off' : 'on',
+        }),
+      )
+      return
+    }
+    // The Settings section's Upgrade button (web/upgrade-admin.ts).
+    if (req.method === 'GET' && pathname === '/config/upgrade') {
+      res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' }).end(
+        JSON.stringify({ ...(await describeUpgrade()), canUpgrade: secretsProtected, restartsItself: exitOnCodeChange }),
+      )
+      return
+    }
+    if (req.method === 'POST' && pathname === '/config/upgrade') {
+      if (!secretsProtected) {
+        res.writeHead(403, { 'content-type': 'application/json' }).end(JSON.stringify({ error: 'Refusing to upgrade without LOOPENGINE_ADMIN_AUTH configured.' }))
+        return
+      }
+      try {
+        const outcome = await runUpgrade({ busy: () => sessionTurns.size + scheduler.running > 0 })
+        res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ ok: true, outcome, restarting: exitOnCodeChange }))
+      } catch (err) {
+        const status = err instanceof UpgradeError ? 409 : 500
+        res.writeHead(status, { 'content-type': 'application/json' }).end(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }))
+        return
+      }
+      exitIfCodeChanged(res)
+      return
+    }
     if (req.method === 'GET' && pathname === '/config/models') {
       res.writeHead(200, { 'content-type': 'application/json' }).end(
         JSON.stringify({ ...describeModelProviders(listAgents(), (name) => getEntry(name)?.config), canSave: secretsProtected }),

package/template/agents/example-agent/index.ts

@@ -12,18 +12,17 @@
 // resolves relative to loopengine's own installed location, not your
 // project, so it only works inside loopengine's own repo — see
 // tools/index.ts's own comment.
-import { createAnthropicModelCall, type AgentConfig, type ModelCall } from 'loopengine'
+import type { AgentConfig } from 'loopengine'
 import { tools } from './tools/index.js'
 
 export const config: AgentConfig = {
   name: 'example-agent',
   systemPrompt: 'You are a helpful assistant.',
   tools,
-}
-
-// Reads ANTHROPIC_API_KEY from the env. Swap for
-// createOpenAIModelCall({ model: '...' }) to use OpenAI instead — see
-// node_modules/loopengine/README.md's "Wiring a real model" section.
-export function createModelCall(): ModelCall {
-  return createAnthropicModelCall({ model: 'claude-sonnet-5' })
+  // Reads OPENAI_API_KEY: set it on the console's Models page, or in .env.
+  // For another provider, change `provider` and `model` (e.g.
+  // { provider: 'anthropic', model: 'claude-sonnet-5' } with
+  // ANTHROPIC_API_KEY). reasoningEffort 'none' lets this gpt-5.x model use
+  // function tools; see AgentModelConfig in loopengine's agent-config.
+  model: { provider: 'openai', model: 'gpt-5.6-luna', reasoningEffort: 'none' },
 }

package/template/package.json

@@ -9,7 +9,7 @@
     "cli": "tsx adapters/cli.ts"
   },
   "dependencies": {
-    "loopengine": "^0.1.74",
+    "loopengine": "^0.1.76",
     "actauth": "^0.0.12"
   },
   "devDependencies": {