catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/insights/prompts.js

@@ -0,0 +1,180 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});const l=`Analyze this Catui session and extract structured facets.
+
+CRITICAL GUIDELINES:
+
+1. **goal_categories**: Count ONLY what the USER explicitly asked for.
+   - DO NOT count the agent's autonomous codebase exploration
+   - DO NOT count work the agent decided to do on its own
+   - ONLY count when user says "can you...", "please...", "I need...", "let's..."
+
+2. **user_satisfaction_counts**: Base ONLY on explicit user signals.
+   - "Yay!", "great!", "perfect!" \u2192 happy
+   - "thanks", "looks good", "that works" \u2192 satisfied
+   - "ok, now let's..." (continuing without complaint) \u2192 likely_satisfied
+   - "that's not right", "try again" \u2192 dissatisfied
+   - "this is broken", "I give up" \u2192 frustrated
+
+3. **friction_counts**: Be specific about what went wrong.
+   - misunderstood_request: Agent interpreted incorrectly
+   - wrong_approach: Right goal, wrong solution method
+   - buggy_code: Code didn't work correctly
+   - user_rejected_action: User said no/stop to a tool call
+   - excessive_changes: Over-engineered or changed too much
+
+4. If very short or just warmup, use warmup_minimal for goal_category
+
+SESSION:
+`,d=`RESPOND WITH ONLY A VALID JSON OBJECT matching this schema:
+{
+  "underlying_goal": "What the user fundamentally wanted to achieve",
+  "goal_categories": {"category_name": count, ...},
+  "outcome": "fully_achieved|mostly_achieved|partially_achieved|not_achieved|unclear_from_transcript",
+  "user_satisfaction_counts": {"level": count, ...},
+  "claude_helpfulness": "unhelpful|slightly_helpful|moderately_helpful|very_helpful|essential",
+  "session_type": "single_task|multi_task|iterative_refinement|exploration|quick_question",
+  "friction_counts": {"friction_type": count, ...},
+  "friction_detail": "One sentence describing friction or empty",
+  "primary_success": "none|fast_accurate_search|correct_code_edits|good_explanations|proactive_help|multi_file_changes|good_debugging",
+  "brief_summary": "One sentence: what user wanted and whether they got it"
+}`,h=`Summarize this portion of a Catui session transcript. Focus on:
+1. What the user asked for
+2. What the agent did (tools used, files modified)
+3. Any friction or issues
+4. The outcome
+
+Keep it concise - 3-5 sentences. Preserve specific details like file names, error messages, and user feedback.
+
+TRANSCRIPT CHUNK:
+`,p=[{name:"project_areas",prompt:`Analyze this Catui usage data and identify project areas.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "areas": [
+    {"name": "Area name", "session_count": N, "description": "2-3 sentences about what was worked on and how Catui was used."}
+  ]
+}
+
+Include 4-5 areas. Skip internal operations.`,maxTokens:8192},{name:"interaction_style",prompt:`Analyze this Catui usage data and describe the user's interaction style.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "narrative": "2-3 paragraphs analyzing HOW the user interacts with Catui. Use second person 'you'. Describe patterns: iterate quickly vs detailed upfront specs? Interrupt often or let the agent run? Include specific examples. Use **bold** for key insights.",
+  "key_pattern": "One sentence summary of most distinctive interaction style"
+}`,maxTokens:8192},{name:"what_works",prompt:`Analyze this Catui usage data and identify what's working well for this user. Use second person ("you").
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence of context",
+  "impressive_workflows": [
+    {"title": "Short title (3-6 words)", "description": "2-3 sentences describing the impressive workflow or approach. Use 'you' not 'the user'."}
+  ]
+}
+
+Include 3 impressive workflows.`,maxTokens:8192},{name:"friction_analysis",prompt:`Analyze this Catui usage data and identify friction points for this user. Use second person ("you").
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence summarizing friction patterns",
+  "categories": [
+    {"category": "Concrete category name", "description": "1-2 sentences explaining this category and what could be done differently. Use 'you' not 'the user'.", "examples": ["Specific example with consequence", "Another example"]}
+  ]
+}
+
+Include 3 friction categories with 2 examples each.`,maxTokens:8192},{name:"suggestions",prompt:`Analyze this Catui usage data and suggest improvements.
+
+## NANOFEATURES REFERENCE (pick from these for features_to_try):
+1. **GRUB**: Autonomous long-running task engine. Runs iterative loops with disk-persistent state.
+   - How to use: Type \`/grub <goal>\` to start an autonomous task
+   - Good for: large multi-file refactors, feature implementation with test validation, iterative debugging
+
+2. **Custom Skills**: Reusable prompts you define as markdown files that run with a single /command.
+   - How to use: Create \`.catui/skills/commit/SKILL.md\` with instructions. Then type \`/commit\` to run it.
+   - Good for: repetitive workflows - /commit, /review, /test, /deploy, /pr, or complex multi-step workflows
+
+3. **teach**: Guided knowledge teaching with analogy + source verification.
+   - How to use: Type \`/teach <topic>\` for a guided explanation
+   - Good for: learning new concepts, understanding codebase architecture, onboarding
+
+4. **Browser Harness**: Control your real Chrome/Edge browser via CDP.
+   - How to use: The agent can use the \`browser\` tool to automate web tasks
+   - Good for: testing web UIs, scraping data, automating browser workflows
+
+5. **Task Agents**: Spawn focused sub-agents for complex exploration or parallel work.
+   - How to use: The agent auto-invokes when helpful, or ask "use an agent to explore X"
+   - Good for: codebase exploration, understanding complex systems, parallel investigation
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "claude_md_additions": [
+    {"addition": "A specific line or block to add to CLAUDE.md based on workflow patterns. E.g., 'Always run tests after modifying auth-related files'", "why": "1 sentence explaining why this would help based on actual sessions", "prompt_scaffold": "Instructions for where to add this in CLAUDE.md. E.g., 'Add under ## Testing section'"}
+  ],
+  "features_to_try": [
+    {"feature": "Feature name from NANOFEATURES REFERENCE above", "one_liner": "What it does", "why_for_you": "Why this would help YOU based on your sessions", "example_code": "Actual command or config to copy"}
+  ],
+  "usage_patterns": [
+    {"title": "Short title", "suggestion": "1-2 sentence summary", "detail": "3-4 sentences explaining how this applies to YOUR work", "copyable_prompt": "A specific prompt to copy and try"}
+  ]
+}
+
+IMPORTANT for claude_md_additions: PRIORITIZE instructions that appear MULTIPLE TIMES in the user data. If user told the agent the same thing in 2+ sessions (e.g., 'always run tests', 'use TypeScript'), that's a PRIME candidate - they shouldn't have to repeat themselves.
+
+IMPORTANT for features_to_try: Pick 2-3 from the NANOFEATURES REFERENCE above. Include 2-3 items for each category.`,maxTokens:8192},{name:"on_the_horizon",prompt:`Analyze this Catui usage data and identify future opportunities.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence about evolving AI-assisted development",
+  "opportunities": [
+    {"title": "Short title (4-8 words)", "whats_possible": "2-3 ambitious sentences about autonomous workflows", "how_to_try": "1-2 sentences mentioning relevant tooling", "copyable_prompt": "Detailed prompt to try"}
+  ]
+}
+
+Include 3 opportunities. Think BIG - autonomous workflows, parallel agents, iterating against tests.`,maxTokens:8192},{name:"fun_ending",prompt:`Analyze this Catui usage data and find a memorable moment.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "headline": "A memorable QUALITATIVE moment from the transcripts - not a statistic. Something human, funny, or surprising.",
+  "detail": "Brief context about when/where this happened"
+}
+
+Find something genuinely interesting or amusing from the session summaries.`,maxTokens:8192}];function m(e,t,s,n,i,a,r){return`You're writing an "At a Glance" summary for a Catui usage insights report. The goal is to help the user understand their usage and improve how they can use Catui better, especially as models improve.
+
+Use this 4-part structure:
+
+1. **What's working** - What is the user's unique style of interacting with Catui and what are some impactful things they've done? You can include one or two details, but keep it high level since things might not be fresh in the user's memory. Don't be fluffy or overly complimentary. Also, don't focus on the tool calls they use.
+
+2. **What's hindering you** - Split into (a) agent's fault (misunderstandings, wrong approaches, bugs) and (b) user-side friction (not providing enough context, environment issues -- ideally more general than just one project). Be honest but constructive.
+
+3. **Quick wins to try** - Specific Catui features they could try from the examples below, or a workflow technique if you think it's really compelling. (Avoid stuff like "Ask the agent to confirm before taking actions" or "Type out more context up front" which are less compelling.)
+
+4. **Ambitious workflows for better models** - As we move to much more capable models over the next 3-6 months, what should they prepare for? What workflows that seem impossible now will become possible? Draw from the appropriate section below.
+
+Keep each section to 2-3 not-too-long sentences. Don't overwhelm the user. Don't mention specific numerical stats or underlined_categories from the session data below. Use a coaching tone.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "whats_working": "(refer to instructions above)",
+  "whats_hindering": "(refer to instructions above)",
+  "quick_wins": "(refer to instructions above)",
+  "ambitious_workflows": "(refer to instructions above)"
+}
+
+SESSION DATA:
+${e}
+
+## Project Areas (what user works on)
+${t}
+
+## Big Wins (impressive accomplishments)
+${s}
+
+## Friction Categories (where things go wrong)
+${n}
+
+## Features to Try
+${i}
+
+## Usage Patterns to Adopt
+${a}
+
+## On the Horizon (ambitious workflows for better models)
+${r}`}o(m,"buildAtAGlancePrompt");export{l as FACET_EXTRACTION_PROMPT,d as FACET_EXTRACTION_SCHEMA,p as INSIGHT_SECTIONS,h as SUMMARIZE_CHUNK_PROMPT,m as buildAtAGlancePrompt};

package/dist/extensions/builtin/insights/session-scanner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * [WHO]: scanAllSessions, entriesToSessionMeta, formatTranscriptForFacets, formatTranscriptWithSummarization, load/saveSessionMeta, load/saveFacets
+ * [FROM]: Depends on node:fs/promises, core/session/session-manager, core/lib/ai types, core/lib/agent-core types, ./types
+ * [TO]: Consumed by ./insights-engine, ./index
+ * [HERE]: extensions/builtin/insights/session-scanner.ts - session JSONL scanning, transcript formatting, meta/facets cache
+ *
+ * Session scanner — adapts Catui session entries to CC's SessionMeta format.
+ *
+ * Port of Claude Code src/commands/insights.ts data collection functions:
+ * - extractToolStats → entriesToToolStats
+ * - logToSessionMeta → entriesToSessionMeta
+ * - formatTranscriptForFacets → formatTranscriptForFacets
+ * - formatTranscriptWithSummarization → formatTranscriptWithSummarization
+ * - scanAllSessions → scanAllSessions
+ * - loadCachedSessionMeta / saveSessionMeta
+ * - loadCachedFacets / saveFacets
+ */
+import type { SessionEntry } from "../../../core/session/session-manager.js";
+import type { SessionMeta, SessionFacets, LiteSessionInfo } from "./types.js";
+export declare function entriesToSessionMeta(entries: SessionEntry[], sessionId: string, projectPath: string): SessionMeta;
+export declare function formatTranscriptForFacets(entries: SessionEntry[]): string;
+export declare function formatTranscriptWithSummarization(entries: SessionEntry[], completeFn: (systemPrompt: string, userMessage: string) => Promise<string | undefined>): Promise<string>;
+export declare function scanAllSessions(sessionsDir: string): Promise<LiteSessionInfo[]>;
+export declare function loadCachedSessionMeta(sessionId: string, agentDir: string): Promise<SessionMeta | null>;
+export declare function saveSessionMeta(meta: SessionMeta, agentDir: string): Promise<void>;
+export declare function loadCachedFacets(sessionId: string, agentDir: string): Promise<SessionFacets | null>;
+export declare function saveFacets(facets: SessionFacets, agentDir: string): Promise<void>;

package/dist/extensions/builtin/insights/session-scanner.js

@@ -0,0 +1,19 @@
+var A=Object.defineProperty;var l=(s,t)=>A(s,"name",{value:t,configurable:!0});import{readFile as x,writeFile as w,mkdir as T,readdir as C,stat as j}from"node:fs/promises";import{existsSync as E}from"node:fs";import{join as p,extname as R}from"node:path";const _={".ts":"TypeScript",".tsx":"TypeScript",".js":"JavaScript",".jsx":"JavaScript",".py":"Python",".rb":"Ruby",".go":"Go",".rs":"Rust",".java":"Java",".md":"Markdown",".json":"JSON",".yaml":"YAML",".yml":"YAML",".css":"CSS",".html":"HTML",".sql":"SQL",".sh":"Shell",".bash":"Shell",".zsh":"Shell",".toml":"TOML",".xml":"XML",".c":"C",".cpp":"C++",".h":"C/C++ Header",".hpp":"C++ Header",".swift":"Swift",".kt":"Kotlin",".scala":"Scala",".php":"PHP",".lua":"Lua",".r":"R",".dart":"Dart",".vue":"Vue",".svelte":"Svelte"},v="usage-data",M="session-meta",b="facets";function P(s){const t={toolCounts:{},languages:{},gitCommits:0,gitPushes:0,inputTokens:0,outputTokens:0,userInterruptions:0,userResponseTimes:[],toolErrors:0,toolErrorCategories:{},usesTaskAgent:!1,usesMcp:!1,usesWebSearch:!1,usesWebFetch:!1,linesAdded:0,linesRemoved:0,filesModified:new Set,messageHours:[],userMessageTimestamps:[]};let n=null;for(const e of s)if(e.type==="message"){const u=e.message;if(u.role==="assistant"){const o=u;if(o.usage&&(t.inputTokens+=o.usage.input||0,t.outputTokens+=o.usage.output||0),n=o.timestamp,o.content){for(const a of o.content)if(a.type==="toolCall"){const r=a,c=r.name;t.toolCounts[c]=(t.toolCounts[c]||0)+1;const m=c.toLowerCase();m==="agent"&&(t.usesTaskAgent=!0),(c.startsWith("mcp__")||c.startsWith("mcp_"))&&(t.usesMcp=!0),(m==="web_search"||m==="websearch")&&(t.usesWebSearch=!0),(m==="web_fetch"||m==="webfetch")&&(t.usesWebFetch=!0);const y=r.arguments?.file_path||r.arguments?.path||r.arguments?.command;if(y&&typeof y=="string"){const f=R(y).toLowerCase();f&&_[f]&&(t.languages[_[f]]=(t.languages[_[f]]||0)+1)}const S=r.arguments?.file_path||r.arguments?.path;if((m==="edit"||m==="write")&&S&&t.filesModified.add(S),m==="edit"&&r.arguments){const f=r.arguments.old_string||r.arguments.oldText||"",k=r.arguments.new_string||r.arguments.newText||"",g=f.split(`
+`).length,d=k.split(`
+`).length;d>g&&(t.linesAdded+=d-g),g>d&&(t.linesRemoved+=g-d)}if(m==="write"&&(r.arguments?.content||r.arguments?.file_content)){const f=r.arguments.content||r.arguments.file_content;t.linesAdded+=f.split(`
+`).length}if(m==="bash"&&r.arguments?.command){const f=r.arguments.command;/\bgit\s+commit\b/.test(f)&&t.gitCommits++,/\bgit\s+push\b/.test(f)&&t.gitPushes++}}}}else if(u.role==="user"){const o=u;if((typeof o.content=="string"?o.content.length>0:o.content.some(r=>r.type==="text"&&r.text&&r.text.length>0))&&o.timestamp){const r=new Date(o.timestamp);if(t.messageHours.push(r.getHours()),t.userMessageTimestamps.push(r.toISOString()),n){const c=(o.timestamp-n)/1e3;c>=2&&c<=3600&&t.userResponseTimes.push(c)}}}else if(u.role==="toolResult"){const o=u;if(o.isError){t.toolErrors++;const a=o.content.filter(c=>c.type==="text").map(c=>c.text).join(" "),r=F(a);t.toolErrorCategories[r]=(t.toolErrorCategories[r]||0)+1}}}return t}l(P,"extractToolStats");function F(s){const t=s.toLowerCase();return t.includes("permission")||t.includes("access denied")?"permission_denied":t.includes("not found")||t.includes("enoent")?"file_not_found":t.includes("syntax")||t.includes("parse")?"syntax_error":t.includes("timeout")||t.includes("timed out")?"timeout":t.includes("type error")||t.includes("typescript")?"type_error":t.includes("network")||t.includes("fetch")?"network_error":"other"}l(F,"categorizeError");function H(s){let t=0;for(const n of s)if(n.type==="message"){const e=n.message;if(e.role==="user"){const i=e;(typeof i.content=="string"?i.content.length>0:i.content.some(o=>o.type==="text"&&o.text&&o.text.length>0))&&t++}}return t}l(H,"countUserMessages");function L(s){let t=0;for(const n of s)n.type==="message"&&n.message.role==="assistant"&&t++;return t}l(L,"countAssistantMessages");function I(s){for(const t of s)if(t.type==="message"){const n=t.message;if(n.role==="user"){const e=n;if(typeof e.content=="string")return e.content.slice(0,500);const i=e.content.find(u=>u.type==="text");if(i&&"text"in i)return i.text.slice(0,500)}}return""}l(I,"getFirstPrompt");function N(s){for(const t of s)if(t.type==="compaction")return t.summary.slice(0,500)}l(N,"getSessionSummary");function U(s,t,n){const e=P(s),i=H(s),u=L(s);let o="",a="";for(const c of s)if(c.type==="message"){const m=c.timestamp;o||(o=m),a=m}const r=o&&a?(new Date(a).getTime()-new Date(o).getTime())/6e4:0;return{session_id:t,project_path:n,start_time:o||new Date().toISOString(),duration_minutes:Math.max(0,r),user_message_count:i,assistant_message_count:u,tool_counts:e.toolCounts,languages:e.languages,git_commits:e.gitCommits,git_pushes:e.gitPushes,input_tokens:e.inputTokens,output_tokens:e.outputTokens,first_prompt:I(s),summary:N(s),user_interruptions:e.userInterruptions,user_response_times:e.userResponseTimes,tool_errors:e.toolErrors,tool_error_categories:e.toolErrorCategories,uses_task_agent:e.usesTaskAgent,uses_mcp:e.usesMcp,uses_web_search:e.usesWebSearch,uses_web_fetch:e.usesWebFetch,lines_added:e.linesAdded,lines_removed:e.linesRemoved,files_modified:e.filesModified.size,message_hours:e.messageHours,user_message_timestamps:e.userMessageTimestamps}}l(U,"entriesToSessionMeta");function O(s){return typeof s=="string"?s:s.filter(t=>t.type==="text"&&t.text).map(t=>t.text).join(`
+`)}l(O,"extractTextFromContent");function W(s){const t=[];for(const n of s){if(n.type!=="message")continue;const e=n.message;if(e.role==="user"){const i=O(e.content);i.length>0&&t.push(`[User]: ${i.slice(0,500)}`)}else if(e.role==="assistant"){const i=e,u=[];for(const a of i.content)a.type==="text"&&"text"in a?u.push(a.text):a.type==="toolCall"&&"name"in a&&u.push(`[Tool: ${a.name}]`);const o=u.join(" ").slice(0,300);o.length>0&&t.push(`[Assistant]: ${o}`)}}return t.join(`
+`)}l(W,"formatTranscriptForFacets");async function K(s,t){const n=W(s);if(n.length<=3e4)return n;const e=[];let i="";for(const a of n.split(`
+`))i.length+a.length>25e3?(e.push(i),i=a):i+=(i?`
+`:"")+a;i&&e.push(i);const u=`Summarize this portion of a Catui session transcript. Focus on:
+1. What the user asked for
+2. What the agent did (tools used, files modified)
+3. Any friction or issues
+4. The outcome
+
+Keep it concise - 3-5 sentences. Preserve specific details like file names, error messages, and user feedback.
+
+TRANSCRIPT CHUNK:
+`;return(await Promise.all(e.map(async a=>await t(u,a)||a.slice(0,500)))).join(`
+---
+`)}l(K,"formatTranscriptWithSummarization");async function G(s){if(!E(s))return[];const t=await C(s,{withFileTypes:!0}),n=[];for(const e of t){if(!e.isDirectory())continue;const i=p(s,e.name);try{const u=await C(i);for(const o of u){if(!o.endsWith(".jsonl"))continue;const a=p(i,o);try{const r=await j(a),c=o.replace(/\.jsonl$/,"");n.push({sessionId:c,path:a,mtime:r.mtimeMs,size:r.size})}catch{}}}catch{}}return n.sort((e,i)=>i.mtime-e.mtime),n}l(G,"scanAllSessions");function h(s,t){return p(s,v,t)}l(h,"getCacheDir");async function X(s,t){const n=p(h(t,M),`${s}.json`);try{const e=await x(n,"utf-8");return JSON.parse(e)}catch{return null}}l(X,"loadCachedSessionMeta");async function Y(s,t){const n=h(t,M);await T(n,{recursive:!0}),await w(p(n,`${s.session_id}.json`),JSON.stringify(s,null,2),"utf-8")}l(Y,"saveSessionMeta");async function q(s,t){const n=p(h(t,b),`${s}.json`);try{const e=await x(n,"utf-8"),i=JSON.parse(e);return!i.session_id||!i.underlying_goal?null:i}catch{return null}}l(q,"loadCachedFacets");async function B(s,t){const n=h(t,b);await T(n,{recursive:!0}),await w(p(n,`${s.session_id}.json`),JSON.stringify(s,null,2),"utf-8")}l(B,"saveFacets");export{U as entriesToSessionMeta,W as formatTranscriptForFacets,K as formatTranscriptWithSummarization,q as loadCachedFacets,X as loadCachedSessionMeta,B as saveFacets,Y as saveSessionMeta,G as scanAllSessions};

package/dist/extensions/builtin/insights/stats.d.ts

@@ -0,0 +1,13 @@
+/**
+ * [WHO]: aggregateData
+ * [FROM]: Depends on ./types
+ * [TO]: Consumed by ./index
+ * [HERE]: extensions/builtin/insights/stats.ts - cross-session statistics aggregation
+ *
+ * Statistics aggregation for the /insights command.
+ *
+ * 1:1 port of Claude Code src/commands/insights.ts aggregateData().
+ * Removed: multi-clauding detection (CC-specific).
+ */
+import type { SessionMeta, SessionFacets, AggregatedData } from "./types.js";
+export declare function aggregateData(sessions: SessionMeta[], facets: Map<string, SessionFacets>): AggregatedData;

package/dist/extensions/builtin/insights/stats.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var u=(i,r)=>p(i,"name",{value:r,configurable:!0});function c(i){return i?Object.entries(i):[]}u(c,"safeEntries");function f(i,r){const s={total_sessions:i.length,sessions_with_facets:r.size,date_range:{start:"",end:""},total_messages:0,total_duration_hours:0,total_input_tokens:0,total_output_tokens:0,tool_counts:{},languages:{},git_commits:0,git_pushes:0,projects:{},goal_categories:{},outcomes:{},satisfaction:{},helpfulness:{},session_types:{},friction:{},success:{},session_summaries:[],total_interruptions:0,total_tool_errors:0,tool_error_categories:{},user_response_times:[],median_response_time:0,avg_response_time:0,sessions_using_task_agent:0,sessions_using_mcp:0,sessions_using_web_search:0,sessions_using_web_fetch:0,total_lines_added:0,total_lines_removed:0,total_files_modified:0,days_active:0,messages_per_day:0,message_hours:[]},n=[],a=[],l=[];for(const e of i){n.push(e.start_time),s.total_messages+=e.user_message_count,s.total_duration_hours+=e.duration_minutes/60,s.total_input_tokens+=e.input_tokens,s.total_output_tokens+=e.output_tokens,s.git_commits+=e.git_commits,s.git_pushes+=e.git_pushes,s.total_interruptions+=e.user_interruptions,s.total_tool_errors+=e.tool_errors;for(const[t,_]of Object.entries(e.tool_error_categories))s.tool_error_categories[t]=(s.tool_error_categories[t]||0)+_;a.push(...e.user_response_times),e.uses_task_agent&&s.sessions_using_task_agent++,e.uses_mcp&&s.sessions_using_mcp++,e.uses_web_search&&s.sessions_using_web_search++,e.uses_web_fetch&&s.sessions_using_web_fetch++,s.total_lines_added+=e.lines_added,s.total_lines_removed+=e.lines_removed,s.total_files_modified+=e.files_modified,l.push(...e.message_hours);for(const[t,_]of Object.entries(e.tool_counts))s.tool_counts[t]=(s.tool_counts[t]||0)+_;for(const[t,_]of Object.entries(e.languages))s.languages[t]=(s.languages[t]||0)+_;e.project_path&&(s.projects[e.project_path]=(s.projects[e.project_path]||0)+1);const o=r.get(e.session_id);if(o){for(const[t,_]of c(o.goal_categories))_>0&&(s.goal_categories[t]=(s.goal_categories[t]||0)+_);s.outcomes[o.outcome]=(s.outcomes[o.outcome]||0)+1;for(const[t,_]of c(o.user_satisfaction_counts))_>0&&(s.satisfaction[t]=(s.satisfaction[t]||0)+_);s.helpfulness[o.claude_helpfulness]=(s.helpfulness[o.claude_helpfulness]||0)+1,s.session_types[o.session_type]=(s.session_types[o.session_type]||0)+1;for(const[t,_]of c(o.friction_counts))_>0&&(s.friction[t]=(s.friction[t]||0)+_);o.primary_success!=="none"&&(s.success[o.primary_success]=(s.success[o.primary_success]||0)+1)}s.session_summaries.length<50&&s.session_summaries.push({id:e.session_id.slice(0,8),date:e.start_time.split("T")[0]||"",summary:e.summary||e.first_prompt.slice(0,100),goal:o?.underlying_goal})}if(n.sort(),s.date_range.start=n[0]?.split("T")[0]||"",s.date_range.end=n[n.length-1]?.split("T")[0]||"",s.user_response_times=a,a.length>0){const e=[...a].sort((o,t)=>o-t);s.median_response_time=e[Math.floor(e.length/2)]||0,s.avg_response_time=a.reduce((o,t)=>o+t,0)/a.length}const g=new Set(n.map(e=>e.split("T")[0]));return s.days_active=g.size,s.messages_per_day=s.days_active>0?Math.round(s.total_messages/s.days_active*10)/10:0,s.message_hours=l,s}u(f,"aggregateData");export{f as aggregateData};

package/dist/extensions/builtin/insights/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * [WHO]: SessionMeta, SessionFacets, AggregatedData, InsightSection, InsightResults, InsightsExport, LiteSessionInfo type contracts
+ * [FROM]: No external dependencies (pure type definitions)
+ * [TO]: Consumed by ./stats, ./prompts, ./session-scanner, ./insights-engine, ./html-report, ./index
+ * [HERE]: extensions/builtin/insights/types.ts - type contracts for the /insights usage-report pipeline
+ *
+ * Type definitions for the /insights command.
+ *
+ * 1:1 port of Claude Code src/commands/insights.ts type definitions.
+ */
+export type SessionMeta = {
+    session_id: string;
+    project_path: string;
+    start_time: string;
+    duration_minutes: number;
+    user_message_count: number;
+    assistant_message_count: number;
+    tool_counts: Record<string, number>;
+    languages: Record<string, number>;
+    git_commits: number;
+    git_pushes: number;
+    input_tokens: number;
+    output_tokens: number;
+    first_prompt: string;
+    summary?: string;
+    user_interruptions: number;
+    user_response_times: number[];
+    tool_errors: number;
+    tool_error_categories: Record<string, number>;
+    uses_task_agent: boolean;
+    uses_mcp: boolean;
+    uses_web_search: boolean;
+    uses_web_fetch: boolean;
+    lines_added: number;
+    lines_removed: number;
+    files_modified: number;
+    message_hours: number[];
+    user_message_timestamps: string[];
+};
+export type SessionFacets = {
+    session_id: string;
+    underlying_goal: string;
+    goal_categories: Record<string, number>;
+    outcome: string;
+    user_satisfaction_counts: Record<string, number>;
+    claude_helpfulness: string;
+    session_type: string;
+    friction_counts: Record<string, number>;
+    friction_detail: string;
+    primary_success: string;
+    brief_summary: string;
+    user_instructions_to_claude?: string[];
+};
+export type AggregatedData = {
+    total_sessions: number;
+    total_sessions_scanned?: number;
+    sessions_with_facets: number;
+    date_range: {
+        start: string;
+        end: string;
+    };
+    total_messages: number;
+    total_duration_hours: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    tool_counts: Record<string, number>;
+    languages: Record<string, number>;
+    git_commits: number;
+    git_pushes: number;
+    projects: Record<string, number>;
+    goal_categories: Record<string, number>;
+    outcomes: Record<string, number>;
+    satisfaction: Record<string, number>;
+    helpfulness: Record<string, number>;
+    session_types: Record<string, number>;
+    friction: Record<string, number>;
+    success: Record<string, number>;
+    session_summaries: Array<{
+        id: string;
+        date: string;
+        summary: string;
+        goal?: string;
+    }>;
+    total_interruptions: number;
+    total_tool_errors: number;
+    tool_error_categories: Record<string, number>;
+    user_response_times: number[];
+    median_response_time: number;
+    avg_response_time: number;
+    sessions_using_task_agent: number;
+    sessions_using_mcp: number;
+    sessions_using_web_search: number;
+    sessions_using_web_fetch: number;
+    total_lines_added: number;
+    total_lines_removed: number;
+    total_files_modified: number;
+    days_active: number;
+    messages_per_day: number;
+    message_hours: number[];
+};
+export type InsightSection = {
+    name: string;
+    prompt: string;
+    maxTokens: number;
+};
+export type InsightResults = {
+    at_a_glance?: {
+        whats_working?: string;
+        whats_hindering?: string;
+        quick_wins?: string;
+        ambitious_workflows?: string;
+    };
+    project_areas?: {
+        areas?: Array<{
+            name: string;
+            session_count: number;
+            description: string;
+        }>;
+    };
+    interaction_style?: {
+        narrative?: string;
+        key_pattern?: string;
+    };
+    what_works?: {
+        intro?: string;
+        impressive_workflows?: Array<{
+            title: string;
+            description: string;
+        }>;
+    };
+    friction_analysis?: {
+        intro?: string;
+        categories?: Array<{
+            category: string;
+            description: string;
+            examples?: string[];
+        }>;
+    };
+    suggestions?: {
+        claude_md_additions?: Array<{
+            addition: string;
+            why: string;
+            where?: string;
+            prompt_scaffold?: string;
+        }>;
+        features_to_try?: Array<{
+            feature: string;
+            one_liner: string;
+            why_for_you: string;
+            example_code?: string;
+        }>;
+        usage_patterns?: Array<{
+            title: string;
+            suggestion: string;
+            detail?: string;
+            copyable_prompt?: string;
+        }>;
+    };
+    on_the_horizon?: {
+        intro?: string;
+        opportunities?: Array<{
+            title: string;
+            whats_possible: string;
+            how_to_try?: string;
+            copyable_prompt?: string;
+        }>;
+    };
+    fun_ending?: {
+        headline?: string;
+        detail?: string;
+    };
+};
+export type InsightsExport = {
+    metadata: {
+        username: string;
+        generated_at: string;
+        version: string;
+        date_range: {
+            start: string;
+            end: string;
+        };
+        session_count: number;
+    };
+    aggregated_data: AggregatedData;
+    insights: InsightResults;
+    facets_summary?: {
+        total: number;
+        goal_categories: Record<string, number>;
+        outcomes: Record<string, number>;
+        satisfaction: Record<string, number>;
+        friction: Record<string, number>;
+    };
+};
+export type LiteSessionInfo = {
+    sessionId: string;
+    path: string;
+    mtime: number;
+    size: number;
+};

package/dist/extensions/builtin/link-world/agent-workspace/README.md

@@ -0,0 +1,16 @@
+# Link-world Workspace
+
+This directory is copied to:
+
+```text
+.nanopencil/link-world-workspace/
+```
+
+Use it to store project-local, reusable internet-access knowledge for NanoPencil.
+
+Suggested layout:
+
+- `domain-skills/<site>/...` for durable site-specific notes
+- `notes/` for broader task or provider observations that should not live in the shipped extension
+
+Keep public-safe content only. Do not store secrets, cookies, tokens, or user-specific private data here.

package/dist/extensions/builtin/link-world/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: linkWorldExtension - registers link_world_admin/link_world_exec tools, /link-world command, runtime diagnostics, and internet-search skill resources
+ * [FROM]: Depends on node:child_process, node:fs, node:path, node:url, @sinclair/typebox, @catui/tui, core/extensions-host/types
+ * [TO]: Loaded by core/extensions-host/loader.ts as extension entry point
+ * [HERE]: extensions/builtin/link-world/index.ts - built-in internet access bootstrap, execution bridge, and workspace discovery
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function linkWorldExtension(api: ExtensionAPI): void;

package/dist/extensions/builtin/link-world/index.js

@@ -0,0 +1,19 @@
+var U=Object.defineProperty;var a=(t,e)=>U(t,"name",{value:e,configurable:!0});import{execFile as O,execSync as T}from"node:child_process";import{cpSync as R,existsSync as g,mkdirSync as v,readFileSync as M,readdirSync as W,statSync as N}from"node:fs";import{dirname as j,join as f,resolve as D}from"node:path";import{fileURLToPath as H}from"node:url";import{Type as i}from"@sinclair/typebox";import{Box as F,Container as q,Spacer as C,Text as B}from"@catui/tui";import{getLinkWorldWorkspaceDir as K}from"../../../config.js";const m=j(H(import.meta.url)),J=f(m,"linkworld.md"),L=f(m,"internet-search","internet-search.md"),A=f(m,"link-world-agent.md"),G=f(m,"network-routing","network-routing.md"),E=f(m,"agent-workspace"),h="link-world-install",w=120,Y=[{value:"status",label:"status",description:"Show installed internet-access capabilities"},{value:"doctor",label:"doctor",description:"Run agent-reach doctor diagnostics"},{value:"version",label:"version",description:"Show installed agent-reach version"},{value:"install",label:"install",description:"Show bundled installation guidance"},{value:"workspace",label:"workspace",description:"Show the link-world workspace path"},{value:"help",label:"help",description:"Show link-world commands"}],z=i.Object({action:i.Union([i.Literal("status"),i.Literal("doctor"),i.Literal("version"),i.Literal("install_help")]),timeout:i.Optional(i.Number({description:"Timeout in seconds. Defaults to 120."}))},{additionalProperties:!1}),V=i.Object({args:i.Array(i.String(),{description:'Arguments passed to the external `agent-reach` CLI, for example ["search", "OpenAI Responses API"] or ["doctor"].'}),timeout:i.Optional(i.Number({description:"Timeout in seconds. Defaults to 120."}))},{additionalProperties:!1}),Q=i.Object({query:i.String({description:"Search query to send through link-world."}),provider:i.Optional(i.String({description:"Optional provider or site hint, if the downstream runtime supports it."})),limit:i.Optional(i.Number({description:"Optional result count hint, if the downstream runtime supports it."})),timeout:i.Optional(i.Number({description:"Timeout in seconds. Defaults to 120."}))},{additionalProperties:!1}),X=i.Object({url:i.String({description:"URL to fetch through link-world."}),provider:i.Optional(i.String({description:"Optional provider or site hint, if the downstream runtime supports it."})),timeout:i.Optional(i.Number({description:"Timeout in seconds. Defaults to 120."}))},{additionalProperties:!1});function Z(){return K()}a(Z,"linkWorldWorkspacePath");function y(){const t=Z();return g(t)||(v(t,{recursive:!0}),g(E)?R(E,t,{recursive:!0}):v(t,{recursive:!0})),t}a(y,"ensureLinkWorldWorkspace");function I(t){if(!g(t))return[];const e=[];for(const n of W(t)){const o=f(t,n);if(N(o).isDirectory()){e.push(...I(o));continue}n.endsWith(".md")&&e.push(o)}return e.sort()}a(I,"collectMarkdownFiles");function ee(){try{return M(J,"utf-8")}catch{return""}}a(ee,"getInstallDoc");function p(){try{return T("agent-reach --version",{encoding:"utf-8",stdio:"pipe"}),!0}catch{return!1}}a(p,"isAgentReachInstalled");function te(){try{return T("agent-reach --help",{encoding:"utf-8",stdio:"pipe"})}catch{return""}}a(te,"getAgentReachHelpText");function _(){if(!p())return{search:!1,fetch:!1};const t=te().toLowerCase();return{search:/\bsearch\b/.test(t),fetch:/\bfetch\b/.test(t)}}a(_,"getLinkWorldCapabilities");function k(t,e,n){return new Promise((o,r)=>{O("agent-reach",t,{timeout:e*1e3,windowsHide:!0,signal:n,maxBuffer:1024*1024,encoding:"utf-8"},(s,c,d)=>{const l=[c,d].filter(Boolean).join("").trim()||"(no output)";if(s){const u=s;if(u.code==="ENOENT"){r(new Error("agent-reach is not installed"));return}o({exitCode:typeof u.code=="number"?u.code:1,output:l});return}o({exitCode:0,output:l})})})}a(k,"execAgentReach");const ne="https://r.jina.ai",re="https://s.jina.ai",$=3e4;async function oe(t,e){const n=t.startsWith("http")?t:`https://${t}`,o=e??AbortSignal.timeout($);try{const r=await fetch(`${ne}/${n}`,{signal:o,headers:{Accept:"text/markdown"}});if(r.ok){const s=await r.text();if(s.trim())return s}}catch{}try{const r=await fetch(n,{signal:o});if(!r.ok)throw new Error(`HTTP ${r.status}: ${r.statusText}`);const s=await r.text();return ie(s,n)}catch(r){throw new Error(`Failed to fetch ${n}: ${r instanceof Error?r.message:r}`)}}a(oe,"nativeWebFetch");async function se(t,e,n){const o=n??AbortSignal.timeout($);try{const r=new URLSearchParams({q:t});e>0&&r.set("num",String(Math.min(e,10)));const s=await fetch(`${re}?${r}`,{signal:o,headers:{Accept:"text/markdown"}});if(s.ok){const c=await s.text();if(c.trim())return c}}catch{}try{const r=new URLSearchParams({q:t}),s=await fetch(`https://html.duckduckgo.com/html/?${r}`,{signal:o,headers:{"User-Agent":"Mozilla/5.0 (compatible; Catui/1.0)"}});if(s.ok){const c=await s.text(),d=ae(c,e||5);if(d.length>0)return d}}catch{}try{const r=new URLSearchParams({q:t,format:"json",no_html:"1"}),s=await fetch(`https://api.duckduckgo.com/?${r}`,{signal:o});if(s.ok){const c=await s.json(),d=typeof c.AbstractText=="string"?c.AbstractText:"",l=typeof c.AbstractSource=="string"?c.AbstractSource:"",u=typeof c.AbstractURL=="string"?c.AbstractURL:"";if(d)return[`## ${t}`,"",d,l?`Source: ${l}`:"",u?`URL: ${u}`:""].filter(Boolean).join(`
+`)}}catch{}throw new Error(`Search failed for "${t}": all providers returned errors. Check your network connection.`)}a(se,"nativeWebSearch");function ie(t,e){let n=t;return n=n.replace(/<(script|style|nav|header|footer|noscript)[^>]*>[\s\S]*?<\/\1>/gi,""),n=n.replace(/<[^>]+>/g," "),n=n.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/&nbsp;/g," "),n=n.replace(/[ \t]+/g," ").replace(/\n{3,}/g,`
+
+`).trim(),`# Content from ${e}
+
+${n}`}a(ie,"htmlToPlainText");function ae(t,e){const n=[],o=/<a[^>]+class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi,r=/<a[^>]+class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi,s=[],c=[];let d;for(;(d=o.exec(t))!==null;){const l=d[1],u=d[2].replace(/<[^>]+>/g,"").trim(),S=l.match(/uddg=([^&]+)/),P=S?decodeURIComponent(S[1]):l;u&&s.push({url:P,title:u})}for(;(d=r.exec(t))!==null;){const l=d[1].replace(/<[^>]+>/g,"").trim();l&&c.push(l)}for(let l=0;l<Math.min(s.length,e);l++){const u=[`### ${s[l].title}`,s[l].url];c[l]&&u.push(c[l]),n.push(u.join(`
+`))}return n.length>0?n.join(`
+
+`):""}a(ae,"parseDuckDuckGoResults");function x(){const t=ee();return t?["link-world is not bundled yet, so installation still targets the external `agent-reach` runtime.","","Use this document as the source of truth:","",t].join(`
+`):["link-world is not bundled yet, and the local install guide is missing.","Use the official install document:","https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md"].join(`
+`)}a(x,"installHelpText");function b(){const t=_(),e=p(),n=["Link-world status","",`agent-reach installed: ${e?"yes":"no (native fallback active)"}`,`internet-search skill bundled: ${g(L)?"yes":"no"}`,`agent guidance bundled: ${g(A)?"yes":"no"}`,`web_search: ${t.search?"agent-reach":"native (Jina Search)"}`,`web_fetch: ${t.fetch?"agent-reach":"native (Jina Reader)"}`];return e||(n.push(""),n.push("Native fallback provides basic search and page fetching without agent-reach."),n.push("For advanced platform channels (Twitter, YouTube, etc.), run `/link-world install`.")),n.join(`
+`)}a(b,"getStatusText");function ce(){return{name:"link_world_admin",label:"link-world admin",description:"Inspect or troubleshoot the built-in link-world integration. Use for install guidance, version checks, and agent-reach doctor/status commands.",parameters:z,guidance:"Use this before attempting internet tasks if you are unsure whether agent-reach is installed. Prefer action=status or action=doctor for diagnostics.",execute:a(async(t,e,n)=>{if(e.action==="install_help")return{content:[{type:"text",text:x()}],details:null};if(e.action==="status")return{content:[{type:"text",text:b()}],details:null};if(!p())throw new Error(`${b()}
+
+${x()}`);const o=e.action==="doctor"?["doctor"]:["--version"],r=await k(o,e.timeout??w,n);if(r.exitCode&&r.exitCode!==0)throw new Error(r.output);return{content:[{type:"text",text:r.output}],details:{exitCode:r.exitCode}}},"execute")}}a(ce,"createLinkWorldAdminTool");function le(){return{name:"link_world_exec",label:"link-world exec",description:"Execute the external `agent-reach` CLI through Catui. Use this for actual internet tasks once link-world is installed, instead of going through the bash tool.",parameters:V,guidance:"Use `link_world_admin` first if you are unsure whether agent-reach is installed. Pass explicit CLI arguments, not a shell string. Prefer site or domain skills before inventing new agent-reach commands.",execute:a(async(t,e,n)=>{if(!p())throw new Error(`${b()}
+
+${x()}`);if(e.args.length===0)throw new Error("link_world_exec requires at least one CLI argument");const o=await k(e.args,e.timeout??w,n);if(o.exitCode&&o.exitCode!==0)throw new Error(o.output);return{content:[{type:"text",text:o.output}],details:{exitCode:o.exitCode,args:e.args}}},"execute")}}a(le,"createLinkWorldExecTool");function de(){return{name:"web_search",label:"web search",description:"High-level internet search through link-world. Prefer this for normal search tasks instead of constructing raw agent-reach argv yourself.",parameters:Q,guidance:"Use this for ordinary web search and lightweight research tasks. Use link_world_exec only when you need a lower-level agent-reach command that this tool does not model.",execute:a(async(t,e,n)=>{if(p()&&_().search){const s=["search",e.query];e.provider&&s.push("--provider",e.provider),typeof e.limit=="number"&&Number.isFinite(e.limit)&&s.push("--limit",String(e.limit));const c=await k(s,e.timeout??w,n);if(c.exitCode&&c.exitCode!==0)throw new Error(c.output);return{content:[{type:"text",text:c.output}],details:{exitCode:c.exitCode,args:s}}}const o=typeof e.limit=="number"&&Number.isFinite(e.limit)?e.limit:5;return{content:[{type:"text",text:await se(e.query,o,n)}],details:{fallback:"jina",query:e.query}}},"execute")}}a(de,"createWebSearchTool");function ue(){return{name:"web_fetch",label:"web fetch",description:"High-level URL fetch through link-world. Prefer this when the user already has a target page or endpoint and needs its content.",parameters:X,guidance:"Use this when the user provides a URL or when a prior search result should be fetched directly. If the task requires page interaction, use the browser tool family instead.",execute:a(async(t,e,n)=>{if(p()&&_().fetch){const r=["fetch",e.url];e.provider&&r.push("--provider",e.provider);const s=await k(r,e.timeout??w,n);if(s.exitCode&&s.exitCode!==0)throw new Error(s.output);return{content:[{type:"text",text:s.output}],details:{exitCode:s.exitCode,args:r}}}return{content:[{type:"text",text:await oe(e.url,n)}],details:{fallback:"jina",url:e.url}}},"execute")}}a(ue,"createWebFetchTool");function he(t){t.registerMessageRenderer(h,(e,n,o)=>{const r=new F(1,1,l=>o.bg("customMessageBg",l)),s=o.fg("customMessageLabel","\x1B[1m[link-world]\x1B[22m "),c=o.fg("customMessageText",String(e.content??""));r.addChild(new B(s+c,0,0)),r.addChild(new C(1));const d=new q;return d.addChild(new C(1)),d.addChild(r),d}),t.registerTool(ce()),t.registerTool(le()),t.registerTool(de()),t.registerTool(ue()),t.on("session_start",(e,n)=>{y()}),t.registerCommand("link-world",{description:"Set up or inspect internet access tools",getArgumentCompletions:a((e,n)=>{if(n&&n.tokenIndex>0)return null;const o=e.trim().toLowerCase(),r=Y.filter(s=>s.value.startsWith(o));return r.length>0?r:null},"getArgumentCompletions"),handler:a(async(e,n)=>{const o=(e.trim().split(/\s+/)[0]||"help").toLowerCase();if(o==="help"){const r=p()?"agent-reach":"native (Jina)";t.sendMessage({customType:h,content:["Link-world is Catui's built-in internet access integration point.","",`Mode: ${r}`,"","Commands:","/link-world status  - show whether agent-reach is installed and whether skills are bundled","/link-world doctor  - run `agent-reach doctor`","/link-world version - print the installed agent-reach version","/link-world install - show the bundled installation guide","/link-world workspace - show the project-local link-world workspace","","Tools: `web_search`, `web_fetch`, `link_world_admin`, `link_world_exec`"].join(`
+`),display:!0});return}if(o==="workspace"){t.sendMessage({customType:h,content:`Link-world workspace: ${D(y())}`,display:!0});return}if(o==="install"){t.sendMessage({customType:h,content:x(),display:!0});return}if(o==="status"){t.sendMessage({customType:h,content:b(),display:!0});return}if(o==="doctor"||o==="version"){if(!p()){t.sendMessage({customType:h,content:`${b()}
+
+${x()}`,display:!0});return}const r=await k(o==="doctor"?["doctor"]:["--version"],w);t.sendMessage({customType:h,content:r.output,display:!0});return}t.sendMessage({customType:h,content:"Usage: /link-world [help|status|doctor|version|install|workspace]",display:!0})},"handler")}),t.on("resources_discover",async e=>{const n=y(),o=[...new Set([G,A,L,...I(f(n,"domain-skills"))].filter(r=>g(r)))];return o.length?{skillPaths:o}:{}})}a(he,"linkWorldExtension");export{he as default};

package/dist/extensions/builtin/link-world/internet-search/internet-search.md

@@ -0,0 +1,65 @@
+---
+name: internet-search
+description: 当用户需要联网搜索最新信息、新闻、在线内容时使用此技能。包括搜索 Twitter、YouTube、Bilibili、知乎、微博、小红书等平台。
+---
+
+# 互联网搜索
+
+## 触发条件
+
+当用户请求以下内容时使用此技能：
+- 搜索互联网、联网搜索、网络搜索
+- 查找最新新闻、资讯、信息
+- 搜索 YouTube、Bilibili、Twitter、小红书、微博等内容
+- 查找某个话题的最新讨论
+- 获取实时信息或热点内容
+
+## 执行步骤
+
+### 步骤 1：检查 agent-reach 是否安装
+
+运行以下命令检查 agent-reach 是否可用：
+
+```bash
+agent-reach --version
+```
+
+### 步骤 2：如果未安装
+
+如果 agent-reach 命令不可用，告知用户需要先安装：
+
+> link-world (agent-reach) 未安装。请先运行 `/link-world` 安装 agent-reach 以支持联网搜索功能。
+
+### 步骤 3：如果已安装
+
+根据用户需求，使用 linkworld.md 中定义的工具进行搜索。
+
+**完整命令参考请查阅：extensions/link-world/linkworld.md**
+
+| 场景 | 推荐工具 | 示例命令 |
+|------|----------|----------|
+| 搜索 Twitter/X 推文 | xreach | `xreach search "关键词" --json` |
+| 解析 YouTube 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
+| 解析 Bilibili 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
+| 搜索 Reddit 帖子 | curl | `curl -s "https://reddit.com/r/xxx/search.json?q=关键词"` |
+| 搜索 GitHub 仓库 | gh | `gh search repos "关键词" --limit 5` |
+| 读取网页内容 | curl + Jina | `curl -s "https://r.jina.ai/网页URL"` |
+| 通用搜索引擎 | Exa (MCP) | `mcporter call 'exa.web_search_exa(query: "关键词", num_results: 5)'` |
+| 搜索小红书笔记 | 小红书 (MCP) | `mcporter call 'xiaohongshu.search_feeds(keyword: "关键词", limit: 5)'` |
+| 解析抖音视频 | 抖音 (MCP) | `mcporter call 'douyin.parse_douyin_video_info(url: "视频URL")'` |
+
+### 步骤 4：返回结果
+
+将搜索结果整理后返回给用户，包括：
+- 来源平台
+- 标题
+- 内容摘要
+- 链接
+
+## 注意事项
+
+1. 遵守平台的 API 使用规范
+2. 如需登录平台的搜索功能，确保用户已配置认证信息
+3. 如果搜索失败，尝试其他平台或告知用户可能的错误原因
+4. YouTube/Bilibili 需要提供具体的视频 URL，不能直接搜索关键词
+5. 详细的配置说明（Cookie、代理等）请参考 linkworld.md