@framers/agentos 0.1.0

package/dist/core/workflows/WorkflowEngine.d.ts

@@ -0,0 +1,28 @@
+import { WorkflowDefinition, WorkflowDescriptorPayload, WorkflowEvent, WorkflowInstance, WorkflowProgressUpdate, WorkflowStatus } from './WorkflowTypes';
+import type { WorkflowQueryOptions, WorkflowTaskUpdate } from './storage/IWorkflowStore';
+import type { IWorkflowEngine, StartWorkflowOptions, WorkflowEngineConfig, WorkflowEngineDependencies, WorkflowEngineEventListener } from './IWorkflowEngine';
+export declare class WorkflowEngine implements IWorkflowEngine {
+    private initialized;
+    private config;
+    private store;
+    private readonly definitions;
+    private readonly emitter;
+    private logger;
+    private activeWorkflowCount;
+    initialize(config: WorkflowEngineConfig, deps: WorkflowEngineDependencies): Promise<void>;
+    registerWorkflowDescriptor(descriptor: WorkflowDescriptorPayload): Promise<void>;
+    unregisterWorkflowDescriptor(workflowDefinitionId: string): Promise<void>;
+    listWorkflowDefinitions(): WorkflowDefinition[];
+    startWorkflow(options: StartWorkflowOptions): Promise<WorkflowInstance>;
+    getWorkflow(workflowId: string): Promise<WorkflowInstance | null>;
+    updateWorkflowStatus(workflowId: string, status: WorkflowStatus): Promise<WorkflowInstance | null>;
+    applyTaskUpdates(workflowId: string, updates: WorkflowTaskUpdate[]): Promise<WorkflowInstance | null>;
+    updateWorkflowAgencyState(workflowId: string, agencyState: WorkflowInstance['agencyState']): Promise<WorkflowInstance | null>;
+    recordEvents(events: WorkflowEvent[]): Promise<void>;
+    listWorkflows(options?: WorkflowQueryOptions): Promise<WorkflowInstance[]>;
+    getWorkflowProgress(workflowId: string, sinceTimestamp?: string): Promise<WorkflowProgressUpdate | null>;
+    onEvent(listener: WorkflowEngineEventListener): void;
+    offEvent(listener: WorkflowEngineEventListener): void;
+    private ensureInitialized;
+}
+//# sourceMappingURL=WorkflowEngine.d.ts.map

package/dist/core/workflows/WorkflowEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowEngine.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/WorkflowEngine.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EAIf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAEV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAyG3B,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,mBAAmB,CAAK;IAEnB,UAAU,CACrB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;IAeH,0BAA0B,CAAC,UAAU,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhF,4BAA4B,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/E,uBAAuB,IAAI,kBAAkB,EAAE;IAKzC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkEvE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAMjE,oBAAoB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA4BtB,gBAAgB,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA2DtB,yBAAyB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,GAC3C,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgBtB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM1E,mBAAmB,CAC9B,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAKlC,OAAO,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAIpD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAI5D,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/core/workflows/WorkflowEngine.js

@@ -0,0 +1,309 @@
+import { EventEmitter } from 'node:events';
+import { v4 as uuidv4 } from 'uuid';
+import { createLogger } from '../../logging/loggerFactory.js';
+import { WorkflowStatus, WorkflowTaskStatus, } from './WorkflowTypes.js';
+const TERMINAL_STATUSES = [
+    WorkflowStatus.COMPLETED,
+    WorkflowStatus.CANCELLED,
+    WorkflowStatus.ERRORED,
+];
+function isTerminal(status) {
+    return TERMINAL_STATUSES.includes(status);
+}
+function cloneInstance(instance) {
+    return JSON.parse(JSON.stringify(instance));
+}
+function buildInitialTasks(definition) {
+    const dependencyMap = new Map();
+    for (const task of definition.tasks) {
+        dependencyMap.set(task.id, new Set(task.dependsOn ?? []));
+    }
+    const result = {};
+    for (const task of definition.tasks) {
+        const dependencies = dependencyMap.get(task.id);
+        const initialStatus = !dependencies || dependencies.size === 0 ? WorkflowTaskStatus.READY : WorkflowTaskStatus.PENDING;
+        result[task.id] = {
+            definitionId: task.id,
+            status: initialStatus,
+            metadata: {},
+        };
+    }
+    return result;
+}
+function validateWorkflowDefinition(definition) {
+    const taskIds = new Set();
+    for (const task of definition.tasks) {
+        if (taskIds.has(task.id)) {
+            throw new Error(`Workflow definition '${definition.id}' contains duplicate task id '${task.id}'.`);
+        }
+        taskIds.add(task.id);
+    }
+    const missingDeps = [];
+    for (const task of definition.tasks) {
+        for (const dependency of task.dependsOn ?? []) {
+            if (!taskIds.has(dependency)) {
+                missingDeps.push({ taskId: task.id, dependencyId: dependency });
+            }
+        }
+    }
+    if (missingDeps.length > 0) {
+        const formatted = missingDeps
+            .map(({ taskId, dependencyId }) => `'${taskId}' -> '${dependencyId}'`)
+            .join(', ');
+        throw new Error(`Workflow definition '${definition.id}' references missing task dependencies: ${formatted}`);
+    }
+    if (hasCycles(definition.tasks)) {
+        throw new Error(`Workflow definition '${definition.id}' contains cyclic dependencies.`);
+    }
+}
+function hasCycles(tasks) {
+    const graph = new Map(tasks.map((task) => [task.id, task.dependsOn ?? []]));
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (node) => {
+        if (visiting.has(node)) {
+            return true;
+        }
+        if (visited.has(node)) {
+            return false;
+        }
+        visiting.add(node);
+        for (const dep of graph.get(node) ?? []) {
+            if (visit(dep)) {
+                return true;
+            }
+        }
+        visiting.delete(node);
+        visited.add(node);
+        return false;
+    };
+    for (const node of graph.keys()) {
+        if (visit(node)) {
+            return true;
+        }
+    }
+    return false;
+}
+export class WorkflowEngine {
+    constructor() {
+        this.initialized = false;
+        this.config = {
+            maxConcurrentWorkflows: Number.POSITIVE_INFINITY,
+            defaultWorkflowTimeoutSeconds: 0,
+        };
+        this.definitions = new Map();
+        this.emitter = new EventEmitter();
+        this.logger = createLogger('WorkflowEngine');
+        this.activeWorkflowCount = 0;
+    }
+    async initialize(config, deps) {
+        this.config = {
+            maxConcurrentWorkflows: config.maxConcurrentWorkflows ?? Number.POSITIVE_INFINITY,
+            defaultWorkflowTimeoutSeconds: config.defaultWorkflowTimeoutSeconds ?? 0,
+        };
+        this.store = deps.store;
+        this.logger = deps.logger ?? createLogger('WorkflowEngine');
+        this.initialized = true;
+        this.logger.info('Workflow engine initialised', {
+            maxConcurrentWorkflows: this.config.maxConcurrentWorkflows,
+        });
+    }
+    async registerWorkflowDescriptor(descriptor) {
+        this.ensureInitialized();
+        const { definition, metadata } = descriptor;
+        validateWorkflowDefinition(definition);
+        this.definitions.set(definition.id, { definition, metadata });
+        this.logger.debug?.('Registered workflow definition', { definitionId: definition.id });
+    }
+    async unregisterWorkflowDescriptor(workflowDefinitionId) {
+        this.ensureInitialized();
+        this.definitions.delete(workflowDefinitionId);
+        this.logger.debug?.('Unregistered workflow definition', { workflowDefinitionId });
+    }
+    listWorkflowDefinitions() {
+        this.ensureInitialized();
+        return Array.from(this.definitions.values()).map(({ definition }) => ({ ...definition }));
+    }
+    async startWorkflow(options) {
+        this.ensureInitialized();
+        if (this.config.maxConcurrentWorkflows !== Number.POSITIVE_INFINITY &&
+            this.activeWorkflowCount >= this.config.maxConcurrentWorkflows) {
+            throw new Error('WorkflowEngine capacity exceeded.');
+        }
+        const { definition } = options;
+        const registered = this.definitions.get(definition.id);
+        if (!registered) {
+            throw new Error(`Workflow definition '${definition.id}' is not registered.`);
+        }
+        const workflowId = options.workflowId ?? uuidv4();
+        const nowIso = new Date().toISOString();
+        const conversationId = options.conversationId ?? options.input.conversationId ?? options.input.sessionId;
+        const createdByUserId = options.createdByUserId ?? options.input.userId;
+        const tasks = buildInitialTasks(registered.definition);
+        const instance = await this.store.createInstance({
+            workflowId,
+            definitionId: registered.definition.id,
+            definitionVersion: registered.definition.version,
+            createdAt: nowIso,
+            createdByUserId,
+            conversationId,
+            context: options.context,
+            roleAssignments: options.roleAssignments,
+            metadata: options.metadata,
+        }, tasks);
+        const runningInstance = (await this.store.updateInstance(workflowId, {
+            status: WorkflowStatus.RUNNING,
+            updatedAt: nowIso,
+        })) ?? instance;
+        const createdEvent = {
+            eventId: uuidv4(),
+            workflowId: runningInstance.workflowId,
+            definitionId: runningInstance.definitionId,
+            timestamp: nowIso,
+            type: 'workflow_created',
+            payload: {
+                conversationId,
+                createdByUserId,
+                input: {
+                    userId: options.input.userId,
+                    sessionId: options.input.sessionId,
+                    selectedPersonaId: options.input.selectedPersonaId,
+                },
+            },
+        };
+        await this.recordEvents([createdEvent]);
+        this.activeWorkflowCount += 1;
+        this.logger.info('Workflow started', { workflowId: runningInstance.workflowId });
+        return cloneInstance(runningInstance);
+    }
+    async getWorkflow(workflowId) {
+        this.ensureInitialized();
+        const instance = await this.store.getInstance(workflowId);
+        return instance ? cloneInstance(instance) : null;
+    }
+    async updateWorkflowStatus(workflowId, status) {
+        this.ensureInitialized();
+        const nowIso = new Date().toISOString();
+        const updated = await this.store.updateInstance(workflowId, {
+            status,
+            updatedAt: nowIso,
+        });
+        if (!updated) {
+            return null;
+        }
+        if (isTerminal(status)) {
+            this.activeWorkflowCount = Math.max(0, this.activeWorkflowCount - 1);
+        }
+        const event = {
+            eventId: uuidv4(),
+            workflowId,
+            definitionId: updated.definitionId,
+            timestamp: nowIso,
+            type: 'workflow_status_changed',
+            payload: { status },
+        };
+        await this.recordEvents([event]);
+        this.logger.debug?.('Workflow status updated', { workflowId, status });
+        return cloneInstance(updated);
+    }
+    async applyTaskUpdates(workflowId, updates) {
+        this.ensureInitialized();
+        if (updates.length === 0) {
+            return this.getWorkflow(workflowId);
+        }
+        const nowIso = new Date().toISOString();
+        const updated = await this.store.updateTasks(workflowId, updates);
+        if (!updated) {
+            return null;
+        }
+        const events = [];
+        for (const update of updates) {
+            if (update.status) {
+                events.push({
+                    eventId: uuidv4(),
+                    workflowId,
+                    definitionId: updated.definitionId,
+                    taskId: update.taskId,
+                    timestamp: nowIso,
+                    type: 'task_status_changed',
+                    payload: {
+                        status: update.status,
+                        assignedExecutorId: update.assignedExecutorId,
+                    },
+                });
+            }
+            if (update.output !== undefined) {
+                events.push({
+                    eventId: uuidv4(),
+                    workflowId,
+                    definitionId: updated.definitionId,
+                    taskId: update.taskId,
+                    timestamp: nowIso,
+                    type: 'task_output_emitted',
+                    payload: { output: update.output },
+                });
+            }
+            if (update.error) {
+                events.push({
+                    eventId: uuidv4(),
+                    workflowId,
+                    definitionId: updated.definitionId,
+                    taskId: update.taskId,
+                    timestamp: nowIso,
+                    type: 'error',
+                    payload: update.error,
+                });
+            }
+        }
+        if (events.length > 0) {
+            await this.recordEvents(events);
+        }
+        this.logger.debug?.('Workflow tasks updated', { workflowId, updatesCount: updates.length });
+        return cloneInstance(updated);
+    }
+    async updateWorkflowAgencyState(workflowId, agencyState) {
+        this.ensureInitialized();
+        const nowIso = new Date().toISOString();
+        const updated = await this.store.updateInstance(workflowId, {
+            agencyState,
+            updatedAt: nowIso,
+        });
+        if (updated) {
+            this.logger.debug?.('Workflow agency state updated', {
+                workflowId,
+                agencyId: agencyState?.agencyId,
+            });
+        }
+        return updated ? cloneInstance(updated) : null;
+    }
+    async recordEvents(events) {
+        if (!events.length) {
+            return;
+        }
+        await this.store.appendEvents(events);
+        for (const event of events) {
+            this.emitter.emit('event', event);
+        }
+    }
+    async listWorkflows(options) {
+        this.ensureInitialized();
+        const instances = await this.store.listInstances(options);
+        return instances.map(cloneInstance);
+    }
+    async getWorkflowProgress(workflowId, sinceTimestamp) {
+        this.ensureInitialized();
+        return this.store.buildProgressUpdate(workflowId, sinceTimestamp);
+    }
+    onEvent(listener) {
+        this.emitter.on('event', listener);
+    }
+    offEvent(listener) {
+        this.emitter.off('event', listener);
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('WorkflowEngine has not been initialised.');
+        }
+    }
+}
+//# sourceMappingURL=WorkflowEngine.js.map

package/dist/core/workflows/WorkflowEngine.js.map

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

package/dist/core/workflows/WorkflowTypes.d.ts

@@ -0,0 +1,180 @@
+import type { JSONSchemaObject } from '../tools/ITool';
+import type { AgencySeatHistoryEntry } from '../agency/AgencyTypes';
+/**
+ * High-level lifecycle states for a workflow instance.
+ */
+export declare enum WorkflowStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    AWAITING_INPUT = "awaiting_input",
+    ERRORED = "errored",
+    COMPLETED = "completed",
+    CANCELLED = "cancelled"
+}
+/**
+ * Lifecycle states for a task within a workflow.
+ */
+export declare enum WorkflowTaskStatus {
+    PENDING = "pending",
+    READY = "ready",
+    IN_PROGRESS = "in_progress",
+    BLOCKED = "blocked",
+    COMPLETED = "completed",
+    SKIPPED = "skipped",
+    FAILED = "failed"
+}
+/**
+ * Categories describing who or what executes a workflow task.
+ */
+export type WorkflowTaskExecutorType = 'gmi' | 'human' | 'tool' | 'extension';
+/**
+ * Declarative role definition referenced by workflow tasks.
+ */
+export interface WorkflowRoleDefinition {
+    roleId: string;
+    displayName: string;
+    description?: string;
+    personaId?: string;
+    personaTraits?: Record<string, unknown>;
+    evolutionRules?: PersonaEvolutionRule[];
+    personaCapabilityRequirements?: string[];
+    toolCapabilityRequirements?: string[];
+    guardrailPolicyTags?: string[];
+    defaultAssigneeStrategy?: 'primary_gmi' | 'conversation_owner' | 'host_supplied';
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Declarative task definition within a workflow.
+ */
+export interface WorkflowTaskDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    dependsOn?: string[];
+    executor: {
+        type: WorkflowTaskExecutorType;
+        roleId?: string;
+        personaId?: string;
+        instructions?: string;
+        extensionId?: string;
+    };
+    inputSchema?: JSONSchemaObject;
+    outputSchema?: JSONSchemaObject;
+    policyTags?: string[];
+    retryPolicy?: {
+        maxAttempts: number;
+        backoffSeconds?: number;
+        strategy?: 'exponential' | 'linear' | 'fixed';
+    };
+    skippable?: boolean;
+    metadata?: Record<string, unknown>;
+    handoff?: Record<string, unknown>;
+}
+export interface WorkflowDefinitionMetadata {
+    requiredSecrets?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Declarative descriptor for a workflow definition.
+ */
+export interface WorkflowDefinition {
+    id: string;
+    version?: string;
+    displayName: string;
+    description?: string;
+    goalSchema?: JSONSchemaObject;
+    finalOutputSchema?: JSONSchemaObject;
+    roles?: WorkflowRoleDefinition[];
+    tasks: WorkflowTaskDefinition[];
+    policyTags?: string[];
+    requiresConversationContext?: boolean;
+    metadata?: WorkflowDefinitionMetadata;
+}
+/**
+ * Runtime snapshot of a single task inside a workflow instance.
+ */
+export interface WorkflowTaskInstance {
+    definitionId: string;
+    status: WorkflowTaskStatus;
+    assignedRoleId?: string;
+    assignedExecutorId?: string;
+    startedAt?: string;
+    completedAt?: string;
+    output?: unknown;
+    error?: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface WorkflowAgencySeatSnapshot {
+    roleId: string;
+    gmiInstanceId: string;
+    personaId: string;
+    attachedAt?: string;
+    metadata?: Record<string, unknown>;
+    history?: AgencySeatHistoryEntry[];
+}
+/**
+ * Runtime snapshot of a workflow instance.
+ */
+export interface WorkflowInstance {
+    workflowId: string;
+    definitionId: string;
+    definitionVersion?: string;
+    status: WorkflowStatus;
+    createdAt: string;
+    updatedAt: string;
+    conversationId?: string;
+    createdByUserId?: string;
+    context?: Record<string, unknown>;
+    roleAssignments?: Record<string, string>;
+    tasks: Record<string, WorkflowTaskInstance>;
+    agencyState?: {
+        agencyId: string;
+        seats: Record<string, WorkflowAgencySeatSnapshot>;
+        metadata?: Record<string, unknown>;
+    };
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Structured event emitted as workflows progress.
+ */
+export interface WorkflowEvent {
+    eventId: string;
+    workflowId: string;
+    definitionId: string;
+    taskId?: string;
+    timestamp: string;
+    type: 'workflow_created' | 'workflow_status_changed' | 'task_status_changed' | 'task_output_emitted' | 'guardrail_applied' | 'error' | 'custom';
+    payload?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payload streamed to clients describing workflow progress.
+ */
+export interface WorkflowProgressUpdate {
+    workflow: WorkflowInstance;
+    recentEvents?: WorkflowEvent[];
+}
+/**
+ * Descriptor payload stored in the extension registry for workflows.
+ */
+export interface WorkflowDescriptorPayload {
+    definition: WorkflowDefinition;
+    metadata?: Record<string, unknown>;
+}
+export interface PersonaPatch {
+    personaTraits?: Record<string, unknown>;
+    mood?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PersonaEvolutionRule {
+    id: string;
+    description?: string;
+    trigger: string | Record<string, unknown>;
+    patch: PersonaPatch;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=WorkflowTypes.d.ts.map

package/dist/core/workflows/WorkflowTypes.d.ts.map

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

package/dist/core/workflows/WorkflowTypes.js

@@ -0,0 +1,26 @@
+/**
+ * High-level lifecycle states for a workflow instance.
+ */
+export var WorkflowStatus;
+(function (WorkflowStatus) {
+    WorkflowStatus["PENDING"] = "pending";
+    WorkflowStatus["RUNNING"] = "running";
+    WorkflowStatus["AWAITING_INPUT"] = "awaiting_input";
+    WorkflowStatus["ERRORED"] = "errored";
+    WorkflowStatus["COMPLETED"] = "completed";
+    WorkflowStatus["CANCELLED"] = "cancelled";
+})(WorkflowStatus || (WorkflowStatus = {}));
+/**
+ * Lifecycle states for a task within a workflow.
+ */
+export var WorkflowTaskStatus;
+(function (WorkflowTaskStatus) {
+    WorkflowTaskStatus["PENDING"] = "pending";
+    WorkflowTaskStatus["READY"] = "ready";
+    WorkflowTaskStatus["IN_PROGRESS"] = "in_progress";
+    WorkflowTaskStatus["BLOCKED"] = "blocked";
+    WorkflowTaskStatus["COMPLETED"] = "completed";
+    WorkflowTaskStatus["SKIPPED"] = "skipped";
+    WorkflowTaskStatus["FAILED"] = "failed";
+})(WorkflowTaskStatus || (WorkflowTaskStatus = {}));
+//# sourceMappingURL=WorkflowTypes.js.map

package/dist/core/workflows/WorkflowTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTypes.js","sourceRoot":"","sources":["../../../src/core/workflows/WorkflowTypes.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mDAAiC,CAAA;IACjC,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;AACzB,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,iDAA2B,CAAA;IAC3B,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;AACnB,CAAC,EARW,kBAAkB,KAAlB,kBAAkB,QAQ7B"}

package/dist/core/workflows/runtime/WorkflowRuntime.d.ts

@@ -0,0 +1,70 @@
+import type { WorkflowEngine } from '../WorkflowEngine';
+import type { WorkflowTaskDefinition } from '../WorkflowTypes';
+import type { GMIManager } from '../../../cognitive_substrate/GMIManager';
+import type { StreamingManager } from '../../streaming/StreamingManager';
+import type { IToolOrchestrator } from '../../tools/IToolOrchestrator';
+import type { ILogger } from '../../../logging/ILogger';
+import { AgencyRegistry } from '../../agency/AgencyRegistry';
+import type { AgencySession } from '../../agency/AgencyTypes';
+import type { ExtensionManager } from '../../../extensions';
+/**
+ * Dependencies required to bootstrap the workflow runtime.
+ */
+export interface WorkflowRuntimeDependencies {
+    workflowEngine: WorkflowEngine;
+    gmiManager: GMIManager;
+    streamingManager: StreamingManager;
+    toolOrchestrator: IToolOrchestrator;
+    agencyRegistry?: AgencyRegistry;
+    extensionManager: ExtensionManager;
+    logger?: ILogger;
+}
+export declare class WorkflowRuntime {
+    private readonly deps;
+    private readonly queue;
+    private readonly agencyRegistry;
+    private readonly extensionManager;
+    private workflowListener?;
+    private started;
+    private readonly definitionCache;
+    constructor(deps: WorkflowRuntimeDependencies);
+    /**
+     * Begins listening to workflow engine events and prepares the execution queue.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the runtime, drains queued tasks, and detaches event listeners.
+     */
+    stop(): Promise<void>;
+    /**
+     * Handles workflow engine events. At this stage we only log structural changes; execution
+     * hooks will be connected as the multi-GMI runtime evolves.
+     */
+    private handleWorkflowEvent;
+    /**
+     * 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.
+     */
+    private enqueueTaskExecution;
+    /**
+     * Helper used by future implementations to resolve a task definition from the workflow definition catalogue.
+     * Provided here to keep the scaffolding self-contained.
+     */
+    protected resolveTaskDefinition(definitionId: string, taskId: string): WorkflowTaskDefinition | undefined;
+    /**
+     * Emits an Agency update to downstream consumers. Placeholder implementation until the runtime
+     * fully manages stream identifiers per Agency seat.
+     */
+    protected emitAgencyUpdate(session: AgencySession): Promise<void>;
+    private getWorkflowDefinition;
+    private executeGmiTask;
+    private executeToolTask;
+    private executeExtensionTask;
+    private collectGmiResponse;
+    private buildOutputPreview;
+    private buildEvolutionContext;
+    private syncWorkflowAgencyState;
+}
+//# sourceMappingURL=WorkflowRuntime.d.ts.map

package/dist/core/workflows/runtime/WorkflowRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowRuntime.d.ts","sourceRoot":"","sources":["../../../../src/core/workflows/runtime/WorkflowRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAIV,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,yCAAyC,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqB/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA4ED,qBAAa,eAAe;IAQd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,gBAAgB,CAAC,CAAiD;IAC1E,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;gBAE5C,IAAI,EAAE,2BAA2B;IAK9D;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC;;;OAGG;YACW,mBAAmB;IAwBjC;;;;;OAKG;YAEW,oBAAoB;IAiElC;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAKzG;;;OAGG;cACa,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvE,OAAO,CAAC,qBAAqB;YAYf,cAAc;YA+Id,eAAe;YAsEf,oBAAoB;YAqDpB,kBAAkB;IA+BhC,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,qBAAqB;YA4Bf,uBAAuB;CAmBtC"}