@tickernelz/paperclip-pro-mcp-server 2026.925.0 → 2026.925.2

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.
@@ -0,0 +1,198 @@
1
+ import { beforeEach, describe, expect, it, vi } from "vitest";
2
+ import { PaperclipApiClient } from "./client.js";
3
+ import { hasManagementAuthority, resolveToolsets } from "./config.js";
4
+ import { createGeneratedToolDefinitions, generatedToolSpecs } from "./generated-tools.js";
5
+ import { createToolDefinitions } from "./tools.js";
6
+ import { paperclipToolCatalog } from "./catalog.js";
7
+ import { resolveManagementAuthority } from "./index.js";
8
+ import { CURATED_OPERATIONS } from "./tool-overrides.js";
9
+ function makeClient() {
10
+ return new PaperclipApiClient({
11
+ apiUrl: "http://localhost:3100/api",
12
+ apiKey: "token-123",
13
+ companyId: "11111111-1111-1111-1111-111111111111",
14
+ agentId: "22222222-2222-2222-2222-222222222222",
15
+ runId: "33333333-3333-3333-3333-333333333333",
16
+ toolsets: ["core", "extended"],
17
+ agentRole: null,
18
+ });
19
+ }
20
+ function getTool(name) {
21
+ const tool = createGeneratedToolDefinitions(makeClient(), ["core", "extended"], true).find((candidate) => candidate.name === name);
22
+ if (!tool)
23
+ throw new Error(`Missing generated tool ${name}`);
24
+ return tool;
25
+ }
26
+ function mockJsonResponse(body, status = 200) {
27
+ return new Response(JSON.stringify(body), {
28
+ status,
29
+ headers: { "Content-Type": "application/json" },
30
+ });
31
+ }
32
+ describe("generated Paperclip API tools", () => {
33
+ beforeEach(() => {
34
+ vi.restoreAllMocks();
35
+ });
36
+ it("fills the company id from config when the route is company scoped", async () => {
37
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse([{ id: "label-1" }]));
38
+ vi.stubGlobal("fetch", fetchMock);
39
+ await getTool("paperclipListLabels").execute({});
40
+ const [url, init] = fetchMock.mock.calls[0];
41
+ expect(String(url)).toBe("http://localhost:3100/api/companies/11111111-1111-1111-1111-111111111111/labels");
42
+ expect(init.method).toBe("GET");
43
+ expect(init.body).toBeUndefined();
44
+ });
45
+ it("prefers an explicit company id over the configured default", async () => {
46
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse([]));
47
+ vi.stubGlobal("fetch", fetchMock);
48
+ await getTool("paperclipListLabels").execute({
49
+ companyId: "44444444-4444-4444-4444-444444444444",
50
+ });
51
+ const [url] = fetchMock.mock.calls[0];
52
+ expect(String(url)).toBe("http://localhost:3100/api/companies/44444444-4444-4444-4444-444444444444/labels");
53
+ });
54
+ it("sends path and query parameters in the right places", async () => {
55
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse([]));
56
+ vi.stubGlobal("fetch", fetchMock);
57
+ await getTool("paperclipListIssueWorkProducts").execute({
58
+ id: "PAP-1135",
59
+ refreshPullRequests: "true",
60
+ });
61
+ const [url] = fetchMock.mock.calls[0];
62
+ expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135/work-products?refreshPullRequests=true");
63
+ });
64
+ it("merges documented body properties into the request body", async () => {
65
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "goal-1" }));
66
+ vi.stubGlobal("fetch", fetchMock);
67
+ await getTool("paperclipUpdateGoal").execute({ id: "55555555-5555-5555-5555-555555555555", title: "Ship it" });
68
+ const [url, init] = fetchMock.mock.calls[0];
69
+ expect(String(url)).toBe("http://localhost:3100/api/goals/55555555-5555-5555-5555-555555555555");
70
+ expect(init.method).toBe("PATCH");
71
+ expect(JSON.parse(String(init.body))).toEqual({ title: "Ship it" });
72
+ expect(init.headers["X-Paperclip-Run-Id"]).toBe("33333333-3333-3333-3333-333333333333");
73
+ });
74
+ it("passes an undocumented body through the body property", async () => {
75
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "child-1" }));
76
+ vi.stubGlobal("fetch", fetchMock);
77
+ await getTool("paperclipCreateChildIssue").execute({
78
+ id: "PAP-1135",
79
+ body: { title: "Child", assigneeAgentId: null },
80
+ });
81
+ const [url, init] = fetchMock.mock.calls[0];
82
+ expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135/children");
83
+ expect(JSON.parse(String(init.body))).toEqual({ title: "Child", assigneeAgentId: null });
84
+ });
85
+ it("reports a failed request instead of throwing", async () => {
86
+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(mockJsonResponse({ error: "nope" }, 403)));
87
+ const response = await getTool("paperclipListLabels").execute({});
88
+ expect(response.content[0]?.text).toContain("403");
89
+ });
90
+ it("marks deletions destructive and reads read-only", () => {
91
+ expect(getTool("paperclipDeleteIssue").annotations).toEqual({
92
+ readOnlyHint: false,
93
+ destructiveHint: true,
94
+ idempotentHint: true,
95
+ });
96
+ expect(getTool("paperclipListLabels").annotations).toEqual({
97
+ readOnlyHint: true,
98
+ destructiveHint: false,
99
+ idempotentHint: true,
100
+ });
101
+ });
102
+ it("registers only the selected toolsets", () => {
103
+ const core = createGeneratedToolDefinitions(makeClient(), ["core"]).map((tool) => tool.name);
104
+ expect(core).toContain("paperclipListLabels");
105
+ expect(core).not.toContain("paperclipDeleteIssue");
106
+ expect(core.length).toBeLessThan(createGeneratedToolDefinitions(makeClient(), ["core", "extended"], true).length);
107
+ });
108
+ it("hides board-authority tools unless the caller has management authority", () => {
109
+ const withoutManagement = createGeneratedToolDefinitions(makeClient(), ["core", "extended"]);
110
+ const withManagement = createGeneratedToolDefinitions(makeClient(), ["core", "extended"], true);
111
+ const boardOnly = generatedToolSpecs().filter((spec) => spec.authority === "board");
112
+ expect(boardOnly.length).toBeGreaterThan(0);
113
+ expect(withManagement.length - withoutManagement.length).toBe(boardOnly.length);
114
+ expect(withoutManagement.map((tool) => tool.name)).not.toContain(boardOnly[0].name);
115
+ expect(boardOnly.every((spec) => spec.authoritySource === "handler" || spec.authoritySource === "probe"
116
+ ? spec.boardGuard !== null
117
+ : spec.authoritySource === "registry")).toBe(true);
118
+ });
119
+ it("treats only management roles as board authority", () => {
120
+ expect(hasManagementAuthority("ceo")).toBe(true);
121
+ expect(hasManagementAuthority("CEO")).toBe(true);
122
+ expect(hasManagementAuthority("engineer")).toBe(false);
123
+ expect(hasManagementAuthority(null)).toBe(false);
124
+ });
125
+ it("reads management authority from the server capabilities, not the role name", async () => {
126
+ const client = makeClient();
127
+ const config = {
128
+ apiUrl: "http://localhost:3100/api",
129
+ apiKey: "token-123",
130
+ companyId: null,
131
+ agentId: null,
132
+ runId: null,
133
+ toolsets: ["core"],
134
+ agentRole: "engineer",
135
+ };
136
+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(mockJsonResponse({ role: "engineer", authorityCapabilities: ["work:read", "company:agents"] })));
137
+ await expect(resolveManagementAuthority(client, { ...config, toolsets: ["core"] })).resolves.toBe(true);
138
+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(mockJsonResponse({ role: "engineer", authorityCapabilities: ["work:read"] })));
139
+ await expect(resolveManagementAuthority(client, { ...config, toolsets: ["core"] })).resolves.toBe(false);
140
+ });
141
+ it("defaults to the core toolset and honours explicit selection", () => {
142
+ expect(resolveToolsets({}, [])).toEqual(["core"]);
143
+ expect(resolveToolsets({ PAPERCLIP_MCP_TOOLSETS: "core,extended" }, [])).toEqual([
144
+ "core",
145
+ "extended",
146
+ ]);
147
+ expect(resolveToolsets({ PAPERCLIP_MCP_TOOLSETS: "core" }, ["--toolsets", "all"])).toEqual([
148
+ "core",
149
+ "extended",
150
+ ]);
151
+ expect(resolveToolsets({ PAPERCLIP_MCP_TOOLSETS: "nonsense" }, [])).toEqual(["core"]);
152
+ });
153
+ it("never collides with a curated tool name or repeats a route", () => {
154
+ const curated = createToolDefinitions(makeClient()).map((tool) => tool.name);
155
+ const generated = generatedToolSpecs();
156
+ const names = generated.map((spec) => spec.name);
157
+ expect(new Set(names).size).toBe(names.length);
158
+ expect(names.filter((name) => curated.includes(name))).toEqual([]);
159
+ expect(generated.filter((spec) => CURATED_OPERATIONS[spec.operationId] !== undefined)).toEqual([]);
160
+ });
161
+ it("builds a usable input schema for every generated tool", () => {
162
+ const tools = createGeneratedToolDefinitions(makeClient(), ["core", "extended"], true);
163
+ expect(tools.length).toBe(generatedToolSpecs().length);
164
+ for (const tool of tools) {
165
+ expect(Object.keys(tool.schema.shape).length).toBeGreaterThanOrEqual(0);
166
+ }
167
+ });
168
+ it("merges advanced fields into a narrowed generated body", async () => {
169
+ const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "project-1" }));
170
+ vi.stubGlobal("fetch", fetchMock);
171
+ const tool = getTool("paperclipUpdateProject");
172
+ expect(Object.keys(tool.schema.shape)).toContain("advanced");
173
+ expect(Object.keys(tool.schema.shape)).not.toContain("executionWorkspacePolicy");
174
+ await tool.execute({
175
+ id: "66666666-6666-6666-6666-666666666666",
176
+ name: "Platform",
177
+ advanced: { executionWorkspacePolicy: { mode: "shared" } },
178
+ });
179
+ const [, init] = fetchMock.mock.calls[0];
180
+ expect(JSON.parse(String(init.body))).toEqual({
181
+ name: "Platform",
182
+ executionWorkspacePolicy: { mode: "shared" },
183
+ });
184
+ });
185
+ it("lists core tools without JSON Schema validation metadata", () => {
186
+ const { listing } = paperclipToolCatalog(makeClient(), ["core"], false);
187
+ const serialized = JSON.stringify(listing.tools);
188
+ expect(serialized).not.toContain('"$schema":');
189
+ expect(Buffer.byteLength(serialized)).toBeLessThan(48_000);
190
+ const updateIssue = listing.tools.find((tool) => tool.name === "paperclipUpdateIssue");
191
+ expect(updateIssue?.inputSchema.required).toEqual(["issueId"]);
192
+ const properties = updateIssue?.inputSchema.properties;
193
+ expect(properties.issueId).toEqual({ type: "string" });
194
+ expect(properties.advanced).toMatchObject({ type: "object" });
195
+ expect(properties.executionPolicy).toBeUndefined();
196
+ });
197
+ });
198
+ //# sourceMappingURL=generated-tools.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generated-tools.test.js","sourceRoot":"","sources":["../src/generated-tools.test.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { PaperclipApiClient } from "./client.js";
3
3
  import { type PaperclipMcpConfig } from "./config.js";
4
- export declare function createPaperclipMcpServer(config?: PaperclipMcpConfig): {
4
+ export declare function resolveManagementAuthority(client: PaperclipApiClient, config: PaperclipMcpConfig): Promise<boolean>;
5
+ export declare function createPaperclipMcpServer(config?: PaperclipMcpConfig, management?: boolean): {
5
6
  server: McpServer;
6
7
  tools: import("./tools.js").ToolDefinition[];
7
8
  client: PaperclipApiClient;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGzE,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,kBAAwC;;;;EAiBxF;AAED,wBAAsB,SAAS,CAAC,MAAM,GAAE,kBAAwC,iBAI/E"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAA6C,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjG,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,kBAAwC,EAChD,UAAU,UAAQ;;;;EA2BnB;AAED,wBAAsB,SAAS,CAAC,MAAM,GAAE,kBAAwC,iBAK/E"}
package/dist/index.js CHANGED
@@ -1,18 +1,36 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
+ import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
4
+ import { paperclipToolCatalog } from "./catalog.js";
3
5
  import { PaperclipApiClient } from "./client.js";
4
- import { readConfigFromEnv } from "./config.js";
5
- import { createToolDefinitions } from "./tools.js";
6
- export function createPaperclipMcpServer(config = readConfigFromEnv()) {
6
+ import { hasManagementAuthority, readConfigFromEnv } from "./config.js";
7
+ export async function resolveManagementAuthority(client, config) {
8
+ try {
9
+ const actor = await client.requestJson("GET", "/agents/me");
10
+ if (Array.isArray(actor?.authorityCapabilities)) {
11
+ return actor.authorityCapabilities.some((capability) => typeof capability === "string" && capability.startsWith("company:"));
12
+ }
13
+ return hasManagementAuthority(typeof actor?.role === "string" ? actor.role : null);
14
+ }
15
+ catch {
16
+ return hasManagementAuthority(config.agentRole);
17
+ }
18
+ }
19
+ export function createPaperclipMcpServer(config = readConfigFromEnv(), management = false) {
7
20
  const server = new McpServer({
8
21
  name: "paperclip",
9
22
  version: "0.1.0",
10
23
  });
11
24
  const client = new PaperclipApiClient(config);
12
- const tools = createToolDefinitions(client);
25
+ const { definitions: tools, listing } = paperclipToolCatalog(client, config.toolsets, management);
13
26
  for (const tool of tools) {
14
- server.tool(tool.name, tool.description, tool.schema.shape, tool.execute);
27
+ server.registerTool(tool.name, {
28
+ description: tool.description,
29
+ inputSchema: tool.schema.shape,
30
+ ...(tool.annotations ? { annotations: tool.annotations } : {}),
31
+ }, tool.execute);
15
32
  }
33
+ server.server.setRequestHandler(ListToolsRequestSchema, () => listing);
16
34
  return {
17
35
  server,
18
36
  tools,
@@ -20,7 +38,8 @@ export function createPaperclipMcpServer(config = readConfigFromEnv()) {
20
38
  };
21
39
  }
22
40
  export async function runServer(config = readConfigFromEnv()) {
23
- const { server } = createPaperclipMcpServer(config);
41
+ const management = await resolveManagementAuthority(new PaperclipApiClient(config), config);
42
+ const { server } = createPaperclipMcpServer(config, management);
24
43
  const transport = new StdioServerTransport();
25
44
  await server.connect(transport);
26
45
  }
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,wBAAwB,CAAC,MAAM,GAAuB,iBAAiB,EAAE;IACvF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAM,GAAuB,iBAAiB,EAAE;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AAEjG,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAA0B,EAC1B,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CACpC,KAAK,EACL,YAAY,CACb,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC,qBAAqB,CAAC,IAAI,CACrC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,sBAAsB,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAM,GAAuB,iBAAiB,EAAE,EAChD,UAAU,GAAG,KAAK;IAElB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YAC9B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,EACD,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IAEvE,OAAO;QACL,MAAM;QACN,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAM,GAAuB,iBAAiB,EAAE;IAC9E,MAAM,UAAU,GAAG,MAAM,0BAA0B,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5F,MAAM,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
@@ -0,0 +1,3 @@
1
+ export type JsonSchemaObject = Record<string, unknown>;
2
+ export declare function leanJsonSchema(schema: unknown): unknown;
3
+ //# sourceMappingURL=lean-schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lean-schema.d.ts","sourceRoot":"","sources":["../src/lean-schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4DvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CA6CvD"}
@@ -0,0 +1,94 @@
1
+ const DROPPED_KEYWORDS = {
2
+ $schema: true,
3
+ contentEncoding: true,
4
+ contentMediaType: true,
5
+ default: true,
6
+ example: true,
7
+ examples: true,
8
+ exclusiveMaximum: true,
9
+ exclusiveMinimum: true,
10
+ format: true,
11
+ maxItems: true,
12
+ maxLength: true,
13
+ maxProperties: true,
14
+ maximum: true,
15
+ minItems: true,
16
+ minLength: true,
17
+ minProperties: true,
18
+ minimum: true,
19
+ multipleOf: true,
20
+ pattern: true,
21
+ propertyNames: true,
22
+ readOnly: true,
23
+ uniqueItems: true,
24
+ writeOnly: true,
25
+ };
26
+ const SCHEMA_MAP_KEYWORDS = {
27
+ $defs: true,
28
+ definitions: true,
29
+ patternProperties: true,
30
+ properties: true,
31
+ };
32
+ const SCHEMA_LIST_KEYWORDS = {
33
+ allOf: true,
34
+ anyOf: true,
35
+ oneOf: true,
36
+ prefixItems: true,
37
+ };
38
+ const NESTED_SCHEMA_KEYWORDS = {
39
+ additionalProperties: true,
40
+ else: true,
41
+ if: true,
42
+ items: true,
43
+ not: true,
44
+ then: true,
45
+ };
46
+ function isNullBranch(value) {
47
+ return (typeof value === "object" &&
48
+ value !== null &&
49
+ Object.keys(value).length === 1 &&
50
+ value.type === "null");
51
+ }
52
+ export function leanJsonSchema(schema) {
53
+ if (Array.isArray(schema))
54
+ return schema.map((entry) => leanJsonSchema(entry));
55
+ if (typeof schema !== "object" || schema === null)
56
+ return schema;
57
+ const result = {};
58
+ for (const [key, value] of Object.entries(schema)) {
59
+ if (DROPPED_KEYWORDS[key])
60
+ continue;
61
+ if (key === "additionalProperties" &&
62
+ (value === false ||
63
+ (typeof value === "object" && value !== null && Object.keys(value).length === 0))) {
64
+ continue;
65
+ }
66
+ if (SCHEMA_MAP_KEYWORDS[key] && typeof value === "object" && value !== null) {
67
+ result[key] = Object.fromEntries(Object.entries(value).map(([name, entry]) => [
68
+ name,
69
+ leanJsonSchema(entry),
70
+ ]));
71
+ continue;
72
+ }
73
+ if (SCHEMA_LIST_KEYWORDS[key] && Array.isArray(value)) {
74
+ result[key] = value.map((entry) => leanJsonSchema(entry));
75
+ continue;
76
+ }
77
+ if (NESTED_SCHEMA_KEYWORDS[key]) {
78
+ result[key] = leanJsonSchema(value);
79
+ continue;
80
+ }
81
+ result[key] = value;
82
+ }
83
+ const branches = result.anyOf ?? result.oneOf;
84
+ if (Array.isArray(branches) && branches.length === 2 && branches.some(isNullBranch)) {
85
+ const alternative = branches.find((entry) => !isNullBranch(entry));
86
+ if (alternative && typeof alternative === "object") {
87
+ delete result.anyOf;
88
+ delete result.oneOf;
89
+ return { ...alternative, ...result };
90
+ }
91
+ }
92
+ return result;
93
+ }
94
+ //# sourceMappingURL=lean-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lean-schema.js","sourceRoot":"","sources":["../src/lean-schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ export type ToolsetName = "core" | "extended";
2
+ export interface ToolAnnotationOverride {
3
+ readOnlyHint?: boolean;
4
+ destructiveHint?: boolean;
5
+ idempotentHint?: boolean;
6
+ }
7
+ export interface ToolOverride {
8
+ name?: string;
9
+ description?: string;
10
+ toolset?: ToolsetName;
11
+ annotations?: ToolAnnotationOverride;
12
+ requiredHint?: string;
13
+ bodyFields?: string[];
14
+ }
15
+ export declare const CURATED_OPERATIONS: Record<string, string>;
16
+ export declare const EXCLUDED_OPERATIONS: Record<string, string>;
17
+ export declare const PROBE_BOARD_DENIED_OPERATIONS: Record<string, string>;
18
+ export declare const TOOL_OVERRIDES: Record<string, ToolOverride>;
19
+ //# sourceMappingURL=tool-overrides.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-overrides.d.ts","sourceRoot":"","sources":["../src/tool-overrides.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0CrD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAatD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoBhE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2JvD,CAAC"}