@pasko70/pibo 3.3.0 → 3.4.1

package/packages/workflows/dist/inspection/index.d.ts

@@ -0,0 +1,47 @@
+import type { EdgeTransfer, NodeAttempt, NodeAttemptId, WorkflowCheckpoint, WorkflowErrorSummary, WorkflowEventRecord, WorkflowHumanActionRecord, WorkflowRun, WorkflowRunId, WorkflowWaitToken, WorkflowWakeup } from "../types/index.js";
+import type { WorkflowCheckpointStore, WorkflowEdgeTransferStore, WorkflowEventStore, WorkflowHumanActionStore, WorkflowNodeAttemptStore, WorkflowRunStore, WorkflowWaitTokenStore, WorkflowWakeupStore } from "../store/index.js";
+export type WorkflowRunInspectionStore = WorkflowRunStore & Partial<WorkflowEventStore> & Partial<WorkflowNodeAttemptStore> & Partial<WorkflowEdgeTransferStore> & Partial<WorkflowCheckpointStore> & Partial<WorkflowWakeupStore> & Partial<WorkflowWaitTokenStore> & Partial<WorkflowHumanActionStore>;
+export type WorkflowRunInspectionOptions = {
+    limit?: number;
+};
+export type WorkflowRunInspectionSummary = {
+    runId: WorkflowRunId;
+    workflowId: string;
+    workflowVersion: string;
+    status: WorkflowRun["status"];
+    piboSessionId?: string;
+    currentNodeId?: string;
+    currentEdgeId?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    failedAt?: string;
+    cancelledAt?: string;
+    nodeAttempts: number;
+    completedNodeAttempts: number;
+    failedNodeAttempts: number;
+    waitingNodeAttempts: number;
+    pendingWaitTokens: number;
+    edgeTransfers: number;
+    events: number;
+    latestCheckpointId?: string;
+    failedNodeId?: string;
+    failedNodeAttemptId?: NodeAttemptId;
+    error?: WorkflowErrorSummary;
+};
+export type WorkflowRunInspection = {
+    kind: "workflowRunInspection";
+    schemaVersion: 1;
+    summary: WorkflowRunInspectionSummary;
+    run: WorkflowRun;
+    nodeAttempts: NodeAttempt[];
+    edgeTransfers: EdgeTransfer[];
+    checkpoints: WorkflowCheckpoint[];
+    wakeups: WorkflowWakeup[];
+    waitTokens: WorkflowWaitToken[];
+    humanActions: WorkflowHumanActionRecord[];
+    events: WorkflowEventRecord[];
+};
+export declare function inspectWorkflowRun(store: WorkflowRunInspectionStore, runId: WorkflowRunId, options?: WorkflowRunInspectionOptions): Promise<WorkflowRunInspection | undefined>;
+export declare function formatWorkflowRunInspection(inspection: WorkflowRunInspection): string;
+//# sourceMappingURL=index.d.ts.map

package/packages/workflows/dist/inspection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GACrD,OAAO,CAAC,kBAAkB,CAAC,GAC3B,OAAO,CAAC,wBAAwB,CAAC,GACjC,OAAO,CAAC,yBAAyB,CAAC,GAClC,OAAO,CAAC,uBAAuB,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,GAC5B,OAAO,CAAC,sBAAsB,CAAC,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEtC,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,aAAa,CAAC;IACpC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,4BAA4B,CAAC;IACtC,GAAG,EAAE,WAAW,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,YAAY,EAAE,yBAAyB,EAAE,CAAC;IAC1C,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAgC5C;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAsBrF"}

package/packages/workflows/dist/inspection/index.js

@@ -0,0 +1,131 @@
+export async function inspectWorkflowRun(store, runId, options = {}) {
+    const run = await store.getRun(runId);
+    if (!run)
+        return undefined;
+    const limit = normalizeInspectionLimit(options.limit);
+    const nodeAttempts = sortNodeAttempts(await listOptional(store, store.listNodeAttempts, { workflowRunId: run.id, limit }));
+    const edgeTransfers = await listOptional(store, store.listEdgeTransfers, { workflowRunId: run.id, limit });
+    const checkpoints = await listOptional(store, store.listCheckpoints, { workflowRunId: run.id, limit });
+    const wakeups = await listOptional(store, store.listWakeups, { workflowRunId: run.id, limit });
+    const waitTokens = await listOptional(store, store.listWaitTokens, { workflowRunId: run.id, limit });
+    const humanActions = await listOptional(store, store.listHumanActions, { workflowRunId: run.id, limit });
+    const events = await listOptional(store, store.listEvents, { workflowRunId: run.id, limit });
+    return {
+        kind: "workflowRunInspection",
+        schemaVersion: 1,
+        summary: createInspectionSummary(run, {
+            nodeAttempts,
+            edgeTransfers,
+            checkpoints,
+            waitTokens,
+            events,
+        }),
+        run,
+        nodeAttempts,
+        edgeTransfers,
+        checkpoints,
+        wakeups,
+        waitTokens,
+        humanActions,
+        events,
+    };
+}
+export function formatWorkflowRunInspection(inspection) {
+    const { summary } = inspection;
+    const lines = [
+        `run\t${summary.runId}`,
+        `workflow\t${summary.workflowId}@${summary.workflowVersion}`,
+        `status\t${summary.status}`,
+    ];
+    if (summary.piboSessionId)
+        lines.push(`pibo_session\t${summary.piboSessionId}`);
+    if (summary.currentNodeId)
+        lines.push(`current_node\t${summary.currentNodeId}`);
+    if (summary.currentEdgeId)
+        lines.push(`current_edge\t${summary.currentEdgeId}`);
+    if (summary.latestCheckpointId)
+        lines.push(`checkpoint\t${summary.latestCheckpointId}`);
+    if (summary.failedNodeId)
+        lines.push(`failed_node\t${summary.failedNodeId}`);
+    if (summary.failedNodeAttemptId)
+        lines.push(`failed_attempt\t${summary.failedNodeAttemptId}`);
+    if (summary.error)
+        lines.push(`error\t${summary.error.code}\t${summary.error.message}`);
+    lines.push(`attempts\t${summary.nodeAttempts}\tcompleted=${summary.completedNodeAttempts}\tfailed=${summary.failedNodeAttempts}\twaiting=${summary.waitingNodeAttempts}`, `wait_tokens\t${summary.pendingWaitTokens} pending`, `edge_transfers\t${summary.edgeTransfers}`, `events\t${summary.events}`, `updated\t${summary.updatedAt}`);
+    return lines.join("\n");
+}
+function createInspectionSummary(run, facts) {
+    const failedAttempt = latestNodeAttempt(facts.nodeAttempts.filter((attempt) => attempt.status === "failed"));
+    const latestCheckpoint = latestCheckpointByCreatedAt(facts.checkpoints);
+    const failedEventError = latestWorkflowFailedEventError(facts.events);
+    return {
+        runId: run.id,
+        workflowId: run.workflowId,
+        workflowVersion: run.workflowVersion,
+        status: run.status,
+        ...(run.piboSessionId ? { piboSessionId: run.piboSessionId } : {}),
+        ...(run.current.nodeId ? { currentNodeId: run.current.nodeId } : {}),
+        ...(run.current.edgeId ? { currentEdgeId: run.current.edgeId } : {}),
+        createdAt: run.createdAt,
+        updatedAt: run.updatedAt,
+        ...(run.completedAt ? { completedAt: run.completedAt } : {}),
+        ...(run.failedAt ? { failedAt: run.failedAt } : {}),
+        ...(run.cancelledAt ? { cancelledAt: run.cancelledAt } : {}),
+        nodeAttempts: facts.nodeAttempts.length,
+        completedNodeAttempts: facts.nodeAttempts.filter((attempt) => attempt.status === "completed").length,
+        failedNodeAttempts: facts.nodeAttempts.filter((attempt) => attempt.status === "failed").length,
+        waitingNodeAttempts: facts.nodeAttempts.filter((attempt) => attempt.status === "waiting").length,
+        pendingWaitTokens: facts.waitTokens.filter((token) => token.status === "pending").length,
+        edgeTransfers: facts.edgeTransfers.length,
+        events: facts.events.length,
+        ...(latestCheckpoint ? { latestCheckpointId: latestCheckpoint.id } : {}),
+        ...(failedAttempt ? { failedNodeId: failedAttempt.nodeId, failedNodeAttemptId: failedAttempt.id } : {}),
+        ...(failedAttempt?.error ?? failedEventError ? { error: failedAttempt?.error ?? failedEventError } : {}),
+    };
+}
+async function listOptional(store, list, filter) {
+    if (!list)
+        return [];
+    return list.call(store, filter);
+}
+function normalizeInspectionLimit(limit) {
+    if (limit === undefined)
+        return 1000;
+    if (!Number.isInteger(limit) || limit < 1)
+        throw new Error("Workflow inspection limit must be a positive integer");
+    return Math.min(limit, 1000);
+}
+function sortNodeAttempts(attempts) {
+    return [...attempts].sort((left, right) => compareNullableStrings(attemptSortKey(left), attemptSortKey(right)) || left.id.localeCompare(right.id));
+}
+function latestNodeAttempt(attempts) {
+    return [...attempts].sort((left, right) => compareNullableStrings(attemptSortKey(right), attemptSortKey(left)) || right.id.localeCompare(left.id))[0];
+}
+function latestCheckpointByCreatedAt(checkpoints) {
+    return [...checkpoints].sort((left, right) => compareNullableStrings(right.createdAt, left.createdAt) || right.id.localeCompare(left.id))[0];
+}
+function attemptSortKey(attempt) {
+    return attempt.startedAt ?? attempt.availableAt ?? attempt.completedAt ?? attempt.failedAt;
+}
+function compareNullableStrings(left, right) {
+    if (left === right)
+        return 0;
+    if (left === undefined)
+        return 1;
+    if (right === undefined)
+        return -1;
+    return left.localeCompare(right);
+}
+function latestWorkflowFailedEventError(events) {
+    const failedEvent = [...events]
+        .filter((event) => event.type === "workflow.failed")
+        .sort((left, right) => compareNullableStrings(right.createdAt, left.createdAt) || right.id.localeCompare(left.id))[0];
+    const payload = failedEvent?.payload;
+    if (!payload || typeof payload !== "object" || !("error" in payload))
+        return undefined;
+    const error = payload.error;
+    if (!error || typeof error !== "object" || !("code" in error) || !("message" in error))
+        return undefined;
+    return error;
+}
+//# sourceMappingURL=index.js.map

package/packages/workflows/dist/inspection/index.js.map

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

package/packages/workflows/dist/registry/index.d.ts

@@ -0,0 +1,30 @@
+import type { AdapterHandler, AdapterRef, AgentProfileDefinition, CodeNodeHandler, GuardHandler, PromptBuilderHandler, PromptBuilderRef, RegistryRefId, WorkflowDefinition, WorkflowHumanActionDefinition, WorkflowProviders, WorkflowPublishedVersionRecord, WorkflowRegistry, WorkflowRegistryEntry, WorkflowRegistration, WorkflowRegistrationOptions, JsonSchema } from "../types/index.js";
+export type WorkflowRegistryEntryOptions = WorkflowRegistrationOptions & {
+    title?: string;
+    description?: string;
+    tags?: string[];
+    paramsSchema?: JsonSchema;
+};
+export declare function createWorkflowRegistry(providers?: WorkflowProviders): WorkflowRegistry;
+export declare function registerProviders(registry: WorkflowRegistry, providers: WorkflowProviders, options?: WorkflowRegistrationOptions): WorkflowRegistry;
+export declare function registerWorkflowDefinition(registry: WorkflowRegistry, definition: WorkflowDefinition, options?: WorkflowRegistrationOptions): void;
+export declare function resolveWorkflowDefinition(registry: Pick<WorkflowRegistry, "workflows">, id: string, version?: string): WorkflowDefinition | undefined;
+export declare function registerWorkflowPublishedVersion(registry: WorkflowRegistry, record: WorkflowPublishedVersionRecord, options?: WorkflowRegistrationOptions): WorkflowRegistration;
+export declare function registerWorkflowPublishedVersions(registry: WorkflowRegistry, records: Iterable<WorkflowPublishedVersionRecord>, options?: WorkflowRegistrationOptions): WorkflowRegistration[];
+export declare function registerWorkflowAgentProfile(registry: WorkflowRegistry, id: RegistryRefId, profile: AgentProfileDefinition, options?: WorkflowRegistryEntryOptions): WorkflowRegistryEntry<AgentProfileDefinition>;
+export declare function registerWorkflowHandler(registry: WorkflowRegistry, id: RegistryRefId, handler: CodeNodeHandler, options?: WorkflowRegistryEntryOptions): WorkflowRegistryEntry<CodeNodeHandler>;
+export declare function registerWorkflowAdapter(registry: WorkflowRegistry, id: RegistryRefId, adapter: AdapterHandler, options?: WorkflowRegistryEntryOptions): WorkflowRegistryEntry<AdapterHandler>;
+export declare function registerWorkflowGuard(registry: WorkflowRegistry, id: RegistryRefId, guard: GuardHandler, options?: WorkflowRegistryEntryOptions): WorkflowRegistryEntry<GuardHandler>;
+export declare function registerWorkflowPromptBuilder(registry: WorkflowRegistry, id: RegistryRefId, promptBuilder: PromptBuilderHandler, options?: WorkflowRegistryEntryOptions): WorkflowRegistryEntry<PromptBuilderHandler>;
+export declare function registerWorkflowHumanAction(registry: WorkflowRegistry, id: RegistryRefId, humanAction: WorkflowHumanActionDefinition, options?: WorkflowRegistrationOptions): WorkflowHumanActionDefinition;
+export declare function resolveWorkflowHumanAction(registry: Pick<WorkflowRegistry, "humanActions">, ref: RegistryRefId): WorkflowHumanActionDefinition | undefined;
+export declare function hasWorkflowHumanAction(registry: Pick<WorkflowRegistry, "humanActions">, ref: RegistryRefId): boolean;
+export declare function resolveWorkflowAgentProfile(registry: Pick<WorkflowRegistry, "profiles">, ref: RegistryRefId): WorkflowRegistryEntry<AgentProfileDefinition> | undefined;
+export declare function hasWorkflowAgentProfile(registry: Pick<WorkflowRegistry, "profiles">, ref: RegistryRefId): boolean;
+export declare function resolveWorkflowHandler(registry: Pick<WorkflowRegistry, "handlers">, ref: RegistryRefId): WorkflowRegistryEntry<CodeNodeHandler> | undefined;
+export declare function hasWorkflowHandler(registry: Pick<WorkflowRegistry, "handlers">, ref: RegistryRefId): boolean;
+export declare function resolveWorkflowAdapter(registry: Pick<WorkflowRegistry, "adapters">, ref: AdapterRef | RegistryRefId): WorkflowRegistryEntry<AdapterHandler> | undefined;
+export declare function hasWorkflowAdapter(registry: Pick<WorkflowRegistry, "adapters">, ref: AdapterRef | RegistryRefId): boolean;
+export declare function resolveWorkflowPromptBuilder(registry: Pick<WorkflowRegistry, "promptBuilders">, ref: PromptBuilderRef): WorkflowRegistryEntry<PromptBuilderHandler> | undefined;
+export declare function hasWorkflowPromptBuilder(registry: Pick<WorkflowRegistry, "promptBuilders">, ref: PromptBuilderRef): boolean;
+//# sourceMappingURL=index.d.ts.map

package/packages/workflows/dist/registry/index.d.ts.map

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

package/packages/workflows/dist/registry/index.js

@@ -0,0 +1,161 @@
+import { hashWorkflowDefinition } from "../definition-hash.js";
+export function createWorkflowRegistry(providers = {}) {
+    const registry = {
+        workflows: new Map(),
+        profiles: new Map(),
+        handlers: new Map(),
+        adapters: new Map(),
+        guards: new Map(),
+        promptBuilders: new Map(),
+        humanActions: new Map(),
+    };
+    registerProviders(registry, providers, { override: true });
+    return registry;
+}
+export function registerProviders(registry, providers, options = {}) {
+    for (const [id, profile] of Object.entries(providers.profiles ?? {})) {
+        registerWorkflowAgentProfile(registry, id, profile, options);
+    }
+    for (const [id, handler] of Object.entries(providers.handlers ?? {})) {
+        registerWorkflowHandler(registry, id, handler, options);
+    }
+    for (const [id, adapter] of Object.entries(providers.adapters ?? {})) {
+        registerWorkflowAdapter(registry, id, adapter, options);
+    }
+    for (const [id, guard] of Object.entries(providers.guards ?? {})) {
+        registerWorkflowGuard(registry, id, guard, options);
+    }
+    for (const [id, promptBuilder] of Object.entries(providers.promptBuilders ?? {})) {
+        registerWorkflowPromptBuilder(registry, id, promptBuilder, options);
+    }
+    for (const [id, humanAction] of Object.entries(providers.humanActions ?? {})) {
+        registerWorkflowHumanAction(registry, id, humanAction, options);
+    }
+    return registry;
+}
+export function registerWorkflowDefinition(registry, definition, options = {}) {
+    const versions = registry.workflows.get(definition.id) ?? [];
+    const existingIndex = versions.findIndex((item) => item.version === definition.version);
+    if (existingIndex >= 0) {
+        if (!options.override) {
+            throw new Error(`Workflow '${definition.id}@${definition.version}' is already registered.`);
+        }
+        versions[existingIndex] = definition;
+    }
+    else {
+        versions.push(definition);
+    }
+    registry.workflows.set(definition.id, versions);
+}
+export function resolveWorkflowDefinition(registry, id, version) {
+    const versions = registry.workflows.get(id);
+    if (!versions || versions.length === 0) {
+        return undefined;
+    }
+    if (version !== undefined) {
+        return versions.find((definition) => definition.version === version);
+    }
+    return [...versions].sort((left, right) => right.version.localeCompare(left.version))[0];
+}
+export function registerWorkflowPublishedVersion(registry, record, options = {}) {
+    assertRegistryPublishedWorkflowVersionRecord(record);
+    registerWorkflowDefinition(registry, record.definition, options);
+    return { id: record.workflowId, version: record.version, hash: record.definitionHash };
+}
+export function registerWorkflowPublishedVersions(registry, records, options = {}) {
+    const registrations = [];
+    for (const record of records) {
+        registrations.push(registerWorkflowPublishedVersion(registry, record, options));
+    }
+    return registrations;
+}
+function assertRegistryPublishedWorkflowVersionRecord(record) {
+    if (record.source !== "ui" || record.status !== "published") {
+        throw new Error(`Workflow '${record.workflowId}@${record.version}' is not a UI published version record.`);
+    }
+    if (record.definition.id !== record.workflowId || record.definition.version !== record.version) {
+        throw new Error(`Workflow '${record.workflowId}@${record.version}' published record does not match its definition id/version.`);
+    }
+    const computedHash = hashWorkflowDefinition(record.definition);
+    if (record.definitionHash !== computedHash) {
+        throw new Error(`Workflow '${record.workflowId}@${record.version}' published record has an invalid definition hash.`);
+    }
+}
+export function registerWorkflowAgentProfile(registry, id, profile, options = {}) {
+    return registerRegistryEntry(registry.profiles, "agent profile", id, profile, options);
+}
+export function registerWorkflowHandler(registry, id, handler, options = {}) {
+    return registerRegistryEntry(registry.handlers, "handler", id, handler, options);
+}
+export function registerWorkflowAdapter(registry, id, adapter, options = {}) {
+    return registerRegistryEntry(registry.adapters, "adapter", id, adapter, options);
+}
+export function registerWorkflowGuard(registry, id, guard, options = {}) {
+    return registerRegistryEntry(registry.guards, "guard", id, guard, options);
+}
+export function registerWorkflowPromptBuilder(registry, id, promptBuilder, options = {}) {
+    return registerRegistryEntry(registry.promptBuilders, "promptBuilder", id, promptBuilder, options);
+}
+export function registerWorkflowHumanAction(registry, id, humanAction, options = {}) {
+    if (registry.humanActions.has(id) && !options.override) {
+        throw new Error(`Workflow human action '${id}' is already registered.`);
+    }
+    registry.humanActions.set(id, humanAction);
+    return humanAction;
+}
+export function resolveWorkflowHumanAction(registry, ref) {
+    return registry.humanActions.get(ref);
+}
+export function hasWorkflowHumanAction(registry, ref) {
+    return resolveWorkflowHumanAction(registry, ref) !== undefined;
+}
+export function resolveWorkflowAgentProfile(registry, ref) {
+    return registry.profiles.get(ref);
+}
+export function hasWorkflowAgentProfile(registry, ref) {
+    return resolveWorkflowAgentProfile(registry, ref) !== undefined;
+}
+export function resolveWorkflowHandler(registry, ref) {
+    return registry.handlers.get(ref);
+}
+export function hasWorkflowHandler(registry, ref) {
+    return resolveWorkflowHandler(registry, ref) !== undefined;
+}
+export function resolveWorkflowAdapter(registry, ref) {
+    const id = typeof ref === "string" ? ref : ref.id;
+    return registry.adapters.get(id);
+}
+export function hasWorkflowAdapter(registry, ref) {
+    return resolveWorkflowAdapter(registry, ref) !== undefined;
+}
+export function resolveWorkflowPromptBuilder(registry, ref) {
+    return registry.promptBuilders.get(getPromptBuilderRefId(ref));
+}
+export function hasWorkflowPromptBuilder(registry, ref) {
+    return resolveWorkflowPromptBuilder(registry, ref) !== undefined;
+}
+function getPromptBuilderRefId(ref) {
+    return typeof ref === "string" ? ref : ref.id;
+}
+function registerRegistryEntry(entries, kind, id, value, options) {
+    if (entries.has(id) && !options.override) {
+        throw new Error(`Workflow ${kind} '${id}' is already registered.`);
+    }
+    const entry = withOptionalEntryMetadata({
+        id,
+        value,
+    }, options);
+    entries.set(id, entry);
+    return entry;
+}
+function withOptionalEntryMetadata(entry, options) {
+    return {
+        ...entry,
+        ...(options.pluginId ? { pluginId: options.pluginId } : {}),
+        ...(options.title ? { title: options.title } : {}),
+        ...(options.description ? { description: options.description } : {}),
+        ...(options.tags ? { tags: options.tags } : {}),
+        ...(options.paramsSchema ? { paramsSchema: options.paramsSchema } : {}),
+    };
+}
+//# sourceMappingURL=index.js.map

package/packages/workflows/dist/registry/index.js.map

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

package/packages/workflows/dist/runtime/adapter-node.d.ts

@@ -0,0 +1,28 @@
+import type { AdapterResult, NodeAttempt, NodeAttemptId, WorkflowDefinition, WorkflowDiagnostic, WorkflowErrorSummary, WorkflowEventEmitter, WorkflowRegistry, WorkflowRun, WorkflowRuntimeEvent, WorkflowValue } from "../types/index.js";
+import type { WorkflowRunStore } from "../store/index.js";
+export type WorkflowAdapterNodeDispatchOptions = {
+    registry: Pick<WorkflowRegistry, "adapters">;
+    now?: () => Date | string;
+    createNodeAttemptId?: () => NodeAttemptId;
+    store?: WorkflowRunStore;
+    emitEvent?: WorkflowEventEmitter;
+};
+export type WorkflowAdapterNodeDispatchSuccess = {
+    ok: true;
+    run: WorkflowRun;
+    nodeAttempt: NodeAttempt;
+    events: WorkflowRuntimeEvent[];
+    output: WorkflowValue;
+    result: AdapterResult;
+};
+export type WorkflowAdapterNodeDispatchFailure = {
+    ok: false;
+    run: WorkflowRun;
+    nodeAttempt?: NodeAttempt;
+    events: WorkflowRuntimeEvent[];
+    diagnostics: WorkflowDiagnostic[];
+    error: WorkflowErrorSummary;
+};
+export type WorkflowAdapterNodeDispatchResult = WorkflowAdapterNodeDispatchSuccess | WorkflowAdapterNodeDispatchFailure;
+export declare function dispatchWorkflowAdapterNode(definition: WorkflowDefinition, run: WorkflowRun, nodeId: string, input: WorkflowValue, options: WorkflowAdapterNodeDispatchOptions): Promise<WorkflowAdapterNodeDispatchResult>;
+//# sourceMappingURL=adapter-node.d.ts.map

package/packages/workflows/dist/runtime/adapter-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-node.d.ts","sourceRoot":"","sources":["../../src/runtime/adapter-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgB1D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,aAAa,CAAC;IAC1C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,KAAK,CAAC;IACV,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,KAAK,EAAE,oBAAoB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GACzC,kCAAkC,GAClC,kCAAkC,CAAC;AAEvC,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,iCAAiC,CAAC,CAsK5C"}

package/packages/workflows/dist/runtime/adapter-node.js

@@ -0,0 +1,172 @@
+import { resolveWorkflowAdapter } from "../registry/index.js";
+import { validateNodeOutput, validateWorkflowPortValue } from "../validation/index.js";
+import { adapterNodeDispatchFailure, failAdapterNodeDispatch, } from "./dispatch-failures.js";
+import { createWorkflowRuntimeId as createId } from "./ids.js";
+import { emitWorkflowRuntimeEvent, persistWorkflowNodeAttempt, persistWorkflowRun, } from "./persistence.js";
+import { createNodeScopedWorkflowRun, localStateSnapshotForNode } from "./state.js";
+import { createTimestampFactory } from "./time.js";
+export async function dispatchWorkflowAdapterNode(definition, run, nodeId, input, options) {
+    const events = [];
+    const timestamp = createTimestampFactory(options.now);
+    const node = definition.nodes[nodeId];
+    if (!node) {
+        return adapterNodeDispatchFailure({
+            run,
+            events,
+            diagnostics: [
+                {
+                    code: "WorkflowRuntimeError.unknownNode",
+                    message: `Workflow node '${nodeId}' does not exist, so it cannot be dispatched as an adapter node.`,
+                    severity: "error",
+                    nodeId,
+                    path: `$.nodes.${nodeId}`,
+                },
+            ],
+            error: {
+                code: "WorkflowRuntimeError.unknownNode",
+                message: "Adapter node dispatch failed because the node is not declared.",
+            },
+        });
+    }
+    if (node.kind !== "adapter") {
+        return adapterNodeDispatchFailure({
+            run,
+            events,
+            diagnostics: [
+                {
+                    code: "WorkflowRuntimeError.adapterNodeRequired",
+                    message: `Workflow node '${nodeId}' is '${node.kind}', but adapter node dispatch requires an adapter node.`,
+                    severity: "error",
+                    nodeId,
+                    path: `$.nodes.${nodeId}.kind`,
+                },
+            ],
+            error: {
+                code: "WorkflowRuntimeError.adapterNodeRequired",
+                message: "Adapter node dispatch failed because the selected node is not an adapter node.",
+            },
+        });
+    }
+    const adapterNode = node;
+    const startedAt = timestamp();
+    const nodeAttempt = {
+        id: options.createNodeAttemptId?.() ?? createId("wna"),
+        workflowRunId: run.id,
+        nodeId,
+        attempt: 1,
+        kind: "adapter",
+        status: "running",
+        input,
+        startedAt,
+        ...localStateSnapshotForNode(run, nodeId),
+        metadata: { adapterId: adapterNode.handler.id },
+    };
+    run.current = { nodeId, status: "running" };
+    run.updatedAt = startedAt;
+    await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+        type: "node.started",
+        runId: run.id,
+        nodeAttemptId: nodeAttempt.id,
+        nodeId,
+    });
+    await persistWorkflowNodeAttempt(options.store, nodeAttempt);
+    await persistWorkflowRun(options.store, run);
+    const adapter = resolveWorkflowAdapter(options.registry, adapterNode.handler);
+    const diagnostics = [];
+    if (!adapter) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownAdapterRef",
+            message: `Workflow adapter node '${nodeId}' references adapter '${adapterNode.handler.id}', but it is not registered in the Workflow Registry.`,
+            severity: "error",
+            nodeId,
+            path: `$.nodes.${nodeId}.handler.id`,
+            hint: "Register the adapter before dispatching the adapter node.",
+        });
+    }
+    if (adapterNode.input) {
+        diagnostics.push(...validateWorkflowPortValue(adapterNode.input, input, { path: `$.nodes.${nodeId}.input` }).diagnostics.map((diagnostic) => ({ ...diagnostic, nodeId })));
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return failAdapterNodeDispatch({
+            run,
+            nodeAttempt,
+            events,
+            diagnostics,
+            timestamp,
+            store: options.store,
+            emitEvent: options.emitEvent,
+            error: {
+                code: "WorkflowRuntimeError.adapterNodeDispatchFailed",
+                message: "Adapter node dispatch failed before adapter execution.",
+            },
+        });
+    }
+    try {
+        const adapterResult = await adapter.value({ input, run: createNodeScopedWorkflowRun(run, nodeId) });
+        const nodeOutputResult = validateNodeOutput(definition, nodeId, adapterResult.output);
+        if (!nodeOutputResult.ok) {
+            return failAdapterNodeDispatch({
+                run,
+                nodeAttempt,
+                events,
+                diagnostics: nodeOutputResult.diagnostics,
+                timestamp,
+                store: options.store,
+                emitEvent: options.emitEvent,
+                error: {
+                    code: "WorkflowRuntimeError.invalidNodeOutput",
+                    message: "Adapter node output failed validation before downstream use.",
+                },
+            });
+        }
+        const completedAt = timestamp();
+        nodeAttempt.status = "completed";
+        nodeAttempt.output = adapterResult.output;
+        nodeAttempt.completedAt = completedAt;
+        Object.assign(nodeAttempt, localStateSnapshotForNode(run, nodeId));
+        nodeAttempt.metadata = { adapterId: adapterNode.handler.id };
+        run.current = { nodeId, status: run.status };
+        run.updatedAt = completedAt;
+        await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+            type: "node.completed",
+            runId: run.id,
+            nodeAttemptId: nodeAttempt.id,
+            output: adapterResult.output,
+        });
+        await persistWorkflowNodeAttempt(options.store, nodeAttempt);
+        await persistWorkflowRun(options.store, run);
+        return {
+            ok: true,
+            run,
+            nodeAttempt,
+            events,
+            output: adapterResult.output,
+            result: adapterResult,
+        };
+    }
+    catch (caught) {
+        return failAdapterNodeDispatch({
+            run,
+            nodeAttempt,
+            events,
+            diagnostics: [],
+            timestamp,
+            store: options.store,
+            emitEvent: options.emitEvent,
+            error: adapterErrorSummaryFromCaught(caught),
+        });
+    }
+}
+function adapterErrorSummaryFromCaught(caught) {
+    if (caught instanceof Error) {
+        return {
+            code: "WorkflowRuntimeError.adapterFailed",
+            message: caught.message,
+        };
+    }
+    return {
+        code: "WorkflowRuntimeError.adapterFailed",
+        message: "Workflow adapter failed with a non-Error value.",
+    };
+}
+//# sourceMappingURL=adapter-node.js.map

package/packages/workflows/dist/runtime/adapter-node.js.map

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