Method chat

backend/src/chat/chat.controller.ts:19–66

(
    @Body() chatDto: ChatRestDto,
    @Res() res: Response,
    @GetAuthToken() userId: string,
  )

import { WorkspaceService } from '../project/workspace.service';
import type { ChangedFile } from '../project/workspace';
import { lintArtifact, type LintFinding } from './lint-artifact';
import { validateExternalApiBaseUrl } from './external-url';
import {
  atTurnLimit,
  busy,
  queueForProject,
  turnLimit,
  withUserTurn,
} from '../project/project-queue';
import { scenarioOfPage } from '../project/scenarios';
import { clipNotes, HISTORY_TURNS } from './instructions';

/**
 * Best-effort label for what a tool call is acting on. Tool arguments arrive as
 * a JSON string whose shape is the tool's own, so this reads the keys the
 * built-in file tools happen to use and gives up quietly otherwise.
 */
const PATH_KEYS = ['file_path', 'filePath', 'path', 'notebook_path'];

const targetOf = (input: unknown): string | undefined => {
  // Typed as a string, but tolerate an already-parsed object: the label is a
  // nicety and must never be the reason a turn fails.
  let args: any = input;
  if (typeof args === 'string') {
    try {
      args = JSON.parse(args);
    } catch {
      return args.length <= 40 ? args : undefined;
    }
  }
  if (!args || typeof args !== 'object') return undefined;

  for (const key of PATH_KEYS) {
    const value = args[key];
    if (typeof value === 'string' && value) return value.split('/').pop();
  }
  if (typeof args.command === 'string') return args.command.slice(0, 40);
  if (typeof args.pattern === 'string') return args.pattern.slice(0, 40);
  return undefined;
};

@Controller('api/chat')
@UseGuards(JWTAuthGuard, ChatGuard)
export class ChatController {
  private readonly logger = new Logger(ChatController.name);

  constructor(
    private readonly chatService: ChatService,
    private readonly workspaces: WorkspaceService,
    @InjectRepository(AgentTurn)
    private readonly turns: Repository<AgentTurn>,