Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
import { useCallback, useEffect, useRef, useState } from "react";
import { createLocalConversations } from "./local-conversation-fixtures.js";
import { localId as newLocalId } from "./local-id.js";
export const LOCAL_CONVERSATIONS_KEY = "agentflow.local-conversations.v1";
export const isLocalConversation = (id) => typeof id === "string" && id.startsWith("local-preview-");
const emptyLive = { answer: "", thinking: "", tools: [], activity: [] };
const timestamp = () => new Date().toISOString();
function localReply(text, title) {
if (/什么模型|哪个模型|什么AI|什么 AI|你是谁/i.test(text))
return "这是保存在浏览器里的本地示例会话。这里的回复由前端生成,方便体验完整的会话操作;新建对话会使用你实际选择的模型。";
if (/总结|汇总|清单|列出来/.test(text))
return `围绕「${title}」,可以把下一步整理成三项:\n\n1. 确认这次补充涉及的范围与目标\n2. 列出具体调整和需要确认的问题\n3. 检查完成标准,保留后续跟进记录\n\n你刚才的补充已保存在这条本地会话中。`;
if (/颜色|hover|动效|动画/.test(text))
return "可以继续按浅灰、深灰的层级统一交互:悬停用轻微的灰色扩散,选中保持固定浅灰底,图标播放自身动效。\n\n按钮本身保持位置稳定,鼠标移开后颜色自然收回。";
return `已记下这条补充。我们继续围绕「${title}」推进:\n\n- 先确认这次调整的具体目标\n- 保留现有流程,列出需要修改的细节\n- 用清晰的验收项检查结果\n\n你可以继续补充要求,或把希望优先处理的部分告诉我。`;
}
/** Use the normal conversation UI with browser-local fixtures when the server is empty.
* Local IDs are intercepted here and never enter useChat, its URL or its API calls.
*/
export function useLocalConversations(real) {
const key = real.user ? `${LOCAL_CONVERSATIONS_KEY}.${real.user.id}` : "";
const [store, setStore] = useState({ key: "", sessions: [] });
const storeRef = useRef(store);
const [localId, setLocalId] = useState(null);
const [localRevealId, setLocalRevealId] = useState(null);
const localIdRef = useRef(localId);
// The ready handshake repeats the host project. Track that context separately
// from a local conversation's project binding so reload can restore selection.
const hostProjectRef = useRef(real.projectId || "");
const [error, setLocalError] = useState("");
const [generations, setGenerations] = useState({});
const generationsRef = useRef(generations);
const timers = useRef(new Map());
const previewEnabled = new URLSearchParams(location.search).get("localPreview") === "1";
const available = previewEnabled && real.ready && !real.activeId && !real.sessions.length;
const availableRef = useRef(available);
availableRef.current = available;
localIdRef.current = localId;
generationsRef.current = generations;
const selectLocal = useCallback((id) => {
localIdRef.current = id;
setLocalId(id);
setLocalError("");
try {
const selectionKey = `${storeRef.current.key}.selected`;
if (id) sessionStorage.setItem(selectionKey, id);
else sessionStorage.removeItem(selectionKey);
} catch {}
}, []);
const save = useCallback((change) => {
const current = storeRef.current;
const sessions = change(current.sessions);
const next = { ...current, sessions };
storeRef.current = next;
setStore(next);
try {
if (next.key) localStorage.setItem(next.key, JSON.stringify(sessions));
} catch {
setLocalError("浏览器存储空间不足,当前内容仍保留在页面中;移除较大的附件后可以继续保存。");
}
return sessions;
}, []);
useEffect(() => {
if (!real.ready || !real.user || !key || storeRef.current.key === key) return;
timers.current.forEach((timer) => clearTimeout(timer));
timers.current.clear();
generationsRef.current = {};
setGenerations({});
let sessions;
try {
const saved = JSON.parse(localStorage.getItem(key));
if (Array.isArray(saved) && saved.every((row) => isLocalConversation(row?.id) && Array.isArray(row.messages))) sessions = saved;
} catch {}
sessions ||= previewEnabled ? createLocalConversations(real.user, real.model) : [];
// Browser-local replies run in this page. A persisted running row has no
// surviving timer after reload, so it must not keep advertising activity.
sessions = sessions.map((row) => row.generationStatus === "running"
? { ...row, generationStatus: "interrupted" } : row);
const next = { key, sessions };
storeRef.current = next;
setStore(next);
setLocalId(null);
try {
localStorage.setItem(key, JSON.stringify(sessions));
} catch {
setLocalError("浏览器存储空间不足,当前内容仍保留在页面中;移除较大的附件后可以继续保存。");
}
if (available) {
try {
const selected = sessionStorage.getItem(`${key}.selected`);
if (sessions.some((row) => row.id === selected && !row.archived)) {
selectLocal(selected);
setLocalRevealId(selected);
}
} catch {}
}
}, [real.ready, real.user?.id, key, real.model, available, previewEnabled, selectLocal]);
useEffect(() => {
if (!available) selectLocal(null);
}, [available, selectLocal]);
useEffect(() => {
const onContext = (event) => {
if (event.origin !== location.origin || event.source !== window.parent || event.data?.type !== "agentflow-project-context") return;
const projectId = event.data.projectId || "";
if (projectId === hostProjectRef.current) return;
hostProjectRef.current = projectId;
selectLocal(null);
};
window.addEventListener("message", onContext);
return () => window.removeEventListener("message", onContext);
}, [selectLocal]);
useEffect(() => () => {
timers.current.forEach((timer) => clearTimeout(timer));
}, []);
const rows = store.key === key ? store.sessions : [];
const session = available ? rows.find((row) => row.id === localId) : null;
const local = !!session;
const selected = () => availableRef.current && storeRef.current.sessions.find((row) => row.id === localIdRef.current);
const setGeneration = (id, value) => {
const next = { ...generationsRef.current, [id]: value };
generationsRef.current = next;
setGenerations(next);
};
const update = (id, change) => {
let result = null;
save((sessions) => sessions.map((row) => {
if (row.id !== id) return row;
result = { ...change(row), updatedAt: timestamp() };
return result;
}));
return result;
};
const complete = (stored, text) => {
const id = stored.id;
const running = generationsRef.current[id];
if (running?.status === "running") {
setLocalError("当前回复仍在生成,可以先停止再发送。");
return false;
}
const startedAt = timestamp();
const response = localReply(text, stored.title);
const generation = { id: `${id}-${Date.now()}`, status: "running", startedAt, updatedAt: startedAt };
setGeneration(id, generation);
update(id, (row) => ({ ...row, generationStatus: "running" }));
const timer = setTimeout(() => {
timers.current.delete(id);
const finishedAt = timestamp();
const activity = [{ kind: "status", text: "整理当前会话", at: startedAt }];
update(id, (row) => ({ ...row, generationStatus: "completed", messages: [...row.messages, { role: "assistant", content: response, createdAt: finishedAt, startedAt, activity }] }));
setGeneration(id, { ...generation, status: "completed", updatedAt: finishedAt });
}, 650);
timers.current.set(id, timer);
return true;
};
const open = useCallback((id) => {
if (isLocalConversation(id)) {
if (availableRef.current && storeRef.current.sessions.some((row) => row.id === id)) {
selectLocal(id);
setLocalRevealId(id);
}
return;
}
selectLocal(null);
return real.open(id);
}, [real.open, selectLocal]);
const newChat = useCallback(() => {
selectLocal(null);
return real.newChat();
}, [real.newChat, selectLocal]);
return {
...real,
local,
localSessions: available && store.key === key,
sessions: available && store.key === key ? rows : real.sessions,
...(local ? {
activeId: session.id,
revealId: localRevealId,
session,
projectId: session.projectId || "",
issueId: session.issueId || "",
model: session.model || real.model,
generation: generations[session.id] || null,
live: emptyLive,
busy: generations[session.id]?.status === "running",
queue: [],
queueHeld: false,
submitting: false,
readOnly: false,
error,
} : {}),
open,
newChat,
startProjectDraft(id) {
selectLocal(null);
return real.startProjectDraft(id);
},
setError(value) {
if (selected()) setLocalError(value);
else real.setError(value);
},
setModel(value) {
const current = selected();
if (current) update(current.id, (row) => ({ ...row, model: value }));
else if (!isLocalConversation(localIdRef.current)) real.setModel(value);
},
setSession(value) {
const current = selected();
if (current) update(current.id, (row) => typeof value === "function" ? value(row) : { ...value, id: row.id, local: true });
else if (!isLocalConversation(localIdRef.current) && !isLocalConversation(value?.id)) real.setSession(value);
},
async send(options) {
const current = selected();
if (!current) return isLocalConversation(localIdRef.current) ? false : real.send(options);
if (!options.text.trim() && !options.attachments?.length) return false;
if (generationsRef.current[current.id]?.status === "running") {
setLocalError("当前回复仍在生成,可以先停止再发送。");
return false;
}
setLocalError("");
const message = { role: "user", content: options.text.trim() || "请阅读本轮附件并回答。", authorId: real.user?.id, authorName: real.user?.chineseName || real.user?.loginName, createdAt: timestamp(), ...(options.attachments?.length ? { attachments: options.attachments } : {}), ...(options.references?.length ? { references: options.references } : {}) };
const stored = update(current.id, (row) => ({ ...row, messages: [...(options.messagesOverride || row.messages), message] }));
return complete(stored, message.content);
},
async stop() {
const current = selected();
if (!current) return isLocalConversation(localIdRef.current) ? false : real.stop();
clearTimeout(timers.current.get(current.id));
timers.current.delete(current.id);
const generation = generationsRef.current[current.id];
setGeneration(current.id, { ...generation, status: "cancelled", updatedAt: timestamp() });
update(current.id, (row) => ({ ...row, generationStatus: "cancelled" }));
setLocalError("");
},
async rename(id, title) {
if (!isLocalConversation(id)) return real.rename(id, title);
if (!title.trim()) return false;
return !!update(id, (row) => ({ ...row, title: title.trim() }));
},
async archive(id, archived) {
if (!isLocalConversation(id)) return real.archive(id, archived);
update(id, (row) => ({ ...row, archived }));
if (localIdRef.current === id) selectLocal(null);
},
async remove(id) {
if (!isLocalConversation(id)) return real.remove(id);
clearTimeout(timers.current.get(id));
timers.current.delete(id);
save((sessions) => sessions.filter((row) => row.id !== id));
if (localIdRef.current === id) selectLocal(null);
},
async edit(index, content, fork = false) {
const current = selected();
if (!current) return isLocalConversation(localIdRef.current) ? null : real.edit(index, content, fork);
if (!current.messages[index] || !content.trim()) return null;
const messages = current.messages.slice(0, index + 1).map((message, messageIndex) => messageIndex === index ? { ...message, content: content.trim() } : message);
if (!fork) return update(current.id, (row) => ({ ...row, messages, generationStatus: "completed" }));
const id = newLocalId("local-preview");
const forked = { ...current, id, title: `${current.title}(分支)`, messages, generationStatus: "completed", createdAt: timestamp(), updatedAt: timestamp() };
save((sessions) => [forked, ...sessions]);
selectLocal(id);
return forked;
},
async regenerate(stored, approvalMode) {
if (!isLocalConversation(stored?.id)) return real.regenerate(stored, approvalMode);
selectLocal(stored.id);
return complete(stored, [...stored.messages].reverse().find((message) => message.role === "user")?.content || stored.title);
},
async selectProject(id, options) {
const current = selected();
if (!current) return isLocalConversation(localIdRef.current) ? false : real.selectProject(id, options);
update(current.id, (row) => ({ ...row, projectId: id, issueId: "" }));
return true;
},
async linkIssue(id) {
const current = selected();
if (!current) return isLocalConversation(localIdRef.current) ? false : real.linkIssue(id);
update(current.id, (row) => ({ ...row, issueId: id }));
return true;
},
async applyDraft(...args) {
if (!selected() && !isLocalConversation(localIdRef.current)) return real.applyDraft(...args);
throw Error("当前本地会话中没有待保存的配置草稿。");
},
async refresh() {
if (!selected()) return real.refresh();
},
};
}