Function generateWorkspaceIdentity

src/node/services/workspaceTitleGenerator.ts:181–287

(
  message: string,
  candidates: string[],
  aiService: AIService,
  /** Optional conversation turns context used for regenerate-title prompts. */
  conversationContext?: string,
  /** Optional most recent user message; included as additional context only — not given precedence over older turns. */
  latestUserMessage?: string
)

}

export async function generateWorkspaceIdentity(
  message: string,
  candidates: string[],
  aiService: AIService,
  /** Optional conversation turns context used for regenerate-title prompts. */
  conversationContext?: string,
  /** Optional most recent user message; included as additional context only — not given precedence over older turns. */
  latestUserMessage?: string
): Promise<Result<GenerateWorkspaceIdentityResult, NameGenerationError>> {
  if (candidates.length === 0) {
    return Err({ type: "unknown", raw: "No model candidates provided for name generation" });
  }

  // Try up to 3 candidates
  const maxAttempts = Math.min(candidates.length, 3);

  // Track the last classified error to return if all candidates fail
  let lastError: NameGenerationError | null = null;

  for (let i = 0; i < maxAttempts; i++) {
    const modelString = candidates[i];

    const modelResult = await aiService.createModel(modelString, undefined, {
      agentInitiated: true,
    });
    if (!modelResult.success) {
      lastError = mapModelCreationError(modelResult.error, modelString);
      log.debug(`Name generation: skipping ${modelString} (${modelResult.error.type})`);
      continue;
    }

    try {
      // Use streamText with a propose_name tool instead of Output.object().
      // Tool calls are universally supported across LLM APIs and far more
      // reliable than structured JSON output, eliminating all the fragile
      // regex fallback parsing that was previously needed.
      //
      // streamText (not generateText): the Codex OAuth endpoint requires
      // stream:true in the request body; streamText sets it automatically.
      //
      // No toolChoice — forced tool choice (toolChoice: "required" / "any" /
      // { type: "tool" }) is incompatible with extended thinking models.
      // Instead, the prompt instructs the model to call the tool, and the
      // name_workspace builtin agent declares tools.require: [propose_name]
      // which the StreamManager enforces via stopWhen for full agent sessions.
      // For this direct streamText path, the candidate retry loop handles the
      // (rare) case where the model ignores the instruction.
      const currentStream = streamText({
        model: modelResult.data,
        prompt: buildWorkspaceIdentityPrompt(message, conversationContext, latestUserMessage),
        tools: {
          // Defined inline so TypeScript preserves full schema inference on
          // toolResult.output (the propose_name tool is only used here).
          propose_name: tool({
            description: TOOL_DEFINITIONS.propose_name.description,
            inputSchema: ProposeNameToolArgsSchema,
            // eslint-disable-next-line @typescript-eslint/require-await -- AI SDK Tool.execute must return a Promise
            execute: async (args) => ({ success: true as const, ...args }),