televerse-egjd.onrender.com

{
  "name": "teleport_agent",
  "kind": "act",
  "impl": "imperative",
  "description": "Use this when a side investigation, debugging task, research task, browser task, test investigation, or other secondary task would interrupt the user's current coding workflow. Teleports a temporary computer-use agent into an isolated Televerse workspace. The teleported agent receives context from the session, works independently, and returns structured findings (and optionally a patch). The current session continues running uninterrupted. Returns a stable teleport ID to track with get_teleport_status and retrieve_teleport_result.",
  "inputSchema": {
    "type": "object",
    "required": [
      "primarySessionId",
      "task"
    ],
    "properties": {
      "primarySessionId": {
        "type": "string",
        "description": "The Televerse session id of the user's primary task. Context is captured from this session and the teleported agent is isolated from it."
      },
      "task": {
        "type": "string",
        "minLength": 1,
        "description": "The side task for the teleported agent to investigate. Be specific: what to reproduce, what to inspect, what the expected behavior is."
      },
      "returnMode": {
        "type": "string",
        "enum": [
          "report",
          "report_and_patch",
          "investigate_only"
        ],
        "description": "What the teleported agent should return. 'report' (default) = findings only. 'report_and_patch' = also prepare a patch for review. 'investigate_only' = read/reproduce, no modifications."
      },
      "relevantFiles": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional file paths (relative to the primary project) relevant to the side task, to seed context."
      },
      "recentErrors": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional error messages the user/primary agent recently observed."
      },
      "constraints": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional guardrails for the teleported agent (e.g. 'do not install packages')."
      },
      "agentCount": {
        "type": "integer",
        "minimum": 1,
        "maximum": 2,
        "description": "Agents for this teleport. Default 1."
      }
    }
  }
}

{
  "name": "list_teleports",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the current user's teleports, newest first. Optionally filter to teleports spawned from a specific primary session id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "primarySessionId": {
        "type": "string",
        "description": "Optional. Only return teleports whose primary session matches this id."
      }
    }
  }
}

{
  "name": "get_teleport_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch the live status of a teleport. Returns lifecycle phase, a short progress description, and the activity log. Poll this while a teleport is running. Terminal states are completed, reviewable, failed, cancelled, and discarded.",
  "inputSchema": {
    "type": "object",
    "required": [
      "teleportId"
    ],
    "properties": {
      "teleportId": {
        "type": "string",
        "description": "The teleport ID from teleport_agent."
      }
    }
  }
}

{
  "name": "retrieve_teleport_result",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieve the structured result of a completed or reviewable teleport. Returns summary, root cause, evidence, files inspected, commands/tests executed, an optional patch (description, files changed, diff), recommendation, and confidence. Consume this to review and decide whether to apply the patch.",
  "inputSchema": {
    "type": "object",
    "required": [
      "teleportId"
    ],
    "properties": {
      "teleportId": {
        "type": "string",
        "description": "The teleport ID from teleport_agent."
      }
    }
  }
}

{
  "name": "apply_teleport_patch",
  "kind": "act",
  "impl": "imperative",
  "description": "Coordinate applying a completed teleport's patch. Televerse never auto-merges into the workspace — it marks the patch as applied so the user knows it's been reviewed. Only call after retrieve_teleport_result shows a reviewable status. Returns a coordination acknowledgement; the actual merge is the caller's responsibility.",
  "inputSchema": {
    "type": "object",
    "required": [
      "teleportId"
    ],
    "properties": {
      "teleportId": {
        "type": "string",
        "description": "The teleport ID."
      }
    }
  }
}

{
  "name": "discard_teleport",
  "kind": "act",
  "impl": "imperative",
  "description": "Discard a teleport and its result. Marks the teleport as discarded and cleans up its workspace. Idempotent — safe to call after a teleport is already terminal.",
  "inputSchema": {
    "type": "object",
    "required": [
      "teleportId"
    ],
    "properties": {
      "teleportId": {
        "type": "string",
        "description": "The teleport ID."
      }
    }
  }
}

{
  "name": "cancel_teleport",
  "kind": "transact",
  "impl": "imperative",
  "description": "Cancel an in-flight teleport. Aborts the teleported agent's workers and marks the teleport as cancelled. No result is produced. Use when the side task is no longer needed.",
  "inputSchema": {
    "type": "object",
    "required": [
      "teleportId"
    ],
    "properties": {
      "teleportId": {
        "type": "string",
        "description": "The teleport ID."
      }
    }
  }
}