@oh-my-pi/pi-coding-agent 0.1.0

package/examples/sdk/README.md

@@ -0,0 +1,154 @@
+# SDK Examples
+
+Programmatic usage of omp-coding-agent via `createAgentSession()`.
+
+## Examples
+
+| File                       | Description                                    |
+| -------------------------- | ---------------------------------------------- |
+| `01-minimal.ts`            | Simplest usage with all defaults               |
+| `02-custom-model.ts`       | Select model and thinking level                |
+| `03-custom-prompt.ts`      | Replace or modify system prompt                |
+| `04-skills.ts`             | Discover, filter, or replace skills            |
+| `05-tools.ts`              | Built-in tools, custom tools                   |
+| `06-hooks.ts`              | Logging, blocking, result modification         |
+| `07-context-files.ts`      | AGENTS.md context files                        |
+| `08-slash-commands.ts`     | File-based slash commands                      |
+| `09-api-keys-and-oauth.ts` | API key resolution, OAuth config               |
+| `10-settings.ts`           | Override compaction, retry, terminal settings  |
+| `11-sessions.ts`           | In-memory, persistent, continue, list sessions |
+| `12-full-control.ts`       | Replace everything, no discovery               |
+
+## Running
+
+```bash
+cd packages/coding-agent
+npx tsx examples/sdk/01-minimal.ts
+```
+
+## Quick Reference
+
+```typescript
+import { getModel } from "@oh-my-pi/pi-ai";
+import {
+	AuthStorage,
+	createAgentSession,
+	discoverAuthStorage,
+	discoverModels,
+	discoverSkills,
+	discoverHooks,
+	discoverCustomTools,
+	discoverContextFiles,
+	discoverSlashCommands,
+	loadSettings,
+	buildSystemPrompt,
+	ModelRegistry,
+	SessionManager,
+	codingTools,
+	readOnlyTools,
+	readTool,
+	bashTool,
+	editTool,
+	writeTool,
+} from "@oh-my-pi/pi-coding-agent";
+
+// Auth and models setup
+const authStorage = discoverAuthStorage();
+const modelRegistry = discoverModels(authStorage);
+
+// Minimal
+const { session } = await createAgentSession({ authStorage, modelRegistry });
+
+// Custom model
+const model = getModel("anthropic", "claude-opus-4-5");
+const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
+
+// Modify prompt
+const { session } = await createAgentSession({
+	systemPrompt: (defaultPrompt) => defaultPrompt + "\n\nBe concise.",
+	authStorage,
+	modelRegistry,
+});
+
+// Read-only
+const { session } = await createAgentSession({ tools: readOnlyTools, authStorage, modelRegistry });
+
+// In-memory
+const { session } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry,
+});
+
+// Full control
+const customAuth = new AuthStorage("/my/app/auth.json");
+customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+const customRegistry = new ModelRegistry(customAuth);
+
+const { session } = await createAgentSession({
+	model,
+	authStorage: customAuth,
+	modelRegistry: customRegistry,
+	systemPrompt: "You are helpful.",
+	tools: [readTool, bashTool],
+	customTools: [{ tool: myTool }],
+	hooks: [{ factory: myHook }],
+	skills: [],
+	contextFiles: [],
+	slashCommands: [],
+	sessionManager: SessionManager.inMemory(),
+});
+
+// Run prompts
+session.subscribe((event) => {
+	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+		process.stdout.write(event.assistantMessageEvent.delta);
+	}
+});
+await session.prompt("Hello");
+```
+
+## Options
+
+| Option                      | Default                       | Description                       |
+| --------------------------- | ----------------------------- | --------------------------------- |
+| `authStorage`               | `discoverAuthStorage()`       | Credential storage                |
+| `modelRegistry`             | `discoverModels(authStorage)` | Model registry                    |
+| `cwd`                       | `process.cwd()`               | Working directory                 |
+| `agentDir`                  | `~/.omp/agent`                | Config directory                  |
+| `model`                     | From settings/first available | Model to use                      |
+| `thinkingLevel`             | From settings/"off"           | off, low, medium, high            |
+| `systemPrompt`              | Discovered                    | String or `(default) => modified` |
+| `tools`                     | `codingTools`                 | Built-in tools                    |
+| `customTools`               | Discovered                    | Replaces discovery                |
+| `additionalCustomToolPaths` | `[]`                          | Merge with discovery              |
+| `hooks`                     | Discovered                    | Replaces discovery                |
+| `additionalHookPaths`       | `[]`                          | Merge with discovery              |
+| `skills`                    | Discovered                    | Skills for prompt                 |
+| `contextFiles`              | Discovered                    | AGENTS.md files                   |
+| `slashCommands`             | Discovered                    | File commands                     |
+| `sessionManager`            | `SessionManager.create(cwd)`  | Persistence                       |
+| `settingsManager`           | From agentDir                 | Settings overrides                |
+
+## Events
+
+```typescript
+session.subscribe((event) => {
+	switch (event.type) {
+		case "message_update":
+			if (event.assistantMessageEvent.type === "text_delta") {
+				process.stdout.write(event.assistantMessageEvent.delta);
+			}
+			break;
+		case "tool_execution_start":
+			console.log(`Tool: ${event.toolName}`);
+			break;
+		case "tool_execution_end":
+			console.log(`Result: ${event.result}`);
+			break;
+		case "agent_end":
+			console.log("Done");
+			break;
+	}
+});
+```

package/package.json

@@ -0,0 +1,89 @@
+{
+	"name": "@oh-my-pi/pi-coding-agent",
+	"version": "0.1.0",
+	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
+	"type": "module",
+	"ompConfig": {
+		"name": "omp",
+		"configDir": ".omp"
+	},
+	"bin": {
+		"omp": "src/cli.ts"
+	},
+	"main": "./src/index.ts",
+	"types": "./src/index.ts",
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"import": "./src/index.ts"
+		},
+		"./hooks": {
+			"types": "./src/core/hooks/index.ts",
+			"import": "./src/core/hooks/index.ts"
+		}
+	},
+	"files": [
+		"src",
+		"docs",
+		"examples",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"check": "tsgo --noEmit",
+		"clean": "rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json && chmod +x dist/cli.js",
+		"build:binary": "bun build --compile ./src/cli.ts --outfile dist/omp",
+		"generate-template": "bun scripts/generate-template.ts",
+		"postinstall": "[ -f scripts/generate-template.ts ] && bun run generate-template || true",
+		"test": "bun test",
+		"prepublishOnly": "bun run generate-template && bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@oh-my-pi/pi-agent-core": "0.1.0",
+		"@oh-my-pi/pi-ai": "0.1.0",
+		"@oh-my-pi/pi-tui": "0.1.0",
+		"@sinclair/typebox": "^0.34.46",
+		"ajv": "^8.17.1",
+		"chalk": "^5.5.0",
+		"cli-highlight": "^2.1.11",
+		"diff": "^8.0.2",
+		"file-type": "^21.1.1",
+		"glob": "^11.0.3",
+		"highlight.js": "^11.11.1",
+		"marked": "^15.0.12",
+		"minimatch": "^10.1.1",
+		"nanoid": "^5.1.6",
+		"ndjson": "^2.0.0",
+		"node-html-parser": "^6.1.13",
+		"smol-toml": "^1.6.0",
+		"strip-ansi": "^7.1.2",
+		"sharp": "^0.34.2",
+		"winston": "^3.17.0",
+		"winston-daily-rotate-file": "^5.0.0",
+		"yaml": "^2.8.2"
+	},
+	"devDependencies": {
+		"@types/diff": "^7.0.2",
+		"@types/ndjson": "^2.0.4",
+		"@types/node": "^24.3.0",
+		"vitest": "^3.2.4"
+	},
+	"keywords": [
+		"coding-agent",
+		"ai",
+		"llm",
+		"cli",
+		"tui",
+		"agent"
+	],
+	"author": "Mario Zechner",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/can1357/oh-my-pi.git",
+		"directory": "packages/coding-agent"
+	},
+	"engines": {
+		"bun": ">=1.0.0"
+	}
+}

package/src/bun-imports.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Type declarations for Bun's import attributes.
+ * These allow importing non-JS files as text at build time.
+ */
+
+// Markdown files imported as text
+declare module "*.md" {
+	const content: string;
+	export default content;
+}
+
+// Text files imported as text
+declare module "*.txt" {
+	const content: string;
+	export default content;
+}

package/src/capability/context-file.ts

@@ -0,0 +1,40 @@
+/**
+ * Context Files Capability
+ *
+ * System instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) that provide
+ * persistent guidance to the agent.
+ */
+
+import { defineCapability } from "./index";
+import type { SourceMeta } from "./types";
+
+/**
+ * A context file that provides persistent instructions to the agent.
+ */
+export interface ContextFile {
+	/** Absolute path to the file */
+	path: string;
+	/** File content */
+	content: string;
+	/** Which level this came from */
+	level: "user" | "project";
+	/** Distance from cwd (0 = in cwd, 1 = parent, etc.) for project files */
+	depth?: number;
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const contextFileCapability = defineCapability<ContextFile>({
+	id: "context-files",
+	displayName: "Context Files",
+	description: "Persistent instruction files (CLAUDE.md, AGENTS.md, etc.) that guide agent behavior",
+	// Deduplicate by level: one user-level file, one project-level file
+	// Higher-priority providers shadow lower-priority ones at the same scope
+	key: (file) => file.level,
+	validate: (file) => {
+		if (!file.path) return "Missing path";
+		if (file.content === undefined) return "Missing content";
+		if (file.level !== "user" && file.level !== "project") return "Invalid level: must be 'user' or 'project'";
+		return undefined;
+	},
+});

package/src/capability/extension.ts

@@ -0,0 +1,48 @@
+/**
+ * Extensions Capability
+ *
+ * Gemini-style extensions that provide MCP servers, tools, and context.
+ */
+
+import { defineCapability } from "./index";
+import type { MCPServer } from "./mcp";
+import type { SourceMeta } from "./types";
+
+/**
+ * Extension manifest structure.
+ */
+export interface ExtensionManifest {
+	name?: string;
+	description?: string;
+	mcpServers?: Record<string, Omit<MCPServer, "name" | "_source">>;
+	tools?: unknown[];
+	context?: unknown;
+}
+
+/**
+ * A loaded extension.
+ */
+export interface Extension {
+	/** Extension name (from manifest.name or directory name) */
+	name: string;
+	/** Absolute path to extension directory */
+	path: string;
+	/** Parsed manifest data */
+	manifest: ExtensionManifest;
+	/** Source level */
+	level: "user" | "project";
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const extensionCapability = defineCapability<Extension>({
+	id: "extensions",
+	displayName: "Extensions",
+	description: "Gemini-style extensions providing MCP servers, tools, and context",
+	key: (ext) => ext.name,
+	validate: (ext) => {
+		if (!ext.name) return "Missing extension name";
+		if (!ext.path) return "Missing extension path";
+		return undefined;
+	},
+});

package/src/capability/hook.ts

@@ -0,0 +1,40 @@
+/**
+ * Hooks Capability
+ *
+ * Pre/post tool execution hooks defined as shell scripts.
+ */
+
+import { defineCapability } from "./index";
+import type { SourceMeta } from "./types";
+
+/**
+ * A hook script.
+ */
+export interface Hook {
+	/** Hook name (filename without extension) */
+	name: string;
+	/** Absolute path to hook file */
+	path: string;
+	/** Hook type (pre/post) and associated tool */
+	type: "pre" | "post";
+	/** Tool this hook applies to, or "*" for all */
+	tool: string;
+	/** Source level */
+	level: "user" | "project";
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const hookCapability = defineCapability<Hook>({
+	id: "hooks",
+	displayName: "Hooks",
+	description: "Pre/post tool execution hooks",
+	key: (hook) => `${hook.type}:${hook.tool}:${hook.name}`,
+	validate: (hook) => {
+		if (!hook.name) return "Missing name";
+		if (!hook.path) return "Missing path";
+		if (hook.type !== "pre" && hook.type !== "post") return "Invalid type (must be 'pre' or 'post')";
+		if (!hook.tool) return "Missing tool";
+		return undefined;
+	},
+});