@frontmcp/plugin-skilled-openapi 0.0.1

package/tools/operation-tool.factory.d.ts

@@ -0,0 +1,60 @@
+import { type FrontMcpLogger, type ProviderRegistry, type ToolRegistry } from '@frontmcp/sdk';
+import { type HiddenOpEntry } from '../registry/hidden-op.registry';
+/**
+ * Compute the registered tool name for an OpenAPI operation.
+ * Format: `<bundleId>.<operationId>` — bundle-namespaced so multiple bundles
+ * can register operations with overlapping operationIds without collision.
+ */
+export declare function operationToolName(bundleId: string, operationId: string): string;
+export interface OperationToolFactoryDeps {
+    /** Tool registry to register/unregister synthetic operation tools. */
+    toolRegistry: ToolRegistry;
+    /** Provider registry to bind synthesized ToolInstances to. */
+    providers: ProviderRegistry;
+    /** Logger for diagnostics. */
+    logger: FrontMcpLogger;
+}
+/**
+ * Stable result envelope produced by every operation executor. Mirrors the
+ * shape returned by `execute_action.tool.ts` so call-site code (via
+ * `callTool`) can branch on `ok` uniformly regardless of which surface the
+ * operation was reached through.
+ */
+export interface OperationToolResult {
+    ok: boolean;
+    status: number;
+    data?: unknown;
+    contentType?: string;
+    error?: string;
+}
+/**
+ * Manages the lifecycle of synthetic per-operation internal tools for one
+ * Skilled OpenAPI plugin instance.
+ */
+export declare class OperationToolFactory {
+    private readonly deps;
+    /** Map (bundleId|opId) → the executor function that doubles as registry token. */
+    private registered;
+    constructor(deps: OperationToolFactoryDeps);
+    /**
+     * Register one operation as an internal tool. Idempotent — calling twice
+     * with the same `(bundleId, operationId)` is a no-op (the existing
+     * registration is left in place).
+     */
+    register(entry: HiddenOpEntry): void;
+    /**
+     * Unregister every tool this factory has registered. Used on bundle swap
+     * before re-registering the new bundle's operations.
+     */
+    unregisterAll(): void;
+    /** Number of currently-registered internal operation tools (test/audit hook). */
+    get size(): number;
+    /**
+     * Build the actual function executor for one op. Mirrors `ExecuteActionTool.execute`:
+     * authority check + input validation + `executeOperation` — so callers
+     * reaching the op via `callTool` get the same security gates as callers
+     * going through `execute_action`.
+     */
+    private makeExecutor;
+}
+//# sourceMappingURL=operation-tool.factory.d.ts.map

package/tools/operation-tool.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-tool.factory.d.ts","sourceRoot":"","sources":["../../src/tools/operation-tool.factory.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAGrB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAWpE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAS/E;AA2BD,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,YAAY,EAAE,YAAY,CAAC;IAC3B,8DAA8D;IAC9D,SAAS,EAAE,gBAAgB,CAAC;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD;;;GAGG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,kFAAkF;IAClF,OAAO,CAAC,UAAU,CAAwC;gBAE7B,IAAI,EAAE,wBAAwB;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAiBpC;;;OAGG;IACH,aAAa,IAAI,IAAI;IAYrB,iFAAiF;IACjF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CA4ErB"}

package/tools/search-skill.schema.d.ts

@@ -0,0 +1,30 @@
+export declare const searchSkillDescription = "Search the available skills by free-form query.\n\nA \"skill\" is a curated bundle of REST operations exposed to you behind a single\nnamed capability \u2014 instead of seeing each individual API endpoint, you see one\nskill that knows how to do something useful (e.g. \"billing\", \"customers\"). Use\nthis tool first to discover what skills exist for the user's request, then call\n`load_skill` to read its instructions + the actions it offers, and `execute_action`\nto actually invoke one.\n\nINPUT:\n- query: short natural-language description of what you want to do\n- limit?: max results (default 20, max 50)\n- tags?: filter to skills carrying these tags\n\nOUTPUT: { skills: Array<{ skillId, name, description, score }> }";
+export declare const searchSkillInputSchema: {
+    query: import("@frontmcp/lazy-zod").ZodString;
+    limit: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
+    tags: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
+};
+export declare const searchSkillOutputSchema: {
+    skills: import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodObject<{
+        skillId: import("@frontmcp/lazy-zod").ZodString;
+        name: import("@frontmcp/lazy-zod").ZodString;
+        description: import("@frontmcp/lazy-zod").ZodString;
+        score: import("@frontmcp/lazy-zod").ZodNumber;
+        bundleVersion: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+};
+export type SearchSkillInput = {
+    query: string;
+    limit?: number;
+    tags?: string[];
+};
+export type SearchSkillOutput = {
+    skills: Array<{
+        skillId: string;
+        name: string;
+        description: string;
+        score: number;
+        bundleVersion?: string;
+    }>;
+};
+//# sourceMappingURL=search-skill.schema.d.ts.map

package/tools/search-skill.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skill.schema.d.ts","sourceRoot":"","sources":["../../src/tools/search-skill.schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,8tBAc8B,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;CAUnC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ,CAAC"}

package/tools/search-skill.tool.d.ts

@@ -0,0 +1,6 @@
+import { ToolContext } from '@frontmcp/sdk';
+import { type SearchSkillInput, type SearchSkillOutput } from './search-skill.schema';
+export default class SearchSkillTool extends ToolContext {
+    execute(input: SearchSkillInput): Promise<SearchSkillOutput>;
+}
+//# sourceMappingURL=search-skill.tool.d.ts.map

package/tools/search-skill.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skill.tool.d.ts","sourceRoot":"","sources":["../../src/tools/search-skill.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,WAAW,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAY/B,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IAChD,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA6BnE"}