@ctxprotocol/sdk 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/dist/client/index.cjs +4 -0
  2. package/dist/client/index.cjs.map +1 -1
  3. package/dist/client/index.d.cts +2 -2
  4. package/dist/client/index.d.ts +2 -2
  5. package/dist/client/index.js +4 -0
  6. package/dist/client/index.js.map +1 -1
  7. package/dist/contrib/search/index.d.cts +2 -2
  8. package/dist/contrib/search/index.d.ts +2 -2
  9. package/dist/index.cjs +4 -0
  10. package/dist/index.cjs.map +1 -1
  11. package/dist/index.d.cts +1 -1
  12. package/dist/index.d.ts +1 -1
  13. package/dist/index.js +4 -0
  14. package/dist/index.js.map +1 -1
  15. package/dist/{types-DRbq-FA6.d.cts → types-Dw_bmVr4.d.cts} +43 -0
  16. package/dist/{types-DRbq-FA6.d.ts → types-Dw_bmVr4.d.ts} +43 -0
  17. package/package.json +1 -1
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/client/types.ts","../src/client/resources/developer.ts","../src/client/resources/discovery.ts","../src/client/resources/tools.ts","../src/client/resources/query.ts","../src/client/client.ts","../src/context/index.ts","../src/auth/index.ts","../src/handshake/types.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ContributorSearchTraceRecord } from \"../contrib/search/types.js\";\n\n/**\n * Configuration options for initializing the ContextClient\n */\nexport interface ContextClientOptions {\n /**\n * Your Context Protocol API key\n * @example \"sk_live_abc123...\"\n */\n apiKey: string;\n\n /**\n * Base URL for the Context Protocol API\n * @default \"https://www.ctxprotocol.com\"\n */\n baseUrl?: string;\n\n /**\n * Request timeout for non-streaming API calls in milliseconds.\n * @default 300000\n */\n requestTimeoutMs?: number;\n\n /**\n * Request timeout for establishing streaming API calls in milliseconds.\n * @default 600000\n */\n streamTimeoutMs?: number;\n}\n\n/**\n * An individual MCP tool exposed by a tool listing\n */\nexport interface McpToolRateLimitHints {\n /** Suggested request budget for this method */\n maxRequestsPerMinute?: number;\n\n /** Suggested parallel call ceiling for this method */\n maxConcurrency?: number;\n\n /** Suggested minimum delay between sequential calls */\n cooldownMs?: number;\n\n /** Whether this method already supports bulk/batch retrieval */\n supportsBulk?: boolean;\n\n /** Preferred batch-oriented methods to call instead of fan-out loops */\n recommendedBatchTools?: string[];\n\n /** Optional human-readable notes for planning */\n notes?: string;\n}\n\nexport type DiscoveryMode = \"query\" | \"execute\";\nexport type McpToolSurface = \"answer\" | \"execute\" | \"both\";\nexport type McpToolLatencyClass = \"instant\" | \"fast\" | \"slow\" | \"streaming\";\n\nexport interface McpToolPricingMeta {\n executeUsd?: string;\n queryUsd?: string;\n [key: string]: unknown;\n}\n\nexport interface McpToolMeta {\n /** Declared method surface */\n surface?: McpToolSurface;\n\n /** Whether this method can be selected in query mode */\n queryEligible?: boolean;\n\n /** Declared latency class for planner/runtime gating */\n latencyClass?: McpToolLatencyClass;\n\n /** Method-level pricing metadata */\n pricing?: McpToolPricingMeta;\n\n /** Derived discovery flag for execute eligibility */\n executeEligible?: boolean;\n\n /** Derived discovery field for explicit execute pricing visibility */\n executePriceUsd?: string;\n\n /** Context injection requirements handled by the Context runtime */\n contextRequirements?: string[];\n\n /**\n * Optional planner/runtime pacing hints.\n * Tool contributors can publish these to reduce rate-limit failures.\n */\n rateLimit?: McpToolRateLimitHints;\n rateLimitHints?: McpToolRateLimitHints;\n\n /** Flat aliases accepted for convenience */\n maxRequestsPerMinute?: number;\n maxConcurrency?: number;\n cooldownMs?: number;\n supportsBulk?: boolean;\n recommendedBatchTools?: string[];\n notes?: string;\n\n [key: string]: unknown;\n}\n\nexport interface StructuredMethodGuidanceHints {\n /** Suggested call-order sequence extracted from method descriptions */\n callOrderHints?: string[];\n\n /** Parameter usage caveats extracted from method descriptions */\n parameterCaveats?: string[];\n\n /** Edge-case behavior notes extracted from method descriptions */\n edgeCaseNotes?: string[];\n}\n\nexport interface McpTool {\n /** Name of the MCP tool method */\n name: string;\n\n /** Description of what this method does */\n description: string;\n\n /**\n * JSON Schema for the input arguments this tool accepts.\n * Used by LLMs to generate correct arguments.\n */\n inputSchema?: Record<string, unknown>;\n\n /**\n * JSON Schema for the output this tool returns.\n * Used by LLMs to understand the response structure.\n */\n outputSchema?: Record<string, unknown>;\n\n /** MCP metadata extensions (context injection, rate-limit hints) */\n _meta?: McpToolMeta;\n\n /** Explicit execute eligibility in discovery responses */\n executeEligible?: boolean;\n\n /** Explicit execute price visibility in discovery responses */\n executePriceUsd?: string | null;\n\n /** Whether this method has normalized structured guidance hints */\n hasStructuredGuidance?: boolean;\n\n /** Optional structured guidance hints derived from the method description */\n structuredGuidance?: StructuredMethodGuidanceHints;\n}\n\n/**\n * Represents a tool available on the Context Protocol marketplace\n */\nexport interface Tool {\n /** Unique identifier for the tool (UUID) */\n id: string;\n\n /** Human-readable name of the tool */\n name: string;\n\n /** Description of what the tool does */\n description: string;\n\n /** Price per execution in USDC */\n price: string;\n\n /** Tool category (e.g., \"defi\", \"nft\") */\n category?: string;\n\n /** Whether the tool is verified by Context Protocol */\n isVerified?: boolean;\n\n /** Tool type - currently always \"mcp\" */\n kind?: string;\n\n /**\n * Available MCP tool methods\n * Use items from this array as `toolName` when executing\n */\n mcpTools?: McpTool[];\n\n // Trust metrics (Level 2 - Reputation Ledger)\n /** Total number of queries processed */\n totalQueries?: number;\n\n /** Success rate percentage (0-100) */\n successRate?: string;\n\n /** Uptime percentage (0-100) */\n uptimePercent?: string;\n\n /** Total USDC staked by the developer */\n totalStaked?: string;\n\n /** Whether the tool has \"Proven\" status (100+ queries, >95% success, >98% uptime) */\n isProven?: boolean;\n}\n\n/**\n * Response from the tools search endpoint\n */\nexport interface SearchResponse {\n /** Array of matching tools */\n tools: Tool[];\n\n /** Discovery mode used by the server */\n mode?: DiscoveryMode;\n\n /** The search query that was used */\n query: string;\n\n /** Total number of results */\n count: number;\n}\n\n/**\n * Options for searching tools\n */\nexport interface SearchOptions {\n /** Search query (semantic search) */\n query?: string;\n\n /** Maximum number of results (1-50, default 10) */\n limit?: number;\n\n /** Discovery mode with billing semantics */\n mode?: DiscoveryMode;\n\n /** Optional explicit method surface filter */\n surface?: McpToolSurface;\n\n /** Require methods marked query eligible */\n queryEligible?: boolean;\n\n /** Require explicit method execute pricing */\n requireExecutePricing?: boolean;\n\n /** Exclude methods by latency class */\n excludeLatencyClasses?: McpToolLatencyClass[];\n\n /** Convenience switch to exclude slow methods in query mode */\n excludeSlow?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Developer / tool management types\n// ---------------------------------------------------------------------------\n\n/**\n * Options for updating a tool listing via `client.developer.updateTool()`.\n * At least one field must be provided.\n */\nexport const ALLOWED_TOOL_CATEGORIES = [\n \"Crypto & DeFi\",\n \"Financial Markets\",\n \"Business & Sales\",\n \"Marketing & SEO\",\n \"Legal & Regulatory\",\n \"Real World\",\n \"Developer Tools\",\n \"Research & Academia\",\n \"Utility\",\n \"Other\",\n] as const;\n\nexport type ToolCategory = (typeof ALLOWED_TOOL_CATEGORIES)[number];\n\nexport interface UpdateToolOptions {\n /** New display name for the tool */\n name?: string;\n\n /** New marketplace description */\n description?: string;\n\n /** New category -- must be one of the predefined marketplace categories */\n category?: ToolCategory | null;\n}\n\n/**\n * Response from updating a tool listing.\n */\nexport interface UpdateToolResult {\n id: string;\n name: string;\n description: string;\n category: string | null;\n updatedAt: string;\n}\n\n/**\n * Options for executing a tool\n */\nexport interface ExecuteOptions {\n /** The UUID of the tool to execute (from search results) */\n toolId: string;\n\n /** The specific MCP tool name to call (from tool's mcpTools array) */\n toolName: string;\n\n /** Arguments to pass to the tool */\n args?: Record<string, unknown>;\n\n /**\n * Optional idempotency key (UUID recommended).\n * Reuse the same key when retrying the same logical request.\n */\n idempotencyKey?: string;\n\n /** Explicit execute mode label for request clarity */\n mode?: \"execute\";\n\n /** Optional execute session identifier */\n sessionId?: string;\n\n /** Optional per-session spend budget envelope (USD) */\n maxSpendUsd?: string;\n\n /** Request session closure after this execute call settles */\n closeSession?: boolean;\n}\n\nexport type ExecuteSessionStatus = \"open\" | \"closed\" | \"expired\";\n\nexport interface ExecuteSessionSpend {\n mode: \"execute\";\n sessionId: string | null;\n methodPrice: string;\n spent: string;\n remaining: string | null;\n maxSpend: string | null;\n\n /** Optional lifecycle fields when the API returns session state */\n status?: ExecuteSessionStatus;\n expiresAt?: string;\n closeRequested?: boolean;\n pendingAccruedCount?: number;\n pendingAccruedUsd?: string;\n}\n\n/**\n * Successful execution response from the API\n */\nexport interface ExecuteApiSuccessResponse {\n success: true;\n mode: \"execute\";\n\n /** The result data from the tool execution */\n result: unknown;\n\n /** Information about the executed tool */\n tool: {\n id: string;\n name: string;\n };\n\n /** Method-level execute pricing used for this call */\n method: {\n name: string;\n executePriceUsd: string;\n };\n\n /** Spend envelope visibility for execute sessions */\n session: ExecuteSessionSpend;\n\n /** Execution duration in milliseconds */\n durationMs: number;\n}\n\n/**\n * Error response from the API\n */\nexport interface ExecuteApiErrorResponse {\n /** Human-readable error message */\n error: string;\n\n /** Explicit mode label for clarity */\n mode?: \"execute\";\n\n /** Error code for programmatic handling */\n code?: ContextErrorCode;\n\n /** URL to help resolve the issue */\n helpUrl?: string;\n\n /** Optional spend envelope context when available */\n session?: ExecuteSessionSpend;\n}\n\n/**\n * Raw API response from the execute endpoint\n */\nexport type ExecuteApiResponse = ExecuteApiSuccessResponse | ExecuteApiErrorResponse;\n\nexport interface ExecuteSessionStartOptions {\n /** Maximum spend budget for the session (USD string) */\n maxSpendUsd: string;\n}\n\nexport interface ExecuteSessionApiSuccessResponse {\n success: true;\n mode: \"execute\";\n session: ExecuteSessionSpend;\n}\n\nexport type ExecuteSessionApiResponse =\n | ExecuteSessionApiSuccessResponse\n | ExecuteApiErrorResponse;\n\nexport interface ExecuteSessionResult {\n mode: \"execute\";\n session: ExecuteSessionSpend;\n}\n\n/**\n * The resolved result returned to the user after SDK processing\n */\nexport interface ExecutionResult<T = unknown> {\n mode: \"execute\";\n\n /** The data returned by the tool */\n result: T;\n\n /** Information about the executed tool */\n tool: {\n id: string;\n name: string;\n };\n\n /** Method-level execute pricing used for this call */\n method: {\n name: string;\n executePriceUsd: string;\n };\n\n /** Spend envelope visibility for execute calls */\n session: ExecuteSessionSpend;\n\n /** Execution duration in milliseconds */\n durationMs: number;\n}\n\n// ---------------------------------------------------------------------------\n// Query types (pay-per-response / agentic mode)\n// ---------------------------------------------------------------------------\n\n/** Supported orchestration depth modes for query execution. */\nexport type QueryDepth = \"fast\" | \"auto\" | \"deep\";\nexport type QueryDeepMode = \"deep\" | \"deep-light\" | \"deep-heavy\";\nexport type QueryClarificationPolicy = \"return\" | \"auto\" | \"error\";\nexport type QueryOutcomeType =\n | \"answer\"\n | \"clarification_required\"\n | \"capability_miss\";\nexport type QueryResponseShape =\n | \"answer\"\n | \"answer_with_evidence\"\n | \"evidence_only\";\nexport type QueryResponseEnvelopeViewType =\n | \"table\"\n | \"leaderboard\"\n | \"heatmap\"\n | \"timeseries\";\n\nexport interface QueryClarificationOption {\n id: string;\n toolId: string;\n toolName: string;\n methodName: string;\n label: string;\n description: string;\n fitScore: number;\n recommended: boolean;\n}\n\nexport interface QueryClarificationPayload {\n question: string;\n options: QueryClarificationOption[];\n allowFreeform: boolean;\n recommendedOptionId: string;\n originalQuery: string;\n}\n\nexport interface QueryCapabilityMissPayload {\n message: string;\n missingCapabilities: string[];\n suggestedRewrites: string[];\n originalQuery: string;\n}\n\nexport interface QueryAssumptionMetadata {\n mode: \"auto\";\n optionId: string;\n label: string;\n reason: string;\n}\n\nexport type QueryClarificationDecisionReasonCode =\n | \"rollout_disabled\"\n | \"no_grounded_candidates\"\n | \"single_grounded_interpretation\"\n | \"required_discriminator_ambiguity\"\n | \"contract_scope_ambiguity\"\n | \"cost_or_latency_ambiguity\"\n | \"semantic_scope_ambiguity\"\n | \"capability_miss\";\n\nexport type QueryAttemptForkReason =\n | \"manual_fork\"\n | \"clarification_branch\"\n | \"bounded_rediscovery\"\n | \"resume_replay\"\n | \"patch_retry\"\n | \"unknown\";\n\nexport interface QueryClarificationEvidenceSources {\n usesMethodSchemas: boolean;\n usesProbeArgs: boolean;\n usesMethodMetadata: boolean;\n usesToolSelectionContext: boolean;\n usesLlmSelection: boolean;\n}\n\nexport interface QueryClarificationCandidateSummary {\n optionId: string;\n fitScore: number;\n llmRelevanceScore: number | null;\n requiredParams: string[];\n unresolvedRequiredParams: string[];\n probeArgKeys: string[];\n inputFieldNames: string[];\n outputKeys: string[];\n latencyClass: string;\n executePriceUsd: string | null;\n queryEligible: boolean;\n}\n\nexport interface QueryClarificationDiagnostics {\n orchestrationMode: string;\n rolloutStage: string;\n shadowMode: boolean;\n policy: QueryClarificationPolicy;\n outcomeType: QueryOutcomeType;\n triggered: boolean;\n optionCount: number;\n candidateCount: number;\n viableCandidateCount: number;\n recommendedOptionId: string | null;\n recommendedOptionReason: string | null;\n autoResolved: boolean;\n autoSelectEnabled: boolean;\n assumptionMade: QueryAssumptionMetadata | null;\n missingCapability: string | null;\n decisionReasonCode: QueryClarificationDecisionReasonCode;\n decisionSignals: string[];\n evidenceSources: QueryClarificationEvidenceSources;\n comparedOptionIds: string[];\n decisionStrategy: \"deterministic\" | \"llm_primary\";\n judgeAttempted: boolean;\n judgeApplied: boolean;\n judgeOutcomeType: QueryOutcomeType | null;\n judgeConfidence: number | null;\n judgeReason: string | null;\n judgeError: string | null;\n validatorReason: string | null;\n fallbackReason: string | null;\n copyStrategy: \"deterministic\" | \"llm_rewritten\";\n rewriteAttempted: boolean;\n rewriteApplied: boolean;\n rewriteError: string | null;\n candidateSummaries: QueryClarificationCandidateSummary[];\n}\n\n/**\n * Options for the agentic query endpoint (pay-per-response).\n *\n * Unlike `execute()` which calls a single tool once, `query()` sends a\n * natural-language question and lets the server handle discovery-first\n * orchestration (`discover/probe -> plan-from-evidence -> execute ->\n * bounded fallback`) plus synthesis.\n * One flat fee covers up to 100 MCP skill calls per tool.\n */\nexport interface QueryOptions {\n /** The natural-language question to answer */\n query: string;\n\n /**\n * How the SDK should handle clarification-required pre-plan situations:\n * - `return`: surface a structured clarification result to the caller\n * - `auto`: enable clarification auto-select and continue with the server's deterministic recommended option\n * - `error`: turn structured clarification/capability outcomes into terminal errors\n */\n clarificationPolicy?: QueryClarificationPolicy;\n\n /**\n * Optional tool IDs to use. When omitted the server discovers tools\n * automatically (Auto Mode). When provided, only these tools are used\n * (Manual Mode).\n */\n tools?: string[];\n\n /**\n * Resume a prior durable query attempt from its latest checkpoint.\n * Cannot be combined with `tools` or `forkFrom`.\n */\n resumeFrom?: QueryAttemptReference;\n\n /**\n * Fork a new durable query attempt from a previous attempt.\n * Optional `reason` keeps the server's non-breaking lineage metadata honest.\n * Cannot be combined with `tools` or `resumeFrom`.\n */\n forkFrom?: QueryForkReference;\n\n /**\n * Optional answer model ID for final synthesis.\n * Supported IDs are published by the Context API. Ignored when\n * `responseShape` is `evidence_only` because synthesis is skipped.\n */\n answerModelId?: string;\n\n /**\n * Structured response mode for query answers.\n * - `answer`: backward-compatible natural-language answer\n * - `answer_with_evidence`: prose answer plus a structured evidence package\n * - `evidence_only`: structured evidence package with a machine-friendly summary\n */\n responseShape?: QueryResponseShape;\n\n /**\n * Include execution data inline in the query response.\n * Useful for headless agents that need raw structured outputs.\n * Handshake completion remains a chat-only flow today; raw execution data\n * is not a typed resume/callback contract for approvals.\n */\n includeData?: boolean;\n\n /**\n * Persist execution data to Vercel Blob and return a download URL.\n * Useful for large payload workflows where inline JSON is not ideal.\n */\n includeDataUrl?: boolean;\n\n /**\n * Include machine-readable developer trace output for this query response.\n * When enabled, the server may return summary counters plus diagnostics\n * for lane selection, scout probe adequacy, and bounded fallback behavior.\n */\n includeDeveloperTrace?: boolean;\n\n /**\n * Query orchestration depth mode:\n * - `fast`: lower-latency path\n * - `auto`: server decides between fast/deep\n * - `deep`: full completeness-oriented path\n */\n queryDepth?: QueryDepth;\n\n /**\n * Development/testing only: force the server's internal deep lane.\n * `deep` is the canonical value. Legacy `deep-light` / `deep-heavy`\n * aliases are still accepted temporarily for compatibility and normalize\n * to the same runtime lane. Invalid when `queryDepth` is `fast`.\n */\n debugScoutDeepMode?: QueryDeepMode;\n\n /**\n * Optional idempotency key (UUID recommended).\n * Reuse the same key when retrying the same logical request.\n */\n idempotencyKey?: string;\n}\n\n/**\n * Tool reference attached to developer trace timeline steps.\n */\nexport interface QueryDeveloperTraceToolRef {\n id?: string;\n name?: string;\n method?: string;\n [key: string]: unknown;\n}\n\n/**\n * Loop metadata attached to developer trace timeline steps.\n */\nexport interface QueryDeveloperTraceLoopInfo {\n name?: string;\n iteration?: number;\n maxIterations?: number;\n [key: string]: unknown;\n}\n\n/**\n * Tool selection metadata attached to discovery/planning diagnostics.\n */\nexport interface QueryDeveloperTraceToolSelection {\n toolId: string;\n toolName: string;\n selectedMethodCount: number;\n selectedMethods: string[];\n omittedSelectedMethodCount: number;\n priceUsd?: string;\n}\n\n/**\n * Initial planner diagnostic details.\n */\nexport interface QueryPlanningTraceDiagnostic {\n plannerQuery: string;\n scoutEvidenceAttached: boolean;\n scoutEvidencePromptBlock: string | null;\n allowedModules: string[];\n}\n\n/**\n * Rediscovery/fallback diagnostic details.\n */\nexport interface QueryRediscoveryTraceDiagnostic {\n considered: boolean;\n executed: boolean;\n skipReason: string | null;\n missingCapability: string | null;\n rediscoveryQuery: string | null;\n capabilityLooksLikeSearchNeed: boolean;\n allowSearchFallbackOnElapsedCap: boolean;\n searchFallbackUsed: boolean;\n preRediscoveryBudgetReasonCode: string | null;\n candidateSearchResults: QueryDeveloperTraceToolSelection[];\n selectedAlternatives: QueryDeveloperTraceToolSelection[];\n mergedTools: QueryDeveloperTraceToolSelection[];\n usingPaidFallback: boolean;\n branchPlan: QueryPlanningTraceDiagnostic | null;\n}\n\nexport interface QueryCompletenessRepairEvent {\n attempt: number;\n outcome:\n | \"attempted\"\n | \"skipped_by_guardrail\"\n | \"skipped_no_retry_budget\"\n | \"skipped_needs_different_tools\"\n | \"skipped_no_retry_path\"\n | \"patch_failed\"\n | \"replan_failed\"\n | \"patched\"\n | \"replanned\";\n semanticRetryCount: number;\n maxSemanticRetries: number;\n strategy: \"patch\" | \"replan\" | null;\n summary: string | null;\n failReason: string | null;\n requestedReplan: boolean;\n hadSyntaxFix: boolean;\n editCount: number | null;\n skipReason: string | null;\n boundedAnswerReason:\n | \"retry_guardrail_same_endpoint_fanout\"\n | \"retry_guardrail_upstream_abort\"\n | null;\n blockingDiagnostics: Array<{\n code: string;\n severity: string;\n message: string;\n }>;\n}\n\n/**\n * Rich developer-trace diagnostics for discovery-first orchestration internals.\n */\nexport interface QueryDeveloperTraceDiagnostics {\n selection: {\n selectedDepth: string;\n deepMode: string | null;\n debugScoutDeepMode: string | null;\n plannerReasoningStage: string;\n scoutEnabled: boolean;\n preserveFastOneShot: boolean;\n candidateMethodCount: number;\n scoutProbeStatus: string;\n scoutProbeAdequacy: string;\n scoutProbeConfidence: number;\n scoutMetadataConfidence: number;\n scoutProbeQuerySafeCandidateCount: number;\n scoutProbeRankedMethodCount: number;\n scoutProbeAmbiguityPoolCount: number;\n scoutProbeShortlistedMethodCount: number;\n scoutProbeMissingCapability: string | null;\n scoutPrePlanProbeCalls: number;\n scoutPrePlanProbeBudgetReasonCode: string | null;\n scoutChangedInitialPlan: boolean;\n scoutChangedPlannerReasoningStage: boolean;\n scoutInitialSelectedDepth: string;\n scoutInitialDeepMode: string | null;\n scoutInitialPlannerReasoningStage: string;\n scoutInitialReasonCode: string;\n scoutFinalReasonCode: string;\n scoutEvidenceAttachedToPlanning: boolean;\n scoutLlmSelectionUsed: boolean;\n scoutLlmSelectionFallback: boolean;\n scoutLlmSelectionLatencyMs: number | null;\n selectedTools: QueryDeveloperTraceToolSelection[];\n };\n planning: {\n initial: QueryPlanningTraceDiagnostic;\n };\n cost?: {\n planningCostUsd: number;\n initialExecutionCostUsd: number;\n rediscoveryAdditionalCostUsd: number;\n synthesisCostUsd: number;\n totalModelCostUsd: number;\n toolCostUsd: number;\n totalChargedUsd: number;\n };\n completeness: {\n evaluations: unknown[];\n repairEvents: QueryCompletenessRepairEvent[];\n triggerNeedsDifferentTools: boolean;\n triggerMissingCapability: string | null;\n };\n rediscovery: QueryRediscoveryTraceDiagnostic | null;\n clarification?: QueryClarificationDiagnostics;\n contributorSearches?: ContributorSearchTraceRecord[];\n [key: string]: unknown;\n}\n\n/**\n * A single developer-trace timeline step.\n */\nexport interface QueryDeveloperTraceStep {\n stepType?: string;\n event?: string;\n status?: string;\n message?: string;\n timestampMs?: number;\n tool?: QueryDeveloperTraceToolRef;\n attempt?: number;\n loop?: QueryDeveloperTraceLoopInfo;\n metadata?: Record<string, unknown>;\n [key: string]: unknown;\n}\n\n/**\n * Aggregate counters that summarize developer-trace behavior.\n */\nexport interface QueryDeveloperTraceSummary {\n toolCalls?: number;\n retryCount?: number;\n selfHealCount?: number;\n fallbackCount?: number;\n failureCount?: number;\n recoveryCount?: number;\n completionChecks?: number;\n loopCount?: number;\n [key: string]: unknown;\n}\n\n/**\n * Developer Mode trace payload returned per query response (opt-in).\n */\nexport interface QueryDeveloperTrace {\n summary?: QueryDeveloperTraceSummary;\n timeline?: QueryDeveloperTraceStep[];\n requestId?: string;\n query?: string;\n source?: string;\n diagnostics?: QueryDeveloperTraceDiagnostics;\n [key: string]: unknown;\n}\n\n/**\n * Information about a tool that was used during a query response\n */\nexport interface QueryToolUsage {\n /** Tool ID */\n id: string;\n\n /** Tool name */\n name: string;\n\n /** Number of MCP skill calls made for this tool */\n skillCalls: number;\n}\n\n/**\n * Cost breakdown for a query response.\n * All values are strings representing USD amounts.\n */\nexport interface QueryCost {\n /** AI model inference cost */\n modelCostUsd: string;\n\n /** Sum of all tool fees */\n toolCostUsd: string;\n\n /** Total cost (model + tools) */\n totalCostUsd: string;\n}\n\n/**\n * High-level orchestration outcome metrics returned by the query API.\n */\nexport interface QueryOrchestrationMetrics {\n parityStage: string;\n orchestrationMode: string;\n /** Whether the first plan path succeeded without fallback. */\n firstPassSuccess: boolean;\n /** Whether execution signaled a missing capability on first pass. */\n capabilityMissSignaled: boolean;\n /** Whether bounded rediscovery/fallback executed. */\n rediscoveryExecuted: boolean;\n}\n\nexport interface QueryAttemptReference {\n sessionId: string;\n attemptId: string;\n}\n\n/** Public fork handle for creating a new attempt from a prior Query session. */\nexport interface QueryForkReference extends QueryAttemptReference {\n reason?: QueryAttemptForkReason;\n}\n\n/**\n * Public continuation state returned by headless Query responses.\n * Internal selected-tool lineage, Scout reuse, and clarification snapshots\n * remain durable server state but are not exposed as chat-style payloads.\n */\nexport interface QuerySessionState {\n sessionId: string;\n attemptId: string;\n parentAttemptId: string | null;\n rootAttemptId: string;\n mode: \"initial\" | \"resume\" | \"fork\";\n origin: \"initial_request\" | \"resume\" | \"fork\";\n status: \"active\" | \"completed\" | \"failed\" | \"aborted\";\n checkpoint: {\n currentStage: string | null;\n latestCheckpointArtifactId: string | null;\n canonicalDatasetId: string | null;\n executionProgramCurrentRevisionId: string | null;\n };\n}\n\nexport interface QueryResponseEnvelopeFact {\n id: string;\n label: string;\n path: string | null;\n relevanceScore: number | null;\n value: unknown;\n}\n\nexport interface QueryResponseEnvelopeSourceRef {\n id: string;\n provider: string | null;\n dataset: string | null;\n observedAt: string | null;\n publishedAt: string | null;\n artifactRef: string | null;\n url: string | null;\n note: string | null;\n}\n\nexport type QueryResponseEnvelopeTone =\n | \"positive\"\n | \"negative\"\n | \"neutral\"\n | \"caution\";\n\nexport type QueryControllerStopReason =\n | \"complete_answer\"\n | \"bounded_runtime_budget\"\n | \"bounded_same_endpoint_guardrail\"\n | \"bounded_upstream_abort_guardrail\"\n | \"clarification_required\"\n | \"capability_miss\";\n\nexport type QueryControllerIssueClass =\n | \"scope_ambiguity\"\n | \"missing_evidence\"\n | \"missing_capability\"\n | \"stale_data\"\n | \"wrong_tool_path\";\n\nexport type QueryControllerAction =\n | \"inspect_current_grounding\"\n | \"patch_current_program\"\n | \"bounded_rediscovery\"\n | \"clarify_scope\"\n | \"return_capability_miss\"\n | \"return_bounded_answer\"\n | \"return_complete_answer\";\n\nexport interface QueryResponseEnvelopeMarketAggregateFlow {\n netFlowUsd: number | null;\n grossInflowUsd: number | null;\n grossOutflowUsd: number | null;\n nativeNetFlow: number | null;\n nativeUnit: string | null;\n direction: \"inflow\" | \"outflow\" | \"flat\" | \"mixed\";\n}\n\nexport interface QueryResponseEnvelopeMarketVenueBreakdown {\n venue: string;\n asset: string | null;\n netFlowUsd: number | null;\n grossInflowUsd: number | null;\n grossOutflowUsd: number | null;\n nativeNetFlow: number | null;\n nativeUnit: string | null;\n shareOfTotal: number | null;\n rank: number | null;\n}\n\nexport interface QueryResponseEnvelopeCatalystRef {\n source: string;\n publishedAt: string | null;\n claim: string | null;\n relationToFlow: string | null;\n url: string | null;\n}\n\nexport interface QueryResponseEnvelopeDerivativesContext {\n openInterestDirection: string | null;\n openInterestChangePct: number | null;\n liquidationBias: string | null;\n venues: string[];\n relationshipToSpotFlows: string | null;\n}\n\nexport interface QueryResponseEnvelopeMarketIntelligence {\n asset: string | null;\n assets: string[] | null;\n timeWindow: string | null;\n asOf: string | null;\n aggregateFlow: QueryResponseEnvelopeMarketAggregateFlow | null;\n venueBreakdown: QueryResponseEnvelopeMarketVenueBreakdown[];\n catalystRefs: QueryResponseEnvelopeCatalystRef[];\n derivativesContext: QueryResponseEnvelopeDerivativesContext | null;\n}\n\nexport interface QueryResponseEnvelopeViewMetric {\n label: string;\n value: string;\n tone?: QueryResponseEnvelopeTone;\n}\n\nexport interface QueryResponseEnvelopeViewRow {\n key: string;\n cells: string[];\n tone?: QueryResponseEnvelopeTone;\n sourceRefIds?: string[];\n}\n\nexport interface QueryResponseEnvelope {\n responseShape: Exclude<QueryResponseShape, \"answer\">;\n response: string;\n summary: string;\n outcome: {\n label: string;\n tone: QueryResponseEnvelopeTone;\n stopReason: QueryControllerStopReason;\n issueClass: QueryControllerIssueClass | null;\n };\n controller: {\n scope: \"wedge\" | \"standard\";\n nextAction: QueryControllerAction;\n actionsTaken: QueryControllerAction[];\n patchFirstProgramPreserved: boolean;\n executionProgramRevisionId: string | null;\n hardBudgetApplied: boolean;\n } | null;\n evidence: {\n facts: QueryResponseEnvelopeFact[];\n sourceRefs: QueryResponseEnvelopeSourceRef[];\n assumptions: string[];\n knownUnknowns: string[];\n retrievalPlanReasonCodes: string[];\n marketIntelligence?: QueryResponseEnvelopeMarketIntelligence | null;\n };\n artifacts: {\n dataUrl: string | null;\n canonicalDataRef: {\n datasetId: string;\n hash: string;\n bytes: number;\n publicDataUrl: string | null;\n } | null;\n stageArtifactKinds: string[];\n };\n view: {\n type: QueryResponseEnvelopeViewType;\n label: string;\n title?: string | null;\n metrics?: QueryResponseEnvelopeViewMetric[];\n columns?: string[];\n rows?: QueryResponseEnvelopeViewRow[];\n } | null;\n freshness: {\n asOf: string | null;\n sourceTimestamps: string[];\n note: string;\n };\n confidence: {\n level: \"high\" | \"medium\" | \"low\";\n reason: string;\n verifiedFactCount: number;\n inferredFactCount: number;\n gapCount: number;\n gapSignals: Array<{\n code: string;\n severity: string;\n detail: string;\n }>;\n };\n usage: {\n durationMs: number;\n cost: QueryCost;\n toolsUsed: QueryToolUsage[];\n outcomeType: QueryOutcomeType;\n orchestrationMetrics?: QueryOrchestrationMetrics;\n };\n}\n\nexport interface QueryBaseResult {\n /** The answer text or machine-friendly summary returned for this query. */\n response: string;\n\n /** Tools that were used to answer the query */\n toolsUsed: QueryToolUsage[];\n\n /** Cost breakdown */\n cost: QueryCost;\n\n /** Total duration in milliseconds */\n durationMs: number;\n\n /** Optional execution data from tools (when includeData=true) */\n data?: unknown;\n\n /** Optional blob URL for persisted execution data (when includeDataUrl=true) */\n dataUrl?: string;\n\n /** Optional machine-readable Developer Mode trace payload */\n developerTrace?: QueryDeveloperTrace;\n\n /** Optional orchestration outcome metrics for benchmarking and rollout analysis */\n orchestrationMetrics?: QueryOrchestrationMetrics;\n\n /** Typed public stop reason for the final outcome. */\n stopReason?: QueryControllerStopReason;\n\n /** Typed issue class exposed by the bounded controller contract. */\n issueClass?: QueryControllerIssueClass | null;\n\n /** Ordered public controller actions taken before the final outcome. */\n actionsTaken?: QueryControllerAction[];\n\n /** Optional controller summary for bounded wedge-style answers. */\n controller?: QueryResponseEnvelope[\"controller\"];\n\n /**\n * Optional public durable continuation handles for resume/fork flows.\n * Query exposes handle-based continuation, not chat-style continuation payloads.\n */\n querySession?: QuerySessionState;\n}\n\n/**\n * The resolved result of a pay-per-response query\n */\nexport type QueryResult =\n | (QueryBaseResult &\n Partial<QueryResponseEnvelope> & {\n outcomeType: \"answer\";\n assumptionMade?: QueryAssumptionMetadata;\n })\n | (QueryBaseResult & {\n outcomeType: \"clarification_required\";\n clarification: QueryClarificationPayload;\n })\n | (QueryBaseResult & {\n outcomeType: \"capability_miss\";\n capabilityMiss: QueryCapabilityMissPayload;\n });\n\n/**\n * Successful response from the /api/v1/query endpoint\n */\nexport type QueryApiSuccessResponse = { success: true } & QueryResult;\n\n/**\n * Raw API response from the query endpoint\n */\nexport type QueryApiResponse = QueryApiSuccessResponse | ExecuteApiErrorResponse;\n\n// ---------------------------------------------------------------------------\n// Query stream event types\n// ---------------------------------------------------------------------------\n\n/** Emitted when a tool starts or changes execution status */\nexport interface QueryStreamToolStatusEvent {\n type: \"tool-status\";\n tool: { id: string; name: string };\n status: string;\n}\n\n/** Emitted for each chunk of the AI response text */\nexport interface QueryStreamTextDeltaEvent {\n type: \"text-delta\";\n delta: string;\n}\n\n/** Emitted when the server streams developer trace updates/chunks */\nexport interface QueryStreamDeveloperTraceEvent {\n type: \"developer-trace\";\n trace: QueryDeveloperTrace;\n}\n\n/** Emitted when the full response is complete */\nexport interface QueryStreamDoneEvent {\n type: \"done\";\n result: QueryResult;\n}\n\n/** Emitted when the server reports a recoverable or terminal query error */\nexport interface QueryStreamErrorEvent {\n type: \"error\";\n error: string;\n code?: ContextErrorCode | string;\n scope?: string;\n reasonCode?: string;\n outcomeType?: Exclude<QueryOutcomeType, \"answer\">;\n clarification?: QueryClarificationPayload;\n capabilityMiss?: QueryCapabilityMissPayload;\n querySession?: QuerySessionState;\n}\n\n/**\n * Union of all events emitted during a streaming query\n */\nexport type QueryStreamEvent =\n | QueryStreamToolStatusEvent\n | QueryStreamTextDeltaEvent\n | QueryStreamDeveloperTraceEvent\n | QueryStreamDoneEvent\n | QueryStreamErrorEvent;\n\n// ---------------------------------------------------------------------------\n// Error types\n// ---------------------------------------------------------------------------\n\n/**\n * Specific error codes returned by the Context Protocol API\n */\nexport type ContextErrorCode =\n | \"unauthorized\"\n | \"no_wallet\"\n | \"insufficient_allowance\"\n | \"payment_failed\"\n | \"execution_failed\"\n | \"query_failed\"\n | \"invalid_tool_method\"\n | \"method_not_execute_eligible\"\n | \"invalid_max_spend\"\n | \"session_not_found\"\n | \"session_forbidden\"\n | \"session_closed\"\n | \"session_expired\"\n | \"max_spend_mismatch\"\n | \"session_budget_exceeded\";\n\n/**\n * Error thrown by the Context Protocol client\n */\nexport class ContextError extends Error {\n constructor(\n message: string,\n public readonly code?: ContextErrorCode | string,\n public readonly statusCode?: number,\n public readonly helpUrl?: string\n ) {\n super(message);\n this.name = \"ContextError\";\n Object.setPrototypeOf(this, ContextError.prototype);\n }\n}\n","import type { UpdateToolOptions, UpdateToolResult } from \"../types.js\";\nimport { ALLOWED_TOOL_CATEGORIES, ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Developer resource for managing tool listings on the Context Protocol marketplace.\n *\n * Scoped to contributor/developer concerns (listing management), separate from\n * the consumer-facing `tools.execute()` and `query.run()`.\n */\nexport class Developer {\n constructor(private client: ContextClient) {}\n\n /**\n * Update a tool listing's metadata (name, description, category).\n *\n * Requires an API key belonging to the tool's owner.\n *\n * @param toolId - The UUID of the tool to update\n * @param updates - Fields to update (at least one required)\n * @returns The updated tool metadata\n *\n * @throws {ContextError} If authentication fails or the caller does not own the tool\n *\n * @example\n * ```typescript\n * const updated = await client.developer.updateTool(\"tool-uuid\", {\n * description: \"Updated description with better showcase prompts\",\n * category: \"crypto\",\n * });\n * console.log(updated.updatedAt);\n * ```\n */\n async updateTool(\n toolId: string,\n updates: UpdateToolOptions\n ): Promise<UpdateToolResult> {\n if (!toolId) {\n throw new ContextError(\"toolId is required\");\n }\n\n if (\n updates.name === undefined &&\n updates.description === undefined &&\n updates.category === undefined\n ) {\n throw new ContextError(\n \"At least one field required: name, description, or category\"\n );\n }\n\n if (\n updates.category !== undefined &&\n updates.category !== null &&\n !ALLOWED_TOOL_CATEGORIES.includes(updates.category)\n ) {\n throw new ContextError(\n `category must be one of: ${ALLOWED_TOOL_CATEGORIES.join(\", \")}`\n );\n }\n\n const encodedToolId = encodeURIComponent(toolId);\n\n return this.client._fetch<UpdateToolResult>(\n `/api/v1/tools/${encodedToolId}`,\n {\n method: \"PATCH\",\n body: JSON.stringify(updates),\n },\n { retry: false }\n );\n }\n}\n","import type { SearchOptions, SearchResponse, Tool } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Discovery resource for searching and finding tools on the Context Protocol marketplace\n */\nexport class Discovery {\n constructor(private client: ContextClient) {}\n\n /**\n * Fetch a single marketplace tool by its unique ID.\n */\n async get(toolId: string): Promise<Tool> {\n return this.client._fetch<Tool>(\n `/api/v1/tools/${encodeURIComponent(toolId)}`\n );\n }\n\n /**\n * Search for tools matching a query string.\n *\n * Backward-compatible signatures:\n * - `search(\"gas prices\", 10)`\n * - `search({ query: \"gas prices\", limit: 10, mode: \"execute\" })`\n */\n async search(query: string, limit?: number): Promise<Tool[]>;\n async search(options: SearchOptions): Promise<Tool[]>;\n async search(\n queryOrOptions: string | SearchOptions,\n limit?: number\n ): Promise<Tool[]> {\n const options: SearchOptions =\n typeof queryOrOptions === \"string\"\n ? { query: queryOrOptions, limit }\n : queryOrOptions;\n\n const params = new URLSearchParams();\n const query = options.query ?? \"\";\n\n if (query) {\n params.set(\"q\", query);\n }\n\n if (options.limit !== undefined) {\n params.set(\"limit\", String(options.limit));\n }\n\n if (options.mode) {\n params.set(\"mode\", options.mode);\n }\n\n if (options.surface) {\n params.set(\"surface\", options.surface);\n }\n\n if (options.queryEligible !== undefined) {\n params.set(\"queryEligible\", String(options.queryEligible));\n }\n\n if (options.requireExecutePricing !== undefined) {\n params.set(\n \"requireExecutePricing\",\n String(options.requireExecutePricing)\n );\n }\n\n if (\n options.excludeLatencyClasses &&\n options.excludeLatencyClasses.length > 0\n ) {\n params.set(\"excludeLatency\", options.excludeLatencyClasses.join(\",\"));\n }\n\n if (options.excludeSlow !== undefined) {\n params.set(\"excludeSlow\", String(options.excludeSlow));\n }\n\n const queryString = params.toString();\n const endpoint = `/api/v1/tools/search${queryString ? `?${queryString}` : \"\"}`;\n\n const response = await this.client._fetch<SearchResponse>(endpoint);\n\n return response.tools;\n }\n\n /**\n * Get featured/popular tools (empty query search)\n *\n * @param limit - Maximum number of results (1-50, default 10)\n * @returns Array of featured tools\n *\n * @example\n * ```typescript\n * const featured = await client.discovery.getFeatured(5);\n * ```\n */\n async getFeatured(\n limit?: number,\n options?: Omit<SearchOptions, \"query\" | \"limit\">\n ): Promise<Tool[]> {\n return this.search({\n ...(options ?? {}),\n query: \"\",\n ...(limit !== undefined ? { limit } : {}),\n });\n }\n}\n","import type {\n ExecuteOptions,\n ExecuteApiResponse,\n ExecuteSessionApiResponse,\n ExecuteSessionResult,\n ExecuteSessionStartOptions,\n ExecutionResult,\n} from \"../types.js\";\nimport { ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Tools resource for executing tools on the Context Protocol marketplace\n */\nexport class Tools {\n constructor(private client: ContextClient) {}\n\n /**\n * Execute a tool with the provided arguments\n *\n * @param options - Execution options\n * @param options.toolId - The UUID of the tool (from search results)\n * @param options.toolName - The specific MCP tool method to call (from tool's mcpTools array)\n * @param options.args - Arguments to pass to the tool\n * @returns The execution result with the tool's output data\n *\n * @throws {ContextError} With code `no_wallet` if wallet not set up\n * @throws {ContextError} With code `insufficient_allowance` if spending cap not set\n * @throws {ContextError} With code `payment_failed` if payment settlement fails\n * @throws {ContextError} With code `execution_failed` if tool execution fails\n *\n * @example\n * ```typescript\n * // First, search for a tool\n * const tools = await client.discovery.search(\"gas prices\");\n * const tool = tools[0];\n *\n * // Execute a specific method from the tool's mcpTools\n * const result = await client.tools.execute({\n * toolId: tool.id,\n * toolName: tool.mcpTools[0].name, // e.g., \"get_gas_prices\"\n * args: { chainId: 1 }\n * });\n *\n * console.log(result.result); // The tool's output\n * console.log(result.durationMs); // Execution time\n * ```\n */\n async execute<T = unknown>(options: ExecuteOptions): Promise<ExecutionResult<T>> {\n const {\n toolId,\n toolName,\n args,\n idempotencyKey,\n mode,\n sessionId,\n maxSpendUsd,\n closeSession,\n } = options;\n const headers = idempotencyKey\n ? { \"Idempotency-Key\": idempotencyKey }\n : undefined;\n\n const response = await this.client._fetch<ExecuteApiResponse>(\n \"/api/v1/tools/execute\",\n {\n method: \"POST\",\n headers,\n body: JSON.stringify({\n toolId,\n toolName,\n args,\n mode: mode ?? \"execute\",\n sessionId,\n maxSpendUsd,\n closeSession,\n }),\n }\n );\n\n // Handle error response\n if (\"error\" in response) {\n throw new ContextError(\n response.error,\n response.code,\n undefined, // Don't hardcode - this was a 200 OK with error body\n response.helpUrl\n );\n }\n\n // Handle success response\n if (response.success) {\n return {\n mode: response.mode,\n result: response.result as T,\n tool: response.tool,\n method: response.method,\n session: response.session,\n durationMs: response.durationMs,\n };\n }\n\n // Fallback - shouldn't reach here with valid API responses\n throw new ContextError(\"Unexpected response format from API\");\n }\n\n /**\n * Start an execute session with a max spend budget.\n */\n async startSession(\n options: ExecuteSessionStartOptions\n ): Promise<ExecuteSessionResult> {\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n \"/api/v1/tools/execute/sessions\",\n {\n method: \"POST\",\n body: JSON.stringify({\n mode: \"execute\",\n maxSpendUsd: options.maxSpendUsd,\n }),\n }\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n /**\n * Fetch current execute session status by ID.\n */\n async getSession(sessionId: string): Promise<ExecuteSessionResult> {\n if (!sessionId) {\n throw new ContextError(\"sessionId is required\");\n }\n\n const encodedSessionId = encodeURIComponent(sessionId);\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n `/api/v1/tools/execute/sessions/${encodedSessionId}`\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n /**\n * Close an execute session by ID.\n */\n async closeSession(sessionId: string): Promise<ExecuteSessionResult> {\n if (!sessionId) {\n throw new ContextError(\"sessionId is required\");\n }\n\n const encodedSessionId = encodeURIComponent(sessionId);\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n `/api/v1/tools/execute/sessions/${encodedSessionId}/close`,\n {\n method: \"POST\",\n body: JSON.stringify({ mode: \"execute\" }),\n }\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n private resolveSessionLifecycleResponse(\n response: ExecuteSessionApiResponse\n ): ExecuteSessionResult {\n if (\"error\" in response) {\n throw new ContextError(\n response.error,\n response.code,\n undefined,\n response.helpUrl\n );\n }\n\n if (response.success) {\n return {\n mode: response.mode,\n session: response.session,\n };\n }\n\n throw new ContextError(\"Unexpected response format from API\");\n }\n}\n","import type {\n QueryCapabilityMissPayload,\n QueryClarificationPayload,\n QueryClarificationPolicy,\n QueryOptions,\n QueryDeveloperTrace,\n QueryResult,\n QueryStreamEvent,\n} from \"../types.js\";\nimport { ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Query resource for pay-per-response agentic queries.\n *\n * Unlike `tools.execute()` which calls a single tool once (pay-per-request),\n * the Query resource sends a natural-language question and lets the server\n * handle discovery-first orchestration (`discover/probe -> plan-from-evidence ->\n * execute -> bounded fallback`) plus AI synthesis — all for one flat fee.\n *\n * This is the \"prepared meal\" vs \"raw ingredients\" distinction:\n * - `tools.execute()` = raw data, full control, predictable cost\n * - `query.run()` / `query.stream()` = curated intelligence, one payment\n */\nexport class Query {\n constructor(private client: ContextClient) {}\n\n private normalizeResult(result: QueryResult): QueryResult {\n const candidate = result as QueryResult & { outcomeType?: string };\n if (\n candidate.outcomeType === \"clarification_required\" &&\n \"clarification\" in candidate &&\n candidate.clarification\n ) {\n return candidate;\n }\n if (\n candidate.outcomeType === \"capability_miss\" &&\n \"capabilityMiss\" in candidate &&\n candidate.capabilityMiss\n ) {\n return candidate;\n }\n return {\n ...candidate,\n outcomeType: \"answer\",\n };\n }\n\n private buildPolicyErrorEvent(params: {\n result: QueryResult;\n clarificationPolicy?: QueryClarificationPolicy;\n }):\n | {\n type: \"error\";\n error: string;\n code: string;\n reasonCode: string;\n outcomeType: \"clarification_required\" | \"capability_miss\";\n clarification?: QueryClarificationPayload;\n capabilityMiss?: QueryCapabilityMissPayload;\n querySession?: QueryResult[\"querySession\"];\n }\n | undefined {\n if (params.clarificationPolicy !== \"error\") {\n return;\n }\n\n if (params.result.outcomeType === \"clarification_required\") {\n return {\n type: \"error\",\n error: params.result.response,\n code: \"clarification_required\",\n reasonCode: \"clarification_required\",\n outcomeType: \"clarification_required\",\n clarification: params.result.clarification,\n querySession: params.result.querySession,\n };\n }\n\n if (params.result.outcomeType === \"capability_miss\") {\n return {\n type: \"error\",\n error: params.result.response,\n code: \"capability_miss\",\n reasonCode: \"capability_miss\",\n outcomeType: \"capability_miss\",\n capabilityMiss: params.result.capabilityMiss,\n querySession: params.result.querySession,\n };\n }\n\n return undefined;\n }\n\n private buildSyntheticTraceFromRunResult(params: {\n toolsUsed: Array<{ id: string; name: string; skillCalls: number }>;\n durationMs: number;\n }): QueryDeveloperTrace {\n const timeline = params.toolsUsed.map((tool, index) => ({\n stepType: \"tool-call\",\n event: \"tool-call\",\n status: \"success\",\n timestampMs: index,\n tool: {\n id: tool.id,\n name: tool.name,\n },\n metadata: {\n skillCalls: tool.skillCalls,\n synthetic: true,\n },\n }));\n\n const toolCalls = params.toolsUsed.reduce(\n (sum, tool) => sum + Math.max(tool.skillCalls, 0),\n 0\n );\n\n return {\n summary: {\n toolCalls,\n retryCount: 0,\n selfHealCount: 0,\n fallbackCount: 0,\n failureCount: 0,\n recoveryCount: 0,\n completionChecks: 0,\n loopCount: 0,\n },\n timeline,\n source: \"sdk-fallback\",\n synthetic: true,\n reason: \"backend_trace_missing\",\n durationMs: params.durationMs,\n };\n }\n\n private buildSyntheticTraceFromStreamStatus(params: {\n statusTimeline: Array<{\n status: string;\n tool: { id: string; name: string };\n }>;\n toolsUsed: Array<{ id: string; name: string; skillCalls: number }>;\n durationMs: number;\n }): QueryDeveloperTrace {\n const timeline = params.statusTimeline.map((entry, index) => ({\n stepType: \"tool-status\",\n event: \"tool-status\",\n status: entry.status,\n timestampMs: index,\n tool:\n entry.tool.name || entry.tool.id\n ? {\n id: entry.tool.id || undefined,\n name: entry.tool.name || undefined,\n }\n : undefined,\n metadata: { synthetic: true },\n }));\n\n const toolCallsFromUsage = params.toolsUsed.reduce(\n (sum, tool) => sum + Math.max(tool.skillCalls, 0),\n 0\n );\n const toolCallsFromStatus = params.statusTimeline.filter(\n (entry) => entry.status === \"tool-complete\"\n ).length;\n const toolCalls = toolCallsFromUsage > 0 ? toolCallsFromUsage : toolCallsFromStatus;\n\n const retryCount = params.statusTimeline.filter((entry) =>\n /(retry|fix|reflect|recover)/i.test(entry.status)\n ).length;\n const completionChecks = params.statusTimeline.filter((entry) =>\n /complet/i.test(entry.status)\n ).length;\n\n return {\n summary: {\n toolCalls,\n retryCount,\n selfHealCount: retryCount,\n fallbackCount: 0,\n failureCount: 0,\n recoveryCount: 0,\n completionChecks,\n loopCount: retryCount,\n },\n timeline,\n source: \"sdk-fallback\",\n synthetic: true,\n reason: \"backend_trace_missing\",\n durationMs: params.durationMs,\n };\n }\n\n private mergeDeveloperTrace(\n first: QueryDeveloperTrace | undefined,\n second: QueryDeveloperTrace | undefined\n ): QueryDeveloperTrace | undefined {\n if (!first) return second;\n if (!second) return first;\n\n const firstTimeline = Array.isArray(first.timeline) ? first.timeline : [];\n const secondTimeline = Array.isArray(second.timeline) ? second.timeline : [];\n const mergedTimeline = [...firstTimeline, ...secondTimeline];\n\n return {\n ...first,\n ...second,\n summary: {\n ...(typeof first.summary === \"object\" && first.summary ? first.summary : {}),\n ...(typeof second.summary === \"object\" && second.summary\n ? second.summary\n : {}),\n },\n ...(mergedTimeline.length > 0 ? { timeline: mergedTimeline } : {}),\n };\n }\n\n private parseStreamEvent(rawData: string): QueryStreamEvent | undefined {\n const parsed = JSON.parse(rawData) as unknown;\n if (!parsed || typeof parsed !== \"object\") {\n return undefined;\n }\n\n const event = parsed as QueryStreamEvent;\n if (typeof (event as { type?: unknown }).type !== \"string\") {\n return undefined;\n }\n\n return event;\n }\n\n /**\n * Run an agentic query and wait for the full response.\n *\n * The server discovers relevant tools (or uses the ones you specify),\n * executes the discovery-first pipeline (up to 100 MCP calls per tool),\n * and returns an AI-synthesized answer. Payment is settled after\n * successful execution via deferred settlement.\n *\n * @param options - Query options or a plain string question\n * @returns The complete query result with response text, tools used, and cost\n *\n * @throws {ContextError} With code `no_wallet` if wallet not set up\n * @throws {ContextError} With code `insufficient_allowance` if spending cap not set\n * @throws {ContextError} With code `payment_failed` if payment settlement fails\n * @throws {ContextError} With code `execution_failed` if the agentic pipeline fails\n *\n * @example\n * ```typescript\n * // Simple question — server discovers tools automatically\n * const answer = await client.query.run(\"What are the top whale movements on Base?\");\n * console.log(answer.response); // AI-synthesized answer\n * console.log(answer.toolsUsed); // Which tools were used\n * console.log(answer.cost); // Cost breakdown\n *\n * // With specific tools (Manual Mode)\n * const answer = await client.query.run({\n * query: \"Analyze whale activity\",\n * tools: [\"tool-uuid-1\", \"tool-uuid-2\"],\n * });\n * ```\n */\n async run(options: QueryOptions | string): Promise<QueryResult> {\n const opts = typeof options === \"string\" ? { query: options } : options;\n let terminalError:\n | { error: string; code?: string; scope?: string; reasonCode?: string }\n | undefined;\n let finalResult: QueryResult | undefined;\n\n for await (const event of this.stream(opts)) {\n if (event.type === \"error\") {\n terminalError = {\n error: event.error,\n ...(event.code ? { code: event.code } : {}),\n ...(event.scope ? { scope: event.scope } : {}),\n ...(event.reasonCode ? { reasonCode: event.reasonCode } : {}),\n };\n continue;\n }\n\n if (event.type === \"done\") {\n finalResult = event.result;\n }\n }\n\n if (finalResult) {\n return finalResult;\n }\n\n if (terminalError) {\n throw new ContextError(terminalError.error, terminalError.code);\n }\n\n throw new ContextError(\"Streaming query ended before done event\");\n }\n\n /**\n * Run an agentic query with streaming. Returns an async iterable that\n * yields events as the server processes the query in real-time.\n *\n * Event types:\n * - `tool-status` — A tool started executing or changed status\n * - `text-delta` — A chunk of the AI response text\n * - `developer-trace` — Runtime trace metadata (when includeDeveloperTrace=true)\n * - `error` — A structured query/runtime error emitted before stream completion\n * - `done` — The full response is complete (includes final `QueryResult`)\n *\n * @param options - Query options or a plain string question\n * @returns An async iterable of stream events\n *\n * @example\n * ```typescript\n * for await (const event of client.query.stream(\"What are the top whale movements?\")) {\n * switch (event.type) {\n * case \"tool-status\":\n * console.log(`Tool ${event.tool.name}: ${event.status}`);\n * break;\n * case \"text-delta\":\n * process.stdout.write(event.delta);\n * break;\n * case \"developer-trace\":\n * console.log(\"Trace summary:\", event.trace.summary);\n * break;\n * case \"done\":\n * console.log(\"\\nCost:\", event.result.cost.totalCostUsd);\n * break;\n * case \"error\":\n * console.error(\"Stream error:\", event.error);\n * break;\n * }\n * }\n * ```\n */\n async *stream(\n options: QueryOptions | string\n ): AsyncGenerator<QueryStreamEvent> {\n const opts = typeof options === \"string\" ? { query: options } : options;\n const headers = opts.idempotencyKey\n ? { \"Idempotency-Key\": opts.idempotencyKey }\n : undefined;\n\n const response = await this.client._fetchRaw(\"/api/v1/query\", {\n method: \"POST\",\n headers,\n body: JSON.stringify({\n query: opts.query,\n tools: opts.tools,\n resumeFrom: opts.resumeFrom,\n forkFrom: opts.forkFrom,\n clarificationPolicy: opts.clarificationPolicy,\n answerModelId: opts.answerModelId,\n responseShape: opts.responseShape,\n includeData: opts.includeData,\n includeDataUrl: opts.includeDataUrl,\n includeDeveloperTrace: opts.includeDeveloperTrace,\n queryDepth: opts.queryDepth,\n debugScoutDeepMode: opts.debugScoutDeepMode,\n stream: true,\n }),\n });\n\n const body = response.body;\n if (!body) {\n throw new ContextError(\"No response body for streaming query\");\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = \"\";\n let aggregatedTrace: QueryDeveloperTrace | undefined;\n const statusTimeline: Array<{\n status: string;\n tool: { id: string; name: string };\n }> = [];\n\n const parseAndHydrateEvent = (\n rawData: string\n ): QueryStreamEvent | undefined => {\n const event = this.parseStreamEvent(rawData);\n if (!event) {\n return undefined;\n }\n\n if (event.type === \"developer-trace\") {\n aggregatedTrace = this.mergeDeveloperTrace(aggregatedTrace, event.trace);\n return event;\n }\n\n if (event.type === \"tool-status\") {\n statusTimeline.push({\n status: event.status,\n tool: {\n id: event.tool.id,\n name: event.tool.name,\n },\n });\n return event;\n }\n\n if (event.type === \"done\") {\n const normalizedResult = this.normalizeResult(event.result);\n let mergedTrace = this.mergeDeveloperTrace(\n aggregatedTrace,\n normalizedResult.developerTrace\n );\n if (!mergedTrace && opts.includeDeveloperTrace) {\n mergedTrace =\n statusTimeline.length > 0\n ? this.buildSyntheticTraceFromStreamStatus({\n statusTimeline,\n toolsUsed: normalizedResult.toolsUsed,\n durationMs: normalizedResult.durationMs,\n })\n : this.buildSyntheticTraceFromRunResult({\n toolsUsed: normalizedResult.toolsUsed,\n durationMs: normalizedResult.durationMs,\n });\n }\n if (mergedTrace) {\n normalizedResult.developerTrace = mergedTrace;\n }\n event.result = normalizedResult;\n\n const policyErrorEvent = this.buildPolicyErrorEvent({\n result: normalizedResult,\n clarificationPolicy: opts.clarificationPolicy,\n });\n if (policyErrorEvent) {\n return policyErrorEvent;\n }\n }\n\n return event;\n };\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\";\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (trimmed.startsWith(\"data: \")) {\n const data = trimmed.slice(6);\n if (data === \"[DONE]\") return;\n try {\n const event = parseAndHydrateEvent(data);\n if (event) {\n yield event;\n }\n } catch {\n // Skip malformed SSE events\n }\n }\n }\n }\n\n // Process any remaining buffer\n if (buffer.trim().startsWith(\"data: \")) {\n const data = buffer.trim().slice(6);\n if (data !== \"[DONE]\") {\n try {\n const event = parseAndHydrateEvent(data);\n if (event) {\n yield event;\n }\n } catch {\n // Skip malformed SSE events\n }\n }\n }\n } finally {\n reader.releaseLock();\n }\n }\n}\n","import type { ContextClientOptions } from \"./types.js\";\nimport { ContextError } from \"./types.js\";\nimport { Developer } from \"./resources/developer.js\";\nimport { Discovery } from \"./resources/discovery.js\";\nimport { Tools } from \"./resources/tools.js\";\nimport { Query } from \"./resources/query.js\";\n\nconst DEFAULT_BASE_URL = \"https://www.ctxprotocol.com\";\nconst DEFAULT_REQUEST_TIMEOUT_MS = 300_000;\nconst DEFAULT_STREAM_TIMEOUT_MS = 600_000;\n\n/**\n * The official TypeScript client for the Context Protocol.\n *\n * Use this client to discover and execute AI tools programmatically.\n *\n * @example\n * ```typescript\n * import { ContextClient } from \"@contextprotocol/client\";\n *\n * const client = new ContextClient({\n * apiKey: \"sk_live_...\"\n * });\n *\n * // Pay-per-request: Execute a specific tool\n * const result = await client.tools.execute({\n * toolId: \"tool-uuid\",\n * toolName: \"get_gas_prices\",\n * args: { chainId: 1 }\n * });\n *\n * // Pay-per-response: Ask a question, get a curated answer\n * const answer = await client.query.run(\"What are the top whale movements on Base?\");\n * console.log(answer.response);\n * ```\n */\nexport class ContextClient {\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly requestTimeoutMs: number;\n private readonly streamTimeoutMs: number;\n private _closed = false;\n\n /**\n * Developer resource for managing tool listings (contributor/developer concerns).\n */\n public readonly developer: Developer;\n\n /**\n * Discovery resource for searching tools\n */\n public readonly discovery: Discovery;\n\n /**\n * Tools resource for executing tools (pay-per-request)\n */\n public readonly tools: Tools;\n\n /**\n * Query resource for agentic queries (pay-per-response).\n *\n * Unlike `tools.execute()` which calls a single tool once, `query` sends\n * a natural-language question and lets the server handle tool discovery,\n * multi-tool orchestration, self-healing, and AI synthesis — one flat fee.\n */\n public readonly query: Query;\n\n /**\n * Creates a new Context Protocol client\n *\n * @param options - Client configuration options\n * @param options.apiKey - Your Context Protocol API key (format: sk_live_...)\n * @param options.baseUrl - Optional base URL override (defaults to https://www.ctxprotocol.com)\n * @param options.requestTimeoutMs - Optional timeout for non-streaming requests (default 300000ms)\n * @param options.streamTimeoutMs - Optional timeout for establishing stream requests (default 600000ms)\n */\n constructor(options: ContextClientOptions) {\n if (!options.apiKey) {\n throw new ContextError(\"API key is required\");\n }\n\n const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n const streamTimeoutMs = options.streamTimeoutMs ?? DEFAULT_STREAM_TIMEOUT_MS;\n\n if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) {\n throw new ContextError(\"requestTimeoutMs must be a positive number\");\n }\n\n if (!Number.isFinite(streamTimeoutMs) || streamTimeoutMs <= 0) {\n throw new ContextError(\"streamTimeoutMs must be a positive number\");\n }\n\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n this.requestTimeoutMs = requestTimeoutMs;\n this.streamTimeoutMs = streamTimeoutMs;\n\n // Initialize resources\n this.developer = new Developer(this);\n this.discovery = new Discovery(this);\n this.tools = new Tools(this);\n this.query = new Query(this);\n }\n\n /**\n * Close the client and clean up resources.\n * After calling close(), any in-flight requests may be aborted.\n */\n close(): void {\n this._closed = true;\n }\n\n /**\n * Internal method for making authenticated HTTP requests\n * Includes timeout and retry with exponential backoff for transient errors\n *\n * @internal\n */\n async _fetch<T>(\n endpoint: string,\n options: RequestInit = {},\n fetchOptions?: { retry?: boolean }\n ): Promise<T> {\n if (this._closed) {\n throw new ContextError(\"Client has been closed\");\n }\n\n const url = `${this.baseUrl}${endpoint}`;\n const maxRetries = 3;\n const timeoutMs = this.requestTimeoutMs;\n const method = (options.method ?? \"GET\").toUpperCase();\n const requestHeaders = new Headers(options.headers);\n const canRetryRequest =\n fetchOptions?.retry === false\n ? false\n : method === \"GET\" ||\n method === \"HEAD\" ||\n method === \"OPTIONS\" ||\n requestHeaders.has(\"Idempotency-Key\");\n\n let lastError: Error | undefined;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), timeoutMs);\n const mergedHeaders = new Headers(requestHeaders);\n if (!mergedHeaders.has(\"Content-Type\")) {\n mergedHeaders.set(\"Content-Type\", \"application/json\");\n }\n mergedHeaders.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n try {\n const response = await fetch(url, {\n ...options,\n signal: controller.signal,\n headers: mergedHeaders,\n });\n\n clearTimeout(timeout);\n\n if (!response.ok) {\n // Retry on 5xx server errors\n if (response.status >= 500 && canRetryRequest && attempt < maxRetries) {\n const delay = Math.min(1000 * 2 ** attempt, 10_000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n continue;\n }\n\n let errorMessage = `HTTP ${response.status}: ${response.statusText}`;\n let errorCode: string | undefined;\n let helpUrl: string | undefined;\n\n try {\n const errorBody = await response.json();\n if (errorBody.error) {\n errorMessage = errorBody.error;\n errorCode = errorBody.code;\n helpUrl = errorBody.helpUrl;\n }\n } catch {\n // Use default error message if JSON parsing fails\n }\n\n throw new ContextError(errorMessage, errorCode, response.status, helpUrl);\n }\n\n try {\n return (await response.json()) as T;\n } catch (error) {\n const parseError = error instanceof Error ? error : new Error(String(error));\n throw new ContextError(\n `Failed to parse JSON response: ${parseError.message}`,\n undefined,\n response.status\n );\n }\n } catch (error) {\n clearTimeout(timeout);\n\n if (error instanceof ContextError) {\n throw error;\n }\n\n lastError = error instanceof Error ? error : new Error(String(error));\n\n // Retry on network errors and timeouts\n const isRetryable =\n lastError.name === \"AbortError\" ||\n lastError.message.includes(\"fetch failed\") ||\n lastError.message.includes(\"ECONNRESET\") ||\n lastError.message.includes(\"ETIMEDOUT\");\n\n if (isRetryable && canRetryRequest && attempt < maxRetries) {\n const delay = Math.min(1000 * 2 ** attempt, 10_000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n continue;\n }\n\n if (lastError.name === \"AbortError\") {\n throw new ContextError(\n `Request timed out after ${timeoutMs / 1000}s`,\n undefined,\n 408\n );\n }\n\n throw new ContextError(\n lastError.message,\n undefined,\n undefined\n );\n }\n }\n\n throw lastError ?? new ContextError(\"Request failed after retries\");\n }\n\n /**\n * Internal method for making authenticated HTTP requests that returns\n * the raw Response object. Used for streaming endpoints (SSE).\n * Includes a configurable timeout for stream setup.\n *\n * @internal\n */\n async _fetchRaw(endpoint: string, options: RequestInit = {}): Promise<Response> {\n if (this._closed) {\n throw new ContextError(\"Client has been closed\");\n }\n\n const url = `${this.baseUrl}${endpoint}`;\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), this.streamTimeoutMs);\n\n let response: Response;\n try {\n response = await fetch(url, {\n ...options,\n signal: controller.signal,\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${this.apiKey}`,\n ...options.headers,\n },\n });\n } catch (error) {\n clearTimeout(timeout);\n const lastError = error instanceof Error ? error : new Error(String(error));\n if (lastError.name === \"AbortError\") {\n throw new ContextError(\n `Streaming request timed out after ${this.streamTimeoutMs / 1000}s`,\n undefined,\n 408\n );\n }\n throw new ContextError(lastError.message);\n }\n\n clearTimeout(timeout);\n\n if (!response.ok) {\n let errorMessage = `HTTP ${response.status}: ${response.statusText}`;\n let errorCode: string | undefined;\n let helpUrl: string | undefined;\n\n try {\n const errorBody = await response.json();\n if (errorBody.error) {\n errorMessage = errorBody.error;\n errorCode = errorBody.code;\n helpUrl = errorBody.helpUrl;\n }\n } catch {\n // Use default error message if JSON parsing fails\n }\n\n throw new ContextError(errorMessage, errorCode, response.status, helpUrl);\n }\n\n return response;\n }\n}\n","/**\n * Context types for portfolio and protocol data injection.\n *\n * These types allow MCP tools to receive personalized user context\n * (wallet addresses, positions, balances) for analysis.\n *\n * =============================================================================\n * DECLARING CONTEXT REQUIREMENTS\n * =============================================================================\n *\n * Context requirements are declared via `_meta.contextRequirements` at the tool level.\n * This is the primary mechanism that the Context Platform reads.\n *\n * Previously, `x-context-requirements` in inputSchema was recommended, but the MCP SDK\n * may strip extension properties during transport. Use `_meta` instead.\n *\n * @example\n * ```typescript\n * import { CONTEXT_REQUIREMENTS_KEY, type ContextRequirementType } from \"@ctxprotocol/sdk\";\n * import type { HyperliquidContext } from \"@ctxprotocol/sdk\";\n *\n * const tool = {\n * name: \"analyze_my_positions\",\n * _meta: {\n * contextRequirements: [\"hyperliquid\"] as ContextRequirementType[],\n * },\n * inputSchema: {\n * type: \"object\",\n * properties: {\n * portfolio: { type: \"object\" }\n * },\n * required: [\"portfolio\"]\n * }\n * };\n *\n * // Your handler receives the injected context:\n * function handleAnalyzeMyPositions(args: { portfolio: HyperliquidContext }) {\n * const { perpPositions, accountSummary } = args.portfolio;\n * // ... analyze and return insights\n * }\n * ```\n *\n * @packageDocumentation\n */\n\n// Wallet context types\nexport * from \"./wallet.js\";\n\n// Protocol-specific context types\nexport * from \"./polymarket.js\";\nexport * from \"./hyperliquid.js\";\n\n// Re-import for composite type\nimport type { WalletContext, ERC20Context } from \"./wallet.js\";\nimport type { PolymarketContext } from \"./polymarket.js\";\nimport type { HyperliquidContext } from \"./hyperliquid.js\";\n\n// ============================================================================\n// CONTEXT REQUIREMENTS\n//\n// MCP tools that need user portfolio data MUST declare this in inputSchema.\n// The MCP protocol only transmits standard fields (name, description,\n// inputSchema, outputSchema). Custom fields get stripped by the MCP SDK.\n// ============================================================================\n\n/**\n * @deprecated Use `_meta.contextRequirements` instead (see META_CONTEXT_REQUIREMENTS_KEY).\n *\n * This key was designed for embedding requirements in inputSchema,\n * but the MCP SDK may strip `x-` prefixed extension properties during transport.\n * The `_meta.contextRequirements` approach is what the Context Platform reads.\n */\nexport const CONTEXT_REQUIREMENTS_KEY = \"x-context-requirements\" as const;\n\n/**\n * The key used inside `_meta` to declare context requirements.\n * This is the PRIMARY mechanism — the Context Platform reads `_meta.contextRequirements`.\n *\n * @example\n * ```typescript\n * const tool = {\n * name: \"analyze_my_positions\",\n * _meta: {\n * [META_CONTEXT_REQUIREMENTS_KEY]: [\"hyperliquid\"] as ContextRequirementType[],\n * },\n * inputSchema: {\n * type: \"object\",\n * properties: { portfolio: { type: \"object\" } },\n * required: [\"portfolio\"]\n * }\n * };\n * ```\n */\nexport const META_CONTEXT_REQUIREMENTS_KEY = \"contextRequirements\" as const;\n\n/**\n * Context requirement types supported by the Context marketplace.\n * Maps to protocol-specific context builders on the platform.\n *\n * @example\n * ```typescript\n * inputSchema: {\n * type: \"object\",\n * \"x-context-requirements\": [\"hyperliquid\"] as ContextRequirementType[],\n * properties: { portfolio: { type: \"object\" } },\n * required: [\"portfolio\"]\n * }\n * ```\n */\nexport type ContextRequirementType = \"polymarket\" | \"hyperliquid\" | \"wallet\";\n\n/**\n * @deprecated The `requirements` field at tool level gets stripped by MCP SDK.\n * Use `x-context-requirements` inside `inputSchema` instead.\n *\n * @example\n * ```typescript\n * // ❌ OLD (doesn't work - stripped by MCP SDK)\n * { requirements: { context: [\"hyperliquid\"] } }\n *\n * // ✅ NEW (works - preserved through MCP transport)\n * { inputSchema: { \"x-context-requirements\": [\"hyperliquid\"], ... } }\n * ```\n */\nexport interface ToolRequirements {\n /**\n * @deprecated Use `x-context-requirements` in inputSchema instead.\n */\n context?: ContextRequirementType[];\n}\n\n/**\n * Composite context for tools that need multiple data sources.\n *\n * This is the unified structure that can be passed to MCP tools\n * to provide comprehensive user context.\n */\nexport interface UserContext {\n /** Base wallet information */\n wallet?: WalletContext;\n /** ERC20 token holdings */\n erc20?: ERC20Context;\n /** Polymarket positions and orders */\n polymarket?: PolymarketContext;\n /** Hyperliquid perpetual positions and account data */\n hyperliquid?: HyperliquidContext;\n // Future protocols:\n // aave?: AaveContext;\n}\n","import { jwtVerify, importSPKI, type JWTPayload } from \"jose\";\nimport { ContextError } from \"../client/types.js\";\n\n// ============================================================================\n// Express-compatible types (avoid requiring express as a dependency)\n// ============================================================================\n\ninterface ContextRequest {\n headers: {\n authorization?: string;\n [key: string]: string | string[] | undefined;\n };\n body?: {\n method?: string;\n [key: string]: unknown;\n };\n context?: JWTPayload;\n}\n\ninterface ContextResponse {\n status(code: number): ContextResponse;\n json(data: unknown): void;\n}\n\ntype NextFunction = (error?: unknown) => void;\n\n/**\n * Extended Request object with verified Context Protocol JWT payload.\n *\n * After `createContextMiddleware()` runs successfully on a protected method,\n * the `context` property contains the decoded JWT claims.\n */\nexport interface ContextMiddlewareRequest extends ContextRequest {\n /** The verified JWT payload from Context Protocol (available after auth) */\n context?: JWTPayload;\n}\n\n// ============================================================================\n// Configuration\n// ============================================================================\n\n// The Context Protocol Public Key\n// In a real scenario, this might be fetched from a well-known URL or passed in config.\n// For now, we hardcode the Official Platform Public Key.\n// Official Context Protocol Platform Public Key (RS256)\nconst CONTEXT_PLATFORM_PUBLIC_KEY_PEM = `-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs9YOgdpkmVQ5aoNovjsu\nchJdV54OT7dUdbVXz914a7Px8EwnpDqhsvG7WO8xL8sj2Rn6ueAJBk+04Hy/P/UN\nRJyp23XL5TsGmb4rbfg0ii0MiL2nbVXuqvAe3JSM2BOFZR5bpwIVIaa8aonfamUy\nVXGc7OosF90ThdKjm9cXlVM+kV6IgSWc1502X7M3abQqRcTU/rluVXnky0eiWDQa\nlfOKbr7w0u72dZjiZPwnNDsX6PEEgvfmoautTFYTQgnZjDzq8UimTcv3KF+hJ5Ep\nweipe6amt9lzQzi8WXaFKpOXHQs//WDlUytz/Hl8pvd5craZKzo6Kyrg1Vfan7H3\nTQIDAQAB\n-----END PUBLIC KEY-----`;\n\n// ============================================================================\n// JWKS Key Fetching (with hardcoded fallback)\n// ============================================================================\n\nconst JWKS_URL = \"https://ctxprotocol.com/.well-known/jwks.json\";\nconst KEY_CACHE_TTL_MS = 3_600_000; // 1 hour\n\nlet cachedPublicKey: Awaited<ReturnType<typeof importSPKI>> | null = null;\nlet cacheTimestamp = 0;\n\n/**\n * Get the platform public key, trying JWKS endpoint first with hardcoded fallback.\n * Caches the result for 1 hour.\n */\nasync function getPlatformPublicKey(): Promise<Awaited<ReturnType<typeof importSPKI>>> {\n const now = Date.now();\n\n // Return cached key if still valid\n if (cachedPublicKey && now - cacheTimestamp < KEY_CACHE_TTL_MS) {\n return cachedPublicKey;\n }\n\n // Try JWKS endpoint first\n try {\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), 5000);\n\n const response = await fetch(JWKS_URL, { signal: controller.signal });\n clearTimeout(timeout);\n\n if (response.ok) {\n const jwks = await response.json() as { keys?: Array<{ x5c?: string[]; kty?: string; n?: string; e?: string }> };\n if (jwks.keys && jwks.keys.length > 0) {\n const key = jwks.keys[0];\n // If the JWKS contains x5c (X.509 cert chain), extract the public key\n if (key.x5c && key.x5c.length > 0) {\n const pem = `-----BEGIN CERTIFICATE-----\\n${key.x5c[0]}\\n-----END CERTIFICATE-----`;\n const { importX509 } = await import(\"jose\");\n cachedPublicKey = await importX509(pem, \"RS256\");\n cacheTimestamp = now;\n return cachedPublicKey;\n }\n }\n }\n } catch {\n // JWKS fetch failed - fall back to hardcoded key\n }\n\n // Fallback: use hardcoded key\n cachedPublicKey = await importSPKI(CONTEXT_PLATFORM_PUBLIC_KEY_PEM, \"RS256\");\n cacheTimestamp = now;\n return cachedPublicKey;\n}\n\n/**\n * MCP methods that require authentication.\n * - tools/call: Executes tool logic, may cost money\n * - resources/read: Reads potentially sensitive data\n * - prompts/get: Gets prompt content\n */\nconst PROTECTED_MCP_METHODS = new Set([\n \"tools/call\",\n // Uncomment these if you want to protect resource/prompt access:\n // \"resources/read\",\n // \"prompts/get\",\n]);\n\n/**\n * MCP methods that are always open (no auth required).\n * These are discovery/listing operations that return metadata only.\n */\nconst OPEN_MCP_METHODS = new Set([\n \"initialize\",\n \"tools/list\",\n \"resources/list\",\n \"prompts/list\",\n \"ping\",\n \"notifications/initialized\",\n]);\n\n// ============================================================================\n// Method Classification\n// ============================================================================\n\n/**\n * Determines if a given MCP method requires authentication.\n *\n * Discovery methods (tools/list, resources/list, etc.) are open.\n * Execution methods (tools/call) require authentication.\n *\n * @param method The MCP JSON-RPC method (e.g., \"tools/list\", \"tools/call\")\n * @returns true if the method requires authentication\n *\n * @example\n * ```typescript\n * if (isProtectedMcpMethod(body.method)) {\n * await verifyContextRequest({ authorizationHeader: req.headers.authorization });\n * }\n * ```\n */\nexport function isProtectedMcpMethod(method: string): boolean {\n return PROTECTED_MCP_METHODS.has(method);\n}\n\n/**\n * Determines if a given MCP method is explicitly open (no auth).\n *\n * @param method The MCP JSON-RPC method\n * @returns true if the method is known to be open\n */\nexport function isOpenMcpMethod(method: string): boolean {\n return OPEN_MCP_METHODS.has(method);\n}\n\n// ============================================================================\n// Request Verification\n// ============================================================================\n\nexport interface VerifyRequestOptions {\n /** The full Authorization header string (e.g. \"Bearer eyJ...\") */\n authorizationHeader?: string;\n /** Expected Audience (your tool URL) for stricter validation */\n audience?: string;\n}\n\n/**\n * Verifies that an incoming request originated from the Context Protocol Platform.\n *\n * @param options Contains the Authorization header\n * @returns The decoded payload if valid\n * @throws ContextError if invalid\n */\nexport async function verifyContextRequest(options: VerifyRequestOptions) {\n const { authorizationHeader, audience } = options;\n\n if (!authorizationHeader || !authorizationHeader.startsWith(\"Bearer \")) {\n throw new ContextError(\n \"Missing or invalid Authorization header\",\n \"unauthorized\",\n 401\n );\n }\n\n const token = authorizationHeader.split(\" \")[1];\n\n try {\n const publicKey = await getPlatformPublicKey();\n\n const { payload } = await jwtVerify(token, publicKey, {\n issuer: \"https://ctxprotocol.com\",\n audience: audience,\n });\n\n return payload;\n } catch (error) {\n throw new ContextError(\n \"Invalid Context Protocol signature\",\n \"unauthorized\",\n 401\n );\n }\n}\n\n// ============================================================================\n// Easy-Mode Middleware\n// ============================================================================\n\nexport interface CreateContextMiddlewareOptions {\n /** Expected Audience (your tool URL) for stricter validation */\n audience?: string;\n}\n\n/**\n * Creates an Express/Connect-compatible middleware that secures your MCP endpoint.\n *\n * This is the \"1 line of code\" solution to secure your MCP server.\n * It automatically:\n * - Allows discovery methods (tools/list, initialize) without authentication\n * - Requires and verifies JWT for execution methods (tools/call)\n * - Attaches the verified payload to `req.context` for downstream use\n *\n * @param options Optional configuration\n * @returns Express-compatible middleware function\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { createContextMiddleware } from \"@ctxprotocol/sdk\";\n *\n * const app = express();\n * app.use(express.json());\n *\n * // 1 line to secure your endpoint\n * app.use(\"/mcp\", createContextMiddleware());\n *\n * app.post(\"/mcp\", (req, res) => {\n * // req.context contains verified JWT payload (on protected methods)\n * // Handle MCP request...\n * });\n * ```\n */\nexport function createContextMiddleware(options: CreateContextMiddlewareOptions = {}) {\n return async function contextMiddleware(\n req: ContextRequest,\n res: ContextResponse,\n next: NextFunction\n ): Promise<void> {\n const method = req.body?.method as string | undefined;\n\n // Allow discovery methods without authentication\n // Discovery methods (tools/list, initialize, etc.) are open by design\n if (!method || !isProtectedMcpMethod(method)) {\n return next();\n }\n\n // Protected method - require authentication\n try {\n const payload = await verifyContextRequest({\n authorizationHeader: req.headers.authorization,\n audience: options.audience,\n });\n\n // Attach verified payload to request for downstream handlers\n req.context = payload;\n next();\n } catch (error) {\n const statusCode = error instanceof ContextError ? error.statusCode || 401 : 401;\n res.status(statusCode).json({ error: \"Unauthorized\" });\n }\n };\n}\n\n\n","/**\n * Handshake Types for MCP Tool Developers\n *\n * Use these types when your tool needs to request user interaction\n * before completing an action (signatures, transactions, OAuth).\n *\n * @see https://docs.ctxprotocol.com/guides/handshake-architecture\n *\n * ## Usage Pattern\n *\n * Tools return handshake actions in the `_meta.handshakeAction` field\n * of their MCP response. The Context platform intercepts these and\n * presents the appropriate UI to the user.\n *\n * These helpers define the contributor-side MCP response contract.\n * They do not create a headless Query API approval/resume flow; completing\n * a handshake currently requires the Context chat app UI.\n *\n * ## Action Types\n *\n * - `signature_request`: For EIP-712 signatures (Hyperliquid, Polymarket, etc.)\n * - `transaction_proposal`: For direct on-chain transactions (Uniswap, NFT mints)\n * - `auth_required`: For OAuth flows (Discord, Twitter, etc.)\n */\n\n// === Shared Meta Type ===\n\nexport type HandshakeMeta = {\n /** Human-readable description of the action */\n description: string;\n /** Protocol name (e.g., \"Hyperliquid\", \"Polymarket\") */\n protocol?: string;\n /** Action verb (e.g., \"Place Order\", \"Place Bid\") */\n action?: string;\n /** Token symbol if relevant */\n tokenSymbol?: string;\n /** Human-readable token amount */\n tokenAmount?: string;\n /** UI warning level */\n warningLevel?: \"info\" | \"caution\" | \"danger\";\n /** Custom title for the signature card (marketplace-friendly, overrides action-based title) */\n title?: string;\n /** Custom subtitle for the signature card (overrides tool name display) */\n subtitle?: string;\n};\n\n// === Web3: Signature Requests (for proxy wallet platforms) ===\n\nexport type EIP712Domain = {\n /** Domain name (e.g., \"Hyperliquid\", \"ClobAuthDomain\") */\n name: string;\n /** Domain version */\n version: string;\n /** Chain ID (informational - signing is chain-agnostic) */\n chainId: number;\n /** Optional verifying contract address */\n verifyingContract?: `0x${string}`;\n};\n\nexport type EIP712TypeField = {\n name: string;\n type: string;\n};\n\n/**\n * Signature Request\n *\n * Use this for platforms with proxy wallets (Hyperliquid, Polymarket, dYdX).\n *\n * Benefits:\n * - No gas required (user signs a message, not a transaction)\n * - No network switching needed (signing is chain-agnostic)\n * - Works with Privy embedded wallets on any chain\n *\n * @example\n * ```typescript\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createSignatureRequest({\n * domain: { name: \"Hyperliquid\", version: \"1\", chainId: 42161 },\n * types: { Order: [...] },\n * primaryType: \"Order\",\n * message: { asset: 4, isBuy: true, ... },\n * meta: { description: \"Place Long ETH order\", protocol: \"Hyperliquid\" }\n * })\n * }\n * }\n * };\n * ```\n */\nexport type SignatureRequest = {\n _action: \"signature_request\";\n /** EIP-712 domain separator */\n domain: EIP712Domain;\n /** EIP-712 type definitions */\n types: Record<string, EIP712TypeField[]>;\n /** The primary type being signed */\n primaryType: string;\n /** The message data to sign */\n message: Record<string, unknown>;\n /** UI metadata for the approval card */\n meta?: HandshakeMeta;\n /**\n * Optional: Tool name to call with the signature result.\n * If provided, the platform will call this tool with { signature, originalParams }\n * after the user signs.\n */\n callbackToolName?: string;\n};\n\n// === Web3: Transaction Proposals (for direct on-chain actions) ===\n\nexport type TransactionProposalMeta = HandshakeMeta & {\n /** Estimated gas cost (informational - Context may sponsor) */\n estimatedGas?: string;\n /** Link to contract on block explorer */\n explorerUrl?: string;\n};\n\n/**\n * Transaction Proposal\n *\n * Use this for protocols without proxy wallets (Uniswap, NFT mints, etc.).\n *\n * Note: May require network switching and gas fees.\n *\n * @example\n * ```typescript\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createTransactionProposal({\n * chainId: 8453,\n * to: \"0x...\",\n * data: \"0x...\",\n * meta: { description: \"Swap 100 USDC for ETH\", protocol: \"Uniswap\" }\n * })\n * }\n * }\n * };\n * ```\n */\nexport type TransactionProposal = {\n _action: \"transaction_proposal\";\n /** EVM chain ID (e.g., 137 for Polygon, 8453 for Base) */\n chainId: number;\n /** Target contract address */\n to: `0x${string}`;\n /** Encoded calldata */\n data: `0x${string}`;\n /** Wei to send (as string, default \"0\") */\n value?: string;\n /** UI metadata for the approval card */\n meta?: TransactionProposalMeta;\n};\n\n// === Web2: OAuth Requests ===\n\nexport type AuthRequiredMeta = {\n /** Human-friendly service name */\n displayName?: string;\n /** Permissions being requested */\n scopes?: string[];\n /** Description of what access is needed */\n description?: string;\n /** Tool's icon URL */\n iconUrl?: string;\n /** How long authorization lasts */\n expiresIn?: string;\n};\n\n/**\n * Auth Required\n *\n * Use this when your tool needs the user to authenticate with an external service.\n *\n * @example\n * ```typescript\n * if (!hasUserToken(contextDid)) {\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createAuthRequired({\n * provider: \"discord\",\n * authUrl: \"https://your-server.com/oauth/discord\",\n * meta: { displayName: \"Discord Bot\", scopes: [\"send_messages\"] }\n * })\n * }\n * }\n * };\n * }\n * ```\n */\nexport type AuthRequired = {\n _action: \"auth_required\";\n /** Service identifier (e.g., \"discord\", \"slack\") */\n provider: string;\n /** Your OAuth initiation endpoint (MUST be HTTPS) */\n authUrl: string;\n /** UI metadata for the auth card */\n meta?: AuthRequiredMeta;\n};\n\n// === Union Type ===\n\nexport type HandshakeAction =\n | SignatureRequest\n | TransactionProposal\n | AuthRequired;\n\n// === Type Guards ===\n\nexport function isHandshakeAction(value: unknown): value is HandshakeAction {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"_action\" in value &&\n ((value as { _action: string })._action === \"signature_request\" ||\n (value as { _action: string })._action === \"transaction_proposal\" ||\n (value as { _action: string })._action === \"auth_required\")\n );\n}\n\nexport function isSignatureRequest(value: unknown): value is SignatureRequest {\n return isHandshakeAction(value) && value._action === \"signature_request\";\n}\n\nexport function isTransactionProposal(\n value: unknown\n): value is TransactionProposal {\n return isHandshakeAction(value) && value._action === \"transaction_proposal\";\n}\n\nexport function isAuthRequired(value: unknown): value is AuthRequired {\n return isHandshakeAction(value) && value._action === \"auth_required\";\n}\n\n// === Helper Functions for Tool Developers ===\n\n/**\n * Create a signature request response.\n * Return this from your tool when you need the user to sign EIP-712 typed data.\n *\n * Use this for platforms with proxy wallets (Hyperliquid, Polymarket, dYdX).\n * Benefits: No gas required, no network switching needed.\n */\nexport function createSignatureRequest(\n params: Omit<SignatureRequest, \"_action\">\n): SignatureRequest {\n return {\n _action: \"signature_request\",\n ...params,\n };\n}\n\n/**\n * Create a transaction proposal response.\n * Return this from your tool when you need the user to sign a direct on-chain transaction.\n *\n * Use this for protocols that don't use proxy wallets (Uniswap, NFT mints, etc.).\n * Note: May require network switching and gas.\n */\nexport function createTransactionProposal(\n params: Omit<TransactionProposal, \"_action\">\n): TransactionProposal {\n return {\n _action: \"transaction_proposal\",\n ...params,\n };\n}\n\n/**\n * Create an auth required response.\n * Return this from your tool when you need the user to authenticate via OAuth.\n */\nexport function createAuthRequired(\n params: Omit<AuthRequired, \"_action\">\n): AuthRequired {\n return {\n _action: \"auth_required\",\n ...params,\n };\n}\n\n// === MCP Response Helper ===\n\n/**\n * Wrap a handshake action in the proper MCP response format.\n *\n * MCP tools should return handshake actions in `_meta.handshakeAction` to prevent\n * the MCP SDK from stripping unknown fields.\n * Headless Query clients may observe raw internal handshake markers in\n * execution data, but they cannot submit approval results through the\n * Query API today.\n *\n * @example\n * ```typescript\n * // In your tool handler:\n * return wrapHandshakeResponse(createSignatureRequest({\n * domain: { name: \"Hyperliquid\", version: \"1\", chainId: 42161 },\n * types: { Order: [...] },\n * primaryType: \"Order\",\n * message: orderData,\n * meta: { description: \"Place order\", protocol: \"Hyperliquid\" }\n * }));\n * ```\n */\nexport function wrapHandshakeResponse(action: HandshakeAction): {\n content: Array<{ type: \"text\"; text: string }>;\n structuredContent: {\n _meta: { handshakeAction: HandshakeAction };\n status: string;\n message: string;\n };\n} {\n const actionType = action._action.replace(\"_\", \" \");\n return {\n content: [\n {\n type: \"text\",\n text: `Handshake required: ${actionType}. Please approve in the Context app.`,\n },\n ],\n structuredContent: {\n _meta: {\n handshakeAction: action,\n },\n status: \"handshake_required\",\n message: action.meta?.description ?? `${actionType} required`,\n },\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/client/types.ts","../src/client/resources/developer.ts","../src/client/resources/discovery.ts","../src/client/resources/tools.ts","../src/client/resources/query.ts","../src/client/client.ts","../src/context/index.ts","../src/auth/index.ts","../src/handshake/types.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ContributorSearchTraceRecord } from \"../contrib/search/types.js\";\n\n/**\n * Configuration options for initializing the ContextClient\n */\nexport interface ContextClientOptions {\n /**\n * Your Context Protocol API key\n * @example \"sk_live_abc123...\"\n */\n apiKey: string;\n\n /**\n * Base URL for the Context Protocol API\n * @default \"https://www.ctxprotocol.com\"\n */\n baseUrl?: string;\n\n /**\n * Request timeout for non-streaming API calls in milliseconds.\n * @default 300000\n */\n requestTimeoutMs?: number;\n\n /**\n * Request timeout for establishing streaming API calls in milliseconds.\n * @default 600000\n */\n streamTimeoutMs?: number;\n}\n\n/**\n * An individual MCP tool exposed by a tool listing\n */\nexport interface McpToolRateLimitHints {\n /** Suggested request budget for this method */\n maxRequestsPerMinute?: number;\n\n /** Suggested parallel call ceiling for this method */\n maxConcurrency?: number;\n\n /** Suggested minimum delay between sequential calls */\n cooldownMs?: number;\n\n /** Whether this method already supports bulk/batch retrieval */\n supportsBulk?: boolean;\n\n /** Preferred batch-oriented methods to call instead of fan-out loops */\n recommendedBatchTools?: string[];\n\n /** Optional human-readable notes for planning */\n notes?: string;\n}\n\nexport type DiscoveryMode = \"query\" | \"execute\";\nexport type McpToolSurface = \"answer\" | \"execute\" | \"both\";\nexport type McpToolLatencyClass = \"instant\" | \"fast\" | \"slow\" | \"streaming\";\n\nexport interface McpToolPricingMeta {\n executeUsd?: string;\n queryUsd?: string;\n [key: string]: unknown;\n}\n\nexport interface McpToolMeta {\n /** Declared method surface */\n surface?: McpToolSurface;\n\n /** Whether this method can be selected in query mode */\n queryEligible?: boolean;\n\n /** Declared latency class for planner/runtime gating */\n latencyClass?: McpToolLatencyClass;\n\n /** Method-level pricing metadata */\n pricing?: McpToolPricingMeta;\n\n /** Derived discovery flag for execute eligibility */\n executeEligible?: boolean;\n\n /** Derived discovery field for explicit execute pricing visibility */\n executePriceUsd?: string;\n\n /** Context injection requirements handled by the Context runtime */\n contextRequirements?: string[];\n\n /**\n * Optional planner/runtime pacing hints.\n * Tool contributors can publish these to reduce rate-limit failures.\n */\n rateLimit?: McpToolRateLimitHints;\n rateLimitHints?: McpToolRateLimitHints;\n\n /** Flat aliases accepted for convenience */\n maxRequestsPerMinute?: number;\n maxConcurrency?: number;\n cooldownMs?: number;\n supportsBulk?: boolean;\n recommendedBatchTools?: string[];\n notes?: string;\n\n [key: string]: unknown;\n}\n\nexport interface StructuredMethodGuidanceHints {\n /** Suggested call-order sequence extracted from method descriptions */\n callOrderHints?: string[];\n\n /** Parameter usage caveats extracted from method descriptions */\n parameterCaveats?: string[];\n\n /** Edge-case behavior notes extracted from method descriptions */\n edgeCaseNotes?: string[];\n}\n\nexport interface McpTool {\n /** Name of the MCP tool method */\n name: string;\n\n /** Description of what this method does */\n description: string;\n\n /**\n * JSON Schema for the input arguments this tool accepts.\n * Used by LLMs to generate correct arguments.\n */\n inputSchema?: Record<string, unknown>;\n\n /**\n * JSON Schema for the output this tool returns.\n * Used by LLMs to understand the response structure.\n */\n outputSchema?: Record<string, unknown>;\n\n /** MCP metadata extensions (context injection, rate-limit hints) */\n _meta?: McpToolMeta;\n\n /** Explicit execute eligibility in discovery responses */\n executeEligible?: boolean;\n\n /** Explicit execute price visibility in discovery responses */\n executePriceUsd?: string | null;\n\n /** Whether this method has normalized structured guidance hints */\n hasStructuredGuidance?: boolean;\n\n /** Optional structured guidance hints derived from the method description */\n structuredGuidance?: StructuredMethodGuidanceHints;\n}\n\n/**\n * Represents a tool available on the Context Protocol marketplace\n */\nexport interface Tool {\n /** Unique identifier for the tool (UUID) */\n id: string;\n\n /** Human-readable name of the tool */\n name: string;\n\n /** Description of what the tool does */\n description: string;\n\n /** Price per execution in USDC */\n price: string;\n\n /** Tool category (e.g., \"defi\", \"nft\") */\n category?: string;\n\n /** Whether the tool is verified by Context Protocol */\n isVerified?: boolean;\n\n /** Tool type - currently always \"mcp\" */\n kind?: string;\n\n /**\n * Available MCP tool methods\n * Use items from this array as `toolName` when executing\n */\n mcpTools?: McpTool[];\n\n // Trust metrics (Level 2 - Reputation Ledger)\n /** Total number of queries processed */\n totalQueries?: number;\n\n /** Success rate percentage (0-100) */\n successRate?: string;\n\n /** Uptime percentage (0-100) */\n uptimePercent?: string;\n\n /** Total USDC staked by the developer */\n totalStaked?: string;\n\n /** Whether the tool has \"Proven\" status (100+ queries, >95% success, >98% uptime) */\n isProven?: boolean;\n}\n\n/**\n * Response from the tools search endpoint\n */\nexport interface SearchResponse {\n /** Array of matching tools */\n tools: Tool[];\n\n /** Discovery mode used by the server */\n mode?: DiscoveryMode;\n\n /** The search query that was used */\n query: string;\n\n /** Total number of results */\n count: number;\n}\n\n/**\n * Options for searching tools\n */\nexport interface SearchOptions {\n /** Search query (semantic search) */\n query?: string;\n\n /** Maximum number of results (1-50, default 10) */\n limit?: number;\n\n /** Discovery mode with billing semantics */\n mode?: DiscoveryMode;\n\n /** Optional explicit method surface filter */\n surface?: McpToolSurface;\n\n /** Require methods marked query eligible */\n queryEligible?: boolean;\n\n /** Require explicit method execute pricing */\n requireExecutePricing?: boolean;\n\n /** Exclude methods by latency class */\n excludeLatencyClasses?: McpToolLatencyClass[];\n\n /** Convenience switch to exclude slow methods in query mode */\n excludeSlow?: boolean;\n\n /**\n * Restrict discovery to the caller's favorite tools.\n * - `true`: force favorites-only discovery for this request\n * - `false`: force unrestricted discovery for this request\n * - omitted: use the account-level default from Context settings\n */\n favoritesOnly?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Developer / tool management types\n// ---------------------------------------------------------------------------\n\n/**\n * Options for updating a tool listing via `client.developer.updateTool()`.\n * At least one field must be provided.\n */\nexport const ALLOWED_TOOL_CATEGORIES = [\n \"Crypto & DeFi\",\n \"Financial Markets\",\n \"Business & Sales\",\n \"Marketing & SEO\",\n \"Legal & Regulatory\",\n \"Real World\",\n \"Developer Tools\",\n \"Research & Academia\",\n \"Utility\",\n \"Other\",\n] as const;\n\nexport type ToolCategory = (typeof ALLOWED_TOOL_CATEGORIES)[number];\n\nexport interface UpdateToolOptions {\n /** New display name for the tool */\n name?: string;\n\n /** New marketplace description */\n description?: string;\n\n /** New category -- must be one of the predefined marketplace categories */\n category?: ToolCategory | null;\n}\n\n/**\n * Response from updating a tool listing.\n */\nexport interface UpdateToolResult {\n id: string;\n name: string;\n description: string;\n category: string | null;\n updatedAt: string;\n}\n\n/**\n * Options for executing a tool\n */\nexport interface ExecuteOptions {\n /** The UUID of the tool to execute (from search results) */\n toolId: string;\n\n /** The specific MCP tool name to call (from tool's mcpTools array) */\n toolName: string;\n\n /** Arguments to pass to the tool */\n args?: Record<string, unknown>;\n\n /**\n * Optional idempotency key (UUID recommended).\n * Reuse the same key when retrying the same logical request.\n */\n idempotencyKey?: string;\n\n /** Explicit execute mode label for request clarity */\n mode?: \"execute\";\n\n /** Optional execute session identifier */\n sessionId?: string;\n\n /** Optional per-session spend budget envelope (USD) */\n maxSpendUsd?: string;\n\n /** Request session closure after this execute call settles */\n closeSession?: boolean;\n}\n\nexport type ExecuteSessionStatus = \"open\" | \"closed\" | \"expired\";\n\nexport interface ExecuteSessionSpend {\n mode: \"execute\";\n sessionId: string | null;\n methodPrice: string;\n spent: string;\n remaining: string | null;\n maxSpend: string | null;\n\n /** Optional lifecycle fields when the API returns session state */\n status?: ExecuteSessionStatus;\n expiresAt?: string;\n closeRequested?: boolean;\n pendingAccruedCount?: number;\n pendingAccruedUsd?: string;\n}\n\n/**\n * Successful execution response from the API\n */\nexport interface ExecuteApiSuccessResponse {\n success: true;\n mode: \"execute\";\n\n /** The result data from the tool execution */\n result: unknown;\n\n /** Information about the executed tool */\n tool: {\n id: string;\n name: string;\n };\n\n /** Method-level execute pricing used for this call */\n method: {\n name: string;\n executePriceUsd: string;\n };\n\n /** Spend envelope visibility for execute sessions */\n session: ExecuteSessionSpend;\n\n /** Execution duration in milliseconds */\n durationMs: number;\n}\n\n/**\n * Error response from the API\n */\nexport interface ExecuteApiErrorResponse {\n /** Human-readable error message */\n error: string;\n\n /** Explicit mode label for clarity */\n mode?: \"execute\";\n\n /** Error code for programmatic handling */\n code?: ContextErrorCode;\n\n /** URL to help resolve the issue */\n helpUrl?: string;\n\n /** Optional spend envelope context when available */\n session?: ExecuteSessionSpend;\n}\n\n/**\n * Raw API response from the execute endpoint\n */\nexport type ExecuteApiResponse = ExecuteApiSuccessResponse | ExecuteApiErrorResponse;\n\nexport interface ExecuteSessionStartOptions {\n /** Maximum spend budget for the session (USD string) */\n maxSpendUsd: string;\n}\n\nexport interface ExecuteSessionApiSuccessResponse {\n success: true;\n mode: \"execute\";\n session: ExecuteSessionSpend;\n}\n\nexport type ExecuteSessionApiResponse =\n | ExecuteSessionApiSuccessResponse\n | ExecuteApiErrorResponse;\n\nexport interface ExecuteSessionResult {\n mode: \"execute\";\n session: ExecuteSessionSpend;\n}\n\n/**\n * The resolved result returned to the user after SDK processing\n */\nexport interface ExecutionResult<T = unknown> {\n mode: \"execute\";\n\n /** The data returned by the tool */\n result: T;\n\n /** Information about the executed tool */\n tool: {\n id: string;\n name: string;\n };\n\n /** Method-level execute pricing used for this call */\n method: {\n name: string;\n executePriceUsd: string;\n };\n\n /** Spend envelope visibility for execute calls */\n session: ExecuteSessionSpend;\n\n /** Execution duration in milliseconds */\n durationMs: number;\n}\n\n// ---------------------------------------------------------------------------\n// Query types (pay-per-response / agentic mode)\n// ---------------------------------------------------------------------------\n\n/** Supported orchestration depth modes for query execution. */\nexport type QueryDepth = \"fast\" | \"auto\" | \"deep\";\nexport type QueryDeepMode = \"deep\" | \"deep-light\" | \"deep-heavy\";\nexport type QueryClarificationPolicy = \"return\" | \"auto\" | \"error\";\nexport type QueryOutcomeType =\n | \"answer\"\n | \"clarification_required\"\n | \"capability_miss\";\nexport type QueryResponseShape =\n | \"answer\"\n | \"answer_with_evidence\"\n | \"evidence_only\";\nexport type QueryResponseEnvelopeViewType =\n | \"table\"\n | \"leaderboard\"\n | \"heatmap\"\n | \"timeseries\";\n\nexport interface QueryClarificationOption {\n id: string;\n toolId: string;\n toolName: string;\n methodName: string;\n label: string;\n description: string;\n fitScore: number;\n recommended: boolean;\n}\n\nexport interface QueryClarificationPayload {\n question: string;\n options: QueryClarificationOption[];\n allowFreeform: boolean;\n recommendedOptionId: string;\n originalQuery: string;\n}\n\nexport interface QueryCapabilityMissPayload {\n message: string;\n missingCapabilities: string[];\n suggestedRewrites: string[];\n originalQuery: string;\n}\n\nexport interface QueryAssumptionMetadata {\n mode: \"auto\";\n optionId: string;\n label: string;\n reason: string;\n}\n\nexport type QueryClarificationDecisionReasonCode =\n | \"rollout_disabled\"\n | \"no_grounded_candidates\"\n | \"single_grounded_interpretation\"\n | \"required_discriminator_ambiguity\"\n | \"contract_scope_ambiguity\"\n | \"cost_or_latency_ambiguity\"\n | \"semantic_scope_ambiguity\"\n | \"capability_miss\";\n\nexport type QueryAttemptForkReason =\n | \"manual_fork\"\n | \"clarification_branch\"\n | \"bounded_rediscovery\"\n | \"resume_replay\"\n | \"patch_retry\"\n | \"unknown\";\n\nexport interface QueryClarificationEvidenceSources {\n usesMethodSchemas: boolean;\n usesProbeArgs: boolean;\n usesMethodMetadata: boolean;\n usesToolSelectionContext: boolean;\n usesLlmSelection: boolean;\n}\n\nexport interface QueryClarificationCandidateSummary {\n optionId: string;\n fitScore: number;\n llmRelevanceScore: number | null;\n requiredParams: string[];\n unresolvedRequiredParams: string[];\n probeArgKeys: string[];\n inputFieldNames: string[];\n outputKeys: string[];\n latencyClass: string;\n executePriceUsd: string | null;\n queryEligible: boolean;\n}\n\nexport interface QueryClarificationDiagnostics {\n orchestrationMode: string;\n rolloutStage: string;\n shadowMode: boolean;\n policy: QueryClarificationPolicy;\n outcomeType: QueryOutcomeType;\n triggered: boolean;\n optionCount: number;\n candidateCount: number;\n viableCandidateCount: number;\n recommendedOptionId: string | null;\n recommendedOptionReason: string | null;\n autoResolved: boolean;\n autoSelectEnabled: boolean;\n assumptionMade: QueryAssumptionMetadata | null;\n missingCapability: string | null;\n decisionReasonCode: QueryClarificationDecisionReasonCode;\n decisionSignals: string[];\n evidenceSources: QueryClarificationEvidenceSources;\n comparedOptionIds: string[];\n decisionStrategy: \"deterministic\" | \"llm_primary\";\n judgeAttempted: boolean;\n judgeApplied: boolean;\n judgeOutcomeType: QueryOutcomeType | null;\n judgeConfidence: number | null;\n judgeReason: string | null;\n judgeError: string | null;\n validatorReason: string | null;\n fallbackReason: string | null;\n copyStrategy: \"deterministic\" | \"llm_rewritten\";\n rewriteAttempted: boolean;\n rewriteApplied: boolean;\n rewriteError: string | null;\n candidateSummaries: QueryClarificationCandidateSummary[];\n}\n\n/**\n * Options for the agentic query endpoint (pay-per-response).\n *\n * Unlike `execute()` which calls a single tool once, `query()` sends a\n * natural-language question and lets the server handle discovery-first\n * orchestration (`discover/probe -> plan-from-evidence -> execute ->\n * bounded fallback`) plus synthesis.\n * One flat fee covers up to 100 MCP skill calls per tool.\n */\nexport interface QueryOptions {\n /** The natural-language question to answer */\n query: string;\n\n /**\n * How the SDK should handle clarification-required pre-plan situations:\n * - `return`: surface a structured clarification result to the caller\n * - `auto`: enable clarification auto-select and continue with the server's deterministic recommended option\n * - `error`: turn structured clarification/capability outcomes into terminal errors\n */\n clarificationPolicy?: QueryClarificationPolicy;\n\n /**\n * Optional tool IDs to use. When omitted the server discovers tools\n * automatically (Auto Mode). When provided, only these tools are used\n * (Manual Mode).\n */\n tools?: string[];\n\n /**\n * Restrict auto-discovery to the caller's favorite tools.\n * Ignored when `tools` is provided because manual tool selection wins.\n * - `true`: force favorites-only discovery for this request\n * - `false`: force unrestricted discovery for this request\n * - omitted: use the account-level default from Context settings\n */\n favoritesOnly?: boolean;\n\n /**\n * Resume a prior durable query attempt from its latest checkpoint.\n * Cannot be combined with `tools` or `forkFrom`.\n */\n resumeFrom?: QueryAttemptReference;\n\n /**\n * Fork a new durable query attempt from a previous attempt.\n * Optional `reason` keeps the server's non-breaking lineage metadata honest.\n * Cannot be combined with `tools` or `resumeFrom`.\n */\n forkFrom?: QueryForkReference;\n\n /**\n * Optional answer model ID for final synthesis.\n * Supported IDs are published by the Context API. Ignored when\n * `responseShape` is `evidence_only` because synthesis is skipped.\n */\n answerModelId?: string;\n\n /**\n * Structured response mode for query answers.\n * - `answer`: backward-compatible natural-language answer\n * - `answer_with_evidence`: prose answer plus a structured evidence package\n * - `evidence_only`: structured evidence package with a machine-friendly summary\n */\n responseShape?: QueryResponseShape;\n\n /**\n * Include execution data inline in the query response.\n * Useful for headless agents that need raw structured outputs.\n * Handshake completion remains a chat-only flow today; raw execution data\n * is not a typed resume/callback contract for approvals.\n */\n includeData?: boolean;\n\n /**\n * Persist execution data to Vercel Blob and return a download URL.\n * Useful for large payload workflows where inline JSON is not ideal.\n */\n includeDataUrl?: boolean;\n\n /**\n * Include machine-readable developer trace output for this query response.\n * When enabled, the server may return summary counters plus diagnostics\n * for lane selection, scout probe adequacy, and bounded fallback behavior.\n */\n includeDeveloperTrace?: boolean;\n\n /**\n * Query orchestration depth mode:\n * - `fast`: lower-latency path\n * - `auto`: server decides between fast/deep\n * - `deep`: full completeness-oriented path\n */\n queryDepth?: QueryDepth;\n\n /**\n * Development/testing only: force the server's internal deep lane.\n * `deep` is the canonical value. Legacy `deep-light` / `deep-heavy`\n * aliases are still accepted temporarily for compatibility and normalize\n * to the same runtime lane. Invalid when `queryDepth` is `fast`.\n */\n debugScoutDeepMode?: QueryDeepMode;\n\n /**\n * Optional idempotency key (UUID recommended).\n * Reuse the same key when retrying the same logical request.\n */\n idempotencyKey?: string;\n}\n\n/**\n * Tool reference attached to developer trace timeline steps.\n */\nexport interface QueryDeveloperTraceToolRef {\n id?: string;\n name?: string;\n method?: string;\n [key: string]: unknown;\n}\n\n/**\n * Loop metadata attached to developer trace timeline steps.\n */\nexport interface QueryDeveloperTraceLoopInfo {\n name?: string;\n iteration?: number;\n maxIterations?: number;\n [key: string]: unknown;\n}\n\n/**\n * Tool selection metadata attached to discovery/planning diagnostics.\n */\nexport interface QueryDeveloperTraceToolSelection {\n toolId: string;\n toolName: string;\n selectedMethodCount: number;\n selectedMethods: string[];\n omittedSelectedMethodCount: number;\n priceUsd?: string;\n}\n\n/**\n * Initial planner diagnostic details.\n */\nexport interface QueryPlanningTraceDiagnostic {\n plannerQuery: string;\n scoutEvidenceAttached: boolean;\n scoutEvidencePromptBlock: string | null;\n allowedModules: string[];\n}\n\n/**\n * Rediscovery/fallback diagnostic details.\n */\nexport interface QueryRediscoveryTraceDiagnostic {\n considered: boolean;\n executed: boolean;\n skipReason: string | null;\n missingCapability: string | null;\n rediscoveryQuery: string | null;\n capabilityLooksLikeSearchNeed: boolean;\n allowSearchFallbackOnElapsedCap: boolean;\n searchFallbackUsed: boolean;\n preRediscoveryBudgetReasonCode: string | null;\n candidateSearchResults: QueryDeveloperTraceToolSelection[];\n selectedAlternatives: QueryDeveloperTraceToolSelection[];\n mergedTools: QueryDeveloperTraceToolSelection[];\n usingPaidFallback: boolean;\n branchPlan: QueryPlanningTraceDiagnostic | null;\n}\n\nexport interface QueryCompletenessRepairEvent {\n attempt: number;\n outcome:\n | \"attempted\"\n | \"skipped_by_guardrail\"\n | \"skipped_no_retry_budget\"\n | \"skipped_needs_different_tools\"\n | \"skipped_no_retry_path\"\n | \"patch_failed\"\n | \"replan_failed\"\n | \"patched\"\n | \"replanned\";\n semanticRetryCount: number;\n maxSemanticRetries: number;\n strategy: \"patch\" | \"replan\" | null;\n summary: string | null;\n failReason: string | null;\n requestedReplan: boolean;\n hadSyntaxFix: boolean;\n editCount: number | null;\n skipReason: string | null;\n boundedAnswerReason:\n | \"retry_guardrail_same_endpoint_fanout\"\n | \"retry_guardrail_upstream_abort\"\n | null;\n blockingDiagnostics: Array<{\n code: string;\n severity: string;\n message: string;\n }>;\n}\n\n/**\n * Rich developer-trace diagnostics for discovery-first orchestration internals.\n */\nexport interface QueryDeveloperTraceDiagnostics {\n selection: {\n selectedDepth: string;\n deepMode: string | null;\n debugScoutDeepMode: string | null;\n plannerReasoningStage: string;\n scoutEnabled: boolean;\n preserveFastOneShot: boolean;\n candidateMethodCount: number;\n scoutProbeStatus: string;\n scoutProbeAdequacy: string;\n scoutProbeConfidence: number;\n scoutMetadataConfidence: number;\n scoutProbeQuerySafeCandidateCount: number;\n scoutProbeRankedMethodCount: number;\n scoutProbeAmbiguityPoolCount: number;\n scoutProbeShortlistedMethodCount: number;\n scoutProbeMissingCapability: string | null;\n scoutPrePlanProbeCalls: number;\n scoutPrePlanProbeBudgetReasonCode: string | null;\n scoutChangedInitialPlan: boolean;\n scoutChangedPlannerReasoningStage: boolean;\n scoutInitialSelectedDepth: string;\n scoutInitialDeepMode: string | null;\n scoutInitialPlannerReasoningStage: string;\n scoutInitialReasonCode: string;\n scoutFinalReasonCode: string;\n scoutEvidenceAttachedToPlanning: boolean;\n scoutLlmSelectionUsed: boolean;\n scoutLlmSelectionFallback: boolean;\n scoutLlmSelectionLatencyMs: number | null;\n selectedTools: QueryDeveloperTraceToolSelection[];\n };\n planning: {\n initial: QueryPlanningTraceDiagnostic;\n };\n cost?: {\n planningCostUsd: number;\n initialExecutionCostUsd: number;\n rediscoveryAdditionalCostUsd: number;\n synthesisCostUsd: number;\n totalModelCostUsd: number;\n toolCostUsd: number;\n totalChargedUsd: number;\n };\n completeness: {\n evaluations: unknown[];\n repairEvents: QueryCompletenessRepairEvent[];\n triggerNeedsDifferentTools: boolean;\n triggerMissingCapability: string | null;\n };\n rediscovery: QueryRediscoveryTraceDiagnostic | null;\n clarification?: QueryClarificationDiagnostics;\n contributorSearches?: ContributorSearchTraceRecord[];\n [key: string]: unknown;\n}\n\n/**\n * A single developer-trace timeline step.\n */\nexport interface QueryDeveloperTraceStep {\n stepType?: string;\n event?: string;\n status?: string;\n message?: string;\n timestampMs?: number;\n tool?: QueryDeveloperTraceToolRef;\n attempt?: number;\n loop?: QueryDeveloperTraceLoopInfo;\n metadata?: Record<string, unknown>;\n [key: string]: unknown;\n}\n\n/**\n * Aggregate counters that summarize developer-trace behavior.\n */\nexport interface QueryDeveloperTraceSummary {\n toolCalls?: number;\n retryCount?: number;\n selfHealCount?: number;\n fallbackCount?: number;\n failureCount?: number;\n recoveryCount?: number;\n completionChecks?: number;\n loopCount?: number;\n [key: string]: unknown;\n}\n\n/**\n * Full tool call record (untruncated) for debugging.\n */\nexport interface QueryDeveloperTraceToolCall {\n toolId?: string;\n toolName: string;\n args?: unknown;\n result: unknown;\n}\n\n/**\n * MCP method schema exposed in the developer trace.\n */\nexport interface QueryDeveloperTraceToolSchema {\n serverName: string;\n toolName: string;\n description: string;\n inputSchema?: Record<string, unknown>;\n outputSchema?: Record<string, unknown>;\n}\n\n/**\n * Developer Mode trace payload returned per query response (opt-in).\n */\nexport interface QueryDeveloperTrace {\n summary?: QueryDeveloperTraceSummary;\n timeline?: QueryDeveloperTraceStep[];\n requestId?: string;\n query?: string;\n source?: string;\n diagnostics?: QueryDeveloperTraceDiagnostics;\n initialCode?: string;\n finalCode?: string;\n executionTrace?: unknown[];\n executionProgram?: unknown;\n attemptCount?: number;\n executionSuccess?: boolean;\n executionResult?: unknown;\n toolCallHistory?: QueryDeveloperTraceToolCall[];\n toolSchemas?: QueryDeveloperTraceToolSchema[];\n [key: string]: unknown;\n}\n\n/**\n * Information about a tool that was used during a query response\n */\nexport interface QueryToolUsage {\n /** Tool ID */\n id: string;\n\n /** Tool name */\n name: string;\n\n /** Number of MCP skill calls made for this tool */\n skillCalls: number;\n}\n\n/**\n * Cost breakdown for a query response.\n * All values are strings representing USD amounts.\n */\nexport interface QueryCost {\n /** AI model inference cost */\n modelCostUsd: string;\n\n /** Sum of all tool fees */\n toolCostUsd: string;\n\n /** Total cost (model + tools) */\n totalCostUsd: string;\n}\n\n/**\n * High-level orchestration outcome metrics returned by the query API.\n */\nexport interface QueryOrchestrationMetrics {\n parityStage: string;\n orchestrationMode: string;\n /** Whether the first plan path succeeded without fallback. */\n firstPassSuccess: boolean;\n /** Whether execution signaled a missing capability on first pass. */\n capabilityMissSignaled: boolean;\n /** Whether bounded rediscovery/fallback executed. */\n rediscoveryExecuted: boolean;\n}\n\nexport interface QueryAttemptReference {\n sessionId: string;\n attemptId: string;\n}\n\n/** Public fork handle for creating a new attempt from a prior Query session. */\nexport interface QueryForkReference extends QueryAttemptReference {\n reason?: QueryAttemptForkReason;\n}\n\n/**\n * Public continuation state returned by headless Query responses.\n * Internal selected-tool lineage, Scout reuse, and clarification snapshots\n * remain durable server state but are not exposed as chat-style payloads.\n */\nexport interface QuerySessionState {\n sessionId: string;\n attemptId: string;\n parentAttemptId: string | null;\n rootAttemptId: string;\n mode: \"initial\" | \"resume\" | \"fork\";\n origin: \"initial_request\" | \"resume\" | \"fork\";\n status: \"active\" | \"completed\" | \"failed\" | \"aborted\";\n checkpoint: {\n currentStage: string | null;\n latestCheckpointArtifactId: string | null;\n canonicalDatasetId: string | null;\n executionProgramCurrentRevisionId: string | null;\n };\n}\n\nexport interface QueryResponseEnvelopeFact {\n id: string;\n label: string;\n path: string | null;\n relevanceScore: number | null;\n value: unknown;\n}\n\nexport interface QueryResponseEnvelopeSourceRef {\n id: string;\n provider: string | null;\n dataset: string | null;\n observedAt: string | null;\n publishedAt: string | null;\n artifactRef: string | null;\n url: string | null;\n note: string | null;\n}\n\nexport type QueryResponseEnvelopeTone =\n | \"positive\"\n | \"negative\"\n | \"neutral\"\n | \"caution\";\n\nexport type QueryControllerStopReason =\n | \"complete_answer\"\n | \"bounded_runtime_budget\"\n | \"bounded_same_endpoint_guardrail\"\n | \"bounded_upstream_abort_guardrail\"\n | \"clarification_required\"\n | \"capability_miss\";\n\nexport type QueryControllerIssueClass =\n | \"scope_ambiguity\"\n | \"missing_evidence\"\n | \"missing_capability\"\n | \"stale_data\"\n | \"wrong_tool_path\";\n\nexport type QueryControllerAction =\n | \"inspect_current_grounding\"\n | \"patch_current_program\"\n | \"bounded_rediscovery\"\n | \"clarify_scope\"\n | \"return_capability_miss\"\n | \"return_bounded_answer\"\n | \"return_complete_answer\";\n\nexport interface QueryResponseEnvelopeMarketAggregateFlow {\n netFlowUsd: number | null;\n grossInflowUsd: number | null;\n grossOutflowUsd: number | null;\n nativeNetFlow: number | null;\n nativeUnit: string | null;\n direction: \"inflow\" | \"outflow\" | \"flat\" | \"mixed\";\n}\n\nexport interface QueryResponseEnvelopeMarketVenueBreakdown {\n venue: string;\n asset: string | null;\n netFlowUsd: number | null;\n grossInflowUsd: number | null;\n grossOutflowUsd: number | null;\n nativeNetFlow: number | null;\n nativeUnit: string | null;\n shareOfTotal: number | null;\n rank: number | null;\n}\n\nexport interface QueryResponseEnvelopeCatalystRef {\n source: string;\n publishedAt: string | null;\n claim: string | null;\n relationToFlow: string | null;\n url: string | null;\n}\n\nexport interface QueryResponseEnvelopeDerivativesContext {\n openInterestDirection: string | null;\n openInterestChangePct: number | null;\n liquidationBias: string | null;\n venues: string[];\n relationshipToSpotFlows: string | null;\n}\n\nexport interface QueryResponseEnvelopeMarketIntelligence {\n asset: string | null;\n assets: string[] | null;\n timeWindow: string | null;\n asOf: string | null;\n aggregateFlow: QueryResponseEnvelopeMarketAggregateFlow | null;\n venueBreakdown: QueryResponseEnvelopeMarketVenueBreakdown[];\n catalystRefs: QueryResponseEnvelopeCatalystRef[];\n derivativesContext: QueryResponseEnvelopeDerivativesContext | null;\n}\n\nexport interface QueryResponseEnvelopeViewMetric {\n label: string;\n value: string;\n tone?: QueryResponseEnvelopeTone;\n}\n\nexport interface QueryResponseEnvelopeViewRow {\n key: string;\n cells: string[];\n tone?: QueryResponseEnvelopeTone;\n sourceRefIds?: string[];\n}\n\nexport interface QueryResponseEnvelope {\n responseShape: Exclude<QueryResponseShape, \"answer\">;\n response: string;\n summary: string;\n outcome: {\n label: string;\n tone: QueryResponseEnvelopeTone;\n stopReason: QueryControllerStopReason;\n issueClass: QueryControllerIssueClass | null;\n };\n controller: {\n scope: \"wedge\" | \"standard\";\n nextAction: QueryControllerAction;\n actionsTaken: QueryControllerAction[];\n patchFirstProgramPreserved: boolean;\n executionProgramRevisionId: string | null;\n hardBudgetApplied: boolean;\n } | null;\n evidence: {\n facts: QueryResponseEnvelopeFact[];\n sourceRefs: QueryResponseEnvelopeSourceRef[];\n assumptions: string[];\n knownUnknowns: string[];\n retrievalPlanReasonCodes: string[];\n marketIntelligence?: QueryResponseEnvelopeMarketIntelligence | null;\n };\n artifacts: {\n dataUrl: string | null;\n canonicalDataRef: {\n datasetId: string;\n hash: string;\n bytes: number;\n publicDataUrl: string | null;\n } | null;\n stageArtifactKinds: string[];\n };\n view: {\n type: QueryResponseEnvelopeViewType;\n label: string;\n title?: string | null;\n metrics?: QueryResponseEnvelopeViewMetric[];\n columns?: string[];\n rows?: QueryResponseEnvelopeViewRow[];\n } | null;\n freshness: {\n asOf: string | null;\n sourceTimestamps: string[];\n note: string;\n };\n confidence: {\n level: \"high\" | \"medium\" | \"low\";\n reason: string;\n verifiedFactCount: number;\n inferredFactCount: number;\n gapCount: number;\n gapSignals: Array<{\n code: string;\n severity: string;\n detail: string;\n }>;\n };\n usage: {\n durationMs: number;\n cost: QueryCost;\n toolsUsed: QueryToolUsage[];\n outcomeType: QueryOutcomeType;\n orchestrationMetrics?: QueryOrchestrationMetrics;\n };\n}\n\nexport interface QueryBaseResult {\n /** The answer text or machine-friendly summary returned for this query. */\n response: string;\n\n /** Tools that were used to answer the query */\n toolsUsed: QueryToolUsage[];\n\n /** Cost breakdown */\n cost: QueryCost;\n\n /** Total duration in milliseconds */\n durationMs: number;\n\n /** Optional execution data from tools (when includeData=true) */\n data?: unknown;\n\n /** Optional blob URL for persisted execution data (when includeDataUrl=true) */\n dataUrl?: string;\n\n /** Optional machine-readable Developer Mode trace payload */\n developerTrace?: QueryDeveloperTrace;\n\n /** Optional orchestration outcome metrics for benchmarking and rollout analysis */\n orchestrationMetrics?: QueryOrchestrationMetrics;\n\n /** Typed public stop reason for the final outcome. */\n stopReason?: QueryControllerStopReason;\n\n /** Typed issue class exposed by the bounded controller contract. */\n issueClass?: QueryControllerIssueClass | null;\n\n /** Ordered public controller actions taken before the final outcome. */\n actionsTaken?: QueryControllerAction[];\n\n /** Optional controller summary for bounded wedge-style answers. */\n controller?: QueryResponseEnvelope[\"controller\"];\n\n /**\n * Optional public durable continuation handles for resume/fork flows.\n * Query exposes handle-based continuation, not chat-style continuation payloads.\n */\n querySession?: QuerySessionState;\n}\n\n/**\n * The resolved result of a pay-per-response query\n */\nexport type QueryResult =\n | (QueryBaseResult &\n Partial<QueryResponseEnvelope> & {\n outcomeType: \"answer\";\n assumptionMade?: QueryAssumptionMetadata;\n })\n | (QueryBaseResult & {\n outcomeType: \"clarification_required\";\n clarification: QueryClarificationPayload;\n })\n | (QueryBaseResult & {\n outcomeType: \"capability_miss\";\n capabilityMiss: QueryCapabilityMissPayload;\n });\n\n/**\n * Successful response from the /api/v1/query endpoint\n */\nexport type QueryApiSuccessResponse = { success: true } & QueryResult;\n\n/**\n * Raw API response from the query endpoint\n */\nexport type QueryApiResponse = QueryApiSuccessResponse | ExecuteApiErrorResponse;\n\n// ---------------------------------------------------------------------------\n// Query stream event types\n// ---------------------------------------------------------------------------\n\n/** Emitted when a tool starts or changes execution status */\nexport interface QueryStreamToolStatusEvent {\n type: \"tool-status\";\n tool: { id: string; name: string };\n status: string;\n}\n\n/** Emitted for each chunk of the AI response text */\nexport interface QueryStreamTextDeltaEvent {\n type: \"text-delta\";\n delta: string;\n}\n\n/** Emitted when the server streams developer trace updates/chunks */\nexport interface QueryStreamDeveloperTraceEvent {\n type: \"developer-trace\";\n trace: QueryDeveloperTrace;\n}\n\n/** Emitted when the full response is complete */\nexport interface QueryStreamDoneEvent {\n type: \"done\";\n result: QueryResult;\n}\n\n/** Emitted when the server reports a recoverable or terminal query error */\nexport interface QueryStreamErrorEvent {\n type: \"error\";\n error: string;\n code?: ContextErrorCode | string;\n scope?: string;\n reasonCode?: string;\n outcomeType?: Exclude<QueryOutcomeType, \"answer\">;\n clarification?: QueryClarificationPayload;\n capabilityMiss?: QueryCapabilityMissPayload;\n querySession?: QuerySessionState;\n}\n\n/**\n * Union of all events emitted during a streaming query\n */\nexport type QueryStreamEvent =\n | QueryStreamToolStatusEvent\n | QueryStreamTextDeltaEvent\n | QueryStreamDeveloperTraceEvent\n | QueryStreamDoneEvent\n | QueryStreamErrorEvent;\n\n// ---------------------------------------------------------------------------\n// Error types\n// ---------------------------------------------------------------------------\n\n/**\n * Specific error codes returned by the Context Protocol API\n */\nexport type ContextErrorCode =\n | \"unauthorized\"\n | \"no_wallet\"\n | \"insufficient_allowance\"\n | \"payment_failed\"\n | \"execution_failed\"\n | \"query_failed\"\n | \"invalid_tool_method\"\n | \"method_not_execute_eligible\"\n | \"invalid_max_spend\"\n | \"session_not_found\"\n | \"session_forbidden\"\n | \"session_closed\"\n | \"session_expired\"\n | \"max_spend_mismatch\"\n | \"session_budget_exceeded\";\n\n/**\n * Error thrown by the Context Protocol client\n */\nexport class ContextError extends Error {\n constructor(\n message: string,\n public readonly code?: ContextErrorCode | string,\n public readonly statusCode?: number,\n public readonly helpUrl?: string\n ) {\n super(message);\n this.name = \"ContextError\";\n Object.setPrototypeOf(this, ContextError.prototype);\n }\n}\n","import type { UpdateToolOptions, UpdateToolResult } from \"../types.js\";\nimport { ALLOWED_TOOL_CATEGORIES, ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Developer resource for managing tool listings on the Context Protocol marketplace.\n *\n * Scoped to contributor/developer concerns (listing management), separate from\n * the consumer-facing `tools.execute()` and `query.run()`.\n */\nexport class Developer {\n constructor(private client: ContextClient) {}\n\n /**\n * Update a tool listing's metadata (name, description, category).\n *\n * Requires an API key belonging to the tool's owner.\n *\n * @param toolId - The UUID of the tool to update\n * @param updates - Fields to update (at least one required)\n * @returns The updated tool metadata\n *\n * @throws {ContextError} If authentication fails or the caller does not own the tool\n *\n * @example\n * ```typescript\n * const updated = await client.developer.updateTool(\"tool-uuid\", {\n * description: \"Updated description with better showcase prompts\",\n * category: \"crypto\",\n * });\n * console.log(updated.updatedAt);\n * ```\n */\n async updateTool(\n toolId: string,\n updates: UpdateToolOptions\n ): Promise<UpdateToolResult> {\n if (!toolId) {\n throw new ContextError(\"toolId is required\");\n }\n\n if (\n updates.name === undefined &&\n updates.description === undefined &&\n updates.category === undefined\n ) {\n throw new ContextError(\n \"At least one field required: name, description, or category\"\n );\n }\n\n if (\n updates.category !== undefined &&\n updates.category !== null &&\n !ALLOWED_TOOL_CATEGORIES.includes(updates.category)\n ) {\n throw new ContextError(\n `category must be one of: ${ALLOWED_TOOL_CATEGORIES.join(\", \")}`\n );\n }\n\n const encodedToolId = encodeURIComponent(toolId);\n\n return this.client._fetch<UpdateToolResult>(\n `/api/v1/tools/${encodedToolId}`,\n {\n method: \"PATCH\",\n body: JSON.stringify(updates),\n },\n { retry: false }\n );\n }\n}\n","import type { SearchOptions, SearchResponse, Tool } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Discovery resource for searching and finding tools on the Context Protocol marketplace\n */\nexport class Discovery {\n constructor(private client: ContextClient) {}\n\n /**\n * Fetch a single marketplace tool by its unique ID.\n */\n async get(toolId: string): Promise<Tool> {\n return this.client._fetch<Tool>(\n `/api/v1/tools/${encodeURIComponent(toolId)}`\n );\n }\n\n /**\n * Search for tools matching a query string.\n *\n * Backward-compatible signatures:\n * - `search(\"gas prices\", 10)`\n * - `search({ query: \"gas prices\", limit: 10, mode: \"execute\" })`\n */\n async search(query: string, limit?: number): Promise<Tool[]>;\n async search(options: SearchOptions): Promise<Tool[]>;\n async search(\n queryOrOptions: string | SearchOptions,\n limit?: number\n ): Promise<Tool[]> {\n const options: SearchOptions =\n typeof queryOrOptions === \"string\"\n ? { query: queryOrOptions, limit }\n : queryOrOptions;\n\n const params = new URLSearchParams();\n const query = options.query ?? \"\";\n\n if (query) {\n params.set(\"q\", query);\n }\n\n if (options.limit !== undefined) {\n params.set(\"limit\", String(options.limit));\n }\n\n if (options.mode) {\n params.set(\"mode\", options.mode);\n }\n\n if (options.surface) {\n params.set(\"surface\", options.surface);\n }\n\n if (options.queryEligible !== undefined) {\n params.set(\"queryEligible\", String(options.queryEligible));\n }\n\n if (options.requireExecutePricing !== undefined) {\n params.set(\n \"requireExecutePricing\",\n String(options.requireExecutePricing)\n );\n }\n\n if (\n options.excludeLatencyClasses &&\n options.excludeLatencyClasses.length > 0\n ) {\n params.set(\"excludeLatency\", options.excludeLatencyClasses.join(\",\"));\n }\n\n if (options.excludeSlow !== undefined) {\n params.set(\"excludeSlow\", String(options.excludeSlow));\n }\n\n if (options.favoritesOnly !== undefined) {\n params.set(\"favorites_only\", String(options.favoritesOnly));\n }\n\n const queryString = params.toString();\n const endpoint = `/api/v1/tools/search${queryString ? `?${queryString}` : \"\"}`;\n\n const response = await this.client._fetch<SearchResponse>(endpoint);\n\n return response.tools;\n }\n\n /**\n * Get featured/popular tools (empty query search)\n *\n * @param limit - Maximum number of results (1-50, default 10)\n * @returns Array of featured tools\n *\n * @example\n * ```typescript\n * const featured = await client.discovery.getFeatured(5);\n * ```\n */\n async getFeatured(\n limit?: number,\n options?: Omit<SearchOptions, \"query\" | \"limit\">\n ): Promise<Tool[]> {\n return this.search({\n ...(options ?? {}),\n query: \"\",\n ...(limit !== undefined ? { limit } : {}),\n });\n }\n}\n","import type {\n ExecuteOptions,\n ExecuteApiResponse,\n ExecuteSessionApiResponse,\n ExecuteSessionResult,\n ExecuteSessionStartOptions,\n ExecutionResult,\n} from \"../types.js\";\nimport { ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Tools resource for executing tools on the Context Protocol marketplace\n */\nexport class Tools {\n constructor(private client: ContextClient) {}\n\n /**\n * Execute a tool with the provided arguments\n *\n * @param options - Execution options\n * @param options.toolId - The UUID of the tool (from search results)\n * @param options.toolName - The specific MCP tool method to call (from tool's mcpTools array)\n * @param options.args - Arguments to pass to the tool\n * @returns The execution result with the tool's output data\n *\n * @throws {ContextError} With code `no_wallet` if wallet not set up\n * @throws {ContextError} With code `insufficient_allowance` if spending cap not set\n * @throws {ContextError} With code `payment_failed` if payment settlement fails\n * @throws {ContextError} With code `execution_failed` if tool execution fails\n *\n * @example\n * ```typescript\n * // First, search for a tool\n * const tools = await client.discovery.search(\"gas prices\");\n * const tool = tools[0];\n *\n * // Execute a specific method from the tool's mcpTools\n * const result = await client.tools.execute({\n * toolId: tool.id,\n * toolName: tool.mcpTools[0].name, // e.g., \"get_gas_prices\"\n * args: { chainId: 1 }\n * });\n *\n * console.log(result.result); // The tool's output\n * console.log(result.durationMs); // Execution time\n * ```\n */\n async execute<T = unknown>(options: ExecuteOptions): Promise<ExecutionResult<T>> {\n const {\n toolId,\n toolName,\n args,\n idempotencyKey,\n mode,\n sessionId,\n maxSpendUsd,\n closeSession,\n } = options;\n const headers = idempotencyKey\n ? { \"Idempotency-Key\": idempotencyKey }\n : undefined;\n\n const response = await this.client._fetch<ExecuteApiResponse>(\n \"/api/v1/tools/execute\",\n {\n method: \"POST\",\n headers,\n body: JSON.stringify({\n toolId,\n toolName,\n args,\n mode: mode ?? \"execute\",\n sessionId,\n maxSpendUsd,\n closeSession,\n }),\n }\n );\n\n // Handle error response\n if (\"error\" in response) {\n throw new ContextError(\n response.error,\n response.code,\n undefined, // Don't hardcode - this was a 200 OK with error body\n response.helpUrl\n );\n }\n\n // Handle success response\n if (response.success) {\n return {\n mode: response.mode,\n result: response.result as T,\n tool: response.tool,\n method: response.method,\n session: response.session,\n durationMs: response.durationMs,\n };\n }\n\n // Fallback - shouldn't reach here with valid API responses\n throw new ContextError(\"Unexpected response format from API\");\n }\n\n /**\n * Start an execute session with a max spend budget.\n */\n async startSession(\n options: ExecuteSessionStartOptions\n ): Promise<ExecuteSessionResult> {\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n \"/api/v1/tools/execute/sessions\",\n {\n method: \"POST\",\n body: JSON.stringify({\n mode: \"execute\",\n maxSpendUsd: options.maxSpendUsd,\n }),\n }\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n /**\n * Fetch current execute session status by ID.\n */\n async getSession(sessionId: string): Promise<ExecuteSessionResult> {\n if (!sessionId) {\n throw new ContextError(\"sessionId is required\");\n }\n\n const encodedSessionId = encodeURIComponent(sessionId);\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n `/api/v1/tools/execute/sessions/${encodedSessionId}`\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n /**\n * Close an execute session by ID.\n */\n async closeSession(sessionId: string): Promise<ExecuteSessionResult> {\n if (!sessionId) {\n throw new ContextError(\"sessionId is required\");\n }\n\n const encodedSessionId = encodeURIComponent(sessionId);\n const response = await this.client._fetch<ExecuteSessionApiResponse>(\n `/api/v1/tools/execute/sessions/${encodedSessionId}/close`,\n {\n method: \"POST\",\n body: JSON.stringify({ mode: \"execute\" }),\n }\n );\n\n return this.resolveSessionLifecycleResponse(response);\n }\n\n private resolveSessionLifecycleResponse(\n response: ExecuteSessionApiResponse\n ): ExecuteSessionResult {\n if (\"error\" in response) {\n throw new ContextError(\n response.error,\n response.code,\n undefined,\n response.helpUrl\n );\n }\n\n if (response.success) {\n return {\n mode: response.mode,\n session: response.session,\n };\n }\n\n throw new ContextError(\"Unexpected response format from API\");\n }\n}\n","import type {\n QueryCapabilityMissPayload,\n QueryClarificationPayload,\n QueryClarificationPolicy,\n QueryOptions,\n QueryDeveloperTrace,\n QueryResult,\n QueryStreamEvent,\n} from \"../types.js\";\nimport { ContextError } from \"../types.js\";\nimport type { ContextClient } from \"../client.js\";\n\n/**\n * Query resource for pay-per-response agentic queries.\n *\n * Unlike `tools.execute()` which calls a single tool once (pay-per-request),\n * the Query resource sends a natural-language question and lets the server\n * handle discovery-first orchestration (`discover/probe -> plan-from-evidence ->\n * execute -> bounded fallback`) plus AI synthesis — all for one flat fee.\n *\n * This is the \"prepared meal\" vs \"raw ingredients\" distinction:\n * - `tools.execute()` = raw data, full control, predictable cost\n * - `query.run()` / `query.stream()` = curated intelligence, one payment\n */\nexport class Query {\n constructor(private client: ContextClient) {}\n\n private normalizeResult(result: QueryResult): QueryResult {\n const candidate = result as QueryResult & { outcomeType?: string };\n if (\n candidate.outcomeType === \"clarification_required\" &&\n \"clarification\" in candidate &&\n candidate.clarification\n ) {\n return candidate;\n }\n if (\n candidate.outcomeType === \"capability_miss\" &&\n \"capabilityMiss\" in candidate &&\n candidate.capabilityMiss\n ) {\n return candidate;\n }\n return {\n ...candidate,\n outcomeType: \"answer\",\n };\n }\n\n private buildPolicyErrorEvent(params: {\n result: QueryResult;\n clarificationPolicy?: QueryClarificationPolicy;\n }):\n | {\n type: \"error\";\n error: string;\n code: string;\n reasonCode: string;\n outcomeType: \"clarification_required\" | \"capability_miss\";\n clarification?: QueryClarificationPayload;\n capabilityMiss?: QueryCapabilityMissPayload;\n querySession?: QueryResult[\"querySession\"];\n }\n | undefined {\n if (params.clarificationPolicy !== \"error\") {\n return;\n }\n\n if (params.result.outcomeType === \"clarification_required\") {\n return {\n type: \"error\",\n error: params.result.response,\n code: \"clarification_required\",\n reasonCode: \"clarification_required\",\n outcomeType: \"clarification_required\",\n clarification: params.result.clarification,\n querySession: params.result.querySession,\n };\n }\n\n if (params.result.outcomeType === \"capability_miss\") {\n return {\n type: \"error\",\n error: params.result.response,\n code: \"capability_miss\",\n reasonCode: \"capability_miss\",\n outcomeType: \"capability_miss\",\n capabilityMiss: params.result.capabilityMiss,\n querySession: params.result.querySession,\n };\n }\n\n return undefined;\n }\n\n private buildSyntheticTraceFromRunResult(params: {\n toolsUsed: Array<{ id: string; name: string; skillCalls: number }>;\n durationMs: number;\n }): QueryDeveloperTrace {\n const timeline = params.toolsUsed.map((tool, index) => ({\n stepType: \"tool-call\",\n event: \"tool-call\",\n status: \"success\",\n timestampMs: index,\n tool: {\n id: tool.id,\n name: tool.name,\n },\n metadata: {\n skillCalls: tool.skillCalls,\n synthetic: true,\n },\n }));\n\n const toolCalls = params.toolsUsed.reduce(\n (sum, tool) => sum + Math.max(tool.skillCalls, 0),\n 0\n );\n\n return {\n summary: {\n toolCalls,\n retryCount: 0,\n selfHealCount: 0,\n fallbackCount: 0,\n failureCount: 0,\n recoveryCount: 0,\n completionChecks: 0,\n loopCount: 0,\n },\n timeline,\n source: \"sdk-fallback\",\n synthetic: true,\n reason: \"backend_trace_missing\",\n durationMs: params.durationMs,\n };\n }\n\n private buildSyntheticTraceFromStreamStatus(params: {\n statusTimeline: Array<{\n status: string;\n tool: { id: string; name: string };\n }>;\n toolsUsed: Array<{ id: string; name: string; skillCalls: number }>;\n durationMs: number;\n }): QueryDeveloperTrace {\n const timeline = params.statusTimeline.map((entry, index) => ({\n stepType: \"tool-status\",\n event: \"tool-status\",\n status: entry.status,\n timestampMs: index,\n tool:\n entry.tool.name || entry.tool.id\n ? {\n id: entry.tool.id || undefined,\n name: entry.tool.name || undefined,\n }\n : undefined,\n metadata: { synthetic: true },\n }));\n\n const toolCallsFromUsage = params.toolsUsed.reduce(\n (sum, tool) => sum + Math.max(tool.skillCalls, 0),\n 0\n );\n const toolCallsFromStatus = params.statusTimeline.filter(\n (entry) => entry.status === \"tool-complete\"\n ).length;\n const toolCalls = toolCallsFromUsage > 0 ? toolCallsFromUsage : toolCallsFromStatus;\n\n const retryCount = params.statusTimeline.filter((entry) =>\n /(retry|fix|reflect|recover)/i.test(entry.status)\n ).length;\n const completionChecks = params.statusTimeline.filter((entry) =>\n /complet/i.test(entry.status)\n ).length;\n\n return {\n summary: {\n toolCalls,\n retryCount,\n selfHealCount: retryCount,\n fallbackCount: 0,\n failureCount: 0,\n recoveryCount: 0,\n completionChecks,\n loopCount: retryCount,\n },\n timeline,\n source: \"sdk-fallback\",\n synthetic: true,\n reason: \"backend_trace_missing\",\n durationMs: params.durationMs,\n };\n }\n\n private mergeDeveloperTrace(\n first: QueryDeveloperTrace | undefined,\n second: QueryDeveloperTrace | undefined\n ): QueryDeveloperTrace | undefined {\n if (!first) return second;\n if (!second) return first;\n\n const firstTimeline = Array.isArray(first.timeline) ? first.timeline : [];\n const secondTimeline = Array.isArray(second.timeline) ? second.timeline : [];\n const mergedTimeline = [...firstTimeline, ...secondTimeline];\n\n return {\n ...first,\n ...second,\n summary: {\n ...(typeof first.summary === \"object\" && first.summary ? first.summary : {}),\n ...(typeof second.summary === \"object\" && second.summary\n ? second.summary\n : {}),\n },\n ...(mergedTimeline.length > 0 ? { timeline: mergedTimeline } : {}),\n };\n }\n\n private parseStreamEvent(rawData: string): QueryStreamEvent | undefined {\n const parsed = JSON.parse(rawData) as unknown;\n if (!parsed || typeof parsed !== \"object\") {\n return undefined;\n }\n\n const event = parsed as QueryStreamEvent;\n if (typeof (event as { type?: unknown }).type !== \"string\") {\n return undefined;\n }\n\n return event;\n }\n\n /**\n * Run an agentic query and wait for the full response.\n *\n * The server discovers relevant tools (or uses the ones you specify),\n * executes the discovery-first pipeline (up to 100 MCP calls per tool),\n * and returns an AI-synthesized answer. Payment is settled after\n * successful execution via deferred settlement.\n *\n * @param options - Query options or a plain string question\n * @returns The complete query result with response text, tools used, and cost\n *\n * @throws {ContextError} With code `no_wallet` if wallet not set up\n * @throws {ContextError} With code `insufficient_allowance` if spending cap not set\n * @throws {ContextError} With code `payment_failed` if payment settlement fails\n * @throws {ContextError} With code `execution_failed` if the agentic pipeline fails\n *\n * @example\n * ```typescript\n * // Simple question — server discovers tools automatically\n * const answer = await client.query.run(\"What are the top whale movements on Base?\");\n * console.log(answer.response); // AI-synthesized answer\n * console.log(answer.toolsUsed); // Which tools were used\n * console.log(answer.cost); // Cost breakdown\n *\n * // With specific tools (Manual Mode)\n * const answer = await client.query.run({\n * query: \"Analyze whale activity\",\n * tools: [\"tool-uuid-1\", \"tool-uuid-2\"],\n * });\n * ```\n */\n async run(options: QueryOptions | string): Promise<QueryResult> {\n const opts = typeof options === \"string\" ? { query: options } : options;\n let terminalError:\n | { error: string; code?: string; scope?: string; reasonCode?: string }\n | undefined;\n let finalResult: QueryResult | undefined;\n\n for await (const event of this.stream(opts)) {\n if (event.type === \"error\") {\n terminalError = {\n error: event.error,\n ...(event.code ? { code: event.code } : {}),\n ...(event.scope ? { scope: event.scope } : {}),\n ...(event.reasonCode ? { reasonCode: event.reasonCode } : {}),\n };\n continue;\n }\n\n if (event.type === \"done\") {\n finalResult = event.result;\n }\n }\n\n if (finalResult) {\n return finalResult;\n }\n\n if (terminalError) {\n throw new ContextError(terminalError.error, terminalError.code);\n }\n\n throw new ContextError(\"Streaming query ended before done event\");\n }\n\n /**\n * Run an agentic query with streaming. Returns an async iterable that\n * yields events as the server processes the query in real-time.\n *\n * Event types:\n * - `tool-status` — A tool started executing or changed status\n * - `text-delta` — A chunk of the AI response text\n * - `developer-trace` — Runtime trace metadata (when includeDeveloperTrace=true)\n * - `error` — A structured query/runtime error emitted before stream completion\n * - `done` — The full response is complete (includes final `QueryResult`)\n *\n * @param options - Query options or a plain string question\n * @returns An async iterable of stream events\n *\n * @example\n * ```typescript\n * for await (const event of client.query.stream(\"What are the top whale movements?\")) {\n * switch (event.type) {\n * case \"tool-status\":\n * console.log(`Tool ${event.tool.name}: ${event.status}`);\n * break;\n * case \"text-delta\":\n * process.stdout.write(event.delta);\n * break;\n * case \"developer-trace\":\n * console.log(\"Trace summary:\", event.trace.summary);\n * break;\n * case \"done\":\n * console.log(\"\\nCost:\", event.result.cost.totalCostUsd);\n * break;\n * case \"error\":\n * console.error(\"Stream error:\", event.error);\n * break;\n * }\n * }\n * ```\n */\n async *stream(\n options: QueryOptions | string\n ): AsyncGenerator<QueryStreamEvent> {\n const opts = typeof options === \"string\" ? { query: options } : options;\n const headers = opts.idempotencyKey\n ? { \"Idempotency-Key\": opts.idempotencyKey }\n : undefined;\n\n const response = await this.client._fetchRaw(\"/api/v1/query\", {\n method: \"POST\",\n headers,\n body: JSON.stringify({\n query: opts.query,\n tools: opts.tools,\n resumeFrom: opts.resumeFrom,\n forkFrom: opts.forkFrom,\n clarificationPolicy: opts.clarificationPolicy,\n answerModelId: opts.answerModelId,\n responseShape: opts.responseShape,\n favoritesOnly: opts.favoritesOnly,\n includeData: opts.includeData,\n includeDataUrl: opts.includeDataUrl,\n includeDeveloperTrace: opts.includeDeveloperTrace,\n queryDepth: opts.queryDepth,\n debugScoutDeepMode: opts.debugScoutDeepMode,\n stream: true,\n }),\n });\n\n const body = response.body;\n if (!body) {\n throw new ContextError(\"No response body for streaming query\");\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = \"\";\n let aggregatedTrace: QueryDeveloperTrace | undefined;\n const statusTimeline: Array<{\n status: string;\n tool: { id: string; name: string };\n }> = [];\n\n const parseAndHydrateEvent = (\n rawData: string\n ): QueryStreamEvent | undefined => {\n const event = this.parseStreamEvent(rawData);\n if (!event) {\n return undefined;\n }\n\n if (event.type === \"developer-trace\") {\n aggregatedTrace = this.mergeDeveloperTrace(aggregatedTrace, event.trace);\n return event;\n }\n\n if (event.type === \"tool-status\") {\n statusTimeline.push({\n status: event.status,\n tool: {\n id: event.tool.id,\n name: event.tool.name,\n },\n });\n return event;\n }\n\n if (event.type === \"done\") {\n const normalizedResult = this.normalizeResult(event.result);\n let mergedTrace = this.mergeDeveloperTrace(\n aggregatedTrace,\n normalizedResult.developerTrace\n );\n if (!mergedTrace && opts.includeDeveloperTrace) {\n mergedTrace =\n statusTimeline.length > 0\n ? this.buildSyntheticTraceFromStreamStatus({\n statusTimeline,\n toolsUsed: normalizedResult.toolsUsed,\n durationMs: normalizedResult.durationMs,\n })\n : this.buildSyntheticTraceFromRunResult({\n toolsUsed: normalizedResult.toolsUsed,\n durationMs: normalizedResult.durationMs,\n });\n }\n if (mergedTrace) {\n normalizedResult.developerTrace = mergedTrace;\n }\n event.result = normalizedResult;\n\n const policyErrorEvent = this.buildPolicyErrorEvent({\n result: normalizedResult,\n clarificationPolicy: opts.clarificationPolicy,\n });\n if (policyErrorEvent) {\n return policyErrorEvent;\n }\n }\n\n return event;\n };\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\";\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (trimmed.startsWith(\"data: \")) {\n const data = trimmed.slice(6);\n if (data === \"[DONE]\") return;\n try {\n const event = parseAndHydrateEvent(data);\n if (event) {\n yield event;\n }\n } catch {\n // Skip malformed SSE events\n }\n }\n }\n }\n\n // Process any remaining buffer\n if (buffer.trim().startsWith(\"data: \")) {\n const data = buffer.trim().slice(6);\n if (data !== \"[DONE]\") {\n try {\n const event = parseAndHydrateEvent(data);\n if (event) {\n yield event;\n }\n } catch {\n // Skip malformed SSE events\n }\n }\n }\n } finally {\n reader.releaseLock();\n }\n }\n}\n","import type { ContextClientOptions } from \"./types.js\";\nimport { ContextError } from \"./types.js\";\nimport { Developer } from \"./resources/developer.js\";\nimport { Discovery } from \"./resources/discovery.js\";\nimport { Tools } from \"./resources/tools.js\";\nimport { Query } from \"./resources/query.js\";\n\nconst DEFAULT_BASE_URL = \"https://www.ctxprotocol.com\";\nconst DEFAULT_REQUEST_TIMEOUT_MS = 300_000;\nconst DEFAULT_STREAM_TIMEOUT_MS = 600_000;\n\n/**\n * The official TypeScript client for the Context Protocol.\n *\n * Use this client to discover and execute AI tools programmatically.\n *\n * @example\n * ```typescript\n * import { ContextClient } from \"@contextprotocol/client\";\n *\n * const client = new ContextClient({\n * apiKey: \"sk_live_...\"\n * });\n *\n * // Pay-per-request: Execute a specific tool\n * const result = await client.tools.execute({\n * toolId: \"tool-uuid\",\n * toolName: \"get_gas_prices\",\n * args: { chainId: 1 }\n * });\n *\n * // Pay-per-response: Ask a question, get a curated answer\n * const answer = await client.query.run(\"What are the top whale movements on Base?\");\n * console.log(answer.response);\n * ```\n */\nexport class ContextClient {\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly requestTimeoutMs: number;\n private readonly streamTimeoutMs: number;\n private _closed = false;\n\n /**\n * Developer resource for managing tool listings (contributor/developer concerns).\n */\n public readonly developer: Developer;\n\n /**\n * Discovery resource for searching tools\n */\n public readonly discovery: Discovery;\n\n /**\n * Tools resource for executing tools (pay-per-request)\n */\n public readonly tools: Tools;\n\n /**\n * Query resource for agentic queries (pay-per-response).\n *\n * Unlike `tools.execute()` which calls a single tool once, `query` sends\n * a natural-language question and lets the server handle tool discovery,\n * multi-tool orchestration, self-healing, and AI synthesis — one flat fee.\n */\n public readonly query: Query;\n\n /**\n * Creates a new Context Protocol client\n *\n * @param options - Client configuration options\n * @param options.apiKey - Your Context Protocol API key (format: sk_live_...)\n * @param options.baseUrl - Optional base URL override (defaults to https://www.ctxprotocol.com)\n * @param options.requestTimeoutMs - Optional timeout for non-streaming requests (default 300000ms)\n * @param options.streamTimeoutMs - Optional timeout for establishing stream requests (default 600000ms)\n */\n constructor(options: ContextClientOptions) {\n if (!options.apiKey) {\n throw new ContextError(\"API key is required\");\n }\n\n const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n const streamTimeoutMs = options.streamTimeoutMs ?? DEFAULT_STREAM_TIMEOUT_MS;\n\n if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) {\n throw new ContextError(\"requestTimeoutMs must be a positive number\");\n }\n\n if (!Number.isFinite(streamTimeoutMs) || streamTimeoutMs <= 0) {\n throw new ContextError(\"streamTimeoutMs must be a positive number\");\n }\n\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n this.requestTimeoutMs = requestTimeoutMs;\n this.streamTimeoutMs = streamTimeoutMs;\n\n // Initialize resources\n this.developer = new Developer(this);\n this.discovery = new Discovery(this);\n this.tools = new Tools(this);\n this.query = new Query(this);\n }\n\n /**\n * Close the client and clean up resources.\n * After calling close(), any in-flight requests may be aborted.\n */\n close(): void {\n this._closed = true;\n }\n\n /**\n * Internal method for making authenticated HTTP requests\n * Includes timeout and retry with exponential backoff for transient errors\n *\n * @internal\n */\n async _fetch<T>(\n endpoint: string,\n options: RequestInit = {},\n fetchOptions?: { retry?: boolean }\n ): Promise<T> {\n if (this._closed) {\n throw new ContextError(\"Client has been closed\");\n }\n\n const url = `${this.baseUrl}${endpoint}`;\n const maxRetries = 3;\n const timeoutMs = this.requestTimeoutMs;\n const method = (options.method ?? \"GET\").toUpperCase();\n const requestHeaders = new Headers(options.headers);\n const canRetryRequest =\n fetchOptions?.retry === false\n ? false\n : method === \"GET\" ||\n method === \"HEAD\" ||\n method === \"OPTIONS\" ||\n requestHeaders.has(\"Idempotency-Key\");\n\n let lastError: Error | undefined;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), timeoutMs);\n const mergedHeaders = new Headers(requestHeaders);\n if (!mergedHeaders.has(\"Content-Type\")) {\n mergedHeaders.set(\"Content-Type\", \"application/json\");\n }\n mergedHeaders.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n try {\n const response = await fetch(url, {\n ...options,\n signal: controller.signal,\n headers: mergedHeaders,\n });\n\n clearTimeout(timeout);\n\n if (!response.ok) {\n // Retry on 5xx server errors\n if (response.status >= 500 && canRetryRequest && attempt < maxRetries) {\n const delay = Math.min(1000 * 2 ** attempt, 10_000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n continue;\n }\n\n let errorMessage = `HTTP ${response.status}: ${response.statusText}`;\n let errorCode: string | undefined;\n let helpUrl: string | undefined;\n\n try {\n const errorBody = await response.json();\n if (errorBody.error) {\n errorMessage = errorBody.error;\n errorCode = errorBody.code;\n helpUrl = errorBody.helpUrl;\n }\n } catch {\n // Use default error message if JSON parsing fails\n }\n\n throw new ContextError(errorMessage, errorCode, response.status, helpUrl);\n }\n\n try {\n return (await response.json()) as T;\n } catch (error) {\n const parseError = error instanceof Error ? error : new Error(String(error));\n throw new ContextError(\n `Failed to parse JSON response: ${parseError.message}`,\n undefined,\n response.status\n );\n }\n } catch (error) {\n clearTimeout(timeout);\n\n if (error instanceof ContextError) {\n throw error;\n }\n\n lastError = error instanceof Error ? error : new Error(String(error));\n\n // Retry on network errors and timeouts\n const isRetryable =\n lastError.name === \"AbortError\" ||\n lastError.message.includes(\"fetch failed\") ||\n lastError.message.includes(\"ECONNRESET\") ||\n lastError.message.includes(\"ETIMEDOUT\");\n\n if (isRetryable && canRetryRequest && attempt < maxRetries) {\n const delay = Math.min(1000 * 2 ** attempt, 10_000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n continue;\n }\n\n if (lastError.name === \"AbortError\") {\n throw new ContextError(\n `Request timed out after ${timeoutMs / 1000}s`,\n undefined,\n 408\n );\n }\n\n throw new ContextError(\n lastError.message,\n undefined,\n undefined\n );\n }\n }\n\n throw lastError ?? new ContextError(\"Request failed after retries\");\n }\n\n /**\n * Internal method for making authenticated HTTP requests that returns\n * the raw Response object. Used for streaming endpoints (SSE).\n * Includes a configurable timeout for stream setup.\n *\n * @internal\n */\n async _fetchRaw(endpoint: string, options: RequestInit = {}): Promise<Response> {\n if (this._closed) {\n throw new ContextError(\"Client has been closed\");\n }\n\n const url = `${this.baseUrl}${endpoint}`;\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), this.streamTimeoutMs);\n\n let response: Response;\n try {\n response = await fetch(url, {\n ...options,\n signal: controller.signal,\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${this.apiKey}`,\n ...options.headers,\n },\n });\n } catch (error) {\n clearTimeout(timeout);\n const lastError = error instanceof Error ? error : new Error(String(error));\n if (lastError.name === \"AbortError\") {\n throw new ContextError(\n `Streaming request timed out after ${this.streamTimeoutMs / 1000}s`,\n undefined,\n 408\n );\n }\n throw new ContextError(lastError.message);\n }\n\n clearTimeout(timeout);\n\n if (!response.ok) {\n let errorMessage = `HTTP ${response.status}: ${response.statusText}`;\n let errorCode: string | undefined;\n let helpUrl: string | undefined;\n\n try {\n const errorBody = await response.json();\n if (errorBody.error) {\n errorMessage = errorBody.error;\n errorCode = errorBody.code;\n helpUrl = errorBody.helpUrl;\n }\n } catch {\n // Use default error message if JSON parsing fails\n }\n\n throw new ContextError(errorMessage, errorCode, response.status, helpUrl);\n }\n\n return response;\n }\n}\n","/**\n * Context types for portfolio and protocol data injection.\n *\n * These types allow MCP tools to receive personalized user context\n * (wallet addresses, positions, balances) for analysis.\n *\n * =============================================================================\n * DECLARING CONTEXT REQUIREMENTS\n * =============================================================================\n *\n * Context requirements are declared via `_meta.contextRequirements` at the tool level.\n * This is the primary mechanism that the Context Platform reads.\n *\n * Previously, `x-context-requirements` in inputSchema was recommended, but the MCP SDK\n * may strip extension properties during transport. Use `_meta` instead.\n *\n * @example\n * ```typescript\n * import { CONTEXT_REQUIREMENTS_KEY, type ContextRequirementType } from \"@ctxprotocol/sdk\";\n * import type { HyperliquidContext } from \"@ctxprotocol/sdk\";\n *\n * const tool = {\n * name: \"analyze_my_positions\",\n * _meta: {\n * contextRequirements: [\"hyperliquid\"] as ContextRequirementType[],\n * },\n * inputSchema: {\n * type: \"object\",\n * properties: {\n * portfolio: { type: \"object\" }\n * },\n * required: [\"portfolio\"]\n * }\n * };\n *\n * // Your handler receives the injected context:\n * function handleAnalyzeMyPositions(args: { portfolio: HyperliquidContext }) {\n * const { perpPositions, accountSummary } = args.portfolio;\n * // ... analyze and return insights\n * }\n * ```\n *\n * @packageDocumentation\n */\n\n// Wallet context types\nexport * from \"./wallet.js\";\n\n// Protocol-specific context types\nexport * from \"./polymarket.js\";\nexport * from \"./hyperliquid.js\";\n\n// Re-import for composite type\nimport type { WalletContext, ERC20Context } from \"./wallet.js\";\nimport type { PolymarketContext } from \"./polymarket.js\";\nimport type { HyperliquidContext } from \"./hyperliquid.js\";\n\n// ============================================================================\n// CONTEXT REQUIREMENTS\n//\n// MCP tools that need user portfolio data MUST declare this in inputSchema.\n// The MCP protocol only transmits standard fields (name, description,\n// inputSchema, outputSchema). Custom fields get stripped by the MCP SDK.\n// ============================================================================\n\n/**\n * @deprecated Use `_meta.contextRequirements` instead (see META_CONTEXT_REQUIREMENTS_KEY).\n *\n * This key was designed for embedding requirements in inputSchema,\n * but the MCP SDK may strip `x-` prefixed extension properties during transport.\n * The `_meta.contextRequirements` approach is what the Context Platform reads.\n */\nexport const CONTEXT_REQUIREMENTS_KEY = \"x-context-requirements\" as const;\n\n/**\n * The key used inside `_meta` to declare context requirements.\n * This is the PRIMARY mechanism — the Context Platform reads `_meta.contextRequirements`.\n *\n * @example\n * ```typescript\n * const tool = {\n * name: \"analyze_my_positions\",\n * _meta: {\n * [META_CONTEXT_REQUIREMENTS_KEY]: [\"hyperliquid\"] as ContextRequirementType[],\n * },\n * inputSchema: {\n * type: \"object\",\n * properties: { portfolio: { type: \"object\" } },\n * required: [\"portfolio\"]\n * }\n * };\n * ```\n */\nexport const META_CONTEXT_REQUIREMENTS_KEY = \"contextRequirements\" as const;\n\n/**\n * Context requirement types supported by the Context marketplace.\n * Maps to protocol-specific context builders on the platform.\n *\n * @example\n * ```typescript\n * inputSchema: {\n * type: \"object\",\n * \"x-context-requirements\": [\"hyperliquid\"] as ContextRequirementType[],\n * properties: { portfolio: { type: \"object\" } },\n * required: [\"portfolio\"]\n * }\n * ```\n */\nexport type ContextRequirementType = \"polymarket\" | \"hyperliquid\" | \"wallet\";\n\n/**\n * @deprecated The `requirements` field at tool level gets stripped by MCP SDK.\n * Use `x-context-requirements` inside `inputSchema` instead.\n *\n * @example\n * ```typescript\n * // ❌ OLD (doesn't work - stripped by MCP SDK)\n * { requirements: { context: [\"hyperliquid\"] } }\n *\n * // ✅ NEW (works - preserved through MCP transport)\n * { inputSchema: { \"x-context-requirements\": [\"hyperliquid\"], ... } }\n * ```\n */\nexport interface ToolRequirements {\n /**\n * @deprecated Use `x-context-requirements` in inputSchema instead.\n */\n context?: ContextRequirementType[];\n}\n\n/**\n * Composite context for tools that need multiple data sources.\n *\n * This is the unified structure that can be passed to MCP tools\n * to provide comprehensive user context.\n */\nexport interface UserContext {\n /** Base wallet information */\n wallet?: WalletContext;\n /** ERC20 token holdings */\n erc20?: ERC20Context;\n /** Polymarket positions and orders */\n polymarket?: PolymarketContext;\n /** Hyperliquid perpetual positions and account data */\n hyperliquid?: HyperliquidContext;\n // Future protocols:\n // aave?: AaveContext;\n}\n","import { jwtVerify, importSPKI, type JWTPayload } from \"jose\";\nimport { ContextError } from \"../client/types.js\";\n\n// ============================================================================\n// Express-compatible types (avoid requiring express as a dependency)\n// ============================================================================\n\ninterface ContextRequest {\n headers: {\n authorization?: string;\n [key: string]: string | string[] | undefined;\n };\n body?: {\n method?: string;\n [key: string]: unknown;\n };\n context?: JWTPayload;\n}\n\ninterface ContextResponse {\n status(code: number): ContextResponse;\n json(data: unknown): void;\n}\n\ntype NextFunction = (error?: unknown) => void;\n\n/**\n * Extended Request object with verified Context Protocol JWT payload.\n *\n * After `createContextMiddleware()` runs successfully on a protected method,\n * the `context` property contains the decoded JWT claims.\n */\nexport interface ContextMiddlewareRequest extends ContextRequest {\n /** The verified JWT payload from Context Protocol (available after auth) */\n context?: JWTPayload;\n}\n\n// ============================================================================\n// Configuration\n// ============================================================================\n\n// The Context Protocol Public Key\n// In a real scenario, this might be fetched from a well-known URL or passed in config.\n// For now, we hardcode the Official Platform Public Key.\n// Official Context Protocol Platform Public Key (RS256)\nconst CONTEXT_PLATFORM_PUBLIC_KEY_PEM = `-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs9YOgdpkmVQ5aoNovjsu\nchJdV54OT7dUdbVXz914a7Px8EwnpDqhsvG7WO8xL8sj2Rn6ueAJBk+04Hy/P/UN\nRJyp23XL5TsGmb4rbfg0ii0MiL2nbVXuqvAe3JSM2BOFZR5bpwIVIaa8aonfamUy\nVXGc7OosF90ThdKjm9cXlVM+kV6IgSWc1502X7M3abQqRcTU/rluVXnky0eiWDQa\nlfOKbr7w0u72dZjiZPwnNDsX6PEEgvfmoautTFYTQgnZjDzq8UimTcv3KF+hJ5Ep\nweipe6amt9lzQzi8WXaFKpOXHQs//WDlUytz/Hl8pvd5craZKzo6Kyrg1Vfan7H3\nTQIDAQAB\n-----END PUBLIC KEY-----`;\n\n// ============================================================================\n// JWKS Key Fetching (with hardcoded fallback)\n// ============================================================================\n\nconst JWKS_URL = \"https://ctxprotocol.com/.well-known/jwks.json\";\nconst KEY_CACHE_TTL_MS = 3_600_000; // 1 hour\n\nlet cachedPublicKey: Awaited<ReturnType<typeof importSPKI>> | null = null;\nlet cacheTimestamp = 0;\n\n/**\n * Get the platform public key, trying JWKS endpoint first with hardcoded fallback.\n * Caches the result for 1 hour.\n */\nasync function getPlatformPublicKey(): Promise<Awaited<ReturnType<typeof importSPKI>>> {\n const now = Date.now();\n\n // Return cached key if still valid\n if (cachedPublicKey && now - cacheTimestamp < KEY_CACHE_TTL_MS) {\n return cachedPublicKey;\n }\n\n // Try JWKS endpoint first\n try {\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), 5000);\n\n const response = await fetch(JWKS_URL, { signal: controller.signal });\n clearTimeout(timeout);\n\n if (response.ok) {\n const jwks = await response.json() as { keys?: Array<{ x5c?: string[]; kty?: string; n?: string; e?: string }> };\n if (jwks.keys && jwks.keys.length > 0) {\n const key = jwks.keys[0];\n // If the JWKS contains x5c (X.509 cert chain), extract the public key\n if (key.x5c && key.x5c.length > 0) {\n const pem = `-----BEGIN CERTIFICATE-----\\n${key.x5c[0]}\\n-----END CERTIFICATE-----`;\n const { importX509 } = await import(\"jose\");\n cachedPublicKey = await importX509(pem, \"RS256\");\n cacheTimestamp = now;\n return cachedPublicKey;\n }\n }\n }\n } catch {\n // JWKS fetch failed - fall back to hardcoded key\n }\n\n // Fallback: use hardcoded key\n cachedPublicKey = await importSPKI(CONTEXT_PLATFORM_PUBLIC_KEY_PEM, \"RS256\");\n cacheTimestamp = now;\n return cachedPublicKey;\n}\n\n/**\n * MCP methods that require authentication.\n * - tools/call: Executes tool logic, may cost money\n * - resources/read: Reads potentially sensitive data\n * - prompts/get: Gets prompt content\n */\nconst PROTECTED_MCP_METHODS = new Set([\n \"tools/call\",\n // Uncomment these if you want to protect resource/prompt access:\n // \"resources/read\",\n // \"prompts/get\",\n]);\n\n/**\n * MCP methods that are always open (no auth required).\n * These are discovery/listing operations that return metadata only.\n */\nconst OPEN_MCP_METHODS = new Set([\n \"initialize\",\n \"tools/list\",\n \"resources/list\",\n \"prompts/list\",\n \"ping\",\n \"notifications/initialized\",\n]);\n\n// ============================================================================\n// Method Classification\n// ============================================================================\n\n/**\n * Determines if a given MCP method requires authentication.\n *\n * Discovery methods (tools/list, resources/list, etc.) are open.\n * Execution methods (tools/call) require authentication.\n *\n * @param method The MCP JSON-RPC method (e.g., \"tools/list\", \"tools/call\")\n * @returns true if the method requires authentication\n *\n * @example\n * ```typescript\n * if (isProtectedMcpMethod(body.method)) {\n * await verifyContextRequest({ authorizationHeader: req.headers.authorization });\n * }\n * ```\n */\nexport function isProtectedMcpMethod(method: string): boolean {\n return PROTECTED_MCP_METHODS.has(method);\n}\n\n/**\n * Determines if a given MCP method is explicitly open (no auth).\n *\n * @param method The MCP JSON-RPC method\n * @returns true if the method is known to be open\n */\nexport function isOpenMcpMethod(method: string): boolean {\n return OPEN_MCP_METHODS.has(method);\n}\n\n// ============================================================================\n// Request Verification\n// ============================================================================\n\nexport interface VerifyRequestOptions {\n /** The full Authorization header string (e.g. \"Bearer eyJ...\") */\n authorizationHeader?: string;\n /** Expected Audience (your tool URL) for stricter validation */\n audience?: string;\n}\n\n/**\n * Verifies that an incoming request originated from the Context Protocol Platform.\n *\n * @param options Contains the Authorization header\n * @returns The decoded payload if valid\n * @throws ContextError if invalid\n */\nexport async function verifyContextRequest(options: VerifyRequestOptions) {\n const { authorizationHeader, audience } = options;\n\n if (!authorizationHeader || !authorizationHeader.startsWith(\"Bearer \")) {\n throw new ContextError(\n \"Missing or invalid Authorization header\",\n \"unauthorized\",\n 401\n );\n }\n\n const token = authorizationHeader.split(\" \")[1];\n\n try {\n const publicKey = await getPlatformPublicKey();\n\n const { payload } = await jwtVerify(token, publicKey, {\n issuer: \"https://ctxprotocol.com\",\n audience: audience,\n });\n\n return payload;\n } catch (error) {\n throw new ContextError(\n \"Invalid Context Protocol signature\",\n \"unauthorized\",\n 401\n );\n }\n}\n\n// ============================================================================\n// Easy-Mode Middleware\n// ============================================================================\n\nexport interface CreateContextMiddlewareOptions {\n /** Expected Audience (your tool URL) for stricter validation */\n audience?: string;\n}\n\n/**\n * Creates an Express/Connect-compatible middleware that secures your MCP endpoint.\n *\n * This is the \"1 line of code\" solution to secure your MCP server.\n * It automatically:\n * - Allows discovery methods (tools/list, initialize) without authentication\n * - Requires and verifies JWT for execution methods (tools/call)\n * - Attaches the verified payload to `req.context` for downstream use\n *\n * @param options Optional configuration\n * @returns Express-compatible middleware function\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { createContextMiddleware } from \"@ctxprotocol/sdk\";\n *\n * const app = express();\n * app.use(express.json());\n *\n * // 1 line to secure your endpoint\n * app.use(\"/mcp\", createContextMiddleware());\n *\n * app.post(\"/mcp\", (req, res) => {\n * // req.context contains verified JWT payload (on protected methods)\n * // Handle MCP request...\n * });\n * ```\n */\nexport function createContextMiddleware(options: CreateContextMiddlewareOptions = {}) {\n return async function contextMiddleware(\n req: ContextRequest,\n res: ContextResponse,\n next: NextFunction\n ): Promise<void> {\n const method = req.body?.method as string | undefined;\n\n // Allow discovery methods without authentication\n // Discovery methods (tools/list, initialize, etc.) are open by design\n if (!method || !isProtectedMcpMethod(method)) {\n return next();\n }\n\n // Protected method - require authentication\n try {\n const payload = await verifyContextRequest({\n authorizationHeader: req.headers.authorization,\n audience: options.audience,\n });\n\n // Attach verified payload to request for downstream handlers\n req.context = payload;\n next();\n } catch (error) {\n const statusCode = error instanceof ContextError ? error.statusCode || 401 : 401;\n res.status(statusCode).json({ error: \"Unauthorized\" });\n }\n };\n}\n\n\n","/**\n * Handshake Types for MCP Tool Developers\n *\n * Use these types when your tool needs to request user interaction\n * before completing an action (signatures, transactions, OAuth).\n *\n * @see https://docs.ctxprotocol.com/guides/handshake-architecture\n *\n * ## Usage Pattern\n *\n * Tools return handshake actions in the `_meta.handshakeAction` field\n * of their MCP response. The Context platform intercepts these and\n * presents the appropriate UI to the user.\n *\n * These helpers define the contributor-side MCP response contract.\n * They do not create a headless Query API approval/resume flow; completing\n * a handshake currently requires the Context chat app UI.\n *\n * ## Action Types\n *\n * - `signature_request`: For EIP-712 signatures (Hyperliquid, Polymarket, etc.)\n * - `transaction_proposal`: For direct on-chain transactions (Uniswap, NFT mints)\n * - `auth_required`: For OAuth flows (Discord, Twitter, etc.)\n */\n\n// === Shared Meta Type ===\n\nexport type HandshakeMeta = {\n /** Human-readable description of the action */\n description: string;\n /** Protocol name (e.g., \"Hyperliquid\", \"Polymarket\") */\n protocol?: string;\n /** Action verb (e.g., \"Place Order\", \"Place Bid\") */\n action?: string;\n /** Token symbol if relevant */\n tokenSymbol?: string;\n /** Human-readable token amount */\n tokenAmount?: string;\n /** UI warning level */\n warningLevel?: \"info\" | \"caution\" | \"danger\";\n /** Custom title for the signature card (marketplace-friendly, overrides action-based title) */\n title?: string;\n /** Custom subtitle for the signature card (overrides tool name display) */\n subtitle?: string;\n};\n\n// === Web3: Signature Requests (for proxy wallet platforms) ===\n\nexport type EIP712Domain = {\n /** Domain name (e.g., \"Hyperliquid\", \"ClobAuthDomain\") */\n name: string;\n /** Domain version */\n version: string;\n /** Chain ID (informational - signing is chain-agnostic) */\n chainId: number;\n /** Optional verifying contract address */\n verifyingContract?: `0x${string}`;\n};\n\nexport type EIP712TypeField = {\n name: string;\n type: string;\n};\n\n/**\n * Signature Request\n *\n * Use this for platforms with proxy wallets (Hyperliquid, Polymarket, dYdX).\n *\n * Benefits:\n * - No gas required (user signs a message, not a transaction)\n * - No network switching needed (signing is chain-agnostic)\n * - Works with Privy embedded wallets on any chain\n *\n * @example\n * ```typescript\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createSignatureRequest({\n * domain: { name: \"Hyperliquid\", version: \"1\", chainId: 42161 },\n * types: { Order: [...] },\n * primaryType: \"Order\",\n * message: { asset: 4, isBuy: true, ... },\n * meta: { description: \"Place Long ETH order\", protocol: \"Hyperliquid\" }\n * })\n * }\n * }\n * };\n * ```\n */\nexport type SignatureRequest = {\n _action: \"signature_request\";\n /** EIP-712 domain separator */\n domain: EIP712Domain;\n /** EIP-712 type definitions */\n types: Record<string, EIP712TypeField[]>;\n /** The primary type being signed */\n primaryType: string;\n /** The message data to sign */\n message: Record<string, unknown>;\n /** UI metadata for the approval card */\n meta?: HandshakeMeta;\n /**\n * Optional: Tool name to call with the signature result.\n * If provided, the platform will call this tool with { signature, originalParams }\n * after the user signs.\n */\n callbackToolName?: string;\n};\n\n// === Web3: Transaction Proposals (for direct on-chain actions) ===\n\nexport type TransactionProposalMeta = HandshakeMeta & {\n /** Estimated gas cost (informational - Context may sponsor) */\n estimatedGas?: string;\n /** Link to contract on block explorer */\n explorerUrl?: string;\n};\n\n/**\n * Transaction Proposal\n *\n * Use this for protocols without proxy wallets (Uniswap, NFT mints, etc.).\n *\n * Note: May require network switching and gas fees.\n *\n * @example\n * ```typescript\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createTransactionProposal({\n * chainId: 8453,\n * to: \"0x...\",\n * data: \"0x...\",\n * meta: { description: \"Swap 100 USDC for ETH\", protocol: \"Uniswap\" }\n * })\n * }\n * }\n * };\n * ```\n */\nexport type TransactionProposal = {\n _action: \"transaction_proposal\";\n /** EVM chain ID (e.g., 137 for Polygon, 8453 for Base) */\n chainId: number;\n /** Target contract address */\n to: `0x${string}`;\n /** Encoded calldata */\n data: `0x${string}`;\n /** Wei to send (as string, default \"0\") */\n value?: string;\n /** UI metadata for the approval card */\n meta?: TransactionProposalMeta;\n};\n\n// === Web2: OAuth Requests ===\n\nexport type AuthRequiredMeta = {\n /** Human-friendly service name */\n displayName?: string;\n /** Permissions being requested */\n scopes?: string[];\n /** Description of what access is needed */\n description?: string;\n /** Tool's icon URL */\n iconUrl?: string;\n /** How long authorization lasts */\n expiresIn?: string;\n};\n\n/**\n * Auth Required\n *\n * Use this when your tool needs the user to authenticate with an external service.\n *\n * @example\n * ```typescript\n * if (!hasUserToken(contextDid)) {\n * return {\n * structuredContent: {\n * _meta: {\n * handshakeAction: createAuthRequired({\n * provider: \"discord\",\n * authUrl: \"https://your-server.com/oauth/discord\",\n * meta: { displayName: \"Discord Bot\", scopes: [\"send_messages\"] }\n * })\n * }\n * }\n * };\n * }\n * ```\n */\nexport type AuthRequired = {\n _action: \"auth_required\";\n /** Service identifier (e.g., \"discord\", \"slack\") */\n provider: string;\n /** Your OAuth initiation endpoint (MUST be HTTPS) */\n authUrl: string;\n /** UI metadata for the auth card */\n meta?: AuthRequiredMeta;\n};\n\n// === Union Type ===\n\nexport type HandshakeAction =\n | SignatureRequest\n | TransactionProposal\n | AuthRequired;\n\n// === Type Guards ===\n\nexport function isHandshakeAction(value: unknown): value is HandshakeAction {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"_action\" in value &&\n ((value as { _action: string })._action === \"signature_request\" ||\n (value as { _action: string })._action === \"transaction_proposal\" ||\n (value as { _action: string })._action === \"auth_required\")\n );\n}\n\nexport function isSignatureRequest(value: unknown): value is SignatureRequest {\n return isHandshakeAction(value) && value._action === \"signature_request\";\n}\n\nexport function isTransactionProposal(\n value: unknown\n): value is TransactionProposal {\n return isHandshakeAction(value) && value._action === \"transaction_proposal\";\n}\n\nexport function isAuthRequired(value: unknown): value is AuthRequired {\n return isHandshakeAction(value) && value._action === \"auth_required\";\n}\n\n// === Helper Functions for Tool Developers ===\n\n/**\n * Create a signature request response.\n * Return this from your tool when you need the user to sign EIP-712 typed data.\n *\n * Use this for platforms with proxy wallets (Hyperliquid, Polymarket, dYdX).\n * Benefits: No gas required, no network switching needed.\n */\nexport function createSignatureRequest(\n params: Omit<SignatureRequest, \"_action\">\n): SignatureRequest {\n return {\n _action: \"signature_request\",\n ...params,\n };\n}\n\n/**\n * Create a transaction proposal response.\n * Return this from your tool when you need the user to sign a direct on-chain transaction.\n *\n * Use this for protocols that don't use proxy wallets (Uniswap, NFT mints, etc.).\n * Note: May require network switching and gas.\n */\nexport function createTransactionProposal(\n params: Omit<TransactionProposal, \"_action\">\n): TransactionProposal {\n return {\n _action: \"transaction_proposal\",\n ...params,\n };\n}\n\n/**\n * Create an auth required response.\n * Return this from your tool when you need the user to authenticate via OAuth.\n */\nexport function createAuthRequired(\n params: Omit<AuthRequired, \"_action\">\n): AuthRequired {\n return {\n _action: \"auth_required\",\n ...params,\n };\n}\n\n// === MCP Response Helper ===\n\n/**\n * Wrap a handshake action in the proper MCP response format.\n *\n * MCP tools should return handshake actions in `_meta.handshakeAction` to prevent\n * the MCP SDK from stripping unknown fields.\n * Headless Query clients may observe raw internal handshake markers in\n * execution data, but they cannot submit approval results through the\n * Query API today.\n *\n * @example\n * ```typescript\n * // In your tool handler:\n * return wrapHandshakeResponse(createSignatureRequest({\n * domain: { name: \"Hyperliquid\", version: \"1\", chainId: 42161 },\n * types: { Order: [...] },\n * primaryType: \"Order\",\n * message: orderData,\n * meta: { description: \"Place order\", protocol: \"Hyperliquid\" }\n * }));\n * ```\n */\nexport function wrapHandshakeResponse(action: HandshakeAction): {\n content: Array<{ type: \"text\"; text: string }>;\n structuredContent: {\n _meta: { handshakeAction: HandshakeAction };\n status: string;\n message: string;\n };\n} {\n const actionType = action._action.replace(\"_\", \" \");\n return {\n content: [\n {\n type: \"text\",\n text: `Handshake required: ${actionType}. Please approve in the Context app.`,\n },\n ],\n structuredContent: {\n _meta: {\n handshakeAction: action,\n },\n status: \"handshake_required\",\n message: action.meta?.description ?? `${actionType} required`,\n },\n };\n}\n"]}