loopengine 0.3.3 → 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,6 +7,7 @@ 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';

package/dist/index.js

@@ -9,6 +9,7 @@ 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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.3.3",
+  "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",