Method createRun

src/node/services/devToolsService.ts:173–206

(workspaceId: string, run: DevToolsRun, metadataId?: string)

  }

  async createRun(workspaceId: string, run: DevToolsRun, metadataId?: string): Promise<void> {
    if (!this.enabled) {
      return;
    }

    assert(workspaceId.trim().length > 0, "DevToolsService.createRun requires a workspaceId");
    assert(run.workspaceId === workspaceId, "DevToolsService.createRun run/workspace mismatch");

    await this.ensureLoaded(workspaceId);
    const data = this.getOrCreateWorkspaceData(workspaceId);

    // Apply queued run metadata (for example, effective tool policy) captured
    // before the stream reached provider middleware. Lookup is keyed by request
    // metadata ID so overlapping requests cannot overwrite each other.
    const byWorkspace = this.pendingRunMetadata.get(workspaceId);
    const normalizedMetadataId = metadataId?.trim();
    if (byWorkspace && normalizedMetadataId != null && normalizedMetadataId.length > 0) {
      const pendingMetadata = byWorkspace.get(normalizedMetadataId);
      if (pendingMetadata != null) {
        Object.assign(run, pendingMetadata);
        byWorkspace.delete(normalizedMetadataId);
      }

      if (byWorkspace.size === 0) {
        this.pendingRunMetadata.delete(workspaceId);
      }
    }

    data.runs.set(run.id, run);
    await this.appendToFile(workspaceId, { type: "run", run });

    const summary = this.buildRunSummary(data, run.id);
    this.emitWorkspaceEvent(workspaceId, { type: "run-created", run: summary });
  }

  async createStep(workspaceId: string, step: DevToolsStep): Promise<void> {
    if (!this.enabled) {