tooltimeout

package
v0.30.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 31, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Overview

Package tooltimeout implements nexus.gate.tool_timeout, a per-call deadline gate for tool invocations. It observes tool.invoke, starts a timer per call, and on expiry synthesizes a tool.result error plus a tool.timeout event so the agent's bookkeeping unwinds even when a tool hangs.

The gate is on by default: nexus.tool.catalog auto-activates it through Requires(), so every profile that dispatches tools through the catalog gets a per-call deadline without listing the gate. The default deadline is a backstop (minutes, not seconds) sized above every shipped tool's own timeout, and tools whose wait is bounded by a human or by their own wall-clock budget are exempt by default (see builtinPerTool).

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func New

func New() engine.Plugin

New creates a new tool_timeout gate plugin instance.

Types

type Plugin

type Plugin struct {
	// contains filtered or unexported fields
}

Plugin watches tool.invoke / tool.result and synthesizes a tool.result error + tool.timeout event when a call exceeds its deadline. It does not veto before:tool.invoke; other gates remain free to refuse the call.

func (*Plugin) Capabilities

func (p *Plugin) Capabilities() []engine.Capability

func (*Plugin) ConfigSchema

func (p *Plugin) ConfigSchema() []byte

ConfigSchema implements engine.ConfigSchemaProvider.

func (*Plugin) Dependencies

func (p *Plugin) Dependencies() []string

func (*Plugin) Emissions

func (p *Plugin) Emissions() []string

func (*Plugin) ID

func (p *Plugin) ID() string

func (*Plugin) Init

func (p *Plugin) Init(ctx engine.PluginContext) error

func (*Plugin) Name

func (p *Plugin) Name() string

func (*Plugin) Ready

func (p *Plugin) Ready() error

func (*Plugin) Requires

func (p *Plugin) Requires() []engine.Requirement

func (*Plugin) Shutdown

func (p *Plugin) Shutdown(_ context.Context) error

func (*Plugin) Subscriptions

func (p *Plugin) Subscriptions() []engine.EventSubscription

func (*Plugin) Version

func (p *Plugin) Version() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL