@ductape/mcp 0.2.3 → 0.2.6

package/dist/index.js

@@ -981,7 +981,8 @@ const snippetGenerateInputSchema = payloadGenerateInputSchema.extend({
     language: z.enum(['typescript', 'python']).default('typescript'),
 });
 const schemaInputSchema = z.object({
-    module: z.enum(['app', 'product']).optional().describe('Optional. Scope the result to a single module ("app" or "product"). Omit to get the full manifest including enums.'),
+    module: z.enum(['app', 'product']).optional().describe('Optional. Scope the result to one module. With no method, returns only the compact list of available methods.'),
+    method: z.string().optional().describe('Optional method key such as "databases.create" or "notifications.update". Use with module to return only that method schema.'),
 });
 function toPrettyJson(value) {
     return JSON.stringify(value ?? {}, null, 2);
@@ -2844,6 +2845,13 @@ FALLBACKS — automatic provider switching on failure:
   fallback.dispatch [{ product, env, tag, input, schedule? }]
 
 HEALTHCHECKS — continuous probe with failure notifications:
+  Scheduled probes have a platform-owned fallback runner in the Ductape proxy. A local SDK monitor
+  may also run them: while it consistently persists a fresh lastChecked record, the proxy defers
+  that product/env/check. The proxy freshness window accounts for the SDK's batched backend status
+  flush (currently five minutes), not only the shorter probe interval. If records stop arriving and
+  the freshness window expires, the proxy automatically takes over. Do not instruct users to
+  disable the proxy fallback when using a local monitor.
+
   Workbench definition shape:
   {
     tag: "payment-health",
@@ -2851,7 +2859,7 @@ HEALTHCHECKS — continuous probe with failure notifications:
     probe: { type: "app", app: "stripe-app", event: "ping" },
     interval: 30000,    // ms between checks
     retries: 3,
-    envs: [{ slug: "prd", input: {} }],
+    envs: [{ slug: "prd", input: { path: "/health" } }],
     onFailure: {
       notifications: [{ notification: "ops-alerts", message: "payment-down",
         channels: { email: { recipients: ["ops@example.com"] } } }],
@@ -2862,8 +2870,37 @@ HEALTHCHECKS — continuous probe with failure notifications:
   health.check  [{ product, env, tag }]   → same as run
   health.status [{ product, env, tag }]   → current health status
 
-Probe types: app | database | feature | graph | message_broker | storage
-Failure actions: notification channels, HTTP webhooks, and/or message broker emit — all can
+Probe types: app | database | feature | graph | events | storage
+Canonical Events probe:
+  { type: "events", events: "statecraft-events", event: "health" }
+Do not create new probes with type/field message_broker or messageBroker; those names are deprecated
+compatibility aliases.
+
+APP HEALTHCHECK SETUP — REQUIRED DISCOVERY AND VALIDATION
+  An app healthcheck is not a generic URL ping. It invokes one action belonging to an app already
+  connected to the product. Before creating it:
+  1. Read the product's connected apps with:
+       ductape_cli("products components get --product-tag <product> --type apps --json")
+  2. Select a connected app by its product access tag. Never invent or use an unconnected app tag.
+  3. Inspect that connected app's available actions/schema using the app/schema tools. Select an
+     existing action intended to be safe for repeated health probes.
+  4. Build a payload matching that action's required input schema for every selected product
+     environment. Payloads belong in envs[].input and may differ by environment.
+  5. Create the resource with:
+       ductape_cli("resources health create --tag <product> -f <healthcheck.json> --json")
+  6. Fetch the created healthcheck and verify probe.app, probe.event, and every env payload target;
+     then run one immediate check and inspect status before relying on the schedule.
+
+  Required app probe shape:
+  {
+    probe: { type: "app", app: "<connected-app-access-tag>", event: "<existing-action-tag>" },
+    envs: [{ slug: "<product-env>", input: { ...actionPayload } }]
+  }
+  Do not create an app healthcheck when the app, action, or required payload cannot be verified.
+  The platform must reject missing/unconnected apps, unknown actions, and invalid action payloads;
+  never interpret a successful create response alone as proof that the probe is runnable.
+
+Failure actions: notification channels, HTTP webhooks, and/or Events emit — all can
   be configured simultaneously on the same healthcheck.
 Input template references: $Input{field} → maps declared input to the probe's action input.
 Provider status: available | unavailable
@@ -4647,8 +4684,23 @@ async function main() {
     };
     const schemaHandler = async (args) => {
         try {
-            const data = await getAssetSchemas(args.module);
-            return { content: [{ type: 'text', text: JSON.stringify(data ?? null, null, 2) }] };
+            if (args.method && !args.module) {
+                throw new Error('module is required when method is provided');
+            }
+            const data = await getAssetSchemas(args.module, args.method);
+            const compactData = args.module &&
+                !args.method &&
+                data &&
+                typeof data === 'object' &&
+                !Array.isArray(data.methods) &&
+                data.methods
+                ? {
+                    module: args.module,
+                    methods: Object.keys(data.methods),
+                    hint: `Call ductape_schema with module="${args.module}" and one method for its complete field schema`,
+                }
+                : data;
+            return { content: [{ type: 'text', text: JSON.stringify(compactData ?? null, null, 2) }] };
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -4686,10 +4738,10 @@ async function main() {
         }, snippetGenerateHandler);
         server.registerTool('ductape_schema', {
             title: 'Ductape Asset Schema',
-            description: 'Returns the full field manifest for Ductape asset creation/update methods, ' +
-                'derived live from the SDK Joi validators. Includes field types, required flags, ' +
-                'enum values, nested structures, and all enum constants. ' +
-                'Pass module="app" or module="product" to scope the result.\n\n' +
+            description: 'Returns a compact method index or one targeted asset schema derived from the SDK Joi validators. ' +
+                'Call with module="app" or module="product" first to list method keys, then call again with ' +
+                'module and method (for example method="databases.create") for the complete field schema. ' +
+                'Avoid calling without module unless you explicitly need the entire manifest.\n\n' +
                 'ALWAYS call this before constructing a file for "resources <type> create" or any cloud ' +
                 'import/provision operation — field shapes are not guessable from context.\n\n' +
                 'Conditional fields: some fields are returned as oneOf (an array of variant shapes). ' +

package/dist/proxy-client.d.ts

@@ -24,6 +24,6 @@ export interface IGenerateExecutablePayloadResponse {
     payload: Record<string, unknown>;
     meta: Record<string, unknown>;
 }
-export declare function getAssetSchemas(module?: string): Promise<unknown>;
+export declare function getAssetSchemas(module?: string, method?: string): Promise<unknown>;
 export declare function generateExecutablePayload<T = IGenerateExecutablePayloadResponse>(request: IGenerateExecutablePayloadRequest): Promise<T>;
 //# sourceMappingURL=proxy-client.d.ts.map

package/dist/proxy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy-client.d.ts","sourceRoot":"","sources":["../src/proxy-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,KAAK,GACL,WAAW,GACX,OAAO,GACP,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAUd;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AASD,wBAAsB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvE;AA4BD,wBAAsB,yBAAyB,CAAC,CAAC,GAAG,kCAAkC,EACpF,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAiCZ"}
+{"version":3,"file":"proxy-client.d.ts","sourceRoot":"","sources":["../src/proxy-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,KAAK,GACL,WAAW,GACX,OAAO,GACP,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAUd;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AASD,wBAAsB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBxF;AA4BD,wBAAsB,yBAAyB,CAAC,CAAC,GAAG,kCAAkC,EACpF,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAiCZ"}

package/dist/proxy-client.js

@@ -28,11 +28,22 @@ export async function executeViaProxy(publishable_key, module, method, params =
     }
     return body.data?.data;
 }
-export async function getAssetSchemas(module) {
-    const path = module ? `/proxy/v1/schema/${encodeURIComponent(module)}` : '/proxy/v1/schema';
+export async function getAssetSchemas(module, method) {
+    const path = module
+        ? `/proxy/v1/schema/${encodeURIComponent(module)}${method ? `/${encodeURIComponent(method)}` : ''}`
+        : '/proxy/v1/schema';
     const url = `${API_BASE_URL.replace(/\/$/, '')}${path}`;
     const res = await fetch(url);
     const body = (await res.json());
+    if (res.status === 404 && module && method) {
+        const fallbackUrl = `${API_BASE_URL.replace(/\/$/, '')}/proxy/v1/schema/${encodeURIComponent(module)}`;
+        const fallbackRes = await fetch(fallbackUrl);
+        const fallbackBody = (await fallbackRes.json());
+        const methodSchema = fallbackBody.data?.methods?.[method];
+        if (fallbackRes.ok && methodSchema) {
+            return { module, method, schema: methodSchema };
+        }
+    }
     if (!res.ok) {
         throw new Error(body.message ?? `Schema request failed: ${res.status}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/mcp",
-  "version": "0.2.3",
+  "version": "0.2.6",
   "description": "MCP server that exposes Ductape SDK operations via the backend proxy",
   "type": "module",
   "main": "dist/index.js",