@parall/agent-core 1.13.1

package/dist/dispatch-adapter.d.ts

@@ -0,0 +1,79 @@
+import type { ParallClient } from "@parall/sdk";
+import type { ParallEvent } from "./types.js";
+export type GatewayLogger = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export type DispatchContext = {
+    accountId: string;
+    apiUrl: string;
+    apiKey: string;
+    orgId: string;
+    agentUserId: string;
+    runtimeType: string;
+    runtimeKey: string;
+    sessionId?: string;
+    chatId?: string;
+    triggerMessageId?: string;
+    noReply: boolean;
+    stepIdFilePath?: string;
+    client: ParallClient;
+    log?: GatewayLogger;
+};
+export type RuntimeEvent = {
+    type: "thinking";
+    text: string;
+    groupKey?: string;
+} | {
+    type: "tool_call";
+    callId: string;
+    toolName: string;
+    input: unknown;
+    startedAt?: string;
+    groupKey?: string;
+} | {
+    type: "tool_result";
+    callId: string;
+    toolName: string;
+    output: string;
+    error?: string;
+    durationMs?: number;
+    groupKey?: string;
+} | {
+    type: "text";
+    text: string;
+    project?: boolean;
+    groupKey?: string;
+} | {
+    type: "error";
+    message: string;
+};
+export type DispatchOpts = {
+    event: ParallEvent;
+    earlierEvents?: ParallEvent[];
+    bodyForAgent: string;
+    sessionKey: string;
+    context: DispatchContext;
+};
+export type ForkSessionHandle = {
+    sessionKey: string;
+    [key: string]: unknown;
+};
+export type ForkOpts = {
+    sessionKey: string;
+    context: DispatchContext;
+};
+export type CleanupForkOpts = {
+    fork: ForkSessionHandle;
+    context: DispatchContext;
+};
+export interface DispatchAdapter {
+    /** Dispatch a Parall event to the runtime and emit normalized runtime events. */
+    dispatch(opts: DispatchOpts): AsyncIterable<RuntimeEvent>;
+    /** Fork the current runtime session for concurrent handling. Return null to buffer on main. */
+    forkSession?(opts: ForkOpts): Promise<ForkSessionHandle | null> | ForkSessionHandle | null;
+    /** Clean up a fork session created by forkSession(). */
+    cleanupFork?(opts: CleanupForkOpts): Promise<void> | void;
+}
+//# sourceMappingURL=dispatch-adapter.d.ts.map

package/dist/dispatch-adapter.d.ts.map

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

package/dist/dispatch-adapter.js

@@ -0,0 +1 @@
+export {};

package/dist/event-format.d.ts

@@ -0,0 +1,4 @@
+import type { ForkResult, ParallEvent } from "./types.js";
+export declare function buildEventBody(event: ParallEvent): string;
+export declare function buildForkResultPrefix(results: ForkResult[]): string;
+//# sourceMappingURL=event-format.d.ts.map

package/dist/event-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0BzD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CASnE"}

package/dist/event-format.js

@@ -0,0 +1,42 @@
+export function buildEventBody(event) {
+    const lines = [];
+    if (event.type === "message") {
+        lines.push(`[Event: message.new]`);
+        const chatLabel = event.targetName
+            ? `"${event.targetName}" (${event.targetId})`
+            : event.targetId;
+        lines.push(`[Chat: ${chatLabel} | type: ${event.targetType ?? "unknown"}]`);
+        lines.push(`[From: ${event.senderName} (${event.senderId})]`);
+        lines.push(`[Message ID: ${event.messageId}]`);
+        if (event.threadRootId)
+            lines.push(`[Thread: ${event.threadRootId}]`);
+        if (event.noReply)
+            lines.push(`[Hint: no_reply]`);
+        if (event.mediaFields?.MediaUrl) {
+            lines.push(`[Attachment: ${event.mediaFields.MediaType ?? "file"} ${event.mediaFields.MediaUrl}]`);
+        }
+        lines.push("", event.body);
+    }
+    else {
+        lines.push(`[Event: task.assigned]`);
+        const taskLabel = event.targetName
+            ? `${event.targetName} (${event.targetId})`
+            : event.targetId;
+        lines.push(`[Task: ${taskLabel} | type: ${event.targetType ?? "task"}]`);
+        lines.push(`[Assigned by: ${event.senderName} (${event.senderId})]`);
+        lines.push("", event.body);
+    }
+    return lines.join("\n");
+}
+export function buildForkResultPrefix(results) {
+    if (!results.length)
+        return "";
+    const blocks = results.map((result) => {
+        const lines = [`[Fork result]`];
+        lines.push(`[Handled: ${result.sourceEvent.type} — ${result.sourceEvent.summary}]`);
+        if (result.actions.length)
+            lines.push(`[Actions: ${result.actions.join("; ")}]`);
+        return lines.join("\n");
+    });
+    return blocks.join("\n\n") + "\n\n---\n\n";
+}

package/dist/gateway-base.d.ts

@@ -0,0 +1,69 @@
+import { ParallClient, ParallWs } from "@parall/sdk";
+import type { AgentConfigUpdateData } from "@parall/sdk";
+import type { DispatchAdapter, GatewayLogger } from "./dispatch-adapter.js";
+export type ParallGatewayOptions = {
+    accountId: string;
+    client: ParallClient;
+    ws: ParallWs;
+    connectionLabel?: string;
+    config: {
+        parall_url: string;
+        api_key: string;
+        org_id: string;
+    };
+    agentUserId: string;
+    runtimeType: string;
+    runtimeKey: string;
+    runtimeRef?: Record<string, unknown>;
+    dispatchAdapter: DispatchAdapter;
+    log?: GatewayLogger;
+    coldStartWindowMs?: number;
+    stepIdFilePathForSession?: (sessionKey: string) => string | undefined;
+    onConfigUpdate?: (data: AgentConfigUpdateData) => Promise<void> | void;
+    onSessionReady?: (state: {
+        activeSessionId?: string;
+        ws: ParallWs;
+        runtimeKey: string;
+    }) => Promise<void> | void;
+    onBeforeDisconnect?: () => Promise<void> | void;
+};
+export declare class ParallAgentGateway {
+    private readonly opts;
+    private readonly chatInfoMap;
+    private readonly activeDispatches;
+    private readonly dispatchedTasks;
+    private readonly dispatchedMessages;
+    private readonly forkStates;
+    private readonly dispatchState;
+    private sessionId;
+    private activeSessionId;
+    private heartbeatTimer;
+    private hadSuccessfulHello;
+    private lastHeartbeatAt;
+    private draining;
+    private readonly DISPATCHED_MESSAGES_CAP;
+    private readonly COLD_START_WINDOW_MS;
+    constructor(opts: ParallGatewayOptions);
+    run(abortSignal: AbortSignal): Promise<void>;
+    private tryClaimMessage;
+    private startTyping;
+    private stopTyping;
+    private buildDispatchContext;
+    private createInputStep;
+    private createRuntimeStep;
+    private writeStepIdFile;
+    private clearStepIdFile;
+    private createInputStepsForEarlierEvents;
+    private runDispatch;
+    private runForkDrainLoop;
+    private drainMainBuffer;
+    private handleInboundEvent;
+    private getOrFetchChatInfo;
+    private buildMessageDispatchDecision;
+    private handleMessage;
+    private handleTaskAssignment;
+    private catchUpFromDispatch;
+    private handleHello;
+    private shutdown;
+}
+//# sourceMappingURL=gateway-base.d.ts.map

package/dist/gateway-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EACV,qBAAqB,EAStB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAEV,eAAe,EAGf,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAmD/B,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD,CAAC;AAkCF,qBAAa,kBAAkB;IAuBjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAtBjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;IAEF,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,IAAI,EAAE,oBAAoB;IAIjD,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8ElD,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,oBAAoB;YAmBd,eAAe;YAqBf,iBAAiB;IAsF/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;YAQT,gCAAgC;YAMhC,WAAW;YAyDX,gBAAgB;YAmEhB,eAAe;YAmDf,kBAAkB;YAoElB,kBAAkB;YAkBlB,4BAA4B;YA8D5B,aAAa;YA8Bb,oBAAoB;YAiCpB,mBAAmB;YAoGnB,WAAW;YA0DX,QAAQ;CAsBvB"}