frontmcp 0.12.2 → 1.0.0-beta.2

package/src/commands/build/exec/cli-runtime/output-formatter.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Output formatting for MCP tool/resource results in CLI context.
+ * This module is embedded in the generated CLI bundle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatToolResult = formatToolResult;
+exports.formatResourceResult = formatResourceResult;
+exports.formatPromptResult = formatPromptResult;
+exports.formatSubscriptionEvent = formatSubscriptionEvent;
+exports.generateOutputFormatterSource = generateOutputFormatterSource;
+/**
+ * Format a tool call result for terminal output.
+ */
+function formatToolResult(result, mode) {
+    if (mode === 'json') {
+        return JSON.stringify(result, null, 2);
+    }
+    return formatTextOutput(result);
+}
+/**
+ * Format a resource read result for terminal output.
+ */
+function formatResourceResult(result, mode) {
+    if (mode === 'json') {
+        return JSON.stringify(result, null, 2);
+    }
+    const contents = result.contents;
+    if (!contents || contents.length === 0) {
+        return '(empty resource)';
+    }
+    return contents
+        .map((c) => {
+        if (c.text)
+            return c.text;
+        if (c.uri)
+            return `[Resource: ${c.uri}]`;
+        if (c.data && c.mimeType)
+            return `[Binary: ${c.mimeType}, ${c.data.length} chars base64]`;
+        return JSON.stringify(c, null, 2);
+    })
+        .join('\n');
+}
+/**
+ * Format a prompt result for terminal output.
+ */
+function formatPromptResult(result, mode) {
+    if (mode === 'json') {
+        return JSON.stringify(result, null, 2);
+    }
+    const messages = result.messages;
+    if (!messages || messages.length === 0) {
+        return '(empty prompt)';
+    }
+    return messages
+        .map((m) => {
+        const role = m.role || 'unknown';
+        const text = m.content?.text || JSON.stringify(m.content);
+        return `[${role}] ${text}`;
+    })
+        .join('\n\n');
+}
+/**
+ * Format a subscription event for terminal output.
+ */
+function formatSubscriptionEvent(event, mode) {
+    if (mode === 'json') {
+        return JSON.stringify(event, null, 2);
+    }
+    const ts = event.timestamp ? `[${event.timestamp}] ` : '';
+    if (event.type === 'resource_updated') {
+        return `${ts}Resource updated: ${event.uri || 'unknown'}`;
+    }
+    if (event.type === 'notification') {
+        const detail = event.params ? ' ' + JSON.stringify(event.params) : '';
+        return `${ts}Notification: ${event.method || 'unknown'}${detail}`;
+    }
+    return `${ts}${event.type}: ${JSON.stringify(event)}`;
+}
+function formatTextOutput(result) {
+    if (!result.content || result.content.length === 0) {
+        return result.isError ? '(error: no content)' : '(no output)';
+    }
+    const blocks = result.content.map((block) => {
+        switch (block.type) {
+            case 'text':
+                return block.text || '';
+            case 'image':
+                return `[Image: ${block.mimeType || 'unknown'}, ${(block.data?.length || 0)} chars base64]`;
+            case 'resource':
+                return `[Resource: ${block.uri || 'unknown'}]`;
+            case 'audio':
+                return `[Audio: ${block.mimeType || 'unknown'}]`;
+            default:
+                return `[${block.type}: ${JSON.stringify(block)}]`;
+        }
+    });
+    const output = blocks.join('\n');
+    if (result.isError) {
+        return `Error: ${output}`;
+    }
+    return output;
+}
+/**
+ * Generate the output-formatter module source code for embedding in CLI bundle.
+ */
+function generateOutputFormatterSource() {
+    return `
+'use strict';
+
+function formatToolResult(result, mode) {
+  if (mode === 'json') return JSON.stringify(result, null, 2);
+  if (!result.content || result.content.length === 0) {
+    return result.isError ? '(error: no content)' : '(no output)';
+  }
+  const blocks = result.content.map(function(block) {
+    switch (block.type) {
+      case 'text': return block.text || '';
+      case 'image': return '[Image: ' + (block.mimeType || 'unknown') + ']';
+      case 'resource': return '[Resource: ' + (block.uri || 'unknown') + ']';
+      case 'audio': return '[Audio: ' + (block.mimeType || 'unknown') + ']';
+      default: return '[' + block.type + ']';
+    }
+  });
+  var output = blocks.join('\\n');
+  return result.isError ? 'Error: ' + output : output;
+}
+
+function formatResourceResult(result, mode) {
+  if (mode === 'json') return JSON.stringify(result, null, 2);
+  var contents = result.contents;
+  if (!contents || contents.length === 0) return '(empty resource)';
+  return contents.map(function(c) {
+    if (c.text) return c.text;
+    if (c.uri) return '[Resource: ' + c.uri + ']';
+    if (c.data && c.mimeType) return '[Binary: ' + c.mimeType + ']';
+    return JSON.stringify(c, null, 2);
+  }).join('\\n');
+}
+
+function formatPromptResult(result, mode) {
+  if (mode === 'json') return JSON.stringify(result, null, 2);
+  var messages = result.messages;
+  if (!messages || messages.length === 0) return '(empty prompt)';
+  return messages.map(function(m) {
+    var role = m.role || 'unknown';
+    var text = m.content && m.content.text ? m.content.text : JSON.stringify(m.content);
+    return '[' + role + '] ' + text;
+  }).join('\\n\\n');
+}
+
+function formatSubscriptionEvent(event, mode) {
+  if (mode === 'json') return JSON.stringify(event, null, 2);
+  var ts = event.timestamp ? '[' + event.timestamp + '] ' : '';
+  if (event.type === 'resource_updated') {
+    return ts + 'Resource updated: ' + (event.uri || 'unknown');
+  }
+  if (event.type === 'notification') {
+    var detail = event.params ? ' ' + JSON.stringify(event.params) : '';
+    return ts + 'Notification: ' + (event.method || 'unknown') + detail;
+  }
+  return ts + event.type + ': ' + JSON.stringify(event);
+}
+
+module.exports = { formatToolResult, formatResourceResult, formatPromptResult, formatSubscriptionEvent };
+`.trim();
+}
+//# sourceMappingURL=output-formatter.js.map

package/src/commands/build/exec/cli-runtime/output-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.js","sourceRoot":"","sources":["../../../../../../src/commands/build/exec/cli-runtime/output-formatter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Output formatting for MCP tool/resource results in CLI context.\n * This module is embedded in the generated CLI bundle.\n */\n\nexport type OutputMode = 'text' | 'json';\n\nexport interface ContentBlock {\n  type: string;\n  text?: string;\n  mimeType?: string;\n  data?: string;\n  uri?: string;\n  [key: string]: unknown;\n}\n\nexport interface CallToolResult {\n  content?: ContentBlock[];\n  isError?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Format a tool call result for terminal output.\n */\nexport function formatToolResult(result: CallToolResult, mode: OutputMode): string {\n  if (mode === 'json') {\n    return JSON.stringify(result, null, 2);\n  }\n\n  return formatTextOutput(result);\n}\n\n/**\n * Format a resource read result for terminal output.\n */\nexport function formatResourceResult(result: Record<string, unknown>, mode: OutputMode): string {\n  if (mode === 'json') {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const contents = result.contents as ContentBlock[] | undefined;\n  if (!contents || contents.length === 0) {\n    return '(empty resource)';\n  }\n\n  return contents\n    .map((c) => {\n      if (c.text) return c.text;\n      if (c.uri) return `[Resource: ${c.uri}]`;\n      if (c.data && c.mimeType) return `[Binary: ${c.mimeType}, ${c.data.length} chars base64]`;\n      return JSON.stringify(c, null, 2);\n    })\n    .join('\\n');\n}\n\n/**\n * Format a prompt result for terminal output.\n */\nexport function formatPromptResult(result: Record<string, unknown>, mode: OutputMode): string {\n  if (mode === 'json') {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const messages = result.messages as Array<{ role?: string; content?: ContentBlock }> | undefined;\n  if (!messages || messages.length === 0) {\n    return '(empty prompt)';\n  }\n\n  return messages\n    .map((m) => {\n      const role = m.role || 'unknown';\n      const text = m.content?.text || JSON.stringify(m.content);\n      return `[${role}] ${text}`;\n    })\n    .join('\\n\\n');\n}\n\nexport interface SubscriptionEvent {\n  type: string;\n  uri?: string;\n  method?: string;\n  params?: unknown;\n  timestamp?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Format a subscription event for terminal output.\n */\nexport function formatSubscriptionEvent(event: SubscriptionEvent, mode: OutputMode): string {\n  if (mode === 'json') {\n    return JSON.stringify(event, null, 2);\n  }\n\n  const ts = event.timestamp ? `[${event.timestamp}] ` : '';\n  if (event.type === 'resource_updated') {\n    return `${ts}Resource updated: ${event.uri || 'unknown'}`;\n  }\n  if (event.type === 'notification') {\n    const detail = event.params ? ' ' + JSON.stringify(event.params) : '';\n    return `${ts}Notification: ${event.method || 'unknown'}${detail}`;\n  }\n  return `${ts}${event.type}: ${JSON.stringify(event)}`;\n}\n\nfunction formatTextOutput(result: CallToolResult): string {\n  if (!result.content || result.content.length === 0) {\n    return result.isError ? '(error: no content)' : '(no output)';\n  }\n\n  const blocks = result.content.map((block) => {\n    switch (block.type) {\n      case 'text':\n        return block.text || '';\n      case 'image':\n        return `[Image: ${block.mimeType || 'unknown'}, ${(block.data?.length || 0)} chars base64]`;\n      case 'resource':\n        return `[Resource: ${block.uri || 'unknown'}]`;\n      case 'audio':\n        return `[Audio: ${block.mimeType || 'unknown'}]`;\n      default:\n        return `[${block.type}: ${JSON.stringify(block)}]`;\n    }\n  });\n\n  const output = blocks.join('\\n');\n\n  if (result.isError) {\n    return `Error: ${output}`;\n  }\n\n  return output;\n}\n\n/**\n * Generate the output-formatter module source code for embedding in CLI bundle.\n */\nexport function generateOutputFormatterSource(): string {\n  return `\n'use strict';\n\nfunction formatToolResult(result, mode) {\n  if (mode === 'json') return JSON.stringify(result, null, 2);\n  if (!result.content || result.content.length === 0) {\n    return result.isError ? '(error: no content)' : '(no output)';\n  }\n  const blocks = result.content.map(function(block) {\n    switch (block.type) {\n      case 'text': return block.text || '';\n      case 'image': return '[Image: ' + (block.mimeType || 'unknown') + ']';\n      case 'resource': return '[Resource: ' + (block.uri || 'unknown') + ']';\n      case 'audio': return '[Audio: ' + (block.mimeType || 'unknown') + ']';\n      default: return '[' + block.type + ']';\n    }\n  });\n  var output = blocks.join('\\\\n');\n  return result.isError ? 'Error: ' + output : output;\n}\n\nfunction formatResourceResult(result, mode) {\n  if (mode === 'json') return JSON.stringify(result, null, 2);\n  var contents = result.contents;\n  if (!contents || contents.length === 0) return '(empty resource)';\n  return contents.map(function(c) {\n    if (c.text) return c.text;\n    if (c.uri) return '[Resource: ' + c.uri + ']';\n    if (c.data && c.mimeType) return '[Binary: ' + c.mimeType + ']';\n    return JSON.stringify(c, null, 2);\n  }).join('\\\\n');\n}\n\nfunction formatPromptResult(result, mode) {\n  if (mode === 'json') return JSON.stringify(result, null, 2);\n  var messages = result.messages;\n  if (!messages || messages.length === 0) return '(empty prompt)';\n  return messages.map(function(m) {\n    var role = m.role || 'unknown';\n    var text = m.content && m.content.text ? m.content.text : JSON.stringify(m.content);\n    return '[' + role + '] ' + text;\n  }).join('\\\\n\\\\n');\n}\n\nfunction formatSubscriptionEvent(event, mode) {\n  if (mode === 'json') return JSON.stringify(event, null, 2);\n  var ts = event.timestamp ? '[' + event.timestamp + '] ' : '';\n  if (event.type === 'resource_updated') {\n    return ts + 'Resource updated: ' + (event.uri || 'unknown');\n  }\n  if (event.type === 'notification') {\n    var detail = event.params ? ' ' + JSON.stringify(event.params) : '';\n    return ts + 'Notification: ' + (event.method || 'unknown') + detail;\n  }\n  return ts + event.type + ': ' + JSON.stringify(event);\n}\n\nmodule.exports = { formatToolResult, formatResourceResult, formatPromptResult, formatSubscriptionEvent };\n`.trim();\n}\n"]}

package/src/commands/build/exec/cli-runtime/schema-extractor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Build-time schema extraction.
+ * After the server bundle is produced, boots a DirectClient via connect(),
+ * extracts tool/resource/prompt schemas, and serializes them for CLI code generation.
+ */
+export interface ExtractedTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ExtractedResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface ExtractedResourceTemplate {
+    uriTemplate: string;
+    name: string;
+    description?: string;
+}
+export interface ExtractedPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export interface ExtractedJob {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    tags?: string[];
+}
+export interface ExtractedCapabilities {
+    skills: boolean;
+    jobs: boolean;
+    workflows: boolean;
+}
+export interface ExtractedSchema {
+    tools: ExtractedTool[];
+    resources: ExtractedResource[];
+    resourceTemplates: ExtractedResourceTemplate[];
+    prompts: ExtractedPrompt[];
+    jobs: ExtractedJob[];
+    capabilities: ExtractedCapabilities;
+}
+/** Known system tool names injected by SDK features (skills, jobs, workflows). */
+export declare const SYSTEM_TOOL_NAMES: Set<string>;
+/**
+ * Extract schemas from a compiled server bundle.
+ * Requires the bundle to export a FrontMcp-decorated class as default export
+ * or a config object usable by connect().
+ */
+export declare function extractSchemas(bundlePath: string): Promise<ExtractedSchema>;

package/src/commands/build/exec/cli-runtime/schema-extractor.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Build-time schema extraction.
+ * After the server bundle is produced, boots a DirectClient via connect(),
+ * extracts tool/resource/prompt schemas, and serializes them for CLI code generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_TOOL_NAMES = void 0;
+exports.extractSchemas = extractSchemas;
+/** Known system tool names injected by SDK features (skills, jobs, workflows). */
+exports.SYSTEM_TOOL_NAMES = new Set([
+    'searchSkills',
+    'loadSkills',
+    'list-jobs',
+    'execute-job',
+    'get-job-status',
+    'register-job',
+    'remove-job',
+    'list-workflows',
+    'execute-workflow',
+    'get-workflow-status',
+    'register-workflow',
+    'remove-workflow',
+]);
+/**
+ * Extract schemas from a compiled server bundle.
+ * Requires the bundle to export a FrontMcp-decorated class as default export
+ * or a config object usable by connect().
+ */
+async function extractSchemas(bundlePath) {
+    // Suppress @FrontMcp() decorator bootstrap — we only need metadata, not a running server
+    const prev = process.env['FRONTMCP_SCHEMA_EXTRACT'];
+    process.env['FRONTMCP_SCHEMA_EXTRACT'] = '1';
+    let mod;
+    try {
+        mod = require(bundlePath);
+    }
+    finally {
+        if (prev === undefined) {
+            delete process.env['FRONTMCP_SCHEMA_EXTRACT'];
+        }
+        else {
+            process.env['FRONTMCP_SCHEMA_EXTRACT'] = prev;
+        }
+    }
+    const configOrClass = mod.default || mod;
+    // Use @frontmcp/sdk connect() to boot in-memory client
+    let connect;
+    try {
+        const sdk = require('@frontmcp/sdk');
+        connect = sdk.connect || sdk.direct?.connect;
+        if (!connect) {
+            throw new Error('connect() not found in @frontmcp/sdk');
+        }
+    }
+    catch {
+        throw new Error('@frontmcp/sdk is required for CLI schema extraction. Ensure it is installed.');
+    }
+    const client = await connect(configOrClass, { mode: 'cli' });
+    try {
+        const [toolsRaw, resourcesResult, promptsResult] = await Promise.all([
+            client.listTools().catch(() => []),
+            client.listResources().catch(() => ({ resources: [] })),
+            client.listPrompts().catch(() => ({ prompts: [] })),
+        ]);
+        let resourceTemplates = [];
+        if (client.listResourceTemplates) {
+            try {
+                const templatesResult = await client.listResourceTemplates();
+                resourceTemplates = (templatesResult.resourceTemplates || []).map((t) => ({
+                    uriTemplate: t.uriTemplate,
+                    name: t.name || t.uriTemplate,
+                    description: t.description,
+                }));
+            }
+            catch {
+                // Resource templates not supported
+            }
+        }
+        // DirectClient.listTools() returns FormattedTools (array) directly,
+        // not { tools: [...] } like the raw MCP client
+        const toolsList = Array.isArray(toolsRaw)
+            ? toolsRaw
+            : (toolsRaw?.tools || []);
+        const tools = toolsList.map((t) => ({
+            name: t.name,
+            description: t.description || '',
+            inputSchema: t.inputSchema || { type: 'object', properties: {} },
+        }));
+        const resources = (resourcesResult.resources || []).map((r) => ({
+            uri: r.uri,
+            name: r.name || r.uri,
+            description: r.description,
+            mimeType: r.mimeType,
+        }));
+        const prompts = (promptsResult.prompts || []).map((p) => ({
+            name: p.name,
+            description: p.description,
+            arguments: p.arguments,
+        }));
+        const toolNameSet = new Set(tools.map((t) => t.name));
+        const capabilities = {
+            skills: toolNameSet.has('searchSkills') || toolNameSet.has('loadSkills'),
+            jobs: toolNameSet.has('execute-job') || toolNameSet.has('get-job-status'),
+            workflows: toolNameSet.has('execute-workflow') || toolNameSet.has('get-workflow-status'),
+        };
+        // Extract job schemas if jobs capability is available
+        let jobs = [];
+        if (capabilities.jobs && client.listJobs) {
+            try {
+                const jobsResult = await client.listJobs();
+                jobs = (jobsResult.jobs || []).map((j) => ({
+                    name: j.name,
+                    description: j.description,
+                    inputSchema: j.inputSchema,
+                    tags: j.tags,
+                }));
+            }
+            catch {
+                // Jobs listing not available at build time
+            }
+        }
+        return { tools, resources, resourceTemplates, prompts, jobs, capabilities };
+    }
+    finally {
+        await client.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=schema-extractor.js.map

package/src/commands/build/exec/cli-runtime/schema-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extractor.js","sourceRoot":"","sources":["../../../../../../src/commands/build/exec/cli-runtime/schema-extractor.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA0EH,wCAkHC;AAvID,kFAAkF;AACrE,QAAA,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,cAAc;IACd,YAAY;IACZ,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,gBAAgB;IAChB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,iBAAiB;CAClB,CAAC,CAAC;AAEH;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,yFAAyF;IACzF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,GAAG,GAAG,CAAC;IAE7C,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;QAChD,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;IAEzC,uDAAuD;IACvD,IAAI,OAA2E,CAAC;IAChF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QACrC,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAO1D,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnE,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;SACpD,CAAC,CAAC;QAEH,IAAI,iBAAiB,GAAgC,EAAE,CAAC;QACxD,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,qBAAqB,EAAE,CAAC;gBAC7D,iBAAiB,GAAG,CAAC,eAAe,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxE,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW;oBAC7B,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,+CAA+C;QAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACvC,CAAC,CAAC,QAAgF;YAClF,CAAC,CAAC,CAAE,QAAkC,EAAE,KAAK,IAAI,EAAE,CAAyE,CAAC;QAE/H,MAAM,KAAK,GAAoB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;YAChC,WAAW,EAAG,CAAC,CAAC,WAAuC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAC9F,CAAC,CAAC,CAAC;QAEJ,MAAM,SAAS,GAAwB,CAAC,eAAe,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnF,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG;YACrB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAsB,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3E,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAyC;SACvD,CAAC,CAAC,CAAC;QAEJ,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,MAAM,YAAY,GAA0B;YAC1C,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;YACxE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACzE,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC;SACzF,CAAC;QAEF,sDAAsD;QACtD,IAAI,IAAI,GAAmB,EAAE,CAAC;QAC9B,IAAI,YAAY,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvC,CAAC;AACH,CAAC","sourcesContent":["/**\n * Build-time schema extraction.\n * After the server bundle is produced, boots a DirectClient via connect(),\n * extracts tool/resource/prompt schemas, and serializes them for CLI code generation.\n */\n\nexport interface ExtractedTool {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}\n\nexport interface ExtractedResource {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n}\n\nexport interface ExtractedResourceTemplate {\n  uriTemplate: string;\n  name: string;\n  description?: string;\n}\n\nexport interface ExtractedPrompt {\n  name: string;\n  description?: string;\n  arguments?: Array<{\n    name: string;\n    description?: string;\n    required?: boolean;\n  }>;\n}\n\nexport interface ExtractedJob {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n  tags?: string[];\n}\n\nexport interface ExtractedCapabilities {\n  skills: boolean;\n  jobs: boolean;\n  workflows: boolean;\n}\n\nexport interface ExtractedSchema {\n  tools: ExtractedTool[];\n  resources: ExtractedResource[];\n  resourceTemplates: ExtractedResourceTemplate[];\n  prompts: ExtractedPrompt[];\n  jobs: ExtractedJob[];\n  capabilities: ExtractedCapabilities;\n}\n\n/** Known system tool names injected by SDK features (skills, jobs, workflows). */\nexport const SYSTEM_TOOL_NAMES = new Set([\n  'searchSkills',\n  'loadSkills',\n  'list-jobs',\n  'execute-job',\n  'get-job-status',\n  'register-job',\n  'remove-job',\n  'list-workflows',\n  'execute-workflow',\n  'get-workflow-status',\n  'register-workflow',\n  'remove-workflow',\n]);\n\n/**\n * Extract schemas from a compiled server bundle.\n * Requires the bundle to export a FrontMcp-decorated class as default export\n * or a config object usable by connect().\n */\nexport async function extractSchemas(bundlePath: string): Promise<ExtractedSchema> {\n  // Suppress @FrontMcp() decorator bootstrap — we only need metadata, not a running server\n  const prev = process.env['FRONTMCP_SCHEMA_EXTRACT'];\n  process.env['FRONTMCP_SCHEMA_EXTRACT'] = '1';\n\n  let mod: Record<string, unknown>;\n  try {\n    mod = require(bundlePath);\n  } finally {\n    if (prev === undefined) {\n      delete process.env['FRONTMCP_SCHEMA_EXTRACT'];\n    } else {\n      process.env['FRONTMCP_SCHEMA_EXTRACT'] = prev;\n    }\n  }\n\n  const configOrClass = mod.default || mod;\n\n  // Use @frontmcp/sdk connect() to boot in-memory client\n  let connect: (config: unknown, options?: { mode?: string }) => Promise<unknown>;\n  try {\n    const sdk = require('@frontmcp/sdk');\n    connect = sdk.connect || sdk.direct?.connect;\n    if (!connect) {\n      throw new Error('connect() not found in @frontmcp/sdk');\n    }\n  } catch {\n    throw new Error(\n      '@frontmcp/sdk is required for CLI schema extraction. Ensure it is installed.',\n    );\n  }\n\n  const client = await connect(configOrClass, { mode: 'cli' }) as {\n    listTools(): Promise<unknown>;\n    listResources(): Promise<{ resources: Array<{ uri: string; name?: string; description?: string; mimeType?: string }> }>;\n    listResourceTemplates?(): Promise<{ resourceTemplates: Array<{ uriTemplate: string; name?: string; description?: string }> }>;\n    listPrompts(): Promise<{ prompts: Array<{ name: string; description?: string; arguments?: unknown[] }> }>;\n    listJobs?(): Promise<{ jobs: Array<{ name: string; description?: string; inputSchema?: Record<string, unknown>; tags?: string[] }>; count: number }>;\n    close(): Promise<void>;\n  };\n\n  try {\n    const [toolsRaw, resourcesResult, promptsResult] = await Promise.all([\n      client.listTools().catch(() => []),\n      client.listResources().catch(() => ({ resources: [] })),\n      client.listPrompts().catch(() => ({ prompts: [] })),\n    ]);\n\n    let resourceTemplates: ExtractedResourceTemplate[] = [];\n    if (client.listResourceTemplates) {\n      try {\n        const templatesResult = await client.listResourceTemplates();\n        resourceTemplates = (templatesResult.resourceTemplates || []).map((t) => ({\n          uriTemplate: t.uriTemplate,\n          name: t.name || t.uriTemplate,\n          description: t.description,\n        }));\n      } catch {\n        // Resource templates not supported\n      }\n    }\n\n    // DirectClient.listTools() returns FormattedTools (array) directly,\n    // not { tools: [...] } like the raw MCP client\n    const toolsList = Array.isArray(toolsRaw)\n      ? toolsRaw as Array<{ name: string; description?: string; inputSchema?: unknown }>\n      : ((toolsRaw as { tools?: unknown[] })?.tools || []) as Array<{ name: string; description?: string; inputSchema?: unknown }>;\n\n    const tools: ExtractedTool[] = toolsList.map((t) => ({\n      name: t.name,\n      description: t.description || '',\n      inputSchema: (t.inputSchema as Record<string, unknown>) || { type: 'object', properties: {} },\n    }));\n\n    const resources: ExtractedResource[] = (resourcesResult.resources || []).map((r) => ({\n      uri: r.uri,\n      name: r.name || r.uri,\n      description: r.description,\n      mimeType: r.mimeType,\n    }));\n\n    const prompts: ExtractedPrompt[] = (promptsResult.prompts || []).map((p) => ({\n      name: p.name,\n      description: p.description,\n      arguments: p.arguments as ExtractedPrompt['arguments'],\n    }));\n\n    const toolNameSet = new Set(tools.map((t) => t.name));\n    const capabilities: ExtractedCapabilities = {\n      skills: toolNameSet.has('searchSkills') || toolNameSet.has('loadSkills'),\n      jobs: toolNameSet.has('execute-job') || toolNameSet.has('get-job-status'),\n      workflows: toolNameSet.has('execute-workflow') || toolNameSet.has('get-workflow-status'),\n    };\n\n    // Extract job schemas if jobs capability is available\n    let jobs: ExtractedJob[] = [];\n    if (capabilities.jobs && client.listJobs) {\n      try {\n        const jobsResult = await client.listJobs();\n        jobs = (jobsResult.jobs || []).map((j) => ({\n          name: j.name,\n          description: j.description,\n          inputSchema: j.inputSchema,\n          tags: j.tags,\n        }));\n      } catch {\n        // Jobs listing not available at build time\n      }\n    }\n\n    return { tools, resources, resourceTemplates, prompts, jobs, capabilities };\n  } finally {\n    await client.close().catch(() => {});\n  }\n}\n"]}

package/src/commands/build/exec/cli-runtime/schema-to-commander.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Converts JSON Schema properties to commander.js option definitions.
+ * Used at code-generation time (not runtime) to map MCP tool input schemas
+ * to CLI option strings that commander can parse.
+ */
+export interface CommanderOption {
+    /** commander flags string, e.g. '--name <value>' */
+    flags: string;
+    /** description from JSON Schema */
+    description: string;
+    /** whether this is a required option */
+    required: boolean;
+    /** for enum types, the allowed choices */
+    choices?: string[];
+    /** default value if specified in schema */
+    defaultValue?: unknown;
+    /** coercion function name: 'parseInt', 'parseFloat', or undefined */
+    coercion?: 'parseInt' | 'parseFloat';
+    /** whether this is a variadic (array) option */
+    variadic: boolean;
+}
+export interface SchemaToCommanderResult {
+    options: CommanderOption[];
+    /** property names that couldn't be mapped */
+    skipped: string[];
+}
+/**
+ * Convert a JSON Schema `properties` object into commander option definitions.
+ */
+export declare function schemaToCommander(schema: Record<string, unknown>): SchemaToCommanderResult;
+/**
+ * Convert camelCase or PascalCase to kebab-case.
+ */
+export declare function camelToKebab(str: string): string;
+/**
+ * Generate commander option code string for embedding in generated CLI entry.
+ */
+export declare function generateOptionCode(opt: CommanderOption): string;

package/src/commands/build/exec/cli-runtime/schema-to-commander.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Converts JSON Schema properties to commander.js option definitions.
+ * Used at code-generation time (not runtime) to map MCP tool input schemas
+ * to CLI option strings that commander can parse.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaToCommander = schemaToCommander;
+exports.camelToKebab = camelToKebab;
+exports.generateOptionCode = generateOptionCode;
+/**
+ * Convert a JSON Schema `properties` object into commander option definitions.
+ */
+function schemaToCommander(schema) {
+    const properties = (schema.properties || {});
+    const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+    const options = [];
+    const skipped = [];
+    for (const [propName, propSchema] of Object.entries(properties)) {
+        const opt = propertyToOption(propName, propSchema, required.has(propName));
+        if (opt) {
+            options.push(opt);
+        }
+        else {
+            skipped.push(propName);
+        }
+    }
+    return { options, skipped };
+}
+function propertyToOption(name, schema, isRequired) {
+    const kebab = camelToKebab(name);
+    const description = schema.description || '';
+    const defaultValue = schema.default;
+    const enumValues = schema.enum;
+    // Resolve type — handle array types like ["string", "null"]
+    let type = schema.type;
+    if (Array.isArray(type)) {
+        type = type.find((t) => t !== 'null') || type[0];
+    }
+    // Handle enum — always treat as string choices
+    if (enumValues && Array.isArray(enumValues)) {
+        return {
+            flags: `--${kebab} <value>`,
+            description,
+            required: isRequired,
+            choices: enumValues.map(String),
+            defaultValue,
+            variadic: false,
+        };
+    }
+    switch (type) {
+        case 'string':
+            return {
+                flags: `--${kebab} <value>`,
+                description,
+                required: isRequired,
+                defaultValue,
+                variadic: false,
+            };
+        case 'number':
+            return {
+                flags: `--${kebab} <number>`,
+                description,
+                required: isRequired,
+                defaultValue,
+                coercion: 'parseFloat',
+                variadic: false,
+            };
+        case 'integer':
+            return {
+                flags: `--${kebab} <number>`,
+                description,
+                required: isRequired,
+                defaultValue,
+                coercion: 'parseInt',
+                variadic: false,
+            };
+        case 'boolean':
+            return {
+                flags: `--${kebab}`,
+                description,
+                required: false, // boolean flags are never "required" in commander sense
+                defaultValue: defaultValue ?? false,
+                variadic: false,
+            };
+        case 'array': {
+            const itemType = schema.items?.type;
+            const coercion = itemType === 'number'
+                ? 'parseFloat'
+                : itemType === 'integer'
+                    ? 'parseInt'
+                    : undefined;
+            return {
+                flags: `--${kebab} <items...>`,
+                description,
+                required: isRequired,
+                defaultValue,
+                coercion,
+                variadic: true,
+            };
+        }
+        case 'object':
+            // Complex objects: accept as JSON string
+            return {
+                flags: `--${kebab} <json>`,
+                description: description ? `${description} (JSON string)` : '(JSON string)',
+                required: isRequired,
+                defaultValue,
+                variadic: false,
+            };
+        default:
+            // Unknown type — skip
+            return null;
+    }
+}
+/**
+ * Convert camelCase or PascalCase to kebab-case.
+ */
+function camelToKebab(str) {
+    return str
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+/**
+ * Generate commander option code string for embedding in generated CLI entry.
+ */
+function generateOptionCode(opt) {
+    // When choices are present, use addOption(new Option(...).choices([...])) pattern
+    // because .choices() is a method on Option, not on Command
+    if (opt.choices) {
+        const parts = [];
+        parts.push(`.addOption(new Option('${opt.flags}', '${escapeStr(opt.description)}')`);
+        if (opt.coercion === 'parseInt') {
+            parts.push(`.argParser((v) => parseInt(v, 10))`);
+        }
+        else if (opt.coercion === 'parseFloat') {
+            parts.push(`.argParser((v) => parseFloat(v))`);
+        }
+        if (opt.defaultValue !== undefined && !opt.required) {
+            parts.push(`.default(${JSON.stringify(opt.defaultValue)})`);
+        }
+        if (opt.required) {
+            parts.push(`.makeOptionMandatory()`);
+        }
+        parts.push(`.choices(${JSON.stringify(opt.choices)})`);
+        parts.push(')');
+        return parts.join('');
+    }
+    const parts = [];
+    if (opt.required) {
+        parts.push(`.requiredOption('${opt.flags}', '${escapeStr(opt.description)}'`);
+    }
+    else {
+        parts.push(`.option('${opt.flags}', '${escapeStr(opt.description)}'`);
+    }
+    if (opt.coercion === 'parseInt') {
+        parts.push(`, (v) => parseInt(v, 10)`);
+    }
+    else if (opt.coercion === 'parseFloat') {
+        parts.push(`, (v) => parseFloat(v)`);
+    }
+    if (opt.defaultValue !== undefined && !opt.required) {
+        parts.push(`, ${JSON.stringify(opt.defaultValue)}`);
+    }
+    parts.push(')');
+    return parts.join('');
+}
+function escapeStr(s) {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+//# sourceMappingURL=schema-to-commander.js.map

package/src/commands/build/exec/cli-runtime/schema-to-commander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-commander.js","sourceRoot":"","sources":["../../../../../../src/commands/build/exec/cli-runtime/schema-to-commander.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Converts JSON Schema properties to commander.js option definitions.\n * Used at code-generation time (not runtime) to map MCP tool input schemas\n * to CLI option strings that commander can parse.\n */\n\nexport interface CommanderOption {\n  /** commander flags string, e.g. '--name <value>' */\n  flags: string;\n  /** description from JSON Schema */\n  description: string;\n  /** whether this is a required option */\n  required: boolean;\n  /** for enum types, the allowed choices */\n  choices?: string[];\n  /** default value if specified in schema */\n  defaultValue?: unknown;\n  /** coercion function name: 'parseInt', 'parseFloat', or undefined */\n  coercion?: 'parseInt' | 'parseFloat';\n  /** whether this is a variadic (array) option */\n  variadic: boolean;\n}\n\nexport interface SchemaToCommanderResult {\n  options: CommanderOption[];\n  /** property names that couldn't be mapped */\n  skipped: string[];\n}\n\n/**\n * Convert a JSON Schema `properties` object into commander option definitions.\n */\nexport function schemaToCommander(\n  schema: Record<string, unknown>,\n): SchemaToCommanderResult {\n  const properties = (schema.properties || {}) as Record<string, Record<string, unknown>>;\n  const required = new Set<string>(\n    Array.isArray(schema.required) ? (schema.required as string[]) : [],\n  );\n\n  const options: CommanderOption[] = [];\n  const skipped: string[] = [];\n\n  for (const [propName, propSchema] of Object.entries(properties)) {\n    const opt = propertyToOption(propName, propSchema, required.has(propName));\n    if (opt) {\n      options.push(opt);\n    } else {\n      skipped.push(propName);\n    }\n  }\n\n  return { options, skipped };\n}\n\nfunction propertyToOption(\n  name: string,\n  schema: Record<string, unknown>,\n  isRequired: boolean,\n): CommanderOption | null {\n  const kebab = camelToKebab(name);\n  const description = (schema.description as string) || '';\n  const defaultValue = schema.default;\n  const enumValues = schema.enum as string[] | undefined;\n\n  // Resolve type — handle array types like [\"string\", \"null\"]\n  let type = schema.type as string | string[] | undefined;\n  if (Array.isArray(type)) {\n    type = type.find((t) => t !== 'null') || type[0];\n  }\n\n  // Handle enum — always treat as string choices\n  if (enumValues && Array.isArray(enumValues)) {\n    return {\n      flags: `--${kebab} <value>`,\n      description,\n      required: isRequired,\n      choices: enumValues.map(String),\n      defaultValue,\n      variadic: false,\n    };\n  }\n\n  switch (type) {\n    case 'string':\n      return {\n        flags: `--${kebab} <value>`,\n        description,\n        required: isRequired,\n        defaultValue,\n        variadic: false,\n      };\n\n    case 'number':\n      return {\n        flags: `--${kebab} <number>`,\n        description,\n        required: isRequired,\n        defaultValue,\n        coercion: 'parseFloat',\n        variadic: false,\n      };\n\n    case 'integer':\n      return {\n        flags: `--${kebab} <number>`,\n        description,\n        required: isRequired,\n        defaultValue,\n        coercion: 'parseInt',\n        variadic: false,\n      };\n\n    case 'boolean':\n      return {\n        flags: `--${kebab}`,\n        description,\n        required: false, // boolean flags are never \"required\" in commander sense\n        defaultValue: defaultValue ?? false,\n        variadic: false,\n      };\n\n    case 'array': {\n      const itemType = (schema.items as Record<string, unknown>)?.type;\n      const coercion = itemType === 'number'\n        ? 'parseFloat' as const\n        : itemType === 'integer'\n          ? 'parseInt' as const\n          : undefined;\n      return {\n        flags: `--${kebab} <items...>`,\n        description,\n        required: isRequired,\n        defaultValue,\n        coercion,\n        variadic: true,\n      };\n    }\n\n    case 'object':\n      // Complex objects: accept as JSON string\n      return {\n        flags: `--${kebab} <json>`,\n        description: description ? `${description} (JSON string)` : '(JSON string)',\n        required: isRequired,\n        defaultValue,\n        variadic: false,\n      };\n\n    default:\n      // Unknown type — skip\n      return null;\n  }\n}\n\n/**\n * Convert camelCase or PascalCase to kebab-case.\n */\nexport function camelToKebab(str: string): string {\n  return str\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase();\n}\n\n/**\n * Generate commander option code string for embedding in generated CLI entry.\n */\nexport function generateOptionCode(opt: CommanderOption): string {\n  // When choices are present, use addOption(new Option(...).choices([...])) pattern\n  // because .choices() is a method on Option, not on Command\n  if (opt.choices) {\n    const parts: string[] = [];\n    parts.push(`.addOption(new Option('${opt.flags}', '${escapeStr(opt.description)}')`);\n\n    if (opt.coercion === 'parseInt') {\n      parts.push(`.argParser((v) => parseInt(v, 10))`);\n    } else if (opt.coercion === 'parseFloat') {\n      parts.push(`.argParser((v) => parseFloat(v))`);\n    }\n\n    if (opt.defaultValue !== undefined && !opt.required) {\n      parts.push(`.default(${JSON.stringify(opt.defaultValue)})`);\n    }\n\n    if (opt.required) {\n      parts.push(`.makeOptionMandatory()`);\n    }\n\n    parts.push(`.choices(${JSON.stringify(opt.choices)})`);\n    parts.push(')');\n    return parts.join('');\n  }\n\n  const parts: string[] = [];\n\n  if (opt.required) {\n    parts.push(`.requiredOption('${opt.flags}', '${escapeStr(opt.description)}'`);\n  } else {\n    parts.push(`.option('${opt.flags}', '${escapeStr(opt.description)}'`);\n  }\n\n  if (opt.coercion === 'parseInt') {\n    parts.push(`, (v) => parseInt(v, 10)`);\n  } else if (opt.coercion === 'parseFloat') {\n    parts.push(`, (v) => parseFloat(v)`);\n  }\n\n  if (opt.defaultValue !== undefined && !opt.required) {\n    parts.push(`, ${JSON.stringify(opt.defaultValue)}`);\n  }\n\n  parts.push(')');\n\n  return parts.join('');\n}\n\nfunction escapeStr(s: string): string {\n  return s.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n"]}

package/src/commands/build/exec/cli-runtime/session-manager.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Session manager for CLI executables.
+ * Generates runtime module code for managing named sessions
+ * stored in ~/.frontmcp/apps/{appName}/sessions/.
+ */
+export interface SessionInfo {
+    name: string;
+    user?: string;
+    createdAt: string;
+    lastUsedAt: string;
+    isActive: boolean;
+}
+/**
+ * Generate the session-manager runtime module source for embedding in CLI bundle.
+ */
+export declare function generateSessionManagerSource(appName: string): string;