Function createCodeModeSystemPrompt

packages/ai-code-mode/src/create-system-prompt.ts:28–110

(config: CodeModeToolConfig)

 * ```
 */
export function createCodeModeSystemPrompt(config: CodeModeToolConfig): string {
  const { tools } = config
  const include = config.lazyToolsConfig?.includeDescription ?? 'none'

  const eagerTools = tools.filter((t) => !t.lazy)
  const lazyTools = tools.filter((t) => t.lazy)

  // Only eager tools get full type stubs + doc lines.
  const bindings = toolsToBindings(eagerTools, 'external_')
  const typeStubs = generateTypeStubs(bindings)

  const functionDocs = Object.entries(bindings)
    .map(([name, binding]) => `- \`${name}(input)\`: ${binding.description}`)
    .join('\n')

  const discoverableSection =
    lazyTools.length > 0
      ? `

### Discoverable APIs

These additional functions are available but not yet documented. Before calling \`external_<name>\` for any of them inside \`execute_typescript\`, call the \`discover_tools\` tool with their names to get full TypeScript signatures:

${lazyTools
  .map(
    (t) =>
      `- ${renderLazyCatalogEntry(`external_${t.name}`, t.description, include)}`,
  )
  .join('\n')}`
      : ''

  return `## Code Execution Tool

You have access to \`execute_typescript\` which runs TypeScript code in a sandboxed environment.

### When to Use

Use \`execute_typescript\` when you need to:
- Process data with loops, conditionals, or complex logic
- Make multiple API calls in parallel (Promise.all)
- Transform, filter, or aggregate data
- Perform calculations or data analysis

For simple operations, prefer calling tools directly.

### Available External APIs

Inside your TypeScript code, you can call these async functions:

${functionDocs}

### Type Definitions

\`\`\`typescript
${typeStubs}
\`\`\`${discoverableSection}

### Example