xc-mcp/dist/tools/cache/list-cached.d.ts

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

/**
 * List recent cached build/test results for progressive disclosure retrieval
 *
 * **What it does:**
 * Displays recently cached build and test operation results with summary metadata. Essential for
 * progressive disclosure pattern - shows lightweight identifiers and summaries that can be used to
 * retrieve full details on demand. Prevents token overflow by avoiding large log dumps in initial
 * responses. Can filter by specific tool or show all cached responses.
 *
 * **Why you'd use it:**
 * - Find cached build/test IDs to retrieve full logs via xcodebuild-get-details
 * - Monitor which operations are cached and available for detailed inspection
 * - Track cache usage patterns and understand what's consuming cache storage
 * - Identify recent failed builds/tests for debugging without overwhelming token budgets
 *
 * **Parameters:**
 * - tool (string, optional): Filter by specific tool name (e.g., "xcodebuild-test")
 * - limit (number, optional): Maximum number of entries to return. Defaults to 10
 *
 * **Returns:**
 * JSON object containing:
 * - cacheStats: Overall cache statistics (totalEntries, byTool breakdown)
 * - recentResponses: Array of cached entries with id, tool, timestamp, exitCode, output sizes
 * - usage: Guidance on how to retrieve full details using cached IDs
 *
 * **Example:**
 * ```typescript
 * // List all recent cached responses
 * await listCachedResponsesTool({limit: 10});
 *
 * // List only cached test results
 * await listCachedResponsesTool({tool: "xcodebuild-test", limit: 5});
 *
 * // Returns:
 * // {
 * //   "recentResponses": [
 * //     {
 * //       "id": "test_abc123",
 * //       "tool": "xcodebuild-test",
 * //       "exitCode": 0,
 * //       "outputSize": 125000,
 * //       "summary": {"totalTests": 45, "passed": 42, "failed": 3}
 * //     }
 * //   ],
 * //   "usage": {
 * //     "note": "Use xcodebuild-get-details with any ID to retrieve full details"
 * //   }
 * // }
 * ```
 *
 * **Full documentation:** See cache/list-cached.md for detailed parameters and examples
 *
 * @param args Tool arguments with optional tool filter and limit
 * @returns Tool result with cached response listings
 */
export declare function listCachedResponsesTool(args: any): Promise<{
    content: {
        type: "text";
        text: string;
    }[];
}>;
export declare const CACHE_LIST_CACHED_RESPONSES_DOCS = "\n# list-cached-responses\n\n\uD83D\uDCCB **List cached build and test results with progressive disclosure** - View recent operations.\n\nRetrieve recent cached build/test results with ability to drill down into full logs via progressive disclosure pattern.\n\n## Advantages\n\n\u2022 Access recent build and test results without re-running operations\n\u2022 Drill down into full logs using returned cache IDs\n\u2022 Filter by specific tool to find relevant operations\n\u2022 Understand cache age and expiry information\n\n## Parameters\n\n### Optional\n- `limit` (number, default: 10): Maximum number of cached responses to return\n- `tool` (string): Filter by specific tool (optional)\n\n## Returns\n\n- List of recent cache entries with IDs\n- Summary information for each cached operation\n- Cache expiry times\n- References for accessing full details\n\n## Related Tools\n\n- `xcodebuild-get-details` - Retrieve full build logs from cache ID\n- `xcodebuild-test` - Run tests (generates new cache entries)\n- `cache-get-stats` - View cache performance statistics\n- `cache-clear` - Clear specific caches\n\n## Notes\n\n- Returns summaries only to avoid token waste\n- Use returned cache IDs with xcodebuild-get-details for full output\n- Ordered by recency (most recent first)\n- Limited to reduce response token usage\n";
//# sourceMappingURL=list-cached.d.ts.map