@adhd/代理基型

为 @adhd/ agent- * 家族共享类型脚本类型定义和计划 。 提供代理,任务,会话,消息,用法以及验证策略的接口.

状态 : 共用类型(已发运 v 2.0.0)
软件包 : npm install @adhd/agent-base-types
消费者: 所有代理软件包

它会做什么

• 核心类型 - 代理、任务、会话、消息、任务事件接口
• 托肯会计 ——与提供者中性字段的 TokenUsage 接口(2.0.2+)
• 反应模式 —— 说 PostModelResponsePayload.responseModel 提供商说发送了电话(未报告)
• 验证计划 ——代理配置的Zod schemas,任务输入,消息验证
• 执行模式 ——状态语句,停止理由正常化,出错类型
• MCP合同 - 16个多边CP工具的工具输入/输出计划

使用量

import {
  Agent,
  Task,
  TokenUsage,
  agentCreateSchema,
} from '@adhd/agent-base-types';

const agentConfig = agentCreateSchema.parse({
  name: 'my-agent',
  config: { provider: 'anthropic', model: 'claude-opus-4-1' },
});

关键文件

• src/domain.ts ——核心接口定义(代理,任务,会话,消息,托克内乌斯克)
• src/validation/ 所有投入的Zod计划
• src/index.ts ——公共出口

R10 微量符号类型( 添加, 所有可选)

• 虎克事件 (单位:千美元)HookEventMap 内 src/hooks.ts: task:startup (单位:千美元)TaskStartupPayload: per- server MCP 连接 ms, 工具准备 ms, 队列等待, 会话 ms, 工具计数), dispatch:completed (单位:千美元)DispatchCompletedPayload: 类型、 同步/ 背景模式、 任务代号、 父屏蔽 ms) 和 background:delivered (单位:千美元)BackgroundDeliveredPayload; 仅输入,尚未发射). HookEvent 实值 keyof HookEventMap,因此这些被 HookRegistry 没有进一步登记.
• 有效载荷字段 : PreToolCallPayload 收益 concurrencyClass, (中文(简体) ), turnIndex, (中文(简体) ), groupIndex, (中文(简体) ), queuedMs· ; PostToolCallPayload 收益 errorClass, (中文(简体) ), resultBytes, (中文(简体) ), noteAppended; 数据 post:model_response 有效载荷收益 thinkingConfig, (中文(简体) ), thinkingBlocks, (中文(简体) ), toolResultBytesIn, (中文(简体) ), turnIndex (已携带) ttfbMs) (中文(简体) ).
• ToolDefinition.annotations (单位:千美元)IToolAnnotations数字 : readOnlyHint, (中文(简体) ), destructiveHint, (中文(简体) ), idempotentHint:引擎-内部元数据. 绝对不能串行到提供者的电线请求上 也不能串行到犬科工具散列上.
• IAnthropicThinking (单位:千美元){ type: 'adaptive'; display?: 'summarized' | 'omitted' } | { type: 'disabled' }在人类的 ProviderConfig 财务报告和审定财务报表 PartialBinding 作为 thinking。默认未设定;由管弦乐手验证 providerConfigSchema。 。 。 .

2.0.2 变动

• TokenUsage 扩展 - 添加 uncachedInputTokens, (中文(简体) ), cacheReadTokens, (中文(简体) ), cacheCreationTokens, (中文(简体) ), reasoningTokens 字段(提供者中性会计)
• 已添加 peakContextTokens 到任务跟踪( u)

建筑

• 6个包装剂框架家族的一部分
• 取决于: zod
• 取决于: 所有其他@adhd/ agent- * 软件包

见 /entrypoint/agent-mcp/docs/architecture-and-security.md 用于全代理运行时架构.