枚举 / 常量参考 · JS / 浏览器

JS SDK 用 export const 对象承载 wire 常量（非 TS enum），值即 wire 字符串。

AgentEventType

export const AgentEventType = {
  // —— 遥操（v1.5.0）——
  TeleopEnter:        'agentsdk.teleop.enter',
  TeleopEnterAck:     'agentsdk.teleop.enter_ack',
  TeleopAudioStart:   'agentsdk.teleop_audio.start',
  TeleopAudioDelta:   'agentsdk.teleop_audio.delta',
  TeleopAudioDone:    'agentsdk.teleop_audio.done',
  TeleopKeepalive:    'agentsdk.teleop.keepalive',
  TeleopKeepaliveAck: 'agentsdk.teleop.keepalive_ack',
  TeleopExit:         'agentsdk.teleop.exit',
  TeleopExitAck:      'agentsdk.teleop.exit_ack',

  // —— 扩展技能（v1.5.0）——
  ExtSkillQuery:       'agentsdk.ext_skill.query',
  ExtSkillQueryResult: 'agentsdk.ext_skill.query_result',
  ExtSkillInvoke:      'agentsdk.ext_skill.invoke',
  ExtSkillInvokeAck:   'agentsdk.ext_skill.invoke_ack',
  ExtSkillInvokeResult:'agentsdk.ext_skill.invoke_result',

  // —— 预留（未接线分发）——
  FunctionCallExpose: 'agentsdk.function_call.expose',
  FunctionCallArbiter:'agentsdk.function_call.arbiter',
  HistoriesExpose:    'agentsdk.histories.expose',

  // —— 通用 ——
  SdkMetaReport: 'agentsdk.sdk_meta.report',
  Error:         'agentsdk.error',
} as const;

export type AgentEventType = typeof AgentEventType[keyof typeof AgentEventType];

常量	wire 值	说明
`TeleopEnter` / `TeleopEnterAck`	`agentsdk.teleop.enter[_ack]`	遥操进入 / 回执
`TeleopAudioStart` / `TeleopAudioDelta` / `TeleopAudioDone`	`agentsdk.teleop_audio.*`	遥操音频段起止 / 增量
`TeleopKeepalive` / `TeleopKeepaliveAck`	`agentsdk.teleop.keepalive[_ack]`	遥操探活
`TeleopExit` / `TeleopExitAck`	`agentsdk.teleop.exit[_ack]`	遥操退出 / 回执
`ExtSkillQuery` / `ExtSkillQueryResult`	`agentsdk.ext_skill.query[_result]`	扩展技能查询 / 结果
`ExtSkillInvoke` / `ExtSkillInvokeAck` / `ExtSkillInvokeResult`	`agentsdk.ext_skill.invoke[_ack/_result]`	扩展技能触发 / 受理 / 结果
`FunctionCallExpose` / `FunctionCallArbiter`	`agentsdk.function_call.*`	预留，未接线分发
`HistoriesExpose`	`agentsdk.histories.expose`	预留，未接线分发
`SdkMetaReport`	`agentsdk.sdk_meta.report`	连接后自动上报
`Error`	`agentsdk.error`	错误事件

FunctionCallExpose / FunctionCallArbiter / HistoriesExpose 仅作协议对齐参考，不代表 JS SDK 支持 Function Call / Arbiter / 对话历史。详见被动回调 API。

ArbiterDecision（预留）

export const ArbiterDecision = {
  Delegate: 'delegate',
  Override: 'override',
  Illegal: 'illegal',
} as const;
export type ArbiterDecision = typeof ArbiterDecision[keyof typeof ArbiterDecision];

常量	wire 值	语义
`Delegate`	`delegate`	委派智能体默认链路处理
`Override`	`override`	二开应用接管、覆盖默认行为
`Illegal`	`illegal`	非法 / 兜底

AgentPolicy

export const AgentPolicy = {
  Active:  'active',
  Passive: 'passive',
  Teleop:  'teleop',
  ExtSkill: 'extskill',
} as const;
export type AgentPolicy = typeof AgentPolicy[keyof typeof AgentPolicy];

常量	wire 值	说明
`Active`	`active`	主动交互（JS 未实现，仅常量）
`Passive`	`passive`	被动交互（JS 未实现，仅常量）
`Teleop`	`teleop`	超视距遥操（`TeleopSession` 报文 `agentMode` 用此值）
`ExtSkill`	`extskill`	扩展技能（`ExtSkillSession` 报文 `agentMode` 用此值）

使用

import { AgentEventType, AgentPolicy, ArbiterDecision } from 'linksoul-agentsdk';

sdk.on('message', ({ data }) => {
  const msg = JSON.parse(String(data));
  if (msg.type === AgentEventType.TeleopEnterAck) { /* ... */ }
});