@framers/agentos 0.1.0

package/dist/core/workflows/runtime/WorkflowRuntime.js

@@ -0,0 +1,566 @@
+import { uuidv4 } from '../../../utils/uuid.js';
+import { WorkflowTaskStatus } from '../WorkflowTypes.js';
+import { AgencyRegistry } from '../../agency/AgencyRegistry.js';
+import { AgentOSResponseChunkType, } from '../../../api/types/AgentOSResponse.js';
+import { GMIInteractionType, GMIOutputChunkType, } from '../../../cognitive_substrate/IGMI.js';
+import { EXTENSION_KIND_WORKFLOW_EXECUTOR, } from '../../../extensions/types.js';
+/**
+ * Lightweight coordinator that listens for workflow engine events and schedules task execution.
+ * @remarks
+ * The current implementation sets up scaffolding for future multi-GMI orchestration. Execution handlers
+ * will be fleshed out as persona overlays, tool dispatchers, and guardrail hooks are implemented.
+ */
+class ConcurrencyQueue {
+    constructor(concurrency) {
+        this.concurrency = concurrency;
+        this.running = 0;
+        this.queue = [];
+        this.idleResolvers = [];
+    }
+    add(task) {
+        return new Promise((resolve, reject) => {
+            const execute = async () => {
+                this.running += 1;
+                try {
+                    const result = await task();
+                    resolve(result);
+                }
+                catch (error) {
+                    reject(error);
+                }
+                finally {
+                    this.running -= 1;
+                    this.dequeue();
+                }
+            };
+            if (this.running < this.concurrency) {
+                void execute();
+            }
+            else {
+                this.queue.push(execute);
+            }
+        });
+    }
+    async onIdle() {
+        if (this.running === 0 && this.queue.length === 0) {
+            return;
+        }
+        return new Promise((resolve) => {
+            this.idleResolvers.push(resolve);
+        });
+    }
+    clear() {
+        this.queue.length = 0;
+    }
+    dequeue() {
+        if (this.queue.length > 0 && this.running < this.concurrency) {
+            const next = this.queue.shift();
+            if (next) {
+                next();
+            }
+            return;
+        }
+        if (this.running === 0 && this.queue.length === 0) {
+            this.resolveIdle();
+        }
+    }
+    resolveIdle() {
+        if (!this.idleResolvers.length) {
+            return;
+        }
+        const resolvers = this.idleResolvers.splice(0, this.idleResolvers.length);
+        for (const resolve of resolvers) {
+            resolve();
+        }
+    }
+}
+export class WorkflowRuntime {
+    constructor(deps) {
+        this.deps = deps;
+        this.queue = new ConcurrencyQueue(4);
+        this.started = false;
+        this.definitionCache = new Map();
+        this.agencyRegistry = deps.agencyRegistry ?? new AgencyRegistry(deps.logger?.child?.({ component: 'AgencyRegistry' }));
+        this.extensionManager = deps.extensionManager;
+    }
+    /**
+     * Begins listening to workflow engine events and prepares the execution queue.
+     */
+    async start() {
+        if (this.started) {
+            return;
+        }
+        const listener = async (event) => {
+            await this.handleWorkflowEvent(event);
+        };
+        this.workflowListener = listener;
+        this.deps.workflowEngine.onEvent(listener);
+        this.started = true;
+        this.deps.logger?.info?.('Workflow runtime started.');
+    }
+    /**
+     * Stops the runtime, drains queued tasks, and detaches event listeners.
+     */
+    async stop() {
+        if (!this.started) {
+            return;
+        }
+        this.started = false;
+        if (this.workflowListener) {
+            this.deps.workflowEngine.offEvent(this.workflowListener);
+            this.workflowListener = undefined;
+        }
+        await this.queue.onIdle();
+        this.deps.logger?.info?.('Workflow runtime stopped.');
+    }
+    /**
+     * Handles workflow engine events. At this stage we only log structural changes; execution
+     * hooks will be connected as the multi-GMI runtime evolves.
+     */
+    async handleWorkflowEvent(event) {
+        switch (event.type) {
+            case 'workflow_created': {
+                this.deps.logger?.debug?.('WorkflowRuntime observed workflow creation', {
+                    workflowId: event.workflowId,
+                    definitionId: event.definitionId,
+                });
+                break;
+            }
+            case 'task_status_changed': {
+                if (!event.taskId || !event.payload) {
+                    return;
+                }
+                const status = event.payload.status;
+                if (status === 'ready') {
+                    this.queue.add(() => this.enqueueTaskExecution(event.workflowId, event.definitionId, event.taskId));
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    /**
+     * Enqueues a single workflow task for execution.
+     * @param workflowId - Identifier of the workflow instance.
+     * @param definitionId - Identifier of the workflow definition.
+     * @param taskId - Identifier of the task ready for execution.
+     */
+    async enqueueTaskExecution(workflowId, definitionId, taskId) {
+        const definition = this.getWorkflowDefinition(definitionId);
+        if (!definition) {
+            this.deps.logger?.error?.('WorkflowRuntime: definition not found', { workflowId, definitionId });
+            return;
+        }
+        const taskDefinition = definition.tasks.find((task) => task.id === taskId);
+        if (!taskDefinition) {
+            this.deps.logger?.error?.('WorkflowRuntime: task definition not found', { workflowId, definitionId, taskId });
+            return;
+        }
+        const instance = await this.deps.workflowEngine.getWorkflow(workflowId);
+        if (!instance) {
+            this.deps.logger?.warn?.('WorkflowRuntime: workflow instance not found', { workflowId });
+            return;
+        }
+        try {
+            switch (taskDefinition.executor.type) {
+                case 'gmi':
+                    await this.executeGmiTask(definition, taskDefinition, instance);
+                    break;
+                case 'tool':
+                    await this.executeToolTask(definition, taskDefinition, instance);
+                    break;
+                case 'extension':
+                    await this.executeExtensionTask(definition, taskDefinition, instance);
+                    break;
+                default:
+                    this.deps.logger?.warn?.('WorkflowRuntime: executor type not yet supported', {
+                        workflowId,
+                        taskId,
+                        executorType: taskDefinition.executor.type,
+                    });
+                    await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+                        {
+                            taskId,
+                            status: WorkflowTaskStatus.COMPLETED,
+                            completedAt: new Date().toISOString(),
+                            metadata: { note: 'Execution skipped (unsupported executor type).' },
+                        },
+                    ]);
+                    break;
+            }
+        }
+        catch (error) {
+            this.deps.logger?.error?.('WorkflowRuntime: task execution error', {
+                workflowId,
+                taskId,
+                error,
+            });
+            await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+                {
+                    taskId,
+                    status: WorkflowTaskStatus.FAILED,
+                    completedAt: new Date().toISOString(),
+                    error: {
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                },
+            ]);
+        }
+    }
+    /**
+     * Helper used by future implementations to resolve a task definition from the workflow definition catalogue.
+     * Provided here to keep the scaffolding self-contained.
+     */
+    resolveTaskDefinition(definitionId, taskId) {
+        const definition = this.getWorkflowDefinition(definitionId);
+        return definition?.tasks.find((task) => task.id === taskId);
+    }
+    /**
+     * Emits an Agency update to downstream consumers. Placeholder implementation until the runtime
+     * fully manages stream identifiers per Agency seat.
+     */
+    async emitAgencyUpdate(session) {
+        const seats = Object.values(session.seats).map((seat) => {
+            const latestHistory = seat.history?.[seat.history.length - 1];
+            const status = (latestHistory?.status ?? seat.metadata?.status ?? 'pending');
+            return {
+                roleId: seat.roleId,
+                gmiInstanceId: seat.gmiInstanceId,
+                personaId: seat.personaId,
+                metadata: {
+                    ...(seat.metadata ?? {}),
+                    status,
+                    lastOutputPreview: latestHistory?.outputPreview ?? seat.metadata?.lastOutputPreview,
+                    history: seat.history,
+                },
+            };
+        });
+        const isFinal = seats.length > 0 &&
+            seats.every((seat) => {
+                const status = seat.metadata?.status ?? 'pending';
+                return status === 'completed' || status === 'failed';
+            });
+        const chunk = {
+            type: AgentOSResponseChunkType.AGENCY_UPDATE,
+            streamId: session.conversationId,
+            gmiInstanceId: `agency:${session.agencyId}`,
+            personaId: `agency:${session.agencyId}`,
+            isFinal,
+            timestamp: new Date().toISOString(),
+            agency: {
+                agencyId: session.agencyId,
+                workflowId: session.workflowId,
+                conversationId: session.conversationId,
+                seats,
+                metadata: session.metadata,
+            },
+        };
+        try {
+            await this.deps.streamingManager.pushChunk(session.conversationId, chunk);
+        }
+        catch (error) {
+            this.deps.logger?.error?.('WorkflowRuntime: failed to emit agency update', {
+                agencyId: session.agencyId,
+                error,
+            });
+        }
+    }
+    getWorkflowDefinition(definitionId) {
+        let definition = this.definitionCache.get(definitionId);
+        if (!definition) {
+            const allDefinitions = this.deps.workflowEngine.listWorkflowDefinitions();
+            definition = allDefinitions.find((def) => def.id === definitionId);
+            if (definition) {
+                this.definitionCache.set(definitionId, definition);
+            }
+        }
+        return definition;
+    }
+    async executeGmiTask(workflowDefinition, taskDefinition, instance) {
+        const { workflowId } = instance;
+        const taskId = taskDefinition.id;
+        const roleId = taskDefinition.executor.roleId;
+        const personaId = taskDefinition.executor.personaId ??
+            workflowDefinition.roles?.find((role) => role.roleId === roleId)?.personaId;
+        if (!roleId || !personaId) {
+            throw new Error(`Missing role or persona configuration for task '${taskId}'.`);
+        }
+        const startedAt = new Date().toISOString();
+        await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+            { taskId, status: WorkflowTaskStatus.IN_PROGRESS, startedAt },
+        ]);
+        const conversationId = instance.conversationId ?? instance.workflowId;
+        const userId = instance.createdByUserId ?? 'system';
+        const agencySession = this.agencyRegistry.upsertAgency({ workflowId, conversationId });
+        const roleDefinition = workflowDefinition.roles?.find((role) => role.roleId === roleId);
+        const priorSeatState = agencySession.seats[roleId];
+        const agencyOptions = {
+            agencyId: agencySession.agencyId,
+            roleId,
+            workflowId,
+            evolutionRules: roleDefinition?.evolutionRules ?? [],
+            evolutionContext: this.buildEvolutionContext(workflowId, agencySession.agencyId, roleId, priorSeatState),
+        };
+        const { gmi, conversationContext } = await this.deps.gmiManager.getOrCreateGMIForSession(userId, conversationId, personaId, conversationId, undefined, undefined, undefined, agencyOptions);
+        this.agencyRegistry.registerSeat({
+            agencyId: agencySession.agencyId,
+            roleId,
+            gmiInstanceId: gmi.gmiId,
+            personaId,
+            metadata: roleDefinition?.metadata,
+        });
+        this.agencyRegistry.mergeSeatMetadata(agencySession.agencyId, roleId, {
+            status: 'running',
+            lastTaskId: taskId,
+            lastUpdatedAt: new Date().toISOString(),
+        });
+        const runningSession = this.agencyRegistry.getAgency(agencySession.agencyId);
+        if (runningSession) {
+            await this.emitAgencyUpdate(runningSession);
+            await this.syncWorkflowAgencyState(runningSession, workflowId);
+        }
+        const instructions = taskDefinition.executor.instructions ??
+            `Complete workflow task '${taskDefinition.name}' for workflow '${workflowDefinition.displayName}'.`;
+        const turnInput = {
+            interactionId: `${workflowId}-${taskId}-${uuidv4()}`,
+            userId,
+            sessionId: conversationId,
+            type: GMIInteractionType.TEXT,
+            content: instructions,
+            metadata: {
+                workflowId,
+                taskId,
+                agencyId: agencySession.agencyId,
+                roleId,
+            },
+            timestamp: new Date(),
+        };
+        try {
+            const { text: taskOutputText } = await this.collectGmiResponse(gmi.processTurnStream(turnInput));
+            conversationContext.setMetadata?.('latestTaskOutput', taskOutputText);
+            const outputPreview = this.buildOutputPreview(taskOutputText);
+            this.agencyRegistry.appendSeatHistory(agencySession.agencyId, roleId, {
+                taskId,
+                timestamp: new Date().toISOString(),
+                status: 'completed',
+                outputPreview,
+                metadata: { executor: 'gmi' },
+            });
+            this.agencyRegistry.mergeSeatMetadata(agencySession.agencyId, roleId, {
+                status: 'completed',
+                lastOutputPreview: outputPreview,
+                lastTaskId: taskId,
+                lastUpdatedAt: new Date().toISOString(),
+            });
+            const completedSession = this.agencyRegistry.getAgency(agencySession.agencyId);
+            if (completedSession) {
+                await this.emitAgencyUpdate(completedSession);
+                await this.syncWorkflowAgencyState(completedSession, workflowId);
+            }
+            await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+                {
+                    taskId,
+                    status: WorkflowTaskStatus.COMPLETED,
+                    completedAt: new Date().toISOString(),
+                    output: { text: taskOutputText },
+                },
+            ]);
+        }
+        catch (error) {
+            const failureMessage = error instanceof Error ? error.message : String(error);
+            this.agencyRegistry.appendSeatHistory(agencySession.agencyId, roleId, {
+                taskId,
+                timestamp: new Date().toISOString(),
+                status: 'failed',
+                outputPreview: failureMessage,
+                metadata: { executor: 'gmi' },
+            });
+            this.agencyRegistry.mergeSeatMetadata(agencySession.agencyId, roleId, {
+                status: 'failed',
+                lastError: failureMessage,
+                lastTaskId: taskId,
+                lastUpdatedAt: new Date().toISOString(),
+            });
+            const failedSession = this.agencyRegistry.getAgency(agencySession.agencyId);
+            if (failedSession) {
+                await this.emitAgencyUpdate(failedSession);
+                await this.syncWorkflowAgencyState(failedSession, workflowId);
+            }
+            throw error;
+        }
+    }
+    async executeToolTask(workflowDefinition, taskDefinition, instance) {
+        const workflowId = instance.workflowId;
+        const taskId = taskDefinition.id;
+        const toolName = taskDefinition.executor.extensionId ??
+            taskDefinition.metadata?.toolName;
+        if (!toolName) {
+            throw new Error(`Tool task '${taskId}' is missing executor.extensionId or metadata.toolName`);
+        }
+        const startedAt = new Date().toISOString();
+        await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+            { taskId, status: WorkflowTaskStatus.IN_PROGRESS, startedAt },
+        ]);
+        const roleId = taskDefinition.executor.roleId;
+        const roleDefinition = workflowDefinition.roles?.find((role) => role.roleId === roleId);
+        const toolArgs = (taskDefinition.metadata?.toolArgs ?? {});
+        const userId = instance.createdByUserId ?? 'system';
+        const requestDetails = {
+            toolCallRequest: {
+                id: `${workflowId}-${taskId}-tool-call`,
+                name: toolName,
+                arguments: toolArgs,
+            },
+            gmiId: `workflow-tool-executor-${workflowId}`,
+            personaId: taskDefinition.executor.personaId ?? roleDefinition?.personaId ?? 'workflow-tool-agent',
+            personaCapabilities: roleDefinition?.personaCapabilityRequirements ?? [],
+            userContext: { userId },
+            correlationId: `${workflowId}-${taskId}`,
+        };
+        let toolResult;
+        try {
+            toolResult = await this.deps.toolOrchestrator.processToolCall(requestDetails);
+        }
+        catch (error) {
+            await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+                {
+                    taskId,
+                    status: WorkflowTaskStatus.FAILED,
+                    completedAt: new Date().toISOString(),
+                    error: { message: error instanceof Error ? error.message : String(error) },
+                },
+            ]);
+            throw error;
+        }
+        const success = !!toolResult && !toolResult.isError;
+        await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+            {
+                taskId,
+                status: success ? WorkflowTaskStatus.COMPLETED : WorkflowTaskStatus.FAILED,
+                completedAt: new Date().toISOString(),
+                output: toolResult?.output,
+                error: success
+                    ? undefined
+                    : {
+                        message: toolResult?.errorDetails?.message ??
+                            'Tool execution reported failure',
+                    },
+            },
+        ]);
+    }
+    async executeExtensionTask(workflowDefinition, taskDefinition, instance) {
+        const workflowId = instance.workflowId;
+        const taskId = taskDefinition.id;
+        const executorId = taskDefinition.executor.extensionId;
+        if (!executorId) {
+            throw new Error(`Extension task '${taskId}' is missing executor.extensionId.`);
+        }
+        const registry = this.extensionManager.getRegistry(EXTENSION_KIND_WORKFLOW_EXECUTOR);
+        const activeDescriptor = registry.getActive(executorId);
+        if (!activeDescriptor) {
+            throw new Error(`No workflow executor extension registered with id '${executorId}'.`);
+        }
+        await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+            { taskId, status: WorkflowTaskStatus.IN_PROGRESS, startedAt: new Date().toISOString() },
+        ]);
+        let result;
+        try {
+            result = await activeDescriptor.payload({
+                workflow: instance,
+                task: taskDefinition,
+            });
+        }
+        catch (error) {
+            await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+                {
+                    taskId,
+                    status: WorkflowTaskStatus.FAILED,
+                    completedAt: new Date().toISOString(),
+                    error: { message: error instanceof Error ? error.message : String(error) },
+                },
+            ]);
+            throw error;
+        }
+        await this.deps.workflowEngine.applyTaskUpdates(workflowId, [
+            {
+                taskId,
+                status: result?.status ?? WorkflowTaskStatus.COMPLETED,
+                completedAt: new Date().toISOString(),
+                output: result?.output,
+                metadata: result?.metadata,
+            },
+        ]);
+    }
+    async collectGmiResponse(stream) {
+        let aggregated = '';
+        let usage;
+        for await (const chunk of stream) {
+            switch (chunk.type) {
+                case GMIOutputChunkType.TEXT_DELTA:
+                    if (typeof chunk.content === 'string') {
+                        aggregated += chunk.content;
+                    }
+                    break;
+                case GMIOutputChunkType.FINAL_RESPONSE_MARKER:
+                    if (typeof chunk.content === 'string') {
+                        aggregated += chunk.content;
+                    }
+                    else if (chunk.content && chunk.content.finalResponseText) {
+                        aggregated += String(chunk.content.finalResponseText);
+                    }
+                    if (chunk.content && typeof chunk.content === 'object' && chunk.content.usage) {
+                        usage = chunk.content.usage;
+                    }
+                    break;
+                default:
+                    break;
+            }
+        }
+        return { text: aggregated, usage };
+    }
+    buildOutputPreview(text, maxLength = 600) {
+        if (!text) {
+            return '';
+        }
+        const normalized = text.trim();
+        return normalized.length > maxLength ? `${normalized.slice(0, maxLength)}…` : normalized;
+    }
+    buildEvolutionContext(workflowId, agencyId, roleId, seatState) {
+        const history = seatState?.history ?? [];
+        const recentOutputs = history
+            .slice(-3)
+            .map((entry) => entry.outputPreview
+            ? { taskId: entry.taskId ?? 'unknown_task', output: entry.outputPreview }
+            : undefined)
+            .filter((entry) => Boolean(entry));
+        return {
+            workflowId,
+            agencyId,
+            roleId,
+            recentOutputs: recentOutputs.length > 0 ? recentOutputs : undefined,
+            metadata: {
+                lastEvent: history.at(-1)?.status,
+                seatMetadata: seatState?.metadata,
+            },
+        };
+    }
+    async syncWorkflowAgencyState(session, workflowId) {
+        await this.deps.workflowEngine.updateWorkflowAgencyState(workflowId, {
+            agencyId: session.agencyId,
+            seats: Object.fromEntries(Object.entries(session.seats).map(([role, seat]) => [
+                role,
+                {
+                    roleId: role,
+                    gmiInstanceId: seat.gmiInstanceId,
+                    personaId: seat.personaId,
+                    attachedAt: seat.attachedAt,
+                    metadata: seat.metadata,
+                    history: seat.history,
+                },
+            ])),
+            metadata: session.metadata,
+        });
+    }
+}
+//# sourceMappingURL=WorkflowRuntime.js.map

package/dist/core/workflows/runtime/WorkflowRuntime.js.map

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

package/dist/core/workflows/storage/IWorkflowStore.d.ts

@@ -0,0 +1,75 @@
+import type { WorkflowEvent, WorkflowInstance, WorkflowProgressUpdate, WorkflowStatus, WorkflowTaskStatus } from '../WorkflowTypes';
+/**
+ * Input payload used when creating a workflow instance.
+ */
+export interface WorkflowCreateInput {
+    workflowId: string;
+    definitionId: string;
+    definitionVersion?: string;
+    createdAt: string;
+    createdByUserId?: string;
+    conversationId?: string;
+    context?: Record<string, unknown>;
+    roleAssignments?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options supplied when querying for workflow instances.
+ */
+export interface WorkflowQueryOptions {
+    conversationId?: string;
+    definitionId?: string;
+    statuses?: WorkflowStatus[];
+    limit?: number;
+}
+/**
+ * Atomic update payload for a task within a workflow.
+ */
+export interface WorkflowTaskUpdate {
+    taskId: string;
+    status?: WorkflowTaskStatus;
+    assignedExecutorId?: string;
+    startedAt?: string;
+    completedAt?: string;
+    output?: unknown;
+    error?: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    } | null;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Interface implemented by persistence layers capable of storing workflow state.
+ */
+export interface IWorkflowStore {
+    /**
+     * Persists a newly created workflow instance and its initial tasks snapshot.
+     */
+    createInstance(data: WorkflowCreateInput, initialTasks: WorkflowInstance['tasks']): Promise<WorkflowInstance>;
+    /**
+     * Retrieves a workflow instance by identifier.
+     */
+    getInstance(workflowId: string): Promise<WorkflowInstance | null>;
+    /**
+     * Applies a partial update to the workflow instance metadata/state.
+     */
+    updateInstance(workflowId: string, patch: Partial<Pick<WorkflowInstance, 'status' | 'updatedAt' | 'metadata' | 'context' | 'roleAssignments' | 'agencyState'>>): Promise<WorkflowInstance | null>;
+    /**
+     * Applies updates to one or more tasks within a workflow instance atomically.
+     */
+    updateTasks(workflowId: string, updates: WorkflowTaskUpdate[]): Promise<WorkflowInstance | null>;
+    /**
+     * Appends workflow events for auditing/streaming purposes.
+     */
+    appendEvents(events: WorkflowEvent[]): Promise<void>;
+    /**
+     * Lists workflow instances matching the supplied filters.
+     */
+    listInstances(options?: WorkflowQueryOptions): Promise<WorkflowInstance[]>;
+    /**
+     * Produces a payload representing the current workflow snapshot and optionally recent events.
+     */
+    buildProgressUpdate(workflowId: string, sinceTimestamp?: string): Promise<WorkflowProgressUpdate | null>;
+}
+//# sourceMappingURL=IWorkflowStore.d.ts.map