@ductape/mcp 0.2.3 → 0.2.4

package/dist/index.js

@@ -2844,6 +2844,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 +2858,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 +2869,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

package/package.json

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