Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@
| UI 组件 `@openagentpack/kit-chat-ui` | Chat、Message、Sender、Attachments、FileCard、ToolApprovalCard 等 | 组合对话、输入、附件、文件和审批界面;支持将组件及声明依赖复制到业务项目中修改 |
| 会话运行时 `@openagentpack/kit-sdk` 的功能入口 | 流解析、请求、后端适配、消息状态、重连与会话动作 | 接入既有后端,管理流式数据与会话交互;非 React 应用可直接订阅会话状态 |
| React hooks `@openagentpack/kit-sdk/<功能>/hooks` | `useChat`、`useSessions`、`useAgentCatalog` 等 | 将连接、消息、发送、停止与审批绑定到 React 页面 |
| 开发 Skill | `kit-components`、`use-kit-chat`、`kit-chat-provider` | 指导 coding agent 选组件、组合交互并适配后端,配有 API 参考与可编译示例 |
| 开发 Skill | `kit-components`、`use-kit-chat`、`kit-chat-provider` | 指导 coding agent 选组件、组合交互并适配后端。离线包可将组件和 Kit SDK 源码复制到业务项目 |

SDK 按功能导入,例如 `@openagentpack/kit-sdk/chat`、`@openagentpack/kit-sdk/chat/hooks`
与 `@openagentpack/kit-sdk/sessions/hooks`,不提供根聚合入口。
Expand Down Expand Up @@ -298,7 +298,6 @@ pnpm gate # typecheck + lint + test + build + 架构检查 + 文档检查
pnpm verify:push # pre-push hook 跑的就是这套
```

提交信息使用简体中文 Conventional Commits,例如 `fix(server): 修复会话恢复`。
Issue 与反馈:https://github.com/modelstudioai/OpenAgentPack-Kit/issues

## License
Expand Down
10 changes: 10 additions & 0 deletions apps/storybook/app/docs/components/express/sender/page.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
const senderDocsPath = "/docs/components/chat/sender/";

export default function SenderDocsRedirect() {
return (
<main className="p-6">
<meta httpEquiv="refresh" content={`0;url=${senderDocsPath}`} />
<a href={senderDocsPath}>打开 Sender 输入框文档</a>
</main>
);
}
36 changes: 1 addition & 35 deletions apps/storybook/components/demos/chrome-demo.tsx
Original file line number Diff line number Diff line change
@@ -1,28 +1,6 @@
"use client";

import { EmptyState, ErrorState, StatusIndicator, ThreadPanel } from "@openagentpack/kit-chat-ui";
import type { ChatMessage } from "@openagentpack/kit-sdk/messages";

const THREADS: Record<string, ChatMessage[]> = {
th_subagent_billing: [
{
id: "t1",
role: "user",
parts: [{ type: "text", text: "查一下这个月的发票状态" }],
status: "done",
createdAt: "2026-11-09T02:00:00Z",
threadId: "th_subagent_billing",
},
{
id: "t2",
role: "assistant",
parts: [{ type: "text", text: "已提交,预计 2 个工作日内开出。" }],
status: "done",
createdAt: "2026-11-09T02:00:04Z",
threadId: "th_subagent_billing",
},
],
};
import { EmptyState, ErrorState, StatusIndicator } from "@openagentpack/kit-chat-ui";

/** 状态由连接状态和 Turn 阶段共同决定。 */
export function StatusDemo() {
Expand All @@ -47,18 +25,6 @@ export function StatusDemo() {
);
}

/** 兼容旧的 threads 分组;新接入使用 Chat.multiAgent。 */
export function ThreadDemo() {
return (
<div className="flex flex-1 flex-col gap-3 p-4">
<p className="text-[length:var(--kit-text-caption)] text-[var(--kit-fg-muted)]">
兼容旧版 ThreadPanel;原生主子 Agent 交互请查看 Chat 的 multiAgent 预览。
</p>
<ThreadPanel threads={THREADS} />
</div>
);
}

/** 空态与错误态:目录为空、请求失败时的两种占位。 */
export function StatesDemo() {
return (
Expand Down
94 changes: 66 additions & 28 deletions apps/storybook/components/demos/general-demo.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
import {
AgentHeader,
EmptyState,
Layout,
Menu,
MenuContent,
MenuItem,
Expand All @@ -16,7 +17,7 @@ import {
import type { ChatAgentThread, ChatMultiAgent } from "@openagentpack/kit-sdk/chat";
import type { ChatMessage } from "@openagentpack/kit-sdk/messages";
import type { SessionSummary } from "@openagentpack/kit-sdk/protocol";
import { useRef, useState } from "react";
import { type ReactNode, useRef, useState } from "react";
import { LogoMark, MessageSquare, SignalBars } from "../icons.tsx";
import { AGENT, AGENTS, SESSIONS } from "./layout-demo.tsx";
import { MESSAGES } from "./message-demo.tsx";
Expand Down Expand Up @@ -495,7 +496,7 @@ export function AgentHeaderActionsDemo() {
);
}

/** 演示线程基座:loaded 即无加载态,mock 的 loadThreadEvents 保持空实现,时间线直接展示 messages。 */
/** 演示线程默认已加载,历史预览可覆盖初始状态。 */
function panelThread(id: string, overrides: Partial<ChatAgentThread>): ChatAgentThread {
return {
id,
Expand Down Expand Up @@ -560,28 +561,66 @@ const SUB_AGENT_MULTI: ChatMultiAgent = {
loadThreadEvents: async () => undefined,
};

/** 分区概览:research 按展示名分组计数,行内区分运行中/完成/失败;勾选后线程清空,分区整体不渲染。 */
export function SubAgentPanelDemo() {
const [empty, setEmpty] = useState(false);
function SubAgentResourcePreview({ multiAgent, children }: { multiAgent: ChatMultiAgent; children?: ReactNode }) {
const [asideOpen, setAsideOpen] = useState(true);
return (
<div
<Layout
data-kit-appearance="workspace"
className="flex min-w-0 flex-1 flex-col bg-[var(--kit-bg)] text-[var(--kit-fg)]"
className="flex-1"
header={() => (
<AgentHeader
agent={AGENT}
compact
actions={
<button
type="button"
className={CONTROL_CLASS}
aria-label={asideOpen ? "收起资源面板" : "展开资源面板"}
aria-pressed={asideOpen}
onClick={() => setAsideOpen((open) => !open)}
>
资源
</button>
}
/>
)}
asideOpen={asideOpen}
onAsideOpenChange={setAsideOpen}
aside={({ closeButton }) => (
<div className="flex min-h-0 flex-1 flex-col">
{closeButton ? (
<div className="flex min-h-14 shrink-0 items-center gap-2 border-b border-[var(--kit-border-subtle)] px-4">
<span className="min-w-0 flex-1 text-[length:var(--kit-text-label)] font-medium">资源</span>
{closeButton}
</div>
) : null}
<div className="min-h-0 flex-1 overflow-y-auto px-4 py-4 md:py-5">
<SubAgentPanel multiAgent={multiAgent} />
</div>
</div>
)}
>
{children}
</Layout>
);
}

/** 分区概览:research 按展示名分组计数,清空线程后分区整体不渲染。 */
export function SubAgentPanelDemo() {
const [empty, setEmpty] = useState(false);
return (
<SubAgentResourcePreview multiAgent={empty ? { ...SUB_AGENT_MULTI, threads: [] } : SUB_AGENT_MULTI}>
<div className={TOOLBAR_CLASS}>
<label className="flex items-center gap-2">
<input type="checkbox" checked={empty} onChange={(event) => setEmpty(event.target.checked)} />
清空线程(观察空态)
清空线程
</label>
</div>
<div className="mx-auto flex w-80 min-h-0 flex-1 flex-col border-l border-[var(--kit-border-subtle)] px-4 py-4">
<SubAgentPanel multiAgent={empty ? { ...SUB_AGENT_MULTI, threads: [] } : SUB_AGENT_MULTI} />
</div>
</div>
</SubAgentResourcePreview>
);
}

/** 翻页演示:mock 400ms 拉取更早事件后清除 nextPageToken;期间按钮禁用并显示加载文案。 */
/** 历史分页示例中追加到前面的较早事件。 */
const SUB_AGENT_OLDER_MESSAGES: ChatMessage[] = [
{
id: "sub-agent-demo-0",
Expand All @@ -605,8 +644,7 @@ const SUB_AGENT_HISTORY_THREADS: ChatAgentThread[] = [
task: "对比三家云厂商的 API 定价与配额,输出对比表",
createdAt: "2026-11-10T01:30:00.000Z",
endedAt: "2026-11-10T01:30:48.000Z",
messages: SUB_AGENT_MESSAGES,
nextPageToken: "page-2",
loaded: false,
}),
panelThread("sthr-slide", {
name: "slide-maker",
Expand All @@ -615,6 +653,14 @@ const SUB_AGENT_HISTORY_THREADS: ChatAgentThread[] = [
createdAt: "2026-11-10T02:00:00.000Z",
endedAt: "2026-11-10T02:00:31.000Z",
historyAvailable: false,
messages: [
{
id: "sub-agent-slide-demo",
role: "assistant",
status: "done",
parts: [{ type: "text", id: "sub-agent-slide-demo:text", text: "已整理季度汇报的结构与逐页标题。" }],
},
],
}),
];

Expand All @@ -629,7 +675,7 @@ export function SubAgentPanelHistoryDemo() {
selectThread: () => undefined,
refreshThreads: async () => undefined,
loadThreadEvents: async (id, options) => {
if (!options?.more) return;
const more = options?.more === true;
setThreads((current) => current.map((thread) => (thread.id === id ? { ...thread, loading: true } : thread)));
await new Promise((resolve) => setTimeout(resolve, 400));
setThreads((current) =>
Expand All @@ -638,22 +684,14 @@ export function SubAgentPanelHistoryDemo() {
? {
...thread,
loading: false,
nextPageToken: null,
messages: [...SUB_AGENT_OLDER_MESSAGES, ...thread.messages],
loaded: true,
nextPageToken: more ? null : "page-2",
messages: more ? [...SUB_AGENT_OLDER_MESSAGES, ...thread.messages] : SUB_AGENT_MESSAGES,
}
: thread,
),
);
},
};
return (
<div
data-kit-appearance="workspace"
className="flex min-w-0 flex-1 flex-col bg-[var(--kit-bg)] text-[var(--kit-fg)]"
>
<div className="mx-auto flex w-80 min-h-0 flex-1 flex-col border-l border-[var(--kit-border-subtle)] px-4 py-4">
<SubAgentPanel multiAgent={multiAgent} />
</div>
</div>
);
return <SubAgentResourcePreview multiAgent={multiAgent} />;
}
Loading