@miphamai/cli 0.2.3

package/src/shared/constants.ts

@@ -0,0 +1,368 @@
+import type { ProviderConfig } from './types'
+
+// Providers: alphabetical by id. Models: Lite/Flash → Text → Vision → Code → Pro/Think
+export const DEFAULT_PROVIDERS: ProviderConfig[] = [
+  {
+    id: 'anthropic',
+    name: 'Anthropic Claude',
+    protocol: 'anthropic',
+    apiKey: '${ANTHROPIC_API_KEY}',
+    models: [
+      {
+        id: 'claude-haiku-4-5-20251001',
+        name: 'Claude Haiku 4.5',
+        providerId: 'anthropic',
+        contextWindow: 200_000,
+        maxOutput: 32_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'claude-sonnet-4-6',
+        name: 'Claude Sonnet 4.6',
+        providerId: 'anthropic',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'claude-opus-4-8',
+        name: 'Claude Opus 4.8',
+        providerId: 'anthropic',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'deepseek',
+    name: 'DeepSeek',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://api.deepseek.com/v1',
+    apiKey: '${DEEPSEEK_API_KEY}',
+    models: [
+      {
+        id: 'deepseek-v4-flash',
+        name: 'DeepSeek V4 Flash',
+        providerId: 'deepseek',
+        contextWindow: 1_000_000,
+        maxOutput: 384_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'deepseek-v4-pro',
+        name: 'DeepSeek V4 Pro',
+        providerId: 'deepseek',
+        contextWindow: 1_000_000,
+        maxOutput: 384_000,
+        vision: false,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'google',
+    name: 'Google Gemini',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
+    apiKey: '${GEMINI_API_KEY}',
+    models: [
+      {
+        id: 'gemini-3.0-flash',
+        name: 'Gemini 3.0 Flash',
+        providerId: 'google',
+        contextWindow: 1_000_000,
+        maxOutput: 64_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'gemini-3.0-pro',
+        name: 'Gemini 3.0 Pro',
+        providerId: 'google',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'gemini-2.5-pro',
+        name: 'Gemini 2.5 Pro',
+        providerId: 'google',
+        contextWindow: 1_000_000,
+        maxOutput: 64_000,
+        vision: true,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'doubao',
+    name: '豆包 (字节跳动)',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+    apiKey: '${DOUBAO_API_KEY}',
+    models: [
+      {
+        id: 'doubao-seed-1.6-flash',
+        name: '豆包 Seed 1.6 Flash',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'doubao-seed-2.0-mini',
+        name: '豆包 Seed 2.0 Mini',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'doubao-seed-2.0-lite',
+        name: '豆包 Seed 2.0 Lite',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'doubao-seed-1.6',
+        name: '豆包 Seed 1.6',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'doubao-seed-2.0-pro',
+        name: '豆包 Seed 2.0 Pro',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'doubao-seed-2.0-code',
+        name: '豆包 Seed 2.0 Code',
+        providerId: 'doubao',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'hunyuan',
+    name: '腾讯混元',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://api.hunyuan.cloud.tencent.com/v1',
+    apiKey: '${HUNYUAN_API_KEY}',
+    models: [
+      {
+        id: 'hunyuan-lite',
+        name: '混元 Lite (免费)',
+        providerId: 'hunyuan',
+        contextWindow: 256_000,
+        maxOutput: 6_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-turbos-latest',
+        name: '混元 TurboS',
+        providerId: 'hunyuan',
+        contextWindow: 32_000,
+        maxOutput: 16_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-2.0-instruct-20251111',
+        name: '混元 2.0 Instruct',
+        providerId: 'hunyuan',
+        contextWindow: 144_000,
+        maxOutput: 16_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-t1-vision-20250916',
+        name: '混元 T1 Vision',
+        providerId: 'hunyuan',
+        contextWindow: 32_000,
+        maxOutput: 64_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-a13b',
+        name: '混元 A13B',
+        providerId: 'hunyuan',
+        contextWindow: 224_000,
+        maxOutput: 32_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-2.0-thinking-20251109',
+        name: '混元 2.0 Think',
+        providerId: 'hunyuan',
+        contextWindow: 192_000,
+        maxOutput: 64_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hunyuan-t1-latest',
+        name: '混元 T1 (推理)',
+        providerId: 'hunyuan',
+        contextWindow: 32_000,
+        maxOutput: 64_000,
+        vision: false,
+        status: 'active',
+      },
+      {
+        id: 'hy3-preview',
+        name: '混元 Hy3 Preview',
+        providerId: 'hunyuan',
+        contextWindow: 256_000,
+        maxOutput: 128_000,
+        vision: false,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'mipham',
+    name: 'MiphamAI',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://api.mipham.ai/v1',
+    apiKey: '${MIPHAM_API_KEY}',
+    models: [
+      {
+        id: 'om-V5-Flash',
+        name: 'OM V5 Flash',
+        providerId: 'mipham',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: false,
+        status: 'upcoming',
+      },
+      {
+        id: 'om-V5-Pro',
+        name: 'OM V5 Pro',
+        providerId: 'mipham',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: false,
+        status: 'upcoming',
+      },
+      {
+        id: 'om-V5-Visual',
+        name: 'OM V5 Visual',
+        providerId: 'mipham',
+        contextWindow: 200_000,
+        maxOutput: 32_000,
+        vision: true,
+        status: 'upcoming',
+      },
+    ],
+    status: 'upcoming',
+  },
+  {
+    id: 'openai',
+    name: 'OpenAI',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://api.openai.com/v1',
+    apiKey: '${OPENAI_API_KEY}',
+    models: [
+      {
+        id: 'gpt-5.4-mini',
+        name: 'GPT-5.4 Mini',
+        providerId: 'openai',
+        contextWindow: 400_000,
+        maxOutput: 32_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'gpt-5.4',
+        name: 'GPT-5.4',
+        providerId: 'openai',
+        contextWindow: 1_050_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'gpt-5.5',
+        name: 'GPT-5.5',
+        providerId: 'openai',
+        contextWindow: 1_050_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'gpt-5.3-codex',
+        name: 'GPT-5.3 Codex',
+        providerId: 'openai',
+        contextWindow: 400_000,
+        maxOutput: 64_000,
+        vision: false,
+        status: 'active',
+      },
+    ],
+  },
+  {
+    id: 'qwen',
+    name: '通义千问',
+    protocol: 'openai-compatible',
+    baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    apiKey: '${QWEN_API_KEY}',
+    models: [
+      {
+        id: 'qwen-plus',
+        name: 'Qwen Plus',
+        providerId: 'qwen',
+        contextWindow: 128_000,
+        maxOutput: 32_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'qwen-max',
+        name: 'Qwen Max',
+        providerId: 'qwen',
+        contextWindow: 128_000,
+        maxOutput: 32_000,
+        vision: true,
+        status: 'active',
+      },
+    ],
+  },
+]
+
+export const PROTOCOL_LABELS: Record<string, string> = {
+  'openai-compatible': 'OpenAI Compatible',
+  anthropic: 'Anthropic',
+  custom: 'Custom Protocol',
+}
+
+export const TOOL_CATEGORIES = ['file', 'exec', 'agent', 'network', 'system'] as const
+export const CONFIG_FILE_NAME = 'config.yml'
+export const MIPHAM_DIR = '.mipham'
+export const USER_CONFIG_DIR = '.mipham'
+export const MEMORY_DIR = 'memory'

package/src/shared/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export * from './constants'

package/src/shared/types.ts

@@ -0,0 +1,161 @@
+// ── Provider Types ──
+export type ProtocolType = 'openai-compatible' | 'anthropic' | 'custom'
+
+export interface ModelInfo {
+  id: string
+  name: string
+  providerId: string
+  contextWindow: number
+  maxOutput: number
+  vision: boolean
+  status: 'active' | 'upcoming' | 'deprecated'
+}
+
+export interface ProviderConfig {
+  id: string
+  name: string
+  protocol: ProtocolType
+  baseUrl?: string
+  apiKey: string
+  models: ModelInfo[]
+  status?: 'active' | 'upcoming'
+}
+
+// ── Message Types ──
+export interface TextContent {
+  type: 'text'
+  text: string
+}
+export interface ImageContent {
+  type: 'image_url'
+  image_url: { url: string }
+}
+export interface ToolUseContent {
+  type: 'tool_use'
+  id: string
+  name: string
+  input: Record<string, unknown>
+}
+export interface ToolResultContent {
+  type: 'tool_result'
+  tool_use_id: string
+  content: string
+}
+export type ContentBlock = TextContent | ImageContent | ToolUseContent | ToolResultContent
+
+export interface Message {
+  role: 'system' | 'user' | 'assistant'
+  content: string | ContentBlock[]
+}
+
+// ── Tool Types ──
+export type ToolPermission = 'auto' | 'ask' | 'bypass'
+export type ToolCategory = 'file' | 'exec' | 'agent' | 'network' | 'system'
+
+export interface ToolContext {
+  cwd: string
+  sessionId: string
+  provider: string
+  model: string
+  skillsLoader?: import('../skills/loader').SkillsLoader
+  registry?: import('../providers/registry').ProviderRegistry
+}
+
+export interface ToolResult {
+  success: boolean
+  content: string
+  error?: string
+}
+
+export interface ToolDefinition {
+  name: string
+  description: string
+  category: ToolCategory
+  permission: ToolPermission
+  parameters: Record<string, unknown>
+  execute: (params: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResult>
+}
+
+// ── Stream Types ──
+export interface StreamChunk {
+  type: 'text' | 'tool_use' | 'tool_result' | 'stop' | 'error'
+  content?: string
+  toolUse?: ToolUseContent
+  tool_use_id?: string
+  error?: string
+}
+
+// ── Config Types ──
+export interface MiphamConfig {
+  version: string
+  defaultProvider: string
+  defaultModel: string
+  permission: ToolPermission
+  providers: ProviderConfig[]
+  skills?: { paths: string[]; mcpServers: McpServerConfig[] }
+}
+
+export interface McpServerConfig {
+  name: string
+  command: string
+  args: string[]
+  env?: Record<string, string>
+}
+
+// ── Skill Types ──
+export interface SkillDefinition {
+  name: string
+  description: string
+  version: string
+  type: 'standard' | 'mipham'
+  tools?: ToolDefinition[]
+  hooks?: HookDefinition[]
+  prompts?: Record<string, string>
+}
+
+// ── Hook Types ──
+export type HookEvent =
+  | 'PreToolUse'
+  | 'PostToolUse'
+  | 'SessionStart'
+  | 'SessionEnd'
+  | 'Notification'
+
+export interface HookDefinition {
+  event: HookEvent
+  toolName?: string
+  handler: (context: HookContext) => Promise<HookResult>
+}
+
+export interface HookContext {
+  event: HookEvent
+  toolName?: string
+  toolInput?: Record<string, unknown>
+  toolResult?: ToolResult
+  sessionId: string
+}
+
+export interface HookResult {
+  allowed: boolean
+  reason?: string
+  modifiedInput?: Record<string, unknown>
+}
+
+// ── Instruction Types ──
+export interface InstructionFile {
+  path: string
+  level: 'group' | 'company' | 'project' | 'directory' | 'user'
+  privacy: 'public' | 'project' | 'private'
+  language: string
+  content: string
+  frontmatter: Record<string, unknown>
+}
+
+// ── Permission Types ──
+export type PermissionLevel = 'auto' | 'ask' | 'bypass'
+
+export interface PermissionRule {
+  toolName: string
+  level: PermissionLevel
+  pattern?: string
+}

package/src/skills/loader.ts

@@ -0,0 +1,109 @@
+import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs'
+import { join, extname } from 'node:path'
+import { parse as parseYaml } from 'yaml'
+import type { SkillDefinition } from '../shared/index.ts'
+
+interface FrontmatterResult {
+  data: Record<string, unknown>
+  content: string
+}
+
+function parseFrontmatter(raw: string): FrontmatterResult {
+  const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/)
+  if (!match) {
+    return { data: {}, content: raw }
+  }
+  return {
+    data: parseYaml(match[1] || '') as Record<string, unknown>,
+    content: match[2] || '',
+  }
+}
+
+export class SkillsLoader {
+  private skills = new Map<string, SkillDefinition>()
+
+  loadBuiltin(basePath: string): void {
+    // Load standard skills (*.SKILL.md)
+    const standardDir = join(basePath, 'skills', 'standard')
+    if (existsSync(standardDir)) {
+      this.loadDirectory(standardDir, 'standard')
+    }
+
+    // Load mipham skills (*.mipham-skill.md)
+    const miphamDir = join(basePath, 'skills', 'mipham')
+    if (existsSync(miphamDir)) {
+      this.loadDirectory(miphamDir, 'mipham')
+    }
+  }
+
+  loadExternal(paths: string[]): void {
+    for (const p of paths) {
+      if (existsSync(p)) {
+        const stat = statSync(p)
+        if (stat.isDirectory()) {
+          this.loadDirectory(p, 'standard')
+        } else if (stat.isFile()) {
+          this.tryLoad(p, 'standard')
+        }
+      }
+    }
+  }
+
+  get(name: string): SkillDefinition | undefined {
+    return this.skills.get(name)
+  }
+
+  list(): SkillDefinition[] {
+    return Array.from(this.skills.values())
+  }
+
+  listByType(type: 'standard' | 'mipham'): SkillDefinition[] {
+    return Array.from(this.skills.values()).filter((s) => s.type === type)
+  }
+
+  has(name: string): boolean {
+    return this.skills.has(name)
+  }
+
+  private loadDirectory(dir: string, type: 'standard' | 'mipham'): void {
+    try {
+      const entries = readdirSync(dir)
+      for (const entry of entries) {
+        const fullPath = join(dir, entry)
+        const isSkillFile = entry.endsWith('.SKILL.md') || entry.endsWith('.mipham-skill.md')
+
+        if (isSkillFile) {
+          this.tryLoad(fullPath, type)
+        }
+      }
+    } catch {
+      // skip unreadable
+    }
+  }
+
+  private tryLoad(path: string, type: 'standard' | 'mipham'): void {
+    try {
+      const raw = readFileSync(path, 'utf-8')
+      const { data, content } = parseFrontmatter(raw)
+
+      const skill: SkillDefinition = {
+        name: (data.name as string) || this.nameFromPath(path),
+        description: (data.description as string) || '',
+        version: (data.version as string) || '0.1.0',
+        type,
+        tools: data.tools as SkillDefinition['tools'],
+        hooks: data.hooks as SkillDefinition['hooks'],
+        prompts: data.prompts as SkillDefinition['prompts'],
+      }
+
+      this.skills.set(skill.name, skill)
+    } catch {
+      // skip unparseable
+    }
+  }
+
+  private nameFromPath(path: string): string {
+    const base = path.split('/').pop() || ''
+    return base.replace(/\.(SKILL|mipham-skill)\.md$/i, '')
+  }
+}

package/src/skills/mipham/runtime.ts

@@ -0,0 +1,63 @@
+import type { SkillDefinition } from '../../shared/index.ts'
+
+export interface MiphamRuntimeContext {
+  skill: SkillDefinition
+  cwd: string
+  sessionId: string
+  modelId: string
+  providerId: string
+}
+
+/**
+ * Mipham exclusive skill runtime.
+ * Mipham skills use `.mipham-skill.md` extension and have access to
+ * Mipham-specific features: model optimization, security features, etc.
+ */
+export class MiphamRuntime {
+  private context: MiphamRuntimeContext
+
+  constructor(context: MiphamRuntimeContext) {
+    this.context = context
+  }
+
+  getSkill(): SkillDefinition {
+    return this.context.skill
+  }
+
+  getPrompts(): Record<string, string> {
+    return this.context.skill.prompts || {}
+  }
+
+  getTools(): SkillDefinition['tools'] {
+    return this.context.skill.tools || []
+  }
+
+  getHooks(): SkillDefinition['hooks'] {
+    return this.context.skill.hooks || []
+  }
+
+  /**
+   * Execute a named prompt with Mipham-specific context.
+   */
+  async executePrompt(name: string, variables?: Record<string, string>): Promise<string> {
+    const prompt = this.context.skill.prompts?.[name]
+    if (!prompt) {
+      throw new Error(`Prompt "${name}" not found in skill "${this.context.skill.name}"`)
+    }
+
+    let result = prompt
+    const allVars: Record<string, string> = {
+      provider: this.context.providerId,
+      model: this.context.modelId,
+      session: this.context.sessionId,
+      cwd: this.context.cwd,
+      ...variables,
+    }
+
+    for (const [key, value] of Object.entries(allVars)) {
+      result = result.replaceAll(`\${${key}}`, value)
+    }
+
+    return result
+  }
+}