@kood/claude-code 0.2.4 → 0.3.0

package/templates/hono/docs/library/ai-sdk/openrouter.md

@@ -1,111 +0,0 @@
-# AI SDK - OpenRouter
-
-> 수백 개 모델을 단일 API로
-
----
-
-## 설치
-
-```bash
-npm install @openrouter/ai-sdk-provider
-```
-
----
-
-## 기본 사용
-
-```typescript
-import { Hono } from 'hono'
-import { streamText, convertToModelMessages } from 'ai'
-import { createOpenRouter } from '@openrouter/ai-sdk-provider'
-
-const openrouter = createOpenRouter({
-  apiKey: process.env.OPENROUTER_API_KEY,
-})
-
-app.post('/api/chat', async (c) => {
-  const { messages } = await c.req.json()
-
-  const result = streamText({
-    model: openrouter.chat('anthropic/claude-3.5-sonnet'),
-    messages: convertToModelMessages(messages),
-  })
-
-  return result.toUIMessageStreamResponse()
-})
-```
-
----
-
-## 동적 모델 선택
-
-```typescript
-import { HTTPException } from 'hono/http-exception'
-
-const ALLOWED_MODELS = [
-  'anthropic/claude-3.5-sonnet',
-  'openai/gpt-4o',
-  'google/gemini-pro-1.5',
-  'meta-llama/llama-3.1-70b-instruct',
-]
-
-app.post('/api/chat', async (c) => {
-  const { messages, model } = await c.req.json()
-
-  if (!ALLOWED_MODELS.includes(model)) {
-    throw new HTTPException(400, { message: 'Invalid model' })
-  }
-
-  const result = streamText({
-    model: openrouter.chat(model),
-    messages: convertToModelMessages(messages),
-  })
-
-  return result.toUIMessageStreamResponse()
-})
-```
-
----
-
-## Cloudflare Workers
-
-```typescript
-import { createOpenRouter } from '@openrouter/ai-sdk-provider'
-
-type Bindings = { OPENROUTER_API_KEY: string }
-
-const app = new Hono<{ Bindings: Bindings }>()
-
-app.post('/api/chat', async (c) => {
-  const openrouter = createOpenRouter({
-    apiKey: c.env.OPENROUTER_API_KEY,
-  })
-
-  const { messages, model } = await c.req.json()
-
-  const result = streamText({
-    model: openrouter.chat(model ?? 'anthropic/claude-3.5-sonnet'),
-    messages: convertToModelMessages(messages),
-  })
-
-  return result.toUIMessageStreamResponse()
-})
-```
-
----
-
-## 주요 모델
-
-| 프로바이더 | 모델 |
-|-----------|------|
-| Anthropic | `anthropic/claude-3.5-sonnet`, `anthropic/claude-3-opus` |
-| OpenAI | `openai/gpt-4o`, `openai/gpt-4-turbo` |
-| Google | `google/gemini-pro-1.5` |
-| Meta | `meta-llama/llama-3.1-70b-instruct` |
-
----
-
-## 관련 문서
-
-- [AI SDK 개요](./index.md)
-- [프로바이더](./providers.md)

package/templates/hono/docs/library/ai-sdk/providers.md

@@ -1,102 +0,0 @@
-# AI SDK - 프로바이더
-
-> 다양한 AI 프로바이더 설정
-
----
-
-## 설치
-
-```bash
-npm install @ai-sdk/openai      # OpenAI
-npm install @ai-sdk/anthropic   # Claude
-npm install @ai-sdk/google      # Gemini
-npm install @ai-sdk/mistral     # Mistral
-npm install @ai-sdk/groq        # Groq
-```
-
----
-
-## OpenAI
-
-```typescript
-import { openai } from '@ai-sdk/openai'
-
-const result = streamText({
-  model: openai('gpt-4o'),
-  messages,
-})
-```
-
-### Cloudflare Workers
-
-```typescript
-import { createOpenAI } from '@ai-sdk/openai'
-
-type Bindings = { OPENAI_API_KEY: string }
-const app = new Hono<{ Bindings: Bindings }>()
-
-app.post('/api/chat', async (c) => {
-  const openai = createOpenAI({ apiKey: c.env.OPENAI_API_KEY })
-  const result = streamText({ model: openai('gpt-4o'), messages })
-  return result.toUIMessageStreamResponse()
-})
-```
-
-### 모델
-
-| 모델 | 설명 |
-|------|------|
-| `gpt-4o` | GPT-4 Omni |
-| `gpt-4o-mini` | 경량 GPT-4o |
-| `o1` | 추론 최적화 |
-
----
-
-## Anthropic (Claude)
-
-```typescript
-import { anthropic } from '@ai-sdk/anthropic'
-
-const result = streamText({
-  model: anthropic('claude-3-5-sonnet-latest'),
-  messages,
-})
-```
-
-### 모델
-
-| 모델 | 설명 |
-|------|------|
-| `claude-3-5-sonnet-latest` | Claude 3.5 Sonnet |
-| `claude-3-opus-latest` | Claude 3 Opus |
-| `claude-3-haiku-latest` | 경량 모델 |
-
----
-
-## Google (Gemini)
-
-```typescript
-import { google } from '@ai-sdk/google'
-
-const result = streamText({
-  model: google('gemini-1.5-pro'),
-  messages,
-})
-```
-
----
-
-## 환경 변수
-
-```bash
-OPENAI_API_KEY=sk-...
-ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_GENERATIVE_AI_API_KEY=...
-```
-
----
-
-## 관련 문서
-
-- [AI SDK 개요](./index.md)
-- [OpenRouter](./openrouter.md)

package/templates/hono/docs/library/ai-sdk/streaming.md

@@ -1,146 +0,0 @@
-# AI SDK - 텍스트 생성 & 스트리밍
-
-> generateText, streamText 사용법
-
----
-
-## generateText
-
-한 번에 텍스트 생성 (비스트리밍).
-
-```typescript
-import { generateText } from 'ai'
-import { openai } from '@ai-sdk/openai'
-
-app.post('/api/generate', async (c) => {
-  const { prompt } = await c.req.json()
-
-  const { text, usage, finishReason } = await generateText({
-    model: openai('gpt-4o'),
-    prompt,
-  })
-
-  return c.json({ text, usage, finishReason })
-})
-```
-
-### 시스템 프롬프트
-
-```typescript
-const { text } = await generateText({
-  model: openai('gpt-4o'),
-  system: 'You are a helpful coding assistant.',
-  prompt,
-})
-```
-
-### 메시지 형식
-
-```typescript
-const { text } = await generateText({
-  model: openai('gpt-4o'),
-  messages: [
-    { role: 'user', content: 'Hello!' },
-    { role: 'assistant', content: 'Hi!' },
-    { role: 'user', content: 'How are you?' },
-  ],
-})
-```
-
----
-
-## streamText
-
-실시간 텍스트 스트리밍.
-
-```typescript
-import { streamText } from 'ai'
-
-app.post('/api/stream', async (c) => {
-  const { prompt } = await c.req.json()
-
-  const result = streamText({
-    model: openai('gpt-4o'),
-    prompt,
-  })
-
-  return result.toUIMessageStreamResponse()
-})
-```
-
-### 스트림 응답 타입
-
-```typescript
-// UI 메시지 스트림 (프론트엔드용)
-return result.toUIMessageStreamResponse()
-
-// 텍스트 스트림 (SSE)
-return result.toTextStreamResponse()
-
-// Data 스트림
-return result.toDataStreamResponse()
-```
-
-### 커스텀 스트림 처리
-
-```typescript
-import { stream } from 'hono/streaming'
-
-app.post('/api/custom-stream', async (c) => {
-  const { prompt } = await c.req.json()
-
-  const result = streamText({
-    model: openai('gpt-4o'),
-    prompt,
-  })
-
-  return stream(c, async (stream) => {
-    for await (const chunk of result.textStream) {
-      await stream.write(chunk)
-    }
-  })
-})
-```
-
----
-
-## 옵션
-
-```typescript
-const result = streamText({
-  model: openai('gpt-4o'),
-  prompt,
-  temperature: 0.7,     // 창의성 (0-2)
-  maxTokens: 1000,      // 최대 토큰
-  topP: 0.9,            // 누적 확률
-  frequencyPenalty: 0,  // 반복 페널티
-  presencePenalty: 0,   // 존재 페널티
-  stopSequences: ['---'], // 중단 시퀀스
-})
-```
-
----
-
-## 스트림 이벤트
-
-```typescript
-const result = streamText({
-  model: openai('gpt-4o'),
-  prompt,
-  onChunk: ({ chunk }) => {
-    console.log('Chunk:', chunk)
-  },
-  onFinish: ({ text, usage, finishReason }) => {
-    console.log('Finished:', text)
-    console.log('Usage:', usage)
-  },
-})
-```
-
----
-
-## 관련 문서
-
-- [AI SDK 개요](./index.md)
-- [도구](./tools.md)
-- [구조화된 출력](./structured-output.md)

package/templates/hono/docs/library/ai-sdk/structured-output.md

@@ -1,161 +0,0 @@
-# AI SDK - 구조화된 출력
-
-> Zod 스키마로 타입 안전한 객체 생성
-
----
-
-## generateObject
-
-```typescript
-import { generateObject } from 'ai'
-import { openai } from '@ai-sdk/openai'
-import { z } from 'zod'
-
-const userSchema = z.object({
-  name: z.string(),
-  age: z.number(),
-  email: z.email(),
-})
-
-app.post('/api/generate-user', async (c) => {
-  const { prompt } = await c.req.json()
-
-  const { object } = await generateObject({
-    model: openai('gpt-4o'),
-    schema: userSchema,
-    prompt,
-  })
-
-  // object: { name: string, age: number, email: string }
-  return c.json(object)
-})
-```
-
----
-
-## 복잡한 스키마
-
-```typescript
-const recipeSchema = z.object({
-  name: z.string().describe('Recipe name'),
-  ingredients: z.array(
-    z.object({
-      name: z.string(),
-      amount: z.string(),
-      unit: z.string().optional(),
-    })
-  ),
-  steps: z.array(z.string()),
-  prepTime: z.number().describe('Prep time in minutes'),
-  cookTime: z.number().describe('Cook time in minutes'),
-  difficulty: z.enum(['easy', 'medium', 'hard']),
-})
-
-app.post('/api/recipe', async (c) => {
-  const { dish } = await c.req.json()
-
-  const { object } = await generateObject({
-    model: openai('gpt-4o'),
-    schema: recipeSchema,
-    prompt: `Generate a recipe for ${dish}.`,
-  })
-
-  return c.json(object)
-})
-```
-
----
-
-## streamObject
-
-스트리밍으로 객체 생성.
-
-```typescript
-import { streamObject } from 'ai'
-
-app.post('/api/stream-user', async (c) => {
-  const { prompt } = await c.req.json()
-
-  const result = streamObject({
-    model: openai('gpt-4o'),
-    schema: userSchema,
-    prompt,
-  })
-
-  return result.toTextStreamResponse()
-})
-```
-
-### 부분 객체 수신
-
-```typescript
-const result = streamObject({
-  model: openai('gpt-4o'),
-  schema: userSchema,
-  prompt,
-})
-
-for await (const partialObject of result.partialObjectStream) {
-  console.log('Partial:', partialObject)
-  // { name: 'Jo' }
-  // { name: 'John', age: 25 }
-  // { name: 'John', age: 25, email: 'john@...' }
-}
-```
-
----
-
-## 출력 모드
-
-```typescript
-// Array 모드
-const { object } = await generateObject({
-  model: openai('gpt-4o'),
-  output: 'array',
-  schema: z.object({ name: z.string(), role: z.string() }),
-  prompt: 'List 5 team members.',
-})
-// object: [{ name: 'Alice', role: 'Engineer' }, ...]
-
-// Enum 모드
-const { object } = await generateObject({
-  model: openai('gpt-4o'),
-  output: 'enum',
-  enum: ['positive', 'negative', 'neutral'],
-  prompt: 'Classify the sentiment: "I love this product!"',
-})
-// object: 'positive'
-```
-
----
-
-## 에러 처리
-
-```typescript
-import { NoObjectGeneratedError, InvalidResponseDataError } from 'ai'
-
-try {
-  const { object } = await generateObject({
-    model: openai('gpt-4o'),
-    schema: userSchema,
-    prompt,
-  })
-  return c.json(object)
-} catch (error) {
-  if (error instanceof NoObjectGeneratedError) {
-    return c.json({ error: 'Failed to generate object' }, 500)
-  }
-  if (error instanceof InvalidResponseDataError) {
-    return c.json({ error: 'Invalid response format' }, 500)
-  }
-  throw error
-}
-```
-
----
-
-## 관련 문서
-
-- [AI SDK 개요](./index.md)
-- [스트리밍](./streaming.md)
-- [도구](./tools.md)

package/templates/hono/docs/library/ai-sdk/tools.md

@@ -1,144 +0,0 @@
-# AI SDK - Tool Calling
-
-> AI 모델이 외부 함수를 호출
-
----
-
-## 기본 도구 정의
-
-```typescript
-import { streamText, tool, convertToModelMessages } from 'ai'
-import { openai } from '@ai-sdk/openai'
-import { z } from 'zod'
-
-app.post('/api/chat', async (c) => {
-  const { messages } = await c.req.json()
-
-  const result = streamText({
-    model: openai('gpt-4o'),
-    messages: convertToModelMessages(messages),
-    tools: {
-      getWeather: tool({
-        description: 'Get the weather for a location',
-        inputSchema: z.object({
-          location: z.string().describe('The city name'),
-        }),
-        execute: async ({ location }) => {
-          return { location, temperature: 22, condition: 'Sunny' }
-        },
-      }),
-    },
-  })
-
-  return result.toUIMessageStreamResponse()
-})
-```
-
----
-
-## tool() 구조
-
-```typescript
-import { tool } from 'ai'
-import { z } from 'zod'
-
-const myTool = tool({
-  description: 'Tool description for the AI',
-  inputSchema: z.object({
-    param1: z.string().describe('Parameter description'),
-    param2: z.number().optional(),
-  }),
-  execute: async (args, context) => {
-    // args: 스키마에 맞는 입력값
-    // context: { toolCallId, messages }
-    return { result: 'success' }
-  },
-})
-```
-
----
-
-## 여러 도구
-
-```typescript
-const result = streamText({
-  model: openai('gpt-4o'),
-  messages: convertToModelMessages(messages),
-  tools: {
-    getWeather: tool({
-      description: 'Get weather',
-      inputSchema: z.object({ location: z.string() }),
-      execute: async ({ location }) => {
-        return { temperature: 22, condition: 'Sunny' }
-      },
-    }),
-    searchDatabase: tool({
-      description: 'Search the database',
-      inputSchema: z.object({ query: z.string() }),
-      execute: async ({ query }) => {
-        return { results: [] }
-      },
-    }),
-    sendEmail: tool({
-      description: 'Send an email',
-      inputSchema: z.object({
-        to: z.email(),
-        subject: z.string(),
-        body: z.string(),
-      }),
-      execute: async (args) => {
-        return { sent: true }
-      },
-    }),
-  },
-})
-```
-
----
-
-## 다단계 도구 호출
-
-```typescript
-import { generateText } from 'ai'
-
-const { text, steps } = await generateText({
-  model: openai('gpt-4o'),
-  messages: convertToModelMessages(messages),
-  tools: { ... },
-  maxSteps: 5, // 최대 도구 호출 횟수
-})
-
-// steps: 각 단계의 도구 호출 정보
-```
-
----
-
-## 도구 선택 제어
-
-```typescript
-const result = streamText({
-  model: openai('gpt-4o'),
-  messages,
-  tools: { ... },
-
-  // 도구 사용 강제
-  toolChoice: 'required',
-
-  // 특정 도구만
-  toolChoice: { type: 'tool', toolName: 'getWeather' },
-
-  // 도구 사용 금지
-  toolChoice: 'none',
-
-  // 자동 (기본)
-  toolChoice: 'auto',
-})
-```
-
----
-
-## 관련 문서
-
-- [AI SDK 개요](./index.md)
-- [스트리밍](./streaming.md)
-- [구조화된 출력](./structured-output.md)