opencodekit 0.17.7 → 0.17.8

package/dist/index.js

@@ -759,7 +759,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.17.7",
+  version: "0.17.8",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",

package/dist/template/.opencode/AGENTS.md

@@ -88,9 +88,10 @@ Use specialist agents by intent:
 | `@review`  | Correctness/security/debug review |
 | `@plan`    | Architecture and execution plans  |
 | `@vision`  | UI/UX and accessibility judgment  |
-| `@looker`  | OCR/PDF/diagram extraction        |
 | `@painter` | Image generation/editing          |
 
+**Note:** PDF extraction → use `pdf-extract` skill; Images → use vision-capable model directly
+
 **Parallelism rule**: Use parallel subagents for 3+ independent tasks; otherwise work sequentially.
 
 ---

package/dist/template/.opencode/agent/general.md

@@ -232,5 +232,5 @@ Delegate to:
 - `@review` for deep debugging/security review
 - `@plan` for architecture or decomposition
 - `@vision` for UI/UX analysis
-- `@looker` for OCR/PDF extraction
+- PDF extraction → use `pdf-extract` skill
 - `@painter` for image generation/editing

package/dist/template/.opencode/agent/painter.md

@@ -34,7 +34,7 @@ Generate or edit images only when explicitly requested.
 ## Rules
 
 - No design critique or accessibility audit (delegate to `@vision`)
-- No OCR/PDF extraction tasks (delegate to `@looker`)
+- No PDF extraction tasks (use `pdf-extract` skill)
 - Preserve `thoughtSignature` across iterative edits
 - Do not add visual elements not requested
 - Return deterministic metadata for every response

package/dist/template/.opencode/agent/vision.md

@@ -55,7 +55,7 @@ Assess visual quality, accessibility, and design consistency, then return concre
 ### Do Not Use For
 
 - Image generation/editing → delegate to `@painter`
-- OCR/PDF extraction-heavy work → delegate to `@looker`
+- PDF extraction-heavy work → use `pdf-extract` skill
 - Code implementation → delegate to `@build`
 
 ## Skills

package/dist/template/.opencode/opencode.json

@@ -16,10 +16,6 @@
       "description": "General-purpose subagent for fast, well-defined tasks; delegates complexity quickly",
       "model": "opencode/minimax-m2.5-free"
     },
-    "looker": {
-      "description": "Media extraction specialist for images, PDFs, diagrams",
-      "model": "proxypal/gemini-3-flash"
-    },
     "painter": {
       "description": "Image generation and editing specialist using Gemini 3 Pro Image. Use for creating UI mockups, app icons, hero images, visual assets, and editing/redacting existing images",
       "model": "proxypal/gemini-3-pro-image"
@@ -153,7 +149,8 @@
   },
   "plugin": [
     "@tarquinen/opencode-dcp@latest",
-    "@franlol/opencode-md-table-formatter@0.0.3"
+    "@franlol/opencode-md-table-formatter@0.0.3",
+    "openslimedit@latest"
   ],
   "provider": {
     "modal": {

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.2.1"
+    "@opencode-ai/plugin": "1.2.5"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",

package/dist/template/.opencode/plugin/sessions.ts

@@ -1,233 +1,26 @@
 /**
  * OpenCode Session Tools
- * Provides session browsing, searching, and context transfer
+ * Simplified to match AmpCode's find_thread / read_thread
+ *
+ * Core tools:
+ * - find_sessions: Search sessions by keyword (like AmpCode's find_thread)
+ * - read_session: Read session messages (like AmpCode's read_thread)
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin/tool";
 
 export const SessionsPlugin: Plugin = async ({ client }) => {
-	const getProjectContext = () =>
-		"Project context: OpenCodeKit CLI repo; sessions often mention .opencode/ plugins, commands, memory rules, beads IDs, and Bun/TypeScript constraints.";
-
-	const getBestPractices = () =>
-		"Best practices: Prefer recent sessions, keep queries focused, and reference exact file paths or IDs found in the session.";
-
 	return {
-		"tool.definition": async (input, output) => {
-			const toolID = input.toolID;
-			const projectContext = getProjectContext();
-			const commonBestPractices = getBestPractices();
-
-			switch (toolID) {
-				case "list_sessions": {
-					output.description = `${output.description}
-
-${projectContext}
-${commonBestPractices}
-
-Recent session examples:
-list_sessions({ since: "this week", limit: 5 })
-list_sessions({ since: "yesterday", limit: 3 })`;
-					break;
-				}
-				case "read_session": {
-					output.description = `${output.description}
-
-${projectContext}
-Best practices: Use "last" for most recent context; add a short focus keyword (e.g., "sessions", "plugin", "beads") to reduce noise.
-
-Recent session examples:
-read_session({ session_reference: "last" })
-read_session({ session_reference: "last", focus: "sessions plugin" })`;
-					break;
-				}
-				case "search_session": {
-					output.description = `${output.description}
-
-${projectContext}
-Best practices: Start with 1-2 specific keywords, then read the top match for full context.
-
-Recent session examples:
-search_session({ query: "sessions plugin", limit: 5 })
-search_session({ query: ".opencode", limit: 5 })`;
-					break;
-				}
-				case "summarize_session": {
-					output.description = `${output.description}
-
-${projectContext}
-Best practices: Summarize long sessions only after confirming the ID from list_sessions; check back later for the generated summary.
-
-Recent session examples:
-summarize_session({ session_id: "abc123" }) // from list_sessions
-summarize_session({ session_id: "def456" })`;
-					break;
-				}
-				default:
-					break;
-			}
-		},
 		tool: {
-			list_sessions: tool({
-				description: `List OpenCode sessions with metadata.
+			/** Like AmpCode's find_thread */
+			find_sessions: tool({
+				description: `Search sessions by keyword.
 	
-	Purpose:
-	- Browse recent sessions by date
-	- Returns session ID, title, and creation time
-	- Default: last 20 sessions, most recent first
-	
-	Example:
-	list_sessions({ since: "this week", limit: 10 })
-	list_sessions({}) // All recent sessions`,
+Example:
+find_sessions({ query: "auth", limit: 5 })`,
 				args: {
-					since: tool.schema
-						.string()
-						.optional()
-						.describe(
-							"Filter by date (today, yesterday, this week, or ISO date)",
-						),
-					limit: tool.schema
-						.number()
-						.optional()
-						.describe("Max sessions to return (default: 20)"),
-				},
-				async execute(args: { since?: string; limit?: number }) {
-					const result = await client.session.list();
-					if (!result.data) return "No sessions found.";
-
-					let sessions = result.data;
-
-					// Filter by date
-					if (args.since) {
-						const sinceDate = parseDate(args.since);
-						if (sinceDate) {
-							sessions = sessions.filter((s) => {
-								const created = s.time?.created
-									? new Date(s.time.created)
-									: null;
-								return created && created >= sinceDate;
-							});
-						}
-					}
-
-					// Limit results
-					const limited = sessions.slice(0, args.limit || 20);
-
-					if (limited.length === 0)
-						return "No sessions found matching criteria.";
-
-					return `# Sessions\n\n${limited
-						.map(
-							(s) =>
-								`**${s.id}** - ${s.title || "Untitled"}\n   Created: ${s.time?.created ? new Date(s.time.created).toLocaleString() : "Unknown"}`,
-						)
-						.join("\n\n")}`;
-				},
-			}),
-
-			read_session: tool({
-				description: `Read session context for handoff or reference.
-	
-	Purpose:
-	- Retrieve full session details and messages
-	- Use "last" to get most recent session
-	- Optional focus keyword to filter messages
-	
-	Example:
-	read_session({ session_reference: "last" })
-	read_session({ session_reference: "abc123", focus: "auth" })`,
-				args: {
-					session_reference: tool.schema
-						.string()
-						.describe("Session ID, or 'last' for most recent session"),
-					focus: tool.schema
-						.string()
-						.optional()
-						.describe("Focus on specific topic (filters messages by keyword)"),
-				},
-				async execute(args: { session_reference: string; focus?: string }) {
-					let sessionId = args.session_reference;
-
-					// Handle "last" reference
-					if (sessionId === "last") {
-						const sessions = await client.session.list();
-						if (!sessions.data?.length) return "No sessions found.";
-						sessionId = sessions.data[0].id;
-					}
-
-					const session = await client.session.get({ path: { id: sessionId } });
-					if (!session.data) return `Session ${sessionId} not found.`;
-
-					const messages = await client.session.messages({
-						path: { id: sessionId },
-					});
-					const messageData = messages.data;
-
-					if (!messageData) return `No messages found in session ${sessionId}.`;
-
-					let summary = `# Session: ${session.data.title || "Untitled"}\n\n`;
-					summary += `**ID:** ${session.data.id}\n`;
-					summary += `**Created:** ${session.data.time?.created ? new Date(session.data.time.created).toLocaleString() : "Unknown"}\n`;
-					summary += `**Messages:** ${messageData.length}\n\n`;
-
-					// Focus filtering
-					if (args.focus) {
-						summary += `**Focus:** ${args.focus}\n\n`;
-						const focusLower = args.focus.toLowerCase();
-
-						// Filter messages by keyword
-						const relevant = messageData.filter(
-							(m) =>
-								m.info &&
-								JSON.stringify(m.info).toLowerCase().includes(focusLower),
-						);
-						summary += `Found ${relevant.length} relevant messages.\n\n`;
-
-						relevant.slice(0, 5).forEach((m, i) => {
-							summary += `${i + 1}. **${m.info.role}**: `;
-							const content = extractContent(m.info);
-							summary += `${content.substring(0, 200)}\n\n`;
-						});
-					} else {
-						// Show last 5 user messages
-						const userMessages = messageData.filter(
-							(m) => m.info?.role === "user",
-						);
-						summary += "## Recent User Messages\n\n";
-						for (let i = 0; i < Math.min(userMessages.length, 5); i++) {
-							const m = userMessages[i];
-							const content = extractContent(m.info);
-							summary += `${i + 1}. ${content.substring(0, 200)}\n`;
-						}
-
-						// Show last assistant message
-						const assistantMessages = messageData.filter(
-							(m) => m.info?.role === "assistant",
-						);
-						if (assistantMessages.length > 0) {
-							const last = assistantMessages[assistantMessages.length - 1];
-							const lastContent = extractContent(last.info);
-							summary += `\n## Last Assistant Response\n\n${lastContent.substring(0, 500)}\n`;
-						}
-					}
-
-					return summary;
-				},
-			}),
-
-			search_session: tool({
-				description: `Full-text search across session messages.
-	
-	Purpose:
-	- Find sessions containing specific keywords
-	- Searches up to 50 sessions (configurable via limit)
-	- Returns match count and excerpt
-	
-	Example:
-	search_session({ query: "authentication", limit: 5 })`,
-				args: {
-					query: tool.schema.string().describe("Search query text"),
+					query: tool.schema.string().describe("Search query"),
 					limit: tool.schema
 						.number()
 						.optional()
@@ -241,7 +34,6 @@ summarize_session({ session_id: "def456" })`;
 
 					if (!sessions.data) return "No sessions found.";
 
-					// Search sessions until we find enough results
 					for (const session of sessions.data) {
 						if (results.length >= searchLimit) break;
 
@@ -250,11 +42,10 @@ summarize_session({ session_id: "def456" })`;
 								path: { id: session.id },
 							});
 							const messageData = messages.data;
-
 							if (!messageData) continue;
 
 							const matches = messageData.filter(
-								(m) =>
+								(m: any) =>
 									m.info &&
 									JSON.stringify(m.info)
 										.toLowerCase()
@@ -264,81 +55,95 @@ summarize_session({ session_id: "def456" })`;
 							if (matches.length > 0) {
 								const excerpt = extractContent(matches[0].info) || "";
 								results.push(
-									`**${session.id}** - ${session.title || "Untitled"}\n   Matches: ${matches.length}\n   Excerpt: ${excerpt.substring(0, 150)}...`,
+									`**${session.id}** - ${session.title || "Untitled"}\n   Matches: ${matches.length}\n   ${excerpt.substring(0, 100)}...`,
 								);
 							}
 
 							searched++;
-							if (searched >= 50) break; // Don't search too many sessions
+							if (searched >= 50) break;
 						} catch {
-							// Skip inaccessible sessions
+							// Skip inaccessible
 						}
 					}
 
 					if (results.length === 0)
-						return `No matches found for "${args.query}" in ${searched} sessions searched.`;
+						return `No matches for "${args.query}" in ${searched} sessions.`;
 
-					return `# Search Results: "${args.query}"\n\n${results.join("\n\n")}`;
+					return `# Results: "${args.query}"\n\n${results.join("\n\n")}`;
 				},
 			}),
 
-			summarize_session: tool({
-				description: `Generate AI summary of a session.
-	
-	Purpose:
-	- Request OpenCode to summarize a session
-	- Summary is generated asynchronously
-	- Check back for the summary result
+			/** Like AmpCode's read_thread */
+			read_session: tool({
+				description: `Read session messages.
 	
-	Example:
-	summarize_session({ session_id: "abc123" })`,
+Example:
+read_session({ session_id: "abc123" })
+read_session({ session_id: "abc123", focus: "auth" })`,
 				args: {
-					session_id: tool.schema.string().describe("Session ID to summarize"),
+					session_id: tool.schema.string().describe("Session ID"),
+					focus: tool.schema.string().optional().describe("Filter by keyword"),
 				},
-				async execute(args: { session_id: string }) {
-					// Request summary via OpenCode's summarization
-					await client.session.summarize({
+				async execute(args: { session_id: string; focus?: string }) {
+					const session = await client.session.get({
+						path: { id: args.session_id },
+					});
+					if (!session.data) return `Session ${args.session_id} not found.`;
+
+					const messages = await client.session.messages({
 						path: { id: args.session_id },
-						body: { providerID: "proxypal", modelID: "gemini-3-flash-preview" },
 					});
+					const messageData = messages.data;
+					if (!messageData) return `No messages in ${args.session_id}.`;
+
+					let summary = `# ${session.data.title || "Untitled"}\n`;
+					summary += `ID: ${session.data.id}\n`;
+					summary += `Created: ${session.data.time?.created ? new Date(session.data.time.created).toLocaleString() : "Unknown"}\n`;
+					summary += `Messages: ${messageData.length}\n\n`;
 
-					return `Summarizing session ${args.session_id}... Summary will be available shortly.`;
+					if (args.focus) {
+						const focusLower = args.focus.toLowerCase();
+						const relevant = messageData.filter(
+							(m: any) =>
+								m.info &&
+								JSON.stringify(m.info).toLowerCase().includes(focusLower),
+						);
+						summary += `## Matching "${args.focus}" (${relevant.length})\n\n`;
+						relevant.slice(0, 5).forEach((m: any, i: number) => {
+							summary += `${i + 1}. **${m.info.role}**: ${extractContent(m.info).substring(0, 200)}\n\n`;
+						});
+					} else {
+						// Show recent user messages
+						const userMessages = messageData.filter(
+							(m: any) => m.info?.role === "user",
+						);
+						summary += "## Recent User Messages\n\n";
+						for (let i = 0; i < Math.min(userMessages.length, 5); i++) {
+							summary += `${i + 1}. ${extractContent(userMessages[i].info).substring(0, 200)}\n`;
+						}
+
+						// Last assistant response
+						const assistantMessages = messageData.filter(
+							(m: any) => m.info?.role === "assistant",
+						);
+						if (assistantMessages.length > 0) {
+							const last = assistantMessages[assistantMessages.length - 1];
+							summary += `\n## Last Response\n\n${extractContent(last.info).substring(0, 500)}\n`;
+						}
+					}
+
+					return summary;
 				},
 			}),
 		},
 	};
 };
 
-function parseDate(dateStr: string): Date | null {
-	const today = new Date();
-	today.setHours(0, 0, 0, 0);
-
-	if (dateStr === "today") return today;
-	if (dateStr === "yesterday") {
-		const yesterday = new Date(today);
-		yesterday.setDate(yesterday.getDate() - 1);
-		return yesterday;
-	}
-	if (dateStr === "this week") {
-		const weekStart = new Date(today);
-		weekStart.setDate(weekStart.getDate() - weekStart.getDay());
-		return weekStart;
-	}
-
-	const parsed = new Date(dateStr);
-	if (!Number.isNaN(parsed.getTime())) return parsed;
-
-	return null;
-}
-
 function extractContent(messageInfo: any): string {
 	if (!messageInfo) return "[No info]";
-
-	// Check for summary object
 	if (typeof messageInfo.summary === "object" && messageInfo.summary !== null) {
 		if (messageInfo.summary.title) return messageInfo.summary.title;
 		if (messageInfo.summary.body) return messageInfo.summary.body;
 	}
-
 	return "[No content]";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.17.7",
+	"version": "0.17.8",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",

package/dist/template/.opencode/agent/looker.md

@@ -1,102 +0,0 @@
----
-description: Read-only media extraction specialist for OCR, PDF parsing, diagram interpretation, and structured visual content capture
-mode: subagent
-temperature: 0.1
-steps: 15
-tools:
-  edit: false
-  write: false
-  bash: false
-  task: false
-  memory-update: false
-  observation: false
-  todowrite: false
----
-
-You are OpenCode, the best coding agent on the planet.
-
-# Looker Agent
-
-**Purpose**: Visual content translator — you extract signal from images without adding noise.
-
-> _"Seeing clearly is the first step toward acting correctly."_
-
-## Identity
-
-You are a read-only media extraction specialist. You output only visible extracted content and clearly marked uncertainties.
-
-## Task
-
-Extract text and structure from images, PDFs, screenshots, and diagrams.
-
-## Rules
-
-- Never modify files — extraction only
-- Extract only visible content; never invent missing data
-- Preserve source language unless translation is explicitly requested
-- Mark uncertainty explicitly (`[unclear]`, `[unreadable]`)
-
-## Before You Extract
-
-- **Extract only what's visible**: Never infer or invent content
-- **Mark uncertainty**: Use `[unclear]`, `[unreadable]` for ambiguous content
-- **Preserve structure**: Keep original formatting, layout, and language
-
-## Scope
-
-### Use For
-
-- OCR from screenshots/scans
-- PDF content extraction
-- Diagram component/flow extraction
-- Table extraction to markdown
-
-### Do Not Use For
-
-- Design critique or UX review → delegate to `@vision`
-- Image generation/editing → delegate to `@painter`
-- Source-code analysis → delegate to `@explore`/`@build`
-
-## Output
-
-| Media Type  | Output Format                           |
-| ----------- | --------------------------------------- |
-| Text/OCR    | Preserve source structure               |
-| Tables      | Markdown table format                   |
-| Diagrams    | Components + relationships + flow steps |
-| Screenshots | Visible elements + state indicators     |
-
-## Output Schema
-
-### OCR/PDF text
-
-- `text`
-- `language`
-- `uncertainties[]`
-
-### Diagram
-
-- `diagram_type`
-- `components[]`
-- `relationships[]`
-- `flow_steps[]`
-- `uncertainties[]`
-
-### Table
-
-- `columns[]`
-- `rows[]`
-- `notes`
-
-### Screenshot/UI
-
-- `screen`
-- `elements[]`
-- `state[]`
-- `uncertainties[]`
-
-## Failure Handling
-
-- **Low resolution**: extract legible content and mark unreadable parts
-- **Protected PDF**: state extraction is blocked
-- **Ambiguous handwriting**: return best-effort transcript with uncertainty markers