hermes-agent-web-chat 0.1.0

package/dist/types/api.d.ts

@@ -0,0 +1,28 @@
+import type { AttachedFile, HermesConfig, StreamEvent } from './types';
+/** 通用请求：返回状态码与原始文本，供 API 调试台使用 */
+export declare function apiRequest(cfg: HermesConfig, method: string, subPath: string, body?: unknown, signal?: AbortSignal): Promise<{
+    status: number;
+    statusText: string;
+    headers: Headers;
+    text: string;
+}>;
+/** 流式 SSE 请求：逐行回调，供 /v1/responses、/v1/runs/{id}/events 等端点使用 */
+export declare function apiStream(cfg: HermesConfig, method: string, subPath: string, body: unknown | undefined, onLine: (line: string) => void, signal?: AbortSignal): Promise<{
+    status: number;
+    statusText: string;
+}>;
+/** 健康检查（探活） */
+export declare function healthProbe(cfg: HermesConfig): Promise<boolean>;
+/** 删除服务端存储的响应（清理会话时使用） */
+export declare function deleteResponse(cfg: HermesConfig, responseId: string): Promise<void>;
+interface SendParams {
+    cfg: HermesConfig;
+    input: string;
+    conversation?: string;
+    instructions?: string;
+    files?: AttachedFile[];
+    signal?: AbortSignal;
+    onEvent: (ev: StreamEvent) => void;
+}
+export declare function streamResponse(p: SendParams): Promise<void>;
+export {};

package/dist/types/components/ApiExplorer.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/components/ChatInput.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/components/ChatView.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/components/HermesChat.vue.d.ts

@@ -0,0 +1,8 @@
+import type { HermesChatProps } from '../types';
+declare const _default: import("vue").DefineComponent<HermesChatProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HermesChatProps> & Readonly<{}>, {
+    model: string;
+    title: string;
+    storageKey: string;
+    defaultView: "chat" | "api";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/Markdown.vue.d.ts

@@ -0,0 +1,5 @@
+type __VLS_Props = {
+    text: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/MessageItem.vue.d.ts

@@ -0,0 +1,6 @@
+import type { ChatMessage } from '../types';
+type __VLS_Props = {
+    message: ChatMessage;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/ProcessPanel.vue.d.ts

@@ -0,0 +1,8 @@
+import type { ProcessStep } from '../types';
+type __VLS_Props = {
+    steps: ProcessStep[];
+    reasoning: string;
+    streaming: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/Sidebar.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vue';
+import HermesChat from './components/HermesChat.vue';
+
+export { HermesChat };
+export { createHermesStore } from './store';
+export type { HermesStore, HermesStoreOptions } from './store';
+export { useHermes, HermesKey } from './inject';
+export type { HermesChatProps, HermesConfig, Conversation, ChatMessage, UserMessage, AssistantMessage, AttachedFile, FileMeta, StreamEvent, } from './types';
+declare const HermesChatPlugin: Plugin;
+export default HermesChatPlugin;

package/dist/types/inject.d.ts

@@ -0,0 +1,5 @@
+import { type InjectionKey } from 'vue';
+import type { HermesStore } from './store';
+export declare const HermesKey: InjectionKey<HermesStore>;
+/** 在 <HermesChat> 子组件中获取 store */
+export declare function useHermes(): HermesStore;

package/dist/types/store.d.ts

@@ -0,0 +1,37 @@
+import { type ComputedRef } from 'vue';
+import type { AttachedFile, Conversation, HermesConfig } from './types';
+type HealthState = 'unknown' | 'online' | 'offline' | 'checking';
+interface State {
+    conversations: Conversation[];
+    currentConversationId: string;
+    streaming: boolean;
+    error: string;
+    systemInstructions: string;
+    health: HealthState;
+    ready: boolean;
+}
+export interface HermesStoreOptions {
+    baseUrl: string;
+    token?: string;
+    model?: string;
+    instructions?: string;
+    storageKey?: string;
+    uploadHandler?: (file: File) => Promise<string>;
+}
+export interface HermesStore {
+    config: HermesConfig;
+    state: State;
+    currentConversation: ComputedRef<Conversation | undefined>;
+    uploadHandler?: (file: File) => Promise<string>;
+    init(): Promise<void>;
+    checkHealth(): Promise<void>;
+    newConversation(): void;
+    deleteConversation(id: string): void;
+    selectConversation(id: string): void;
+    setSystemInstructions(v: string): void;
+    sendMessage(text: string, files?: AttachedFile[]): Promise<void>;
+    stopStreaming(): void;
+    updateConfig(opts: Partial<HermesStoreOptions>): void;
+}
+export declare function createHermesStore(opts: HermesStoreOptions): HermesStore;
+export {};

package/dist/types/types.d.ts

@@ -0,0 +1,110 @@
+/** Hermes 后端连接配置（组件内部使用） */
+export interface HermesConfig {
+    baseUrl: string;
+    token?: string;
+    model: string;
+}
+/** <HermesChat> 组件 props */
+export interface HermesChatProps {
+    /** Hermes 后端地址，例如 http://localhost:8642 */
+    baseUrl: string;
+    /** 可选 Bearer token；为空则不附加 Authorization 头 */
+    token?: string;
+    /** 模型名（仅展示用），默认 hermes-agent */
+    model?: string;
+    /** 初始系统指令（用户仍可在面板内修改） */
+    instructions?: string;
+    /** 顶部品牌标题，默认 Hermes Agent */
+    title?: string;
+    /** localStorage 命名空间，默认 default；多实例隔离用不同 key */
+    storageKey?: string;
+    /** 自定义文件上传：返回公开 URL；不提供则图片走 data URL、文本内联、二进制拒绝 */
+    uploadHandler?: (file: File) => Promise<string>;
+    /** 初始视图，默认 chat */
+    defaultView?: 'chat' | 'api';
+}
+export interface AttachedFile {
+    name: string;
+    type: string;
+    size: number;
+    kind: 'image' | 'text' | 'binary';
+    url?: string;
+    dataUrl?: string;
+    text?: string;
+    uploading?: boolean;
+    uploadError?: string;
+}
+export interface FileMeta {
+    name: string;
+    type: string;
+    size: number;
+    kind: 'image' | 'text' | 'binary';
+    url?: string;
+    dataUrl?: string;
+    text?: string;
+}
+export type StepKind = 'tool_call' | 'tool_result' | 'reasoning';
+export interface ProcessStep {
+    kind: StepKind;
+    callId?: string;
+    name?: string;
+    arguments?: string;
+    output?: string;
+    status?: 'running' | 'done';
+    text?: string;
+}
+export interface UserMessage {
+    id: string;
+    role: 'user';
+    content: string;
+    files?: FileMeta[];
+}
+export interface AssistantMessage {
+    id: string;
+    role: 'assistant';
+    text: string;
+    reasoning: string;
+    steps: ProcessStep[];
+    status: 'streaming' | 'done' | 'error' | 'aborted';
+    usage: Record<string, unknown> | null;
+    error: string | null;
+    responseId: string | null;
+}
+export type ChatMessage = UserMessage | AssistantMessage;
+export interface Conversation {
+    id: string;
+    title: string;
+    createdAt: number;
+    updatedAt: number;
+    messages: ChatMessage[];
+}
+export type StreamEvent = {
+    kind: 'created';
+    responseId?: string;
+} | {
+    kind: 'text_delta';
+    delta: string;
+} | {
+    kind: 'reasoning';
+    delta: string;
+} | {
+    kind: 'tool_call';
+    callId: string;
+    name: string;
+    arguments: string;
+} | {
+    kind: 'tool_result';
+    callId: string;
+    output: string;
+} | {
+    kind: 'completed';
+    responseId?: string;
+    usage?: Record<string, unknown>;
+} | {
+    kind: 'error';
+    message: string;
+} | {
+    kind: 'other';
+    type: string;
+    raw: unknown;
+};

package/dist/types/utils.d.ts

@@ -0,0 +1,14 @@
+import type { AttachedFile } from './types';
+export declare function classifyFile(file: File): AttachedFile;
+export declare function readFileAsDataUrl(file: File): Promise<string>;
+export declare function readFileAsText(file: File): Promise<string>;
+export declare function formatSize(n: number): string;
+export declare function formatTime(ts: number): string;
+export declare function toolLabel(name?: string): string;
+export declare function tryPrettyJson(s: string): string;
+/** 归一化 usage 对象为 {input, output, total}，兼容 Responses / Chat Completions 字段名 */
+export declare function normalizeUsage(u: Record<string, unknown> | null | undefined): {
+    input: number;
+    output: number;
+    total: number;
+} | null;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "hermes-agent-web-chat",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Vue 3 组件包：接入 Hermes 适配智能体的对话界面与 HTTP API 调试台",
+  "keywords": ["vue", "vue3", "hermes", "agent", "chat", "component"],
+  "license": "MIT",
+  "main": "./dist/hermes-agent-web-chat.umd.cjs",
+  "module": "./dist/hermes-agent-web-chat.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/hermes-agent-web-chat.js",
+      "require": "./dist/hermes-agent-web-chat.umd.cjs"
+    },
+    "./style.css": "./dist/hermes-agent-web-chat.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": ["**/*.css"],
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc -b && vite build && vue-tsc -p tsconfig.build.json && node scripts/strip-css-imports.mjs",
+    "preview": "vite preview",
+    "typecheck": "vue-tsc -b",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.12.12",
+    "@vitejs/plugin-vue": "^5.0.4",
+    "dompurify": "^3.1.5",
+    "highlight.js": "^11.9.0",
+    "marked": "^12.0.2",
+    "typescript": "^5.4.5",
+    "vite": "^5.2.11",
+    "vue": "^3.4.27",
+    "vue-tsc": "^2.0.19"
+  }
+}