loopengine 0.3.2 → 0.3.4

package/dist/core/run-events.d.ts

@@ -0,0 +1,21 @@
+import type { Message } from './run-agent.js';
+export type RunEventSource = 'workflow' | 'schedule' | 'message' | 'slack' | 'telegram';
+export interface RunEvent {
+    at: string;
+    agent: string;
+    source: RunEventSource;
+    /** The same for every report of the same job. */
+    id: string;
+    /** workflow only: how the run started. */
+    via?: string;
+    /** message only. */
+    caller?: 'api' | 'console' | 'unknown';
+    usedTool: boolean;
+}
+export type RunObserver = (event: RunEvent) => void;
+/** Sets the one observer for this process; undefined removes it. */
+export declare function setRunObserver(next: RunObserver | undefined): void;
+/** Never throws: a broken observer must not fail the job. */
+export declare function reportRun(event: Omit<RunEvent, 'at'>): void;
+/** Whether a turn's new messages include a tool call by the agent. */
+export declare function usedTool(newMessages: Message[]): boolean;

package/dist/core/run-events.js

@@ -0,0 +1,20 @@
+let observer;
+/** Sets the one observer for this process; undefined removes it. */
+export function setRunObserver(next) {
+    observer = next;
+}
+/** Never throws: a broken observer must not fail the job. */
+export function reportRun(event) {
+    if (!observer)
+        return;
+    try {
+        observer({ ...event, at: new Date().toISOString() });
+    }
+    catch (err) {
+        console.error('[loopengine] run observer failed:', err instanceof Error ? err.message : err);
+    }
+}
+/** Whether a turn's new messages include a tool call by the agent. */
+export function usedTool(newMessages) {
+    return newMessages.some((m) => m.role === 'assistant' && Array.isArray(m.content) && m.content.some((b) => b.type === 'tool_use'));
+}

package/dist/index.d.ts

@@ -7,21 +7,25 @@ export { createAgentEnv, agentDirFor, envScopeOf, type EnvScope } from '#core/ag
 export { FileSecretStore, setSecretStore, getSecretStore, type SecretStore } from '#core/secret-store.js';
 export { signProxyIdentity, verifyProxyIdentity, TRUSTED_PROXY_IDENTITY_HEADER, type ProxyIdentity } from '#core/trusted-proxy.js';
 export { setUsageSink, recordUsage, type UsageEvent, type UsageSink } from '#core/usage.js';
+export { setRunObserver, reportRun, usedTool, type RunEvent, type RunEventSource, type RunObserver } from '#core/run-events.js';
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS, type NotifierFile, type MessagingApprover } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery, type NotifierDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';
 export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, setScheduledTaskNotify, deleteScheduledTask, nextScheduledWakeAt, moveScheduledTasksToTimeZone, importLegacyScheduledTasks, parseEvery, describeSchedule, type ScheduledTask, type ScheduledTaskRun, type ScheduledTaskStatus, type Schedule, type SchedulerStore, type FireTask, type CreateScheduledTaskInput } from '#core/scheduler.js';
 export { NOTIFIER_SLACK_SIGNING_SECRET_VAR } from '#core/notifier-file.js';
-export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval, type MessagingDeps, type MessagingDecision, type DecisionOutcome } from '#core/messaging/engine.js';
+export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval, outcomeText, type MessagingDeps, type MessagingDecision, type DecisionOutcome } from '#core/messaging/engine.js';
+export { handleJobMessage, isJobMessage, settleJobThread, jobSessionId, findJobFor, type JobDeps, type JobTurn } from '#core/messaging/jobs.js';
 export { formatArgs, formatChange, labelFor } from '#core/messaging/format-args.js';
 export { decideReply, proposeEdit, describeChange, type ReplyDecision, type DecisionRequest } from '#core/messaging/decide.js';
-export { recordThread, findThread, findThreadByPending, type ThreadLink } from '#core/messaging/threads.js';
+export { recordThread, findThread, findThreadByPending, recordJobThread, findJobThread, findJobThreadBySession, type ThreadLink, type JobThread } from '#core/messaging/threads.js';
 export type { InboundMessage, MessagingConnector, ThreadMessage, MessagingChoice, MessagingAction } from '#core/messaging/connector.js';
 export { parseSlackEvent, createSlackConnector, verifySlackRequest, parseSlackInteraction, openSlackAnswerModal, replyInSlack, replyPrivatelyInSlack, slackOutcomeText, listSlackChannels, listSlackChannelMembers, slackAppManifest, toSlackMrkdwn, slackArgs, slackEscape, type SlackEvent, type SlackInteraction, type SlackChannel } from '#core/messaging/connectors/slack/index.js';
 export { createDecisionToken, verifyDecisionToken, decidePath, decideLinkMaker, decisionLinkTtlMs, type DecisionKind } from '#core/approval-links.js';
 export { renderDecidePage, renderDecideGonePage, renderDecideInvalidPage, type DecidePageItem } from './web/decide-page.js';
-export { sendTestWebhook } from '#core/http-notify-triggers/webhook.js';
+export { sendTestWebhook, publicBaseUrl } from '#core/http-notify-triggers/webhook.js';
 export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, setAgentPrimaryNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, slackConversationsOn, slackClickAllowed, agentApprovers, setAgentApprovers, listAgentSlackMembers, listAgentSlackChannels, announceToNotifier, type DefaultWebhook } from './web/notifier-admin.js';
+export { clickAllowed, conversationsOn, jobsOn, jobAllowed, connectionPublicUrl, telegramCredentialsFor, telegramHomeChat, listAgentTelegramPeople, setupAgentTelegramWebhook, agentTelegramWebhookInfo, type TwoWayApp } from './web/notifier-admin.js';
+export { createTelegramConnector, parseTelegramUpdate, verifyTelegramRequest, telegramCallbackData, answerTelegramClick, editTelegramMessage, telegramBotUsername, setTelegramWebhook, telegramWebhookInfo, callTelegram, recordTelegramMessage, readTelegramThread, telegramRootOf, telegramPeople, toTelegramHtml, telegramEscape, telegramArgs, type TelegramUpdate, type TelegramButton, type TelegramPerson, } from '#core/messaging/connectors/telegram/index.js';
 export type * from './core/loop-events.js';
 export { streamMessage, streamMessageWithCallbacks, sendMessage, approveCall, denyCall, answerQuestion, getSessionHistory, } from './core/client.js';
 export type { RequestOptions, SendMessageResult, PendingApprovalResult, PendingQuestionResult, PendingResult, MessageResult, StreamMessageCallbacks, } from './core/client.js';

package/dist/index.js

@@ -9,20 +9,24 @@ export { createAgentEnv, agentDirFor, envScopeOf } from '#core/agent-env.js';
 export { FileSecretStore, setSecretStore, getSecretStore } from '#core/secret-store.js';
 export { signProxyIdentity, verifyProxyIdentity, TRUSTED_PROXY_IDENTITY_HEADER } from '#core/trusted-proxy.js';
 export { setUsageSink, recordUsage } from '#core/usage.js';
+export { setRunObserver, reportRun, usedTool } from '#core/run-events.js';
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';
 export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, setScheduledTaskNotify, deleteScheduledTask, nextScheduledWakeAt, moveScheduledTasksToTimeZone, importLegacyScheduledTasks, parseEvery, describeSchedule } from '#core/scheduler.js';
 export { NOTIFIER_SLACK_SIGNING_SECRET_VAR } from '#core/notifier-file.js';
-export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval } from '#core/messaging/engine.js';
+export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval, outcomeText } from '#core/messaging/engine.js';
+export { handleJobMessage, isJobMessage, settleJobThread, jobSessionId, findJobFor } from '#core/messaging/jobs.js';
 export { formatArgs, formatChange, labelFor } from '#core/messaging/format-args.js';
 export { decideReply, proposeEdit, describeChange } from '#core/messaging/decide.js';
-export { recordThread, findThread, findThreadByPending } from '#core/messaging/threads.js';
+export { recordThread, findThread, findThreadByPending, recordJobThread, findJobThread, findJobThreadBySession } from '#core/messaging/threads.js';
 export { parseSlackEvent, createSlackConnector, verifySlackRequest, parseSlackInteraction, openSlackAnswerModal, replyInSlack, replyPrivatelyInSlack, slackOutcomeText, listSlackChannels, listSlackChannelMembers, slackAppManifest, toSlackMrkdwn, slackArgs, slackEscape } from '#core/messaging/connectors/slack/index.js';
 export { createDecisionToken, verifyDecisionToken, decidePath, decideLinkMaker, decisionLinkTtlMs } from '#core/approval-links.js';
 export { renderDecidePage, renderDecideGonePage, renderDecideInvalidPage } from './web/decide-page.js';
-export { sendTestWebhook } from '#core/http-notify-triggers/webhook.js';
+export { sendTestWebhook, publicBaseUrl } from '#core/http-notify-triggers/webhook.js';
 export { describeAgentNotifier, saveAgentNotifier, removeAgentNotifier, setAgentPrimaryNotifier, testAgentNotifier, listAgentPending, slackCredentialsFor, slackConversationsOn, slackClickAllowed, agentApprovers, setAgentApprovers, listAgentSlackMembers, listAgentSlackChannels, announceToNotifier } from './web/notifier-admin.js';
+export { clickAllowed, conversationsOn, jobsOn, jobAllowed, connectionPublicUrl, telegramCredentialsFor, telegramHomeChat, listAgentTelegramPeople, setupAgentTelegramWebhook, agentTelegramWebhookInfo } from './web/notifier-admin.js';
+export { createTelegramConnector, parseTelegramUpdate, verifyTelegramRequest, telegramCallbackData, answerTelegramClick, editTelegramMessage, telegramBotUsername, setTelegramWebhook, telegramWebhookInfo, callTelegram, recordTelegramMessage, readTelegramThread, telegramRootOf, telegramPeople, toTelegramHtml, telegramEscape, telegramArgs, } from '#core/messaging/connectors/telegram/index.js';
 // The framework-agnostic browser client for adapters/http.ts's own wire
 // protocol (see client.ts's own header comment) — this, not a deep
 // subpath import, is how a consumer's React/Vue/etc. chat UI is meant to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",
@@ -46,6 +46,8 @@
     "dist/core/trusted-proxy.d.ts",
     "dist/core/usage.js",
     "dist/core/usage.d.ts",
+    "dist/core/run-events.js",
+    "dist/core/run-events.d.ts",
     "dist/core/email-senders.js",
     "dist/core/email-senders.d.ts",
     "dist/core/notifier-file.js",