@agent-relay/agent 0.1.0

package/dist/dispatcher.js

@@ -0,0 +1,101 @@
+import { withBurnTags } from './burn.js';
+/**
+ * Creates the single-handler dispatcher that enforces local concurrency limits.
+ */
+export function createDispatcher(options) {
+    const concurrency = Math.max(1, options.concurrency);
+    const queue = [];
+    const active = new Set();
+    const controllers = new Set();
+    let closed = false;
+    const pump = () => {
+        if (closed && queue.length > 0) {
+            while (queue.length > 0) {
+                const queued = queue.shift();
+                queued?.reject(new Error('Dispatcher closed'));
+            }
+            return;
+        }
+        while (active.size < concurrency && queue.length > 0) {
+            const next = queue.shift();
+            if (!next) {
+                break;
+            }
+            const task = runItem(next);
+            active.add(task);
+            void task.finally(() => {
+                active.delete(task);
+                pump();
+            });
+        }
+    };
+    const runItem = async (item) => {
+        const controller = new AbortController();
+        controllers.add(controller);
+        const timeout = setTimeout(() => {
+            controller.abort(new Error('Handler timed out'));
+        }, options.handlerTimeoutMs);
+        try {
+            const ctx = options.createContext(controller.signal, item.event);
+            await dispatchToHandler(ctx, item.event, options.onEvent, controller.signal);
+            item.resolve();
+        }
+        catch (error) {
+            item.reject(error);
+        }
+        finally {
+            clearTimeout(timeout);
+            controllers.delete(controller);
+        }
+    };
+    return {
+        dispatch(event) {
+            if (closed) {
+                return Promise.reject(new Error('Dispatcher closed'));
+            }
+            return new Promise((resolve, reject) => {
+                queue.push({ event, resolve, reject });
+                pump();
+            });
+        },
+        close() {
+            closed = true;
+            pump();
+        },
+        abortActive(reason) {
+            for (const controller of controllers) {
+                controller.abort(reason);
+            }
+        },
+        async drain(timeoutMs) {
+            const deadline = Date.now() + timeoutMs;
+            while ((queue.length > 0 || active.size > 0) && Date.now() < deadline) {
+                await new Promise((resolve) => {
+                    setTimeout(resolve, 25);
+                });
+            }
+            return queue.length === 0 && active.size === 0;
+        },
+    };
+}
+async function dispatchToHandler(ctx, event, handler, signal) {
+    if (signal.aborted) {
+        throw signal.reason instanceof Error ? signal.reason : new Error('Handler aborted');
+    }
+    const abortPromise = new Promise((_, reject) => {
+        signal.addEventListener('abort', () => {
+            reject(signal.reason instanceof Error ? signal.reason : new Error('Handler aborted'));
+        }, { once: true });
+    });
+    await withBurnTags({
+        workspace: ctx.workspace,
+        agentId: ctx.agentId,
+        eventType: event.type,
+        eventId: event.id,
+        occurredAt: event.occurredAt,
+    }, async () => {
+        const handlerPromise = Promise.resolve(handler(ctx, event));
+        await Promise.race([handlerPromise, abortPromise]);
+    });
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { NoRetry, relayfileTools } from '@agent-relay/events';
+import { deployAgent } from './deploy.js';
+import type { AgentDefinition, AgentHandle } from './types.js';
+/**
+ * Registers and runs a proactive agent using the layered runtime SDK.
+ */
+export declare function agent(definition: AgentDefinition): AgentHandle;
+/**
+ * Re-exported for callers that want relayfile-compatible tools next to `agent()`.
+ */
+export { NoRetry, relayfileTools, deployAgent };
+export type { AgentDefinition, AgentHandle, AgentOptions, AgentPolicy, AgentPolicyMode, AgentProviderConfig, CoalesceMissedTicksMode, Context, DeployHandle, FileSummary, HostedAgentDefinition, HostedAgentHandler, HostedAgentStatus, Logger, LogFields, PostOpts, ReplayOnStart, RelaycastClient, RelaycronClient, RelaycronScheduleDefinition, RelaycronScheduleHandle, RelayfileClient, ScheduleSpec, WorkspaceFile, WriteMeta, } from './types.js';
+export type { AgentEvent, ChangeEvent, CronTickEvent, EventType, Expansion, ExpansionLevel, RelaycastMessageEvent, RelayfileChangeEvent, StartupEvent, } from '@agent-relay/events';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,OAAO,EACP,cAAc,EAWf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EAuBZ,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAiJ9D;AAED;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAEhD,YAAY,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,OAAO,EACP,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,EACN,SAAS,EACT,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,GACb,MAAM,qBAAqB,CAAC"}