@terrantula/sdk 0.8.1 → 0.9.1

package/dist/{chunk-NVHWMOWP.mjs → chunk-OXOF623W.mjs}

@@ -73,19 +73,19 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     get: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       (params) => call(cloud.orgs[":id"].$get({ param: params }))
     ),
     listUsers: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       (params) => call(cloud.orgs[":id"].users.$get({ param: params }))
     ),
     inviteUser: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         email: z.string().describe("User email"),
         name: z.string().describe("User full name"),
         role: z.enum(["owner", "admin", "member"]).optional().describe("Role (owner|admin|member)")
@@ -97,7 +97,7 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     updateUserRole: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         userId: z.string().describe("User ID"),
         role: z.enum(["owner", "admin", "member"]).describe("New role")
       }),
@@ -110,26 +110,26 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     removeUser: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         userId: z.string().describe("User ID")
       }),
       (params) => call(cloud.orgs[":id"].users[":userId"].$delete({ param: params }))
     ),
     leave: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       (params) => call(cloud.orgs[":id"].leave.$post({ param: params }))
     ),
     delete: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       (params) => call(cloud.orgs[":id"].$delete({ param: params }))
     ),
     listPersonalTokens: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       async (params) => callPersonalTokens(
         await personalTokensRequest(baseUrl, hcOpts, `/orgs/${params.id}/personal-tokens`)
@@ -137,7 +137,7 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     createPersonalToken: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         name: z.string().describe("Token label"),
         expiresAt: z.string().datetime().optional().describe("Optional ISO expiry")
       }),
@@ -154,7 +154,7 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     revokePersonalToken: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         tokenId: z.string().describe("Personal token ID")
       }),
       async (params) => callPersonalTokens(
@@ -168,7 +168,7 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     listSsoExtras: withSchema(
       z.object({
-        id: z.string().describe("Organization ID")
+        id: z.string().describe("Organization ID or slug")
       }),
       async (params) => callPersonalTokens(
         await personalTokensRequest(baseUrl, hcOpts, `/orgs/${params.id}/sso-extras`)
@@ -176,7 +176,7 @@ function createOrgsClient(cloud, baseUrl, hcOpts) {
     ),
     setSsoForce: withSchema(
       z.object({
-        id: z.string().describe("Organization ID"),
+        id: z.string().describe("Organization ID or slug"),
         providerId: z.string().describe("SSO provider ID"),
         forceSso: z.boolean().describe("Force-SSO toggle for this provider")
       }),
@@ -203,13 +203,13 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
   return {
     list: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID")
+        orgId: z2.string().describe("Organization slug")
       }),
       (params) => call(cloud.orgs[":orgId"].projects.$get({ param: params }))
     ),
     create: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
+        orgId: z2.string().describe("Organization slug"),
         name: z2.string().describe("Project name"),
         slug: z2.string().describe("URL slug (lowercase, hyphens only)")
       }),
@@ -220,22 +220,22 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     get: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID")
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name")
       }),
       (params) => call(cloud.orgs[":orgId"].projects[":projectId"].$get({ param: params }))
     ),
     delete: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID")
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name")
       }),
       (params) => call(cloud.orgs[":orgId"].projects[":projectId"].$delete({ param: params }))
     ),
     update: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         name: z2.string().optional().describe("New project name"),
         metadata: z2.record(z2.unknown()).optional().describe("Per-project UI settings")
       }),
@@ -251,15 +251,15 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     listMembers: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID")
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name")
       }),
       (params) => call(cloud.orgs[":orgId"].projects[":projectId"].members.$get({ param: params }))
     ),
     addMember: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         userId: z2.string().describe("User ID"),
         role: z2.enum(["owner", "admin", "member", "viewer"]).optional().describe("Role (owner|admin|member|viewer)"),
         envName: z2.string().optional().describe("Optional env scope; omit for project-wide access")
@@ -276,8 +276,8 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     removeMember: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         userId: z2.string().describe("User ID")
       }),
       (params) => call(
@@ -288,8 +288,8 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     updateCellScopes: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         userId: z2.string().describe("User ID"),
         cellScopes: z2.union([z2.array(z2.string()), z2.null()]).describe("null = all cells; array = restrict to listed cell-label values")
       }),
@@ -305,8 +305,8 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     listTokens: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID")
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name")
       }),
       (params) => call(
         hc(
@@ -317,8 +317,8 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     createToken: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         name: z2.string().describe("Token name"),
         role: z2.enum(["owner", "admin", "member", "viewer"]).optional().describe("Role (owner|admin|member|viewer)"),
         expiresAt: z2.string().optional().describe("Expiry timestamp (ISO 8601)"),
@@ -339,8 +339,8 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     ),
     revokeToken: withSchema(
       z2.object({
-        orgId: z2.string().describe("Organization ID"),
-        projectId: z2.string().describe("Project ID"),
+        orgId: z2.string().describe("Organization slug"),
+        projectId: z2.string().describe("Project name"),
         tokenId: z2.string().describe("Token ID")
       }),
       (params) => call(
@@ -359,7 +359,7 @@ function createProjectsClient(cloud, baseUrl, hcOpts) {
     nuke: withSchema(
       z2.object({
         orgId: z2.string().describe("Organization slug"),
-        projectId: z2.string().describe("Project ID to nuke")
+        projectId: z2.string().describe("Project name to nuke")
       }),
       async (params) => {
         const url = `${baseUrl}/${encodeURIComponent(params.orgId)}/${encodeURIComponent(params.projectId)}/nuke`;
@@ -396,14 +396,14 @@ function createEntityTypesClient(proj) {
     list: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID")
+        projectId: z3.string().describe("Project name")
       }),
       (params) => call(proj(params.orgId, params.projectId)["entity-types"].$get())
     ),
     get: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         name: z3.string().describe("Entity type name")
       }),
       (params) => call(proj(params.orgId, params.projectId)["entity-types"][":name"].$get({ param: { name: params.name } }))
@@ -411,7 +411,7 @@ function createEntityTypesClient(proj) {
     create: withSchema(
       EntityTypeSchema.extend({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID")
+        projectId: z3.string().describe("Project name")
       }),
       (params) => {
         const { orgId, projectId, ...body } = params;
@@ -421,7 +421,7 @@ function createEntityTypesClient(proj) {
     update: withSchema(
       EntityTypeSchema.extend({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID")
+        projectId: z3.string().describe("Project name")
       }),
       (params) => {
         const { orgId, projectId, ...body } = params;
@@ -433,7 +433,7 @@ function createEntityTypesClient(proj) {
     delete: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         name: z3.string().describe("Entity type name")
       }),
       (params) => call(
@@ -447,11 +447,10 @@ function createEntitiesClient(projEnv) {
     list: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
         entityType: z3.string().optional().describe("Filter by entity type"),
         state: z3.string().optional().describe("Filter by state"),
-        pool: z3.string().optional().describe("Filter by pool membership"),
         limit: z3.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)"),
         cursor: z3.string().optional().describe("Pagination cursor")
       }),
@@ -465,16 +464,16 @@ function createEntitiesClient(projEnv) {
     get: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        id: z3.string().uuid().describe("Entity ID")
+        name: z3.string().describe("Entity name")
       }),
-      (params) => call(projEnv(params.orgId, params.projectId, params.envName)["entities"][":id"].$get({ param: { id: params.id } }))
+      (params) => call(projEnv(params.orgId, params.projectId, params.envName)["entities"][":name"].$get({ param: { name: params.name } }))
     ),
     create: withSchema(
       EntitySchema.extend({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name")
       }),
       (params) => {
@@ -485,28 +484,28 @@ function createEntitiesClient(projEnv) {
     delete: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        id: z3.string().uuid().describe("Entity ID")
+        name: z3.string().describe("Entity name")
       }),
       (params) => call(
-        projEnv(params.orgId, params.projectId, params.envName)["entities"][":id"].$delete({ param: { id: params.id } })
+        projEnv(params.orgId, params.projectId, params.envName)["entities"][":name"].$delete({ param: { name: params.name } })
       )
     ),
     setMetric: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        id: z3.string().uuid().describe("Entity ID"),
+        name: z3.string().describe("Entity name"),
         metricName: z3.string().describe("Metric name"),
         value: z3.number().describe("Metric value")
       }),
       (params) => {
-        const { orgId, projectId, envName, id, metricName, value } = params;
+        const { orgId, projectId, envName, name, metricName, value } = params;
         return call(
-          projEnv(orgId, projectId, envName)["entities"][":id"]["metrics"][":metricName"].$put({
-            param: { id, metricName },
+          projEnv(orgId, projectId, envName)["entities"][":name"]["metrics"][":metricName"].$put({
+            param: { name, metricName },
             json: { value }
           })
         );
@@ -515,18 +514,18 @@ function createEntitiesClient(projEnv) {
     trigger: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        id: z3.string().uuid().describe("Entity ID"),
+        name: z3.string().describe("Entity name"),
         actionName: z3.string().describe("Action name"),
         parameters: z3.record(z3.unknown()).optional().describe("Action parameters as JSON"),
         recommendations: z3.record(z3.string()).optional().describe("Recommendation selections as JSON")
       }).describe("Trigger an instance-scope action on a single entity"),
       (params) => {
-        const { orgId, projectId, envName, id, actionName, parameters, recommendations } = params;
+        const { orgId, projectId, envName, name, actionName, parameters, recommendations } = params;
         return call(
-          projEnv(orgId, projectId, envName)["entities"][":id"]["actions"][":actionName"].$post({
-            param: { id, actionName },
+          projEnv(orgId, projectId, envName)["entities"][":name"]["actions"][":actionName"].$post({
+            param: { name, actionName },
             json: { parameters, recommendations }
           })
         );
@@ -535,24 +534,24 @@ function createEntitiesClient(projEnv) {
     getMetrics: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        entityId: z3.string().describe("Entity ID")
+        name: z3.string().describe("Entity name")
       }),
-      (params) => call(projEnv(params.orgId, params.projectId, params.envName).entities[":id"].metrics.$get({ param: { id: params.entityId } }))
+      (params) => call(projEnv(params.orgId, params.projectId, params.envName).entities[":name"].metrics.$get({ param: { name: params.name } }))
     ),
     getMetricsBatch: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        entityIds: z3.array(z3.string().uuid()).min(1).max(500).describe("Entity IDs to fetch metrics for (max 500)")
+        names: z3.array(z3.string()).min(1).max(500).describe("Entity names to fetch metrics for (max 500)")
       }),
       (params) => {
-        const { orgId, projectId, envName, entityIds } = params;
+        const { orgId, projectId, envName, names } = params;
         return call(
           projEnv(orgId, projectId, envName).entities.metrics.$get({
-            query: { ids: entityIds.join(",") }
+            query: { names: names.join(",") }
           })
         );
       }
@@ -560,26 +559,26 @@ function createEntitiesClient(projEnv) {
     getRelationships: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        entityId: z3.string().describe("Entity ID")
+        name: z3.string().describe("Entity name")
       }),
-      (params) => call(projEnv(params.orgId, params.projectId, params.envName).entities[":id"].relationships.$get({ param: { id: params.entityId } }))
+      (params) => call(projEnv(params.orgId, params.projectId, params.envName).entities[":name"].relationships.$get({ param: { name: params.name } }))
     ),
     syncStamp: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
-        projectId: z3.string().describe("Project ID"),
+        projectId: z3.string().describe("Project name"),
         envName: z3.string().describe("Environment name"),
-        id: z3.string().uuid().describe("Entity ID"),
+        name: z3.string().describe("Entity name"),
         source: z3.string().min(1).describe("Source-of-truth name (e.g. argo, k8s, aws)"),
         observedAt: z3.string().datetime().optional().describe("ISO-8601 observation timestamp; defaults to server time")
       }),
       (params) => {
-        const { orgId, projectId, envName, id, source, observedAt } = params;
+        const { orgId, projectId, envName, name, source, observedAt } = params;
         return call(
-          projEnv(orgId, projectId, envName)["entities"][":id"]["sync-stamp"].$post({
-            param: { id },
+          projEnv(orgId, projectId, envName)["entities"][":name"]["sync-stamp"].$post({
+            param: { name },
             json: { source, observedAt }
           })
         );
@@ -757,14 +756,14 @@ function createRelationshipTypesClient(proj) {
     list: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID")
+        projectId: z6.string().describe("Project name")
       }),
       (params) => call(proj(params.orgId, params.projectId)["relationship-types"].$get())
     ),
     get: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         name: z6.string().describe("Relationship type name")
       }),
       (params) => call(
@@ -776,7 +775,7 @@ function createRelationshipTypesClient(proj) {
     create: withSchema(
       RelationshipTypeSchema.extend({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID")
+        projectId: z6.string().describe("Project name")
       }),
       (params) => {
         const { orgId, projectId, ...body } = params;
@@ -786,7 +785,7 @@ function createRelationshipTypesClient(proj) {
     update: withSchema(
       RelationshipTypeSchema.extend({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID")
+        projectId: z6.string().describe("Project name")
       }),
       (params) => {
         const { orgId, projectId, ...body } = params;
@@ -801,7 +800,7 @@ function createRelationshipTypesClient(proj) {
     delete: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         name: z6.string().describe("Relationship type name")
       }),
       (params) => call(
@@ -817,14 +816,14 @@ function createRelationshipsClient(projEnv) {
     list: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         envName: z6.string().describe("Environment name"),
         relationshipType: z6.string().optional().describe("Filter by relationship type"),
         state: z6.string().optional().describe("Filter by state"),
         fromEntity: z6.string().uuid().optional().describe("Filter by from-entity ID"),
         toEntity: z6.string().uuid().optional().describe("Filter by to-entity ID"),
-        fromEntityPool: z6.string().optional().describe("Filter by from-entity pool"),
-        toEntityPool: z6.string().optional().describe("Filter by to-entity pool"),
+        fromEntityCell: z6.string().optional().describe("Filter by from-entity cell membership"),
+        toEntityCell: z6.string().optional().describe("Filter by to-entity cell membership"),
         limit: z6.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)")
       }),
       (params) => {
@@ -837,7 +836,7 @@ function createRelationshipsClient(projEnv) {
     get: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         envName: z6.string().describe("Environment name"),
         id: z6.string().uuid().describe("Relationship ID")
       }),
@@ -848,7 +847,7 @@ function createRelationshipsClient(projEnv) {
     create: withSchema(
       RelationshipSchema.extend({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         envName: z6.string().describe("Environment name")
       }),
       (params) => {
@@ -859,7 +858,7 @@ function createRelationshipsClient(projEnv) {
     delete: withSchema(
       z6.object({
         orgId: z6.string().describe("Organization slug"),
-        projectId: z6.string().describe("Project ID"),
+        projectId: z6.string().describe("Project name"),
         envName: z6.string().describe("Environment name"),
         id: z6.string().uuid().describe("Relationship ID")
       }),
@@ -1077,14 +1076,18 @@ function createGithubClient(cloud, _baseUrl, _hcOpts) {
   return {
     connect: withSchema(
       z9.object({
-        projectId: z9.string().describe("Project ID")
+        projectId: z9.string().describe("Project name")
       }),
+      // why: the install-url route has a "GitHub App not configured" branch
+      // that returns a bare `new Response(...)` (see notConfiguredResponse in
+      // @terrantula/github), which defeats Hono RPC JSON-body inference and
+      // collapses the success type to `unknown`. The 200 body is { url }.
       (params) => call(cloud.github["install-url"].$post({ json: params }))
     ),
     installations: {
       list: withSchema(
         z9.object({
-          orgId: z9.string().describe("Organization ID")
+          orgId: z9.string().describe("Organization slug")
         }),
         (params) => call(cloud.github.installations.$get({ query: params }))
       ),
@@ -1110,17 +1113,20 @@ function createGithubClient(cloud, _baseUrl, _hcOpts) {
       ),
       recover: withSchema(
         z9.object({
-          orgId: z9.string().describe("Organization ID"),
+          orgId: z9.string().describe("Organization slug"),
           installationId: z9.number().int().positive().describe("GitHub installation ID (from the GitHub install URL)")
         }),
+        // why: same bare-Response inference break as `connect` (the route's
+        // not-configured branch returns `new Response(...)`), so the 200 body
+        // type collapses to `unknown`. The success body is the claimed row.
         (params) => call(cloud.github.installations.recover.$post({ json: params }))
       )
     },
     projects: {
       list: withSchema(
         z9.object({
-          orgId: z9.string().describe("Organization ID"),
-          projectId: z9.string().describe("Project ID")
+          orgId: z9.string().describe("Organization slug"),
+          projectId: z9.string().describe("Project name")
         }),
         (params) => call(
           cloud.orgs[":orgId"].projects[":projectId"]["github-repos"].$get({
@@ -1130,8 +1136,8 @@ function createGithubClient(cloud, _baseUrl, _hcOpts) {
       ),
       linkRepo: withSchema(
         z9.object({
-          orgId: z9.string().describe("Organization ID"),
-          projectId: z9.string().describe("Project ID"),
+          orgId: z9.string().describe("Organization slug"),
+          projectId: z9.string().describe("Project name"),
           installationId: z9.string().describe("github_installations.id (UUID)"),
           repoFullName: z9.string().describe('GitHub repo "owner/name"')
         }),
@@ -1147,8 +1153,8 @@ function createGithubClient(cloud, _baseUrl, _hcOpts) {
       ),
       unlinkRepo: withSchema(
         z9.object({
-          orgId: z9.string().describe("Organization ID"),
-          projectId: z9.string().describe("Project ID"),
+          orgId: z9.string().describe("Organization slug"),
+          projectId: z9.string().describe("Project name"),
           id: z9.string().describe("project_github_repos.id (UUID) \u2014 returned by linkRepo")
         }),
         (params) => call(
@@ -1314,7 +1320,7 @@ function createAuditEventsClient(proj) {
     list: withSchema(
       z13.object({
         orgId: z13.string().describe("Organization slug"),
-        projectId: z13.string().describe("Project ID"),
+        projectId: z13.string().describe("Project name"),
         envName: z13.string().optional().describe("Filter to a single env"),
         actorType: z13.enum(["user", "token"]).optional().describe("Filter by actor type"),
         actorId: z13.string().optional().describe("Filter by actor (user.id or apikey.id)"),
@@ -1338,14 +1344,14 @@ function createEnvironmentsClient(proj) {
     list: withSchema(
       z14.object({
         orgId: z14.string().describe("Organization slug"),
-        projectId: z14.string().describe("Project ID")
+        projectId: z14.string().describe("Project name")
       }),
       (params) => call(proj(params.orgId, params.projectId)["environments"].$get())
     ),
     create: withSchema(
       z14.object({
         orgId: z14.string().describe("Organization slug"),
-        projectId: z14.string().describe("Project ID"),
+        projectId: z14.string().describe("Project name"),
         name: z14.string().min(1).max(31).regex(/^[a-z0-9][a-z0-9-]{0,30}$/).describe("Environment name (lowercase letters, digits, hyphens; max 31 chars)")
       }),
       (params) => {
@@ -1356,7 +1362,7 @@ function createEnvironmentsClient(proj) {
     delete: withSchema(
       z14.object({
         orgId: z14.string().describe("Organization slug"),
-        projectId: z14.string().describe("Project ID"),
+        projectId: z14.string().describe("Project name"),
         name: z14.string().describe("Environment name")
       }),
       (params) => call(
@@ -1375,11 +1381,11 @@ function createDriftEventsClient(projEnv) {
     list: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name"),
         status: z15.enum(["open", "accepted", "reapplied", "snoozed"]).optional(),
         kind: z15.string().optional().describe("Filter by entity type name"),
-        entityId: z15.string().uuid().optional(),
+        entityName: z15.string().optional().describe("Filter by entity name"),
         since: z15.string().optional().describe("ISO timestamp lower bound on detectedAt"),
         limit: z15.coerce.number().int().min(1).max(500).optional()
       }),
@@ -1393,7 +1399,7 @@ function createDriftEventsClient(projEnv) {
     count: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name")
       }),
       (params) => call(projEnv(params.orgId, params.projectId, params.envName)["drift-events"].count.$get())
@@ -1401,7 +1407,7 @@ function createDriftEventsClient(projEnv) {
     get: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name"),
         id: z15.string().uuid()
       }),
@@ -1414,7 +1420,7 @@ function createDriftEventsClient(projEnv) {
     accept: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name"),
         id: z15.string().uuid()
       }),
@@ -1427,7 +1433,7 @@ function createDriftEventsClient(projEnv) {
     reapply: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name"),
         id: z15.string().uuid()
       }),
@@ -1440,7 +1446,7 @@ function createDriftEventsClient(projEnv) {
     snooze: withSchema(
       z15.object({
         orgId: z15.string().describe("Organization slug"),
-        projectId: z15.string().describe("Project ID"),
+        projectId: z15.string().describe("Project name"),
         envName: z15.string().describe("Environment name"),
         id: z15.string().uuid(),
         untilSeconds: z15.number().int().positive().optional()
@@ -1464,7 +1470,7 @@ function createStatsClient(proj) {
     entitiesByState: withSchema(
       z16.object({
         orgId: z16.string().describe("Organization slug"),
-        projectId: z16.string().describe("Project ID"),
+        projectId: z16.string().describe("Project name"),
         window: WindowSchema,
         bucket: BucketSchema
       }),
@@ -1476,7 +1482,7 @@ function createStatsClient(proj) {
     runsByType: withSchema(
       z16.object({
         orgId: z16.string().describe("Organization slug"),
-        projectId: z16.string().describe("Project ID"),
+        projectId: z16.string().describe("Project name"),
         window: WindowSchema
       }),
       (params) => {
@@ -1487,7 +1493,7 @@ function createStatsClient(proj) {
     failingKinds: withSchema(
       z16.object({
         orgId: z16.string().describe("Organization slug"),
-        projectId: z16.string().describe("Project ID"),
+        projectId: z16.string().describe("Project name"),
         window: WindowSchema
       }),
       (params) => {
@@ -1498,7 +1504,7 @@ function createStatsClient(proj) {
     driftDensity: withSchema(
       z16.object({
         orgId: z16.string().describe("Organization slug"),
-        projectId: z16.string().describe("Project ID"),
+        projectId: z16.string().describe("Project name"),
         dim: z16.string().optional().describe('Dimensions to bucket \u2014 e.g. "kind,cell"')
       }),
       (params) => {
@@ -1715,11 +1721,19 @@ function createUserPreferencesClient(baseUrl, hcOpts) {
   );
   return {
     get: (key) => call(c[":key"].$get({ param: { key } })),
-    set: (key, value) => call(
-      c[":key"].$put({
-        param: { key },
-        json: { value }
-      })
+    set: (key, value) => (
+      // why: PUT /:key reads the body via c.req.text() (it enforces a 64KB cap
+      // before parsing JSON), so it has no zValidator('json') and the Hono RPC
+      // type doesn't surface a `json` arg. The route does accept a JSON body —
+      // the cast restores the real wire shape the server expects. Switching the
+      // route to zValidator would parse before the size check and break the
+      // 64KB-limit guard, so the fix belongs here.
+      call(
+        c[":key"].$put({
+          param: { key },
+          json: { value }
+        })
+      )
     ),
     delete: (key) => call(c[":key"].$delete({ param: { key } }))
   };