@greatwait/contracts 0.3.1 → 0.3.2

package/generated/v1/schemas/schedules.create.request.json

@@ -182,7 +182,7 @@
     },
     "latencyClass": {
       "type": "string",
-      "enum": ["realtime", "bulk"]
+      "enum": ["auto", "bulk", "realtime"]
     },
     "lateness": {
       "type": "object",

package/generated/v1/schemas/schedules.create.response.json

@@ -29,6 +29,7 @@
           "maxLength": 128
         },
         "timingPolicyVersion": {
+          "description": "Timing policy pinned with trusted first-outbound evidence. Banded occurrences use timing-v2-service-bands (realtime 1000ms, short bulk 10000ms, bulk 60000ms from plannedFor); legacy occurrences without a band retain their recorded policy, including payg-v1, and 5000ms/15000ms thresholds. Absent timing evidence means unknown.",
           "type": "string",
           "minLength": 1,
           "maxLength": 64
@@ -50,6 +51,9 @@
           "type": "string",
           "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
         },
+        "scheduleName": {
+          "type": "string"
+        },
         "sequence": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -294,6 +298,10 @@
           "type": "string",
           "enum": ["realtime", "bulk"]
         },
+        "requestedLatencyClass": {
+          "type": "string",
+          "enum": ["auto", "bulk", "realtime"]
+        },
         "lateness": {
           "type": "object",
           "properties": {

package/generated/v1/schemas/schedules.list.query.json

@@ -65,6 +65,12 @@
       "default": "created",
       "type": "string",
       "enum": ["created", "due"]
+    },
+    "direction": {
+      "default": "asc",
+      "description": "asc (default) walks the order oldest-created or soonest-due first; desc walks it newest-created or latest-due first. A cursor continues only in the direction that issued it.",
+      "type": "string",
+      "enum": ["asc", "desc"]
     }
   }
 }

package/generated/v1/schemas/schedules.list.response.json

@@ -214,6 +214,10 @@
             "type": "string",
             "enum": ["realtime", "bulk"]
           },
+          "requestedLatencyClass": {
+            "type": "string",
+            "enum": ["auto", "bulk", "realtime"]
+          },
           "lateness": {
             "type": "object",
             "properties": {

package/generated/v1/schemas/schedules.pause.response.json

@@ -29,6 +29,7 @@
           "maxLength": 128
         },
         "timingPolicyVersion": {
+          "description": "Timing policy pinned with trusted first-outbound evidence. Banded occurrences use timing-v2-service-bands (realtime 1000ms, short bulk 10000ms, bulk 60000ms from plannedFor); legacy occurrences without a band retain their recorded policy, including payg-v1, and 5000ms/15000ms thresholds. Absent timing evidence means unknown.",
           "type": "string",
           "minLength": 1,
           "maxLength": 64
@@ -50,6 +51,9 @@
           "type": "string",
           "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
         },
+        "scheduleName": {
+          "type": "string"
+        },
         "sequence": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -294,6 +298,10 @@
           "type": "string",
           "enum": ["realtime", "bulk"]
         },
+        "requestedLatencyClass": {
+          "type": "string",
+          "enum": ["auto", "bulk", "realtime"]
+        },
         "lateness": {
           "type": "object",
           "properties": {

package/generated/v1/schemas/schedules.read.response.json

@@ -29,6 +29,7 @@
           "maxLength": 128
         },
         "timingPolicyVersion": {
+          "description": "Timing policy pinned with trusted first-outbound evidence. Banded occurrences use timing-v2-service-bands (realtime 1000ms, short bulk 10000ms, bulk 60000ms from plannedFor); legacy occurrences without a band retain their recorded policy, including payg-v1, and 5000ms/15000ms thresholds. Absent timing evidence means unknown.",
           "type": "string",
           "minLength": 1,
           "maxLength": 64
@@ -50,6 +51,9 @@
           "type": "string",
           "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
         },
+        "scheduleName": {
+          "type": "string"
+        },
         "sequence": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -294,6 +298,10 @@
           "type": "string",
           "enum": ["realtime", "bulk"]
         },
+        "requestedLatencyClass": {
+          "type": "string",
+          "enum": ["auto", "bulk", "realtime"]
+        },
         "lateness": {
           "type": "object",
           "properties": {

package/generated/v1/schemas/schedules.replace.request.json

@@ -182,7 +182,7 @@
     },
     "latencyClass": {
       "type": "string",
-      "enum": ["realtime", "bulk"]
+      "enum": ["auto", "bulk", "realtime"]
     },
     "lateness": {
       "type": "object",

package/generated/v1/schemas/schedules.replace.response.json

@@ -29,6 +29,7 @@
           "maxLength": 128
         },
         "timingPolicyVersion": {
+          "description": "Timing policy pinned with trusted first-outbound evidence. Banded occurrences use timing-v2-service-bands (realtime 1000ms, short bulk 10000ms, bulk 60000ms from plannedFor); legacy occurrences without a band retain their recorded policy, including payg-v1, and 5000ms/15000ms thresholds. Absent timing evidence means unknown.",
           "type": "string",
           "minLength": 1,
           "maxLength": 64
@@ -50,6 +51,9 @@
           "type": "string",
           "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
         },
+        "scheduleName": {
+          "type": "string"
+        },
         "sequence": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -294,6 +298,10 @@
           "type": "string",
           "enum": ["realtime", "bulk"]
         },
+        "requestedLatencyClass": {
+          "type": "string",
+          "enum": ["auto", "bulk", "realtime"]
+        },
         "lateness": {
           "type": "object",
           "properties": {

package/generated/v1/schemas/schedules.resume.response.json

@@ -29,6 +29,7 @@
           "maxLength": 128
         },
         "timingPolicyVersion": {
+          "description": "Timing policy pinned with trusted first-outbound evidence. Banded occurrences use timing-v2-service-bands (realtime 1000ms, short bulk 10000ms, bulk 60000ms from plannedFor); legacy occurrences without a band retain their recorded policy, including payg-v1, and 5000ms/15000ms thresholds. Absent timing evidence means unknown.",
           "type": "string",
           "minLength": 1,
           "maxLength": 64
@@ -50,6 +51,9 @@
           "type": "string",
           "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
         },
+        "scheduleName": {
+          "type": "string"
+        },
         "sequence": {
           "type": "integer",
           "exclusiveMinimum": 0,
@@ -294,6 +298,10 @@
           "type": "string",
           "enum": ["realtime", "bulk"]
         },
+        "requestedLatencyClass": {
+          "type": "string",
+          "enum": ["auto", "bulk", "realtime"]
+        },
         "lateness": {
           "type": "object",
           "properties": {

package/generated/v1/schemas/schedules.summary.query.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "timeZone": {
+      "description": "IANA time zone the per-day buckets are counted in; defaults to UTC.",
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}

package/generated/v1/schemas/schedules.summary.response.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "counts": {
+      "type": "object",
+      "properties": {
+        "active": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "paused": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "completed": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "cancelled": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": ["active", "paused", "completed", "cancelled"]
+    },
+    "pausedAfterFailures": {
+      "type": "object",
+      "properties": {
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "schedules": {
+          "maxItems": 5,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^sch_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
+              },
+              "name": {
+                "type": "string"
+              },
+              "autoPauseReason": {
+                "type": "object",
+                "properties": {
+                  "failedRuns": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "status": {
+                    "type": "integer",
+                    "minimum": 100,
+                    "maximum": 599
+                  },
+                  "diagnostic": {
+                    "type": "string",
+                    "maxLength": 500
+                  },
+                  "pausedAt": {
+                    "type": "string",
+                    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
+                  }
+                },
+                "required": ["failedRuns", "diagnostic", "pausedAt"]
+              }
+            },
+            "required": ["id", "autoPauseReason"]
+          }
+        }
+      },
+      "required": ["count", "schedules"]
+    },
+    "days": {
+      "minItems": 30,
+      "maxItems": 30,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+          },
+          "created": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "finished": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": ["date", "created", "finished"]
+      }
+    },
+    "window": {
+      "type": "object",
+      "properties": {
+        "from": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+        },
+        "to": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+        },
+        "timeZone": {}
+      },
+      "required": ["from", "to", "timeZone"]
+    },
+    "freshness": {
+      "type": "object",
+      "properties": {
+        "asOf": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
+        },
+        "kind": {
+          "type": "string",
+          "const": "projected"
+        },
+        "lagSeconds": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": ["asOf", "kind", "lagSeconds"]
+    }
+  },
+  "required": ["counts", "pausedAfterFailures", "days", "window", "freshness"]
+}

package/generated/v1/schemas/timing.summary.response.json

@@ -2,6 +2,75 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {
+    "bandTargets": {
+      "minItems": 3,
+      "maxItems": 3,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "serviceBand": {
+            "type": "string",
+            "enum": ["realtime", "short_bulk", "bulk"]
+          },
+          "targetMs": {
+            "anyOf": [
+              {
+                "type": "number",
+                "const": 1000
+              },
+              {
+                "type": "number",
+                "const": 10000
+              },
+              {
+                "type": "number",
+                "const": 60000
+              }
+            ]
+          },
+          "breachCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "customerBlockedCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "eligibleOutstandingBreachCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "maturedCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "verdict": {
+            "type": "string",
+            "enum": ["met", "missed", "unknown"]
+          },
+          "withinTargetCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": [
+          "serviceBand",
+          "targetMs",
+          "breachCount",
+          "customerBlockedCount",
+          "eligibleOutstandingBreachCount",
+          "maturedCount",
+          "verdict",
+          "withinTargetCount"
+        ]
+      }
+    },
     "customerBlockedCount": {
       "type": "integer",
       "minimum": 0,

package/generated/v1/snippets/billing.noticesdismiss.json

@@ -0,0 +1,6 @@
+{
+  "curl": "curl -sS -X POST \"$GREATWAIT_API_URL/v1/billing/notices/dismiss\" \\\n  --variable %GREATWAIT_API_KEY \\\n  --expand-header \"Authorization: Bearer {{GREATWAIT_API_KEY}}\" \\\n  -H 'Content-Type: application/json' \\\n  --data-binary '{\"through\":\"2026-09-10T12:00:00.000Z\"}'",
+  "environments": ["test", "live"],
+  "javascript": "import { createGreatwaitClient } from \"@greatwait/api-client\";\n\nconst greatwait = createGreatwaitClient({\n  baseUrl: process.env.GREATWAIT_API_URL,\n  credential: process.env.GREATWAIT_API_KEY,\n  fetch,\n});\n\nconst body = {\n  \"through\": \"2026-09-10T12:00:00.000Z\"\n};\n\nconst result = await greatwait.request(\"billing_noticesdismiss\", body);",
+  "mcp": "// Any MCP client, against $GREATWAIT_API_URL/mcp.\n{\n  \"arguments\": {\n    \"through\": \"2026-09-10T12:00:00.000Z\"\n  },\n  \"name\": \"billing_noticesdismiss\"\n}"
+}

package/generated/v1/snippets/projectnotifications.rotateSigningKey.json

@@ -2,5 +2,5 @@
   "curl": "curl -sS -X POST \"$GREATWAIT_API_URL/v1/projects/$GREATWAIT_PROJECTID/notification-settings/status-signing-key\" \\\n  --variable %GREATWAIT_API_KEY \\\n  --expand-header \"Authorization: Bearer {{GREATWAIT_API_KEY}}\" \\\n  -H 'Content-Type: application/json' \\\n  --data-binary '{\"expectedRevision\":1}'",
   "environments": ["test", "live"],
   "javascript": "import { createGreatwaitClient } from \"@greatwait/api-client\";\n\nconst greatwait = createGreatwaitClient({\n  baseUrl: process.env.GREATWAIT_API_URL,\n  credential: process.env.GREATWAIT_API_KEY,\n  fetch,\n});\n\nconst projectId = process.env.GREATWAIT_PROJECTID;\n\nconst body = {\n  \"expectedRevision\": 1\n};\n\nconst result = await greatwait.request(\"projectnotifications_rotateSigningKey\", projectId, body);",
-  "mcp": "// projectnotifications.rotateSigningKey is not on the MCP surface.\n// Minting or rotating returns a one-time signing secret. MCP has no negotiated secure-result channel that keeps it out of ordinary tool history. Configure preferences with projectnotifications_update, then use the dashboard or an authenticated REST/SDK/CLI client for the secret."
+  "mcp": "// projectnotifications.rotateSigningKey is not on the MCP surface.\n// Rotating returns a signing secret, and MCP has no negotiated secure-result channel that keeps it out of ordinary tool history. Choose the status webhook's endpoint with projectnotifications_update; reveal or rotate that endpoint's key on its page in the dashboard, or with endpoints.rotateSigningKey through an authenticated REST/SDK/CLI client."
 }

package/generated/v1/snippets/projects.read.json

@@ -0,0 +1,6 @@
+{
+  "curl": "curl -sS -X GET \"$GREATWAIT_API_URL/v1/projects/$GREATWAIT_PROJECTID\" \\\n  --variable %GREATWAIT_SESSION_TOKEN \\\n  --expand-header \"Authorization: Bearer {{GREATWAIT_SESSION_TOKEN}}\" \\\n  -H 'Greatwait-Project: $GREATWAIT_PROJECT' \\\n  -H 'Greatwait-Environment: $GREATWAIT_ENVIRONMENT'",
+  "environments": ["test", "live"],
+  "javascript": "import { createGreatwaitClient } from \"@greatwait/api-client\";\n\nconst named = (input, init = {}) =>\n  fetch(input, {\n    ...init,\n    headers: {\n      ...init.headers,\n      \"Greatwait-Project\": process.env.GREATWAIT_PROJECT,\n      \"Greatwait-Environment\": process.env.GREATWAIT_ENVIRONMENT,\n    },\n  });\n\nconst greatwait = createGreatwaitClient({\n  baseUrl: process.env.GREATWAIT_API_URL,\n  credential: process.env.GREATWAIT_SESSION_TOKEN,\n  fetch: named,\n});\n\nconst projectId = process.env.GREATWAIT_PROJECTID;\n\nconst result = await greatwait.request(\"projects_read\", projectId);",
+  "mcp": "// projects.read is not on the MCP surface.\n// The counted read is the deletion preview a signed-in member sees before deleting a project. Counting reads the project's whole history, so it is not offered as an agent tool; rename, archive and delete each answer with the project they changed."
+}

package/generated/v1/snippets/schedules.summary.json

@@ -0,0 +1,6 @@
+{
+  "curl": "curl -sS -X GET \"$GREATWAIT_API_URL/v1/schedule-summary\" \\\n  --variable %GREATWAIT_API_KEY \\\n  --expand-header \"Authorization: Bearer {{GREATWAIT_API_KEY}}\"",
+  "environments": ["test", "live"],
+  "javascript": "import { createGreatwaitClient } from \"@greatwait/api-client\";\n\nconst greatwait = createGreatwaitClient({\n  baseUrl: process.env.GREATWAIT_API_URL,\n  credential: process.env.GREATWAIT_API_KEY,\n  fetch,\n});\n\nconst result = await greatwait.request(\"schedules_summary\");",
+  "mcp": "// Any MCP client, against $GREATWAIT_API_URL/mcp.\n{\n  \"arguments\": {},\n  \"name\": \"schedules_summary\"\n}"
+}

package/package.json

@@ -154,5 +154,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.3.1"
+  "version": "0.3.2"
 }