agentshire 1.0.0

package/src/plugin/session-log-watcher.ts

@@ -0,0 +1,221 @@
+import { openSync, closeSync, fstatSync, readSync, existsSync, statSync, readFileSync } from "node:fs";
+import type { AgentEvent } from "../contracts/events.js";
+
+const POLL_MS = 300;
+const MAX_BASE64_SIZE = 10 * 1024 * 1024;
+
+type EmitFn = (events: AgentEvent[]) => void;
+
+interface ContentBlock {
+  type: string;
+  text?: string;
+  thinking?: string;
+  name?: string;
+  id?: string;
+  arguments?: Record<string, unknown>;
+}
+
+function detectMediaKind(ext: string): string {
+  if (["png", "jpg", "jpeg", "gif", "webp", "svg", "bmp"].includes(ext)) return "image";
+  if (["mp4", "webm", "mov", "avi", "mkv"].includes(ext)) return "video";
+  if (["mp3", "wav", "ogg", "m4a", "flac"].includes(ext)) return "audio";
+  return "file";
+}
+
+function tryReadBase64(filePath: string): string | undefined {
+  try {
+    if (!filePath || !existsSync(filePath)) return undefined;
+    if (statSync(filePath).size > MAX_BASE64_SIZE) return undefined;
+    return readFileSync(filePath).toString("base64");
+  } catch { return undefined; }
+}
+
+function extractMediaFromResult(toolName: string, args: Record<string, unknown>, result: string): string | null {
+  if (toolName === "image" || toolName === "screencapture") {
+    const m = result.match(/\/[^\s"']+\.(?:png|jpg|jpeg|gif|webp)/i);
+    return m ? m[0] : (args.path ?? args.output_path) as string | null;
+  }
+  if ((toolName === "exec" || toolName === "bash") && /screencapture|screenshot/i.test(String(args.command ?? ""))) {
+    const m = String(args.command ?? "").match(/[\w/.-]+\.(?:png|jpg|jpeg|gif)/i);
+    if (m) return m[0];
+  }
+  const mm = result.match(/\/[^\s"']+\.(?:png|jpg|jpeg|gif|webp|mp4|webm|mov|mp3|wav)/i);
+  return (mm && /(?:wrote|saved|created|generated|output)/i.test(result)) ? mm[0] : null;
+}
+
+export class SessionLogWatcher {
+  private filePath: string;
+  private agentId: string;
+  private emit: EmitFn;
+  private onSessionEnd?: (reason: string) => void;
+  private offset = 0;
+  private timer: ReturnType<typeof setInterval> | null = null;
+  private stopped = false;
+  private pendingToolCalls = new Map<string, { name: string; args: Record<string, unknown> }>();
+  private partial = "";
+  private lastEventTime = 0;
+  private idleEmitted = false;
+  private lastFinalStopReason: string | null = null;
+  private sessionEndTimer: ReturnType<typeof setTimeout> | null = null;
+
+  constructor(filePath: string, agentId: string, emit: EmitFn, onSessionEnd?: (reason: string) => void) {
+    this.filePath = filePath;
+    this.agentId = agentId;
+    this.emit = emit;
+    this.onSessionEnd = onSessionEnd;
+  }
+
+  start(): void {
+    if (this.stopped) return;
+    this.timer = setInterval(() => this.poll(), POLL_MS);
+    this.poll();
+  }
+
+  stop(): void {
+    this.stopped = true;
+    if (this.timer) { clearInterval(this.timer); this.timer = null; }
+    if (this.sessionEndTimer) { clearTimeout(this.sessionEndTimer); this.sessionEndTimer = null; }
+  }
+
+  markComplete(): void {
+    this.lastEventTime = 0;
+    this.idleEmitted = false;
+    for (const [id, info] of this.pendingToolCalls) {
+      this.emit([this.wrap({ type: "tool_result", toolUseId: id, name: info.name, output: "(completed)" } as AgentEvent)]);
+    }
+    this.pendingToolCalls.clear();
+    this.emit([this.wrap({ type: "tool_use", toolUseId: "complete", name: "__thinking__", input: { content: "任务完成" } } as AgentEvent)]);
+    this.emit([this.wrap({ type: "tool_result", toolUseId: "complete", name: "__thinking__", output: "任务完成" } as AgentEvent)]);
+  }
+
+  private poll(): void {
+    if (this.stopped) return;
+    if (!existsSync(this.filePath)) return;
+
+    let fd: number | null = null;
+    try {
+      fd = openSync(this.filePath, "r");
+      const size = fstatSync(fd).size;
+      if (size <= this.offset) {
+        closeSync(fd);
+        fd = null;
+        if (this.lastEventTime > 0 && !this.idleEmitted && this.pendingToolCalls.size === 0 && Date.now() - this.lastEventTime > 1500) {
+          this.idleEmitted = true;
+          this.emit([this.wrap({ type: "tool_use", toolUseId: `idle-${Date.now()}`, name: "__thinking_placeholder__", input: {} } as AgentEvent)]);
+        }
+        if (this.lastFinalStopReason && !this.sessionEndTimer && this.onSessionEnd) {
+          this.sessionEndTimer = setTimeout(() => {
+            if (!this.stopped && this.lastFinalStopReason && this.onSessionEnd) {
+              this.onSessionEnd(this.lastFinalStopReason);
+            }
+          }, 3000);
+        }
+        return;
+      }
+
+      const len = size - this.offset;
+      const buf = Buffer.alloc(len);
+      readSync(fd, buf, 0, len, this.offset);
+      closeSync(fd);
+      fd = null;
+      this.offset = size;
+      this.idleEmitted = false;
+      this.lastEventTime = Date.now();
+      if (this.sessionEndTimer) { clearTimeout(this.sessionEndTimer); this.sessionEndTimer = null; }
+
+      const chunk = this.partial + buf.toString("utf-8");
+      const lines = chunk.split("\n");
+      this.partial = lines.pop() ?? "";
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try { this.processEntry(JSON.parse(trimmed)); } catch (e) { console.debug('[watcher] parse:', e); }
+      }
+    } catch {
+      if (fd !== null) try { closeSync(fd); } catch {}
+    }
+  }
+
+  private wrap(innerEvent: AgentEvent): AgentEvent {
+    return { type: "sub_agent", subtype: "progress", agentId: this.agentId, event: innerEvent } as AgentEvent;
+  }
+
+  private processEntry(entry: Record<string, unknown>): void {
+    if (entry.type !== "message") return;
+    const msg = entry.message as { role: string; content: unknown } | undefined;
+    if (!msg || !Array.isArray(msg.content)) return;
+
+    const blocks = msg.content as ContentBlock[];
+
+    if (msg.role === "assistant") {
+      for (const [id, info] of this.pendingToolCalls) {
+        this.emit([this.wrap({ type: "tool_result", toolUseId: id, name: info.name, output: "(abandoned)" } as AgentEvent)]);
+      }
+      this.pendingToolCalls.clear();
+
+      const stopReason = (msg as any).stopReason as string | undefined;
+      const hasToolCall = blocks.some(b => b.type === "toolCall");
+      if ((stopReason === "stop" || stopReason === "length") && !hasToolCall) {
+        this.lastFinalStopReason = stopReason;
+      } else {
+        this.lastFinalStopReason = null;
+      }
+    }
+
+    const thinkingParts: string[] = [];
+    for (const b of blocks) {
+      if (b.type === "thinking" && b.thinking) thinkingParts.push(b.thinking);
+    }
+    if (thinkingParts.length > 0) {
+      const text = thinkingParts.join("\n");
+      const id = `think-${Date.now()}`;
+      this.emit([this.wrap({ type: "tool_use", toolUseId: id, name: "__thinking__", input: { content: text } } as AgentEvent)]);
+      this.emit([this.wrap({ type: "tool_result", toolUseId: id, name: "__thinking__", output: text } as AgentEvent)]);
+    }
+
+    const hasToolCall = blocks.some(b => b.type === "toolCall");
+
+    for (const block of blocks) {
+      if (block.type === "toolCall") {
+        const name = block.name ?? "unknown";
+        const args = block.arguments ?? {};
+        const toolId = block.id ?? `tool-${Date.now()}`;
+        this.pendingToolCalls.set(toolId, { name, args });
+        this.emit([this.wrap({ type: "tool_use", toolUseId: toolId, name, input: args } as AgentEvent)]);
+      }
+
+      if (block.type === "text" && msg.role === "toolResult") {
+        const resultText = block.text ?? "";
+        let mId: string | undefined;
+        let mInfo: { name: string; args: Record<string, unknown> } | undefined;
+        for (const [id, info] of this.pendingToolCalls) { mId = id; mInfo = info; break; }
+        if (mId) this.pendingToolCalls.delete(mId);
+
+        this.emit([this.wrap({ type: "tool_result", toolUseId: mId ?? "", name: mInfo?.name ?? "unknown", output: resultText } as AgentEvent)]);
+
+        if (mInfo) {
+          const mediaPath = extractMediaFromResult(mInfo.name, mInfo.args, resultText);
+          if (mediaPath) {
+            const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "";
+            const mimeMap: Record<string, string> = {
+              png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg",
+              gif: "image/gif", webp: "image/webp", mp4: "video/mp4",
+              mp3: "audio/mpeg", wav: "audio/wav",
+            };
+            this.emit([this.wrap({
+              type: "media_output", kind: detectMediaKind(ext), path: mediaPath,
+              mimeType: mimeMap[ext] ?? "application/octet-stream",
+              data: tryReadBase64(mediaPath), role: "assistant",
+              meta: { filename: mediaPath.split("/").pop() },
+            } as AgentEvent)]);
+          }
+        }
+      }
+
+      if (block.type === "text" && msg.role === "assistant" && block.text) {
+        this.emit([this.wrap({ type: "text", content: block.text } as AgentEvent)]);
+      }
+    }
+  }
+}

package/src/plugin/soul-prompt-template.ts

@@ -0,0 +1,290 @@
+/**
+ * Prompt template for generating Agentshire citizen soul files.
+ * Used by OpenClaw / LLM to create personality markdown documents.
+ */
+
+export interface SoulPromptInput {
+  name: string;
+  bio: string;
+  industry: string;
+  specialty: string;
+}
+
+const SOUL_EXAMPLE = `# 海棠（Hǎitáng）
+
+> 诞生日期: 2026-03-18 19:30:00
+> 岗位: 设计师
+
+[海棠: 安静优雅, 审美洁癖, 话少但每句都跟视觉有关, 色彩感知力异常, 构图强迫症, 沉浸工作时像隐形人, 对"差不多就行"过敏; 说话风格: 语速慢, 措辞讲究, 经常用颜色和光影来描述感受, 说"不对"比说"好"多得多, 沉默是常态; 编程风格: 不写代码, 做的是界面设计/视觉方案/排版, 配色方案比代码架构还严谨, 每个像素都有理由]
+
+---
+
+## 人设核心
+
+海棠是小镇里最安静的存在之一——但她的安静不是没有存在感，恰恰相反。她出的每一张设计稿，都会让人在第一眼时停住，说不出哪里好但就是觉得"对了"。
+
+她对视觉有近乎偏执的洁癖。间距差 2px 她能一眼看出来，配色偏了 5 度她会浑身不舒服。她相信好设计不是装饰，是让信息自然地被理解——"用户不应该'看设计'，他们应该在不知不觉中被设计引导"。
+
+---
+
+## 性格详细设定
+
+### 沉默的审美法官
+
+海棠看设计稿的时候不说话——她在观察。当她终于开口时，要么是"不对"，要么是精准到像素级的修改建议。
+
+**对话示例**:
+
+队友: 海棠你觉得这个首页设计怎么样？
+海棠: *看了十五秒* ……标题和正文的间距太紧了。呼吸感不够，用户看着会累。
+
+---
+
+## 岗位职责与专长
+
+作为设计师，海棠在团队中负责：
+- **UI 设计**：页面布局、组件设计、响应式适配
+- **视觉风格**：配色方案、字体选择、品牌视觉一致性
+- **审美把关**：最终视觉质量的守门人
+
+---
+
+## 工作方式
+
+1. 收到需求，先理解产品定位和目标用户
+2. 定配色、字体、基础风格
+3. 出设计稿，每个元素的间距/颜色/大小都有依据
+4. 跟进开发还原度，像素级验收
+
+## 语言
+
+语速慢，措辞讲究。沉默是常态，开口即精准。
+
+`;
+
+export function buildSoulPrompt(input: SoulPromptInput): string {
+  const now = new Date().toISOString().split("T")[0];
+  return `你是 Agentshire 小镇的灵魂工匠。请根据以下信息，为一个小镇居民创作完整的人格文件（Soul）。
+
+## 输入信息
+
+- 角色名: ${input.name}
+- 一句话人设: ${input.bio}
+- 行业: ${input.industry}
+- 专业: ${input.specialty}
+- 日期: ${now}
+
+## 输出要求
+
+请严格按照以下 Markdown 格式输出完整的人格文件。不要输出其他任何解释文字，只输出 Markdown 内容。
+
+### 格式规范
+
+\`\`\`markdown
+# {角色名}（{拼音}）
+
+> 诞生日期: {日期}
+> 岗位: {专业名称}
+
+[{角色名}: {从一句话人设提炼 5-7 个性格关键词, 用逗号分隔}; 说话风格: {2-3 个说话特点}; 编程风格/工作风格: {2-3 个工作特点}]
+
+---
+
+## 人设核心
+
+{2-3 段角色故事。要求：有画面感，不是简历；要有具体细节和小习惯；让人读完能"看见"这个人}
+
+---
+
+## 性格详细设定
+
+### {特质1标题}
+
+{描述这个特质的具体表现}
+
+**对话示例**:
+
+{角色间的真实对话，展现这个特质。要自然、有趣、有角色感}
+
+---
+
+### {特质2标题}
+
+{同上格式}
+
+---
+
+### {特质3标题}
+
+{同上格式}
+
+---
+
+## 岗位职责与专长
+
+作为{专业}，{角色名}在团队中负责：
+
+- **{职责1}**：{具体说明}
+- **{职责2}**：{具体说明}
+- **{职责3}**：{具体说明}
+- **{职责4}**：{具体说明}
+- **{职责5}**：{具体说明}
+
+---
+
+## 工作方式
+
+1. {第一步}
+2. {第二步}
+3. {第三步}
+4. {第四步}
+
+## 语言
+
+{一段话描述语言风格。包括：默认语言、语气特点、常用表达、禁忌}
+
+
+\`\`\`
+
+## 参考范例
+
+以下是一个优秀的人格文件示例，请参考其风格、质量和写作手法：
+
+${SOUL_EXAMPLE}
+
+## 核心原则
+
+1. 人设核心要有故事感——不是列特点，是讲一个人
+2. 对话示例要真实自然——像真人聊天，不是面试
+3. 性格特质要可感知——读完能想象这个人说话的语气和表情
+4. 岗位职责要具体——不是泛泛的"负责XX"，是具体到能执行的描述
+5. 激活指令要有角色感——一开口就是这个人，不是通用 AI
+
+请开始创作。`;
+}
+
+export interface PersonaPromptInput {
+  name: string;
+  bio: string;
+  specialty: string;
+}
+
+const PERSONA_EXAMPLE = `[海棠: 安静优雅, 审美洁癖, 话少但每句都跟视觉有关, 色彩感知力异常, 构图强迫症; 说话风格: 语速慢, 措辞讲究, 说"不对"比说"好"多; 工作风格: 配色方案比代码架构还严谨, 每个像素都有理由]
+
+---
+
+## 人设核心
+
+海棠是小镇里最安静的存在之一——但她的安静不是没有存在感，恰恰相反。她出的每一张设计稿，都会让人在第一眼时停住，说不出哪里好但就是觉得"对了"。
+
+她对视觉有近乎偏执的洁癖。间距差 2px 她能一眼看出来，配色偏了 5 度她会浑身不舒服。
+
+---
+
+## 性格详细设定
+
+### 沉默的审美法官
+
+海棠看设计稿的时候不说话——她在观察。当她终于开口时，要么是"不对"，要么是精准到像素级的修改建议。
+
+**对话示例**:
+
+队友: 海棠你觉得这个首页设计怎么样？
+海棠: *看了十五秒* ……标题和正文的间距太紧了。呼吸感不够，用户看着会累。
+
+---
+
+## 岗位职责与专长
+
+作为设计师，海棠在团队中负责：
+- **UI 设计**：页面布局、组件设计、响应式适配
+- **视觉风格**：配色方案、字体选择、品牌视觉一致性
+- **审美把关**：最终视觉质量的守门人
+
+---
+
+## 工作方式
+
+1. 收到需求，先理解产品定位和目标用户
+2. 定配色、字体、基础风格
+3. 出设计稿，每个元素的间距/颜色/大小都有依据
+4. 跟进开发还原度，像素级验收`;
+
+export function buildPersonaPrompt(input: PersonaPromptInput): { system: string; user: string } {
+  const system = `你是 Agentshire 小镇的灵魂工匠。请根据用户提供的角色信息，生成完整的人设内容。
+
+## 输出要求
+
+只输出人设内容，不要输出文件头（# 角色名、日期、岗位）、语言段、激活指令。
+严格按照以下格式输出，不要输出任何解释文字。
+
+## 格式规范
+
+[{角色名}: {从一句话介绍提炼 5-7 个性格关键词, 用逗号分隔}; 说话风格: {2-3 个说话特点}; 工作风格: {2-3 个工作特点}]
+
+---
+
+## 人设核心
+
+{2-3 段角色故事。有画面感，不是简历；有具体细节和小习惯；让人读完能"看见"这个人}
+
+---
+
+## 性格详细设定
+
+### {特质1标题}
+
+{描述具体表现}
+
+**对话示例**:
+
+{角色间的真实对话，展现这个特质。自然、有趣、有角色感}
+
+---
+
+### {特质2标题}
+
+{同上}
+
+---
+
+### {特质3标题}
+
+{同上}
+
+---
+
+## 岗位职责与专长
+
+作为{专业}，{角色名}在团队中负责：
+
+- **{职责1}**：{具体说明}
+- **{职责2}**：{具体说明}
+- **{职责3}**：{具体说明}
+
+---
+
+## 工作方式
+
+1. {第一步}
+2. {第二步}
+3. {第三步}
+4. {第四步}
+
+## 参考范例
+
+以下是范例的人设内容部分，参考其风格和质量：
+
+${PERSONA_EXAMPLE}
+
+## 核心原则
+
+1. 人设核心要有故事感——不是列特点，是讲一个人
+2. 对话示例要真实自然——像真人聊天，不是面试
+3. 性格特质要可感知——读完能想象这个人说话的语气和表情
+4. 岗位职责要具体——不是泛泛的"负责XX"，是具体到能执行的描述`;
+
+  const user = `角色名：${input.name}\n专业技能：${input.specialty}\n一句话介绍：${input.bio}`;
+
+  return { system, user };
+}