Function updateAgentMetadata

extensions/cli/src/util/exit.ts:104–137

(
  options?: ChatHistoryItem[] | UpdateAgentMetadataOptions,
)

 * @param options - Options including history and completion state
 */
export async function updateAgentMetadata(
  options?: ChatHistoryItem[] | UpdateAgentMetadataOptions,
): Promise<void> {
  // Support both old signature (history array) and new signature (options object)
  const { history, isComplete } = Array.isArray(options)
    ? { history: options, isComplete: false }
    : { history: options?.history, isComplete: options?.isComplete ?? false };

  try {
    const agentId = getAgentIdFromArgs();
    if (!agentId) {
      logger.debug("No agent ID found, skipping metadata update");
      return;
    }

    const metadata: Record<string, any> = {};
    const hasChanges = await collectDiffStats(metadata);

    if (isComplete) {
      metadata.isComplete = true;
      metadata.hasChanges = hasChanges;
    }

    collectSummary(metadata, history);
    collectSessionUsage(metadata);

    if (Object.keys(metadata).length > 0) {
      await postAgentMetadata(agentId, metadata);
    }
  } catch (err) {
    // Non-critical: log but don't fail the process
    logger.debug("Error in updateAgentMetadata (ignored)", err as any);
  }
}

/**
 * Display session usage breakdown in verbose mode