DeepSeek Harness: 依存関係の宣言：inject

import { Context } from '@deepseek-ai/cordis'

export const name = 'my-tool'
export const inject = ['tools', 'llm']

export function apply(ctx: Context) {
  // apply が呼び出される時点で ctx.tools と ctx.llm は確実に準備完了
  ctx.logger.info('tools ready:', !!ctx.tools)
  ctx.logger.info('llm ready:', !!ctx.llm)
}

export default {
  name: 'my-tool',
  inject: ['tools', 'llm'],
  apply(ctx: Context) {
    // ...
  }
}

export default class MyPlugin {
  static name = 'my-tool'
  static inject = ['tools', 'llm']
  
  constructor(private ctx: Context) {
    // ...
  }
}

// ❌ inject を宣言せず、サービスを直接使用
export function apply(ctx: Context) {
  ctx.tools.register(...)  // ランタイムエラー：ctx.tools が undefined の可能性
}

export const inject = ['tools', 'llm']

export function apply(ctx: Context) {
  // ctx.tools — ツールサービス
  ctx.tools.register({
    name: 'my_tool',
    // ...
  })

  // ctx.llm — LLM サービス
  const response = await ctx.llm.complete({
    messages: [{ role: 'user', content: 'hello' }]
  })
}

// inject = ['tools'] → ctx.tools: ToolsService
// inject = ['llm']   → ctx.llm: LLMService
// inject = ['tools', 'llm'] → ctx.tools + ctx.llm 両方が型付き

plugins:
  plugin-c: ...
  plugin-a: ...
  plugin-b: ...

フェーズ 1：依存関係のないプラグインをロード → [core, logger]
フェーズ 2：フェーズ 1 に依存するプラグインをロード → [tools, sessions]
フェーズ 3：フェーズ 2 に依存するプラグインをロード → [my-plugin, other-plugin]
...

export const inject = ['tools', 'llm?']

export const inject = ['tools', 'llm?']

export function apply(ctx: Context) {
  // tools は常に存在
  ctx.tools.register(...)

  // llm は存在しない可能性あり
  if (ctx.llm) {
    ctx.llm.complete(...)
  } else {
    ctx.logger.warn('llm not available, skipping LLM features')
  }
}

export const inject = ['tools', 'search?']

export function apply(ctx: Context) {
  ctx.tools.register({
    name: 'smart_search',
    async execute(params) {
      if (ctx.search) {
        return ctx.search.query(params.query)
      }
      return 'search service not available'
    }
  })
}

A inject: ['B']
B inject: ['A']

Error: Circular dependency detected:
  plugin-a → plugin-b → plugin-a
  
Please review your inject declarations.

変更前：A → B → A
変更後：A → C, B → C

// A は B に直接依存せず、イベントをリッスン
export const inject = []

export function apply(ctx: Context) {
  ctx.on('b/ready', (bService) => {
    // A は依存を宣言せずに B の機能を使用
  })
}

// A は B にオプションで依存
export const inject = ['B?']

export function apply(ctx: Context) {
  if (ctx.B) {
    // B を使用
  }
}

A → B → C → A

// プロバイダプラグインがサービスを登録
ctx.provide('tools', toolsInstance)

// コンシューマプラグインがサービスを検出
const tools = ctx.get('tools')

// フレームワーク内部の型マッピング
interface Context {
  tools: ToolsService      // inject に 'tools' が含まれる場合
  llm: LLMService          // inject に 'llm' が含まれる場合
  sessions: SessionService // inject に 'sessions' が含まれる場合
  // ...
}