create-loopengine 0.1.72 → 0.1.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.1.72",
+  "version": "0.1.74",
   "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/_gitignore

@@ -4,6 +4,8 @@ dist
 .checkpoints
 # Slack threads matched to their requests (agents/<name>/.messaging).
 .messaging
+# "Find your first agent" interviews (the console page /interview).
+.interviews
 .scheduler
 .env
 *.log

package/template/adapters/http.ts

@@ -72,6 +72,26 @@ import {
   playgroundHtml,
   agentsConfigPageHtml,
   agentsListPageHtml,
+  interviewPageHtml,
+  InterviewError,
+  answerInterview,
+  createFromCandidate,
+  deleteInterview,
+  finishInterview,
+  getInterview,
+  interviewTools,
+  listInterviews,
+  pickInterviewModel,
+  pickAgentModel,
+  previewCandidate,
+  startInterview,
+  setInterviewProject,
+  type InterviewAgentSource,
+  templatesPageHtml,
+  TemplateError,
+  createFromTemplate,
+  listTemplates,
+  previewTemplate,
   globalConfigPageHtml,
   addGatewayTool,
   agentDir,
@@ -879,6 +899,109 @@ function parseAgentLimitsFields(
   return { ok: true, value }
 }
 
+// "Find your first agent" (web/interview-admin.ts): the interview's
+// routes, behind the console login like the rest. The interviewer runs on
+// the model of an agent that already works here; creating an agent goes
+// through the same scaffold and registration as Agents → + New.
+function interviewAgents(): InterviewAgentSource[] {
+  return listAgents().flatMap((name) => {
+    const entry = getEntry(name)
+    return entry ? [{ name, config: entry.config, createModelCall: () => entry.createModelCall() }] : []
+  })
+}
+
+async function handleInterviews(req: IncomingMessage, res: ServerResponse, pathname: string): Promise<void> {
+  setInterviewProject(projectDir())
+  const json = (status: number, body: unknown): void => {
+    res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store' }).end(JSON.stringify(body))
+  }
+  const parts = pathname.split('/').slice(2).map(decodeURIComponent) // after /interviews
+  const [id, action, index, sub] = parts
+  try {
+    if (!id) {
+      if (req.method === 'GET') return json(200, { interviews: listInterviews(), ready: Boolean(pickInterviewModel(interviewAgents())) })
+      if (req.method === 'POST') return json(200, startInterview())
+      return json(405, { error: 'method not allowed' })
+    }
+    if (!action) {
+      if (req.method === 'GET') return json(200, getInterview(id))
+      if (req.method === 'DELETE') {
+        deleteInterview(id)
+        return json(200, { deleted: true })
+      }
+      return json(405, { error: 'method not allowed' })
+    }
+    const agents = interviewAgents()
+    const exists = (name: string) => Boolean(getEntry(name)) || existsSync(join(projectDir(), 'agents', name))
+    if (action === 'candidates' && index !== undefined && sub === 'preview' && req.method === 'GET') {
+      return json(200, previewCandidate(id, Number(index), { agentExists: exists }))
+    }
+    const picked = pickInterviewModel(agents)
+    if (!picked) return json(409, { error: 'No agent here names a model yet. Set one on an agent (Overview → Model) and add its key under Models.' })
+    if (action === 'messages' && req.method === 'POST') {
+      const body = await readJsonBody(req)
+      return json(200, await answerInterview(id, body.text, picked.modelCall, interviewTools(agents)))
+    }
+    if (action === 'finish' && req.method === 'POST') return json(200, await finishInterview(id, picked.modelCall, interviewTools(agents)))
+    if (action === 'candidates' && index !== undefined && sub === 'create' && req.method === 'POST') {
+      const created = await createFromCandidate(id, Number(index), {
+        agentExists: exists,
+        createAgent: async (name, systemPrompt) => {
+          const parsed = parseAgentTemplateOptions({ systemPrompt, model: picked.model })
+          if (!parsed.ok) throw new InterviewError(parsed.error)
+          const indexPath = await scaffoldAgent(projectDir(), name, parsed.value)
+          registerAgent(await loadAgentModule(indexPath, indexPath))
+        },
+      })
+      return json(200, created)
+    }
+    return json(404, { error: 'not found' })
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    if (err instanceof InterviewError) return json(message === 'No such interview' || message === 'No such candidate' ? 404 : 400, { error: message })
+    console.error('[loopengine] interview failed:', err)
+    return json(502, { error: `The interviewer couldn't answer: ${message}` })
+  }
+}
+
+// Templates (loopengine's web/templates-admin.ts): ready-made agents,
+// created through the same scaffold and registration as Agents → + New.
+// A template agent takes the model of an agent that already works here,
+// as an interview's does; with none, it starts on the scaffold's default.
+async function handleStarterTemplates(req: IncomingMessage, res: ServerResponse, pathname: string): Promise<void> {
+  const json = (status: number, body: unknown): void => {
+    res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store' }).end(JSON.stringify(body))
+  }
+  const [id, action] = pathname.split('/').slice(2).map(decodeURIComponent) // after /starter-templates
+  const exists = (name: string) => Boolean(getEntry(name)) || existsSync(join(projectDir(), 'agents', name))
+  try {
+    if (!id) {
+      if (req.method === 'GET') return json(200, { templates: listTemplates() })
+      return json(405, { error: 'method not allowed' })
+    }
+    if (action === 'preview' && req.method === 'GET') return json(200, previewTemplate(id, { agentExists: exists }))
+    if (action === 'create' && req.method === 'POST') {
+      const model = pickAgentModel(interviewAgents())
+      const created = await createFromTemplate(id, {
+        agentExists: exists,
+        createAgent: async (name, systemPrompt) => {
+          const parsed = parseAgentTemplateOptions({ systemPrompt, ...(model ? { model } : {}) })
+          if (!parsed.ok) throw new TemplateError(parsed.error)
+          const indexPath = await scaffoldAgent(projectDir(), name, parsed.value)
+          registerAgent(await loadAgentModule(indexPath, indexPath))
+        },
+      })
+      return json(200, created)
+    }
+    return json(404, { error: 'not found' })
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    if (err instanceof TemplateError) return json(message === 'No such template' ? 404 : 400, { error: message })
+    console.error('[loopengine] template failed:', err)
+    return json(500, { error: `Couldn't create it: ${message}` })
+  }
+}
+
 async function handleCreateAgent(req: IncomingMessage, res: ServerResponse): Promise<void> {
   const body = await readJsonBody(req)
   if (typeof body.name !== 'string' || !body.name) {
@@ -3184,6 +3307,24 @@ const server = createServer(async (req, res) => {
       await handleCreateAgent(req, res)
       return
     }
+    // "Find your first agent": the page, and its routes.
+    if (req.method === 'GET' && pathname === '/interview') {
+      res.writeHead(200, { 'content-type': 'text/html' }).end(interviewPageHtml)
+      return
+    }
+    if (pathname === '/interviews' || pathname.startsWith('/interviews/')) {
+      await handleInterviews(req, res, pathname)
+      return
+    }
+    // Templates: the page, and its routes.
+    if (req.method === 'GET' && pathname === '/templates') {
+      res.writeHead(200, { 'content-type': 'text/html' }).end(templatesPageHtml)
+      return
+    }
+    if (pathname === '/starter-templates' || pathname.startsWith('/starter-templates/')) {
+      await handleStarterTemplates(req, res, pathname)
+      return
+    }
     const editAgentMatch = req.method === 'PUT' && pathname.match(/^\/agents\/([^/]+)$/)
     if (editAgentMatch) {
       await handleEditAgent(req, res, decodeURIComponent(editAgentMatch[1]))

package/template/package.json

@@ -9,7 +9,7 @@
     "cli": "tsx adapters/cli.ts"
   },
   "dependencies": {
-    "loopengine": "^0.1.89",
+    "loopengine": "^0.1.92",
     "actauth": "^0.0.12",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0"