@githits/mcp 0.11.0 → 0.11.1

package/dist/tools.d.ts

@@ -0,0 +1,144 @@
+import { z } from "zod";
+/** Annotation fields required by OpenAI's MCP marketplace validation. */
+interface CompleteToolAnnotations {
+	title?: string;
+	readOnlyHint: boolean;
+	idempotentHint?: boolean;
+	openWorldHint: boolean;
+	destructiveHint: boolean;
+}
+interface McpAuthActionContext {
+	authSource: unknown;
+	defaultAction: string;
+}
+type McpAuthAction = string | ((context: McpAuthActionContext) => string);
+/** Host-selected message and action for terms-acceptance failures. */
+interface ToolTermsRemediation {
+	message: string;
+	action: string;
+}
+/** Host-provided execution state shared by MCP and direct tool callers. */
+interface ToolExecutionContext {
+	authAction?: McpAuthAction;
+	termsRemediation?: ToolTermsRemediation;
+	signal?: AbortSignal;
+}
+/**
+* Standard result type for all MCP tools
+*/
+type ToolResult = {
+	content: Array<{
+		type: "text";
+		text: string;
+	}>;
+	isError?: boolean;
+};
+/** Transport-neutral callable tool handler receiving optional execution context. */
+type ToolHandler<TArgs> = (args: TArgs, context?: ToolExecutionContext) => Promise<ToolResult>;
+/**
+* Zod raw shape type (what MCP SDK expects)
+*/
+type ZodRawShape = {
+	[k: string]: z.ZodTypeAny;
+};
+/**
+* Tool definition with metadata and handler
+*/
+interface ToolDefinition<
+	TArgs,
+	TSchema extends ZodRawShape = ZodRawShape
+> {
+	name: string;
+	description: string;
+	schema: TSchema;
+	annotations: CompleteToolAnnotations;
+	handler: ToolHandler<TArgs>;
+}
+/** Browser-standard options supplied to a callable tool execution. */
+interface CallableToolExecutionOptions {
+	signal?: AbortSignal;
+}
+/** JSON Schema emitted for a callable tool's input. */
+type CallableToolInputSchema = Record<string, unknown>;
+/** Transport-neutral callable representation of a tool definition. */
+interface CallableTool {
+	name: string;
+	description: string;
+	inputSchema: CallableToolInputSchema;
+	annotations: CompleteToolAnnotations;
+	execute(input: unknown, options?: CallableToolExecutionOptions): Promise<ToolResult>;
+}
+/**
+* Adapt a Zod-backed tool definition to a browser-callable surface.
+*
+* Input is validated and defaulted before the original handler is invoked;
+* only the optional abort signal crosses the callable execution boundary.
+*/
+declare function toCallableTool<
+	TArgs,
+	TSchema extends ZodRawShape
+>(definition: ToolDefinition<TArgs, TSchema>): CallableTool;
+interface GetExampleInput {
+	query: string;
+	language?: string;
+	license_mode?: "strict" | "yolo" | "custom";
+	format?: "json" | "text" | "text-v1";
+}
+/** Search parameters required by the browser-callable example tool. */
+interface GetExampleSearchParams {
+	query: string;
+	language?: string;
+	licenseMode?: "strict" | "yolo" | "custom";
+	includeExplanation?: boolean;
+}
+/** Browser-standard request controls for example search. */
+interface GetExampleRequestOptions {
+	signal?: AbortSignal;
+}
+/** Minimal injected service contract used by the example tool. */
+interface GetExampleService {
+	search(params: GetExampleSearchParams, options?: GetExampleRequestOptions): Promise<string>;
+}
+declare const schema: ZodRawShape;
+declare function createGetExampleTool(service: GetExampleService): ToolDefinition<GetExampleInput, typeof schema>;
+interface AuthenticationErrorInstance extends Error {
+	readonly source: "local" | "server";
+}
+interface AuthenticationErrorConstructor {
+	new (message?: string, source?: "local" | "server"): AuthenticationErrorInstance;
+}
+interface ApiRateLimitErrorInstance extends Error {
+	readonly status: 429;
+	readonly retryAfterSeconds: number | undefined;
+}
+interface ApiRateLimitErrorConstructor {
+	new (message?: string, retryAfterSeconds?: number): ApiRateLimitErrorInstance;
+}
+interface FetchTimeoutErrorInstance extends Error {
+	readonly timeoutMs: number;
+}
+interface FetchTimeoutErrorConstructor {
+	new (timeoutMs: number, options?: {
+		cause?: unknown;
+	}): FetchTimeoutErrorInstance;
+}
+interface TermsAcceptanceRequiredErrorInstance extends Error {
+	readonly code: "TERMS_ACCEPTANCE_REQUIRED";
+	readonly termsUrl: string;
+	readonly acceptanceUrl: string;
+}
+interface TermsAcceptanceRequiredErrorConstructor {
+	new (remediation?: {
+		termsUrl?: string;
+		acceptanceUrl?: string;
+	}): TermsAcceptanceRequiredErrorInstance;
+}
+/** Authentication failure raised by a GitHits service. */
+declare const AuthenticationError: AuthenticationErrorConstructor;
+/** Rate-limit failure raised by a GitHits service. */
+declare const ApiRateLimitError: ApiRateLimitErrorConstructor;
+/** Request deadline failure raised by a GitHits service. */
+declare const FetchTimeoutError: FetchTimeoutErrorConstructor;
+/** Terms gate raised by a GitHits service. */
+declare const TermsAcceptanceRequiredError: TermsAcceptanceRequiredErrorConstructor;
+export { ApiRateLimitError, AuthenticationError, CallableTool, CallableToolExecutionOptions, CallableToolInputSchema, CompleteToolAnnotations, FetchTimeoutError, GetExampleInput, GetExampleRequestOptions, GetExampleSearchParams, GetExampleService, TermsAcceptanceRequiredError, ToolResult, createGetExampleTool, toCallableTool };

package/dist/tools.js

@@ -0,0 +1 @@
+import{createGetExampleTool}from"./shared/chunk-62ejtp2e.js";import{ApiRateLimitError,AuthenticationError,FetchTimeoutError,TermsAcceptanceRequiredError}from"./shared/chunk-51x6tx02.js";import{z}from"zod";function toCallableTool(definition){const input=z.object(definition.schema);const inputSchema=z.toJSONSchema(input,{io:"input"});return{name:definition.name,description:definition.description,inputSchema,annotations:definition.annotations,execute:async(value,options)=>{const args=input.parse(value);const context={authAction:"Authenticate with GitHits, then retry.",...options?.signal?{signal:options.signal}:{}};return definition.handler(args,context)}}}var AuthenticationError2=AuthenticationError;var ApiRateLimitError2=ApiRateLimitError;var FetchTimeoutError2=FetchTimeoutError;var TermsAcceptanceRequiredError2=TermsAcceptanceRequiredError;export{ApiRateLimitError2 as ApiRateLimitError,AuthenticationError2 as AuthenticationError,FetchTimeoutError2 as FetchTimeoutError,TermsAcceptanceRequiredError2 as TermsAcceptanceRequiredError,createGetExampleTool,toCallableTool};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githits/mcp",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Reusable MCP server APIs and tools for GitHits",
   "type": "module",
   "files": [
@@ -29,6 +29,12 @@
         "default": "./dist/smoke-test.js"
       }
     },
+    "./tools": {
+      "import": {
+        "types": "./dist/tools.d.ts",
+        "default": "./dist/tools.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "scripts": {