@goondan/runtime 0.0.3-alpha1

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,409 @@
+import { isJsonObject } from "../types.js";
+export class OrchestratorImpl {
+    options;
+    swarmName;
+    bundleDir;
+    agents = new Map();
+    desiredAgents = new Set();
+    desiredConnectors = new Set();
+    agentState = new Map();
+    connectorState = new Map();
+    reconcileIntervalMs;
+    crashThreshold;
+    initialBackoffMs;
+    maxBackoffMs;
+    defaultGracePeriodMs;
+    now;
+    setTimeoutFn;
+    clearTimeoutFn;
+    setIntervalFn;
+    clearIntervalFn;
+    reconcileTimer = null;
+    constructor(options) {
+        this.options = options;
+        this.swarmName = options.swarmName;
+        this.bundleDir = options.bundleDir;
+        this.reconcileIntervalMs = options.reconcileIntervalMs ?? 5000;
+        this.crashThreshold = options.crashThreshold ?? 5;
+        this.initialBackoffMs = options.initialBackoffMs ?? 1000;
+        this.maxBackoffMs = options.maxBackoffMs ?? 300000;
+        this.defaultGracePeriodMs = options.defaultGracePeriodMs ?? 30000;
+        this.now = options.now ?? (() => new Date());
+        this.setTimeoutFn = options.setTimeoutFn ?? setTimeout;
+        this.clearTimeoutFn = options.clearTimeoutFn ?? clearTimeout;
+        this.setIntervalFn = options.setIntervalFn ?? setInterval;
+        this.clearIntervalFn = options.clearIntervalFn ?? clearInterval;
+        for (const agentName of options.desiredAgents) {
+            this.desiredAgents.add(agentName);
+        }
+        for (const connectorName of options.desiredConnectors ?? []) {
+            this.desiredConnectors.add(connectorName);
+        }
+        this.reconcileTimer = this.setIntervalFn(() => {
+            void this.reconcile();
+        }, this.reconcileIntervalMs);
+    }
+    spawn(agentName, instanceKey) {
+        const key = buildAgentKey(agentName, instanceKey);
+        const existingState = this.agentState.get(key);
+        if (existingState !== undefined) {
+            if (existingState.process === null) {
+                this.spawnIntoState(existingState);
+            }
+            const existingHandle = this.agents.get(key);
+            if (existingHandle !== undefined) {
+                return existingHandle;
+            }
+        }
+        const state = {
+            pid: -1,
+            agentName,
+            instanceKey,
+            status: "spawning",
+            consecutiveCrashes: 0,
+            process: null,
+        };
+        const handle = this.createHandle(state);
+        this.agentState.set(key, state);
+        this.agents.set(key, handle);
+        this.spawnIntoState(state);
+        return handle;
+    }
+    async restart(agentName) {
+        const matching = [...this.agentState.values()].filter((state) => state.agentName === agentName);
+        for (const state of matching) {
+            await this.gracefulShutdown(state, { reason: "restart" });
+            state.consecutiveCrashes = 0;
+            state.nextSpawnAllowedAt = undefined;
+            this.spawnIntoState(state);
+        }
+    }
+    async reloadAndRestartAll() {
+        const uniqueAgentNames = new Set();
+        for (const state of this.agentState.values()) {
+            uniqueAgentNames.add(state.agentName);
+        }
+        for (const agentName of uniqueAgentNames) {
+            await this.restart(agentName);
+        }
+    }
+    async reconcile() {
+        const result = {
+            toSpawn: [],
+            toTerminate: [],
+            toRespawn: [],
+        };
+        for (const agentName of this.desiredAgents) {
+            if (this.hasStateForAgent(agentName)) {
+                continue;
+            }
+            const instanceKey = "default";
+            this.spawn(agentName, instanceKey);
+            result.toSpawn.push({
+                agentName,
+                instanceKey,
+            });
+        }
+        for (const connectorName of this.desiredConnectors) {
+            const connector = this.connectorState.get(connectorName);
+            if (connector === undefined || connector.process === null) {
+                this.spawnConnector(connectorName);
+            }
+        }
+        for (const [connectorName, state] of this.connectorState.entries()) {
+            if (this.desiredConnectors.has(connectorName)) {
+                continue;
+            }
+            result.toTerminate.push({
+                agentName: connectorName,
+                reason: "connector_not_in_desired_state",
+            });
+            if (state.process !== null) {
+                state.process.kill("SIGTERM");
+                state.process = null;
+            }
+            this.connectorState.delete(connectorName);
+        }
+        for (const [key, state] of this.agentState.entries()) {
+            if (!this.desiredAgents.has(state.agentName)) {
+                result.toTerminate.push({
+                    agentName: state.agentName,
+                    reason: "not_in_desired_state",
+                });
+                await this.gracefulShutdown(state, { reason: "config_change" });
+                this.agentState.delete(key);
+                this.agents.delete(key);
+                continue;
+            }
+            if (state.status === "crashed" || state.status === "crashLoopBackOff") {
+                const now = this.now();
+                const nextAllowedAt = state.nextSpawnAllowedAt;
+                const backoffMs = nextAllowedAt === undefined ? 0 : Math.max(0, nextAllowedAt.getTime() - now.getTime());
+                if (nextAllowedAt !== undefined && nextAllowedAt.getTime() > now.getTime()) {
+                    result.toRespawn.push({
+                        agentName: state.agentName,
+                        instanceKey: state.instanceKey,
+                        backoffMs,
+                    });
+                    continue;
+                }
+                this.spawnIntoState(state);
+                result.toSpawn.push({
+                    agentName: state.agentName,
+                    instanceKey: state.instanceKey,
+                });
+            }
+        }
+        return result;
+    }
+    async shutdown() {
+        if (this.reconcileTimer !== null) {
+            this.clearIntervalFn(this.reconcileTimer);
+            this.reconcileTimer = null;
+        }
+        for (const state of this.agentState.values()) {
+            await this.gracefulShutdown(state, { reason: "orchestrator_shutdown" });
+        }
+        for (const connector of this.connectorState.values()) {
+            if (connector.process !== null) {
+                connector.process.kill("SIGTERM");
+                connector.process = null;
+            }
+        }
+    }
+    route(message) {
+        if (message.type === "shutdown_ack") {
+            this.handleShutdownAck(message);
+            return;
+        }
+        if (message.type !== "event") {
+            return;
+        }
+        const target = message.to === "orchestrator" ? inferTargetFromPayload(message.payload) : message.to;
+        if (target === undefined) {
+            return;
+        }
+        const instanceKey = inferInstanceKey(message.payload);
+        const handle = this.spawn(target, instanceKey);
+        handle.send({
+            type: "event",
+            from: message.from,
+            to: target,
+            payload: message.payload,
+        });
+    }
+    createHandle(state) {
+        return {
+            get pid() {
+                return state.pid;
+            },
+            get agentName() {
+                return state.agentName;
+            },
+            get instanceKey() {
+                return state.instanceKey;
+            },
+            get status() {
+                return state.status;
+            },
+            get consecutiveCrashes() {
+                return state.consecutiveCrashes;
+            },
+            get nextSpawnAllowedAt() {
+                return state.nextSpawnAllowedAt;
+            },
+            send: (message) => {
+                if (state.process !== null) {
+                    state.process.send(message);
+                }
+            },
+            shutdown: (options) => this.gracefulShutdown(state, options),
+            kill: () => {
+                if (state.process !== null) {
+                    state.process.kill("SIGKILL");
+                }
+            },
+        };
+    }
+    spawnIntoState(state) {
+        const process = this.options.spawner.spawnAgent(state.agentName, state.instanceKey);
+        state.process = process;
+        state.pid = process.pid;
+        state.status = "spawning";
+        state.nextSpawnAllowedAt = undefined;
+        process.onMessage((message) => {
+            this.route(message);
+        });
+        process.onExit((code) => {
+            state.process = null;
+            if (state.status === "draining" || state.status === "terminated") {
+                state.status = "terminated";
+                this.resetCrashTracking(state);
+                return;
+            }
+            if (code === 0) {
+                state.status = "terminated";
+                this.resetCrashTracking(state);
+                return;
+            }
+            state.consecutiveCrashes += 1;
+            state.status = "crashed";
+            if (state.consecutiveCrashes > this.crashThreshold) {
+                const backoffMs = this.calculateBackoffMs(state.consecutiveCrashes);
+                state.status = "crashLoopBackOff";
+                state.nextSpawnAllowedAt = new Date(this.now().getTime() + backoffMs);
+                this.logCrashLoopBackOff(state, backoffMs);
+            }
+        });
+        state.status = "idle";
+    }
+    spawnConnector(name) {
+        const process = this.options.spawner.spawnConnector(name);
+        const state = {
+            name,
+            process,
+        };
+        process.onMessage((message) => {
+            this.route(message);
+        });
+        process.onExit(() => {
+            state.process = null;
+        });
+        this.connectorState.set(name, state);
+    }
+    calculateBackoffMs(consecutiveCrashes) {
+        const exponent = consecutiveCrashes - this.crashThreshold - 1;
+        const factor = exponent <= 0 ? 1 : Math.pow(2, exponent);
+        return Math.min(this.initialBackoffMs * factor, this.maxBackoffMs);
+    }
+    async gracefulShutdown(state, options = {}) {
+        if (state.process === null) {
+            state.status = "terminated";
+            this.resetCrashTracking(state);
+            return;
+        }
+        if (state.shutdownRequest !== undefined) {
+            return state.shutdownRequest.promise;
+        }
+        const gracePeriodMs = options.gracePeriodMs ?? this.defaultGracePeriodMs;
+        const reason = options.reason ?? "orchestrator_shutdown";
+        state.status = "draining";
+        state.process.send({
+            type: "shutdown",
+            from: "orchestrator",
+            to: state.agentName,
+            payload: {
+                gracePeriodMs,
+                reason,
+            },
+        });
+        let settled = false;
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        const timer = this.setTimeoutFn(() => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (state.process !== null) {
+                state.process.kill("SIGKILL");
+                state.process = null;
+            }
+            state.status = "terminated";
+            state.shutdownRequest = undefined;
+            if (resolvePromise !== undefined) {
+                resolvePromise();
+            }
+        }, gracePeriodMs);
+        state.shutdownRequest = {
+            promise,
+            resolve: () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                this.clearTimeoutFn(timer);
+                if (state.process !== null) {
+                    state.process.kill("SIGTERM");
+                    state.process = null;
+                }
+                state.status = "terminated";
+                this.resetCrashTracking(state);
+                state.shutdownRequest = undefined;
+                if (resolvePromise !== undefined) {
+                    resolvePromise();
+                }
+            },
+        };
+        return promise;
+    }
+    handleShutdownAck(message) {
+        const targetState = this.findStateForShutdownAck(message);
+        if (targetState === undefined) {
+            return;
+        }
+        if (targetState.shutdownRequest !== undefined) {
+            targetState.shutdownRequest.resolve();
+        }
+    }
+    findStateForShutdownAck(message) {
+        const payload = isJsonObject(message.payload) ? message.payload : undefined;
+        if (payload !== undefined && typeof payload.instanceKey === "string") {
+            const key = buildAgentKey(message.from, payload.instanceKey);
+            return this.agentState.get(key);
+        }
+        const candidates = [...this.agentState.values()].filter((state) => state.agentName === message.from && state.status === "draining");
+        return candidates.length === 1 ? candidates[0] : undefined;
+    }
+    hasStateForAgent(agentName) {
+        for (const state of this.agentState.values()) {
+            if (state.agentName === agentName) {
+                return true;
+            }
+        }
+        return false;
+    }
+    resetCrashTracking(state) {
+        state.consecutiveCrashes = 0;
+        state.nextSpawnAllowedAt = undefined;
+    }
+    logCrashLoopBackOff(state, backoffMs) {
+        console.warn("[orchestrator] crashLoopBackOff", {
+            event: "orchestrator.crashLoopBackOff",
+            swarmName: this.swarmName,
+            agentName: state.agentName,
+            instanceKey: state.instanceKey,
+            status: state.status,
+            consecutiveCrashes: state.consecutiveCrashes,
+            crashThreshold: this.crashThreshold,
+            backoffMs,
+            nextSpawnAllowedAt: state.nextSpawnAllowedAt?.toISOString(),
+        });
+    }
+}
+function buildAgentKey(agentName, instanceKey) {
+    return `${agentName}:${instanceKey}`;
+}
+function inferTargetFromPayload(payload) {
+    if (!isJsonObject(payload)) {
+        return undefined;
+    }
+    const replyTo = payload.replyTo;
+    if (isJsonObject(replyTo) && typeof replyTo.target === "string") {
+        return replyTo.target;
+    }
+    return undefined;
+}
+function inferInstanceKey(payload) {
+    if (!isJsonObject(payload)) {
+        return "default";
+    }
+    const value = payload.instanceKey;
+    if (typeof value === "string" && value.length > 0) {
+        return value;
+    }
+    return "default";
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/orchestrator/types.d.ts

@@ -0,0 +1,72 @@
+import type { IpcMessage, ProcessStatus, ShutdownReason } from "../types.js";
+export interface ShutdownOptions {
+    gracePeriodMs?: number;
+    reason?: ShutdownReason;
+}
+export interface AgentProcessHandle {
+    readonly pid: number;
+    readonly agentName: string;
+    readonly instanceKey: string;
+    readonly status: ProcessStatus;
+    readonly consecutiveCrashes: number;
+    readonly nextSpawnAllowedAt?: Date;
+    send(message: IpcMessage): void;
+    shutdown(options?: ShutdownOptions): Promise<void>;
+    kill(): void;
+}
+export interface ReconciliationTarget {
+    agentName: string;
+    instanceKey: string;
+}
+export interface ReconciliationResult {
+    toSpawn: ReconciliationTarget[];
+    toTerminate: Array<{
+        agentName: string;
+        reason: string;
+    }>;
+    toRespawn: Array<{
+        agentName: string;
+        instanceKey: string;
+        backoffMs: number;
+    }>;
+}
+export interface Orchestrator {
+    readonly swarmName: string;
+    readonly bundleDir: string;
+    readonly agents: Map<string, AgentProcessHandle>;
+    spawn(agentName: string, instanceKey: string): AgentProcessHandle;
+    restart(agentName: string): Promise<void>;
+    reloadAndRestartAll(): Promise<void>;
+    reconcile(): Promise<ReconciliationResult>;
+    shutdown(): Promise<void>;
+    route(message: IpcMessage): void;
+}
+export interface ManagedChildProcess {
+    readonly pid: number;
+    send(message: IpcMessage): void;
+    kill(signal?: "SIGTERM" | "SIGKILL"): void;
+    onMessage(listener: (message: IpcMessage) => void): void;
+    onExit(listener: (code: number | null) => void): void;
+}
+export interface RuntimeProcessSpawner {
+    spawnAgent(agentName: string, instanceKey: string): ManagedChildProcess;
+    spawnConnector(name: string): ManagedChildProcess;
+}
+export interface OrchestratorOptions {
+    swarmName: string;
+    bundleDir: string;
+    desiredAgents: string[];
+    desiredConnectors?: string[];
+    spawner: RuntimeProcessSpawner;
+    reconcileIntervalMs?: number;
+    crashThreshold?: number;
+    initialBackoffMs?: number;
+    maxBackoffMs?: number;
+    defaultGracePeriodMs?: number;
+    now?: () => Date;
+    setTimeoutFn?: (handler: () => void, timeoutMs: number) => NodeJS.Timeout;
+    clearTimeoutFn?: (handle: NodeJS.Timeout) => void;
+    setIntervalFn?: (handler: () => void, timeoutMs: number) => NodeJS.Timeout;
+    clearIntervalFn?: (handle: NodeJS.Timeout) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/orchestrator/types.d.ts.map

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

package/dist/orchestrator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/orchestrator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":""}

package/dist/pipeline/registry.d.ts

@@ -0,0 +1,60 @@
+import type { AgentEvent, ConversationState, ExecutionContext, JsonObject, JsonValue, MessageEvent, StepResult, ToolCallResult, ToolCatalogItem, Turn, TurnResult } from "../types.js";
+import type { RuntimeEventBus } from "../events/runtime-events.js";
+export type PipelineType = "turn" | "step" | "toolCall";
+export interface MiddlewareOptions {
+    priority?: number;
+}
+export interface TurnMiddlewareContext extends ExecutionContext {
+    readonly inputEvent: AgentEvent;
+    readonly conversationState: ConversationState;
+    emitMessageEvent(event: MessageEvent): void;
+    metadata: Record<string, JsonValue>;
+    next(): Promise<TurnResult>;
+}
+export interface StepMiddlewareContext extends ExecutionContext {
+    readonly turn: Turn;
+    readonly stepIndex: number;
+    readonly conversationState: ConversationState;
+    emitMessageEvent(event: MessageEvent): void;
+    toolCatalog: ToolCatalogItem[];
+    metadata: Record<string, JsonValue>;
+    next(): Promise<StepResult>;
+}
+export interface ToolCallMiddlewareContext extends ExecutionContext {
+    readonly stepIndex: number;
+    readonly toolName: string;
+    readonly toolCallId: string;
+    args: JsonObject;
+    metadata: Record<string, JsonValue>;
+    next(): Promise<ToolCallResult>;
+}
+export type TurnMiddleware = (ctx: TurnMiddlewareContext) => Promise<TurnResult>;
+export type StepMiddleware = (ctx: StepMiddlewareContext) => Promise<StepResult>;
+export type ToolCallMiddleware = (ctx: ToolCallMiddlewareContext) => Promise<ToolCallResult>;
+export interface PipelineRegistry {
+    register(type: "turn", fn: TurnMiddleware, options?: MiddlewareOptions): void;
+    register(type: "step", fn: StepMiddleware, options?: MiddlewareOptions): void;
+    register(type: "toolCall", fn: ToolCallMiddleware, options?: MiddlewareOptions): void;
+    runTurn(ctx: Omit<TurnMiddlewareContext, "next">, core: TurnMiddleware): Promise<TurnResult>;
+    runStep(ctx: Omit<StepMiddlewareContext, "next">, core: StepMiddleware): Promise<StepResult>;
+    runToolCall(ctx: Omit<ToolCallMiddlewareContext, "next">, core: ToolCallMiddleware): Promise<ToolCallResult>;
+}
+export declare class PipelineRegistryImpl implements PipelineRegistry {
+    private readonly eventBus?;
+    private turnMiddlewares;
+    private stepMiddlewares;
+    private toolCallMiddlewares;
+    constructor(eventBus?: RuntimeEventBus | undefined);
+    register(...args: ["turn", TurnMiddleware, MiddlewareOptions?]): void;
+    register(...args: ["step", StepMiddleware, MiddlewareOptions?]): void;
+    register(...args: ["toolCall", ToolCallMiddleware, MiddlewareOptions?]): void;
+    runTurn(ctx: Omit<TurnMiddlewareContext, "next">, core: TurnMiddleware): Promise<TurnResult>;
+    runStep(ctx: Omit<StepMiddlewareContext, "next">, core: StepMiddleware): Promise<StepResult>;
+    runToolCall(ctx: Omit<ToolCallMiddlewareContext, "next">, core: ToolCallMiddleware): Promise<ToolCallResult>;
+    private sortEntries;
+    private createTurnContext;
+    private createStepContext;
+    private createToolCallContext;
+    private createNeverNext;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/pipeline/registry.d.ts.map

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