# Interface: ToolkitEntry

A tool reference produced by a plugin's `.toolkit()` call. The agents plugin recognizes the `__toolkitRef` brand and dispatches tool invocations through `PluginContext.executeTool(req, pluginName, localName, ...)`, preserving OBO (asUser) and telemetry spans.

## Properties[​](#properties "Direct link to Properties")

### \_\_toolkitRef[​](#__toolkitref "Direct link to __toolkitRef")

```ts
readonly __toolkitRef: true;

```

***

### annotations?[​](#annotations "Direct link to annotations?")

```ts
optional annotations: ToolAnnotations;

```

***

### autoInheritable?[​](#autoinheritable "Direct link to autoInheritable?")

```ts
optional autoInheritable: boolean;

```

Whether this tool is eligible for `autoInheritTools` spreading. Mirrors [ToolEntry.autoInheritable](./docs/api/appkit/Interface.ToolEntry.md#autoinheritable) from the source registry so the agents plugin can filter auto-inherited tools without re-walking the provider's internal registry.

***

### def[​](#def "Direct link to def")

```ts
def: AgentToolDefinition;

```

***

### localName[​](#localname "Direct link to localName")

```ts
localName: string;

```

***

### pluginName[​](#pluginname "Direct link to pluginName")

```ts
pluginName: string;

```