@introspection-ai/recipes 0.13.0

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.
Files changed (161) hide show
  1. package/LICENSE +191 -0
  2. package/README.md +184 -0
  3. package/dist/agent-tool.d.ts +42 -0
  4. package/dist/agent-tool.d.ts.map +1 -0
  5. package/dist/agent-tool.js +159 -0
  6. package/dist/agent-tool.js.map +1 -0
  7. package/dist/child-agent-completions.d.ts +61 -0
  8. package/dist/child-agent-completions.d.ts.map +1 -0
  9. package/dist/child-agent-completions.js +135 -0
  10. package/dist/child-agent-completions.js.map +1 -0
  11. package/dist/child-agent-store.d.ts +48 -0
  12. package/dist/child-agent-store.d.ts.map +1 -0
  13. package/dist/child-agent-store.js +98 -0
  14. package/dist/child-agent-store.js.map +1 -0
  15. package/dist/child-agent.d.ts +43 -0
  16. package/dist/child-agent.d.ts.map +1 -0
  17. package/dist/child-agent.js +268 -0
  18. package/dist/child-agent.js.map +1 -0
  19. package/dist/direct-cli.d.ts +9 -0
  20. package/dist/direct-cli.d.ts.map +1 -0
  21. package/dist/direct-cli.js +22 -0
  22. package/dist/direct-cli.js.map +1 -0
  23. package/dist/index.d.ts +14 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +14 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/inspect.d.ts +26 -0
  28. package/dist/inspect.d.ts.map +1 -0
  29. package/dist/inspect.js +70 -0
  30. package/dist/inspect.js.map +1 -0
  31. package/dist/interactions.d.ts +204 -0
  32. package/dist/interactions.d.ts.map +1 -0
  33. package/dist/interactions.js +358 -0
  34. package/dist/interactions.js.map +1 -0
  35. package/dist/mcp-catalog.d.ts +8 -0
  36. package/dist/mcp-catalog.d.ts.map +1 -0
  37. package/dist/mcp-catalog.js +60 -0
  38. package/dist/mcp-catalog.js.map +1 -0
  39. package/dist/mcp-cli-core.d.ts +79 -0
  40. package/dist/mcp-cli-core.d.ts.map +1 -0
  41. package/dist/mcp-cli-core.js +1717 -0
  42. package/dist/mcp-cli-core.js.map +1 -0
  43. package/dist/mcp-cli-help.d.ts +2 -0
  44. package/dist/mcp-cli-help.d.ts.map +1 -0
  45. package/dist/mcp-cli-help.js +36 -0
  46. package/dist/mcp-cli-help.js.map +1 -0
  47. package/dist/mcp-cli-policy.d.ts +17 -0
  48. package/dist/mcp-cli-policy.d.ts.map +1 -0
  49. package/dist/mcp-cli-policy.js +230 -0
  50. package/dist/mcp-cli-policy.js.map +1 -0
  51. package/dist/mcp-cli.d.ts +3 -0
  52. package/dist/mcp-cli.d.ts.map +1 -0
  53. package/dist/mcp-cli.js +33 -0
  54. package/dist/mcp-cli.js.map +1 -0
  55. package/dist/mcp-client.d.ts +3 -0
  56. package/dist/mcp-client.d.ts.map +1 -0
  57. package/dist/mcp-client.js +86 -0
  58. package/dist/mcp-client.js.map +1 -0
  59. package/dist/mcp-command-context.d.ts +13 -0
  60. package/dist/mcp-command-context.d.ts.map +1 -0
  61. package/dist/mcp-command-context.js +29 -0
  62. package/dist/mcp-command-context.js.map +1 -0
  63. package/dist/mcp-contract.d.ts +16 -0
  64. package/dist/mcp-contract.d.ts.map +1 -0
  65. package/dist/mcp-contract.js +306 -0
  66. package/dist/mcp-contract.js.map +1 -0
  67. package/dist/mcp-daemon-client.d.ts +10 -0
  68. package/dist/mcp-daemon-client.d.ts.map +1 -0
  69. package/dist/mcp-daemon-client.js +119 -0
  70. package/dist/mcp-daemon-client.js.map +1 -0
  71. package/dist/mcp-daemon-protocol.d.ts +64 -0
  72. package/dist/mcp-daemon-protocol.d.ts.map +1 -0
  73. package/dist/mcp-daemon-protocol.js +6 -0
  74. package/dist/mcp-daemon-protocol.js.map +1 -0
  75. package/dist/mcp-daemon.d.ts +3 -0
  76. package/dist/mcp-daemon.d.ts.map +1 -0
  77. package/dist/mcp-daemon.js +76880 -0
  78. package/dist/mcp-daemon.js.map +1 -0
  79. package/dist/mcp-run-worker.d.ts +2 -0
  80. package/dist/mcp-run-worker.d.ts.map +1 -0
  81. package/dist/mcp-run-worker.js +76579 -0
  82. package/dist/mcp-run-worker.js.map +1 -0
  83. package/dist/mcp.d.ts +168 -0
  84. package/dist/mcp.d.ts.map +1 -0
  85. package/dist/mcp.js +558 -0
  86. package/dist/mcp.js.map +1 -0
  87. package/dist/pi-extension.d.ts +30 -0
  88. package/dist/pi-extension.d.ts.map +1 -0
  89. package/dist/pi-extension.js +880 -0
  90. package/dist/pi-extension.js.map +1 -0
  91. package/dist/provider-env.d.ts +2 -0
  92. package/dist/provider-env.d.ts.map +1 -0
  93. package/dist/provider-env.js +21 -0
  94. package/dist/provider-env.js.map +1 -0
  95. package/dist/recipe/resolve.d.ts +30 -0
  96. package/dist/recipe/resolve.d.ts.map +1 -0
  97. package/dist/recipe/resolve.js +131 -0
  98. package/dist/recipe/resolve.js.map +1 -0
  99. package/dist/recipe-agent.d.ts +71 -0
  100. package/dist/recipe-agent.d.ts.map +1 -0
  101. package/dist/recipe-agent.js +555 -0
  102. package/dist/recipe-agent.js.map +1 -0
  103. package/dist/recipe-extensions.d.ts +9 -0
  104. package/dist/recipe-extensions.d.ts.map +1 -0
  105. package/dist/recipe-extensions.js +81 -0
  106. package/dist/recipe-extensions.js.map +1 -0
  107. package/dist/recipe-mcp-config.d.ts +15 -0
  108. package/dist/recipe-mcp-config.d.ts.map +1 -0
  109. package/dist/recipe-mcp-config.js +82 -0
  110. package/dist/recipe-mcp-config.js.map +1 -0
  111. package/dist/recipe-model.d.ts +49 -0
  112. package/dist/recipe-model.d.ts.map +1 -0
  113. package/dist/recipe-model.js +299 -0
  114. package/dist/recipe-model.js.map +1 -0
  115. package/dist/recipe-package.d.ts +79 -0
  116. package/dist/recipe-package.d.ts.map +1 -0
  117. package/dist/recipe-package.js +479 -0
  118. package/dist/recipe-package.js.map +1 -0
  119. package/dist/recipe-skills.d.ts +7 -0
  120. package/dist/recipe-skills.d.ts.map +1 -0
  121. package/dist/recipe-skills.js +46 -0
  122. package/dist/recipe-skills.js.map +1 -0
  123. package/dist/run-controller.d.ts +32 -0
  124. package/dist/run-controller.d.ts.map +1 -0
  125. package/dist/run-controller.js +259 -0
  126. package/dist/run-controller.js.map +1 -0
  127. package/dist/run.d.ts +28 -0
  128. package/dist/run.d.ts.map +1 -0
  129. package/dist/run.js +84 -0
  130. package/dist/run.js.map +1 -0
  131. package/dist/session.d.ts +140 -0
  132. package/dist/session.d.ts.map +1 -0
  133. package/dist/session.js +363 -0
  134. package/dist/session.js.map +1 -0
  135. package/dist/test-utils.d.ts +32 -0
  136. package/dist/test-utils.d.ts.map +1 -0
  137. package/dist/test-utils.js +259 -0
  138. package/dist/test-utils.js.map +1 -0
  139. package/dist/testing.d.ts +25 -0
  140. package/dist/testing.d.ts.map +1 -0
  141. package/dist/testing.js +96 -0
  142. package/dist/testing.js.map +1 -0
  143. package/docs/agent-composition.md +196 -0
  144. package/docs/deployment-configuration.md +65 -0
  145. package/docs/index.md +49 -0
  146. package/docs/interactions.md +210 -0
  147. package/docs/mcp-auth.md +80 -0
  148. package/docs/mcp-configuration.md +126 -0
  149. package/docs/migration.md +70 -0
  150. package/docs/pi-extension.md +97 -0
  151. package/docs/python-bindings-release.md +47 -0
  152. package/docs/recipe-evals.md +70 -0
  153. package/docs/recipe-flow.md +41 -0
  154. package/docs/recipe-format.md +186 -0
  155. package/docs/recipe-judges.md +152 -0
  156. package/docs/runtime-library.md +171 -0
  157. package/package.json +106 -0
  158. package/vendor/mcp-client/darwin-arm64/mcp-client +0 -0
  159. package/vendor/mcp-client/darwin-x64/mcp-client +0 -0
  160. package/vendor/mcp-client/linux-arm64/mcp-client +0 -0
  161. package/vendor/mcp-client/linux-x64/mcp-client +0 -0
@@ -0,0 +1,29 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ const storage = new AsyncLocalStorage();
3
+ export function currentMcpCommandContext() {
4
+ return storage.getStore();
5
+ }
6
+ export function runWithMcpCommandContext(context, task) {
7
+ return storage.run(context, task);
8
+ }
9
+ export function installMcpCommandIoRouting() {
10
+ const stdoutWrite = process.stdout.write.bind(process.stdout);
11
+ const stderrWrite = process.stderr.write.bind(process.stderr);
12
+ process.stdout.write = ((chunk, ...args) => {
13
+ const target = currentMcpCommandContext()?.stdout;
14
+ return target
15
+ ? target.write(chunk)
16
+ : stdoutWrite(chunk, ...args);
17
+ });
18
+ process.stderr.write = ((chunk, ...args) => {
19
+ const target = currentMcpCommandContext()?.stderr;
20
+ return target
21
+ ? target.write(chunk)
22
+ : stderrWrite(chunk, ...args);
23
+ });
24
+ return () => {
25
+ process.stdout.write = stdoutWrite;
26
+ process.stderr.write = stderrWrite;
27
+ };
28
+ }
29
+ //# sourceMappingURL=mcp-command-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-command-context.js","sourceRoot":"","sources":["../src/mcp-command-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAarD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAE3D,MAAM,UAAU,wBAAwB;IACtC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA0B,EAC1B,IAAsB;IAEtB,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAc,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,wBAAwB,EAAE,EAAE,MAAM,CAAC;QAClD,OAAO,MAAM;YACX,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAc,CAAC;YAC9B,CAAC,CAAC,WAAW,CAAC,KAAc,EAAE,GAAI,IAAgB,CAAC,CAAC;IACxD,CAAC,CAAgC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAc,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,wBAAwB,EAAE,EAAE,MAAM,CAAC;QAClD,OAAO,MAAM;YACX,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAc,CAAC;YAC9B,CAAC,CAAC,WAAW,CAAC,KAAc,EAAE,GAAI,IAAgB,CAAC,CAAC;IACxD,CAAC,CAAgC,CAAC;IAElC,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,WAA0C,CAAC;QAClE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,WAA0C,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,16 @@
1
+ import type { McpToolCatalogEntry } from "./mcp.js";
2
+ export declare function compactSchemaType(value: unknown): string;
3
+ export interface ContractTool {
4
+ name: string;
5
+ description?: string;
6
+ inputSchema?: unknown;
7
+ outputSchema?: unknown;
8
+ }
9
+ export declare function renderToolContract(server: string, tool: ContractTool, options?: {
10
+ verboseDescriptions?: boolean;
11
+ }): string;
12
+ export declare function renderToolSignature(server: string, tool: ContractTool, options?: {
13
+ allParameters?: boolean;
14
+ }): string;
15
+ export declare function catalogOutputSchema(tool: McpToolCatalogEntry | undefined): unknown;
16
+ //# sourceMappingURL=mcp-contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-contract.d.ts","sourceRoot":"","sources":["../src/mcp-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AA2EpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiCxD;AA2LD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,MAAM,CA6BR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,MAAM,CA4BR;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAElF"}
@@ -0,0 +1,306 @@
1
+ const MAX_EXAMPLE_ARRAY_ITEMS = 3;
2
+ const SAFE_CLI_KEY = /^[A-Za-z_][A-Za-z0-9_.-]*$/;
3
+ const SAFE_SHELL_TOKEN = /^[A-Za-z0-9_./:@+-]+$/;
4
+ function record(value) {
5
+ return value !== null && typeof value === "object" && !Array.isArray(value)
6
+ ? value
7
+ : undefined;
8
+ }
9
+ function number(value) {
10
+ return typeof value === "number" && Number.isFinite(value) ? value : undefined;
11
+ }
12
+ function quoted(value) {
13
+ return JSON.stringify(value);
14
+ }
15
+ function renderSchema(value) {
16
+ const schema = record(value);
17
+ if (!schema || !Array.isArray(schema.allOf))
18
+ return schema;
19
+ const branches = schema.allOf.map(renderSchema).filter((branch) => Boolean(branch));
20
+ const baseProperties = record(schema.properties) ?? {};
21
+ const objectLike = branches.every((branch) => branch.type === "object" || Boolean(record(branch.properties)));
22
+ if (!objectLike)
23
+ return { ...schema, allOf: branches };
24
+ const properties = Object.assign({}, baseProperties, ...branches.map((branch) => record(branch.properties) ?? {}));
25
+ const required = new Set(Array.isArray(schema.required)
26
+ ? schema.required.filter((entry) => typeof entry === "string")
27
+ : []);
28
+ for (const branch of branches) {
29
+ if (!Array.isArray(branch.required))
30
+ continue;
31
+ for (const entry of branch.required) {
32
+ if (typeof entry === "string")
33
+ required.add(entry);
34
+ }
35
+ }
36
+ const { allOf: _allOf, ...rest } = schema;
37
+ return {
38
+ ...rest,
39
+ type: "object",
40
+ properties,
41
+ ...(required.size > 0 ? { required: [...required] } : {}),
42
+ };
43
+ }
44
+ function constraintSuffix(schema) {
45
+ const constraints = [];
46
+ const minimum = number(schema.minimum);
47
+ const maximum = number(schema.maximum);
48
+ if (minimum !== undefined || maximum !== undefined) {
49
+ constraints.push(`${minimum ?? ""}..${maximum ?? ""}`);
50
+ }
51
+ const minLength = number(schema.minLength);
52
+ const maxLength = number(schema.maxLength);
53
+ if (minLength !== undefined)
54
+ constraints.push(`minLength=${minLength}`);
55
+ if (maxLength !== undefined)
56
+ constraints.push(`maxLength=${maxLength}`);
57
+ const minItems = number(schema.minItems);
58
+ const maxItems = number(schema.maxItems);
59
+ if (minItems !== undefined)
60
+ constraints.push(`minItems=${minItems}`);
61
+ if (maxItems !== undefined)
62
+ constraints.push(`maxItems=${maxItems}`);
63
+ if (schema.default !== undefined)
64
+ constraints.push(`default=${quoted(schema.default)}`);
65
+ return constraints.length > 0 ? ` [${constraints.join(", ")}]` : "";
66
+ }
67
+ export function compactSchemaType(value) {
68
+ const schema = renderSchema(value);
69
+ if (!schema)
70
+ return "unknown";
71
+ if (Array.isArray(schema.allOf)) {
72
+ return schema.allOf.map(compactSchemaType).join(" & ");
73
+ }
74
+ if (schema.const !== undefined)
75
+ return quoted(schema.const);
76
+ if (Array.isArray(schema.enum))
77
+ return schema.enum.map(quoted).join(" | ");
78
+ const union = Array.isArray(schema.anyOf)
79
+ ? schema.anyOf
80
+ : Array.isArray(schema.oneOf)
81
+ ? schema.oneOf
82
+ : undefined;
83
+ if (union)
84
+ return union.map(compactSchemaType).join(" | ");
85
+ if (schema.type === "array") {
86
+ return `${compactSchemaType(schema.items)}[]${constraintSuffix(schema)}`;
87
+ }
88
+ if (schema.type === "object" || record(schema.properties)) {
89
+ const properties = record(schema.properties);
90
+ if (!properties || Object.keys(properties).length === 0)
91
+ return "object";
92
+ const required = new Set(Array.isArray(schema.required)
93
+ ? schema.required.filter((entry) => typeof entry === "string")
94
+ : []);
95
+ const fields = Object.entries(properties).map(([name, descriptor]) => `${name}${required.has(name) ? "" : "?"}: ${compactSchemaType(descriptor)}`);
96
+ return `{${fields.join(", ")}}`;
97
+ }
98
+ const type = schema.type === "number" ? "number" : schema.type;
99
+ return `${typeof type === "string" ? type : "unknown"}${constraintSuffix(schema)}`;
100
+ }
101
+ function descriptionText(value, verbose) {
102
+ if (typeof value !== "string" || !value.trim())
103
+ return "";
104
+ const normalized = value.trim().replace(/\s+/g, " ");
105
+ if (verbose || normalized.length <= 160)
106
+ return normalized;
107
+ return `${normalized.slice(0, 159).trimEnd()}…`;
108
+ }
109
+ function hasLongDescription(value) {
110
+ if (Array.isArray(value))
111
+ return value.some(hasLongDescription);
112
+ const object = record(value);
113
+ if (!object)
114
+ return false;
115
+ if (typeof object.description === "string" &&
116
+ object.description.trim().replace(/\s+/g, " ").length > 160) {
117
+ return true;
118
+ }
119
+ return Object.entries(object).some(([key, nested]) => key !== "description" && hasLongDescription(nested));
120
+ }
121
+ function schemaLines(value, indent, options = {}) {
122
+ const schema = renderSchema(value);
123
+ if (!schema)
124
+ return [`${indent}unknown`];
125
+ const properties = record(schema.properties);
126
+ if (!properties)
127
+ return [`${indent}${compactSchemaType(schema)}`];
128
+ const required = new Set(Array.isArray(schema.required)
129
+ ? schema.required.filter((entry) => typeof entry === "string")
130
+ : []);
131
+ const lines = [];
132
+ for (const [name, descriptorValue] of Object.entries(properties)) {
133
+ const descriptor = record(descriptorValue) ?? {};
134
+ const optional = required.has(name) ? "" : "?";
135
+ const compactDescription = descriptionText(descriptor.description, options.verboseDescriptions === true);
136
+ const description = compactDescription ? ` — ${compactDescription}` : "";
137
+ const nested = record(descriptor.properties);
138
+ if (nested) {
139
+ lines.push(`${indent}${name}${optional}: {`);
140
+ lines.push(...schemaLines(descriptor, `${indent} `, options));
141
+ lines.push(`${indent}}${description}`);
142
+ }
143
+ else {
144
+ lines.push(`${indent}${name}${optional}: ${compactSchemaType(descriptor)}${description}`);
145
+ }
146
+ }
147
+ return lines.length > 0 ? lines : [`${indent}{}`];
148
+ }
149
+ function schemaObject(value) {
150
+ return record(value);
151
+ }
152
+ function shellQuote(value) {
153
+ return `'${value.replace(/'/g, `'"'"'`)}'`;
154
+ }
155
+ function shellToken(value) {
156
+ return SAFE_SHELL_TOKEN.test(value) ? value : shellQuote(value);
157
+ }
158
+ function toolSelector(server, tool) {
159
+ return shellToken(`${server}.${tool}`);
160
+ }
161
+ function exampleValue(value, name) {
162
+ const schema = renderSchema(value) ?? {};
163
+ const union = Array.isArray(schema.anyOf)
164
+ ? schema.anyOf
165
+ : Array.isArray(schema.oneOf)
166
+ ? schema.oneOf
167
+ : undefined;
168
+ if (union?.length)
169
+ return exampleValue(union[0], name);
170
+ if (schema.const !== undefined)
171
+ return schema.const;
172
+ if (Array.isArray(schema.enum) && schema.enum.length > 0)
173
+ return schema.enum[0];
174
+ if (schema.type === "boolean")
175
+ return true;
176
+ if (schema.type === "number" || schema.type === "integer") {
177
+ return number(schema.minimum) ?? 1;
178
+ }
179
+ if (schema.type === "array") {
180
+ const count = Math.min(MAX_EXAMPLE_ARRAY_ITEMS, Math.max(1, number(schema.minItems) ?? 1));
181
+ return Array.from({ length: count }, () => exampleValue(schema.items, "value"));
182
+ }
183
+ if (schema.type === "object" || record(schema.properties)) {
184
+ const properties = record(schema.properties) ?? {};
185
+ const required = Array.isArray(schema.required)
186
+ ? schema.required.filter((entry) => typeof entry === "string")
187
+ : [];
188
+ return Object.fromEntries(required.map((field) => [field, exampleValue(properties[field], field)]));
189
+ }
190
+ return `<${name}>`;
191
+ }
192
+ function callValue(value, name) {
193
+ const example = exampleValue(value, name);
194
+ return typeof example === "string"
195
+ ? shellQuote(example)
196
+ : typeof example === "object"
197
+ ? shellQuote(JSON.stringify(example))
198
+ : String(example);
199
+ }
200
+ function callExample(server, tool) {
201
+ const schema = renderSchema(tool.inputSchema);
202
+ const properties = record(schema?.properties) ?? {};
203
+ const required = Array.isArray(schema?.required)
204
+ ? schema.required.filter((entry) => typeof entry === "string")
205
+ : [];
206
+ if (required.some((name) => !SAFE_CLI_KEY.test(name) ||
207
+ Boolean(structuredBranch(properties[name], "object") ??
208
+ structuredBranch(properties[name], "array")))) {
209
+ const json = JSON.stringify(Object.fromEntries(required.map((name) => [name, exampleValue(properties[name], name)])));
210
+ return `mcp call ${toolSelector(server, tool.name)} --json ${shellQuote(json)}`;
211
+ }
212
+ const args = required.map((name) => {
213
+ const descriptor = record(properties[name]) ?? {};
214
+ return `${name}=${callValue(descriptor, name)}`;
215
+ });
216
+ return `mcp call ${toolSelector(server, tool.name)}${args.length > 0 ? ` ${args.join(" ")}` : ""}`;
217
+ }
218
+ function structuredBranch(value, kind) {
219
+ const schema = renderSchema(value);
220
+ if (!schema)
221
+ return undefined;
222
+ if ((kind === "array" && schema.type === "array") ||
223
+ (kind === "object" && (schema.type === "object" || record(schema.properties)))) {
224
+ return schema;
225
+ }
226
+ const union = Array.isArray(schema.anyOf)
227
+ ? schema.anyOf
228
+ : Array.isArray(schema.oneOf)
229
+ ? schema.oneOf
230
+ : [];
231
+ return union.map((branch) => structuredBranch(branch, kind)).find(Boolean);
232
+ }
233
+ function structuredCallExample(server, tool) {
234
+ const schema = renderSchema(tool.inputSchema);
235
+ const properties = record(schema?.properties) ?? {};
236
+ const required = new Set(Array.isArray(schema?.required)
237
+ ? schema.required.filter((entry) => typeof entry === "string")
238
+ : []);
239
+ const requiredValues = Object.fromEntries([...required].map((name) => [name, exampleValue(properties[name], name)]));
240
+ for (const kind of ["object", "array"]) {
241
+ for (const [name, descriptor] of Object.entries(properties)) {
242
+ const branch = structuredBranch(descriptor, kind);
243
+ if (!branch)
244
+ continue;
245
+ const json = JSON.stringify({
246
+ ...requiredValues,
247
+ ...(!required.has(name) ? { [name]: exampleValue(branch, name) } : {}),
248
+ });
249
+ return `mcp call ${toolSelector(server, tool.name)} --json ${shellQuote(json)}`;
250
+ }
251
+ }
252
+ return undefined;
253
+ }
254
+ export function renderToolContract(server, tool, options = {}) {
255
+ const lines = [`${server}.${tool.name}`];
256
+ const description = descriptionText(tool.description, options.verboseDescriptions === true);
257
+ if (description) {
258
+ lines.push(description);
259
+ }
260
+ if (!options.verboseDescriptions &&
261
+ (descriptionText(tool.description, true).length > 160 ||
262
+ hasLongDescription(tool.inputSchema) ||
263
+ hasLongDescription(tool.outputSchema))) {
264
+ lines.push("Descriptions shortened; use --verbose for full text.");
265
+ }
266
+ lines.push("", "input", ...schemaLines(tool.inputSchema, " ", options));
267
+ lines.push("", "output", ...(schemaObject(tool.outputSchema)
268
+ ? schemaLines(tool.outputSchema, " ", options)
269
+ : [" unspecified"]));
270
+ lines.push("", "call", ` ${callExample(server, tool)}`);
271
+ const structured = structuredCallExample(server, tool);
272
+ if (structured)
273
+ lines.push(` structured: ${structured}`);
274
+ return `${lines.join("\n")}\n`;
275
+ }
276
+ export function renderToolSignature(server, tool, options = {}) {
277
+ const schema = renderSchema(tool.inputSchema);
278
+ const properties = record(schema?.properties) ?? {};
279
+ const required = new Set(Array.isArray(schema?.required)
280
+ ? schema.required.filter((entry) => typeof entry === "string")
281
+ : []);
282
+ const entries = Object.entries(properties);
283
+ const included = new Set(entries.filter(([name]) => required.has(name)).map(([name]) => name));
284
+ if (!options.allParameters) {
285
+ for (const [name] of entries) {
286
+ if (included.size >= 5)
287
+ break;
288
+ included.add(name);
289
+ }
290
+ }
291
+ const visible = options.allParameters
292
+ ? entries
293
+ : entries.filter(([name]) => included.has(name));
294
+ const parameters = visible.map(([name, descriptor]) => {
295
+ const optional = required.has(name) ? "" : "?";
296
+ return `${name}${optional}: ${compactSchemaType(descriptor)}`;
297
+ });
298
+ const hidden = entries.length - visible.length;
299
+ if (hidden > 0)
300
+ parameters.push(`… +${hidden} optional`);
301
+ return `${server}.${tool.name}(${parameters.join(", ")})`;
302
+ }
303
+ export function catalogOutputSchema(tool) {
304
+ return tool?.output_schema;
305
+ }
306
+ //# sourceMappingURL=mcp-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-contract.js","sourceRoot":"","sources":["../src/mcp-contract.ts"],"names":[],"mappings":"AAIA,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAgB;QACnB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtG,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAC/B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAC3E,CAAC;IACF,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAC9B,EAAE,EACF,cAAc,EACd,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAC7D,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,EAAE,CACP,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC1C,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACrE,IAAI,QAAQ,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;YACd,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;YAC/E,CAAC,CAAC,EAAE,CACP,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAC3C,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CACrB,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAC9E,CAAC;QACF,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/D,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,OAAgB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrD,IAAI,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,UAAU,CAAC;IAC3D,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,IACE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QACtC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,EAC3D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAChC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,aAAa,IAAI,kBAAkB,CAAC,MAAM,CAAC,CACvE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,MAAc,EACd,UAA6C,EAAE;IAE/C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,GAAG,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,EAAE,CACP,CAAC;IACF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,MAAM,kBAAkB,GAAG,eAAe,CACxC,UAAU,CAAC,WAAW,EACtB,OAAO,CAAC,mBAAmB,KAAK,IAAI,CACrC,CAAC;QACF,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,KAAK,iBAAiB,CAAC,UAAU,CAAC,GAAG,WAAW,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,IAAY;IAChD,OAAO,UAAU,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;YACd,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,KAAK,EAAE,MAAM;QAAE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,uBAAuB,EACvB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAC1C,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;YAC/E,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,MAAM,CAAC,WAAW,CACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CACzE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,GAAG,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,IAAY;IAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,IAAkB;IACrD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,EAAE,CAAC;IACP,IACE,QAAQ,CAAC,IAAI,CACX,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,OAAO,CACL,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;YAC1C,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAC9C,CACJ,EACD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CACzF,CAAC;QACF,OAAO,YAAY,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,GAAG,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,YAAY,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,IAAwB;IAChE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IACE,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;QAC7C,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAC9E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;YACd,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc,EAAE,IAAkB;IAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,EAAE,CACP,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CACvC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAC1E,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAU,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC1B,GAAG,cAAc;gBACjB,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC,CAAC;YACH,OAAO,YAAY,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,IAAkB,EAClB,UAA6C,EAAE;IAE/C,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,eAAe,CACjC,IAAI,CAAC,WAAW,EAChB,OAAO,CAAC,mBAAmB,KAAK,IAAI,CACrC,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IACD,IACE,CAAC,OAAO,CAAC,mBAAmB;QAC5B,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;YACnD,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC;YACpC,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CACR,EAAE,EACF,QAAQ,EACR,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QACjC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC;QAC/C,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CACvB,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC1D,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAkB,EAClB,UAAuC,EAAE;IAEzC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,EAAE,CACP,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CACrE,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC;gBAAE,MAAM;YAC9B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa;QACnC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,OAAO,GAAG,IAAI,GAAG,QAAQ,KAAK,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/C,IAAI,MAAM,GAAG,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,MAAM,MAAM,WAAW,CAAC,CAAC;IACzD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAqC;IACvE,OAAO,IAAI,EAAE,aAAa,CAAC;AAC7B,CAAC"}
@@ -0,0 +1,10 @@
1
+ import { type Socket } from "node:net";
2
+ import { type McpDaemonEnvelope, type McpDaemonRequest } from "./mcp-daemon-protocol.js";
3
+ export declare function mcpDaemonEnvironment(env?: NodeJS.ProcessEnv): {
4
+ socketPath: string;
5
+ token: string;
6
+ fingerprint: string;
7
+ };
8
+ export declare function exchangeMcpDaemon(request: McpDaemonRequest, onEnvelope: (envelope: McpDaemonEnvelope, socket: Socket) => void, env?: NodeJS.ProcessEnv): Promise<void>;
9
+ export declare function ensureMcpDaemon(env?: NodeJS.ProcessEnv): Promise<void>;
10
+ //# sourceMappingURL=mcp-daemon-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-daemon-client.d.ts","sourceRoot":"","sources":["../src/mcp-daemon-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAIzD,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAUlC,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAQA;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EACjE,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAeD,wBAAsB,eAAe,CACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,IAAI,CAAC,CAuDf"}
@@ -0,0 +1,119 @@
1
+ import { spawn } from "node:child_process";
2
+ import { randomUUID } from "node:crypto";
3
+ import { existsSync } from "node:fs";
4
+ import { open, readFile, rm } from "node:fs/promises";
5
+ import { createConnection } from "node:net";
6
+ import { setTimeout as delay } from "node:timers/promises";
7
+ import { fileURLToPath } from "node:url";
8
+ import { MCP_DAEMON_FINGERPRINT_ENV, MCP_DAEMON_SOCKET_ENV, MCP_DAEMON_TOKEN_ENV, MCP_SESSION_ROOT_ENV, } from "./mcp-daemon-protocol.js";
9
+ const START_TIMEOUT_MS = 20_000;
10
+ function daemonPath() {
11
+ const adjacent = fileURLToPath(new URL("./mcp-daemon.js", import.meta.url));
12
+ if (existsSync(adjacent))
13
+ return adjacent;
14
+ return fileURLToPath(new URL("../dist/mcp-daemon.js", import.meta.url));
15
+ }
16
+ export function mcpDaemonEnvironment(env = process.env) {
17
+ const socketPath = env[MCP_DAEMON_SOCKET_ENV];
18
+ const token = env[MCP_DAEMON_TOKEN_ENV];
19
+ const fingerprint = env[MCP_DAEMON_FINGERPRINT_ENV];
20
+ if (!socketPath || !token || !fingerprint) {
21
+ throw new Error("MCP daemon environment is incomplete.");
22
+ }
23
+ return { socketPath, token, fingerprint };
24
+ }
25
+ export function exchangeMcpDaemon(request, onEnvelope, env = process.env) {
26
+ const { socketPath } = mcpDaemonEnvironment(env);
27
+ return new Promise((resolve, reject) => {
28
+ const socket = createConnection(socketPath);
29
+ let buffer = "";
30
+ socket.setEncoding("utf8");
31
+ socket.once("connect", () => socket.write(`${JSON.stringify(request)}\n`));
32
+ socket.on("data", (chunk) => {
33
+ buffer += chunk;
34
+ let newline = buffer.indexOf("\n");
35
+ while (newline >= 0) {
36
+ const line = buffer.slice(0, newline);
37
+ buffer = buffer.slice(newline + 1);
38
+ if (line)
39
+ onEnvelope(JSON.parse(line), socket);
40
+ newline = buffer.indexOf("\n");
41
+ }
42
+ });
43
+ socket.once("end", resolve);
44
+ socket.once("error", reject);
45
+ });
46
+ }
47
+ async function ping(env) {
48
+ const { token, fingerprint } = mcpDaemonEnvironment(env);
49
+ let ready = false;
50
+ await exchangeMcpDaemon({ type: "ping", id: randomUUID(), token, fingerprint }, (envelope) => {
51
+ if ("ready" in envelope && envelope.fingerprint === fingerprint)
52
+ ready = true;
53
+ }, env).catch(() => { });
54
+ return ready;
55
+ }
56
+ export async function ensureMcpDaemon(env = process.env) {
57
+ if (await ping(env))
58
+ return;
59
+ const { socketPath } = mcpDaemonEnvironment(env);
60
+ const lockPath = `${socketPath}.lock`;
61
+ let lock;
62
+ try {
63
+ lock = await open(lockPath, "wx", 0o600);
64
+ }
65
+ catch (error) {
66
+ if (error.code !== "EEXIST")
67
+ throw error;
68
+ const owner = Number(await readFile(lockPath, "utf8").catch(() => ""));
69
+ if (Number.isSafeInteger(owner) && owner > 0) {
70
+ try {
71
+ process.kill(owner, 0);
72
+ }
73
+ catch (ownerError) {
74
+ if (ownerError.code === "ESRCH") {
75
+ await rm(lockPath, { force: true });
76
+ return ensureMcpDaemon(env);
77
+ }
78
+ }
79
+ }
80
+ }
81
+ if (lock) {
82
+ try {
83
+ await lock.writeFile(String(process.pid));
84
+ if (process.platform !== "win32")
85
+ await rm(socketPath, { force: true });
86
+ const child = spawn(process.execPath, [daemonPath()], {
87
+ detached: true,
88
+ stdio: "ignore",
89
+ env: { ...process.env, ...env },
90
+ cwd: env[MCP_SESSION_ROOT_ENV] || process.cwd(),
91
+ });
92
+ await new Promise((resolve, reject) => {
93
+ child.once("spawn", resolve);
94
+ child.once("error", reject);
95
+ });
96
+ child.unref();
97
+ }
98
+ catch (error) {
99
+ await rm(lockPath, { force: true });
100
+ throw error;
101
+ }
102
+ finally {
103
+ await lock.close();
104
+ }
105
+ }
106
+ const deadline = Date.now() + START_TIMEOUT_MS;
107
+ while (Date.now() < deadline) {
108
+ if (await ping(env)) {
109
+ if (lock)
110
+ await rm(lockPath, { force: true });
111
+ return;
112
+ }
113
+ await delay(50);
114
+ }
115
+ if (lock)
116
+ await rm(lockPath, { force: true });
117
+ throw new Error("MCP daemon did not become ready before the startup deadline.");
118
+ }
119
+ //# sourceMappingURL=mcp-daemon-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-daemon-client.js","sourceRoot":"","sources":["../src/mcp-daemon-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ import type { McpToolCatalogEntry } from "./mcp.js";
2
+ export declare const MCP_DAEMON_SOCKET_ENV = "PI_RECIPES_MCP_DAEMON_SOCKET";
3
+ export declare const MCP_DAEMON_TOKEN_ENV = "PI_RECIPES_MCP_DAEMON_TOKEN";
4
+ export declare const MCP_DAEMON_FINGERPRINT_ENV = "PI_RECIPES_MCP_DAEMON_FINGERPRINT";
5
+ export declare const MCP_DAEMON_PARENT_PID_ENV = "PI_RECIPES_MCP_DAEMON_PARENT_PID";
6
+ export declare const MCP_SESSION_ROOT_ENV = "PI_RECIPES_MCP_SESSION_ROOT";
7
+ export interface McpDaemonExecuteRequest {
8
+ type: "execute";
9
+ id: string;
10
+ token: string;
11
+ fingerprint: string;
12
+ args: string[];
13
+ stdin: string;
14
+ }
15
+ export interface McpDaemonCancelRequest {
16
+ type: "cancel";
17
+ id: string;
18
+ token: string;
19
+ requestId: string;
20
+ }
21
+ export interface McpDaemonStopRequest {
22
+ type: "stop";
23
+ id: string;
24
+ token: string;
25
+ }
26
+ export interface McpDaemonPingRequest {
27
+ type: "ping";
28
+ id: string;
29
+ token: string;
30
+ fingerprint: string;
31
+ }
32
+ export interface McpDaemonCatalogRequest {
33
+ type: "catalog";
34
+ id: string;
35
+ token: string;
36
+ fingerprint: string;
37
+ timeoutMs: number;
38
+ }
39
+ export interface McpCatalogServer {
40
+ id: string;
41
+ name: string;
42
+ tools: McpToolCatalogEntry[];
43
+ error?: string;
44
+ }
45
+ export type McpDaemonRequest = McpDaemonExecuteRequest | McpDaemonCancelRequest | McpDaemonStopRequest | McpDaemonPingRequest | McpDaemonCatalogRequest;
46
+ export type McpDaemonEnvelope = {
47
+ id: string;
48
+ stream: "stdout" | "stderr";
49
+ data: string;
50
+ } | {
51
+ id: string;
52
+ ready: true;
53
+ fingerprint: string;
54
+ } | {
55
+ id: string;
56
+ catalogs: McpCatalogServer[];
57
+ } | {
58
+ id: string;
59
+ exitCode: number;
60
+ } | {
61
+ id: string;
62
+ error: string;
63
+ };
64
+ //# sourceMappingURL=mcp-daemon-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-daemon-protocol.d.ts","sourceRoot":"","sources":["../src/mcp-daemon-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AACpE,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAClE,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAC9E,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAC5E,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}
@@ -0,0 +1,6 @@
1
+ export const MCP_DAEMON_SOCKET_ENV = "PI_RECIPES_MCP_DAEMON_SOCKET";
2
+ export const MCP_DAEMON_TOKEN_ENV = "PI_RECIPES_MCP_DAEMON_TOKEN";
3
+ export const MCP_DAEMON_FINGERPRINT_ENV = "PI_RECIPES_MCP_DAEMON_FINGERPRINT";
4
+ export const MCP_DAEMON_PARENT_PID_ENV = "PI_RECIPES_MCP_DAEMON_PARENT_PID";
5
+ export const MCP_SESSION_ROOT_ENV = "PI_RECIPES_MCP_SESSION_ROOT";
6
+ //# sourceMappingURL=mcp-daemon-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-daemon-protocol.js","sourceRoot":"","sources":["../src/mcp-daemon-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAA8B,CAAC;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,mCAAmC,CAAC;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=mcp-daemon.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-daemon.d.ts","sourceRoot":"","sources":["../src/mcp-daemon.ts"],"names":[],"mappings":""}