claude-code-best/src/utils/systemPrompt.ts
James Feng 0c01c93e80 Phase 2a: mechanical dedup — import rewrite to canonical package
- Migrated src/tools/-only files into packages/builtin-tools/src/tools/
- Rewrote all src/tools/ imports to @claude-code-best/builtin-tools/tools/
- Deleted 121 identical duplicate files from src/tools/
- 238 drifted files preserved in src/tools/ for Phase 2b manual merge
- 359 files changed: 914 insertions, 4042 deletions

Build: 568 files bundled ✓
Test: 3340 pass / 4 fail (baseline) ✓
2026-06-03 13:54:22 +08:00

120 lines
4.5 KiB
TypeScript

import { feature } from 'bun:bundle'
import {
type AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
logEvent,
} from '../services/analytics/index.js'
import type { ToolUseContext } from '../Tool.js'
import type { AgentDefinition } from '@claude-code-best/builtin-tools/tools/AgentTool/loadAgentsDir.js'
import { isBuiltInAgent } from '@claude-code-best/builtin-tools/tools/AgentTool/loadAgentsDir.js'
import { isEnvTruthy } from './envUtils.js'
import { asSystemPrompt, type SystemPrompt } from './systemPromptType.js'
import * as proactiveModuleValue from '../proactive/index.js'
export { asSystemPrompt, type SystemPrompt } from './systemPromptType.js'
const proactiveModule =
feature('PROACTIVE') || feature('KAIROS')
? proactiveModuleValue
: null
function isProactiveActive_SAFE_TO_CALL_ANYWHERE(): boolean {
return proactiveModule?.isProactiveActive() ?? false
}
/**
* Builds the effective system prompt array based on priority:
* 0. Override system prompt (if set, e.g., via loop mode - REPLACES all other prompts)
* 1. Coordinator system prompt (if coordinator mode is active)
* 2. Agent system prompt (if mainThreadAgentDefinition is set)
* - In proactive mode: agent prompt is APPENDED to default (agent adds domain
* instructions on top of the autonomous agent prompt, like teammates do)
* - Otherwise: agent prompt REPLACES default
* 3. Custom system prompt (if specified via --system-prompt)
* 4. Default system prompt (the standard Claude Code prompt)
*
* Plus appendSystemPrompt is always added at the end if specified (except when override is set).
*/
export function buildEffectiveSystemPrompt({
mainThreadAgentDefinition,
toolUseContext,
customSystemPrompt,
defaultSystemPrompt,
appendSystemPrompt,
overrideSystemPrompt,
}: {
mainThreadAgentDefinition: AgentDefinition | undefined
toolUseContext: Pick<ToolUseContext, 'options'>
customSystemPrompt: string | undefined
defaultSystemPrompt: string[]
appendSystemPrompt: string | undefined
overrideSystemPrompt?: string | null
}): SystemPrompt {
if (overrideSystemPrompt) {
return asSystemPrompt([overrideSystemPrompt])
}
// Coordinator mode: use coordinator prompt instead of default
// Use inline env check instead of coordinatorModule to avoid circular
// dependency issues during test module loading.
if (
feature('COORDINATOR_MODE') &&
isEnvTruthy(process.env.CLAUDE_CODE_COORDINATOR_MODE) &&
!mainThreadAgentDefinition
) {
// Lazy require to avoid circular dependency at module load time
const { getCoordinatorSystemPrompt } =
// eslint-disable-next-line @typescript-eslint/no-require-imports
require('../coordinator/coordinatorMode.js') as typeof import('../coordinator/coordinatorMode.js')
return asSystemPrompt([
getCoordinatorSystemPrompt(),
...(appendSystemPrompt ? [appendSystemPrompt] : []),
])
}
const agentSystemPrompt = mainThreadAgentDefinition
? isBuiltInAgent(mainThreadAgentDefinition)
? mainThreadAgentDefinition.getSystemPrompt({
toolUseContext: { options: toolUseContext.options },
})
: mainThreadAgentDefinition.getSystemPrompt()
: undefined
// Log agent memory loaded event for main loop agents
if (mainThreadAgentDefinition?.memory) {
logEvent('tengu_agent_memory_loaded', {
...(process.env.USER_TYPE === 'ant' && {
agent_type:
mainThreadAgentDefinition.agentType as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
}),
scope:
mainThreadAgentDefinition.memory as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
source:
'main-thread' as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
})
}
// In proactive mode, agent instructions are appended to the default prompt
// rather than replacing it. The proactive default prompt is already lean
// (autonomous agent identity + memory + env + proactive section), and agents
// add domain-specific behavior on top — same pattern as teammates.
if (
agentSystemPrompt &&
(feature('PROACTIVE') || feature('KAIROS')) &&
isProactiveActive_SAFE_TO_CALL_ANYWHERE()
) {
return asSystemPrompt([
...defaultSystemPrompt,
`\n# Custom Agent Instructions\n${agentSystemPrompt}`,
...(appendSystemPrompt ? [appendSystemPrompt] : []),
])
}
return asSystemPrompt([
...(agentSystemPrompt
? [agentSystemPrompt]
: customSystemPrompt
? [customSystemPrompt]
: defaultSystemPrompt),
...(appendSystemPrompt ? [appendSystemPrompt] : []),
])
}