@lessly/sdk-app 63.2.0 → 63.2.1

package/dist/playground/index.d.cts

@@ -0,0 +1 @@
+export * from '../_types/gen/playground/index.js';

package/dist/playground/index.d.ts

@@ -0,0 +1 @@
+export * from '../_types/gen/playground/index.js';

package/dist/playground/index.js

@@ -0,0 +1,58 @@
+import { wsBindings } from '../chunk-2YAA3AF4.js';
+
+// src/gen/playground/queryOptions.gen.ts
+var playgroundAnalyticsOverviewQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "analytics", "overview", input],
+  queryFn: () => sdk["playground"]["analytics"]["overview"](input)
+});
+var playgroundBillingEntitlementsQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "billing", "entitlements", input],
+  queryFn: () => sdk["playground"]["billing"]["entitlements"](input)
+});
+var playgroundBillingRecordUsageMutationOptions = (sdk) => ({
+  mutationKey: ["playground", "billing", "record-usage"],
+  mutationFn: (input) => sdk["playground"]["billing"]["record-usage"](input)
+});
+var playgroundClickupCreateTaskMutationOptions = (sdk) => ({
+  mutationKey: ["playground", "clickup", "create-task"],
+  mutationFn: (input) => sdk["playground"]["clickup"]["create-task"](input)
+});
+var playgroundClickupGetLastWebhookQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "clickup", "get-last-webhook", input],
+  queryFn: () => sdk["playground"]["clickup"]["get-last-webhook"](input)
+});
+var playgroundClickupGetOverviewQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "clickup", "get-overview", input],
+  queryFn: () => sdk["playground"]["clickup"]["get-overview"](input)
+});
+var playgroundGdriveGetLastChangeQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "gdrive", "get-last-change", input],
+  queryFn: () => sdk["playground"]["gdrive"]["get-last-change"](input)
+});
+var playgroundGdriveReadFileQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "gdrive", "read-file", input],
+  queryFn: () => sdk["playground"]["gdrive"]["read-file"](input)
+});
+var playgroundGoogleadsReadCustomerQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "googleads", "read-customer", input],
+  queryFn: () => sdk["playground"]["googleads"]["read-customer"](input)
+});
+var playgroundLifecycleGetStateQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "lifecycle", "get-state", input],
+  queryFn: () => sdk["playground"]["lifecycle"]["get-state"](input)
+});
+var playgroundLifecycleListEventsQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "lifecycle", "list-events", input],
+  queryFn: () => sdk["playground"]["lifecycle"]["list-events"](input)
+});
+var playgroundWebhookGetLastQueryOptions = (sdk, input) => ({
+  queryKey: ["playground", "webhook", "get-last", input],
+  queryFn: () => sdk["playground"]["webhook"]["get-last"](input)
+});
+
+// src/gen/playground/connect.gen.ts
+var playgroundWsEchoConnect = (sdk, input) => sdk.openStream(wsBindings["playground"]["ws"]["echo"], input);
+
+export { playgroundAnalyticsOverviewQueryOptions, playgroundBillingEntitlementsQueryOptions, playgroundBillingRecordUsageMutationOptions, playgroundClickupCreateTaskMutationOptions, playgroundClickupGetLastWebhookQueryOptions, playgroundClickupGetOverviewQueryOptions, playgroundGdriveGetLastChangeQueryOptions, playgroundGdriveReadFileQueryOptions, playgroundGoogleadsReadCustomerQueryOptions, playgroundLifecycleGetStateQueryOptions, playgroundLifecycleListEventsQueryOptions, playgroundWebhookGetLastQueryOptions, playgroundWsEchoConnect };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/playground/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/gen/playground/queryOptions.gen.ts","../../src/gen/playground/connect.gen.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// AUTOGENERATED by scripts/generate.ts — do not edit.\nimport type { GeneratedClient } from '../client.gen';\nimport type {\n  PlaygroundAnalyticsOverviewInput,\n  PlaygroundAnalyticsOverviewOutput,\n  PlaygroundBillingEntitlementsInput,\n  PlaygroundBillingEntitlementsOutput,\n  PlaygroundBillingRecordUsageInput,\n  PlaygroundClickupCreateTaskInput,\n  PlaygroundClickupGetLastWebhookInput,\n  PlaygroundClickupGetLastWebhookOutput,\n  PlaygroundClickupGetOverviewInput,\n  PlaygroundClickupGetOverviewOutput,\n  PlaygroundGdriveGetLastChangeInput,\n  PlaygroundGdriveGetLastChangeOutput,\n  PlaygroundGdriveReadFileInput,\n  PlaygroundGdriveReadFileOutput,\n  PlaygroundGoogleadsReadCustomerInput,\n  PlaygroundGoogleadsReadCustomerOutput,\n  PlaygroundLifecycleGetStateInput,\n  PlaygroundLifecycleGetStateOutput,\n  PlaygroundLifecycleListEventsInput,\n  PlaygroundLifecycleListEventsOutput,\n  PlaygroundWebhookGetLastInput,\n  PlaygroundWebhookGetLastOutput,\n} from '../types.gen';\n\nexport const playgroundAnalyticsOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundAnalyticsOverviewInput) => ({\n  queryKey: ['playground', 'analytics', 'overview', input] as const,\n  queryFn: () => sdk['playground']['analytics']['overview'](input),\n});\n\nexport const playgroundBillingEntitlementsQueryOptions = (sdk: GeneratedClient, input: PlaygroundBillingEntitlementsInput) => ({\n  queryKey: ['playground', 'billing', 'entitlements', input] as const,\n  queryFn: () => sdk['playground']['billing']['entitlements'](input),\n});\n\nexport const playgroundBillingRecordUsageMutationOptions = (sdk: GeneratedClient) => ({\n  mutationKey: ['playground', 'billing', 'record-usage'],\n  mutationFn: (input: PlaygroundBillingRecordUsageInput) => sdk['playground']['billing']['record-usage'](input),\n});\n\nexport const playgroundClickupCreateTaskMutationOptions = (sdk: GeneratedClient) => ({\n  mutationKey: ['playground', 'clickup', 'create-task'],\n  mutationFn: (input: PlaygroundClickupCreateTaskInput) => sdk['playground']['clickup']['create-task'](input),\n});\n\nexport const playgroundClickupGetLastWebhookQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetLastWebhookInput) => ({\n  queryKey: ['playground', 'clickup', 'get-last-webhook', input] as const,\n  queryFn: () => sdk['playground']['clickup']['get-last-webhook'](input),\n});\n\nexport const playgroundClickupGetOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetOverviewInput) => ({\n  queryKey: ['playground', 'clickup', 'get-overview', input] as const,\n  queryFn: () => sdk['playground']['clickup']['get-overview'](input),\n});\n\nexport const playgroundGdriveGetLastChangeQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveGetLastChangeInput) => ({\n  queryKey: ['playground', 'gdrive', 'get-last-change', input] as const,\n  queryFn: () => sdk['playground']['gdrive']['get-last-change'](input),\n});\n\nexport const playgroundGdriveReadFileQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveReadFileInput) => ({\n  queryKey: ['playground', 'gdrive', 'read-file', input] as const,\n  queryFn: () => sdk['playground']['gdrive']['read-file'](input),\n});\n\nexport const playgroundGoogleadsReadCustomerQueryOptions = (sdk: GeneratedClient, input: PlaygroundGoogleadsReadCustomerInput) => ({\n  queryKey: ['playground', 'googleads', 'read-customer', input] as const,\n  queryFn: () => sdk['playground']['googleads']['read-customer'](input),\n});\n\nexport const playgroundLifecycleGetStateQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleGetStateInput) => ({\n  queryKey: ['playground', 'lifecycle', 'get-state', input] as const,\n  queryFn: () => sdk['playground']['lifecycle']['get-state'](input),\n});\n\nexport const playgroundLifecycleListEventsQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleListEventsInput) => ({\n  queryKey: ['playground', 'lifecycle', 'list-events', input] as const,\n  queryFn: () => sdk['playground']['lifecycle']['list-events'](input),\n});\n\nexport const playgroundWebhookGetLastQueryOptions = (sdk: GeneratedClient, input: PlaygroundWebhookGetLastInput) => ({\n  queryKey: ['playground', 'webhook', 'get-last', input] as const,\n  queryFn: () => sdk['playground']['webhook']['get-last'](input),\n});\n","// AUTOGENERATED by scripts/generate.ts — do not edit.\nimport { wsBindings } from '../bindings.gen';\nimport type { LesslyStream, LesslyStreamOpener } from '../../runtime/types';\nimport type {\n  PlaygroundWsEchoInput,\n} from '../types.gen';\n\nexport const playgroundWsEchoConnect = (sdk: LesslyStreamOpener, input: PlaygroundWsEchoInput): LesslyStream =>\n  sdk.openStream(wsBindings['playground']!['ws']!['echo']!, input as Record<string, unknown>);\n"]}

package/docs/recipes/access.md

@@ -395,6 +395,23 @@ explanations. Keyboard reachability (below) is satisfied on the owning control,
 and the elements themselves just go inert — `draggable={false}`, `readOnly`,
 `disabled` — with no wrapper of their own.
 
+Some surfaces have no such control. A calendar's Month/Week toggle owns the
+*view*, not the move; a board's filter bar owns the filter, not the drop. Do not
+hang the reason on it: the reason names the operation actually gated, and
+`accessReason(app.content.publications.reschedule)` under a control that switches
+weeks explains a gate that control does not hold. Where nothing owns the
+capability, the reason goes on the **surface itself, as one `CardNote`** — the
+same shape as a deferred-save form:
+
+```tsx
+<Card title="Schedule">
+  <Calendar events={events} draggable={false} />
+  {denied && <CardNote>{accessReason(app.content.publications.reschedule)}</CardNote>}
+</Card>
+```
+
+One line for the surface, elements inert, no tooltip anywhere on the grid.
+
 ### Buttons that touch more than one operation
 
 Two shapes, and they gate differently. Get this wrong and you either grey out a
@@ -458,6 +475,25 @@ eventually send. Two failure modes, and both are common:
 So: gate the staging control on the staged operation *unless* the upstream
 control is already gated on the same one.
 
+A surface-level `CardNote` counts as that upstream gate. If the card already
+carries `accessReason` for the *same* operation, its staging controls are not
+gated on it a second time: the reader has met the sentence before starting, and
+N repetitions of it explain nothing the one line did not.
+
+What that removes is the **duplicate explanation, not the disabled state**. The
+staging or submit button stays `disabled` — with no tooltip of its own, because
+the `CardNote` is the explanation — while the draft's own fields and switches
+stay editable (they send nothing; see below). Never re-enable the button
+"because the gateway will refuse anyway": that is precisely the case this rule
+exists against, the caller doing the whole job and meeting the refusal at the end.
+
+And gate only what actually writes. Parsing a pasted CSV, rendering a preview,
+editing a local draft — anything that calls no SDK method — is **reading**, and
+gating it is forbidden: it costs the caller a capability nobody denied them.
+This rule covers the control after which a user without the right would reach
+the refusal having already done the work, with no explanation before it. A
+preview they can look at and discard is not that control.
+
 ### Forms with a deferred save
 
 A form the reader fills in and *then* saves is the one case where a hint per
@@ -552,6 +588,38 @@ frequent and not the user's mistake. Painting it as a crash teaches people to
 ignore the colour you need for real failures.
 
 
+### State keeps the error OBJECT, not its message
+
+A refusal is only classifiable while it is still an object. The moment a reducer,
+a queue item or a store slice flattens it to a string — `error: errorMessage(err)`,
+`error: err.message`, `` error: `Upload failed: ${err}` `` — `isAccessDenied` has
+nothing left to read, and a denial by role arrives red from a file that has no
+render site at all. Sweeping your render sites never finds it: the classification
+was lost upstream, in state.
+
+So state holds `unknown`, and exactly one shared component classifies it:
+
+```tsx
+// before — the refusal is a string by the time anything renders it
+type UploadItem = { id: string; error: string };
+dispatch({ type: 'failed', id, error: errorMessage(err) });
+{item.error && <ErrorState>{item.error}</ErrorState>}   // always red
+
+// after — the object survives; one component decides the words and the tone
+type UploadItem = { id: string; error: unknown };
+dispatch({ type: 'failed', id, error: err });
+{item.error && <RequestError error={item.error} />}     // isAccessDenied → neutral
+```
+
+`RequestError` is the same classifier as your shared query state — it calls
+`isAccessDenied(error)` and renders the neutral sentence for a denial, red only
+for everything else. Write it once; give every error in the App one way out.
+
+When you audit an App for this, do not comb the render sites. Comb the **state**:
+every reducer, every queue, every store slice, every `useState` whose type says
+`string | null` where an error goes. Content shipped this bug twice — an upload
+queue and a calendar — and both were invisible to a review of the screens.
+
 ### A refusal inside the kit's `ConfirmDialog`
 
 `ConfirmDialog` takes `onError?: (error: unknown) => string` — a string, and the
@@ -668,4 +736,8 @@ itself with a `role_denied` body (the neutral empty state, not the red one).
 | Leave a drag handle or inline edit ungated because it has no button | It is the same write. Set the native inactive state and wrap it. Skipping the gate is a spec'd exception, not a default. |
 | Name the headline operation on a multi-operation button | Name the level and key of the operation that actually blocked it. |
 | Put the reason in a native `title=` on the control | `disabled:pointer-events-none` swallows the hover, and a native tooltip is unreachable by keyboard and by touch. Wrap the control in a `TooltipTrigger`. |
+| Hang a surface's reason on a control that owns a different action | The reason must name the operation actually gated. No owning control means one `CardNote` on the surface. |
+| Gate a staging control the surface's `CardNote` already explains | One explanation for the same operation, not N. |
+| Gate a parse, a preview or a local draft | Nothing is sent, so nothing can be refused. Gating reading takes a capability nobody denied. |
+| Store an error as a string in a reducer, queue or store | `isAccessDenied` needs the object. A flattened refusal arrives red from a file with no render site. |
 | Disable a control because `state === 'error'` | Nothing is known about the role. Stay enabled, say nothing about the role, let the gateway answer. |

package/docs/rules.md

@@ -405,12 +405,33 @@ wrappers are thirty extra tab stops and one sentence thirty times, not thirty
 explanations. Keyboard reachability is satisfied on the owning control; the
 elements themselves just go inert.
 
+Where NO control owns the capability — a calendar whose Month/Week toggle owns
+the view and not the move — the App MUST NOT hang the reason on a control that
+owns a DIFFERENT action: the reason names the operation actually gated, and a
+level and key under a week switcher describe a gate that switcher does not hold.
+It MUST instead render ONE `CardNote` with `accessReason(op)` on the surface
+itself, with the elements left in their inactive state (`draggable={false}`) and
+no tooltip among them.
+
 A control that STAGES a change — it writes nothing itself, the write is sent
 later by a Save or an Apply — MUST be gated on the operation the staged change
 will send, UNLESS the upstream control that reaches it is already gated on that
 same operation. Never on nothing (the caller does the work and meets the refusal
 later, somewhere else) and never twice in a row.
 
+A surface `CardNote` carrying `accessReason` of that SAME operation IS such an
+upstream gate: the staging controls under it MUST NOT be gated again — one
+explanation, not N. What drops is the DUPLICATE EXPLANATION, not the disabled
+state: the staging or submit control stays disabled and carries no tooltip of its
+own (the `CardNote` speaks for it), while the draft's fields and switches stay
+editable. An App MUST NOT re-enable that control "because the gateway will
+refuse" — that is the exact scenario this rule exists against.
+
+Anything that sends NOTHING — parsing an upload, rendering a preview, editing a
+local draft — is reading, and the App MUST NOT gate it. This rule reaches only
+the control after which a caller without the right would meet the refusal having
+already done the work and with no explanation before it.
+
 A control that performs SEVERAL operations per click is disabled if ANY of them
 is denied. A DISPATCHER control — one operation per click, selected by a mode or
 a switch — MUST instead be gated on the operation it is about to call, and name
@@ -466,6 +487,14 @@ Two failure modes are worth naming, because both ship regularly:
   reason (`role_denied`, `operation_uncatalogued`, `no_tool_permission`) and
   false for every other 403 — a `tenant_blocked` is not a permission problem.
 
+State MUST keep the error OBJECT, never a string derived from it. A reducer, a
+queue item or a store slice typed `error: string` has thrown away the only thing
+`isAccessDenied` can read, so a refusal by role arrives red out of a file that
+has no render site at all — and a sweep of render sites never finds it. State
+holds `unknown`; ONE shared component classifies it (`isAccessDenied` → the
+neutral sentence, red for everything else). Audit the reducers, queues and
+stores, not the screens.
+
 Pass the generated method rather than a hand-written tool id
 (`app.access.can(app.mail.domain.create)`): the accessor path is a lossy view
 of the tool id, so a literal string can silently drift from the call it gates.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessly/sdk-app",
-  "version": "63.2.0",
+  "version": "63.2.1",
   "type": "module",
   "sideEffects": false,
   "engines": {
@@ -148,6 +148,16 @@
         "default": "./dist/organization/index.cjs"
       }
     },
+    "./playground": {
+      "import": {
+        "types": "./dist/playground/index.d.ts",
+        "default": "./dist/playground/index.js"
+      },
+      "require": {
+        "types": "./dist/playground/index.d.cts",
+        "default": "./dist/playground/index.cjs"
+      }
+    },
     "./realtime": {
       "import": {
         "types": "./dist/realtime/index.d.ts",
@@ -199,5 +209,5 @@
       }
     }
   },
-  "sdkContentHash": "sha256:dd29109a46bbe0d03bc1d40d04cb3be51eecfdcc76db40b6eceead9bf9a05f9b"
+  "sdkContentHash": "sha256:965d6441024647f1461d4e50bedeba9d79dca805ea4668ca8c9ecedefc1c0d0a"
 }

package/src/gen/bindings.gen.ts

@@ -7116,6 +7116,134 @@ export const bindings: BindingsMap = {
       }
     }
   },
+  "playground": {
+    "analytics": {
+      "overview": {
+        "level": "read",
+        "method": "POST",
+        "operationKey": "playground_analytics_overview",
+        "params": [
+          {
+            "in": "body",
+            "name": "limit"
+          }
+        ],
+        "path": "/playground/analytics/overview",
+        "readOnly": true
+      }
+    },
+    "billing": {
+      "entitlements": {
+        "level": "read",
+        "method": "POST",
+        "operationKey": "playground_billing_entitlements",
+        "path": "/playground/billing/entitlements",
+        "readOnly": true
+      },
+      "record-usage": {
+        "level": "write",
+        "method": "POST",
+        "operationKey": "playground_billing_record-usage",
+        "params": [
+          {
+            "in": "body",
+            "name": "value"
+          }
+        ],
+        "path": "/playground/billing/usage",
+        "readOnly": false
+      }
+    },
+    "clickup": {
+      "create-task": {
+        "level": "write",
+        "method": "POST",
+        "operationKey": "playground_clickup_create-task",
+        "params": [
+          {
+            "in": "body",
+            "name": "listId"
+          },
+          {
+            "in": "body",
+            "name": "name"
+          }
+        ],
+        "path": "/playground/clickup/tasks",
+        "readOnly": false
+      },
+      "get-last-webhook": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_clickup_get-last-webhook",
+        "path": "/playground/clickup/webhooks/last",
+        "readOnly": true
+      },
+      "get-overview": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_clickup_get-overview",
+        "path": "/playground/clickup/overview",
+        "readOnly": true
+      }
+    },
+    "gdrive": {
+      "get-last-change": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_gdrive_get-last-change",
+        "path": "/playground/gdrive/changes/last",
+        "readOnly": true
+      },
+      "read-file": {
+        "level": "read",
+        "method": "POST",
+        "operationKey": "playground_gdrive_read-file",
+        "params": [
+          {
+            "in": "body",
+            "name": "fileId"
+          }
+        ],
+        "path": "/playground/gdrive/file",
+        "readOnly": true
+      }
+    },
+    "googleads": {
+      "read-customer": {
+        "level": "read",
+        "method": "POST",
+        "operationKey": "playground_googleads_read-customer",
+        "path": "/playground/googleads/customer",
+        "readOnly": true
+      }
+    },
+    "lifecycle": {
+      "get-state": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_lifecycle_get-state",
+        "path": "/playground/lifecycle/state",
+        "readOnly": true
+      },
+      "list-events": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_lifecycle_list-events",
+        "path": "/playground/lifecycle/events",
+        "readOnly": true
+      }
+    },
+    "webhook": {
+      "get-last": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "playground_webhook_get-last",
+        "path": "/playground/webhooks/last",
+        "readOnly": true
+      }
+    }
+  },
   "realtime": {
     "archive": {
       "export": {
@@ -10297,4 +10425,12 @@ export const bindings: BindingsMap = {
   }
 };
 
-export const wsBindings: WsBindingsMap = {};
+export const wsBindings: WsBindingsMap = {
+  "playground": {
+    "ws": {
+      "echo": {
+        "path": "/playground/ws/echo"
+      }
+    }
+  }
+};

package/src/gen/client.gen.ts

@@ -769,6 +769,30 @@ import type {
   OrganizationXInstallOutput,
   OrganizationYoutubeInstallInput,
   OrganizationYoutubeInstallOutput,
+  PlaygroundAnalyticsOverviewInput,
+  PlaygroundAnalyticsOverviewOutput,
+  PlaygroundBillingEntitlementsInput,
+  PlaygroundBillingEntitlementsOutput,
+  PlaygroundBillingRecordUsageInput,
+  PlaygroundBillingRecordUsageOutput,
+  PlaygroundClickupCreateTaskInput,
+  PlaygroundClickupCreateTaskOutput,
+  PlaygroundClickupGetLastWebhookInput,
+  PlaygroundClickupGetLastWebhookOutput,
+  PlaygroundClickupGetOverviewInput,
+  PlaygroundClickupGetOverviewOutput,
+  PlaygroundGdriveGetLastChangeInput,
+  PlaygroundGdriveGetLastChangeOutput,
+  PlaygroundGdriveReadFileInput,
+  PlaygroundGdriveReadFileOutput,
+  PlaygroundGoogleadsReadCustomerInput,
+  PlaygroundGoogleadsReadCustomerOutput,
+  PlaygroundLifecycleGetStateInput,
+  PlaygroundLifecycleGetStateOutput,
+  PlaygroundLifecycleListEventsInput,
+  PlaygroundLifecycleListEventsOutput,
+  PlaygroundWebhookGetLastInput,
+  PlaygroundWebhookGetLastOutput,
   RealtimeArchiveExportInput,
   RealtimeArchiveExportOutput,
   RealtimeArchiveExportStatusInput,
@@ -1778,6 +1802,34 @@ export interface GeneratedClient {
       install: ((input: OrganizationYoutubeInstallInput) => Promise<OrganizationYoutubeInstallOutput>) & Operation;
     };
   };
+  playground: {
+    analytics: {
+      overview: ((input: PlaygroundAnalyticsOverviewInput) => Promise<PlaygroundAnalyticsOverviewOutput>) & Operation;
+    };
+    billing: {
+      entitlements: ((input: PlaygroundBillingEntitlementsInput) => Promise<PlaygroundBillingEntitlementsOutput>) & Operation;
+      'record-usage': ((input: PlaygroundBillingRecordUsageInput) => Promise<PlaygroundBillingRecordUsageOutput>) & Operation;
+    };
+    clickup: {
+      'create-task': ((input: PlaygroundClickupCreateTaskInput) => Promise<PlaygroundClickupCreateTaskOutput>) & Operation;
+      'get-last-webhook': ((input: PlaygroundClickupGetLastWebhookInput) => Promise<PlaygroundClickupGetLastWebhookOutput>) & Operation;
+      'get-overview': ((input: PlaygroundClickupGetOverviewInput) => Promise<PlaygroundClickupGetOverviewOutput>) & Operation;
+    };
+    gdrive: {
+      'get-last-change': ((input: PlaygroundGdriveGetLastChangeInput) => Promise<PlaygroundGdriveGetLastChangeOutput>) & Operation;
+      'read-file': ((input: PlaygroundGdriveReadFileInput) => Promise<PlaygroundGdriveReadFileOutput>) & Operation;
+    };
+    googleads: {
+      'read-customer': ((input: PlaygroundGoogleadsReadCustomerInput) => Promise<PlaygroundGoogleadsReadCustomerOutput>) & Operation;
+    };
+    lifecycle: {
+      'get-state': ((input: PlaygroundLifecycleGetStateInput) => Promise<PlaygroundLifecycleGetStateOutput>) & Operation;
+      'list-events': ((input: PlaygroundLifecycleListEventsInput) => Promise<PlaygroundLifecycleListEventsOutput>) & Operation;
+    };
+    webhook: {
+      'get-last': ((input: PlaygroundWebhookGetLastInput) => Promise<PlaygroundWebhookGetLastOutput>) & Operation;
+    };
+  };
   realtime: {
     archive: {
       export: ((input: RealtimeArchiveExportInput) => Promise<RealtimeArchiveExportOutput>) & Operation;

package/src/gen/manifest.gen.ts

@@ -1,7 +1,7 @@
 // AUTOGENERATED by scripts/generate.ts — do not edit.
 import type { ToolLevel } from '../runtime/types';
 
-export const namespaces = ['analytics', 'brain', 'consent', 'content', 'deployment', 'mail', 'observe', 'organization', 'realtime', 'support', 'tracking', 'users', 'waitlist'] as const;
+export const namespaces = ['analytics', 'brain', 'consent', 'content', 'deployment', 'mail', 'observe', 'organization', 'playground', 'realtime', 'support', 'tracking', 'users', 'waitlist'] as const;
 
 export const operations: Record<string, ToolLevel> = {
   'analytics_catalog_get': 'read',
@@ -388,6 +388,18 @@ export const operations: Record<string, ToolLevel> = {
   'organization_support_threads_list': 'read',
   'organization_x_install': 'read',
   'organization_youtube_install': 'read',
+  'playground_analytics_overview': 'read',
+  'playground_billing_entitlements': 'read',
+  'playground_billing_record-usage': 'write',
+  'playground_clickup_create-task': 'write',
+  'playground_clickup_get-last-webhook': 'read',
+  'playground_clickup_get-overview': 'read',
+  'playground_gdrive_get-last-change': 'read',
+  'playground_gdrive_read-file': 'read',
+  'playground_googleads_read-customer': 'read',
+  'playground_lifecycle_get-state': 'read',
+  'playground_lifecycle_list-events': 'read',
+  'playground_webhook_get-last': 'read',
   'realtime_archive_export': 'admin',
   'realtime_archive_export_status': 'read',
   'realtime_archive_get': 'read',

package/src/gen/playground/connect.gen.ts

@@ -0,0 +1,9 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+import { wsBindings } from '../bindings.gen';
+import type { LesslyStream, LesslyStreamOpener } from '../../runtime/types';
+import type {
+  PlaygroundWsEchoInput,
+} from '../types.gen';
+
+export const playgroundWsEchoConnect = (sdk: LesslyStreamOpener, input: PlaygroundWsEchoInput): LesslyStream =>
+  sdk.openStream(wsBindings['playground']!['ws']!['echo']!, input as Record<string, unknown>);

package/src/gen/playground/index.ts

@@ -0,0 +1,4 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+export * from './queryOptions.gen';
+export * from './connect.gen';
+export type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundBillingRecordUsageOutput, PlaygroundClickupCreateTaskInput, PlaygroundClickupCreateTaskOutput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput, PlaygroundWsEchoInput } from '../types.gen';

package/src/gen/playground/queryOptions.gen.ts

@@ -0,0 +1,86 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+import type { GeneratedClient } from '../client.gen';
+import type {
+  PlaygroundAnalyticsOverviewInput,
+  PlaygroundAnalyticsOverviewOutput,
+  PlaygroundBillingEntitlementsInput,
+  PlaygroundBillingEntitlementsOutput,
+  PlaygroundBillingRecordUsageInput,
+  PlaygroundClickupCreateTaskInput,
+  PlaygroundClickupGetLastWebhookInput,
+  PlaygroundClickupGetLastWebhookOutput,
+  PlaygroundClickupGetOverviewInput,
+  PlaygroundClickupGetOverviewOutput,
+  PlaygroundGdriveGetLastChangeInput,
+  PlaygroundGdriveGetLastChangeOutput,
+  PlaygroundGdriveReadFileInput,
+  PlaygroundGdriveReadFileOutput,
+  PlaygroundGoogleadsReadCustomerInput,
+  PlaygroundGoogleadsReadCustomerOutput,
+  PlaygroundLifecycleGetStateInput,
+  PlaygroundLifecycleGetStateOutput,
+  PlaygroundLifecycleListEventsInput,
+  PlaygroundLifecycleListEventsOutput,
+  PlaygroundWebhookGetLastInput,
+  PlaygroundWebhookGetLastOutput,
+} from '../types.gen';
+
+export const playgroundAnalyticsOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundAnalyticsOverviewInput) => ({
+  queryKey: ['playground', 'analytics', 'overview', input] as const,
+  queryFn: () => sdk['playground']['analytics']['overview'](input),
+});
+
+export const playgroundBillingEntitlementsQueryOptions = (sdk: GeneratedClient, input: PlaygroundBillingEntitlementsInput) => ({
+  queryKey: ['playground', 'billing', 'entitlements', input] as const,
+  queryFn: () => sdk['playground']['billing']['entitlements'](input),
+});
+
+export const playgroundBillingRecordUsageMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'billing', 'record-usage'],
+  mutationFn: (input: PlaygroundBillingRecordUsageInput) => sdk['playground']['billing']['record-usage'](input),
+});
+
+export const playgroundClickupCreateTaskMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'clickup', 'create-task'],
+  mutationFn: (input: PlaygroundClickupCreateTaskInput) => sdk['playground']['clickup']['create-task'](input),
+});
+
+export const playgroundClickupGetLastWebhookQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetLastWebhookInput) => ({
+  queryKey: ['playground', 'clickup', 'get-last-webhook', input] as const,
+  queryFn: () => sdk['playground']['clickup']['get-last-webhook'](input),
+});
+
+export const playgroundClickupGetOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetOverviewInput) => ({
+  queryKey: ['playground', 'clickup', 'get-overview', input] as const,
+  queryFn: () => sdk['playground']['clickup']['get-overview'](input),
+});
+
+export const playgroundGdriveGetLastChangeQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveGetLastChangeInput) => ({
+  queryKey: ['playground', 'gdrive', 'get-last-change', input] as const,
+  queryFn: () => sdk['playground']['gdrive']['get-last-change'](input),
+});
+
+export const playgroundGdriveReadFileQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveReadFileInput) => ({
+  queryKey: ['playground', 'gdrive', 'read-file', input] as const,
+  queryFn: () => sdk['playground']['gdrive']['read-file'](input),
+});
+
+export const playgroundGoogleadsReadCustomerQueryOptions = (sdk: GeneratedClient, input: PlaygroundGoogleadsReadCustomerInput) => ({
+  queryKey: ['playground', 'googleads', 'read-customer', input] as const,
+  queryFn: () => sdk['playground']['googleads']['read-customer'](input),
+});
+
+export const playgroundLifecycleGetStateQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleGetStateInput) => ({
+  queryKey: ['playground', 'lifecycle', 'get-state', input] as const,
+  queryFn: () => sdk['playground']['lifecycle']['get-state'](input),
+});
+
+export const playgroundLifecycleListEventsQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleListEventsInput) => ({
+  queryKey: ['playground', 'lifecycle', 'list-events', input] as const,
+  queryFn: () => sdk['playground']['lifecycle']['list-events'](input),
+});
+
+export const playgroundWebhookGetLastQueryOptions = (sdk: GeneratedClient, input: PlaygroundWebhookGetLastInput) => ({
+  queryKey: ['playground', 'webhook', 'get-last', input] as const,
+  queryFn: () => sdk['playground']['webhook']['get-last'](input),
+});