create-loopengine 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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/adapters/http.ts

@@ -67,6 +67,7 @@ import {
   type AgentConfig,
   type AgentModelConfig,
   type ToolDefinition,
+  type Message,
   type ModelContentBlock,
   type RunAgentResult,
   playgroundHtml,
@@ -120,6 +121,8 @@ import {
   agentDirFor,
   verifyProxyIdentity,
   TRUSTED_PROXY_IDENTITY_HEADER,
+  reportRun,
+  usedTool,
   NotifierFileError,
   verifyDecisionToken,
   decidePath,
@@ -646,7 +649,11 @@ async function describeAgent(entry: RegistryEntry): Promise<Record<string, unkno
     // tab badge; the Apps tab's own GET .../abilities has the detail
     // (and its slower npm version lookups).
     abilityCount: listInstalledAbilities(config.name).length,
-    skills: skillIndex.map((s) => ({ name: s.name, description: s.description })),
+    // A skill that's a workflow is edited as one, on the Workflows tab.
+    skills: (() => {
+      const workflowIds = new Set(readWorkflows(agentDirFor(config)).map((w) => w.id))
+      return skillIndex.map((s) => ({ name: s.name, description: s.description, ...(workflowIds.has(s.name) ? { workflow: true } : {}) }))
+    })(),
     systemSkills: systemSkillIndex.map((s) => ({ name: s.name, description: s.description })),
     tools: tools.map(describeTool),
     // createAskUserTool() with no onPending, purely to describe its
@@ -1925,6 +1932,8 @@ async function executeUnattendedRun(agent: string, message: string, rawSessionId
 async function reportWorkflowRun(run: WorkflowRun): Promise<void> {
   const event: RunCallbackEvent | undefined = run.status === 'done' ? 'run.done' : run.status === 'error' ? 'run.failed' : run.status === 'awaiting_approval' ? 'run.awaiting_approval' : undefined
   if (!event) return
+  // For a host's run observer (core/run-events.ts); a failed run isn't reported.
+  if (run.status !== 'error') reportRun({ agent: run.agent, source: 'workflow', id: run.run_id, via: run.source, usedTool: true })
   const entry = getEntry(run.agent)
   if (run.notify && entry && event !== 'run.awaiting_approval') {
     const text = run.status === 'done' ? `Workflow ${run.workflow_id} for ${run.agent} ran:\n${run.result ?? ''}` : `Workflow ${run.workflow_id} for ${run.agent} failed: ${run.error ?? 'unknown error'}`
@@ -1942,7 +1951,12 @@ const workflowRunner = new WorkflowRunner({ execute: executeUnattendedRun, onCha
 // A task that runs a workflow is also recorded as a run of that workflow,
 // so the workflow's Recent runs shows its scheduled runs too.
 function fireScheduledTask(task: ScheduledTask, rawSessionId: string): ReturnType<typeof executeUnattendedRun> {
-  if (!task.workflow_id) return executeUnattendedRun(task.agent, task.message, rawSessionId)
+  if (!task.workflow_id) {
+    return executeUnattendedRun(task.agent, task.message, rawSessionId).then((outcome) => {
+      reportRun({ agent: task.agent, source: 'schedule', id: randomUUID(), usedTool: true })
+      return outcome
+    })
+  }
   return workflowRunner.runForSchedule({
     agent: task.agent,
     workflow_id: task.workflow_id,
@@ -1999,12 +2013,14 @@ async function handleSchedulesGet(res: ServerResponse, agentName: string): Promi
     if (!t.workflow_id) return t
     const workflow = workflows.find((w) => w.id === t.workflow_id)
     // Its start message as this task's runs see it, parameters filled in.
-    const startMessage = workflow && fillStartMessage(workflow.startMessage, t.params ?? {}, Object.keys(workflow.parameters))
-    return workflow ? { ...t, workflow: { id: workflow.id, title: workflow.title, start_message: startMessage } } : { ...t, workflow_missing: true }
+    // An older workflow's start message, else its instructions' first line.
+    const lead = workflow && (workflow.startMessage || workflow.instructions.split('\n').find((line) => line.trim()) || '')
+    const startMessage = workflow && fillStartMessage(lead!, t.params ?? {}, Object.keys(workflow.parameters))
+    return workflow ? { ...t, workflow: { id: workflow.id, title: workflow.title, description: workflow.description, start_message: startMessage } } : { ...t, workflow_missing: true }
   })
   scheduleJson(res, 200, {
     tasks,
-    workflows: workflows.map((w) => ({ id: w.id, title: w.title, description: w.description, start_message: w.startMessage, parameters: w.parameters })),
+    workflows: workflows.map((w) => ({ id: w.id, title: w.title, description: w.description, start_message: w.startMessage || w.instructions.split('\n').find((line) => line.trim()) || '', parameters: w.parameters })),
     time_zone: workspaceTimeZone(),
   })
 }
@@ -2917,6 +2933,19 @@ async function raceAndRespond(res: ServerResponse, agentName: string, rawSession
   res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(responseBody))
 }
 
+// Who sent a message, as a trusted proxy says in its signed identity:
+// an API key (role "api") or a signed-in person. Without a proxy, unknown.
+function messageCaller(req: IncomingMessage): 'api' | 'console' | 'unknown' {
+  const identity = trustedProxySecret ? verifyProxyIdentity(req.headers[TRUSTED_PROXY_IDENTITY_HEADER], trustedProxySecret) : undefined
+  if (!identity) return 'unknown'
+  return identity.role === 'api' ? 'api' : 'console'
+}
+
+// For a host's run observer (core/run-events.ts).
+function reportMessageRun(req: IncomingMessage, agent: string, newMessages: Message[]): void {
+  reportRun({ agent, source: 'message', id: randomUUID(), caller: messageCaller(req), usedTool: usedTool(newMessages) })
+}
+
 async function handleMessages(req: IncomingMessage, res: ServerResponse, agentName: string): Promise<void> {
   const parsed = await parseRequest(req, agentName)
   if (!parsed.ok) {
@@ -2982,6 +3011,7 @@ async function handleMessages(req: IncomingMessage, res: ServerResponse, agentNa
         pushSignal(state, { type: 'question', entry: question })
       },
     })
+    reportMessageRun(req, agentName, result.newMessages)
     if (result.pending) {
       await createCheckpointFromPending(agentName, tenant, rawSessionId, result.pending)
     }
@@ -3092,6 +3122,7 @@ async function handleMessagesStream(req: IncomingMessage, res: ServerResponse, a
         pushSignal(state, { type: 'question', entry: question })
       },
     })
+    reportMessageRun(req, agentName, result.newMessages)
     if (result.pending) {
       await createCheckpointFromPending(agentName, tenant, rawSessionId, result.pending)
     }
@@ -3963,7 +3994,7 @@ function jobDeps(agentName: string, entry: RegistryEntry, connector: MessagingCo
     connector,
     plan: process.env.LOOPENGINE_PLAN,
     allowed: (message) => jobAllowed(entry.config, app, message),
-    runTurn: (sessionId, text) => runJobTurn(agentName, sessionId, text),
+    runTurn: (sessionId, text) => runJobTurn(agentName, sessionId, text, connector.app === 'telegram' ? 'telegram' : 'slack'),
     decideLink: (pendingId, kind) => {
       const base = publicBaseUrl(connectionPublicUrl(entry.config, app))
       return base ? `${base}${decidePath(pendingId, kind)}` : undefined
@@ -3998,7 +4029,7 @@ function jobTurnOf(text: string, pending: PendingSummary[] | undefined): JobTurn
 }
 
 // One turn of a job thread: the same session for the whole thread.
-async function runJobTurn(agent: string, rawSessionId: string, message: string): Promise<JobTurn> {
+async function runJobTurn(agent: string, rawSessionId: string, message: string, source: 'slack' | 'telegram'): Promise<JobTurn> {
   const entry = getEntry(agent)
   if (!entry) throw new Error(`no agent named "${agent}" in this project`)
   const tenant = 'default'
@@ -4011,6 +4042,8 @@ async function runJobTurn(agent: string, rawSessionId: string, message: string):
       approver: threadApprover,
       questionHandler: threadQuestions,
     })
+    // For a host's run observer (core/run-events.ts).
+    reportRun({ agent, source, id: randomUUID(), usedTool: usedTool(result.newMessages) })
     if (result.pending) await createCheckpointFromPending(agent, tenant, rawSessionId, result.pending)
     return { newMessages: result.newMessages, result: { text: result.text, pending: pendingSummary(result.pending) } }
   })

package/template/package.json

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