Unseen Workflow Compiler

Turn supplied document evidence or raw operational text into a publication-ready workflow diagram with source references, clean vector SVG, Mermaid, Excalidraw scene, and interactive Studio deep link (`studioUrl`). INPUT SCOPE: Use reviewed written procedures only. Do not interpret scans, images, chart/diagram geometry or unlabeled arrows, and do not certify business procedures. Ask for reviewed written process text or source-backed clarification. HOW TO STRUCTURE TEXT INPUTS: Either pass `sources` (array of 1..60 verbatim chunks `{id, locator, excerpt}` where each excerpt is <= 2000 chars with exact numbers/actors/thresholds preserved) OR pass raw `text` and Unseen will automatically segment it into source chunks. EDITING GUIDANCE: For cosmetic/styling/annotation edits, edit the returned `<svg>` XML directly. For structural/topological edits (adding/removing nodes or rerouting branches), edit `spec` (VisualSpec JSON) and call `autofix_workflow` ($0 deterministic connector healing + fresh SVG/Mermaid/Excalidraw) or `revise_workflow`.

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "enum": [
        "0.1"
      ],
      "description": "Protocol envelope version (must be '0.1')"
    },
    "requestId": {
      "type": "string",
      "description": "Optional client request correlation ID"
    },
    "jobId": {
      "type": "string",
      "description": "Optional job ID when resuming a workflow after clarification"
    },
    "userGoal": {
      "type": "string",
      "description": "The overarching operational goal or process description (e.g. 'Driver Onboarding SOP' or 'Vendor Risk Assessment')"
    },
    "text": {
      "type": "string",
      "description": "Optional raw document or user text. If provided when `sources` is omitted or empty, Unseen automatically segments `text` into faithful `sources[]` chunks."
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) obtained from `auth_verify_otp` or `auth_login` if not already supplied in the HTTP `Authorization: Bearer` header."
    },
    "desiredOutput": {
      "type": "object",
      "properties": {
        "orientation": {
          "type": "string",
          "enum": [
            "portrait",
            "landscape",
            "choose"
          ],
          "description": "Desired visual orientation"
        },
        "depth": {
          "type": "string",
          "enum": [
            "macro",
            "detailed",
            "choose"
          ],
          "description": "Desired workflow abstraction depth"
        }
      }
    },
    "sources": {
      "type": "array",
      "description": "Array of faithful source excerpts with locators from the input document (1..60 chunks, <=2000 chars each). Preserve exact thresholds, actors, and IF/ELSE branches.",
      "items": {
        "type": "object",
        "required": [
          "id",
          "locator",
          "excerpt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique chunk ID (e.g. 's1', 's2')"
          },
          "name": {
            "type": "string",
            "description": "Document or file name"
          },
          "locator": {
            "type": "string",
            "description": "Heading, page, or section locator"
          },
          "excerpt": {
            "type": "string",
            "description": "Faithful document excerpt (do not rewrite)"
          }
        }
      }
    },
    "hostContext": {
      "type": "object",
      "description": "Optional advisory context observed by the host agent",
      "properties": {
        "actors": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "ambiguities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contradictions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "assumptions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "userContext": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "priorAnswers": {
      "type": "array",
      "description": "Answers to prior Unseen clarification questions when resuming a compilation",
      "items": {
        "type": "object",
        "required": [
          "questionId",
          "answer",
          "source"
        ],
        "properties": {
          "questionId": {
            "type": "string"
          },
          "answer": {
            "description": "User's answer to the clarification question"
          },
          "source": {
            "type": "string",
            "enum": [
              "user",
              "document",
              "host-context"
            ]
          }
        }
      }
    }
  },
  "required": [
    "schemaVersion",
    "userGoal",
    "sources"
  ]
}

Apply explicit node label/role changes or node removal using node IDs, or request connector autofix. For other changes, including new steps or edges, edit the returned spec with confirmed source evidence and call autofix_workflow. Unsupported instructions return an error; this tool does not perform general natural-language rewrites.

{
  "type": "object",
  "properties": {
    "spec": {
      "type": "object",
      "description": "The existing VisualSpec object to revise"
    },
    "instruction": {
      "type": "string",
      "description": "Clear revision instruction (e.g. 'Change node-2 role to decision and label to Finance Approval?', 'Remove orphan node-4', 'Autofix layout connections')"
    },
    "additionalSources": {
      "type": "array",
      "description": "Optional additional source evidence excerpts to support the revision",
      "items": {
        "type": "object",
        "required": [
          "id",
          "locator",
          "excerpt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique chunk ID"
          },
          "locator": {
            "type": "string",
            "description": "Heading or section locator"
          },
          "excerpt": {
            "type": "string",
            "description": "Faithful document excerpt"
          }
        }
      }
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) if not passed via Authorization header."
    }
  },
  "required": [
    "spec",
    "instruction"
  ]
}

Deterministic connector healing and full visual re-rendering ($0 compute cost, instant, unlimited). Rescues orphan nodes, heals broken or missing decision branches, recomputes deterministic orthogonal layout, and returns fresh `spec`, `svg`, `mermaid`, `excalidraw`, and `studioUrl`. Use this tool after making direct structural edits to `VisualSpec` JSON (`nodes` / `edges`), or when a user asks to autofix connectors.

{
  "type": "object",
  "properties": {
    "spec": {
      "type": "object",
      "description": "The VisualSpec JSON object to deterministically heal and re-render into SVG, Mermaid, and Excalidraw."
    },
    "orientation": {
      "type": "string",
      "enum": [
        "portrait",
        "landscape"
      ],
      "description": "Optional layout orientation (defaults to portrait)."
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) if not passed via Authorization header."
    }
  },
  "required": [
    "spec"
  ]
}

Bundled free semantic verification and repair powered by TypeSafe Jev. Audits the VisualSpec against its cited `sources[]` for unsupported claims, missing decision branches, and role accuracy, applies targeted repair if actionable issues are found, and returns the enhanced `spec`, `svg`, `mermaid`, `excalidraw`, `studioUrl`, and Jev quality metrics.

{
  "type": "object",
  "properties": {
    "spec": {
      "type": "object",
      "description": "The current VisualSpec JSON object (including its `sources` array) to audit and enhance."
    },
    "visualId": {
      "type": "string",
      "description": "The `jobId` or `visualId` returned when the workflow was compiled."
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) if not passed via Authorization header."
    }
  },
  "required": [
    "spec"
  ]
}

Discover distinct operational workflows from multi-section documents or raw text before compiling. Returns candidate workflows (`id`, `title`, `description`, `sourceIds`) audited by TypeSafe Jev.

{
  "type": "object",
  "properties": {
    "sources": {
      "type": "array",
      "description": "Array of source excerpts `{id, locator, excerpt}` from the document.",
      "items": {
        "type": "object",
        "required": [
          "id",
          "locator",
          "excerpt"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "locator": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          }
        }
      }
    },
    "text": {
      "type": "string",
      "description": "Optional raw document text if `sources` is not pre-segmented."
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) if not passed via Authorization header."
    }
  }
}

Retrieve an existing VisualSpec workflow by jobId or visualId, returning the spec, SVG layout, and Mermaid diagram.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The jobId or visualId of the workflow to retrieve"
    },
    "authToken": {
      "type": "string",
      "description": "Optional session token (`utok_...`) if not passed via Authorization header."
    }
  },
  "required": [
    "id"
  ]
}

Step 1 of Agent & Human Login (Email + OTP): Sends a 6-digit Login OTP (`UNSEEN_LOGIN_OTP`) to the user's email address. This is a passwordless Login OTP (NOT a password reset). Once called, the agent can either read the 6-digit `UNSEEN_LOGIN_OTP` directly from the user's email (when the user has granted email access) or ask the user in chat for the 6-digit code, then call `auth_verify_otp`.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user's email address to receive the 6-digit Login OTP."
    }
  },
  "required": [
    "email"
  ]
}

Step 2 of Agent & Human Login (Email + OTP): Verifies the 6-digit Login OTP sent to `email` and returns `{ token: 'utok_...', user }` (30 free credits / 3 visuals per month on new accounts). Pass the returned `token` as `Authorization: Bearer <token>` or in the `authToken` argument of subsequent MCP tool calls.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user's email address."
    },
    "otp": {
      "type": "string",
      "description": "The 6-digit Login OTP read from the user's email (`UNSEEN_LOGIN_OTP`) or supplied by the user."
    }
  },
  "required": [
    "email",
    "otp"
  ]
}

Legacy sign-in for an existing password account. Account creation and password setup require verified browser sign-in. ChatGPT/Codex plugin connections use browser OAuth instead of this tool.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user's email address."
    },
    "password": {
      "type": "string",
      "description": "Account password (min 8 characters)."
    },
    "register": {
      "type": "boolean",
      "description": "Deprecated. Registration through this tool is rejected; use verified browser sign-in."
    },
    "name": {
      "type": "string",
      "description": "Optional display name when registering."
    }
  },
  "required": [
    "email",
    "password"
  ]
}