@mongodb-js/agent-engine-runner-shared 0.11.3

package/dist/server/aer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Agent Execution Runtime (AER) server — framework-agnostic agent execution.
+ *
+ * Responsibilities:
+ * - Execute agents via the BaseAgent protocol (framework-neutral)
+ * - Use SecureToolWrapper for all tool/LLM calls through OE
+ * - Handle HITL via StreamEvent suspend/resume pattern
+ * - Report completion/suspension to OE via callback
+ *
+ * Mirrors Python's `AERServer` in `server/aer.py`.
+ */
+import type { FastifyInstance } from "fastify";
+import { BaseServer } from "./base.js";
+export declare class AERServer extends BaseServer {
+    private chunkSeq;
+    ownerCallbackUrl: Map<string, string>;
+    private callbackDelivery;
+    pendingSessionFinish: Set<string>;
+    private readonly durabilityOwnerId;
+    private capabilitiesAdvertised;
+    get modeName(): string;
+    onStartup(): Promise<void>;
+    /**
+     * Run pending one-shot OE registrations (capability advertise).
+     *
+     * Mirrors Python's `_ensure_oe_registrations`. Called from `onStartup` and
+     * defensively from `/execute` so agent work cannot run without a persisted
+     * declaration even if startup was bypassed.
+     */
+    private ensureOeRegistrations;
+    /** Push the current declaration to OE, failing startup if it is not accepted. */
+    private advertiseCapabilities;
+    onShutdown(): Promise<void>;
+    getHealthDetails(): Record<string, unknown>;
+    registerRoutes(app: FastifyInstance): void;
+    private handleExecute;
+    private doHandleExecute;
+    /**
+     * Ask OE to activate a fenced attempt, or return null for native routing.
+     *
+     * Null covers incomplete tenant identity, a framework that never registered
+     * a workflow adapter, and an old OE without workflow routes (bare 404). Any
+     * other failure propagates so the invocation fails closed rather than
+     * running unfenced.
+     */
+    private startDurableAttempt;
+    private sendStreamChunk;
+    private executeViaAgentStream;
+    private reportCallback;
+    /**
+     * Ask the OE to free this session's compute now that the turn is over.
+     *
+     * Called from the /execute route only after its response has been flushed,
+     * because the OE will kill this pod with zero grace. Wait for any retained
+     * terminal callback and queued Memory writes first so the finish request
+     * cannot destroy their only in-memory copies. Best-effort: a failure just
+     * leaves the pods to the idle sweep.
+     */
+    private releaseFinishedSession;
+}
+//# sourceMappingURL=aer.d.ts.map

package/dist/server/aer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aer.d.ts","sourceRoot":"","sources":["../../src/server/aer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAsE/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAgTvC,qBAAa,SAAU,SAAQ,UAAU;IACvC,OAAO,CAAC,QAAQ,CAAkC;IAOlD,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAClD,OAAO,CAAC,gBAAgB,CAA0B;IAGlD,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAG5D,OAAO,CAAC,sBAAsB,CAAS;IACvC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;YACW,qBAAqB;IASnC,iFAAiF;YACnE,qBAAqB;IAiE7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO3C,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAmG1C,OAAO,CAAC,aAAa,CAGnB;YAEY,eAAe;IAoqB7B;;;;;;;OAOG;YACW,mBAAmB;YAoBnB,eAAe;YA+Df,qBAAqB;YAoIrB,cAAc;IAmC5B;;;;;;;;OAQG;YACW,sBAAsB;CAyBrC"}