@codeany/open-agent-sdk 0.2.1 → 0.2.3

package/src/sdk-mcp-server.ts

@@ -1,78 +0,0 @@
-/**
- * In-Process MCP Server
- *
- * createSdkMcpServer() creates an in-process MCP server from tool() definitions.
- * Compatible with open-agent-sdk's createSdkMcpServer().
- *
- * Usage:
- *   import { tool, createSdkMcpServer } from 'open-agent-sdk'
- *   import { z } from 'zod'
- *
- *   const weatherTool = tool('get_weather', 'Get weather', { city: z.string() },
- *     async ({ city }) => ({ content: [{ type: 'text', text: `22°C in ${city}` }] })
- *   )
- *
- *   const server = createSdkMcpServer({
- *     name: 'weather',
- *     tools: [weatherTool],
- *   })
- *
- *   // Use as MCP server config:
- *   const agent = createAgent({
- *     mcpServers: { weather: server },
- *   })
- */
-
-import type { SdkMcpToolDefinition } from './tool-helper.js'
-import { sdkToolToToolDefinition } from './tool-helper.js'
-import type { ToolDefinition, McpServerConfig } from './types.js'
-
-/**
- * SDK MCP server config that includes the in-process server instance.
- */
-export interface McpSdkServerConfig {
-  type: 'sdk'
-  name: string
-  version: string
-  tools: ToolDefinition[]
-  _sdkTools: SdkMcpToolDefinition<any>[]
-}
-
-/**
- * Create an in-process MCP server from tool definitions.
- *
- * The server runs in the same process as the agent, avoiding
- * subprocess overhead. Tools are directly callable.
- */
-export function createSdkMcpServer(options: {
-  name: string
-  version?: string
-  tools?: SdkMcpToolDefinition<any>[]
-}): McpSdkServerConfig {
-  const sdkTools = options.tools || []
-
-  // Convert SDK tools to engine-compatible tool definitions
-  // Prefix tool names with mcp__{server_name}__ for namespace isolation
-  const toolDefinitions: ToolDefinition[] = sdkTools.map((sdkTool) => {
-    const toolDef = sdkToolToToolDefinition(sdkTool)
-    return {
-      ...toolDef,
-      name: `mcp__${options.name}__${sdkTool.name}`,
-    }
-  })
-
-  return {
-    type: 'sdk',
-    name: options.name,
-    version: options.version || '1.0.0',
-    tools: toolDefinitions,
-    _sdkTools: sdkTools,
-  }
-}
-
-/**
- * Check if a server config is an in-process SDK server.
- */
-export function isSdkServerConfig(config: any): config is McpSdkServerConfig {
-  return config?.type === 'sdk' && Array.isArray(config.tools)
-}

package/src/session.ts

@@ -1,227 +0,0 @@
-/**
- * Session Storage & Management
- *
- * Persists conversation transcripts to disk for resumption.
- * Manages session lifecycle (create, resume, list, fork).
- */
-
-import { readFile, writeFile, mkdir, readdir, stat } from 'fs/promises'
-import { join } from 'path'
-import type { Message } from './types.js'
-import type { NormalizedMessageParam } from './providers/types.js'
-
-/**
- * Session metadata.
- */
-export interface SessionMetadata {
-  id: string
-  cwd: string
-  model: string
-  createdAt: string
-  updatedAt: string
-  messageCount: number
-  summary?: string
-}
-
-/**
- * Session data on disk.
- */
-export interface SessionData {
-  metadata: SessionMetadata
-  messages: NormalizedMessageParam[]
-}
-
-/**
- * Get the sessions directory path.
- */
-function getSessionsDir(): string {
-  const home = process.env.HOME || process.env.USERPROFILE || '/tmp'
-  return join(home, '.open-agent-sdk', 'sessions')
-}
-
-/**
- * Get the path for a specific session.
- */
-function getSessionPath(sessionId: string): string {
-  return join(getSessionsDir(), sessionId)
-}
-
-/**
- * Save session to disk.
- */
-export async function saveSession(
-  sessionId: string,
-  messages: NormalizedMessageParam[],
-  metadata: Partial<SessionMetadata>,
-): Promise<void> {
-  const dir = getSessionPath(sessionId)
-  await mkdir(dir, { recursive: true })
-
-  const data: SessionData = {
-    metadata: {
-      id: sessionId,
-      cwd: metadata.cwd || process.cwd(),
-      model: metadata.model || 'claude-sonnet-4-6',
-      createdAt: metadata.createdAt || new Date().toISOString(),
-      updatedAt: new Date().toISOString(),
-      messageCount: messages.length,
-      summary: metadata.summary,
-    },
-    messages,
-  }
-
-  await writeFile(
-    join(dir, 'transcript.json'),
-    JSON.stringify(data, null, 2),
-    'utf-8',
-  )
-}
-
-/**
- * Load session from disk.
- */
-export async function loadSession(sessionId: string): Promise<SessionData | null> {
-  try {
-    const filePath = join(getSessionPath(sessionId), 'transcript.json')
-    const content = await readFile(filePath, 'utf-8')
-    return JSON.parse(content) as SessionData
-  } catch {
-    return null
-  }
-}
-
-/**
- * List all sessions.
- */
-export async function listSessions(): Promise<SessionMetadata[]> {
-  try {
-    const dir = getSessionsDir()
-    const entries = await readdir(dir)
-    const sessions: SessionMetadata[] = []
-
-    for (const entry of entries) {
-      try {
-        const data = await loadSession(entry)
-        if (data?.metadata) {
-          sessions.push(data.metadata)
-        }
-      } catch {
-        // Skip invalid sessions
-      }
-    }
-
-    // Sort by updatedAt descending
-    sessions.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
-
-    return sessions
-  } catch {
-    return []
-  }
-}
-
-/**
- * Fork a session (create a copy with a new ID).
- */
-export async function forkSession(
-  sourceSessionId: string,
-  newSessionId?: string,
-): Promise<string | null> {
-  const data = await loadSession(sourceSessionId)
-  if (!data) return null
-
-  const forkId = newSessionId || crypto.randomUUID()
-
-  await saveSession(forkId, data.messages, {
-    ...data.metadata,
-    id: forkId,
-    createdAt: new Date().toISOString(),
-    summary: `Forked from session ${sourceSessionId}`,
-  })
-
-  return forkId
-}
-
-/**
- * Get session messages.
- */
-export async function getSessionMessages(
-  sessionId: string,
-): Promise<NormalizedMessageParam[]> {
-  const data = await loadSession(sessionId)
-  return data?.messages || []
-}
-
-/**
- * Append a message to a session transcript.
- */
-export async function appendToSession(
-  sessionId: string,
-  message: NormalizedMessageParam,
-): Promise<void> {
-  const data = await loadSession(sessionId)
-  if (!data) return
-
-  data.messages.push(message)
-  data.metadata.updatedAt = new Date().toISOString()
-  data.metadata.messageCount = data.messages.length
-
-  await saveSession(sessionId, data.messages, data.metadata)
-}
-
-/**
- * Delete a session.
- */
-export async function deleteSession(sessionId: string): Promise<boolean> {
-  try {
-    const { rm } = await import('fs/promises')
-    await rm(getSessionPath(sessionId), { recursive: true, force: true })
-    return true
-  } catch {
-    return false
-  }
-}
-
-/**
- * Get info about a specific session.
- */
-export async function getSessionInfo(
-  sessionId: string,
-  options?: { dir?: string },
-): Promise<SessionMetadata | null> {
-  const data = await loadSession(sessionId)
-  return data?.metadata || null
-}
-
-/**
- * Rename a session.
- */
-export async function renameSession(
-  sessionId: string,
-  title: string,
-  options?: { dir?: string },
-): Promise<void> {
-  const data = await loadSession(sessionId)
-  if (!data) return
-
-  data.metadata.summary = title
-  data.metadata.updatedAt = new Date().toISOString()
-
-  await saveSession(sessionId, data.messages, data.metadata)
-}
-
-/**
- * Tag a session.
- */
-export async function tagSession(
-  sessionId: string,
-  tag: string | null,
-  options?: { dir?: string },
-): Promise<void> {
-  const data = await loadSession(sessionId)
-  if (!data) return
-
-  ;(data.metadata as any).tag = tag
-  data.metadata.updatedAt = new Date().toISOString()
-
-  await saveSession(sessionId, data.messages, data.metadata)
-}

package/src/skills/bundled/commit.ts

@@ -1,38 +0,0 @@
-/**
- * Bundled Skill: commit
- *
- * Create a git commit with a well-crafted message based on staged changes.
- */
-
-import { registerSkill } from '../registry.js'
-import type { SkillContentBlock } from '../types.js'
-
-const COMMIT_PROMPT = `Create a git commit for the current changes. Follow these steps:
-
-1. Run \`git status\` and \`git diff --cached\` to understand what's staged
-2. If nothing is staged, run \`git diff\` to see unstaged changes and suggest what to stage
-3. Analyze the changes and draft a concise commit message that:
-   - Uses imperative mood ("Add feature" not "Added feature")
-   - Summarizes the "why" not just the "what"
-   - Keeps the first line under 72 characters
-   - Adds a body with details if the change is complex
-4. Create the commit
-
-Do NOT push to remote unless explicitly asked.`
-
-export function registerCommitSkill(): void {
-  registerSkill({
-    name: 'commit',
-    description: 'Create a git commit with a well-crafted message based on staged changes.',
-    aliases: ['ci'],
-    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],
-    userInvocable: true,
-    async getPrompt(args): Promise<SkillContentBlock[]> {
-      let prompt = COMMIT_PROMPT
-      if (args.trim()) {
-        prompt += `\n\nAdditional instructions: ${args}`
-      }
-      return [{ type: 'text', text: prompt }]
-    },
-  })
-}

package/src/skills/bundled/debug.ts

@@ -1,48 +0,0 @@
-/**
- * Bundled Skill: debug
- *
- * Systematic debugging of an issue using structured investigation.
- */
-
-import { registerSkill } from '../registry.js'
-import type { SkillContentBlock } from '../types.js'
-
-const DEBUG_PROMPT = `Debug the described issue using a systematic approach:
-
-1. **Reproduce**: Understand and reproduce the issue
-   - Read relevant error messages or logs
-   - Identify the failing component
-
-2. **Investigate**: Trace the root cause
-   - Read the relevant source code
-   - Add logging or use debugging tools if needed
-   - Check recent changes that might have introduced the issue (\`git log --oneline -20\`)
-
-3. **Hypothesize**: Form a theory about the cause
-   - State your hypothesis clearly before attempting a fix
-
-4. **Fix**: Implement the minimal fix
-   - Make the smallest change that resolves the issue
-   - Don't refactor unrelated code
-
-5. **Verify**: Confirm the fix works
-   - Run relevant tests
-   - Check for regressions`
-
-export function registerDebugSkill(): void {
-  registerSkill({
-    name: 'debug',
-    description: 'Systematic debugging of an issue using structured investigation.',
-    aliases: ['investigate', 'diagnose'],
-    userInvocable: true,
-    async getPrompt(args): Promise<SkillContentBlock[]> {
-      let prompt = DEBUG_PROMPT
-      if (args.trim()) {
-        prompt += `\n\n## Issue Description\n${args}`
-      } else {
-        prompt += `\n\nAsk the user to describe the issue they're experiencing.`
-      }
-      return [{ type: 'text', text: prompt }]
-    },
-  })
-}

package/src/skills/bundled/index.ts

@@ -1,28 +0,0 @@
-/**
- * Bundled Skills Initialization
- *
- * Registers all built-in skills at SDK startup.
- */
-
-import { registerSimplifySkill } from './simplify.js'
-import { registerCommitSkill } from './commit.js'
-import { registerReviewSkill } from './review.js'
-import { registerDebugSkill } from './debug.js'
-import { registerTestSkill } from './test.js'
-
-let initialized = false
-
-/**
- * Initialize all bundled skills.
- * Safe to call multiple times (idempotent).
- */
-export function initBundledSkills(): void {
-  if (initialized) return
-  initialized = true
-
-  registerSimplifySkill()
-  registerCommitSkill()
-  registerReviewSkill()
-  registerDebugSkill()
-  registerTestSkill()
-}

package/src/skills/bundled/review.ts

@@ -1,41 +0,0 @@
-/**
- * Bundled Skill: review
- *
- * Review code changes (PR or local diff) for issues and improvements.
- */
-
-import { registerSkill } from '../registry.js'
-import type { SkillContentBlock } from '../types.js'
-
-const REVIEW_PROMPT = `Review the current code changes for potential issues. Follow these steps:
-
-1. Run \`git diff\` to see uncommitted changes, or \`git diff main...HEAD\` for branch changes
-2. For each changed file, analyze:
-   - **Correctness**: Logic errors, edge cases, off-by-one errors
-   - **Security**: Injection vulnerabilities, auth issues, data exposure
-   - **Performance**: N+1 queries, unnecessary allocations, blocking I/O
-   - **Style**: Naming, consistency with surrounding code, readability
-   - **Testing**: Are the changes adequately tested?
-3. Provide a summary with:
-   - Critical issues (must fix)
-   - Suggestions (nice to have)
-   - Questions (need clarification)
-
-Be specific: reference file names, line numbers, and suggest fixes.`
-
-export function registerReviewSkill(): void {
-  registerSkill({
-    name: 'review',
-    description: 'Review code changes for correctness, security, performance, and style issues.',
-    aliases: ['review-pr', 'cr'],
-    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],
-    userInvocable: true,
-    async getPrompt(args): Promise<SkillContentBlock[]> {
-      let prompt = REVIEW_PROMPT
-      if (args.trim()) {
-        prompt += `\n\nFocus area: ${args}`
-      }
-      return [{ type: 'text', text: prompt }]
-    },
-  })
-}

package/src/skills/bundled/simplify.ts

@@ -1,51 +0,0 @@
-/**
- * Bundled Skill: simplify
- *
- * Reviews changed code for reuse opportunities, code quality issues,
- * and efficiency improvements, then fixes any issues found.
- */
-
-import { registerSkill } from '../registry.js'
-import type { SkillContentBlock } from '../types.js'
-
-const SIMPLIFY_PROMPT = `Review the recently changed code for three categories of improvements. Launch 3 parallel Agent sub-tasks:
-
-## Task 1: Reuse Analysis
-Look for:
-- Duplicated code that could be consolidated
-- Existing utilities or helpers that could replace new code
-- Patterns that should be extracted into shared functions
-- Re-implementations of functionality that already exists elsewhere
-
-## Task 2: Code Quality
-Look for:
-- Overly complex logic that could be simplified
-- Poor naming or unclear intent
-- Missing edge case handling
-- Unnecessary abstractions or over-engineering
-- Dead code or unused imports
-
-## Task 3: Efficiency
-Look for:
-- Unnecessary allocations or copies
-- N+1 query patterns or redundant I/O
-- Blocking operations that could be async
-- Inefficient data structures for the access pattern
-- Unnecessary re-computation
-
-After all three analyses complete, fix any issues found. Prioritize by impact.`
-
-export function registerSimplifySkill(): void {
-  registerSkill({
-    name: 'simplify',
-    description: 'Review changed code for reuse, quality, and efficiency, then fix any issues found.',
-    userInvocable: true,
-    async getPrompt(args): Promise<SkillContentBlock[]> {
-      let prompt = SIMPLIFY_PROMPT
-      if (args.trim()) {
-        prompt += `\n\n## Additional Focus\n${args}`
-      }
-      return [{ type: 'text', text: prompt }]
-    },
-  })
-}

package/src/skills/bundled/test.ts

@@ -1,43 +0,0 @@
-/**
- * Bundled Skill: test
- *
- * Run tests and analyze failures.
- */
-
-import { registerSkill } from '../registry.js'
-import type { SkillContentBlock } from '../types.js'
-
-const TEST_PROMPT = `Run the project's test suite and analyze the results:
-
-1. **Discover**: Find the test runner configuration
-   - Look for package.json scripts, jest.config, vitest.config, pytest.ini, etc.
-   - Identify the appropriate test command
-
-2. **Execute**: Run the tests
-   - Run the full test suite or specific tests if specified
-   - Capture output including failures and errors
-
-3. **Analyze**: If tests fail:
-   - Read the failing test to understand what it expects
-   - Read the source code being tested
-   - Identify why the test is failing
-   - Fix the issue (in tests or source as appropriate)
-
-4. **Re-verify**: Run the failing tests again to confirm the fix`
-
-export function registerTestSkill(): void {
-  registerSkill({
-    name: 'test',
-    description: 'Run tests and analyze failures, fixing any issues found.',
-    aliases: ['run-tests'],
-    allowedTools: ['Bash', 'Read', 'Write', 'Edit', 'Glob', 'Grep'],
-    userInvocable: true,
-    async getPrompt(args): Promise<SkillContentBlock[]> {
-      let prompt = TEST_PROMPT
-      if (args.trim()) {
-        prompt += `\n\nSpecific test target: ${args}`
-      }
-      return [{ type: 'text', text: prompt }]
-    },
-  })
-}

package/src/skills/index.ts

@@ -1,25 +0,0 @@
-/**
- * Skills Module - Public API
- */
-
-// Types
-export type {
-  SkillDefinition,
-  SkillContentBlock,
-  SkillResult,
-} from './types.js'
-
-// Registry
-export {
-  registerSkill,
-  getSkill,
-  getAllSkills,
-  getUserInvocableSkills,
-  hasSkill,
-  unregisterSkill,
-  clearSkills,
-  formatSkillsForPrompt,
-} from './registry.js'
-
-// Bundled skills
-export { initBundledSkills } from './bundled/index.js'