@mag.ni/process 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,208 @@
+/**
+ * MCP Processes - API Client
+ * HTTP client for the Process Workboard API
+ */
+import { User, CreateAgentUserRequest, CreateAgentUserResponse, ClaimUserResponse, HeartbeatResponse, ReleaseUserResponse, Instance, AvailableActionsResponse, TakeActionRequest, TakeActionResponse, Diagram, DiagramContext, ApiError, InstanceStatus } from './types.js';
+import { AuthConfig } from './auth.js';
+export declare class ApiClientError extends Error {
+    statusCode: number;
+    apiError?: ApiError | undefined;
+    constructor(message: string, statusCode: number, apiError?: ApiError | undefined);
+}
+export declare class SessionNotClaimedError extends Error {
+    constructor();
+}
+export declare class ProcessesApiClient {
+    private baseUrl;
+    private sessionId;
+    private claimedUserId;
+    private oauthManager;
+    private cookies;
+    private sessionEstablished;
+    constructor(baseUrl: string, oauth?: AuthConfig);
+    /**
+     * Get the current session ID (if claimed)
+     */
+    getSessionId(): string | null;
+    /**
+     * Get the currently claimed user ID
+     */
+    getClaimedUserId(): string | null;
+    /**
+     * Check if a user is currently claimed
+     */
+    hasClaimedUser(): boolean;
+    /**
+     * Set the session ID (for restoring sessions)
+     */
+    setSessionId(sessionId: string, userId: string): void;
+    /**
+     * Clear the session state (used when lease expires)
+     */
+    clearSession(): void;
+    /**
+     * Establish a BFF session by exchanging the OAuth access token for a session cookie.
+     * This calls POST /api/auth/session with the Bearer token, and the backend validates
+     * it via the auth server's userinfo endpoint, then returns a session cookie.
+     */
+    private ensureBffSession;
+    private getHeaders;
+    private request;
+    private requireSession;
+    /**
+     * Logout: destroy the server-side BFF session and clear local OAuth credentials.
+     * After this, the next API call will trigger a fresh interactive login.
+     */
+    logout(): Promise<void>;
+    /**
+     * List all agent users with their claim status
+     */
+    listAgentUsers(): Promise<User[]>;
+    /**
+     * Create a new agent user
+     */
+    createAgentUser(request: CreateAgentUserRequest): Promise<CreateAgentUserResponse>;
+    /**
+     * Delete an agent user (must be unclaimed)
+     */
+    deleteAgentUser(userId: string): Promise<void>;
+    /**
+     * Claim a user identity to start working
+     * Returns a lease that must be kept alive with heartbeat()
+     */
+    claimUser(userId: string): Promise<ClaimUserResponse>;
+    /**
+     * Send heartbeat to keep the lease alive
+     * Must be called periodically (recommended: every minute for 5-minute TTL)
+     */
+    heartbeat(): Promise<HeartbeatResponse>;
+    /**
+     * Release the claimed user identity
+     * Should be called when done working
+     */
+    releaseUser(): Promise<ReleaseUserResponse>;
+    /**
+     * Get instances assigned to the claimed user
+     * Returns WorkflowInstanceDto[] from the backend
+     */
+    getMyInstances(status?: InstanceStatus): Promise<Record<string, unknown>[]>;
+    /**
+     * Get full details for a specific instance
+     * Returns the raw WorkflowInstanceDto from the backend
+     */
+    getInstanceDetails(instanceId: string): Promise<Record<string, unknown>>;
+    /**
+     * Get available actions for an instance at its current step
+     */
+    getAvailableActions(instanceId: string): Promise<AvailableActionsResponse>;
+    /**
+     * Execute an action on an instance
+     */
+    takeAction(instanceId: string, request: TakeActionRequest): Promise<TakeActionResponse>;
+    /**
+     * Get a diagram by ID
+     * Maps the raw API response (arrows/from/to/shape) to the MCP type (edges/sourceNodeId/targetNodeId/type)
+     */
+    getDiagram(diagramId: string): Promise<Diagram>;
+    /**
+     * Map raw API diagram response to MCP Diagram type.
+     * The backend returns ArrowDto[] as "arrows" with "from"/"to" properties,
+     * while MCP types expect DiagramEdge[] as "edges" with "sourceNodeId"/"targetNodeId".
+     * Similarly, nodes use "shape"/"isStart"/"isEnd" instead of "type".
+     * Raw properties are preserved via spread for handlers that access them directly.
+     */
+    private mapRawDiagram;
+    /**
+     * Get full context for a diagram including node details
+     */
+    getDiagramContext(diagramId: string): Promise<DiagramContext>;
+    /**
+     * Assign an instance to a user
+     */
+    assignInstance(instanceId: string, userId: string): Promise<Instance>;
+    /**
+     * Get a user by ID
+     */
+    getUser(userId: string): Promise<User>;
+    /**
+     * Get all notes for an instance
+     */
+    getInstanceNotes(instanceId: string): Promise<Record<string, unknown>>;
+    /**
+     * Add a note to an instance
+     */
+    addInstanceNote(instanceId: string, text: string): Promise<Record<string, unknown>>;
+    /**
+     * List all diagrams with optional filtering
+     */
+    listDiagrams(filter?: {
+        search?: string;
+        diagramType?: string;
+        sortBy?: string;
+        sortOrder?: string;
+        topLevelOnly?: boolean;
+    }): Promise<Record<string, unknown>[]>;
+    /**
+     * Get a diagram by ID (raw API response without mapping)
+     */
+    getDiagramRaw(diagramId: string): Promise<Record<string, unknown>>;
+    /**
+     * Create a new diagram
+     */
+    createDiagram(data: {
+        title: string;
+        token: string;
+        diagramType?: string;
+        mode?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Update a diagram's properties
+     */
+    updateDiagram(diagramId: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Delete a diagram
+     */
+    deleteDiagram(diagramId: string, confirm?: boolean): Promise<{
+        success?: boolean;
+        requiresConfirmation?: boolean;
+        message?: string;
+        count?: number;
+    }>;
+    /**
+     * Duplicate a diagram
+     */
+    duplicateDiagram(diagramId: string): Promise<Record<string, unknown>>;
+    /**
+     * Add a node to a diagram
+     * Fetches the current diagram, adds the node, and saves
+     */
+    addNode(diagramId: string, nodeData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Update a node in a diagram
+     */
+    updateNode(diagramId: string, nodeId: string, updateData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Delete a node from a diagram
+     * Also removes any arrows connected to this node
+     */
+    deleteNode(diagramId: string, nodeId: string): Promise<{
+        removedArrowCount: number;
+    }>;
+    /**
+     * Add an arrow to a diagram
+     */
+    addArrow(diagramId: string, arrowData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Update an arrow in a diagram
+     */
+    updateArrow(diagramId: string, arrowId: string, updateData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Delete an arrow from a diagram
+     */
+    deleteArrow(diagramId: string, arrowId: string): Promise<void>;
+}
+/**
+ * Create a new API client instance from environment variables
+ */
+export declare function createClient(): ProcessesApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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