@manifest-network/manifest-mcp-fred 0.1.0

package/dist/index.js

@@ -0,0 +1,211 @@
+import { createAuthToken, createLeaseDataSignMessage, createSignMessage } from "./http/auth.js";
+import { ProviderApiError, checkedFetch, getLeaseConnectionInfo, getProviderHealth, uploadLeaseData, validateProviderUrl } from "./http/provider.js";
+import { MAX_TAIL, getLeaseInfo, getLeaseLogs, getLeaseProvision, getLeaseReleases, getLeaseStatus, pollLeaseUntilReady, restartLease, updateLease } from "./http/fred.js";
+import { resolveProviderUrl } from "./tools/resolveLeaseProvider.js";
+import { appStatus } from "./tools/appStatus.js";
+import { browseCatalog, mapWithConcurrency } from "./tools/browseCatalog.js";
+import { buildManifest, buildStackManifest, deriveAppNameFromImage, getServiceNames, isStackManifest, mergeManifest, normalizePorts, parseStackManifest, validateServiceName } from "./manifest.js";
+import { deployApp } from "./tools/deployApp.js";
+import { fetchActiveLease } from "./tools/fetchActiveLease.js";
+import { getAppLogs } from "./tools/getLogs.js";
+import { restartApp } from "./tools/restartApp.js";
+import { updateApp } from "./tools/updateApp.js";
+import { CosmosClientManager, INFRASTRUCTURE_ERROR_CODES, ManifestMCPError, ManifestMCPError as ManifestMCPError$1, ManifestMCPErrorCode, ManifestMCPErrorCode as ManifestMCPErrorCode$1, VERSION, bigIntReplacer, createMnemonicServer, createValidatedConfig, jsonResponse, withErrorHandling } from "@manifest-network/manifest-mcp-core";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+//#region src/index.ts
+var FredMCPServer = class {
+	constructor(options) {
+		const config = createValidatedConfig(options.config);
+		this.walletProvider = options.walletProvider;
+		this.clientManager = CosmosClientManager.getInstance(config, this.walletProvider);
+		this.mcpServer = new McpServer({
+			name: "@manifest-network/manifest-mcp-fred",
+			version: VERSION
+		}, { capabilities: { tools: {} } });
+		this.registerTools();
+	}
+	requireSignArbitrary() {
+		if (!this.walletProvider.signArbitrary) throw new ManifestMCPError$1(ManifestMCPErrorCode$1.INVALID_CONFIG, "Wallet does not support signArbitrary (ADR-036). Required for provider authentication. Use a wallet provider that implements signArbitrary.");
+		return this.walletProvider.signArbitrary.bind(this.walletProvider);
+	}
+	async getProviderAuthToken(address, leaseUuid) {
+		const signArbitrary = this.requireSignArbitrary();
+		const timestamp = Math.floor(Date.now() / 1e3);
+		const { pub_key, signature } = await signArbitrary(address, createSignMessage(address, leaseUuid, timestamp));
+		return createAuthToken(address, leaseUuid, timestamp, pub_key.value, signature);
+	}
+	async getLeaseDataAuthToken(address, leaseUuid, metaHashHex) {
+		const signArbitrary = this.requireSignArbitrary();
+		const timestamp = Math.floor(Date.now() / 1e3);
+		const { pub_key, signature } = await signArbitrary(address, createLeaseDataSignMessage(leaseUuid, metaHashHex, timestamp));
+		return createAuthToken(address, leaseUuid, timestamp, pub_key.value, signature, metaHashHex);
+	}
+	registerTools() {
+		this.mcpServer.registerTool("browse_catalog", { description: "Browse available cloud providers and service tiers with live health checks. Use this before deploy_app to see which providers are online and what SKU sizes (e.g. docker-micro, docker-small) are available with pricing." }, withErrorHandling("browse_catalog", async () => {
+			await this.clientManager.acquireRateLimit();
+			return jsonResponse(await browseCatalog(await this.clientManager.getQueryClient()), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("app_status", {
+			description: "Get detailed status and connection info for a deployed app. Use this after deploy_app to check if an app is running and get its URL.",
+			inputSchema: { lease_uuid: z.string().uuid().describe("The lease UUID of the app to check") }
+		}, withErrorHandling("app_status", async (args) => {
+			const leaseUuid = args.lease_uuid;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			return jsonResponse(await appStatus(await this.clientManager.getQueryClient(), address, leaseUuid, (addr, uuid) => this.getProviderAuthToken(addr, uuid)), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("get_logs", {
+			description: "Get recent container logs for a deployed app. Use this to debug apps that are failing or to verify an app started correctly after deploy_app.",
+			inputSchema: {
+				lease_uuid: z.string().uuid().describe("The lease UUID of the app to get logs for"),
+				tail: z.number().int().min(1).max(MAX_TAIL).optional().describe("Number of recent log lines to retrieve")
+			}
+		}, withErrorHandling("get_logs", async (args) => {
+			const leaseUuid = args.lease_uuid;
+			const tail = args.tail;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			return jsonResponse(await getAppLogs(await this.clientManager.getQueryClient(), address, leaseUuid, (addr, uuid) => this.getProviderAuthToken(addr, uuid), tail), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("deploy_app", {
+			description: "Deploy a new containerized application. Requires funded credits (use fund_credit if needed). Creates a lease on-chain, uploads the container manifest to a provider, and polls until ready. Use browse_catalog first to see available SKU sizes.",
+			inputSchema: {
+				image: z.string().optional().describe("Docker image to deploy. Required unless services is provided."),
+				port: z.number().int().min(1).max(65535).optional().describe("Container port to expose. Required unless services is provided."),
+				size: z.string().describe("SKU tier name (e.g. \"docker-micro\", \"docker-small\")"),
+				env: z.record(z.string(), z.string()).optional().describe("Environment variables as key-value pairs"),
+				command: z.array(z.string()).optional().describe("Override container command (entrypoint)"),
+				args: z.array(z.string()).optional().describe("Arguments to the container command"),
+				user: z.string().optional().describe("User to run the container as (e.g. \"1000:1000\")"),
+				tmpfs: z.array(z.string()).optional().describe("tmpfs mounts (e.g. [\"/tmp:size=64M\"])"),
+				health_check: z.object({
+					test: z.array(z.string()),
+					interval: z.string().optional(),
+					timeout: z.string().optional(),
+					retries: z.number().int().optional(),
+					start_period: z.string().optional()
+				}).optional().describe("Container health check configuration"),
+				stop_grace_period: z.string().optional().describe("Grace period before force-killing (e.g. \"30s\")"),
+				init: z.boolean().optional().describe("Run an init process inside the container"),
+				expose: z.array(z.string()).optional().describe("Expose ports without publishing (e.g. [\"8080/tcp\"])"),
+				labels: z.record(z.string(), z.string()).optional().describe("Container labels as key-value pairs"),
+				storage: z.string().optional().describe("Storage SKU name for persistent disk (adds a second lease item)"),
+				depends_on: z.record(z.string(), z.object({ condition: z.string() })).optional().describe("Service dependencies"),
+				services: z.record(z.string(), z.object({
+					image: z.string(),
+					ports: z.record(z.string(), z.object({})).optional(),
+					env: z.record(z.string(), z.string()).optional(),
+					command: z.array(z.string()).optional(),
+					args: z.array(z.string()).optional(),
+					user: z.string().optional(),
+					tmpfs: z.array(z.string()).optional(),
+					health_check: z.object({
+						test: z.array(z.string()),
+						interval: z.string().optional(),
+						timeout: z.string().optional(),
+						retries: z.number().int().optional(),
+						start_period: z.string().optional()
+					}).optional(),
+					stop_grace_period: z.string().optional(),
+					depends_on: z.record(z.string(), z.object({ condition: z.string() })).optional(),
+					expose: z.array(z.string()).optional(),
+					labels: z.record(z.string(), z.string()).optional()
+				})).optional().describe("Multi-service stack. Mutually exclusive with image/port. Keys are service names (RFC 1123 DNS labels).")
+			}
+		}, withErrorHandling("deploy_app", async (args) => {
+			return jsonResponse(await deployApp(this.clientManager, (addr, uuid) => this.getProviderAuthToken(addr, uuid), (addr, uuid, metaHashHex) => this.getLeaseDataAuthToken(addr, uuid, metaHashHex), {
+				image: args.image,
+				port: args.port,
+				size: args.size,
+				env: args.env,
+				command: args.command,
+				args: args.args,
+				user: args.user,
+				tmpfs: args.tmpfs,
+				health_check: args.health_check,
+				stop_grace_period: args.stop_grace_period,
+				init: args.init,
+				expose: args.expose,
+				labels: args.labels,
+				storage: args.storage,
+				depends_on: args.depends_on,
+				services: args.services
+			}), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("restart_app", {
+			description: "Restart a running app via the provider without closing its lease. Use this to apply configuration changes or recover from a crash.",
+			inputSchema: { lease_uuid: z.string().uuid().describe("The lease UUID of the app to restart") }
+		}, withErrorHandling("restart_app", async (args) => {
+			const leaseUuid = args.lease_uuid;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			return jsonResponse(await restartApp(await this.clientManager.getQueryClient(), address, leaseUuid, (addr, uuid) => this.getProviderAuthToken(addr, uuid)), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("update_app", {
+			description: "Update a deployed app with a new container manifest. Use this to change the Docker image, ports, or environment variables of a running app without closing the lease.",
+			inputSchema: {
+				lease_uuid: z.string().uuid().describe("The lease UUID of the app to update"),
+				manifest: z.string().describe("The full manifest JSON string to deploy"),
+				existing_manifest: z.string().optional().describe("The current manifest JSON. When provided, the new manifest is merged over the existing one (env, ports, labels merged; other fields carried forward if not in new).")
+			}
+		}, withErrorHandling("update_app", async (args) => {
+			const manifest = args.manifest;
+			try {
+				const parsed = JSON.parse(manifest);
+				if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("must be a JSON object");
+			} catch (err) {
+				throw new ManifestMCPError$1(ManifestMCPErrorCode$1.INVALID_CONFIG, `Invalid manifest: ${err instanceof Error ? err.message : String(err)}`);
+			}
+			const leaseUuid = args.lease_uuid;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			return jsonResponse(await updateApp(await this.clientManager.getQueryClient(), address, leaseUuid, (addr, uuid) => this.getProviderAuthToken(addr, uuid), manifest, args.existing_manifest), bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("app_diagnostics", {
+			description: "Get provision diagnostics for a deployed app. Use this to debug apps stuck in provisioning or that failed to start. Returns provision status, failure count, and last error message.",
+			inputSchema: { lease_uuid: z.string().uuid().describe("The lease UUID of the app to diagnose") }
+		}, withErrorHandling("app_diagnostics", async (args) => {
+			const leaseUuid = args.lease_uuid;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			const queryClient = await this.clientManager.getQueryClient();
+			const provision = await getLeaseProvision(await resolveProviderUrl(queryClient, (await fetchActiveLease(queryClient, leaseUuid, "cannot be diagnosed")).providerUuid), leaseUuid, await this.getProviderAuthToken(address, leaseUuid));
+			return jsonResponse({
+				lease_uuid: leaseUuid,
+				provision_status: provision.status,
+				fail_count: provision.fail_count,
+				last_error: provision.last_error
+			}, bigIntReplacer);
+		}));
+		this.mcpServer.registerTool("app_releases", {
+			description: "Get release/version history for a deployed app. Use this to see what versions have been deployed, when they were created, and their status.",
+			inputSchema: { lease_uuid: z.string().uuid().describe("The lease UUID of the app to get release history for") }
+		}, withErrorHandling("app_releases", async (args) => {
+			const leaseUuid = args.lease_uuid;
+			const address = await this.walletProvider.getAddress();
+			await this.clientManager.acquireRateLimit();
+			const queryClient = await this.clientManager.getQueryClient();
+			return jsonResponse({
+				lease_uuid: leaseUuid,
+				releases: (await getLeaseReleases(await resolveProviderUrl(queryClient, (await fetchActiveLease(queryClient, leaseUuid, "releases are not available")).providerUuid), leaseUuid, await this.getProviderAuthToken(address, leaseUuid))).releases
+			}, bigIntReplacer);
+		}));
+	}
+	getServer() {
+		return this.mcpServer.server;
+	}
+	getClientManager() {
+		return this.clientManager;
+	}
+	disconnect() {
+		this.clientManager.disconnect();
+	}
+};
+function createMnemonicFredServer(config) {
+	return createMnemonicServer(config, FredMCPServer);
+}
+//#endregion
+export { FredMCPServer, INFRASTRUCTURE_ERROR_CODES, MAX_TAIL, ManifestMCPError, ManifestMCPErrorCode, ProviderApiError, appStatus, browseCatalog, buildManifest, buildStackManifest, checkedFetch, createAuthToken, createLeaseDataSignMessage, createMnemonicFredServer, createSignMessage, deployApp, deriveAppNameFromImage, fetchActiveLease, getAppLogs, getLeaseConnectionInfo, getLeaseInfo, getLeaseLogs, getLeaseProvision, getLeaseReleases, getLeaseStatus, getProviderHealth, getServiceNames, isStackManifest, mapWithConcurrency, mergeManifest, normalizePorts, parseStackManifest, pollLeaseUntilReady, resolveProviderUrl, restartApp, restartLease, updateApp, updateLease, uploadLeaseData, validateProviderUrl, validateServiceName };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["ManifestMCPError","ManifestMCPErrorCode"],"sources":["../src/index.ts"],"sourcesContent":["import type { WalletProvider } from '@manifest-network/manifest-mcp-core';\nimport {\n  bigIntReplacer,\n  CosmosClientManager,\n  createMnemonicServer,\n  createValidatedConfig,\n  jsonResponse,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type ManifestMCPServerOptions,\n  type MnemonicServerConfig,\n  VERSION,\n  withErrorHandling,\n} from '@manifest-network/manifest-mcp-core';\nimport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport {\n  createAuthToken,\n  createLeaseDataSignMessage,\n  createSignMessage,\n} from './http/auth.js';\nimport { getLeaseProvision, getLeaseReleases, MAX_TAIL } from './http/fred.js';\nimport { appStatus } from './tools/appStatus.js';\nimport { browseCatalog } from './tools/browseCatalog.js';\nimport { deployApp } from './tools/deployApp.js';\nimport { fetchActiveLease } from './tools/fetchActiveLease.js';\nimport { getAppLogs } from './tools/getLogs.js';\nimport { resolveProviderUrl } from './tools/resolveLeaseProvider.js';\nimport { restartApp } from './tools/restartApp.js';\nimport { updateApp } from './tools/updateApp.js';\n\nexport type { ManifestMCPServerOptions } from '@manifest-network/manifest-mcp-core';\nexport {\n  INFRASTRUCTURE_ERROR_CODES,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from '@manifest-network/manifest-mcp-core';\nexport {\n  type AuthTokenPayload,\n  createAuthToken,\n  createLeaseDataSignMessage,\n  createSignMessage,\n} from './http/auth.js';\nexport {\n  type FredActionResponse,\n  type FredInstanceInfo,\n  type FredLeaseInfo,\n  type FredLeaseLogs,\n  type FredLeaseProvision,\n  type FredLeaseRelease,\n  type FredLeaseReleases,\n  type FredLeaseStatus,\n  type FredServiceStatus,\n  getLeaseInfo,\n  getLeaseLogs,\n  getLeaseProvision,\n  getLeaseReleases,\n  getLeaseStatus,\n  MAX_TAIL,\n  type PollOptions,\n  pollLeaseUntilReady,\n  restartLease,\n  updateLease,\n} from './http/fred.js';\nexport {\n  type ConnectionDetails,\n  checkedFetch,\n  getLeaseConnectionInfo,\n  getProviderHealth,\n  type InstanceInfo,\n  type LeaseConnectionResponse,\n  ProviderApiError,\n  type ProviderHealthResponse,\n  type ServiceConnectionDetails,\n  uploadLeaseData,\n  validateProviderUrl,\n} from './http/provider.js';\nexport {\n  type BuildManifestOptions,\n  buildManifest,\n  buildStackManifest,\n  deriveAppNameFromImage,\n  getServiceNames,\n  isStackManifest,\n  mergeManifest,\n  normalizePorts,\n  parseStackManifest,\n  validateServiceName,\n} from './manifest.js';\nexport { appStatus } from './tools/appStatus.js';\nexport { browseCatalog, mapWithConcurrency } from './tools/browseCatalog.js';\nexport {\n  type DeployAppInput,\n  type DeployAppResult,\n  deployApp,\n  type ServiceConfig,\n} from './tools/deployApp.js';\nexport { fetchActiveLease } from './tools/fetchActiveLease.js';\nexport { getAppLogs } from './tools/getLogs.js';\nexport { resolveProviderUrl } from './tools/resolveLeaseProvider.js';\nexport { restartApp } from './tools/restartApp.js';\nexport { updateApp } from './tools/updateApp.js';\n\nexport class FredMCPServer {\n  private mcpServer: McpServer;\n  private clientManager: CosmosClientManager;\n  private walletProvider: WalletProvider;\n\n  constructor(options: ManifestMCPServerOptions) {\n    const config = createValidatedConfig(options.config);\n    this.walletProvider = options.walletProvider;\n    this.clientManager = CosmosClientManager.getInstance(\n      config,\n      this.walletProvider,\n    );\n\n    this.mcpServer = new McpServer(\n      {\n        name: '@manifest-network/manifest-mcp-fred',\n        version: VERSION,\n      },\n      {\n        capabilities: {\n          tools: {},\n        },\n      },\n    );\n\n    this.registerTools();\n  }\n\n  private requireSignArbitrary(): NonNullable<WalletProvider['signArbitrary']> {\n    if (!this.walletProvider.signArbitrary) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        'Wallet does not support signArbitrary (ADR-036). Required for provider authentication. Use a wallet provider that implements signArbitrary.',\n      );\n    }\n    return this.walletProvider.signArbitrary.bind(this.walletProvider);\n  }\n\n  private async getProviderAuthToken(\n    address: string,\n    leaseUuid: string,\n  ): Promise<string> {\n    const signArbitrary = this.requireSignArbitrary();\n    const timestamp = Math.floor(Date.now() / 1000);\n    const message = createSignMessage(address, leaseUuid, timestamp);\n    const { pub_key, signature } = await signArbitrary(address, message);\n    return createAuthToken(\n      address,\n      leaseUuid,\n      timestamp,\n      pub_key.value,\n      signature,\n    );\n  }\n\n  private async getLeaseDataAuthToken(\n    address: string,\n    leaseUuid: string,\n    metaHashHex: string,\n  ): Promise<string> {\n    const signArbitrary = this.requireSignArbitrary();\n    const timestamp = Math.floor(Date.now() / 1000);\n    const message = createLeaseDataSignMessage(\n      leaseUuid,\n      metaHashHex,\n      timestamp,\n    );\n    const { pub_key, signature } = await signArbitrary(address, message);\n    return createAuthToken(\n      address,\n      leaseUuid,\n      timestamp,\n      pub_key.value,\n      signature,\n      metaHashHex,\n    );\n  }\n\n  private registerTools(): void {\n    // -- browse_catalog --\n    this.mcpServer.registerTool(\n      'browse_catalog',\n      {\n        description:\n          'Browse available cloud providers and service tiers with live health checks. Use this before deploy_app to see which providers are online and what SKU sizes (e.g. docker-micro, docker-small) are available with pricing.',\n      },\n      withErrorHandling('browse_catalog', async () => {\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n        const result = await browseCatalog(queryClient);\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- app_status --\n    this.mcpServer.registerTool(\n      'app_status',\n      {\n        description:\n          'Get detailed status and connection info for a deployed app. Use this after deploy_app to check if an app is running and get its URL.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to check'),\n        },\n      },\n      withErrorHandling('app_status', async (args) => {\n        const leaseUuid = args.lease_uuid;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n        const result = await appStatus(\n          queryClient,\n          address,\n          leaseUuid,\n          (addr, uuid) => this.getProviderAuthToken(addr, uuid),\n        );\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- get_logs --\n    this.mcpServer.registerTool(\n      'get_logs',\n      {\n        description:\n          'Get recent container logs for a deployed app. Use this to debug apps that are failing or to verify an app started correctly after deploy_app.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to get logs for'),\n          tail: z\n            .number()\n            .int()\n            .min(1)\n            .max(MAX_TAIL)\n            .optional()\n            .describe('Number of recent log lines to retrieve'),\n        },\n      },\n      withErrorHandling('get_logs', async (args) => {\n        const leaseUuid = args.lease_uuid;\n        const tail = args.tail;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n        const result = await getAppLogs(\n          queryClient,\n          address,\n          leaseUuid,\n          (addr, uuid) => this.getProviderAuthToken(addr, uuid),\n          tail,\n        );\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- deploy_app --\n    this.mcpServer.registerTool(\n      'deploy_app',\n      {\n        description:\n          'Deploy a new containerized application. Requires funded credits (use fund_credit if needed). Creates a lease on-chain, uploads the container manifest to a provider, and polls until ready. Use browse_catalog first to see available SKU sizes.',\n        inputSchema: {\n          image: z\n            .string()\n            .optional()\n            .describe(\n              'Docker image to deploy. Required unless services is provided.',\n            ),\n          port: z\n            .number()\n            .int()\n            .min(1)\n            .max(65535)\n            .optional()\n            .describe(\n              'Container port to expose. Required unless services is provided.',\n            ),\n          size: z\n            .string()\n            .describe('SKU tier name (e.g. \"docker-micro\", \"docker-small\")'),\n          env: z\n            .record(z.string(), z.string())\n            .optional()\n            .describe('Environment variables as key-value pairs'),\n          command: z\n            .array(z.string())\n            .optional()\n            .describe('Override container command (entrypoint)'),\n          args: z\n            .array(z.string())\n            .optional()\n            .describe('Arguments to the container command'),\n          user: z\n            .string()\n            .optional()\n            .describe('User to run the container as (e.g. \"1000:1000\")'),\n          tmpfs: z\n            .array(z.string())\n            .optional()\n            .describe('tmpfs mounts (e.g. [\"/tmp:size=64M\"])'),\n          health_check: z\n            .object({\n              test: z.array(z.string()),\n              interval: z.string().optional(),\n              timeout: z.string().optional(),\n              retries: z.number().int().optional(),\n              start_period: z.string().optional(),\n            })\n            .optional()\n            .describe('Container health check configuration'),\n          stop_grace_period: z\n            .string()\n            .optional()\n            .describe('Grace period before force-killing (e.g. \"30s\")'),\n          init: z\n            .boolean()\n            .optional()\n            .describe('Run an init process inside the container'),\n          expose: z\n            .array(z.string())\n            .optional()\n            .describe('Expose ports without publishing (e.g. [\"8080/tcp\"])'),\n          labels: z\n            .record(z.string(), z.string())\n            .optional()\n            .describe('Container labels as key-value pairs'),\n          storage: z\n            .string()\n            .optional()\n            .describe(\n              'Storage SKU name for persistent disk (adds a second lease item)',\n            ),\n          depends_on: z\n            .record(z.string(), z.object({ condition: z.string() }))\n            .optional()\n            .describe('Service dependencies'),\n          services: z\n            .record(\n              z.string(),\n              z.object({\n                image: z.string(),\n                ports: z.record(z.string(), z.object({})).optional(),\n                env: z.record(z.string(), z.string()).optional(),\n                command: z.array(z.string()).optional(),\n                args: z.array(z.string()).optional(),\n                user: z.string().optional(),\n                tmpfs: z.array(z.string()).optional(),\n                health_check: z\n                  .object({\n                    test: z.array(z.string()),\n                    interval: z.string().optional(),\n                    timeout: z.string().optional(),\n                    retries: z.number().int().optional(),\n                    start_period: z.string().optional(),\n                  })\n                  .optional(),\n                stop_grace_period: z.string().optional(),\n                depends_on: z\n                  .record(z.string(), z.object({ condition: z.string() }))\n                  .optional(),\n                expose: z.array(z.string()).optional(),\n                labels: z.record(z.string(), z.string()).optional(),\n              }),\n            )\n            .optional()\n            .describe(\n              'Multi-service stack. Mutually exclusive with image/port. Keys are service names (RFC 1123 DNS labels).',\n            ),\n        },\n      },\n      withErrorHandling('deploy_app', async (args) => {\n        const result = await deployApp(\n          this.clientManager,\n          (addr, uuid) => this.getProviderAuthToken(addr, uuid),\n          (addr, uuid, metaHashHex) =>\n            this.getLeaseDataAuthToken(addr, uuid, metaHashHex),\n          {\n            image: args.image,\n            port: args.port,\n            size: args.size,\n            env: args.env,\n            command: args.command,\n            args: args.args,\n            user: args.user,\n            tmpfs: args.tmpfs,\n            health_check: args.health_check,\n            stop_grace_period: args.stop_grace_period,\n            init: args.init,\n            expose: args.expose,\n            labels: args.labels,\n            storage: args.storage,\n            depends_on: args.depends_on,\n            services: args.services,\n          },\n        );\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- restart_app --\n    this.mcpServer.registerTool(\n      'restart_app',\n      {\n        description:\n          'Restart a running app via the provider without closing its lease. Use this to apply configuration changes or recover from a crash.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to restart'),\n        },\n      },\n      withErrorHandling('restart_app', async (args) => {\n        const leaseUuid = args.lease_uuid;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n        const result = await restartApp(\n          queryClient,\n          address,\n          leaseUuid,\n          (addr, uuid) => this.getProviderAuthToken(addr, uuid),\n        );\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- update_app --\n    this.mcpServer.registerTool(\n      'update_app',\n      {\n        description:\n          'Update a deployed app with a new container manifest. Use this to change the Docker image, ports, or environment variables of a running app without closing the lease.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to update'),\n          manifest: z\n            .string()\n            .describe('The full manifest JSON string to deploy'),\n          existing_manifest: z\n            .string()\n            .optional()\n            .describe(\n              'The current manifest JSON. When provided, the new manifest is merged over the existing one (env, ports, labels merged; other fields carried forward if not in new).',\n            ),\n        },\n      },\n      withErrorHandling('update_app', async (args) => {\n        const manifest = args.manifest;\n\n        try {\n          const parsed = JSON.parse(manifest);\n          if (\n            parsed === null ||\n            typeof parsed !== 'object' ||\n            Array.isArray(parsed)\n          ) {\n            throw new Error('must be a JSON object');\n          }\n        } catch (err) {\n          throw new ManifestMCPError(\n            ManifestMCPErrorCode.INVALID_CONFIG,\n            `Invalid manifest: ${err instanceof Error ? err.message : String(err)}`,\n          );\n        }\n\n        const leaseUuid = args.lease_uuid;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n\n        const result = await updateApp(\n          queryClient,\n          address,\n          leaseUuid,\n          (addr, uuid) => this.getProviderAuthToken(addr, uuid),\n          manifest,\n          args.existing_manifest,\n        );\n        return jsonResponse(result, bigIntReplacer);\n      }),\n    );\n\n    // -- app_diagnostics --\n    this.mcpServer.registerTool(\n      'app_diagnostics',\n      {\n        description:\n          'Get provision diagnostics for a deployed app. Use this to debug apps stuck in provisioning or that failed to start. Returns provision status, failure count, and last error message.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to diagnose'),\n        },\n      },\n      withErrorHandling('app_diagnostics', async (args) => {\n        const leaseUuid = args.lease_uuid;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n\n        const lease = await fetchActiveLease(\n          queryClient,\n          leaseUuid,\n          'cannot be diagnosed',\n        );\n        const providerUrl = await resolveProviderUrl(\n          queryClient,\n          lease.providerUuid,\n        );\n        const authToken = await this.getProviderAuthToken(address, leaseUuid);\n        const provision = await getLeaseProvision(\n          providerUrl,\n          leaseUuid,\n          authToken,\n        );\n\n        return jsonResponse(\n          {\n            lease_uuid: leaseUuid,\n            provision_status: provision.status,\n            fail_count: provision.fail_count,\n            last_error: provision.last_error,\n          },\n          bigIntReplacer,\n        );\n      }),\n    );\n\n    // -- app_releases --\n    this.mcpServer.registerTool(\n      'app_releases',\n      {\n        description:\n          'Get release/version history for a deployed app. Use this to see what versions have been deployed, when they were created, and their status.',\n        inputSchema: {\n          lease_uuid: z\n            .string()\n            .uuid()\n            .describe('The lease UUID of the app to get release history for'),\n        },\n      },\n      withErrorHandling('app_releases', async (args) => {\n        const leaseUuid = args.lease_uuid;\n        const address = await this.walletProvider.getAddress();\n        await this.clientManager.acquireRateLimit();\n        const queryClient = await this.clientManager.getQueryClient();\n\n        const lease = await fetchActiveLease(\n          queryClient,\n          leaseUuid,\n          'releases are not available',\n        );\n        const providerUrl = await resolveProviderUrl(\n          queryClient,\n          lease.providerUuid,\n        );\n        const authToken = await this.getProviderAuthToken(address, leaseUuid);\n        const result = await getLeaseReleases(\n          providerUrl,\n          leaseUuid,\n          authToken,\n        );\n\n        return jsonResponse(\n          {\n            lease_uuid: leaseUuid,\n            releases: result.releases,\n          },\n          bigIntReplacer,\n        );\n      }),\n    );\n  }\n\n  getServer(): Server {\n    return this.mcpServer.server;\n  }\n\n  getClientManager(): CosmosClientManager {\n    return this.clientManager;\n  }\n\n  disconnect(): void {\n    this.clientManager.disconnect();\n  }\n}\n\nexport function createMnemonicFredServer(\n  config: MnemonicServerConfig,\n): Promise<FredMCPServer> {\n  return createMnemonicServer(config, FredMCPServer);\n}\n"],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,44 @@
+//#region src/manifest.d.ts
+interface BuildManifestOptions {
+  image: string;
+  ports: Record<string, Record<string, never>>;
+  env?: Record<string, string>;
+  command?: string[];
+  args?: string[];
+  user?: string;
+  tmpfs?: string[];
+  health_check?: {
+    test: string[];
+    interval?: string;
+    timeout?: string;
+    retries?: number;
+    start_period?: string;
+  };
+  stop_grace_period?: string;
+  init?: boolean;
+  expose?: string[];
+  labels?: Record<string, string>;
+  depends_on?: Record<string, {
+    condition: string;
+  }>;
+}
+declare function deriveAppNameFromImage(image: string): string;
+declare function validateServiceName(name: string): boolean;
+declare function buildManifest(opts: BuildManifestOptions): Record<string, unknown>;
+declare function normalizePorts(port: string): Record<string, Record<string, never>>;
+declare function buildStackManifest(opts: {
+  services: Record<string, BuildManifestOptions>;
+}): {
+  services: Record<string, unknown>;
+};
+declare function mergeManifest(newManifest: Record<string, unknown>, oldManifestJson: string): Record<string, unknown>;
+declare function isStackManifest(manifest: unknown): manifest is {
+  services: Record<string, Record<string, unknown>>;
+};
+declare function parseStackManifest(json: string): {
+  services: Record<string, Record<string, unknown>>;
+};
+declare function getServiceNames(manifest: unknown): string[];
+//#endregion
+export { BuildManifestOptions, buildManifest, buildStackManifest, deriveAppNameFromImage, getServiceNames, isStackManifest, mergeManifest, normalizePorts, parseStackManifest, validateServiceName };
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","names":[],"sources":["../src/manifest.ts"],"mappings":";UAAiB,oBAAA;EACf,KAAA;EACA,KAAA,EAAO,MAAA,SAAe,MAAA;EACtB,GAAA,GAAM,MAAA;EACN,OAAA;EACA,IAAA;EACA,IAAA;EACA,KAAA;EACA,YAAA;IACE,IAAA;IACA,QAAA;IACA,OAAA;IACA,OAAA;IACA,YAAA;EAAA;EAEF,iBAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA,GAAS,MAAA;EACT,UAAA,GAAa,MAAA;IAAiB,SAAA;EAAA;AAAA;AAAA,iBAWhB,sBAAA,CAAuB,KAAA;AAAA,iBAkCvB,mBAAA,CAAoB,IAAA;AAAA,iBAIpB,aAAA,CACd,IAAA,EAAM,oBAAA,GACL,MAAA;AAAA,iBAsBa,cAAA,CACd,IAAA,WACC,MAAA,SAAe,MAAA;AAAA,iBA+BF,kBAAA,CAAmB,IAAA;EACjC,QAAA,EAAU,MAAA,SAAe,oBAAA;AAAA;EACrB,QAAA,EAAU,MAAA;AAAA;AAAA,iBAoBA,aAAA,CACd,WAAA,EAAa,MAAA,mBACb,eAAA,WACC,MAAA;AAAA,iBA6Da,eAAA,CACd,QAAA,YACC,QAAA;EAAc,QAAA,EAAU,MAAA,SAAe,MAAA;AAAA;AAAA,iBA2B1B,kBAAA,CAAmB,IAAA;EACjC,QAAA,EAAU,MAAA,SAAe,MAAA;AAAA;AAAA,iBAuBX,eAAA,CAAgB,QAAA"}

package/dist/manifest.js

@@ -0,0 +1,122 @@
+import { DNS_LABEL_RE, ManifestMCPError, ManifestMCPErrorCode } from "@manifest-network/manifest-mcp-core";
+//#region src/manifest.ts
+const MAX_NAME_LENGTH = 32;
+function deriveAppNameFromImage(image) {
+	const lastSlash = image.lastIndexOf("/");
+	let name = lastSlash >= 0 ? image.slice(lastSlash + 1) : image;
+	const atIdx = name.indexOf("@");
+	if (atIdx >= 0) name = name.slice(0, atIdx);
+	const colonIdx = name.indexOf(":");
+	if (colonIdx >= 0) name = name.slice(0, colonIdx);
+	name = name.toLowerCase().replace(/[^a-z0-9]/g, "-");
+	name = name.replace(/-{2,}/g, "-");
+	name = name.replace(/^-+|-+$/g, "");
+	if (name.length > MAX_NAME_LENGTH) name = name.slice(0, MAX_NAME_LENGTH).replace(/-+$/, "");
+	return name;
+}
+function validateServiceName(name) {
+	return DNS_LABEL_RE.test(name);
+}
+function buildManifest(opts) {
+	const manifest = {
+		image: opts.image,
+		ports: opts.ports
+	};
+	if (opts.env) manifest.env = opts.env;
+	if (opts.command) manifest.command = opts.command;
+	if (opts.args) manifest.args = opts.args;
+	if (opts.user) manifest.user = opts.user;
+	if (opts.tmpfs) manifest.tmpfs = opts.tmpfs;
+	if (opts.health_check) manifest.health_check = opts.health_check;
+	if (opts.stop_grace_period) manifest.stop_grace_period = opts.stop_grace_period;
+	if (opts.init !== void 0) manifest.init = opts.init;
+	if (opts.expose) manifest.expose = opts.expose;
+	if (opts.labels) manifest.labels = opts.labels;
+	if (opts.depends_on) manifest.depends_on = opts.depends_on;
+	return manifest;
+}
+const VALID_PROTOCOLS = new Set(["tcp", "udp"]);
+function normalizePorts(port) {
+	const result = {};
+	for (const raw of port.split(",")) {
+		const trimmed = raw.trim();
+		if (!trimmed) continue;
+		const slashIdx = trimmed.indexOf("/");
+		const portStr = slashIdx >= 0 ? trimmed.slice(0, slashIdx) : trimmed;
+		const protocol = slashIdx >= 0 ? trimmed.slice(slashIdx + 1) : "tcp";
+		const portNum = parseInt(portStr, 10);
+		if (Number.isNaN(portNum) || portNum < 1 || portNum > 65535 || String(portNum) !== portStr) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `Invalid port: "${portStr}". Port must be a number between 1 and 65535.`);
+		if (!VALID_PROTOCOLS.has(protocol)) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `Invalid protocol: "${protocol}". Must be "tcp" or "udp".`);
+		result[`${portNum}/${protocol}`] = {};
+	}
+	return result;
+}
+function buildStackManifest(opts) {
+	const stack = {};
+	for (const [name, serviceOpts] of Object.entries(opts.services)) stack[name] = buildManifest(serviceOpts);
+	return { services: stack };
+}
+const CARRY_FORWARD_KEYS = [
+	"user",
+	"tmpfs",
+	"command",
+	"args",
+	"health_check",
+	"stop_grace_period",
+	"init",
+	"expose",
+	"depends_on"
+];
+function mergeManifest(newManifest, oldManifestJson) {
+	let old;
+	try {
+		const parsed = JSON.parse(oldManifestJson);
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "existing_manifest must be a JSON object");
+		old = parsed;
+	} catch (err) {
+		if (err instanceof SyntaxError) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `existing_manifest contains invalid JSON: ${err.message}`);
+		throw err;
+	}
+	const merged = { ...newManifest };
+	if (old.env || merged.env) merged.env = {
+		...old.env,
+		...merged.env
+	};
+	if (old.ports || merged.ports) merged.ports = {
+		...old.ports,
+		...merged.ports
+	};
+	if (old.labels || merged.labels) merged.labels = {
+		...old.labels,
+		...merged.labels
+	};
+	for (const key of CARRY_FORWARD_KEYS) if (!(key in merged) && key in old) merged[key] = old[key];
+	return merged;
+}
+function isStackManifest(manifest) {
+	if (manifest === null || typeof manifest !== "object" || Array.isArray(manifest)) return false;
+	const services = manifest.services;
+	if (services === null || typeof services !== "object" || Array.isArray(services)) return false;
+	const entries = Object.values(services);
+	if (entries.length === 0) return false;
+	return entries.every((v) => v !== null && typeof v === "object" && !Array.isArray(v) && "image" in v);
+}
+function parseStackManifest(json) {
+	let parsed;
+	try {
+		parsed = JSON.parse(json);
+	} catch (err) {
+		if (err instanceof SyntaxError) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `Stack manifest contains invalid JSON: ${err.message}`);
+		throw err;
+	}
+	if (!isStackManifest(parsed)) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "Not a valid stack manifest: expected { services: { ... } } where each service has an \"image\" key");
+	return parsed;
+}
+function getServiceNames(manifest) {
+	if (!isStackManifest(manifest)) return [];
+	return Object.keys(manifest.services);
+}
+//#endregion
+export { buildManifest, buildStackManifest, deriveAppNameFromImage, getServiceNames, isStackManifest, mergeManifest, normalizePorts, parseStackManifest, validateServiceName };
+
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../src/manifest.ts"],"sourcesContent":["export interface BuildManifestOptions {\n  image: string;\n  ports: Record<string, Record<string, never>>;\n  env?: Record<string, string>;\n  command?: string[];\n  args?: string[];\n  user?: string;\n  tmpfs?: string[];\n  health_check?: {\n    test: string[];\n    interval?: string;\n    timeout?: string;\n    retries?: number;\n    start_period?: string;\n  };\n  stop_grace_period?: string;\n  init?: boolean;\n  expose?: string[];\n  labels?: Record<string, string>;\n  depends_on?: Record<string, { condition: string }>;\n}\n\nimport {\n  DNS_LABEL_RE,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from '@manifest-network/manifest-mcp-core';\n\nconst MAX_NAME_LENGTH = 32;\n\nexport function deriveAppNameFromImage(image: string): string {\n  // Strip registry prefix (everything before the last /)\n  const lastSlash = image.lastIndexOf('/');\n  let name = lastSlash >= 0 ? image.slice(lastSlash + 1) : image;\n\n  // Strip digest (@sha256:...)\n  const atIdx = name.indexOf('@');\n  if (atIdx >= 0) {\n    name = name.slice(0, atIdx);\n  }\n\n  // Strip tag unconditionally\n  const colonIdx = name.indexOf(':');\n  if (colonIdx >= 0) {\n    name = name.slice(0, colonIdx);\n  }\n\n  // Normalize: lowercase, replace non-alphanumeric with hyphens\n  name = name.toLowerCase().replace(/[^a-z0-9]/g, '-');\n\n  // Collapse consecutive hyphens\n  name = name.replace(/-{2,}/g, '-');\n\n  // Trim leading/trailing hyphens\n  name = name.replace(/^-+|-+$/g, '');\n\n  // Truncate\n  if (name.length > MAX_NAME_LENGTH) {\n    name = name.slice(0, MAX_NAME_LENGTH).replace(/-+$/, '');\n  }\n\n  return name;\n}\n\nexport function validateServiceName(name: string): boolean {\n  return DNS_LABEL_RE.test(name);\n}\n\nexport function buildManifest(\n  opts: BuildManifestOptions,\n): Record<string, unknown> {\n  const manifest: Record<string, unknown> = {\n    image: opts.image,\n    ports: opts.ports,\n  };\n  if (opts.env) manifest.env = opts.env;\n  if (opts.command) manifest.command = opts.command;\n  if (opts.args) manifest.args = opts.args;\n  if (opts.user) manifest.user = opts.user;\n  if (opts.tmpfs) manifest.tmpfs = opts.tmpfs;\n  if (opts.health_check) manifest.health_check = opts.health_check;\n  if (opts.stop_grace_period)\n    manifest.stop_grace_period = opts.stop_grace_period;\n  if (opts.init !== undefined) manifest.init = opts.init;\n  if (opts.expose) manifest.expose = opts.expose;\n  if (opts.labels) manifest.labels = opts.labels;\n  if (opts.depends_on) manifest.depends_on = opts.depends_on;\n  return manifest;\n}\n\nconst VALID_PROTOCOLS = new Set(['tcp', 'udp']);\n\nexport function normalizePorts(\n  port: string,\n): Record<string, Record<string, never>> {\n  const result: Record<string, Record<string, never>> = {};\n  for (const raw of port.split(',')) {\n    const trimmed = raw.trim();\n    if (!trimmed) continue;\n    const slashIdx = trimmed.indexOf('/');\n    const portStr = slashIdx >= 0 ? trimmed.slice(0, slashIdx) : trimmed;\n    const protocol = slashIdx >= 0 ? trimmed.slice(slashIdx + 1) : 'tcp';\n    const portNum = parseInt(portStr, 10);\n    if (\n      Number.isNaN(portNum) ||\n      portNum < 1 ||\n      portNum > 65535 ||\n      String(portNum) !== portStr\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `Invalid port: \"${portStr}\". Port must be a number between 1 and 65535.`,\n      );\n    }\n    if (!VALID_PROTOCOLS.has(protocol)) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `Invalid protocol: \"${protocol}\". Must be \"tcp\" or \"udp\".`,\n      );\n    }\n    result[`${portNum}/${protocol}`] = {};\n  }\n  return result;\n}\n\nexport function buildStackManifest(opts: {\n  services: Record<string, BuildManifestOptions>;\n}): { services: Record<string, unknown> } {\n  const stack: Record<string, unknown> = {};\n  for (const [name, serviceOpts] of Object.entries(opts.services)) {\n    stack[name] = buildManifest(serviceOpts);\n  }\n  return { services: stack };\n}\n\nconst CARRY_FORWARD_KEYS = [\n  'user',\n  'tmpfs',\n  'command',\n  'args',\n  'health_check',\n  'stop_grace_period',\n  'init',\n  'expose',\n  'depends_on',\n] as const;\n\nexport function mergeManifest(\n  newManifest: Record<string, unknown>,\n  oldManifestJson: string,\n): Record<string, unknown> {\n  let old: Record<string, unknown>;\n  try {\n    const parsed = JSON.parse(oldManifestJson);\n    if (\n      parsed === null ||\n      typeof parsed !== 'object' ||\n      Array.isArray(parsed)\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        'existing_manifest must be a JSON object',\n      );\n    }\n    old = parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `existing_manifest contains invalid JSON: ${err.message}`,\n      );\n    }\n    throw err;\n  }\n\n  const merged: Record<string, unknown> = { ...newManifest };\n\n  // env: old defaults, new overrides\n  if (old.env || merged.env) {\n    merged.env = {\n      ...(old.env as Record<string, string> | undefined),\n      ...(merged.env as Record<string, string> | undefined),\n    };\n  }\n\n  // ports: union\n  if (old.ports || merged.ports) {\n    merged.ports = {\n      ...(old.ports as Record<string, unknown> | undefined),\n      ...(merged.ports as Record<string, unknown> | undefined),\n    };\n  }\n\n  // labels: old defaults, new overrides\n  if (old.labels || merged.labels) {\n    merged.labels = {\n      ...(old.labels as Record<string, string> | undefined),\n      ...(merged.labels as Record<string, string> | undefined),\n    };\n  }\n\n  // Carry forward from old if not present in new\n  for (const key of CARRY_FORWARD_KEYS) {\n    if (!(key in merged) && key in old) {\n      merged[key] = old[key];\n    }\n  }\n\n  return merged;\n}\n\nexport function isStackManifest(\n  manifest: unknown,\n): manifest is { services: Record<string, Record<string, unknown>> } {\n  if (\n    manifest === null ||\n    typeof manifest !== 'object' ||\n    Array.isArray(manifest)\n  ) {\n    return false;\n  }\n  const services = (manifest as Record<string, unknown>).services;\n  if (\n    services === null ||\n    typeof services !== 'object' ||\n    Array.isArray(services)\n  ) {\n    return false;\n  }\n  const entries = Object.values(services as Record<string, unknown>);\n  if (entries.length === 0) return false;\n  return entries.every(\n    (v) =>\n      v !== null &&\n      typeof v === 'object' &&\n      !Array.isArray(v) &&\n      'image' in (v as Record<string, unknown>),\n  );\n}\n\nexport function parseStackManifest(json: string): {\n  services: Record<string, Record<string, unknown>>;\n} {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `Stack manifest contains invalid JSON: ${err.message}`,\n      );\n    }\n    throw err;\n  }\n  if (!isStackManifest(parsed)) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      'Not a valid stack manifest: expected { services: { ... } } where each service has an \"image\" key',\n    );\n  }\n  return parsed;\n}\n\nexport function getServiceNames(manifest: unknown): string[] {\n  if (!isStackManifest(manifest)) return [];\n  return Object.keys(manifest.services);\n}\n"],"mappings":"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"}

package/dist/tools/appStatus.d.ts

@@ -0,0 +1,21 @@
+import { FredLeaseStatus } from "../http/fred.js";
+import { ConnectionDetails } from "../http/provider.js";
+import { LeaseState, ManifestQueryClient } from "@manifest-network/manifest-mcp-core";
+
+//#region src/tools/appStatus.d.ts
+declare function appStatus(queryClient: ManifestQueryClient, address: string, leaseUuid: string, getAuthToken: (address: string, leaseUuid: string) => Promise<string>, fetchFn?: typeof globalThis.fetch): Promise<{
+  connectionError?: string | undefined;
+  providerError?: string | undefined;
+  fredStatus?: FredLeaseStatus | undefined;
+  chainState: {
+    state: LeaseState;
+    providerUuid: string;
+    createdAt: string;
+    closedAt: string | undefined;
+  };
+  connection?: ConnectionDetails | undefined;
+  lease_uuid: string;
+}>;
+//#endregion
+export { appStatus };
+//# sourceMappingURL=appStatus.d.ts.map

package/dist/tools/appStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appStatus.d.ts","names":[],"sources":["../../src/tools/appStatus.ts"],"mappings":";;;;;iBAgBsB,SAAA,CACpB,WAAA,EAAa,mBAAA,EACb,OAAA,UACA,SAAA,UACA,YAAA,GAAe,OAAA,UAAiB,SAAA,aAAsB,OAAA,UACtD,OAAA,UAAiB,UAAA,CAAW,KAAA,GAAK,OAAA"}

package/dist/tools/appStatus.js

@@ -0,0 +1,73 @@
+import { getLeaseConnectionInfo } from "../http/provider.js";
+import { getLeaseStatus } from "../http/fred.js";
+import { resolveProviderUrl } from "./resolveLeaseProvider.js";
+import { INFRASTRUCTURE_ERROR_CODES, LeaseState, ManifestMCPError, ManifestMCPErrorCode, logger, sanitizeForLogging } from "@manifest-network/manifest-mcp-core";
+//#region src/tools/appStatus.ts
+async function appStatus(queryClient, address, leaseUuid, getAuthToken, fetchFn) {
+	const leaseResult = await queryClient.liftedinit.billing.v1.lease({ leaseUuid });
+	if (!leaseResult.lease) throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Lease "${leaseUuid}" not found on chain`);
+	const lease = leaseResult.lease;
+	const chainState = {
+		state: lease.state,
+		providerUuid: lease.providerUuid,
+		createdAt: lease.createdAt?.toISOString(),
+		closedAt: lease.closedAt?.toISOString()
+	};
+	let fredStatus = null;
+	let connection = null;
+	let providerError;
+	let connectionError;
+	if (lease.state === LeaseState.LEASE_STATE_PENDING || lease.state === LeaseState.LEASE_STATE_ACTIVE) {
+		let providerUrl;
+		try {
+			providerUrl = await resolveProviderUrl(queryClient, lease.providerUuid);
+		} catch (err) {
+			if (err instanceof ManifestMCPError && INFRASTRUCTURE_ERROR_CODES.has(err.code)) throw err;
+			const rawMsg = `Could not resolve provider: ${err instanceof Error ? err.message : String(err)}`;
+			logger.error(`[app_status] ${rawMsg}`);
+			return {
+				lease_uuid: leaseUuid,
+				chainState,
+				providerError: sanitizeForLogging(rawMsg)
+			};
+		}
+		let authToken;
+		try {
+			authToken = await getAuthToken(address, leaseUuid);
+		} catch (err) {
+			if (err instanceof ManifestMCPError && INFRASTRUCTURE_ERROR_CODES.has(err.code)) throw err;
+			const rawMsg = `Auth token error: ${err instanceof Error ? err.message : String(err)}`;
+			logger.error(`[app_status] ${rawMsg}`);
+			return {
+				lease_uuid: leaseUuid,
+				chainState,
+				providerError: sanitizeForLogging(rawMsg)
+			};
+		}
+		const [statusResult, connResult] = await Promise.allSettled([getLeaseStatus(providerUrl, leaseUuid, authToken, fetchFn), getLeaseConnectionInfo(providerUrl, leaseUuid, authToken, fetchFn)]);
+		if (statusResult.status === "fulfilled") fredStatus = statusResult.value;
+		else {
+			const rawMsg = statusResult.reason instanceof Error ? statusResult.reason.message : String(statusResult.reason);
+			logger.error(`[app_status] Failed to get lease status for ${leaseUuid}: ${rawMsg}`);
+			providerError = sanitizeForLogging(rawMsg);
+		}
+		if (connResult.status === "fulfilled") connection = connResult.value.connection;
+		else {
+			const rawMsg = connResult.reason instanceof Error ? connResult.reason.message : String(connResult.reason);
+			logger.error(`[app_status] Failed to get connection info for ${leaseUuid}: ${rawMsg}`);
+			connectionError = sanitizeForLogging(rawMsg);
+		}
+	}
+	return {
+		lease_uuid: leaseUuid,
+		...connection && { connection },
+		chainState,
+		...fredStatus && { fredStatus },
+		...providerError && { providerError },
+		...connectionError && { connectionError }
+	};
+}
+//#endregion
+export { appStatus };
+
+//# sourceMappingURL=appStatus.js.map

package/dist/tools/appStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appStatus.js","names":[],"sources":["../../src/tools/appStatus.ts"],"sourcesContent":["import {\n  INFRASTRUCTURE_ERROR_CODES,\n  LeaseState,\n  logger,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type ManifestQueryClient,\n  sanitizeForLogging,\n} from '@manifest-network/manifest-mcp-core';\nimport { type FredLeaseStatus, getLeaseStatus } from '../http/fred.js';\nimport {\n  type ConnectionDetails,\n  getLeaseConnectionInfo,\n} from '../http/provider.js';\nimport { resolveProviderUrl } from './resolveLeaseProvider.js';\n\nexport async function appStatus(\n  queryClient: ManifestQueryClient,\n  address: string,\n  leaseUuid: string,\n  getAuthToken: (address: string, leaseUuid: string) => Promise<string>,\n  fetchFn?: typeof globalThis.fetch,\n) {\n  const leaseResult = await queryClient.liftedinit.billing.v1.lease({\n    leaseUuid,\n  });\n\n  if (!leaseResult.lease) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.QUERY_FAILED,\n      `Lease \"${leaseUuid}\" not found on chain`,\n    );\n  }\n\n  const lease = leaseResult.lease;\n  const chainState = {\n    state: lease.state,\n    providerUuid: lease.providerUuid,\n    createdAt: lease.createdAt?.toISOString(),\n    closedAt: lease.closedAt?.toISOString(),\n  };\n\n  let fredStatus: FredLeaseStatus | null = null;\n  let connection: ConnectionDetails | null = null;\n  let providerError: string | undefined;\n  let connectionError: string | undefined;\n\n  if (\n    lease.state === LeaseState.LEASE_STATE_PENDING ||\n    lease.state === LeaseState.LEASE_STATE_ACTIVE\n  ) {\n    let providerUrl: string;\n    try {\n      providerUrl = await resolveProviderUrl(queryClient, lease.providerUuid);\n    } catch (err) {\n      if (\n        err instanceof ManifestMCPError &&\n        INFRASTRUCTURE_ERROR_CODES.has(err.code)\n      )\n        throw err;\n      const rawMsg = `Could not resolve provider: ${err instanceof Error ? err.message : String(err)}`;\n      logger.error(`[app_status] ${rawMsg}`);\n      return {\n        lease_uuid: leaseUuid,\n        chainState,\n        providerError: sanitizeForLogging(rawMsg) as string,\n      };\n    }\n\n    let authToken: string;\n    try {\n      authToken = await getAuthToken(address, leaseUuid);\n    } catch (err) {\n      if (\n        err instanceof ManifestMCPError &&\n        INFRASTRUCTURE_ERROR_CODES.has(err.code)\n      )\n        throw err;\n      const rawMsg = `Auth token error: ${err instanceof Error ? err.message : String(err)}`;\n      logger.error(`[app_status] ${rawMsg}`);\n      return {\n        lease_uuid: leaseUuid,\n        chainState,\n        providerError: sanitizeForLogging(rawMsg) as string,\n      };\n    }\n\n    const [statusResult, connResult] = await Promise.allSettled([\n      getLeaseStatus(providerUrl, leaseUuid, authToken, fetchFn),\n      getLeaseConnectionInfo(providerUrl, leaseUuid, authToken, fetchFn),\n    ]);\n\n    if (statusResult.status === 'fulfilled') {\n      fredStatus = statusResult.value;\n    } else {\n      const rawMsg =\n        statusResult.reason instanceof Error\n          ? statusResult.reason.message\n          : String(statusResult.reason);\n      logger.error(\n        `[app_status] Failed to get lease status for ${leaseUuid}: ${rawMsg}`,\n      );\n      providerError = sanitizeForLogging(rawMsg) as string;\n    }\n\n    if (connResult.status === 'fulfilled') {\n      connection = connResult.value.connection;\n    } else {\n      const rawMsg =\n        connResult.reason instanceof Error\n          ? connResult.reason.message\n          : String(connResult.reason);\n      logger.error(\n        `[app_status] Failed to get connection info for ${leaseUuid}: ${rawMsg}`,\n      );\n      connectionError = sanitizeForLogging(rawMsg) as string;\n    }\n  }\n\n  return {\n    lease_uuid: leaseUuid,\n    ...(connection && { connection }),\n    chainState,\n    ...(fredStatus && { fredStatus }),\n    ...(providerError && { providerError }),\n    ...(connectionError && { connectionError }),\n  };\n}\n"],"mappings":";;;;;AAgBA,eAAsB,UACpB,aACA,SACA,WACA,cACA,SACA;CACA,MAAM,cAAc,MAAM,YAAY,WAAW,QAAQ,GAAG,MAAM,EAChE,WACD,CAAC;AAEF,KAAI,CAAC,YAAY,MACf,OAAM,IAAI,iBACR,qBAAqB,cACrB,UAAU,UAAU,sBACrB;CAGH,MAAM,QAAQ,YAAY;CAC1B,MAAM,aAAa;EACjB,OAAO,MAAM;EACb,cAAc,MAAM;EACpB,WAAW,MAAM,WAAW,aAAa;EACzC,UAAU,MAAM,UAAU,aAAa;EACxC;CAED,IAAI,aAAqC;CACzC,IAAI,aAAuC;CAC3C,IAAI;CACJ,IAAI;AAEJ,KACE,MAAM,UAAU,WAAW,uBAC3B,MAAM,UAAU,WAAW,oBAC3B;EACA,IAAI;AACJ,MAAI;AACF,iBAAc,MAAM,mBAAmB,aAAa,MAAM,aAAa;WAChE,KAAK;AACZ,OACE,eAAe,oBACf,2BAA2B,IAAI,IAAI,KAAK,CAExC,OAAM;GACR,MAAM,SAAS,+BAA+B,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC9F,UAAO,MAAM,gBAAgB,SAAS;AACtC,UAAO;IACL,YAAY;IACZ;IACA,eAAe,mBAAmB,OAAO;IAC1C;;EAGH,IAAI;AACJ,MAAI;AACF,eAAY,MAAM,aAAa,SAAS,UAAU;WAC3C,KAAK;AACZ,OACE,eAAe,oBACf,2BAA2B,IAAI,IAAI,KAAK,CAExC,OAAM;GACR,MAAM,SAAS,qBAAqB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACpF,UAAO,MAAM,gBAAgB,SAAS;AACtC,UAAO;IACL,YAAY;IACZ;IACA,eAAe,mBAAmB,OAAO;IAC1C;;EAGH,MAAM,CAAC,cAAc,cAAc,MAAM,QAAQ,WAAW,CAC1D,eAAe,aAAa,WAAW,WAAW,QAAQ,EAC1D,uBAAuB,aAAa,WAAW,WAAW,QAAQ,CACnE,CAAC;AAEF,MAAI,aAAa,WAAW,YAC1B,cAAa,aAAa;OACrB;GACL,MAAM,SACJ,aAAa,kBAAkB,QAC3B,aAAa,OAAO,UACpB,OAAO,aAAa,OAAO;AACjC,UAAO,MACL,+CAA+C,UAAU,IAAI,SAC9D;AACD,mBAAgB,mBAAmB,OAAO;;AAG5C,MAAI,WAAW,WAAW,YACxB,cAAa,WAAW,MAAM;OACzB;GACL,MAAM,SACJ,WAAW,kBAAkB,QACzB,WAAW,OAAO,UAClB,OAAO,WAAW,OAAO;AAC/B,UAAO,MACL,kDAAkD,UAAU,IAAI,SACjE;AACD,qBAAkB,mBAAmB,OAAO;;;AAIhD,QAAO;EACL,YAAY;EACZ,GAAI,cAAc,EAAE,YAAY;EAChC;EACA,GAAI,cAAc,EAAE,YAAY;EAChC,GAAI,iBAAiB,EAAE,eAAe;EACtC,GAAI,mBAAmB,EAAE,iBAAiB;EAC3C"}

package/dist/tools/browseCatalog.d.ts

@@ -0,0 +1,27 @@
+import { ManifestQueryClient } from "@manifest-network/manifest-mcp-core";
+
+//#region src/tools/browseCatalog.d.ts
+/**
+ * Run an array of async functions with a concurrency limit.
+ * Returns results in the same order as the input.
+ */
+declare function mapWithConcurrency<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]>;
+declare function browseCatalog(queryClient: ManifestQueryClient, fetchFn?: typeof globalThis.fetch): Promise<{
+  providers: {
+    healthError?: string | undefined;
+    uuid: string;
+    address: string;
+    apiUrl: string;
+    active: boolean;
+    healthy: boolean;
+    providerUuid: string | undefined;
+  }[];
+  tiers: Record<string, {
+    provider: string;
+    price: string | null;
+    unit: string | null;
+  }[]>;
+}>;
+//#endregion
+export { browseCatalog, mapWithConcurrency };
+//# sourceMappingURL=browseCatalog.d.ts.map

package/dist/tools/browseCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browseCatalog.d.ts","names":[],"sources":["../../src/tools/browseCatalog.ts"],"mappings":";;;;;AAgBA;;iBAAsB,kBAAA,MAAA,CACpB,KAAA,EAAO,CAAA,IACP,KAAA,UACA,EAAA,GAAK,IAAA,EAAM,CAAA,KAAM,OAAA,CAAQ,CAAA,IACxB,OAAA,CAAQ,CAAA;AAAA,iBAiBW,aAAA,CACpB,WAAA,EAAa,mBAAA,EACb,OAAA,UAAiB,UAAA,CAAW,KAAA,GAAK,OAAA"}