create-loopengine 0.1.71 → 0.1.73

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.1.71",
+  "version": "0.1.73",
   "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,20 @@ import {
   playgroundHtml,
   agentsConfigPageHtml,
   agentsListPageHtml,
+  interviewPageHtml,
+  InterviewError,
+  answerInterview,
+  createFromCandidate,
+  deleteInterview,
+  finishInterview,
+  getInterview,
+  interviewTools,
+  listInterviews,
+  pickInterviewModel,
+  previewCandidate,
+  startInterview,
+  setInterviewProject,
+  type InterviewAgentSource,
   globalConfigPageHtml,
   addGatewayTool,
   agentDir,
@@ -135,6 +149,7 @@ import {
   type DecisionOutcome,
   type MessagingDeps,
   handleMessagingAction,
+  settleThreadChoice,
   describeChange,
   openSlackAnswerModal,
   parseSlackInteraction,
@@ -878,6 +893,71 @@ 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}` })
+  }
+}
+
 async function handleCreateAgent(req: IncomingMessage, res: ServerResponse): Promise<void> {
   const body = await readJsonBody(req)
   if (typeof body.name !== 'string' || !body.name) {
@@ -2803,6 +2883,12 @@ async function handleSlackInteraction(req: IncomingMessage, res: ServerResponse,
   if (interaction.type === 'decide') await resolvePendingApproval(capture.res, interaction.pendingId, { decision: interaction.decision })
   else await answerPendingQuestion(capture.res, interaction.pendingId, { answer: interaction.answer })
   const outcome = await capture.done
+  // A proposed change or a Confirm still waiting in the thread no longer
+  // applies: replace it so its buttons don't linger.
+  if (botToken && outcome.status < 400 && !outcome.body.alreadyResolved) {
+    const done = interaction.type === 'decide' ? (interaction.decision === 'approve' ? 'Approved' : 'Denied') : 'Answered'
+    await settleThreadChoice(slackMessagingDeps(agentName, entry, botToken), interaction.pendingId, `${done}${interaction.user ? ` by <@${interaction.user}>` : ''} with the request's own buttons.`).catch((err) => console.error('[loopengine] Slack update failed:', err))
+  }
   if (interaction.responseUrl) {
     let text = slackOutcomeText(interaction.type === 'decide' ? interaction.decision : 'answer', outcome.status, outcome.body, interaction.user)
     if (ran && outcome.status < 400 && !outcome.body.alreadyResolved) text += ran
@@ -3177,6 +3263,15 @@ 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
+    }
     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.88",
+    "loopengine": "^0.1.91",
     "actauth": "^0.0.12",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0"