@sophonsai/agent-embed-core 0.1.0 → 0.2.0

package/README.md

@@ -6,4 +6,4 @@ Core 不包含面板挂载、生命周期管理或主题 preset 等产品配置
 
 该包是 SDK 和框架适配包的底层依赖。业务项目通常应安装 SDK 或 React/Vue 适配包，不需要直接依赖 Core。
 
-URL 模式的 init config 为 `{ mode: "url", appearance, threadId? }`，不携带 Agent ID 或用户凭证。Agent 与身份由 iframe URL 中的 应用接入凭证 在 WebAPI 端解析。
+iframe 初始化消息使用 `{ mode: "url", appearance, threadId? }` 配置外观和初始会话。WebAPI 根据 iframe 路径中的应用接入凭证解析智能体和访问身份。

package/dist/index.d.mts

@@ -1,8 +1,6 @@
 //#region src/types.d.ts
 declare const AGENT_EMBED_QUERY_PARAMS: {
-  readonly agentId: "agent_id";
   readonly threadId: "thread_id";
-  readonly token: "token";
   readonly theme: "theme";
   readonly fontSize: "font_size";
   readonly headerHistoryButton: "header_history_button";
@@ -45,8 +43,6 @@ interface AgentTextPayload {
 interface AgentSessionRunEventContext {
   runId: string;
   threadId: string | null;
-  objectType: 'model' | 'agent' | 'knowledge_base' | 'database' | 'file';
-  objectId: string;
   step: number;
   parentToolCallId: string | null;
 }
@@ -86,12 +82,17 @@ interface AgentToolCallCancelledEvent {
 }
 type AgentToolCall = AgentToolCallStartedEvent & ({
   kind: 'tool';
-  executor: 'server';
+  executor: 'server' | 'client';
 } | {
   kind: 'action';
   executor: 'client';
 });
 interface AgentToolCallCreatedEvent {
+  toolCallId: string;
+  toolName: string;
+  icon?: string;
+}
+interface AgentToolCallReadyEvent {
   toolCall: AgentToolCall;
   dependsOn?: {
     toolCallId: string;
@@ -163,6 +164,7 @@ interface AgentEvents {
   onEvent?: (event: AgentServerEvent) => void;
   onSessionContextReady?: (context: AgentSessionContext) => void;
   onToolCallCreated?: (event: AgentToolCallCreatedEvent, context: AgentSessionEventContext) => void;
+  onToolCallReady?: (event: AgentToolCallReadyEvent, context: AgentSessionEventContext) => void;
   onToolApprovalRequested?: (event: AgentToolApprovalRequestedEvent, context: AgentSessionEventContext) => void;
   onToolCallStarted?: (event: AgentToolCallStartedEvent, context: AgentSessionEventContext) => void;
   onToolCallProgressUpdated?: (event: AgentToolCallProgressUpdatedEvent, context: AgentSessionEventContext) => void;
@@ -170,6 +172,7 @@ interface AgentEvents {
   onToolCallSucceeded?: (event: AgentToolCallSucceededEvent, context: AgentSessionEventContext) => void;
   onToolCallFailed?: (event: AgentToolCallFailedEvent, context: AgentSessionEventContext) => void;
   onToolCallCancelled?: (event: AgentToolCallCancelledEvent, context: AgentSessionEventContext) => void;
+  onClientToolRequest?: (event: AgentToolCallStartedEvent, context: AgentSessionEventContext) => void;
   onClientActionRequest?: (event: AgentClientActionRequestEvent, context: AgentSessionEventContext) => void;
   onUserFeedbackConsumed?: (event: AgentUserFeedbackConsumedEvent, context: AgentSessionEventContext) => void;
   onUserSteerConsumed?: (event: AgentUserSteerConsumedEvent, context: AgentSessionEventContext) => void;
@@ -188,20 +191,7 @@ interface AgentEvents {
   onCancelled?: (result: AgentSessionCancelled) => void;
   onSettled?: (result: AgentSessionSettlement) => void;
 }
-declare const AGENT_EVENT_NAMES: readonly ["onConcurrentSend", "onEvent", "onSessionContextReady", "onToolCallCreated", "onToolApprovalRequested", "onToolCallStarted", "onToolCallProgressUpdated", "onToolCallBackgrounded", "onToolCallSucceeded", "onToolCallFailed", "onToolCallCancelled", "onClientActionRequest", "onUserFeedbackConsumed", "onUserSteerConsumed", "onUserSteerCancelled", "onUserInputSubmitted", "onSessionTurnStarted", "onSessionTurnSucceeded", "onSessionTurnFailed", "onSessionTurnCancelled", "onSessionRunStarted", "onSessionRunIdled", "onSessionRunEnded", "onSystemMessageConsumed", "onSuccess", "onError", "onCancelled", "onSettled"];
-interface AgentEmbedPlatformUserAuth {
-  type: 'platform.user.credential';
-  credential: string;
-}
-interface AgentEmbedExtensionUserAuth {
-  type: 'extension.user.identity';
-  appId: string;
-  externalUser: {
-    id: string;
-    name?: string;
-  };
-}
-type AgentEmbedAuth = AgentEmbedPlatformUserAuth | AgentEmbedExtensionUserAuth;
+declare const AGENT_EVENT_NAMES: readonly ["onConcurrentSend", "onEvent", "onSessionContextReady", "onToolCallCreated", "onToolCallReady", "onToolApprovalRequested", "onToolCallStarted", "onToolCallProgressUpdated", "onToolCallBackgrounded", "onToolCallSucceeded", "onToolCallFailed", "onToolCallCancelled", "onClientToolRequest", "onClientActionRequest", "onUserFeedbackConsumed", "onUserSteerConsumed", "onUserSteerCancelled", "onUserInputSubmitted", "onSessionTurnStarted", "onSessionTurnSucceeded", "onSessionTurnFailed", "onSessionTurnCancelled", "onSessionRunStarted", "onSessionRunIdled", "onSessionRunEnded", "onSystemMessageConsumed", "onSuccess", "onError", "onCancelled", "onSettled"];
 interface AgentEmbedSendMessageInput {
   text: string;
 }
@@ -222,33 +212,18 @@ interface AgentEmbedInitError {
   code: 'invalid_token' | 'forbidden' | 'agent_not_found' | 'request_failed' | 'frame_load_failed';
   message: string;
 }
-interface AgentEmbedInitConfig {
-  agentId: string;
-  auth: AgentEmbedAuth;
-  /** @deprecated Bridge compatibility for token-mode clients and frames. */
-  token?: string;
-  threadId?: string;
-  appearance: AgentAppearance;
-}
-interface AgentEmbedLegacyInitConfig {
-  agentId: string;
-  token: string;
-  auth?: never;
-  threadId?: string;
-  appearance: AgentAppearance;
-}
 /** URL mode config carries appearance and session context, never platform credentials. */
 type AgentRuntimeValue = string | number | boolean | null | AgentRuntimeValue[] | AgentRuntimeVariables;
 interface AgentRuntimeVariables {
   [key: string]: AgentRuntimeValue;
 }
 interface AgentEmbedUrlInitConfig {
+  client_tool_names?: string[];
   mode: 'url';
   runtime_variables?: AgentRuntimeVariables;
   threadId?: string;
   appearance: AgentAppearance;
 }
-type AgentEmbedBridgeConfig = AgentEmbedInitConfig | AgentEmbedUrlInitConfig;
 //#endregion
 //#region src/protocol.d.ts
 declare const AGENT_EMBED_BRIDGE = "sophonsai/agent-component-bridge";
@@ -260,7 +235,7 @@ interface AgentEmbedInitMessage {
   version: typeof AGENT_EMBED_BRIDGE_VERSION;
   type: 'init';
   instanceId: string;
-  config: AgentEmbedInitConfig | AgentEmbedLegacyInitConfig | AgentEmbedUrlInitConfig;
+  config: AgentEmbedUrlInitConfig;
 }
 interface AgentEmbedCommandMessage {
   bridge: typeof AGENT_EMBED_BRIDGE;
@@ -296,4 +271,4 @@ declare const isAgentRuntimeVariables: (value: unknown) => value is AgentRuntime
 declare const isAgentEmbedHostMessage: (value: unknown) => value is AgentEmbedHostMessage;
 declare const isAgentEmbedFrameMessage: (value: unknown) => value is AgentEmbedFrameMessage;
 //#endregion
-export { AGENT_EMBED_BRIDGE, AGENT_EMBED_BRIDGE_VERSION, AGENT_EMBED_QUERY_PARAMS, AGENT_EVENT_NAMES, AgentAppearance, AgentClientActionRequestEvent, AgentEmbedAction, AgentEmbedAppearanceUpdate, AgentEmbedAuth, AgentEmbedBridgeConfig, AgentEmbedCallback, AgentEmbedCommandMessage, AgentEmbedExtensionUserAuth, AgentEmbedFrameMessage, AgentEmbedHeaderAppearance, AgentEmbedHostMessage, AgentEmbedInitConfig, AgentEmbedInitError, AgentEmbedInitMessage, AgentEmbedInputQuery, AgentEmbedInstance, AgentEmbedLegacyInitConfig, AgentEmbedPlatformUserAuth, AgentEmbedSendMessageInput, AgentEmbedTheme, AgentEmbedUpdateAppearanceMessage, AgentEmbedUrlInitConfig, AgentEvents, AgentRuntimeValue, AgentRuntimeVariables, AgentServerEvent, AgentSessionCancelled, AgentSessionContext, AgentSessionEventContext, AgentSessionFailure, AgentSessionRunEndedEvent, AgentSessionRunEventContext, AgentSessionRunIdledEvent, AgentSessionRunStartedEvent, AgentSessionSettlement, AgentSessionSuccess, AgentSessionTurnCancelledEvent, AgentSessionTurnFailedEvent, AgentSessionTurnStartedEvent, AgentSessionTurnSucceededEvent, AgentSystemMessageConsumedEvent, AgentTextPayload, AgentToolApprovalRequestedEvent, AgentToolCall, AgentToolCallBackgroundedEvent, AgentToolCallCancelledEvent, AgentToolCallCreatedEvent, AgentToolCallFailedEvent, AgentToolCallProgressUpdatedEvent, AgentToolCallStartedEvent, AgentToolCallSucceededEvent, AgentUserFeedbackConsumedEvent, AgentUserInputSubmittedEvent, AgentUserSteerCancelledEvent, AgentUserSteerConsumedEvent, isAgentEmbedFrameMessage, isAgentEmbedHostMessage, isAgentRuntimeVariables };
+export { AGENT_EMBED_BRIDGE, AGENT_EMBED_BRIDGE_VERSION, AGENT_EMBED_QUERY_PARAMS, AGENT_EVENT_NAMES, AgentAppearance, AgentClientActionRequestEvent, AgentEmbedAction, AgentEmbedAppearanceUpdate, AgentEmbedCallback, AgentEmbedCommandMessage, AgentEmbedFrameMessage, AgentEmbedHeaderAppearance, AgentEmbedHostMessage, AgentEmbedInitError, AgentEmbedInitMessage, AgentEmbedInputQuery, AgentEmbedInstance, AgentEmbedSendMessageInput, AgentEmbedTheme, AgentEmbedUpdateAppearanceMessage, AgentEmbedUrlInitConfig, AgentEvents, AgentRuntimeValue, AgentRuntimeVariables, AgentServerEvent, AgentSessionCancelled, AgentSessionContext, AgentSessionEventContext, AgentSessionFailure, AgentSessionRunEndedEvent, AgentSessionRunEventContext, AgentSessionRunIdledEvent, AgentSessionRunStartedEvent, AgentSessionSettlement, AgentSessionSuccess, AgentSessionTurnCancelledEvent, AgentSessionTurnFailedEvent, AgentSessionTurnStartedEvent, AgentSessionTurnSucceededEvent, AgentSystemMessageConsumedEvent, AgentTextPayload, AgentToolApprovalRequestedEvent, AgentToolCall, AgentToolCallBackgroundedEvent, AgentToolCallCancelledEvent, AgentToolCallCreatedEvent, AgentToolCallFailedEvent, AgentToolCallProgressUpdatedEvent, AgentToolCallReadyEvent, AgentToolCallStartedEvent, AgentToolCallSucceededEvent, AgentUserFeedbackConsumedEvent, AgentUserInputSubmittedEvent, AgentUserSteerCancelledEvent, AgentUserSteerConsumedEvent, isAgentEmbedFrameMessage, isAgentEmbedHostMessage, isAgentRuntimeVariables };

package/dist/index.mjs

@@ -22,15 +22,8 @@ const isAgentEmbedHostMessage = (value) => {
 	if (message.bridge !== "sophonsai/agent-component-bridge" || message.version !== 1 || typeof message.instanceId !== "string") return false;
 	if (message.type === "init") {
 		const config = message.config;
-		if (config?.mode === "url") return Boolean(config.appearance && typeof config.appearance === "object" && (config.threadId === void 0 || typeof config.threadId === "string") && (config.runtime_variables === void 0 || isAgentRuntimeVariables(config.runtime_variables)));
-		if (!config || typeof config.agentId !== "string") return false;
-		if (!config.auth) return typeof config.token === "string";
-		if (typeof config.auth !== "object") return false;
-		const auth = config.auth;
-		if (auth.type === "platform.user.credential") return typeof auth.credential === "string";
-		if (auth.type !== "extension.user.identity") return false;
-		const externalUser = auth.externalUser;
-		return Boolean(typeof auth.appId === "string" && externalUser && typeof externalUser === "object" && typeof externalUser.id === "string" && (externalUser.name === void 0 || typeof externalUser.name === "string"));
+		if (config?.mode === "url") return Boolean(config.appearance && typeof config.appearance === "object" && (config.threadId === void 0 || typeof config.threadId === "string") && (config.runtime_variables === void 0 || isAgentRuntimeVariables(config.runtime_variables)) && (config.client_tool_names === void 0 || Array.isArray(config.client_tool_names) && config.client_tool_names.every((name) => typeof name === "string" && name.length > 0)));
+		return false;
 	}
 	if (message.type === "update-appearance") {
 		const appearance = message.appearance;
@@ -84,9 +77,7 @@ const isAgentEmbedFrameMessage = (value) => {
 //#endregion
 //#region src/types.ts
 const AGENT_EMBED_QUERY_PARAMS = {
-	agentId: "agent_id",
 	threadId: "thread_id",
-	token: "token",
 	theme: "theme",
 	fontSize: "font_size",
 	headerHistoryButton: "header_history_button",
@@ -98,6 +89,7 @@ const AGENT_EVENT_NAMES = [
 	"onEvent",
 	"onSessionContextReady",
 	"onToolCallCreated",
+	"onToolCallReady",
 	"onToolApprovalRequested",
 	"onToolCallStarted",
 	"onToolCallProgressUpdated",
@@ -105,6 +97,7 @@ const AGENT_EVENT_NAMES = [
 	"onToolCallSucceeded",
 	"onToolCallFailed",
 	"onToolCallCancelled",
+	"onClientToolRequest",
 	"onClientActionRequest",
 	"onUserFeedbackConsumed",
 	"onUserSteerConsumed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sophonsai/agent-embed-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-independent types and protocol primitives for Sophon Agent Embed.",
   "type": "module",
   "keywords": [