T3.Environments (T3 v0.3.0)

Copy Markdown View Source

Environments MCP operations. Pass T3's original string-keyed argument maps.

Tool availability depends on the authenticated server, permission mode and invocation context. In-app agent tools may not be available to outside clients. See T3.Catalog.tools(:environments) for descriptions and context requirements.

Summary

Functions

Ask the user to link another environment. Linking requires an agent invocation context; returns pending while the user approves.

List linked environments and whether each answers now. Pass environmentId to supported tools to act there.

Read this server's identity and preferences. Providers and models: orchestrator_capabilities.

Forget a linked environment. The remote session remains until revoked there.

Update environment-wide preferences. Live full-access or default caller thread only. Omitted fields are unchanged; customInstructions: '' clears it.

Functions

link(client, arguments \\ %{})

@spec link(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}

Ask the user to link another environment. Linking requires an agent invocation context; returns pending while the user approves.

Requires linked-environment support, which may be disabled or hidden by the server.

links(client, arguments \\ %{})

@spec links(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}

List linked environments and whether each answers now. Pass environmentId to supported tools to act there.

Requires linked-environment support, which may be disabled or hidden by the server.

read(client, arguments \\ %{})

@spec read(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}

Read this server's identity and preferences. Providers and models: orchestrator_capabilities.

Availability is server-, permission-, and context-dependent; outside clients must supply explicit project/thread targets when required.

unlink(client, arguments \\ %{})

@spec unlink(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}

Forget a linked environment. The remote session remains until revoked there.

Requires linked-environment support, which may be disabled or hidden by the server.

update_preferences(client, arguments \\ %{})

@spec update_preferences(T3.Client.t(), map()) ::
  {:ok, map()} | {:error, T3.Error.t()}

Update environment-wide preferences. Live full-access or default caller thread only. Omitted fields are unchanged; customInstructions: '' clears it.

Requires a live full-access/default caller thread.