@symbolica/agentica 0.2.11-rc

package/dist/src/warpc/rpc-channel/socket.js

@@ -0,0 +1,58 @@
+import { createLogger } from "../../logging/index.js";
+import { bytesToStr, strToBytes } from './utils.js';
+export class VirtualSocketForHandle {
+    readyState = 1;
+    onmessage = null;
+    onclose = null;
+    #running = true;
+    handle;
+    #logger;
+    constructor(handle, parentLogger) {
+        this.handle = handle;
+        this.#logger = parentLogger?.withScope('socket:virtual') ?? createLogger('socket:virtual');
+    }
+    send(data) {
+        try {
+            const bytes = strToBytes(data);
+            void this.handle.send_message(bytes);
+            this.#logger.debug(`Sent message (${bytes.length} bytes)`);
+        }
+        catch (error) {
+            this.#logger.error('Failed to send message', error);
+        }
+    }
+    close() {
+        this.#running = false;
+        this.#logger.debug('Socket closed');
+        return;
+    }
+    startReceiving() {
+        this.#startRecvLoop();
+    }
+    async #startRecvLoop() {
+        this.#logger.debug('Starting receive loop');
+        while (this.#running) {
+            try {
+                const bytes = await this.handle.recv_message();
+                this.#logger.debug(`Received ${bytes.length} bytes`);
+                const decoded = bytesToStr(bytes);
+                if (this.onmessage) {
+                    this.onmessage?.({ data: decoded });
+                }
+                else {
+                    this.#logger.warn('Received bytes before onmessage is set');
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && error.message === 'Queue closed') {
+                    this.#logger.debug('Receive loop ended (queue closed)');
+                }
+                else {
+                    this.#logger.debug('Receive loop ended because of an error', error);
+                }
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/src/warpc/rpc-channel/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../../src/warpc/rpc-channel/socket.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,YAAY,EAAE,4BAAuB;AAEjE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAYjD,MAAM,OAAO,sBAAsB;IAC/B,UAAU,GAAG,CAAC,CAAC;IACf,SAAS,GAA4C,IAAI,CAAC;IAC1D,OAAO,GAAwB,IAAI,CAAC;IACpC,QAAQ,GAAG,IAAI,CAAC;IAChB,MAAM,CAAI;IACV,OAAO,CAAe;IAEtB,YAAY,MAAS,EAAE,YAA2B;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,YAAY,EAAE,SAAS,CAAC,gBAAgB,CAAC,IAAI,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC,IAAY;QACb,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAc,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAED,KAAK;QACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpC,OAAO;IACX,CAAC;IAED,cAAc;QACV,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,cAAc;QAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACjB,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;gBAChE,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;oBAC7D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAc,CAAC,CAAC;gBACjF,CAAC;gBACD,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/src/warpc/rpc-channel/utils.d.ts

@@ -0,0 +1,6 @@
+import { Msg } from '@warpc/msg-protocol/kinds';
+export declare function msgToBytes(msg: Msg): Uint8Array;
+export declare function strToBytes(data: string): Uint8Array;
+export declare function bytesToMsg(bytes: Uint8Array): Msg;
+export declare function bytesToStr(bytes: Uint8Array): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/warpc/rpc-channel/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/warpc/rpc-channel/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAEhD,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAG/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAGjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD"}

package/dist/src/warpc/rpc-channel/utils.js

@@ -0,0 +1,15 @@
+export function msgToBytes(msg) {
+    const data = JSON.stringify(msg);
+    return strToBytes(data);
+}
+export function strToBytes(data) {
+    return new TextEncoder().encode(data);
+}
+export function bytesToMsg(bytes) {
+    const decoded = bytesToStr(bytes);
+    return JSON.parse(decoded);
+}
+export function bytesToStr(bytes) {
+    return new TextDecoder().decode(bytes);
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/warpc/rpc-channel/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/warpc/rpc-channel/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,GAAQ;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IACxC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IACxC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/src/warpc/runtime.d.ts

@@ -0,0 +1,36 @@
+import { type ScopedLogger } from '@logging/index';
+import { Frame, FrameTree } from './frame.js';
+import { UIDGenerator } from './frame-context/uid-gen.js';
+import { DefMsg } from './msg-protocol/concept/concept.js';
+import { FrameID, World } from './msg-protocol/kinds.js';
+import { ResponseMsg } from './msg-protocol/rpc/response-msg.js';
+import { FrameMuxSocket } from './rpc-channel/mux.js';
+export declare class FrameRuntime {
+    world: World;
+    remoteFrameCounter: FrameID;
+    localFrameTree: FrameTree;
+    remoteParents: Map<FrameID, FrameID>;
+    remoteChildren: Map<FrameID, Set<FrameID>>;
+    socket?: FrameMuxSocket;
+    uidGenerator: UIDGenerator;
+    logger: ScopedLogger;
+    uid: string | undefined;
+    iid: string | undefined;
+    createdAt: number;
+    private sentDefsByRemote;
+    constructor(world?: World, parentLogger?: ScopedLogger);
+    setUid(uid: string | undefined): void;
+    setIid(iid: string | undefined): void;
+    get elapsedTimeInSeconds(): number;
+    get rootFrame(): Frame;
+    get otherWorld(): World;
+    incrementRemoteFrameCounter(): FrameID;
+    newRemoteFrameForLocalRequest(localFrameID: FrameID): number;
+    newLocalFrameForRemoteRequest(localParentID: FrameID, requestedLocalID: FrameID, requestingRemoteID: FrameID): Frame;
+    returnFromRemoteFrame(localID: FrameID, remoteID: FrameID): void;
+    returnContextFromLocalFrame(localID: FrameID, response: ResponseMsg): DefMsg[];
+    private getOrInitSentSet;
+    filterUnsentLocalDefs(remoteFID: FrameID, defs: DefMsg[]): DefMsg[];
+    markDefsSent(remoteFID: FrameID, defs: DefMsg[]): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/warpc/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/warpc/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAc,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAW,KAAK,EAAmB,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAkB,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,qBAAa,YAAY;IACd,KAAK,EAAE,KAAK,CAAC;IACb,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,SAAS,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAa;IACjD,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAa;IACvD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAGzB,OAAO,CAAC,gBAAgB,CAAwC;gBAEpD,KAAK,GAAE,KAAoB,EAAE,YAAY,CAAC,EAAE,YAAY;IAapE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAI9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAI9B,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,IAAI,SAAS,IAAI,KAAK,CAErB;IAED,IAAI,UAAU,IAAI,KAAK,CAEtB;IAED,2BAA2B,IAAI,OAAO;IAStC,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM;IAa5D,6BAA6B,CACzB,aAAa,EAAE,OAAO,EACtB,gBAAgB,EAAE,OAAO,EACzB,kBAAkB,EAAE,OAAO,GAC5B,KAAK;IAqBR,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAYhE,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,EAAE;IAoD9E,OAAO,CAAC,gBAAgB;IASxB,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAanE,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;CAMzD"}

package/dist/src/warpc/runtime.js

@@ -0,0 +1,153 @@
+import { createLogger } from "../logging/index.js";
+import { Frame, FrameTree } from './frame.js';
+import { UIDGenerator } from './frame-context/uid-gen.js';
+import { RPCKind, World, defnUidToString } from './msg-protocol/kinds.js';
+const ROOT_FRAME_ID = 0;
+export class FrameRuntime {
+    world;
+    remoteFrameCounter;
+    localFrameTree;
+    remoteParents = new Map();
+    remoteChildren = new Map();
+    socket;
+    uidGenerator;
+    logger;
+    uid;
+    iid;
+    createdAt;
+    sentDefsByRemote = new Map();
+    constructor(world = World.Client, parentLogger) {
+        this.world = world;
+        this.logger = parentLogger?.withScope(`runtime`) ?? createLogger(`runtime`);
+        this.remoteFrameCounter = ROOT_FRAME_ID;
+        this.remoteParents.set(ROOT_FRAME_ID, ROOT_FRAME_ID);
+        this.remoteChildren.set(ROOT_FRAME_ID, new Set());
+        this.uidGenerator = new UIDGenerator(this.world);
+        this.localFrameTree = new FrameTree();
+        this.localFrameTree.push(undefined, new Frame(this, ROOT_FRAME_ID));
+        this.logger.debug(`Initialized runtime with root frame ${ROOT_FRAME_ID}`);
+        this.createdAt = Date.now();
+    }
+    setUid(uid) {
+        this.uid = uid;
+    }
+    setIid(iid) {
+        this.iid = iid;
+    }
+    get elapsedTimeInSeconds() {
+        return (Date.now() - this.createdAt) / 1000;
+    }
+    get rootFrame() {
+        return this.localFrameTree.frames.get(ROOT_FRAME_ID);
+    }
+    get otherWorld() {
+        return this.world === World.Client ? World.Server : World.Client;
+    }
+    incrementRemoteFrameCounter() {
+        return ++this.remoteFrameCounter;
+    }
+    newRemoteFrameForLocalRequest(localFrameID) {
+        const remoteFrameId = this.incrementRemoteFrameCounter();
+        let remoteRequests = this.remoteChildren.get(localFrameID);
+        if (!remoteRequests) {
+            remoteRequests = new Set();
+            this.remoteChildren.set(localFrameID, remoteRequests);
+        }
+        remoteRequests.add(remoteFrameId);
+        this.logger.debug(`New remote frame ${remoteFrameId} for local ${localFrameID}`);
+        return remoteFrameId;
+    }
+    newLocalFrameForRemoteRequest(localParentID, requestedLocalID, requestingRemoteID) {
+        const localParentFrame = this.localFrameTree.frames.get(localParentID);
+        if (!localParentFrame) {
+            this.logger.error(`Unknown parent frame ${localParentID}`);
+            throw new Error('Unknown parent frame');
+        }
+        this.remoteParents.set(requestedLocalID, requestingRemoteID);
+        this.remoteChildren.set(requestedLocalID, new Set([]));
+        const newFrame = new Frame(this, requestedLocalID, localParentFrame);
+        this.localFrameTree.push(localParentID, newFrame);
+        this.logger.debug(`New local frame ${requestedLocalID} (parent=${localParentID}, remote=${requestingRemoteID})`);
+        return newFrame;
+    }
+    returnFromRemoteFrame(localID, remoteID) {
+        const children = this.remoteChildren.get(localID);
+        if (!children || !children.has(remoteID)) {
+            this.logger.error(`Trying to return from unknown remote frame ${remoteID}`);
+            throw new Error('Trying to return from unknown remote frame');
+        }
+        children.delete(remoteID);
+        this.logger.debug(`Returned from remote frame ${remoteID} (local=${localID})`);
+    }
+    returnContextFromLocalFrame(localID, response) {
+        const span = this.logger.startSpan(`returnFromLocalFrame-${localID}`);
+        try {
+            const localFrame = this.localFrameTree.frames.get(localID);
+            if (!localFrame) {
+                this.logger.error(`Trying to return from unknown local frame ${localID}`);
+                throw new Error('Trying to return from unknown local frame');
+            }
+            const outstanding = this.remoteChildren.get(localID);
+            if (outstanding && outstanding.size > 1) {
+                this.logger.error(`Returning from local frame ${localID} with ${outstanding.size} outstanding remote frames`);
+                throw new Error('Returning from local frame with outstanding remote frames');
+            }
+            const new_defs = [];
+            switch (response.kind) {
+                case RPCKind.Response.Ok:
+                    this.logger.debug(`Frame ${localID} returned OK`);
+                    break;
+                case RPCKind.Response.Err: {
+                    this.logger.warn(`Frame ${localID} returned an error with the following payload:`, response.payload.error);
+                    break;
+                }
+                case RPCKind.Response.Res: {
+                    const result = response.payload.result;
+                    localFrame.parentFrame?.passContextFromOtherFrame(localFrame, result, new_defs);
+                    this.logger.debug(`Frame ${localID} returned result with ${new_defs.length} new defs`);
+                    span.setAttribute('new_defs_count', new_defs.length);
+                    break;
+                }
+            }
+            this.localFrameTree.pop(localID);
+            this.remoteParents.delete(localID);
+            this.remoteChildren.delete(localID);
+            return new_defs;
+        }
+        catch (error) {
+            span.recordException(error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+    getOrInitSentSet(remoteFID) {
+        let set = this.sentDefsByRemote.get(remoteFID);
+        if (!set) {
+            set = new Set();
+            this.sentDefsByRemote.set(remoteFID, set);
+        }
+        return set;
+    }
+    filterUnsentLocalDefs(remoteFID, defs) {
+        const sent = this.getOrInitSentSet(remoteFID);
+        const filtered = [];
+        for (const def of defs) {
+            if (def.uid.world !== this.world)
+                continue;
+            const key = defnUidToString(def.uid);
+            if (sent.has(key))
+                continue;
+            filtered.push(def);
+        }
+        return filtered;
+    }
+    markDefsSent(remoteFID, defs) {
+        const sent = this.getOrInitSentSet(remoteFID);
+        for (const def of defs) {
+            sent.add(defnUidToString(def.uid));
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/warpc/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/warpc/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,YAAY,EAAE,yBAAuB;AAEjE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAW,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIhF,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,OAAO,YAAY;IACd,KAAK,CAAQ;IACb,kBAAkB,CAAU;IAC5B,cAAc,CAAY;IAC1B,aAAa,GAA0B,IAAI,GAAG,EAAE,CAAC;IACjD,cAAc,GAA+B,IAAI,GAAG,EAAE,CAAC;IACvD,MAAM,CAAkB;IACxB,YAAY,CAAe;IAC3B,MAAM,CAAe;IACrB,GAAG,CAAqB;IACxB,GAAG,CAAqB;IACxB,SAAS,CAAS;IAGjB,gBAAgB,GAA8B,IAAI,GAAG,EAAE,CAAC;IAEhE,YAAY,QAAe,KAAK,CAAC,MAAM,EAAE,YAA2B;QAChE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5E,IAAI,CAAC,kBAAkB,GAAG,aAAa,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,IAAI,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,GAAuB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAuB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED,IAAI,oBAAoB;QACpB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAChD,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;IAC1D,CAAC;IAED,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACrE,CAAC;IAED,2BAA2B;QACvB,OAAO,EAAE,IAAI,CAAC,kBAAkB,CAAC;IACrC,CAAC;IAOD,6BAA6B,CAAC,YAAqB;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACzD,IAAI,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,cAAc,GAAG,IAAI,GAAG,EAAW,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAC1D,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,aAAa,cAAc,YAAY,EAAE,CAAC,CAAC;QACjF,OAAO,aAAa,CAAC;IACzB,CAAC;IAGD,6BAA6B,CACzB,aAAsB,EACtB,gBAAyB,EACzB,kBAA2B;QAE3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,aAAa,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QAC7D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,mBAAmB,gBAAgB,YAAY,aAAa,YAAY,kBAAkB,GAAG,CAChG,CAAC;QACF,OAAO,QAAQ,CAAC;IACpB,CAAC;IAOD,qBAAqB,CAAC,OAAgB,EAAE,QAAiB;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAClE,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,WAAW,OAAO,GAAG,CAAC,CAAC;IACnF,CAAC;IAID,2BAA2B,CAAC,OAAgB,EAAE,QAAqB;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;gBAC1E,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,8BAA8B,OAAO,SAAS,WAAW,CAAC,IAAI,4BAA4B,CAC7F,CAAC;gBACF,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE;oBACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,OAAO,cAAc,CAAC,CAAC;oBAClD,MAAM;gBACV,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,SAAS,OAAO,gDAAgD,EAC/D,QAAmB,CAAC,OAAO,CAAC,KAAK,CACrC,CAAC;oBACF,MAAM;gBACV,CAAC;gBACD,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;oBACxB,MAAM,MAAM,GAAgB,QAAmB,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC/D,UAAU,CAAC,WAAW,EAAE,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAChF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,OAAO,yBAAyB,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;oBACvF,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACrD,MAAM;gBACV,CAAC;YACL,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,QAAQ,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;IACL,CAAC;IAMO,gBAAgB,CAAC,SAAkB;QACvC,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;YACxB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,qBAAqB,CAAC,SAAkB,EAAE,IAAc;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YAErB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,SAAS;YAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,YAAY,CAAC,SAAkB,EAAE,IAAc;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ"}

package/dist-transformer/agentica/agent.d.ts

@@ -0,0 +1,81 @@
+import { CompiledConceptContext } from '../transformer/processor/processor-utils.js';
+import { Chunk, MaxTokens, ModelStrings, ToolModeStrings, Usage } from './common.js';
+import { type Template } from './template.js';
+import { Agentica } from '../agentica-client/index.js';
+export { Usage } from './common.js';
+export type AgentSpawnCtx = {
+    siteId: string;
+    concepts?: CompiledConceptContext;
+};
+export type AgentSpawnConfig = {
+    model?: ModelStrings;
+    premise?: string;
+    system?: string | Template;
+    listener?: (iid: string, chunk: Chunk) => void;
+    mode?: ToolModeStrings;
+    maxTokens?: number | MaxTokens;
+    client?: Agentica;
+};
+export declare function spawn(config: AgentSpawnConfig & {
+    system: string | Template;
+    premise?: never;
+}, scope?: object): Promise<Agent>;
+export declare function spawn(config: AgentSpawnConfig & {
+    system?: never;
+    premise: string;
+}, scope?: object): Promise<Agent>;
+export declare function spawn(config: AgentSpawnConfig & {
+    system?: never;
+    premise?: never;
+}, scope?: object): Promise<Agent>;
+export declare function spawnTransformation(ctx: AgentSpawnCtx, config: AgentSpawnConfig): Promise<Agent>;
+export type AgentCallCtx = {
+    concepts: CompiledConceptContext;
+    siteId: string;
+    siteOutputType: string;
+    docString: string;
+};
+export type AgentCallConfig = {
+    listener?: (iid: string, chunk: Chunk) => void;
+    parentCallId?: string;
+};
+export declare class Agent implements AsyncDisposable {
+    private uid;
+    private iid;
+    private onCallComplete;
+    private ctx;
+    private config;
+    private runtime?;
+    private sessionManager?;
+    private mode;
+    private logger;
+    private lastIid;
+    private lastTotal;
+    private usages;
+    constructor(ctx: AgentSpawnCtx, config: AgentSpawnConfig);
+    initialize(): Promise<void>;
+    call<T>(userPrompt: string | Template, scope?: object, config?: AgentCallConfig): Promise<T>;
+    callPro<T>(userPromptParts: TemplateStringsArray, ...scope: any[]): (config?: AgentCallConfig) => Promise<T>;
+    setOnCallComplete(onCallComplete: (iid: string | undefined) => void): void;
+    getUid(): string;
+    getCurrentCallIid(): string | undefined;
+    /**
+     * Get the usage for the last invocation.
+     * @throws Error if no invocation has been made yet or usage not found
+     */
+    lastUsage(): Usage;
+    /**
+     * Get the total usage across all invocations.
+     */
+    totalUsage(): Usage;
+    /**
+     * Manually close the agent and clean up resources
+     */
+    close(): Promise<void>;
+    /**
+     * AsyncDisposable implementation for "await using" syntax
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    callTransformation<T>(ctx: AgentCallCtx, prompt: string | Template, config?: AgentCallConfig): Promise<T>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist-transformer/agentica/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agentica/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAGhF,OAAO,EAGH,KAAK,EACL,SAAS,EACT,YAAY,EAEZ,eAAe,EACf,KAAK,EAKR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAIF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/C,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAGF,wBAAsB,KAAK,CACvB,MAAM,EAAE,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,EACzE,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC,CAAC;AAElB,wBAAsB,KAAK,CACvB,MAAM,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC,CAAC;AAElB,wBAAsB,KAAK,CACvB,MAAM,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,EAC9D,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC,CAAC;AAOlB,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAItG;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,qBAAa,KAAM,YAAW,eAAe;IACzC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,cAAc,CAAoC;IAE1D,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAuB;IAC9C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,MAAM,CAAkC;IAGhD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,MAAM,CAAiC;gBAEnC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB;IAclD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IASlG,OAAO,CAAC,CAAC,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC;IAM5G,iBAAiB,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI;IAI1E,MAAM,IAAI,MAAM;IAIhB,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC;;;OAGG;IACH,SAAS,IAAI,KAAK;IAWlB;;OAEG;IACH,UAAU,IAAI,KAAK;IAQnB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;CAuFlH"}

package/dist-transformer/agentica/agent.js

@@ -0,0 +1,185 @@
+import { createLogger } from '../logging/index.js';
+import { MaxTokens, Usage, createAgentEnvironment, invokeAgent, serveRequestsUntilResult, startEchoStream, } from './common.js';
+import { maybePromptTemplate } from './template.js';
+import { throwNoJsonMode } from '../coming-soon.js';
+// Re-export Usage for convenience
+export { Usage } from './common.js';
+let AGENT_COUNTER = 0;
+export async function spawn(config, scope) {
+    void config;
+    void scope;
+    throw new Error('Run the transformation before calling spawn');
+}
+export async function spawnTransformation(ctx, config) {
+    const agent = new Agent(ctx, config);
+    await agent.initialize();
+    return agent;
+}
+export class Agent {
+    constructor(ctx, config) {
+        this.usages = new Map();
+        this.ctx = ctx;
+        this.config = config;
+        this.mode = config.mode ?? 'code';
+        if (this.mode === 'json') {
+            throwNoJsonMode();
+        }
+        this.uid = ''; // set using initialize
+        this.iid = undefined; // no call yet
+        this.onCallComplete = () => { }; // no-op
+        this.logger = createLogger(`agent:${AGENT_COUNTER}`);
+        AGENT_COUNTER++;
+    }
+    async initialize() {
+        const initConfig = {
+            persist: true,
+            streaming: !!this.config.listener,
+            model: this.config.model,
+            system: maybePromptTemplate(this.config.system),
+            premise: this.config.premise,
+            siteId: this.ctx.siteId,
+            mode: this.mode,
+            maxTokens: MaxTokens.fromMaxTokens(this.config.maxTokens),
+            concepts: this.ctx.concepts,
+            client: this.config.client,
+        };
+        const { uid, runtime, sessionManager } = await createAgentEnvironment(initConfig, this.logger);
+        this.uid = uid;
+        this.runtime = runtime;
+        this.sessionManager = sessionManager;
+        this.logger.debug(`Agent initialized: ${this.uid}`);
+    }
+    // my_result = myAgent.call("Return the sum of obj1 and obj2", {obj1, obj2})
+    // my_result = myAgent.call("Return the sum of obj1 and obj2", {obj1, obj2}, { echo: (iid, chunk) => {...} })
+    async call(userPrompt, scope, config) {
+        void userPrompt;
+        void scope;
+        void config;
+        throw new Error('Run the transformation before calling call');
+    }
+    // my_result = myAgent.callPro`Return the sum of ${obj1} and ${obj2}`()
+    // my_result = myAgent.callPro`Return the sum of ${obj1} and ${obj2}`(config)
+    callPro(userPromptParts, ...scope) {
+        void userPromptParts;
+        void scope;
+        throw new Error('Run the transformation before calling callPro');
+    }
+    setOnCallComplete(onCallComplete) {
+        this.onCallComplete = onCallComplete;
+    }
+    getUid() {
+        return this.uid;
+    }
+    getCurrentCallIid() {
+        return this.iid;
+    }
+    /**
+     * Get the usage for the last invocation.
+     * @throws Error if no invocation has been made yet or usage not found
+     */
+    lastUsage() {
+        if (!this.lastIid) {
+            throw new Error('No invocation has been made yet');
+        }
+        const usage = this.usages.get(this.lastIid);
+        if (!usage) {
+            throw new Error(`Usage not found for invocation ${this.lastIid}`);
+        }
+        return usage;
+    }
+    /**
+     * Get the total usage across all invocations.
+     */
+    totalUsage() {
+        let total = Usage.zero();
+        for (const usage of this.usages.values()) {
+            total = total.add(usage);
+        }
+        return total;
+    }
+    /**
+     * Manually close the agent and clean up resources
+     */
+    async close() {
+        if (!this.uid || !this.sessionManager) {
+            this.logger.debug('Agent not initialized, nothing to close');
+            return;
+        }
+        this.logger.debug(`Manually closing agent ${this.uid.slice(0, 8)}`);
+        // Close local resources
+        await this.sessionManager.closeAgent(this.uid);
+        // Clear references to help GC
+        this.runtime = undefined;
+    }
+    /**
+     * AsyncDisposable implementation for "await using" syntax
+     */
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    async callTransformation(ctx, prompt, config) {
+        const span = this.logger.startSpan('agentCallTransformation');
+        try {
+            // Check initialized
+            if (!this.uid || !this.runtime || !this.sessionManager) {
+                throw new Error('Agent not initialized. Call initialize first!');
+            }
+            // Invoke agent with call-time concepts (spawn concepts already sent during initialization)
+            const invokeConfig = {
+                uid: this.uid,
+                concepts: ctx.concepts,
+                siteId: ctx.siteId,
+                siteOutputType: ctx.siteOutputType,
+                prompt: maybePromptTemplate(prompt),
+                streaming: !!config?.listener || !!this.config.listener,
+                parentCallId: config?.parentCallId,
+            };
+            const { handle } = await invokeAgent(invokeConfig, this.mode, this.logger, this.sessionManager, this.runtime);
+            this.iid = handle.iid;
+            let cancelStream;
+            // If echo callback is provided, iterate over stream and call the callback
+            if (config?.listener || this.config.listener) {
+                cancelStream = new AbortController();
+                const echoCallback = config?.listener || this.config.listener; // Prioritize per-site config
+                // Start streaming in parallel with serving response
+                startEchoStream(this.sessionManager, cancelStream.signal, this.uid, handle.iid, echoCallback, this.logger);
+            }
+            // Serve response
+            const serveConfig = {
+                runtime: this.runtime,
+                handle,
+                siteOutputType: ctx.siteOutputType,
+            };
+            const result = (await Promise.race([
+                serveRequestsUntilResult(serveConfig, this.logger),
+                handle.exception,
+            ]));
+            if (cancelStream) {
+                cancelStream.abort(); // Cancel the streaming loop after result is returned
+            }
+            return result;
+        }
+        catch (error) {
+            span.recordException(error);
+            throw error;
+        }
+        finally {
+            // Fetch usage for this invocation
+            if (this.iid && this.sessionManager) {
+                try {
+                    const { usage, newTotal } = await this.sessionManager.fetchUsage(this.uid, this.iid, this.lastTotal);
+                    this.usages.set(this.iid, usage);
+                    this.lastIid = this.iid;
+                    this.lastTotal = newTotal;
+                }
+                catch (e) {
+                    this.logger.warn('Failed to fetch usage', e);
+                }
+            }
+            this.onCallComplete(this.iid);
+            this.iid = undefined;
+            this.runtime?.setIid(undefined);
+            span.end();
+        }
+    }
+}

package/dist-transformer/agentica/agentic.d.ts

@@ -0,0 +1,36 @@
+import { CompiledConceptContext } from '../transformer/processor/processor-utils.js';
+import { Chunk, MaxTokens, ModelStrings, ToolModeStrings, Usage } from './common.js';
+import { type Template } from './template.js';
+export { Usage } from './common.js';
+export type AgenticContext = {
+    concepts: CompiledConceptContext;
+    siteId: string;
+    siteOutputType: string;
+    docString: string;
+};
+export type AgenticConfig = {
+    model?: ModelStrings;
+    premise?: string;
+    system?: string | Template;
+    listener?: (iid: string, chunk: Chunk) => void;
+    /** Callback to receive usage statistics after the agentic function completes */
+    onUsage?: (usage: Usage) => void;
+    mode?: ToolModeStrings;
+    maxTokens?: MaxTokens | number;
+    parentCallId?: string;
+};
+export declare function agentic<T>(userPrompt: string, scope?: object, config?: AgenticConfig & {
+    system: string | Template;
+    premise?: never;
+}): Promise<T>;
+export declare function agentic<T>(userPrompt: string, scope?: object, config?: AgenticConfig & {
+    system?: never;
+    premise: string;
+}): Promise<T>;
+export declare function agentic<T>(userPrompt: string, scope?: object, config?: AgenticConfig & {
+    system?: never;
+    premise?: never;
+}): Promise<T>;
+export declare function agenticPro<T>(userPromptParts: TemplateStringsArray, ...scope: any[]): (config?: AgenticConfig) => Promise<T>;
+export declare function agenticTransformation<T = any>(ctx: AgenticContext, prompt: string, config?: AgenticConfig): Promise<T>;
+//# sourceMappingURL=agentic.d.ts.map

package/dist-transformer/agentica/agentic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic.d.ts","sourceRoot":"","sources":["../../src/agentica/agentic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAGH,KAAK,EACL,SAAS,EACT,YAAY,EAEZ,eAAe,EACf,KAAK,EAKR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAKhE,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/C,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAGF,wBAAsB,OAAO,CAAC,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GACxE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEd,wBAAsB,OAAO,CAAC,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,CAAC,CAAC,CAAC;AAEd,wBAAsB,OAAO,CAAC,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GAC7D,OAAO,CAAC,CAAC,CAAC,CAAC;AAQd,wBAAgB,UAAU,CAAC,CAAC,EACxB,eAAe,EAAE,oBAAoB,EACrC,GAAG,KAAK,EAAE,GAAG,EAAE,GAChB,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAIxC;AAED,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAC/C,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CAwFZ"}