@oh-my-pi/pi-coding-agent 3.20.1 → 3.24.0

package/examples/sdk/05-tools.ts

@@ -1,94 +0,0 @@
-/**
- * Tools Configuration
- *
- * Use built-in tool sets, individual tools, or add custom tools.
- *
- * IMPORTANT: When using a custom `cwd`, you must use the tool factory functions
- * (createCodingTools, createReadOnlyTools, createReadTool, etc.) to ensure
- * tools resolve paths relative to your cwd, not process.cwd().
- */
-
-import {
-	bashTool, // read, bash, edit, write - uses process.cwd()
-	type CustomTool,
-	createAgentSession,
-	createBashTool,
-	createCodingTools, // Factory: creates tools for specific cwd
-	createGrepTool,
-	createReadTool,
-	grepTool,
-	readOnlyTools, // read, grep, find, ls - uses process.cwd()
-	readTool,
-	SessionManager,
-} from "@oh-my-pi/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
-
-// Read-only mode (no edit/write) - uses process.cwd()
-await createAgentSession({
-	tools: readOnlyTools,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Read-only session created");
-
-// Custom tool selection - uses process.cwd()
-await createAgentSession({
-	tools: [readTool, bashTool, grepTool],
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Custom tools session created");
-
-// With custom cwd - MUST use factory functions!
-const customCwd = "/path/to/project";
-const customTools = await createCodingTools(customCwd);
-await createAgentSession({
-	cwd: customCwd,
-	tools: customTools, // Tools resolve paths relative to customCwd
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Custom cwd session created");
-
-// Or pick specific tools for custom cwd
-const customReadTool = await createReadTool(customCwd);
-const customBashTool = await createBashTool(customCwd);
-const customGrepTool = await createGrepTool(customCwd);
-await createAgentSession({
-	cwd: customCwd,
-	tools: [customReadTool, customBashTool, customGrepTool],
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Specific tools with custom cwd session created");
-
-// Inline custom tool (needs TypeBox schema)
-const weatherTool: CustomTool = {
-	name: "get_weather",
-	label: "Get Weather",
-	description: "Get current weather for a city",
-	parameters: Type.Object({
-		city: Type.String({ description: "City name" }),
-	}),
-	execute: async (_toolCallId, params) => ({
-		content: [{ type: "text", text: `Weather in ${(params as { city: string }).city}: 22°C, sunny` }],
-		details: {},
-	}),
-};
-
-const { session } = await createAgentSession({
-	customTools: [weatherTool],
-	sessionManager: SessionManager.inMemory(),
-});
-
-session.subscribe((event) => {
-	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-		process.stdout.write(event.assistantMessageEvent.delta);
-	}
-});
-
-await session.prompt("What's the weather in Tokyo?");
-console.log();
-
-// Merge with discovered tools from cwd/.omp/tools and ~/.omp/agent/tools:
-// const discovered = await discoverCustomTools();
-// customTools: [...discovered, { tool: myTool }]
-
-// Or add paths without replacing discovery:
-// additionalCustomToolPaths: ["/extra/tools"]

package/examples/sdk/12-full-control.ts

@@ -1,95 +0,0 @@
-/**
- * Full Control
- *
- * Replace everything - no discovery, explicit configuration.
- *
- * IMPORTANT: When providing `tools` with a custom `cwd`, use the tool factory
- * functions (createReadTool, createBashTool, etc.) to ensure tools resolve
- * paths relative to your cwd.
- */
-
-import { getModel } from "@oh-my-pi/pi-ai";
-import {
-	AuthStorage,
-	type CustomTool,
-	createAgentSession,
-	createBashTool,
-	createReadTool,
-	type ExtensionFactory,
-	ModelRegistry,
-	SessionManager,
-	SettingsManager,
-} from "@oh-my-pi/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
-
-// Custom auth storage location
-const authStorage = new AuthStorage("/tmp/my-agent/auth.json");
-
-// Runtime API key override (not persisted)
-if (process.env.MY_ANTHROPIC_KEY) {
-	authStorage.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
-}
-
-// Model registry with no custom models.json
-const modelRegistry = new ModelRegistry(authStorage);
-
-// Inline extension
-const auditHook: ExtensionFactory = (api) => {
-	api.on("tool_call", async (event) => {
-		console.log(`[Audit] ${event.toolName}`);
-		return undefined;
-	});
-};
-
-// Inline custom tool
-const statusTool: CustomTool = {
-	name: "status",
-	label: "Status",
-	description: "Get system status",
-	parameters: Type.Object({}),
-	execute: async () => ({
-		content: [{ type: "text", text: `Uptime: ${process.uptime()}s, Node: ${process.version}` }],
-		details: {},
-	}),
-};
-
-const model = getModel("anthropic", "claude-opus-4-5");
-if (!model) throw new Error("Model not found");
-
-// In-memory settings with overrides
-const settingsManager = SettingsManager.inMemory({
-	compaction: { enabled: false },
-	retry: { enabled: true, maxRetries: 2 },
-});
-
-// When using a custom cwd with explicit tools, use the factory functions
-const cwd = process.cwd();
-
-const { session } = await createAgentSession({
-	cwd,
-	agentDir: "/tmp/my-agent",
-	model,
-	thinkingLevel: "off",
-	authStorage,
-	modelRegistry,
-	systemPrompt: `You are a minimal assistant.
-Available: read, bash, status. Be concise.`,
-	// Use factory functions with the same cwd to ensure path resolution works correctly
-	tools: [createReadTool(cwd), createBashTool(cwd)],
-	customTools: [statusTool],
-	extensions: [auditHook],
-	skills: [],
-	contextFiles: [],
-	promptTemplates: [],
-	sessionManager: SessionManager.inMemory(),
-	settingsManager,
-});
-
-session.subscribe((event) => {
-	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-		process.stdout.write(event.assistantMessageEvent.delta);
-	}
-});
-
-await session.prompt("Get status and list files.");
-console.log();

package/src/prompts/browser.md

@@ -1,71 +0,0 @@
----
-name: browser
-description: Fetches and renders a single URL into clean, digestible text for extraction
-tools: bash
-model: claude-haiku-4-5, haiku, flash, mini
----
-
-You are a web content extraction specialist. Your job is to fetch a single URL, render it into clean readable text, and extract the specific information requested.
-
-=== CRITICAL: EXTRACTION ONLY ===
-This is a SINGLE-URL extraction task. You are STRICTLY PROHIBITED from:
-
-- Following links to other pages (unless explicitly part of the URL)
-- Performing web searches or investigations
-- Running commands that install software or change system state
-
-Your role is EXCLUSIVELY to fetch, render, and extract from ONE URL.
-
-=== HOW TO FETCH ===
-
-Use the `omp render-web` command to fetch and render the URL:
-
-```bash
-omp render-web "<URL>"
-```
-
-This command automatically:
-
-1. Checks for LLM-friendly endpoints (llms.txt, llms.md)
-2. Tries content negotiation for markdown/plain text
-3. Looks for page-specific alternate feeds (RSS, Atom)
-4. Falls back to lynx for HTML→text rendering
-5. Pretty-prints JSON/XML if applicable
-6. Reports any issues (JS-gated pages, truncation, etc.)
-
-Options:
-
-- `--raw` — Output only the content, no metadata headers
-- `--json` — Structured JSON output with metadata
-- `--timeout <seconds>` — Request timeout (default: 20)
-
-=== WORKFLOW ===
-
-1. Run `omp render-web "<URL>"` to fetch the page
-2. Review the output — check the "Method" and "Notes" fields for any issues
-3. If the page appears JS-gated or incomplete, note this in your response
-4. Extract the specific information requested by the caller
-5. Format your findings clearly
-
-=== OUTPUT FORMAT ===
-
-Always structure your response as:
-
-## URL
-
-The final URL after redirects.
-
-## Metadata
-
-```
-Content-Type: <type>
-Method: <how it was rendered>
-```
-
-## Extracted Information
-
-The specific information requested by the caller, clearly formatted.
-
-## Notes
-
-Any issues encountered (JS-gated, paywall, truncated, etc).