@sepveneto/dnde-agent 0.1.16 → 0.2.0-beta.1

package/README.md

@@ -0,0 +1,77 @@
+# `@sepveneto/dnde-agent`
+
+装修助手以一个独立自定义元素接入编辑器。Agent 实现来自
+`llm-agent`：Agents SDK 负责 Agent Loop、工具调用、流式输出和会话历史；
+本包只保留 Web Component 外壳、宿主 API 协议和业务工具适配。
+
+## 接入
+
+宿主提供编辑器 API、业务工具和运行时上下文：
+
+```vue
+<dnd-agent
+  :api="agentApi"
+  :tools="businessTools"
+  :context="getContext"
+></dnd-agent>
+```
+
+直接导入元素入口会自动注册 `<dnd-agent>`：
+
+```ts
+import '@sepveneto/dnde-agent/element'
+```
+
+也可以由编辑器在 `register({ agent })` 中按需注入：
+
+```ts
+register({
+  remoteUrl,
+  agent: () => import('@sepveneto/dnde-agent/element'),
+})
+```
+
+## 宿主 API
+
+```ts
+interface AgentHostApi {
+  model?: {
+    baseURL?: string
+    model?: string
+    apiMode?: 'responses' | 'chat_completions'
+  }
+  editor?: {
+    getCurrentEditor(): unknown | Promise<unknown>
+    getWidgets(): unknown | Promise<unknown>
+    operateEditor(operation: AgentEditorOperation): unknown | Promise<unknown>
+  }
+}
+```
+
+默认带三个基于编辑器 API 的工具：`get_current_editor`、`get_widgets`、
+`editor_operator`。写操作和历史不可逆操作应先取得用户确认。
+
+## 业务工具
+
+```ts
+import { defineAgentTool } from '@sepveneto/dnde-agent'
+import { z } from 'zod'
+
+const queryOrder = defineAgentTool({
+  name: 'query_order',
+  description: '查询订单状态',
+  parameters: z.object({ id: z.string() }),
+  async execute({ id }, context) {
+    return fetch(`/api/orders/${id}`).then(response => response.json())
+  },
+})
+```
+
+工具的 `execute` 在浏览器内运行，并可读取宿主通过 `context` 注入的只读上下文。
+模型请求走兼容 OpenAI 的宿主代理/BFF，浏览器侧不保存真实密钥。
+
+## UI
+
+UI 保留原装修助手的悬浮按钮交互。展开后使用 `llm-agent` 的聊天视图：
+空状态示例、Markdown、reasoning、工具调用、数据事件、流式文本、停止生成和历史记录，
+全部位于 `dnd-agent` 的 Shadow DOM 内。

package/dist/{agent-JES391Lz.js → agent-BP3wmmgT.js}

@@ -1,7 +1,7 @@
 var V = Object.defineProperty;
 var Q = (t, s, e) => s in t ? V(t, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[s] = e;
 var a = (t, s, e) => Q(t, typeof s != "symbol" ? s + "" : s, e);
-import { C as E, U as x, r as X, t as I, o as v, s as y, a as Z, w as A, i as q, e as ee, A as te, n as k, b as R, p as C, c as se, S as ie, d as ne, M as re, f as ae } from "./index-gtAUVnBf.js";
+import { C as E, U as x, r as X, t as I, o as v, s as y, a as Z, w as A, i as q, e as ee, A as te, n as k, b as R, p as C, c as se, S as ie, d as ne, M as re, f as ae } from "./index-B_cPI3XS.js";
 function oe(t) {
   return t ? !(typeof t == "object" && t && "constructor" in t && typeof t.constructor == "function" ? t.constructor.name : "").includes("ChatCompletions") : !0;
 }

package/dist/agents.d.ts

@@ -0,0 +1,19 @@
+import type { AgentToolDefinition } from './tool';
+import type { AgentHostApi } from './types';
+import { Agent } from '@openai/agents';
+export declare const DEFAULT_AGENT_MODEL = "qwen3.6-flash";
+export declare const DEFAULT_AGENT_BFF_URL = "http://localhost:4000/v1";
+export interface CreateAgentsOptions {
+    model?: string;
+    api: AgentHostApi;
+    tools?: AgentToolDefinition[];
+    getContext?: () => Record<string, unknown>;
+}
+/**
+ * llm-agent 的 Agent 定义已迁移到这里。业务工具通过 options.tools 注入，
+ * 编辑器能力通过 options.api 注入，Agent 本身不持有宿主状态。
+ */
+export declare function createAgents(options: CreateAgentsOptions): {
+    agent: Agent<any, "text">;
+};
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAQ,MAAM,gBAAgB,CAAA;AAG5C,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAClD,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAE/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AA4JD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;EA2BxD"}