@zackbart/connecta 0.1.0

package/dist/meta-tools.d.ts

@@ -0,0 +1,100 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ActivityRequestContext } from "./activity.js";
+import type { Registry } from "./registry.js";
+interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ToolResult {
+    content: TextContent[];
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+    [x: string]: unknown;
+}
+export declare function jsonResult(obj: unknown): ToolResult;
+export declare function errorResult(message: string): ToolResult;
+export interface SearchArgs {
+    query?: string;
+    connector?: string;
+    limit?: number;
+    offset?: number;
+    fullDescriptions?: boolean;
+    includeSchemas?: "compact" | "json";
+}
+export interface DescribeArgs {
+    addresses: string[];
+    format?: "compact" | "json";
+    fullDescriptions?: boolean;
+}
+export interface ListArgs {
+    /** When false, return cached/observed health without downstream I/O. */
+    probe?: boolean;
+}
+export type ResultMode = "mcp" | "value";
+export interface CallArgs {
+    address: string;
+    args?: Record<string, unknown>;
+    fields?: string[];
+    resultMode?: ResultMode;
+    timeoutMs?: number;
+    /** Retries after the first attempt; honored only for safely annotated tools. */
+    maxRetries?: number;
+    /** Include connector/catalog/result-processing timing segments. */
+    diagnostics?: boolean;
+}
+export interface GetResultArgs {
+    id: string;
+    offset?: number;
+    maxBytes?: number;
+}
+export interface BatchCall {
+    address: string;
+    args?: Record<string, unknown>;
+    fields?: string[];
+    resultMode?: ResultMode;
+    timeoutMs?: number;
+    maxRetries?: number;
+    diagnostics?: boolean;
+}
+export interface BatchArgs {
+    calls: BatchCall[];
+    resultMode?: ResultMode;
+    timeoutMs?: number;
+    maxRetries?: number;
+    diagnostics?: boolean;
+}
+export interface AuthorizeArgs {
+    connector: string;
+    force?: boolean;
+}
+export interface SkillArgs {
+    name?: string;
+}
+/**
+ * The nine meta-tool handlers over a registry. Exported for direct testing;
+ * registerMetaTools() wires them onto an McpServer. `opts.maxResultBytes`
+ * overrides the registry's default result-size cap. (execute_code, the optional
+ * tenth tool, is registered separately by registerExecuteTool.)
+ */
+export declare function createMetaTools(registry: Registry, baseUrl: string, opts?: {
+    maxResultBytes?: number;
+    activity?: ActivityRequestContext;
+}): {
+    skills(args?: SkillArgs): Promise<ToolResult>;
+    listConnectors(args?: ListArgs): Promise<ToolResult>;
+    searchTools(args: SearchArgs): Promise<ToolResult>;
+    describeTools(args: DescribeArgs): Promise<ToolResult>;
+    callTool(args: CallArgs): Promise<ToolResult>;
+    callDestructiveTool(args: CallArgs): Promise<ToolResult>;
+    getResult(args: GetResultArgs): Promise<ToolResult>;
+    batchCall(args: BatchArgs): Promise<ToolResult>;
+    authorizeConnector(args: AuthorizeArgs): Promise<ToolResult>;
+};
+/** Register the nine meta-tools onto an McpServer instance. */
+export declare function registerMetaTools(server: McpServer, registry: Registry, ctx: {
+    baseUrl: string;
+    maxResultBytes?: number;
+    activity?: ActivityRequestContext;
+}): void;
+export {};
+//# sourceMappingURL=meta-tools.d.ts.map

package/dist/meta-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.d.ts","sourceRoot":"","sources":["../src/meta-tools.ts"],"names":[],"mappings":"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"}