Dropstone SDK

npm install @blankline/dropstone-sdk

import { createDropstoneApi } from "@blankline/dropstone-sdk"

// 환경에서 DROPSTONE_API_KEY를 자동으로 읽습니다.
const dropstone = createDropstoneApi()

const resp = await dropstone.chat.completions.create({
  model: "dropstone-fast", // 또는 "dropstone-pro" / "dropstone-heavy"
  messages: [{ role: "user", content: "디버깅에 관한 하이쿠를 써 주세요." }],
})

console.log(resp.choices[0].message.content)
console.log("비용: $" + resp.usage?.cost) // 청구 금액 (USD)

export DROPSTONE_API_KEY=dsk_live_...

const stream = await dropstone.chat.completions.create({
  model: "dropstone-fast",
  stream: true,
  messages: [{ role: "user", content: "5까지 세어 보세요." }],
})

for await (const chunk of stream) {
  process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "")
}

import { createDropstone } from "@blankline/dropstone-sdk"

const { client } = await createDropstone()

const { client } = await createDropstone({
  config: {
    provider: {
      dropstone: {
        options: {
          apiKey: process.env.DROPSTONE_API_KEY,
          baseURL: "https://api.dropstone.io/api/v1",
        },
      },
    },
    permission: { "*": "deny", read: "allow", edit: "allow", glob: "allow", grep: "allow", bash: "allow" },
  },
})

import { createDropstone } from "@blankline/dropstone-sdk"

const dropstone = await createDropstone({
  hostname: "127.0.0.1",
  port: 4096,
  config: {
    model: "dropstone/dropstone-pro",
  },
})

console.log(`서버가 ${dropstone.server.url}에서 실행 중입니다`)

dropstone.server.close()

const { client } = await createDropstone()

const session = await client.session.create({ body: { title: "메모리 가르치기" } })

await client.session.prompt({
  path: { id: session.data.id },
  body: {
    parts: [{ type: "text", text: "이것을 상시 규칙으로 기억하세요: 항상 bun을 사용하고 npm을 사용하지 마세요." }],
  },
})

import { createDropstoneClient } from "@blankline/dropstone-sdk"

const client = createDropstoneClient({
  baseUrl: "http://localhost:4096",
})

import type { Session, Message, Part } from "@blankline/dropstone-sdk"

try {
  await client.session.get({ path: { id: "invalid-id" } })
} catch (error) {
  console.error("세션을 가져오지 못했습니다:", (error as Error).message)
}

const result = await client.session.prompt({
  path: { id: sessionId },
  body: {
    parts: [{ type: "text", text: "Dropstone을 조사하고 회사 정보를 제공하세요" }],
    format: {
      type: "json_schema",
      schema: {
        type: "object",
        properties: {
          company: { type: "string", description: "회사 이름" },
          founded: { type: "number", description: "설립 연도" },
          products: {
            type: "array",
            items: { type: "string" },
            description: "주요 제품",
          },
        },
        required: ["company", "founded"],
      },
    },
  },
})

// 구조화된 출력에 접근
console.log(result.data.info.structured_output)
// { company: "Dropstone", founded: 2024, products: ["Dropstone CLI"] }

if (result.data.info.error?.name === "StructuredOutputError") {
  console.error("구조화된 출력을 생성하지 못했습니다:", result.data.info.error.message)
  console.error("시도 횟수:", result.data.info.error.retries)
}

const health = await client.global.health()
console.log(health.data.version)

// 로그 항목 작성
await client.app.log({
  body: {
    service: "my-app",
    level: "info",
    message: "작업 완료",
  },
})

// 사용 가능한 에이전트 나열
const agents = await client.app.agents()

// 모든 프로젝트 나열
const projects = await client.project.list()

// 현재 프로젝트 가져오기
const currentProject = await client.project.current()

// 현재 경로 정보 가져오기
const pathInfo = await client.path.get()

const config = await client.config.get()

// 세션 생성 및 관리
const session = await client.session.create({
  body: { title: "내 세션" },
})

const sessions = await client.session.list()

// 프롬프트 메시지 보내기
const result = await client.session.prompt({
  path: { id: session.data.id },
  body: {
    model: { providerID: "dropstone", modelID: "dropstone-pro" },
    parts: [{ type: "text", text: "안녕하세요!" }],
  },
})

// AI 응답 없이 컨텍스트 주입 (플러그인에 유용)
await client.session.prompt({
  path: { id: session.data.id },
  body: {
    noReply: true,
    parts: [{ type: "text", text: "당신은 유용한 비서입니다." }],
  },
})

// 파일 검색 및 읽기
const textResults = await client.find.text({
  query: { pattern: "function.*dropstone" },
})

const files = await client.find.files({
  query: { query: "*.ts", type: "file" },
})

const directories = await client.find.files({
  query: { query: "packages", type: "directory", limit: 20 },
})

const content = await client.file.read({
  query: { path: "src/index.ts" },
})

await client.auth.set({
  path: { id: "dropstone" },
  body: { type: "api", key: "your-dropstone-api-key" },
})

// 실시간 이벤트 수신
const events = await client.event.subscribe()
for await (const event of events.stream) {
  console.log("이벤트:", event.type, event.properties)
}

import { createDropstone } from "@blankline/dropstone-sdk/v2"

const { client, server } = await createDropstone()
// v2는 더 풍부한 리소스 계층을 노출합니다: workspace, worktree, file, find 등
const files = await client.file.list({ path: "src" })