@tomflow/proflow-platform-host 0.1.0

package/dist/src/index.d.ts

@@ -0,0 +1,252 @@
+import { z } from "zod";
+declare const configSchema: z.ZodPipe<z.ZodObject<{
+    stateRoot: z.ZodString;
+    workspaceRoot: z.ZodString;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    executionBaseUrl: z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>;
+    executionTransportCredentialFile: z.ZodOptional<z.ZodString>;
+    modelBaseUrl: z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>;
+    modelTransportCredentialFile: z.ZodOptional<z.ZodString>;
+    gatewayTransportCredentialFile: z.ZodOptional<z.ZodString>;
+    roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        agentPackageRef: z.ZodEnum<{
+            "@tomflow/proflow-agent-controller-dev": "@tomflow/proflow-agent-controller-dev";
+            "@tomflow/proflow-agent-product": "@tomflow/proflow-agent-product";
+            "@tomflow/proflow-agent-test-ops": "@tomflow/proflow-agent-test-ops";
+        }>;
+        registeredPackageVersion: z.ZodString;
+        roleRef: z.ZodString;
+        carrierUrl: z.ZodURL;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodTransform<{
+    host: string;
+    port: number;
+    executionBaseUrl: string;
+    executionTransportCredentialFile?: string | undefined;
+    modelBaseUrl: string;
+    modelTransportCredentialFile?: string | undefined;
+    gatewayTransportCredentialFile?: string | undefined;
+    roles: {
+        agentPackageRef: "@tomflow/proflow-agent-controller-dev" | "@tomflow/proflow-agent-product" | "@tomflow/proflow-agent-test-ops";
+        registeredPackageVersion: string;
+        roleRef: string;
+        carrierUrl: string;
+    }[];
+    stateRoot: string;
+    workspaceRoot: string;
+}, {
+    stateRoot: string;
+    workspaceRoot: string;
+    host: string;
+    port: number;
+    executionBaseUrl: string;
+    executionTransportCredentialFile?: string | undefined;
+    modelBaseUrl: string;
+    modelTransportCredentialFile?: string | undefined;
+    gatewayTransportCredentialFile?: string | undefined;
+    roles: {
+        agentPackageRef: "@tomflow/proflow-agent-controller-dev" | "@tomflow/proflow-agent-product" | "@tomflow/proflow-agent-test-ops";
+        registeredPackageVersion: string;
+        roleRef: string;
+        carrierUrl: string;
+    }[];
+}>>;
+export type PlatformHostConfig = z.infer<typeof configSchema>;
+export declare const parsePlatformHostConfig: (value: unknown) => PlatformHostConfig;
+export declare function loadPlatformHostConfig(path: string): Promise<{
+    host: string;
+    port: number;
+    executionBaseUrl: string;
+    executionTransportCredentialFile?: string | undefined;
+    modelBaseUrl: string;
+    modelTransportCredentialFile?: string | undefined;
+    gatewayTransportCredentialFile?: string | undefined;
+    roles: {
+        agentPackageRef: "@tomflow/proflow-agent-controller-dev" | "@tomflow/proflow-agent-product" | "@tomflow/proflow-agent-test-ops";
+        registeredPackageVersion: string;
+        roleRef: string;
+        carrierUrl: string;
+    }[];
+    stateRoot: string;
+    workspaceRoot: string;
+}>;
+export type DependencyReadiness = {
+    status: "READY" | "NOT_READY";
+    liveness: "UP" | "DOWN";
+    owner: "task" | "agent" | "execution" | "model";
+    detail?: unknown;
+};
+export type PlatformHostStatus = {
+    process: "STOPPED" | "STARTING" | "RUNNING" | "DRAINING";
+    liveness: "UP" | "DOWN";
+    transport: "UP" | "DOWN";
+    readiness: "READY" | "NOT_READY";
+    accepting: boolean;
+    inFlight: number;
+    dependencies: {
+        task: DependencyReadiness;
+        agent: DependencyReadiness;
+        execution: DependencyReadiness;
+        model: DependencyReadiness;
+    };
+};
+export type PlatformHostBrowserOwnerPorts = {
+    task: {
+        getWorkerBinding(taskId: string, roleRef: string): Promise<{
+            workerRef: string;
+            conversationLocator: string | null;
+        } | null>;
+        bindWorker(input: {
+            taskId: string;
+            roleRef: string;
+            workerRef: string;
+            conversationLocator: string;
+        }): Promise<void>;
+    };
+    agent: {
+        listPendingMessages(limit: number): Promise<Array<{
+            messageId: string;
+            threadId: string;
+            taskId: string;
+            kind: "QUESTION" | "REPLY";
+            fromRoleRef: string;
+            fromWorkerRef: string;
+            targetRoleRef: string;
+            targetWorkerRef: string;
+            replyToMessageId: string | null;
+            content: string;
+            status: "PENDING";
+            deliveryAttemptCount: number;
+            lastDeliveryErrorCode: string | null;
+            executionRef: string | null;
+            evidenceRef: string | null;
+        }>>;
+        getPendingMessage(messageRef: string): Promise<{
+            messageId: string;
+            threadId: string;
+            taskId: string;
+            kind: "QUESTION" | "REPLY";
+            fromRoleRef: string;
+            fromWorkerRef: string;
+            targetRoleRef: string;
+            targetWorkerRef: string;
+            replyToMessageId: string | null;
+            content: string;
+            status: "PENDING";
+            deliveryAttemptCount: number;
+            lastDeliveryErrorCode: string | null;
+            executionRef: string | null;
+            evidenceRef: string | null;
+        }>;
+        reportDeliveryOutcome(input: {
+            messageRef: string;
+            outcome: "DELIVERED" | "FAILED" | "UNKNOWN";
+            executionRef?: string;
+            evidenceRef?: string;
+            errorCode?: string;
+        }): Promise<void>;
+    };
+};
+export type PlatformHostExecutionIdentityPort = {
+    authorize(request: {
+        callerRef: string;
+        roleRef?: string | undefined;
+        taskId?: string | undefined;
+        nodeId?: string | undefined;
+        runNo?: number | undefined;
+        workerRef?: string | undefined;
+        projectRoot?: string | undefined;
+        capability: string;
+        input: unknown;
+    }): Promise<boolean>;
+};
+export type PlatformHostTaskDriverPorts = {
+    getTask(taskId: string): Promise<{
+        taskId: string;
+        status: string;
+        version: number;
+        currentNodeId: string | null;
+        roleBindings: Array<{
+            roleRef: string;
+            workerRef: string | null;
+        }>;
+    }>;
+    getTaskDriveProjection(taskId: string): Promise<{
+        taskId: string;
+        taskStatus: string;
+        taskVersion: number;
+        terminal: boolean;
+        currentNode: {
+            nodeId: string;
+            status: string;
+            version: number;
+            runNo: number;
+            requiredAgentPackageRef: string;
+        } | null;
+        roleBinding: {
+            agentPackageRef: string;
+            roleRef: string;
+            workerRef: string | null;
+            conversationLocator: string | null;
+        } | null;
+        canDrive: boolean;
+        blockedReason: string | null;
+    }>;
+    getNodeContext(taskId: string, nodeId: string): Promise<{
+        task: {
+            taskId: string;
+            status: string;
+            version: number;
+        };
+        node: {
+            nodeId: string;
+            status: string;
+            version: number;
+            runNo: number;
+            requiredAgentPackageRef: string;
+            workerRef: string | null;
+        };
+    }>;
+    startTask(input: {
+        taskId: string;
+        expectedTaskVersion: number;
+        idempotencyKey: string;
+    }): Promise<unknown>;
+    startNode(input: {
+        taskId: string;
+        nodeId: string;
+        expectedTaskVersion: number;
+        expectedNodeVersion: number;
+        idempotencyKey: string;
+    }): Promise<unknown>;
+};
+export type PlatformHostAgentIdentityPorts = {
+    getRegisteredRole(roleRef: string): Promise<{
+        roleRef: string;
+    }>;
+};
+export type PlatformHostRoleManagement = {
+    invoke(operation: string, input: unknown): Promise<unknown>;
+};
+export declare function createPlatformHost(input: {
+    config: PlatformHostConfig;
+    log?: (entry: Record<string, unknown>) => void;
+    executionCredential?: string;
+}): Readonly<{
+    start: () => Promise<{
+        host: string;
+        port: number;
+    }>;
+    stop: () => Promise<void>;
+    status: () => Promise<PlatformHostStatus>;
+    browserOwnerPorts: PlatformHostBrowserOwnerPorts;
+    executionIdentity: PlatformHostExecutionIdentityPort;
+    taskDriverPorts: PlatformHostTaskDriverPorts;
+    agentIdentityPorts: PlatformHostAgentIdentityPorts;
+    restart(): Promise<{
+        host: string;
+        port: number;
+    }>;
+}>;
+export {};