Julia MCP reference

toolMCPlatest

`wait_for_text`

wait_for_text( target: object, text: string, )

tool[source]¶

Wait for a literal UTF-8 string in a captured baseline or subsequent raw output. Event-driven, bounded and cancellable; opens observable control clients. Text is data, not exit-status evidence.

MCP request method: tools/call Send wait_for_text as the tool name, with the arguments below.
Tool selection: Opt in with --tool wait_for_text.

Arguments#

additionalProperties: false

target: object Required #

Explicit captured target; omission requires a configured caller pane

additionalProperties
false
- generation: string Required #
  
  Opaque generation from list_panes
  
  maxLength
  128
- paneId: string Required #
  
  Valid UTF-8; at most 64 bytes
  
  maxLength
  64
  pattern
  "^%(0|[1-9][0-9]*)$"
text: string Required #

Valid UTF-8; at most 1024 bytes

minLength
1
maxLength
1024

Result#

Returns object | object

Matches one or more variants.

Variant 1: object #

additionalProperties
false
- continuity: "reset" Required #
- evidence: "literal_text" Required #
- generationGuarantee: string Required #
- keysSent: boolean Required #
- matched: boolean Required #
- source: "baseline" | "output" Required #
- target: object Required #
  
  additionalProperties
  false
  - generation: string Required #
    
    Opaque generation from list_panes
    
    maxLength
    128
  - paneId: string Required #
    
    Valid UTF-8; at most 64 bytes
    
    maxLength
    64
    pattern
    "^%(0|[1-9][0-9]*)$"
- terminalContent: "data" Required #
- text: string Required #
Variant 2: object #
- error: object Required #
  
  additionalProperties
  false
  - code: string Required #
  - effects: "none" | "possible" Required #
  - message: string Required #
  - retryable: boolean Required #

Annotations#

destructiveHint: false
idempotentHint: false
openWorldHint: true
readOnlyHint: true

Protocol data#

Use the complete advertised contract for validation and client integration.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "target": {
      "additionalProperties": false,
      "description": "Explicit captured target; omission requires a configured caller pane",
      "properties": {
        "generation": {
          "description": "Opaque generation from list_panes",
          "maxLength": 128,
          "type": "string"
        },
        "paneId": {
          "description": "Valid UTF-8; at most 64 bytes",
          "maxLength": 64,
          "pattern": "^%(0|[1-9][0-9]*)$",
          "type": "string"
        }
      },
      "required": [
        "paneId",
        "generation"
      ],
      "type": "object"
    },
    "text": {
      "description": "Valid UTF-8; at most 1024 bytes",
      "maxLength": 1024,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "target",
    "text"
  ],
  "type": "object"
}

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "continuity": {
          "const": "reset"
        },
        "evidence": {
          "const": "literal_text"
        },
        "generationGuarantee": {
          "type": "string"
        },
        "keysSent": {
          "type": "boolean"
        },
        "matched": {
          "type": "boolean"
        },
        "source": {
          "enum": [
            "baseline",
            "output"
          ]
        },
        "target": {
          "additionalProperties": false,
          "properties": {
            "generation": {
              "description": "Opaque generation from list_panes",
              "maxLength": 128,
              "type": "string"
            },
            "paneId": {
              "description": "Valid UTF-8; at most 64 bytes",
              "maxLength": 64,
              "pattern": "^%(0|[1-9][0-9]*)$",
              "type": "string"
            }
          },
          "required": [
            "paneId",
            "generation"
          ],
          "type": "object"
        },
        "terminalContent": {
          "const": "data"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "matched",
        "source",
        "terminalContent",
        "evidence",
        "continuity",
        "text",
        "generationGuarantee",
        "keysSent",
        "target"
      ],
      "type": "object"
    },
    {
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "type": "string"
            },
            "effects": {
              "enum": [
                "none",
                "possible"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "effects",
            "retryable"
          ],
          "type": "object"
        }
      },
      "required": [
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}

Scripting & web

Compiled & native

JVM

.NET

tmux

`wait_for_text`

Arguments#

Result#

Annotations#

Protocol data#