{"schema_version":1,"failures":[{"code":"TNL_CLIENT_ADMIN_UNAVAILABLE","slug":"admin-unavailable","class":"unavailable","message":"tnl could not complete the administrator operation","action":"check administrator access and control health, then retry"},{"code":"TNL_CLIENT_ALIAS_NOT_SELECTED","slug":"alias-not-selected","class":"conflict","message":"this worktree is not selected for the alias","action":"release the alias from its selected worktree or select this one explicitly"},{"code":"TNL_CLIENT_ALIAS_OWNED","slug":"alias-owned","class":"conflict","message":"another live worktree owns this alias","action":"use tnl alias use NAME --force for a deliberate handoff"},{"code":"TNL_CLIENT_ALIAS_POLICY_CONFLICT","slug":"alias-policy-conflict","class":"conflict","message":"another running worktree declares a different alias or uses its hostname","action":"use matching alias definitions across worktrees and choose a distinct public hostname"},{"code":"TNL_CLIENT_ALIAS_RECEIVER_UNREADY","slug":"alias-receiver-unready","class":"unavailable","message":"the selected alias entry service is not ready","action":"start the entry service in the selected worktree and check tnl status"},{"code":"TNL_CLIENT_APP_CONFIGURATION_CONFLICT","slug":"app-configuration-conflict","class":"conflict","message":"the local publisher uses another project configuration","action":"stop this project's apps and named publishers, then start them with the selected configuration"},{"code":"TNL_CLIENT_APP_CURSOR_EXPIRED","slug":"app-cursor-expired","class":"invalid","message":"the local event cursor has expired","action":"run tnl watch without --after to follow current events"},{"code":"TNL_CLIENT_APP_OWNER_CONFLICT","slug":"app-owner-conflict","class":"conflict","message":"another live app or named publisher owns this service","action":"stop that service's current owner before starting another"},{"code":"TNL_CLIENT_APP_READINESS_TIMEOUT","slug":"app-readiness-timeout","class":"unavailable","message":"public readiness checks timed out","action":"check tnl status and the app response, then run tnl wait again"},{"code":"TNL_CLIENT_APP_REMOTE_SERVICE","slug":"app-remote-service","class":"invalid","message":"readiness checks require a local configured service","action":"select a local service with --service; use tnl status for applied publisher groups"},{"code":"TNL_CLIENT_AUTHENTICATION_REQUIRED","slug":"authentication-required","class":"unauthenticated","message":"tnl could not authenticate this request","action":"log in again or check the supplied access token"},{"code":"TNL_CLIENT_AUTH_CANCELLED","slug":"auth-cancelled","class":"conflict","message":"the login operation was cancelled","action":"start a new login with tnl auth login"},{"code":"TNL_CLIENT_AUTH_DENIED","slug":"auth-denied","class":"forbidden","message":"login approval was denied","action":"start a new login with tnl auth login"},{"code":"TNL_CLIENT_AUTH_EXPIRED","slug":"auth-expired","class":"unauthenticated","message":"the login approval code expired","action":"start a new login with tnl auth login"},{"code":"TNL_CLIENT_AUTH_METHOD_UNAVAILABLE","slug":"auth-method-unavailable","class":"invalid","message":"the selected server does not support this login method","action":"use tnl auth login with a method supported by this server"},{"code":"TNL_CLIENT_AUTH_OPERATION_NOT_FOUND","slug":"auth-operation-not-found","class":"not_found","message":"the login operation was not found for the selected server","action":"check the operation ID, server, and state directory"},{"code":"TNL_CLIENT_AUTH_PROVIDER_UNAVAILABLE","slug":"auth-provider-unavailable","class":"unavailable","message":"the sign-in provider could not be reached or its signing keys are unavailable","action":"check provider connectivity and resume with tnl auth login wait <operation-id>"},{"code":"TNL_CLIENT_AUTH_RECOVERY_REQUIRED","slug":"auth-recovery-required","class":"conflict","message":"login credential redemption has an uncertain outcome","action":"start a new login with tnl auth login; this operation cannot be replayed"},{"code":"TNL_CLIENT_AUTH_WAIT_TIMEOUT","slug":"auth-wait-timeout","class":"unavailable","message":"login is still waiting for approval","action":"resume with tnl auth login wait <operation-id>"},{"code":"TNL_CLIENT_BROWSER_OPEN_FAILED","slug":"browser-open-failed","class":"unavailable","message":"tnl could not open the public URL in a browser","action":"open the printed public URL manually"},{"code":"TNL_CLIENT_CERTIFICATE_UNAVAILABLE","slug":"certificate-unavailable","class":"unavailable","message":"the public URL certificate is not ready","action":"leave the tunnel running while certificate issuance retries"},{"code":"TNL_CLIENT_CONNECTION_CLEANUP_FAILED","slug":"connection-cleanup-failed","class":"unavailable","message":"the connector owner stopped with a cleanup failure","action":"check the selected server's availability and revoke the workload session if it remains active"},{"code":"TNL_CLIENT_CONNECTION_EXPIRED","slug":"connection-expired","class":"unavailable","message":"the connector session has expired","action":"prepare connections again within the authorized execution window"},{"code":"TNL_CLIENT_CONNECTION_HANDLE_INVALID","slug":"connection-handle-invalid","class":"invalid","message":"the private connection handle is not valid for this project or user","action":"prepare connections again from the selected project"},{"code":"TNL_CLIENT_CONNECTION_PORT_IN_USE","slug":"connection-port-in-use","class":"conflict","message":"the service's allocated loopback port is already in use","action":"stop the process using that port and prepare connections again"},{"code":"TNL_CLIENT_CONNECTION_REQUEST_INVALID","slug":"connection-request-invalid","class":"invalid","message":"the connector connection request is invalid","action":"check the connection schema, project configuration, and selected services"},{"code":"TNL_CLIENT_CONNECTION_TEAM_BINDING","slug":"connection-team-binding","class":"invalid","message":"the workload has no configured team selector","action":"set team in project configuration and run tnl generate"},{"code":"TNL_CLIENT_CONNECTION_TLS_REJECTED","slug":"connection-tls-rejected","class":"invalid","message":"the native service TLS certificate could not be verified","action":"check the service hostname and the client's server trust roots, then prepare connections again"},{"code":"TNL_CLIENT_CONNECTION_TRANSPORT_MISSING","slug":"connection-transport-missing","class":"unavailable","message":"this binary does not include the required connector transport","action":"use a tnl binary with the required connection capabilities"},{"code":"TNL_CLIENT_CONNECTION_UNAVAILABLE","slug":"connection-unavailable","class":"unavailable","message":"the connector owner could not prepare or maintain every selected service","action":"check service availability and prepare connections again"},{"code":"TNL_CLIENT_CONNECT_ACCESS_REQUIRED","slug":"connect-access-required","class":"forbidden","message":"the current sign-in or device cannot access this service","action":"run tnl auth login --team <team> to refresh company sign-in, and check device and service access before reconnecting"},{"code":"TNL_CLIENT_CONNECT_MODE_INVALID","slug":"connect-mode-invalid","class":"invalid","message":"connect options select incompatible modes","action":"select one of --foreground, --detach, or --install; --stdio takes none of these, --listen, or --output=json"},{"code":"TNL_CLIENT_CONNECT_PROTOCOL_MISMATCH","slug":"connect-protocol-mismatch","class":"invalid","message":"--protocol differs from the approved service protocol","action":"omit --protocol to use trusted service metadata; no flag changes the service's authentication"},{"code":"TNL_CLIENT_CONNECT_SERVER_ROOTS_UNAVAILABLE","slug":"connect-server-roots-unavailable","class":"not_found","message":"mysql needs a server CA bundle for VERIFY_IDENTITY","action":"install system CA certificates or set SSL_CERT_FILE to a trusted PEM bundle, then run tnl connect again"},{"code":"TNL_CLIENT_CONNECT_STDIO_PROTOCOL_INVALID","slug":"connect-stdio-protocol-invalid","class":"invalid","message":"--stdio requires a service with the approved tcp protocol","action":"omit --stdio for native HTTP and database clients; no flag changes the service's authentication"},{"code":"TNL_CLIENT_CURRENT_DIRECTORY_UNAVAILABLE","slug":"current-directory-unavailable","class":"unavailable","message":"tnl could not read the working directory","action":"move to an accessible project directory and retry"},{"code":"TNL_CLIENT_CUSTOM_DOMAINS_DISABLED","slug":"custom-domains-disabled","class":"forbidden","message":"this server does not allow adding custom domains","action":"publish on a domain already available to your team"},{"code":"TNL_CLIENT_DEMO_CONFIG_NOT_USED","slug":"demo-config-not-used","class":"invalid","message":"the built-in demo does not use project configuration","action":"remove --config from tnl publish --demo"},{"code":"TNL_CLIENT_DEMO_LOCAL_SERVICE_UNAVAILABLE","slug":"demo-local-service-unavailable","class":"unavailable","message":"tnl could not start the local demo","action":"check that loopback networking is available, then retry"},{"code":"TNL_CLIENT_DEMO_MUST_BE_EPHEMERAL","slug":"demo-must-be-ephemeral","class":"invalid","message":"the built-in demo needs an ephemeral public URL","action":"remove --ephemeral=false from tnl publish --demo"},{"code":"TNL_CLIENT_DEMO_TARGET_NOT_ALLOWED","slug":"demo-target-not-allowed","class":"invalid","message":"the built-in demo starts its own local service","action":"remove the service or target argument from tnl publish --demo"},{"code":"TNL_CLIENT_DEMO_URL_MANAGED","slug":"demo-url-managed","class":"invalid","message":"the built-in demo chooses its own public URL","action":"remove --name or --public-url from tnl publish --demo"},{"code":"TNL_CLIENT_DETACHED_NOT_FOUND","slug":"detached-not-found","class":"not_found","message":"the detached publication is not running","action":"run tnl detached list to see current publications"},{"code":"TNL_CLIENT_DETACHED_START_FAILED","slug":"detached-start-failed","class":"unavailable","message":"the detached publication did not start","action":"run tnl publish without --detach to see the failure, then retry"},{"code":"TNL_CLIENT_DNS_PENDING","slug":"dns-pending","class":"unavailable","message":"the domain's DNS setup is not ready","action":"check its DNS records and retry after they propagate"},{"code":"TNL_CLIENT_DOMAIN_NOT_AVAILABLE","slug":"domain-not-available","class":"not_found","message":"the selected domain is not available to this team","action":"run tnl domain list and select a domain owned by the current team"},{"code":"TNL_CLIENT_DOMAIN_NOT_READY","slug":"domain-not-ready","class":"unavailable","message":"the selected domain is not ready for public URLs","action":"check tnl domain status and complete its required DNS records"},{"code":"TNL_CLIENT_DOMAIN_UNAVAILABLE","slug":"domain-unavailable","class":"unavailable","message":"tnl could not complete the domain operation","action":"check the team domain and required DNS records, then retry"},{"code":"TNL_CLIENT_FEEDBACK_INPUT_INVALID","slug":"feedback-input-invalid","class":"invalid","message":"feedback ID, cursor, or message is invalid","action":"use an ID from tnl feedback list, a nonnegative cursor, and a message of at most 4000 bytes"},{"code":"TNL_CLIENT_GUEST_DEMO_ONLY","slug":"guest-demo-only","class":"forbidden","message":"guest access only publishes the built-in demo","action":"run tnl auth login to publish your own app or change settings"},{"code":"TNL_CLIENT_GUEST_IP_CHANGED","slug":"guest-ip-changed","class":"forbidden","message":"your IP changed since this guest demo started","action":"run tnl auth login to publish your own app"},{"code":"TNL_CLIENT_GUEST_ISSUANCE_LIMITED","slug":"guest-issuance-limited","class":"rate_limited","message":"guest demo creation is limited on this network","action":"wait an hour or run tnl auth login to continue"},{"code":"TNL_CLIENT_GUEST_SESSION_INVALID","slug":"guest-session-invalid","class":"invalid","message":"the saved guest demo state is invalid","action":"run tnl auth login or retry tnl publish --demo with a fresh --state-dir"},{"code":"TNL_CLIENT_GUEST_SIGN_IN_REQUIRED","slug":"guest-sign-in-required","class":"unauthenticated","message":"this command needs sign-in","action":"run tnl auth login to manage this server, or tnl publish --demo to try the built-in demo"},{"code":"TNL_CLIENT_GUEST_TRIAL_EXHAUSTED","slug":"guest-trial-exhausted","class":"forbidden","message":"this guest demo trial has ended","action":"run tnl auth login to publish your own app"},{"code":"TNL_CLIENT_INIT_FAILED","slug":"init-failed","class":"unavailable","message":"tnl could not finish setting up this project","action":"check project files and permissions, then run tnl init again"},{"code":"TNL_CLIENT_INIT_FRAMEWORK","slug":"init-framework","class":"invalid","message":"tnl could not determine the project's framework","action":"choose the framework integration for the project, then run tnl init again"},{"code":"TNL_CLIENT_INIT_PACKAGE_MANAGER","slug":"init-package-manager","class":"invalid","message":"tnl could not select a package manager","action":"set packageManager to pnpm, npm, yarn, or bun, then run tnl init again"},{"code":"TNL_CLIENT_INSTALLED_JOB_AMBIGUOUS","slug":"installed-job-ambiguous","class":"conflict","message":"more than one installed publication has this name","action":"run tnl service list and use the job ID for start, stop, or remove"},{"code":"TNL_CLIENT_INSTALLED_PUBLISHER_SELECTION_MISSING","slug":"installed-publisher-selection-missing","class":"not_found","message":"this service has no saved scoped publisher grant","action":"publish the service once to save its public URL, then enroll a publisher for that URL and retry --install with --enroll-key"},{"code":"TNL_CLIENT_INSTALLED_PUBLISH_RUN_PENDING","slug":"installed-publish-run-pending","class":"unavailable","message":"the saved public URL's previous publish run is still closing","action":"leave the publisher running while control expires the previous run; stop any other publisher still serving this URL"},{"code":"TNL_CLIENT_INSTALLED_SERVICE_IDENTITY_UNAVAILABLE","slug":"installed-service-identity-unavailable","class":"unavailable","message":"tnl could not determine the configured service's exact public hostname and team","action":"sign in to resolve the selected team and domain, or configure an exact tunnel.public_url and select its publisher explicitly"},{"code":"TNL_CLIENT_INSTALLED_TARGET_MISSING","slug":"installed-target-missing","class":"invalid","message":"the configured service has no fixed target to install","action":"set this service's target to an address that remains valid after restart, then retry --install"},{"code":"TNL_CLIENT_INTEGRATION_URL_LEASE_EXPIRED","slug":"integration-url-lease-expired","class":"stale","message":"the integration URL publisher stopped renewing its readiness","action":"check the running app tunnels and restart one if the publisher does not recover"},{"code":"TNL_CLIENT_INTEGRATION_URL_NOT_READY","slug":"integration-url-not-ready","class":"unavailable","message":"the integration URL publisher is not ready","action":"keep a participating app or tnl publish tunnel running and wait for its publisher"},{"code":"TNL_CLIENT_INVALID_AUTHORITY_URL","slug":"invalid-authority-url","class":"invalid","message":"authority endpoint must be a canonical HTTPS origin","action":"check the authority URL configured on the selected server"},{"code":"TNL_CLIENT_INVALID_COMMAND","slug":"invalid-command","class":"invalid","message":"tnl could not use this command or its options","action":"run tnl --help or the command's --help and correct the arguments"},{"code":"TNL_CLIENT_INVALID_CONTROL_PORT","slug":"invalid-control-port","class":"invalid","message":"server port must be between 1 and 65535","action":"check the control URL port and retry"},{"code":"TNL_CLIENT_INVALID_CONTROL_URL","slug":"invalid-control-url","class":"invalid","message":"server must be an HTTPS origin","action":"use an HTTPS control URL with --server or TNL_SERVER"},{"code":"TNL_CLIENT_INVALID_DOMAIN_NAME","slug":"invalid-domain-name","class":"invalid","message":"the domain name is not a canonical DNS name","action":"use lowercase ASCII DNS labels without a trailing dot"},{"code":"TNL_CLIENT_INVALID_SETUP_INPUT","slug":"invalid-setup-input","class":"invalid","message":"the entered value is not valid for this prompt","action":"enter one of the shown values or press enter to skip"},{"code":"TNL_CLIENT_INVALID_TARGET","slug":"invalid-target","class":"invalid","message":"the service target is invalid","action":"use an HTTP or HTTPS origin reachable by tnl, or a local port"},{"code":"TNL_CLIENT_INVALID_TUNNEL_FLAGS","slug":"invalid-tunnel-flags","class":"invalid","message":"tunnel options conflict or contain an invalid value","action":"check --public-url, --name, --ip, and HTTP limits such as --concurrency"},{"code":"TNL_CLIENT_LOCAL_PRIVATE_SERVICE_UNAVAILABLE","slug":"local-private-service-unavailable","class":"not_found","message":"the local service is not available in this worktree","action":"start the app or run tnl publish with the configured service key, check visitor access, then retry tnl connect"},{"code":"TNL_CLIENT_MEMBER_HOSTNAME_DEPTH_EXCEEDED","slug":"member-hostname-depth-exceeded","class":"forbidden","message":"this hostname exceeds the server's member URL depth limit on its managed domain","action":"use fewer labels beneath your namespace"},{"code":"TNL_CLIENT_MISSING_TARGET","slug":"missing-target","class":"invalid","message":"a target is required","action":"pass an HTTP or HTTPS origin or local port, or set publish.target in the project configuration"},{"code":"TNL_CLIENT_NAMED_PUBLISH_OVERRIDES","slug":"named-publish-overrides","class":"invalid","message":"named publishing uses the selected project configuration","action":"set public URL, access, TLS, limits, and inspection in the selected configuration"},{"code":"TNL_CLIENT_NAMED_PUBLISH_SESSION","slug":"named-publish-session","class":"invalid","message":"named publishing requires its saved sign-in","action":"omit the access token or publish an explicit target"},{"code":"TNL_CLIENT_NAMED_PUBLISH_TEAM","slug":"named-publish-team","class":"invalid","message":"the configured team belongs to another server selection","action":"select --team explicitly for the selected server"},{"code":"TNL_CLIENT_OBSERVABILITY_CONFIG_INVALID","slug":"observability-config-invalid","class":"invalid","message":"operational observability configuration is invalid","action":"correct the named OTEL setting or remove optional export configuration"},{"code":"TNL_CLIENT_OUTPUT_UNAVAILABLE","slug":"output-unavailable","class":"unavailable","message":"tnl could not write the command result","action":"check the output destination and retry"},{"code":"TNL_CLIENT_PREVIEW_NOT_SAVED","slug":"preview-not-saved","class":"not_found","message":"the project does not have a saved preview","action":"start a configured app service before sharing or reading its feedback"},{"code":"TNL_CLIENT_PREVIEW_STATE_CONFLICT","slug":"preview-state-conflict","class":"conflict","message":"the saved preview does not match the current project","action":"check the selected server, team, and project, then restart the app"},{"code":"TNL_CLIENT_PRIVATE_PUBLISHER_UNAVAILABLE","slug":"private-publisher-unavailable","class":"unavailable","message":"the private TCP publisher is not connected to the relay service yet","action":"wait for private publisher relay support before installing this service"},{"code":"TNL_CLIENT_PROJECT_CONFIG_INVALID","slug":"project-config-invalid","class":"invalid","message":"tnl could not use the project configuration","action":"run tnl check and correct the reported setting"},{"code":"TNL_CLIENT_PROJECT_CONFIG_MISSING","slug":"project-config-missing","class":"not_found","message":"no project configuration file was found","action":"run tnl init or select a config file with --config"},{"code":"TNL_CLIENT_PUBLISHER_CERTIFICATE_STATE_MISSING","slug":"publisher-certificate-state-missing","class":"not_found","message":"this replica's durable publisher certificate state is missing","action":"restore this replica's identity directory and select it with --identity-dir"},{"code":"TNL_CLIENT_PUBLISHER_DEPLOYMENT_INVALID","slug":"publisher-deployment-invalid","class":"invalid","message":"generated project files are missing, stale, or unsafe","action":"run tnl generate with the same --output-dir; use regular files and directories without symlinks"},{"code":"TNL_CLIENT_PUBLISHER_DEPLOYMENT_METADATA_INVALID","slug":"publisher-deployment-metadata-invalid","class":"invalid","message":"publisher deployment metadata is incomplete or invalid","action":"supply all TNL_DEPLOYMENT_* metadata fields and use the provisioned instance"},{"code":"TNL_CLIENT_PUBLISHER_DEPLOYMENT_WRITE_FAILED","slug":"publisher-deployment-write-failed","class":"invalid","message":"tnl could not write generated project files","action":"check output directory permissions and symlinks, then run tnl generate; keep handwritten files outside the generated directory"},{"code":"TNL_CLIENT_PUBLISHER_ENROLLMENT_INPUT","slug":"publisher-enrollment-input","class":"invalid","message":"one publisher enrollment key is required","action":"pass one enrollment key or use --enroll-key - to read it from stdin"},{"code":"TNL_CLIENT_PUBLISHER_ENROLLMENT_REQUIRED","slug":"publisher-enrollment-required","class":"unauthenticated","message":"this publisher needs a new enrollment key","action":"request fresh enrollment for the saved public URL with tnl publisher enroll; set TNL_ENROLL_KEY and restart with the persistent state volume"},{"code":"TNL_CLIENT_PUBLISHER_GRANT_MISMATCH","slug":"publisher-grant-mismatch","class":"invalid","message":"the selected publisher grant does not match this publication","action":"match the configured service, target, protocol, and public or private scope to the saved grant"},{"code":"TNL_CLIENT_PUBLISHER_IDENTITY_STATE_INVALID","slug":"publisher-identity-state-invalid","class":"invalid","message":"the durable publisher identity files are unsafe, invalid or belong to another scope","action":"check the identity directory, permissions and replica ownership, or restore its valid files"},{"code":"TNL_CLIENT_PUBLISHER_IDENTITY_STATE_UNAVAILABLE","slug":"publisher-identity-state-unavailable","class":"unavailable","message":"tnl could not use the durable publisher identity files","action":"check the identity directory's mount and available space, then retry"},{"code":"TNL_CLIENT_PUBLISHER_INSTALL_INSPECTION","slug":"publisher-install-inspection","class":"invalid","message":"installed publication does not support inspection capture","action":"use --inspection-mode=none"},{"code":"TNL_CLIENT_PUBLISHER_INSTALL_OPTIONS","slug":"publisher-install-options","class":"invalid","message":"installed publication requires a saved HTTP public URL and stable target","action":"select --name or --public-url with a stable HTTP target; remove demo, ephemeral, and open options"},{"code":"TNL_CLIENT_PUBLISHER_INSTALL_SOURCE_INVALID","slug":"publisher-install-source-invalid","class":"invalid","message":"tnl's installation files are missing or unsafe","action":"install tnl from a release archive with LICENSE, NOTICE and THIRD_PARTY_LICENSES.txt, then retry --install"},{"code":"TNL_CLIENT_PUBLISHER_NAMESPACE_OPTIONS","slug":"publisher-namespace-options","class":"invalid","message":"namespace publication requires an HTTP target","action":"select an HTTP target and remove private-protocol and target TLS name overrides"},{"code":"TNL_CLIENT_PUBLISHER_SAVED_POLICY","slug":"publisher-saved-policy","class":"invalid","message":"the saved public URL owns visitor policy and lifecycle","action":"remove anonymous, access, IP, and ephemeral overrides; change policy on the saved URL"},{"code":"TNL_CLIENT_PUBLISHER_SELECTION_INVALID","slug":"publisher-selection-invalid","class":"invalid","message":"scoped publisher selection conflicts with publication options","action":"select one --enroll-key, --publisher, or --publisher-credential-file; its grant selects the URL and team"},{"code":"TNL_CLIENT_SERVER_CONFLICT","slug":"server-conflict","class":"conflict","message":"the requested operation conflicts with the server's current state","action":"inspect the public URL or team state and retry when it changes"},{"code":"TNL_CLIENT_SERVER_DENIED","slug":"server-denied","class":"forbidden","message":"the selected identity is not allowed to perform this operation","action":"check the team membership and selected credentials"},{"code":"TNL_CLIENT_SERVER_RATE_LIMITED","slug":"server-rate-limited","class":"rate_limited","message":"the server is limiting requests","action":"wait for the retry interval before sending another request"},{"code":"TNL_CLIENT_SERVER_REQUEST_INVALID","slug":"server-request-invalid","class":"invalid","message":"the server rejected this request","action":"check the command options and selected resource, then retry"},{"code":"TNL_CLIENT_SERVER_RESOURCE_NOT_FOUND","slug":"server-resource-not-found","class":"not_found","message":"the requested resource was not found on the selected server","action":"check the selected server, team, and resource ID"},{"code":"TNL_CLIENT_SERVER_RESPONSE_INVALID","slug":"server-response-invalid","class":"internal","message":"the server sent a response tnl could not use","action":"check the selected server and its version, then retry"},{"code":"TNL_CLIENT_SERVER_UNAVAILABLE","slug":"server-unavailable","class":"unavailable","message":"tnl could not reach the selected server","action":"check the server address and connectivity, then retry","cases":[{"id":"timeout","description":"the selected server did not respond before the request timed out.","action":"check network connectivity and server health, then retry","diagram_detail":"server response timed out"},{"id":"connection-refused","description":"a connection to the selected server was refused.","action":"check the selected control URL and server listener, then retry","diagram_detail":"server refused connection"}]},{"code":"TNL_CLIENT_SERVICE_NOT_CONFIGURED","slug":"service-not-configured","class":"not_found","message":"the selected service is not configured","action":"run tnl check or select a configured project service"},{"code":"TNL_CLIENT_SERVICE_NOT_INSTALLED","slug":"service-not-installed","class":"not_found","message":"the selected tnl service is not installed or running","action":"log into your user session and run tnl service install, or run sudo tnl service install --system for headless publications"},{"code":"TNL_CLIENT_SHARE_INPUT_INVALID","slug":"share-input-invalid","class":"invalid","message":"share URL or lifetime is invalid","action":"select a public URL ID, hostname, or HTTPS origin and a lifetime greater than zero and at most 30d"},{"code":"TNL_CLIENT_STATE_LOCKED","slug":"state-locked","class":"conflict","message":"another tnl process is using the client state","action":"wait for it to finish or stop it, then retry"},{"code":"TNL_CLIENT_STATE_UNAVAILABLE","slug":"state-unavailable","class":"unavailable","message":"tnl could not use the client state","action":"check the state directory and its permissions, then retry","cases":[{"id":"permission-denied","description":"tnl cannot access the local client state directory.","action":"check permissions on the state directory, then retry","diagram_detail":"state directory access denied"}]},{"code":"TNL_CLIENT_TARGET_DISCOVERY_AUTHENTICATION","slug":"target-discovery-authentication","class":"unauthenticated","message":"cloud target credentials are unavailable or rejected","action":"check the publisher's AWS credential chain"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_CHANGED","slug":"target-discovery-changed","class":"conflict","message":"cloud target resource or CA changed","action":"prepare a new publication"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_DENIED","slug":"target-discovery-denied","class":"forbidden","message":"cloud target discovery was denied","action":"allow the selected resource's Describe action on the publisher role"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_INVALID","slug":"target-discovery-invalid","class":"invalid","message":"cloud target selector or protocol is invalid","action":"check the assigned target declaration"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_METADATA","slug":"target-discovery-metadata","class":"invalid","message":"cloud target metadata or TLS trust is invalid","action":"check the selected resource before preparing another publication"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_NOT_FOUND","slug":"target-discovery-not-found","class":"not_found","message":"cloud target was not found","action":"check the declared region and resource identifier"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_NOT_READY","slug":"target-discovery-not-ready","class":"unavailable","message":"cloud target is not ready","action":"wait for the selected resource to become available"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_STALE","slug":"target-discovery-stale","class":"stale","message":"cloud target discovery is stale","action":"restore publisher access to AWS before opening new connections"},{"code":"TNL_CLIENT_TARGET_DISCOVERY_UNAVAILABLE","slug":"target-discovery-unavailable","class":"unavailable","message":"cloud target discovery is unavailable","action":"retry when AWS is reachable"},{"code":"TNL_CLIENT_TARGET_TLS_REJECTED","slug":"target-tls-rejected","class":"invalid","message":"target TLS could not be verified or negotiated","action":"check the target protocol, target.tls.server_name, and target.tls.ca_file, then retry"},{"code":"TNL_CLIENT_TARGET_UNAVAILABLE","slug":"target-unavailable","class":"unavailable","message":"the publisher could not reach the target","action":"check the target listener and publisher network connection, then retry"},{"code":"TNL_CLIENT_TEAM_NOT_FOUND","slug":"team-not-found","class":"not_found","message":"team not found","action":"run tnl team list and choose a team you belong to"},{"code":"TNL_CLIENT_TEAM_SELECTION_AMBIGUOUS","slug":"team-selection-ambiguous","class":"conflict","message":"more than one team has the selected name","action":"run tnl team list and select a team by ID with --team"},{"code":"TNL_CLIENT_TEAM_UNAVAILABLE","slug":"team-unavailable","class":"unavailable","message":"tnl could not complete the team operation","action":"check the selected team and membership, then retry"},{"code":"TNL_CLIENT_TRANSPORT_FALLBACK","slug":"transport-fallback","class":"degraded","message":"QUIC did not establish before TLS/TCP; continuing over TLS/TCP","action":"the tunnel remains available over TLS/TCP"},{"code":"TNL_CLIENT_TRANSPORT_UNAVAILABLE","slug":"transport-unavailable","class":"unavailable","message":"a publisher connection could not be established","action":"check connectivity to the assigned relay and retry"},{"code":"TNL_CLIENT_TUNNEL_UNAVAILABLE","slug":"tunnel-unavailable","class":"unavailable","message":"tnl could not start or maintain this tunnel","action":"check the local service, selected server, and network connection, then retry"},{"code":"TNL_CLIENT_WEBHOOK_NOT_SELECTED","slug":"webhook-not-selected","class":"conflict","message":"this worktree is not the selected webhook receiver","action":"check tnl status before releasing or switching this webhook"},{"code":"TNL_CLIENT_WEBHOOK_NO_READY_RECEIVERS","slug":"webhook-no-ready-receivers","class":"unavailable","message":"this webhook has no ready receivers","action":"start the configured service in a worktree and wait for its public URL"},{"code":"TNL_CLIENT_WEBHOOK_OWNED","slug":"webhook-owned","class":"conflict","message":"another running tunnel is selected for this webhook","action":"run tnl webhook use NAME --force to switch, or release it from the current worktree"},{"code":"TNL_CLIENT_WEBHOOK_OWNER_MISSING","slug":"webhook-owner-missing","class":"unavailable","message":"this webhook has no selected receiver","action":"run tnl webhook use NAME from a worktree with a ready service"},{"code":"TNL_CLIENT_WEBHOOK_OWNER_UNREADY","slug":"webhook-owner-unready","class":"unavailable","message":"the selected webhook receiver is not ready","action":"wait for its tunnel to recover or run tnl webhook use NAME --force from a ready worktree"},{"code":"TNL_CLIENT_WEBHOOK_POLICY_CONFLICT","slug":"webhook-policy-conflict","class":"conflict","message":"worktrees disagree about this webhook endpoint","action":"make the endpoint declarations agree, then restart the conflicting tunnel"},{"code":"TNL_CLIENT_WEBHOOK_RECEIVER_UNREADY","slug":"webhook-receiver-unready","class":"unavailable","message":"the selected webhook receiver is not ready","action":"start the configured service in this worktree and wait for its public URL to be ready"},{"code":"TNL_CLIENT_WORKLOAD_ASSERTION_UNAVAILABLE","slug":"workload-assertion-unavailable","class":"unauthenticated","message":"the workload provider assertion is unavailable","action":"check the selected workload's token file or provider acquisition callback"},{"code":"TNL_CLIENT_WORKLOAD_MANIFEST_INVALID","slug":"workload-manifest-invalid","class":"invalid","message":"the generated workload manifest is missing or invalid","action":"run tnl generate during the build and package .tnl/generated/workloads.json with the application"},{"code":"TNL_CLIENT_WORKLOAD_REPOSITORY_METADATA_UNAVAILABLE","slug":"workload-repository-metadata-unavailable","class":"invalid","message":"workload repository metadata is unavailable for first setup","action":"configure existing gh authentication with read access to this repository, then run tnl apply again"},{"code":"TNL_CLIENT_WORKLOAD_REQUIRED","slug":"workload-required","class":"invalid","message":"select one saved workload","action":"set TNL_WORKLOAD or configure a workload source in the SDK"},{"code":"TNL_CLIENT_WORKLOAD_SERVICE_DENIED","slug":"workload-service-denied","class":"forbidden","message":"the selected workload does not include this service","action":"check the selected workload and its saved service access"}]}