@ctxprotocol/sdk 0.10.0 → 0.11.0

package/dist/client/index.d.cts

@@ -1,5 +1,37 @@
-import { T as Tool, H as SearchOptions, I as ExecuteOptions, O as ExecutionResult, J as ExecuteSessionStartOptions, N as ExecuteSessionResult, a0 as QueryOptions, a1 as QueryResult, ad as QueryStreamEvent, D as ContextClientOptions } from '../types-Bgjq3OBR.cjs';
-export { B as ContextError, aj as ContextErrorCode, U as ExecuteApiErrorResponse, V as ExecuteApiResponse, P as ExecuteApiSuccessResponse, X as ExecuteSessionApiResponse, W as ExecuteSessionApiSuccessResponse, L as ExecuteSessionSpend, K as ExecuteSessionStatus, M as McpTool, E as McpToolMeta, F as McpToolRateLimitHints, ac as QueryApiResponse, ab as QueryApiSuccessResponse, ao as QueryAssumptionMetadata, Z as QueryAttemptForkReason, _ as QueryAttemptReference, an as QueryCapabilityMissPayload, al as QueryClarificationOption, ak as QueryClarificationPayload, am as QueryClarificationPolicy, a5 as QueryCompletenessRepairEvent, a4 as QueryCost, Y as QueryDeepMode, Q as QueryDeveloperTrace, a6 as QueryDeveloperTraceDiagnostics, aa as QueryDeveloperTraceLoopInfo, a8 as QueryDeveloperTraceStep, a7 as QueryDeveloperTraceSummary, a9 as QueryDeveloperTraceToolRef, $ as QueryForkReference, ap as QueryOutcomeType, a2 as QuerySessionState, ag as QueryStreamDeveloperTraceEvent, ah as QueryStreamDoneEvent, ai as QueryStreamErrorEvent, af as QueryStreamTextDeltaEvent, ae as QueryStreamToolStatusEvent, a3 as QueryToolUsage, G as SearchResponse } from '../types-Bgjq3OBR.cjs';
+import { aj as UpdateToolOptions, ak as UpdateToolResult, T as Tool, H as SearchOptions, I as ExecuteOptions, O as ExecutionResult, J as ExecuteSessionStartOptions, N as ExecuteSessionResult, a0 as QueryOptions, a1 as QueryResult, ad as QueryStreamEvent, D as ContextClientOptions } from '../types-DRbq-FA6.cjs';
+export { at as ALLOWED_TOOL_CATEGORIES, B as ContextError, al as ContextErrorCode, U as ExecuteApiErrorResponse, V as ExecuteApiResponse, P as ExecuteApiSuccessResponse, X as ExecuteSessionApiResponse, W as ExecuteSessionApiSuccessResponse, L as ExecuteSessionSpend, K as ExecuteSessionStatus, M as McpTool, E as McpToolMeta, F as McpToolRateLimitHints, ac as QueryApiResponse, ab as QueryApiSuccessResponse, aq as QueryAssumptionMetadata, Z as QueryAttemptForkReason, _ as QueryAttemptReference, ap as QueryCapabilityMissPayload, an as QueryClarificationOption, am as QueryClarificationPayload, ao as QueryClarificationPolicy, a5 as QueryCompletenessRepairEvent, a4 as QueryCost, Y as QueryDeepMode, Q as QueryDeveloperTrace, a6 as QueryDeveloperTraceDiagnostics, aa as QueryDeveloperTraceLoopInfo, a8 as QueryDeveloperTraceStep, a7 as QueryDeveloperTraceSummary, a9 as QueryDeveloperTraceToolRef, $ as QueryForkReference, ar as QueryOutcomeType, a2 as QuerySessionState, ag as QueryStreamDeveloperTraceEvent, ah as QueryStreamDoneEvent, ai as QueryStreamErrorEvent, af as QueryStreamTextDeltaEvent, ae as QueryStreamToolStatusEvent, a3 as QueryToolUsage, G as SearchResponse, as as ToolCategory } from '../types-DRbq-FA6.cjs';
+
+/**
+ * Developer resource for managing tool listings on the Context Protocol marketplace.
+ *
+ * Scoped to contributor/developer concerns (listing management), separate from
+ * the consumer-facing `tools.execute()` and `query.run()`.
+ */
+declare class Developer {
+    private client;
+    constructor(client: ContextClient);
+    /**
+     * Update a tool listing's metadata (name, description, category).
+     *
+     * Requires an API key belonging to the tool's owner.
+     *
+     * @param toolId - The UUID of the tool to update
+     * @param updates - Fields to update (at least one required)
+     * @returns The updated tool metadata
+     *
+     * @throws {ContextError} If authentication fails or the caller does not own the tool
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.developer.updateTool("tool-uuid", {
+     *   description: "Updated description with better showcase prompts",
+     *   category: "crypto",
+     * });
+     * console.log(updated.updatedAt);
+     * ```
+     */
+    updateTool(toolId: string, updates: UpdateToolOptions): Promise<UpdateToolResult>;
+}
 
 /**
  * Discovery resource for searching and finding tools on the Context Protocol marketplace
@@ -211,6 +243,10 @@ declare class ContextClient {
     private readonly requestTimeoutMs;
     private readonly streamTimeoutMs;
     private _closed;
+    /**
+     * Developer resource for managing tool listings (contributor/developer concerns).
+     */
+    readonly developer: Developer;
     /**
      * Discovery resource for searching tools
      */
@@ -261,4 +297,4 @@ declare class ContextClient {
     _fetchRaw(endpoint: string, options?: RequestInit): Promise<Response>;
 }
 
-export { ContextClient, ContextClientOptions, Discovery, ExecuteOptions, ExecuteSessionResult, ExecuteSessionStartOptions, ExecutionResult, Query, QueryOptions, QueryResult, QueryStreamEvent, SearchOptions, Tool, Tools };
+export { ContextClient, ContextClientOptions, Developer, Discovery, ExecuteOptions, ExecuteSessionResult, ExecuteSessionStartOptions, ExecutionResult, Query, QueryOptions, QueryResult, QueryStreamEvent, SearchOptions, Tool, Tools, UpdateToolOptions, UpdateToolResult };

package/dist/client/index.d.ts

@@ -1,5 +1,37 @@
-import { T as Tool, H as SearchOptions, I as ExecuteOptions, O as ExecutionResult, J as ExecuteSessionStartOptions, N as ExecuteSessionResult, a0 as QueryOptions, a1 as QueryResult, ad as QueryStreamEvent, D as ContextClientOptions } from '../types-Bgjq3OBR.js';
-export { B as ContextError, aj as ContextErrorCode, U as ExecuteApiErrorResponse, V as ExecuteApiResponse, P as ExecuteApiSuccessResponse, X as ExecuteSessionApiResponse, W as ExecuteSessionApiSuccessResponse, L as ExecuteSessionSpend, K as ExecuteSessionStatus, M as McpTool, E as McpToolMeta, F as McpToolRateLimitHints, ac as QueryApiResponse, ab as QueryApiSuccessResponse, ao as QueryAssumptionMetadata, Z as QueryAttemptForkReason, _ as QueryAttemptReference, an as QueryCapabilityMissPayload, al as QueryClarificationOption, ak as QueryClarificationPayload, am as QueryClarificationPolicy, a5 as QueryCompletenessRepairEvent, a4 as QueryCost, Y as QueryDeepMode, Q as QueryDeveloperTrace, a6 as QueryDeveloperTraceDiagnostics, aa as QueryDeveloperTraceLoopInfo, a8 as QueryDeveloperTraceStep, a7 as QueryDeveloperTraceSummary, a9 as QueryDeveloperTraceToolRef, $ as QueryForkReference, ap as QueryOutcomeType, a2 as QuerySessionState, ag as QueryStreamDeveloperTraceEvent, ah as QueryStreamDoneEvent, ai as QueryStreamErrorEvent, af as QueryStreamTextDeltaEvent, ae as QueryStreamToolStatusEvent, a3 as QueryToolUsage, G as SearchResponse } from '../types-Bgjq3OBR.js';
+import { aj as UpdateToolOptions, ak as UpdateToolResult, T as Tool, H as SearchOptions, I as ExecuteOptions, O as ExecutionResult, J as ExecuteSessionStartOptions, N as ExecuteSessionResult, a0 as QueryOptions, a1 as QueryResult, ad as QueryStreamEvent, D as ContextClientOptions } from '../types-DRbq-FA6.js';
+export { at as ALLOWED_TOOL_CATEGORIES, B as ContextError, al as ContextErrorCode, U as ExecuteApiErrorResponse, V as ExecuteApiResponse, P as ExecuteApiSuccessResponse, X as ExecuteSessionApiResponse, W as ExecuteSessionApiSuccessResponse, L as ExecuteSessionSpend, K as ExecuteSessionStatus, M as McpTool, E as McpToolMeta, F as McpToolRateLimitHints, ac as QueryApiResponse, ab as QueryApiSuccessResponse, aq as QueryAssumptionMetadata, Z as QueryAttemptForkReason, _ as QueryAttemptReference, ap as QueryCapabilityMissPayload, an as QueryClarificationOption, am as QueryClarificationPayload, ao as QueryClarificationPolicy, a5 as QueryCompletenessRepairEvent, a4 as QueryCost, Y as QueryDeepMode, Q as QueryDeveloperTrace, a6 as QueryDeveloperTraceDiagnostics, aa as QueryDeveloperTraceLoopInfo, a8 as QueryDeveloperTraceStep, a7 as QueryDeveloperTraceSummary, a9 as QueryDeveloperTraceToolRef, $ as QueryForkReference, ar as QueryOutcomeType, a2 as QuerySessionState, ag as QueryStreamDeveloperTraceEvent, ah as QueryStreamDoneEvent, ai as QueryStreamErrorEvent, af as QueryStreamTextDeltaEvent, ae as QueryStreamToolStatusEvent, a3 as QueryToolUsage, G as SearchResponse, as as ToolCategory } from '../types-DRbq-FA6.js';
+
+/**
+ * Developer resource for managing tool listings on the Context Protocol marketplace.
+ *
+ * Scoped to contributor/developer concerns (listing management), separate from
+ * the consumer-facing `tools.execute()` and `query.run()`.
+ */
+declare class Developer {
+    private client;
+    constructor(client: ContextClient);
+    /**
+     * Update a tool listing's metadata (name, description, category).
+     *
+     * Requires an API key belonging to the tool's owner.
+     *
+     * @param toolId - The UUID of the tool to update
+     * @param updates - Fields to update (at least one required)
+     * @returns The updated tool metadata
+     *
+     * @throws {ContextError} If authentication fails or the caller does not own the tool
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.developer.updateTool("tool-uuid", {
+     *   description: "Updated description with better showcase prompts",
+     *   category: "crypto",
+     * });
+     * console.log(updated.updatedAt);
+     * ```
+     */
+    updateTool(toolId: string, updates: UpdateToolOptions): Promise<UpdateToolResult>;
+}
 
 /**
  * Discovery resource for searching and finding tools on the Context Protocol marketplace
@@ -211,6 +243,10 @@ declare class ContextClient {
     private readonly requestTimeoutMs;
     private readonly streamTimeoutMs;
     private _closed;
+    /**
+     * Developer resource for managing tool listings (contributor/developer concerns).
+     */
+    readonly developer: Developer;
     /**
      * Discovery resource for searching tools
      */
@@ -261,4 +297,4 @@ declare class ContextClient {
     _fetchRaw(endpoint: string, options?: RequestInit): Promise<Response>;
 }
 
-export { ContextClient, ContextClientOptions, Discovery, ExecuteOptions, ExecuteSessionResult, ExecuteSessionStartOptions, ExecutionResult, Query, QueryOptions, QueryResult, QueryStreamEvent, SearchOptions, Tool, Tools };
+export { ContextClient, ContextClientOptions, Developer, Discovery, ExecuteOptions, ExecuteSessionResult, ExecuteSessionStartOptions, ExecutionResult, Query, QueryOptions, QueryResult, QueryStreamEvent, SearchOptions, Tool, Tools, UpdateToolOptions, UpdateToolResult };

package/dist/client/index.js

@@ -1,4 +1,16 @@
 // src/client/types.ts
+var ALLOWED_TOOL_CATEGORIES = [
+  "Crypto & DeFi",
+  "Financial Markets",
+  "Business & Sales",
+  "Marketing & SEO",
+  "Legal & Regulatory",
+  "Real World",
+  "Developer Tools",
+  "Research & Academia",
+  "Utility",
+  "Other"
+];
 var ContextError = class _ContextError extends Error {
   constructor(message, code, statusCode, helpUrl) {
     super(message);
@@ -10,6 +22,57 @@ var ContextError = class _ContextError extends Error {
   }
 };
 
+// src/client/resources/developer.ts
+var Developer = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Update a tool listing's metadata (name, description, category).
+   *
+   * Requires an API key belonging to the tool's owner.
+   *
+   * @param toolId - The UUID of the tool to update
+   * @param updates - Fields to update (at least one required)
+   * @returns The updated tool metadata
+   *
+   * @throws {ContextError} If authentication fails or the caller does not own the tool
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.developer.updateTool("tool-uuid", {
+   *   description: "Updated description with better showcase prompts",
+   *   category: "crypto",
+   * });
+   * console.log(updated.updatedAt);
+   * ```
+   */
+  async updateTool(toolId, updates) {
+    if (!toolId) {
+      throw new ContextError("toolId is required");
+    }
+    if (updates.name === void 0 && updates.description === void 0 && updates.category === void 0) {
+      throw new ContextError(
+        "At least one field required: name, description, or category"
+      );
+    }
+    if (updates.category !== void 0 && updates.category !== null && !ALLOWED_TOOL_CATEGORIES.includes(updates.category)) {
+      throw new ContextError(
+        `category must be one of: ${ALLOWED_TOOL_CATEGORIES.join(", ")}`
+      );
+    }
+    const encodedToolId = encodeURIComponent(toolId);
+    return this.client._fetch(
+      `/api/v1/tools/${encodedToolId}`,
+      {
+        method: "PATCH",
+        body: JSON.stringify(updates)
+      },
+      { retry: false }
+    );
+  }
+};
+
 // src/client/resources/discovery.ts
 var Discovery = class {
   constructor(client) {
@@ -607,6 +670,10 @@ var ContextClient = class {
   requestTimeoutMs;
   streamTimeoutMs;
   _closed = false;
+  /**
+   * Developer resource for managing tool listings (contributor/developer concerns).
+   */
+  developer;
   /**
    * Discovery resource for searching tools
    */
@@ -648,6 +715,7 @@ var ContextClient = class {
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
     this.requestTimeoutMs = requestTimeoutMs;
     this.streamTimeoutMs = streamTimeoutMs;
+    this.developer = new Developer(this);
     this.discovery = new Discovery(this);
     this.tools = new Tools(this);
     this.query = new Query(this);
@@ -806,6 +874,6 @@ var ContextClient = class {
   }
 };
 
-export { ContextClient, ContextError, Discovery, Query, Tools };
+export { ALLOWED_TOOL_CATEGORIES, ContextClient, ContextError, Developer, Discovery, Query, Tools };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map