@kkelly-offical/kkcode 0.1.2

package/src/core/errors.mjs

@@ -0,0 +1,57 @@
+export class KkError extends Error {
+  constructor(code, message, details = null) {
+    super(message)
+    this.name = "KkError"
+    this.code = code
+    this.details = details
+  }
+}
+
+export class ValidationError extends KkError {
+  constructor(message, details = null) {
+    super("VALIDATION_ERROR", message, details)
+    this.name = "ValidationError"
+  }
+}
+
+export class ProviderError extends KkError {
+  constructor(message, details = null) {
+    super("PROVIDER_ERROR", message, details)
+    this.name = "ProviderError"
+  }
+}
+
+export class PermissionError extends KkError {
+  constructor(message, details = null) {
+    super("PERMISSION_DENIED", message, details)
+    this.name = "PermissionError"
+  }
+}
+
+export class ToolError extends KkError {
+  constructor(message, details = null) {
+    super("TOOL_ERROR", message, details)
+    this.name = "ToolError"
+  }
+}
+
+export class McpError extends KkError {
+  /**
+   * @param {string} message
+   * @param {{ reason?: string, server?: string, action?: string }} [details]
+   * reason: "timeout" | "spawn_failed" | "connection_refused" | "bad_response" | "server_crash" | "protocol_error" | "unknown"
+   */
+  constructor(message, details = null) {
+    super("MCP_ERROR", message, details)
+    this.name = "McpError"
+    this.reason = details?.reason || "unknown"
+    this.server = details?.server || null
+  }
+}
+
+export class SessionError extends KkError {
+  constructor(message, details = null) {
+    super("SESSION_ERROR", message, details)
+    this.name = "SessionError"
+  }
+}

package/src/core/events.mjs

@@ -0,0 +1,29 @@
+import { makeEventEnvelope } from "./types.mjs"
+
+const listeners = new Set()
+const sinks = new Set()
+
+export const EventBus = {
+  subscribe(fn) {
+    listeners.add(fn)
+    return () => listeners.delete(fn)
+  },
+  registerSink(fn) {
+    sinks.add(fn)
+    return () => sinks.delete(fn)
+  },
+  async emit(input) {
+    const event = makeEventEnvelope(input)
+    for (const sink of sinks) {
+      try { await sink(event) } catch (err) {
+        console.error("[events] sink error:", err?.message || err)
+      }
+    }
+    for (const fn of listeners) {
+      try { await fn(event) } catch (err) {
+        console.error("[events] listener error:", err?.message || err)
+      }
+    }
+    return event
+  }
+}

package/src/core/types.mjs

@@ -0,0 +1,57 @@
+import { randomUUID } from "node:crypto"
+
+export function nowMs() {
+  return Date.now()
+}
+
+export function newId(prefix) {
+  return `${prefix}_${randomUUID().slice(0, 12)}`
+}
+
+export function makeEventEnvelope({ type, sessionId = null, turnId = null, payload = {} }) {
+  return {
+    id: newId("evt"),
+    type,
+    sessionId,
+    turnId,
+    timestamp: nowMs(),
+    payload
+  }
+}
+
+export function makeToolResult({ name, status, output = "", error = null, durationMs = 0, metadata = {} }) {
+  return {
+    name,
+    status,
+    output,
+    error,
+    durationMs,
+    metadata
+  }
+}
+
+export function makeTurnResult({
+  sessionId,
+  turnId,
+  mode,
+  model,
+  reply,
+  usage,
+  cost,
+  toolEvents,
+  estimated = false,
+  warnings = []
+}) {
+  return {
+    sessionId,
+    turnId,
+    mode,
+    model,
+    reply,
+    usage,
+    cost,
+    toolEvents,
+    estimated,
+    warnings
+  }
+}

package/src/github/api.mjs

@@ -0,0 +1,78 @@
+const API_BASE = "https://api.github.com"
+
+function headers(token) {
+  return {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28"
+  }
+}
+
+async function ghFetch(token, path, params = {}) {
+  const url = new URL(`${API_BASE}${path}`)
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined && v !== null) url.searchParams.set(k, String(v))
+  }
+  const res = await fetch(url.href, { headers: headers(token) })
+  if (!res.ok) {
+    const body = await res.text().catch(() => "")
+    throw new Error(`GitHub API ${res.status}: ${path} — ${body.slice(0, 200)}`)
+  }
+  return res.json()
+}
+
+export async function listUserRepos(token, { page = 1, perPage = 20, sort = "pushed" } = {}) {
+  const repos = await ghFetch(token, "/user/repos", {
+    sort,
+    per_page: perPage,
+    page,
+    affiliation: "owner,collaborator,organization_member"
+  })
+  return repos.map((r) => ({
+    full_name: r.full_name,
+    name: r.name,
+    owner: r.owner.login,
+    description: r.description || "",
+    default_branch: r.default_branch,
+    stars: r.stargazers_count,
+    pushed_at: r.pushed_at,
+    private: r.private
+  }))
+}
+
+export async function searchRepos(token, query, login) {
+  const q = login ? `${query} user:${login}` : query
+  const data = await ghFetch(token, "/search/repositories", { q, per_page: 20, sort: "updated" })
+  return (data.items || []).map((r) => ({
+    full_name: r.full_name,
+    name: r.name,
+    owner: r.owner.login,
+    description: r.description || "",
+    default_branch: r.default_branch,
+    stars: r.stargazers_count,
+    pushed_at: r.pushed_at,
+    private: r.private
+  }))
+}
+
+export async function listBranches(token, owner, repo) {
+  const branches = await ghFetch(token, `/repos/${owner}/${repo}/branches`, { per_page: 100 })
+  return branches.map((b) => ({
+    name: b.name,
+    protected: b.protected
+  }))
+}
+
+export async function getRepo(token, owner, repo) {
+  const r = await ghFetch(token, `/repos/${owner}/${repo}`)
+  return {
+    full_name: r.full_name,
+    name: r.name,
+    owner: r.owner.login,
+    description: r.description || "",
+    default_branch: r.default_branch,
+    stars: r.stargazers_count,
+    pushed_at: r.pushed_at,
+    private: r.private
+  }
+}

package/src/github/auth.mjs

@@ -0,0 +1,286 @@
+import { readFile, writeFile, unlink, mkdir } from "node:fs/promises"
+import { dirname } from "node:path"
+import { spawn } from "node:child_process"
+import { githubTokenPath } from "../storage/paths.mjs"
+
+const CLIENT_ID = "Ov23liCqhJ6cRaqyv3uA"
+const DEVICE_CODE_URL = "https://github.com/login/device/code"
+const ACCESS_TOKEN_URL = "https://github.com/login/oauth/access_token"
+const SCOPE = "repo"
+
+export async function getStoredToken() {
+  try {
+    const raw = await readFile(githubTokenPath(), "utf8")
+    const data = JSON.parse(raw)
+    if (data.token && data.login) return data
+    return null
+  } catch {
+    return null
+  }
+}
+
+async function saveToken(data) {
+  const filePath = githubTokenPath()
+  await mkdir(dirname(filePath), { recursive: true })
+  await writeFile(filePath, JSON.stringify(data, null, 2), "utf8")
+}
+
+export async function logout() {
+  try {
+    await unlink(githubTokenPath())
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function validateToken(token) {
+  try {
+    const res = await fetch("https://api.github.com/user", {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/vnd.github+json"
+      }
+    })
+    if (res.ok) {
+      const user = await res.json()
+      return { valid: true, login: user.login }
+    }
+    return { valid: false, login: null }
+  } catch {
+    return { valid: false, login: null }
+  }
+}
+
+async function requestDeviceCode() {
+  const res = await fetch(DEVICE_CODE_URL, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ client_id: CLIENT_ID, scope: SCOPE })
+  })
+  if (!res.ok) {
+    throw new Error(`GitHub device code request failed: ${res.status}`)
+  }
+  return res.json()
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+/**
+ * 跨平台打开浏览器
+ * @param {string} url - 要打开的 URL
+ */
+function openBrowser(url) {
+  const platform = process.platform
+  let command
+  let args
+
+  if (platform === "win32") {
+    // Windows
+    command = "cmd"
+    args = ["/c", "start", "", url]
+  } else if (platform === "darwin") {
+    // macOS
+    command = "open"
+    args = [url]
+  } else {
+    // Linux 和其他平台
+    command = "xdg-open"
+    args = [url]
+  }
+
+  try {
+    const child = spawn(command, args, { detached: true, stdio: "ignore" })
+    child.unref()
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 跨平台复制文本到剪贴板
+ * @param {string} text - 要复制的文本
+ * @returns {boolean} 是否成功
+ */
+function copyToClipboard(text) {
+  const platform = process.platform
+  let command
+  let args
+  let input = text
+
+  if (platform === "win32") {
+    // Windows - 使用 clip 命令
+    command = "clip"
+    args = []
+  } else if (platform === "darwin") {
+    // macOS - 使用 pbcopy
+    command = "pbcopy"
+    args = []
+  } else {
+    // Linux - 尝试 wl-copy (Wayland) 或 xclip (X11)
+    try {
+      // 先尝试 wl-copy (Wayland)
+      const child = spawn("wl-copy", [], { stdio: ["pipe", "ignore", "ignore"] })
+      child.stdin.write(text)
+      child.stdin.end()
+      return true
+    } catch {
+      // 回退到 xclip (X11)
+      try {
+        const child = spawn("xclip", ["-selection", "clipboard"], { stdio: ["pipe", "ignore", "ignore"] })
+        child.stdin.write(text)
+        child.stdin.end()
+        return true
+      } catch {
+        return false
+      }
+    }
+  }
+
+  try {
+    const child = spawn(command, args, { stdio: ["pipe", "ignore", "ignore"] })
+    child.stdin.write(input)
+    child.stdin.end()
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function pollAccessToken(deviceCode, interval) {
+  let retryCount = 0
+  const maxRetries = 3
+
+  while (true) {
+    await sleep(interval * 1000)
+
+    let res
+    try {
+      res = await fetch(ACCESS_TOKEN_URL, {
+        method: "POST",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          client_id: CLIENT_ID,
+          device_code: deviceCode,
+          grant_type: "urn:ietf:params:oauth:grant-type:device_code"
+        })
+      })
+      retryCount = 0 // 重置重试计数
+    } catch (networkError) {
+      retryCount++
+      if (retryCount >= maxRetries) {
+        throw new Error(`Network error after ${maxRetries} retries: ${networkError.message}`)
+      }
+      process.stdout.write(`\n  \x1b[33m⚠ 网络错误，${maxRetries - retryCount} 秒后重试...\x1b[0m`)
+      await sleep(1000)
+      process.stdout.write("\r  \x1b[K等待授权...")
+      continue
+    }
+
+    let data
+    try {
+      data = await res.json()
+    } catch {
+      // 如果无法解析 JSON，可能是网络问题，继续等待
+      continue
+    }
+
+    if (data.access_token) {
+      return data.access_token
+    }
+    if (data.error === "authorization_pending") {
+      process.stdout.write(".")
+      continue
+    }
+    if (data.error === "slow_down") {
+      interval = (data.interval || interval) + 1
+      process.stdout.write("\n  \x1b[33m⚠ 请求过于频繁，已放慢速度...\x1b[0m")
+      continue
+    }
+    if (data.error === "expired_token") {
+      throw new Error("Authorization timed out. Please try again.")
+    }
+    if (data.error === "access_denied") {
+      throw new Error("Authorization denied by user.")
+    }
+    // 其他错误，记录但继续等待（可能是临时错误）
+    process.stdout.write(`\n  \x1b[33m⚠ 服务器返回: ${data.error || 'unknown'}，继续等待...\x1b[0m`)
+  }
+}
+
+export async function ensureGitHubAuth() {
+  // Check stored token
+  const stored = await getStoredToken()
+  if (stored) {
+    const check = await validateToken(stored.token)
+    if (check.valid) {
+      return { token: stored.token, login: check.login }
+    }
+    // Token expired, remove it
+    await logout()
+  }
+
+  // Start Device Flow
+  console.log("\n\x1b[33m🔐 GitHub 账户未登录，正在启动授权...\x1b[0m\n")
+
+  const deviceData = await requestDeviceCode()
+  const { device_code, user_code, verification_uri, interval } = deviceData
+
+  // 自动复制代码到剪贴板
+  const copied = copyToClipboard(user_code)
+
+  console.log(`  请在浏览器中打开: \x1b[36m\x1b[4m${verification_uri}\x1b[0m`)
+  if (copied) {
+    console.log(`  输入代码: \x1b[1m\x1b[32m${user_code}\x1b[0m  \x1b[2m✅ 已复制到剪贴板\x1b[0m\n`)
+  } else {
+    console.log(`  输入代码: \x1b[1m\x1b[32m${user_code}\x1b[0m\n`)
+  }
+
+  // 自动打开浏览器
+  const opened = openBrowser(verification_uri)
+  if (opened) {
+    console.log("  \x1b[2m已自动打开浏览器，请完成授权...\x1b[0m")
+    if (copied) {
+      console.log("  \x1b[2m提示: 在 GitHub 页面按 Ctrl+V 粘贴代码\x1b[0m\n")
+    } else {
+      console.log("")
+    }
+  } else {
+    console.log("  \x1b[33m⚠ 无法自动打开浏览器，请手动访问上述链接\x1b[0m\n")
+  }
+
+  process.stdout.write("  等待授权...")
+
+  const token = await pollAccessToken(device_code, interval || 5)
+
+  // Get user info
+  const userRes = await fetch("https://api.github.com/user", {
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.github+json"
+    }
+  })
+  if (!userRes.ok) {
+    throw new Error(`Failed to get user info: ${userRes.status}`)
+  }
+  const user = await userRes.json()
+
+  await saveToken({
+    token,
+    login: user.login,
+    login_at: new Date().toISOString()
+  })
+
+  console.log(` \x1b[32m✓ 已登录为 @${user.login}\x1b[0m\n`)
+
+  return { token, login: user.login }
+}