@ekanos/cli 0.15.0 → 0.16.0

package/dist/team-connect-api.js

@@ -7,9 +7,9 @@ import { call } from './teams-api.js';
  *   GET  /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>[&as=<email>][&connection=<id>]
  *     → { plan }
  *   POST /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>
- *        { as?, fields?, connection? }
+ *        { as?, fields?, set?, connection? }
  *     → { plan, result: "activated" }                         fields / no-fields
- *     → { plan, result: "consent", authorizeUrl, expiresAt }  oauth
+ *     → { plan, result: "consent", authorizeUrl, expiresAt }  oauth (fields too, for signIn "app")
  *
  * The plan's `mode`, decided by the host, says how the product is
  * connected. The shapes are read here rather than from
@@ -41,6 +41,12 @@ export const TeamConnectPlanSchema = z.object({
         'no-fields',
         'browser',
     ]),
+    /**
+     * `oauth` mode: whose sign-in the link opens — the hosted partner
+     * transport, or the app's own connect route (GitHub, ROAM), which then
+     * activates with `fields`. Absent from an older host (`partner`).
+     */
+    signIn: z.enum(['partner', 'app']).optional(),
     reason: z.string().nullable(),
     fields: z.array(z.object({
         name: z.string(),
@@ -48,6 +54,15 @@ export const TeamConnectPlanSchema = z.object({
         description: z.string().nullable(),
         sensitive: z.boolean(),
         required: z.boolean(),
+        /**
+         * How it is entered (`connect-fields.ts`). An older host sends only
+         * plain fields, so absent reads as text.
+         */
+        type: z
+            .enum(['text', 'number', 'boolean', 'select', 'list', 'json'])
+            .default('text'),
+        options: z.array(z.string()).nullable().default(null),
+        itemType: z.enum(['text', 'number']).nullable().default(null),
     })),
     teamApp: z.boolean(),
     member: z

package/dist/team-connect-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"team-connect-api.js","sourceRoot":"","sources":["../src/team-connect-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { type TeamsApiResult, call } from './teams-api';\n\n/**\n * The CLI's client for connecting a product for a team (`ekanos teams\n * connect`), for the team's Source admin.\n *\n *   GET  /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>[&as=<email>][&connection=<id>]\n *     → { plan }\n *   POST /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>\n *        { as?, fields?, connection? }\n *     → { plan, result: \"activated\" }                         fields / no-fields\n *     → { plan, result: \"consent\", authorizeUrl, expiresAt }  oauth\n *\n * The plan's `mode`, decided by the host, says how the product is\n * connected. The shapes are read here rather than from\n * `@ekanos/integration-schema`, so this CLI works against a host without a\n * schema release.\n */\n\nexport const TeamConnectPlanSchema = z.object({\n  source: z.object({\n    id: z.string(),\n    slug: z.string(),\n    name: z.string().nullable(),\n  }),\n  team: z.object({ slug: z.string(), name: z.string() }),\n  product: z.object({\n    slug: z.string(),\n    name: z.string(),\n    kind: z.enum(['experience', 'integration']).nullable(),\n  }),\n  scope: z.enum(['team', 'user']),\n  /** The OAuth connection the plan is for; absent from an older host (`default`). */\n  connectionId: z.string().optional(),\n  mode: z.enum([\n    'unsupported',\n    'not-entitled',\n    'not-self-serve',\n    'works-as-shipped',\n    'oauth',\n    'fields',\n    'no-fields',\n    'browser',\n  ]),\n  reason: z.string().nullable(),\n  fields: z.array(\n    z.object({\n      name: z.string(),\n      label: z.string(),\n      description: z.string().nullable(),\n      sensitive: z.boolean(),\n      required: z.boolean(),\n    }),\n  ),\n  teamApp: z.boolean(),\n  member: z\n    .object({\n      userId: z.string(),\n      email: z.string().nullable(),\n      isCaller: z.boolean(),\n    })\n    .nullable(),\n  memberProblem: z.string().nullable(),\n  connected: z.boolean(),\n  connectedAt: z.string().nullable(),\n  connectUrl: z.string(),\n  /**\n   * Whether the team's product scopes hide the product from it in the app.\n   * Absent from an older host.\n   */\n  productScope: z\n    .object({\n      state: z.enum(['unscoped', 'scoped', 'locked_out']),\n      scopes: z.array(z.string()),\n      hidden: z.boolean(),\n    })\n    .optional(),\n});\nexport type TeamConnectPlan = z.infer<typeof TeamConnectPlanSchema>;\n\nconst ShowSchema = z.object({ plan: TeamConnectPlanSchema });\nconst StartSchema = z.discriminatedUnion('result', [\n  z.object({ plan: TeamConnectPlanSchema, result: z.literal('activated') }),\n  z.object({\n    plan: TeamConnectPlanSchema,\n    result: z.literal('consent'),\n    authorizeUrl: z.string(),\n    expiresAt: z.string(),\n  }),\n]);\nexport type TeamConnectStart = z.infer<typeof StartSchema>;\n\ninterface Target {\n  source: string;\n  team: string;\n  product: string;\n  /** A named OAuth connection (`agent`); the main one when absent. */\n  connection?: string;\n}\n\nfunction connectPath(target: Target): string {\n  return `/api/partner/teams/${encodeURIComponent(target.team)}/integrations/${encodeURIComponent(target.product)}/connect`;\n}\n\nexport function showTeamConnect(\n  host: string,\n  accessToken: string,\n  target: Target,\n  asEmail?: string,\n): Promise<TeamsApiResult<z.infer<typeof ShowSchema>>> {\n  // `call` puts `source` in the query; the rest ride in the path's own query.\n  const query = new URLSearchParams({\n    ...(asEmail ? { as: asEmail } : {}),\n    ...(target.connection ? { connection: target.connection } : {}),\n  }).toString();\n  const path = query ? `${connectPath(target)}?${query}` : connectPath(target);\n  return call(host, accessToken, ShowSchema, {\n    method: 'GET',\n    path,\n    source: target.source,\n  });\n}\n\nexport function startTeamConnect(\n  host: string,\n  accessToken: string,\n  target: Target,\n  body: { as?: string; fields?: Record<string, string> },\n): Promise<TeamsApiResult<TeamConnectStart>> {\n  return call(host, accessToken, StartSchema, {\n    method: 'POST',\n    path: connectPath(target),\n    source: target.source,\n    body: target.connection ? { ...body, connection: target.connection } : body,\n  });\n}\n"]}
+{"version":3,"file":"team-connect-api.js","sourceRoot":"","sources":["../src/team-connect-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { type TeamsApiResult, call } from './teams-api';\n\n/**\n * The CLI's client for connecting a product for a team (`ekanos teams\n * connect`), for the team's Source admin.\n *\n *   GET  /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>[&as=<email>][&connection=<id>]\n *     → { plan }\n *   POST /api/partner/teams/<team>/integrations/<product>/connect?source=<slug>\n *        { as?, fields?, set?, connection? }\n *     → { plan, result: \"activated\" }                         fields / no-fields\n *     → { plan, result: \"consent\", authorizeUrl, expiresAt }  oauth (fields too, for signIn \"app\")\n *\n * The plan's `mode`, decided by the host, says how the product is\n * connected. The shapes are read here rather than from\n * `@ekanos/integration-schema`, so this CLI works against a host without a\n * schema release.\n */\n\nexport const TeamConnectPlanSchema = z.object({\n  source: z.object({\n    id: z.string(),\n    slug: z.string(),\n    name: z.string().nullable(),\n  }),\n  team: z.object({ slug: z.string(), name: z.string() }),\n  product: z.object({\n    slug: z.string(),\n    name: z.string(),\n    kind: z.enum(['experience', 'integration']).nullable(),\n  }),\n  scope: z.enum(['team', 'user']),\n  /** The OAuth connection the plan is for; absent from an older host (`default`). */\n  connectionId: z.string().optional(),\n  mode: z.enum([\n    'unsupported',\n    'not-entitled',\n    'not-self-serve',\n    'works-as-shipped',\n    'oauth',\n    'fields',\n    'no-fields',\n    'browser',\n  ]),\n  /**\n   * `oauth` mode: whose sign-in the link opens — the hosted partner\n   * transport, or the app's own connect route (GitHub, ROAM), which then\n   * activates with `fields`. Absent from an older host (`partner`).\n   */\n  signIn: z.enum(['partner', 'app']).optional(),\n  reason: z.string().nullable(),\n  fields: z.array(\n    z.object({\n      name: z.string(),\n      label: z.string(),\n      description: z.string().nullable(),\n      sensitive: z.boolean(),\n      required: z.boolean(),\n      /**\n       * How it is entered (`connect-fields.ts`). An older host sends only\n       * plain fields, so absent reads as text.\n       */\n      type: z\n        .enum(['text', 'number', 'boolean', 'select', 'list', 'json'])\n        .default('text'),\n      options: z.array(z.string()).nullable().default(null),\n      itemType: z.enum(['text', 'number']).nullable().default(null),\n    }),\n  ),\n  teamApp: z.boolean(),\n  member: z\n    .object({\n      userId: z.string(),\n      email: z.string().nullable(),\n      isCaller: z.boolean(),\n    })\n    .nullable(),\n  memberProblem: z.string().nullable(),\n  connected: z.boolean(),\n  connectedAt: z.string().nullable(),\n  connectUrl: z.string(),\n  /**\n   * Whether the team's product scopes hide the product from it in the app.\n   * Absent from an older host.\n   */\n  productScope: z\n    .object({\n      state: z.enum(['unscoped', 'scoped', 'locked_out']),\n      scopes: z.array(z.string()),\n      hidden: z.boolean(),\n    })\n    .optional(),\n});\nexport type TeamConnectPlan = z.infer<typeof TeamConnectPlanSchema>;\nexport type TeamConnectField = TeamConnectPlan['fields'][number];\n\n/** A field's value as sent: text, or typed by `connect-fields.ts`. */\nexport type FieldValue =\n  | string\n  | number\n  | boolean\n  | null\n  | FieldValue[]\n  | { [key: string]: FieldValue };\n\nconst ShowSchema = z.object({ plan: TeamConnectPlanSchema });\nconst StartSchema = z.discriminatedUnion('result', [\n  z.object({ plan: TeamConnectPlanSchema, result: z.literal('activated') }),\n  z.object({\n    plan: TeamConnectPlanSchema,\n    result: z.literal('consent'),\n    authorizeUrl: z.string(),\n    expiresAt: z.string(),\n  }),\n]);\nexport type TeamConnectStart = z.infer<typeof StartSchema>;\n\ninterface Target {\n  source: string;\n  team: string;\n  product: string;\n  /** A named OAuth connection (`agent`); the main one when absent. */\n  connection?: string;\n}\n\nfunction connectPath(target: Target): string {\n  return `/api/partner/teams/${encodeURIComponent(target.team)}/integrations/${encodeURIComponent(target.product)}/connect`;\n}\n\nexport function showTeamConnect(\n  host: string,\n  accessToken: string,\n  target: Target,\n  asEmail?: string,\n): Promise<TeamsApiResult<z.infer<typeof ShowSchema>>> {\n  // `call` puts `source` in the query; the rest ride in the path's own query.\n  const query = new URLSearchParams({\n    ...(asEmail ? { as: asEmail } : {}),\n    ...(target.connection ? { connection: target.connection } : {}),\n  }).toString();\n  const path = query ? `${connectPath(target)}?${query}` : connectPath(target);\n  return call(host, accessToken, ShowSchema, {\n    method: 'GET',\n    path,\n    source: target.source,\n  });\n}\n\nexport function startTeamConnect(\n  host: string,\n  accessToken: string,\n  target: Target,\n  body: {\n    as?: string;\n    fields?: Record<string, FieldValue>;\n    /** The field names given by `--set`, not a prompt: the host refuses a secret among them. */\n    set?: string[];\n  },\n): Promise<TeamsApiResult<TeamConnectStart>> {\n  return call(host, accessToken, StartSchema, {\n    method: 'POST',\n    path: connectPath(target),\n    source: target.source,\n    body: target.connection ? { ...body, connection: target.connection } : body,\n  });\n}\n"]}

package/dist/team-lifecycle-api.d.ts

@@ -0,0 +1,435 @@
+import { z } from 'zod';
+import { type TeamsApiResult } from './teams-api.js';
+export declare const InvitationResendSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    email: z.ZodString;
+    role: z.ZodString;
+    action: z.ZodEnum<{
+        renewed: "renewed";
+        resent: "resent";
+    }>;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export declare const TeamLeaveSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    role: z.ZodString;
+}, z.core.$strip>;
+export declare const TeamGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    members: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        email: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    products: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    widgetCount: z.ZodNumber;
+    mcpToolCount: z.ZodNumber;
+}, z.core.$strip>;
+export type TeamGroup = z.infer<typeof TeamGroupSchema>;
+declare const GroupListSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        members: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            email: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        products: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        widgetCount: z.ZodNumber;
+        mcpToolCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const GroupResultSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    group: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        members: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            email: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        products: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        widgetCount: z.ZodNumber;
+        mcpToolCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const GroupUpdateSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    group: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        members: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            email: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        products: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        widgetCount: z.ZodNumber;
+        mcpToolCount: z.ZodNumber;
+    }, z.core.$strip>;
+    previous: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        members: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            email: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        products: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        widgetCount: z.ZodNumber;
+        mcpToolCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const GroupMemberSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    group: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        members: z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            email: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        products: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        widgetCount: z.ZodNumber;
+        mcpToolCount: z.ZodNumber;
+    }, z.core.$strip>;
+    email: z.ZodString;
+    changed: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const TeamHealthRowSchema: z.ZodObject<{
+    productId: z.ZodString;
+    productName: z.ZodString;
+    slug: z.ZodString;
+    status: z.ZodEnum<{
+        degraded: "degraded";
+        healthy: "healthy";
+        unhealthy: "unhealthy";
+        unknown: "unknown";
+    }>;
+    lastCheckedAt: z.ZodNullable<z.ZodString>;
+    lastSuccessAt: z.ZodNullable<z.ZodString>;
+    lastFailureAt: z.ZodNullable<z.ZodString>;
+    lastErrorMessage: z.ZodNullable<z.ZodString>;
+    errorRatePct: z.ZodNullable<z.ZodNumber>;
+    tokenExpiresAt: z.ZodNullable<z.ZodString>;
+    statusReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type TeamHealthRow = z.infer<typeof TeamHealthRowSchema>;
+declare const HealthListSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    integrations: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        productName: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            healthy: "healthy";
+            unhealthy: "unhealthy";
+            unknown: "unknown";
+        }>;
+        lastCheckedAt: z.ZodNullable<z.ZodString>;
+        lastSuccessAt: z.ZodNullable<z.ZodString>;
+        lastFailureAt: z.ZodNullable<z.ZodString>;
+        lastErrorMessage: z.ZodNullable<z.ZodString>;
+        errorRatePct: z.ZodNullable<z.ZodNumber>;
+        tokenExpiresAt: z.ZodNullable<z.ZodString>;
+        statusReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const HealthRunSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    integration: z.ZodObject<{
+        productId: z.ZodString;
+        productName: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            healthy: "healthy";
+            unhealthy: "unhealthy";
+            unknown: "unknown";
+        }>;
+        lastCheckedAt: z.ZodNullable<z.ZodString>;
+        lastSuccessAt: z.ZodNullable<z.ZodString>;
+        lastFailureAt: z.ZodNullable<z.ZodString>;
+        lastErrorMessage: z.ZodNullable<z.ZodString>;
+        errorRatePct: z.ZodNullable<z.ZodNumber>;
+        tokenExpiresAt: z.ZodNullable<z.ZodString>;
+        statusReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const WorkspaceListSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    workspaces: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        visible: z.ZodBoolean;
+        isDefault: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const WorkspaceDefaultSchema: z.ZodObject<{
+    team: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    workspace: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        visible: z.ZodBoolean;
+        isDefault: z.ZodBoolean;
+    }, z.core.$strip>;
+    previous: z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        visible: z.ZodBoolean;
+        isDefault: z.ZodBoolean;
+    }, z.core.$strip>>;
+    changed: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const SourceRoleSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    hierarchyLevel: z.ZodNumber;
+    isSystem: z.ZodBoolean;
+    permissions: z.ZodArray<z.ZodString>;
+    memberCount: z.ZodNumber;
+}, z.core.$strip>;
+export type SourceRole = z.infer<typeof SourceRoleSchema>;
+declare const RoleListSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    roles: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        hierarchyLevel: z.ZodNumber;
+        isSystem: z.ZodBoolean;
+        permissions: z.ZodArray<z.ZodString>;
+        memberCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    permissions: z.ZodArray<z.ZodObject<{
+        permission: z.ZodString;
+        label: z.ZodString;
+        category: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const RoleResultSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    role: z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        hierarchyLevel: z.ZodNumber;
+        isSystem: z.ZodBoolean;
+        permissions: z.ZodArray<z.ZodString>;
+        memberCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const RoleUpdateSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    role: z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        hierarchyLevel: z.ZodNumber;
+        isSystem: z.ZodBoolean;
+        permissions: z.ZodArray<z.ZodString>;
+        memberCount: z.ZodNumber;
+    }, z.core.$strip>;
+    previous: z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        hierarchyLevel: z.ZodNumber;
+        isSystem: z.ZodBoolean;
+        permissions: z.ZodArray<z.ZodString>;
+        memberCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const PeopleSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    people: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        joinedAt: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            active: "active";
+            invited: "invited";
+            left: "left";
+            removed: "removed";
+            suspended: "suspended";
+        }>;
+        teams: z.ZodArray<z.ZodObject<{
+            accountName: z.ZodString;
+            roleLabel: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                invited: "invited";
+                left: "left";
+                removed: "removed";
+                suspended: "suspended";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pageSize: z.ZodNumber;
+}, z.core.$strip>;
+export type SourcePeople = z.infer<typeof PeopleSchema>;
+type TeamTarget = {
+    source: string;
+    team: string;
+};
+type Api<T> = Promise<TeamsApiResult<T>>;
+export declare function resendTeamInvitation(host: string, token: string, target: TeamTarget & {
+    email: string;
+}): Api<z.infer<typeof InvitationResendSchema>>;
+export declare function leaveTeam(host: string, token: string, target: TeamTarget): Api<z.infer<typeof TeamLeaveSchema>>;
+export declare function listTeamGroups(host: string, token: string, target: TeamTarget): Api<z.infer<typeof GroupListSchema>>;
+export declare function createTeamGroup(host: string, token: string, target: TeamTarget, body: {
+    name: string;
+    description?: string;
+    products?: string[];
+}): Api<z.infer<typeof GroupResultSchema>>;
+export declare function updateTeamGroup(host: string, token: string, target: TeamTarget & {
+    group: string;
+}, body: {
+    name?: string;
+    description?: string | null;
+    products?: string[];
+}): Api<z.infer<typeof GroupUpdateSchema>>;
+export declare function deleteTeamGroup(host: string, token: string, target: TeamTarget & {
+    group: string;
+}): Api<z.infer<typeof GroupResultSchema>>;
+export declare function setTeamGroupMember(host: string, token: string, target: TeamTarget & {
+    group: string;
+    email: string;
+}, member: boolean): Api<z.infer<typeof GroupMemberSchema>>;
+export declare function listTeamHealth(host: string, token: string, target: TeamTarget): Api<z.infer<typeof HealthListSchema>>;
+/** The caller's own personal connection's health; `run` checks it now. */
+export declare function ownTeamHealth(host: string, token: string, target: TeamTarget & {
+    product: string;
+}, run: boolean): Api<z.infer<typeof HealthRunSchema>>;
+export declare function runTeamHealthCheck(host: string, token: string, target: TeamTarget & {
+    product: string;
+}): Api<z.infer<typeof HealthRunSchema>>;
+export declare function listTeamWorkspaces(host: string, token: string, target: TeamTarget): Api<z.infer<typeof WorkspaceListSchema>>;
+export declare function setTeamDefaultWorkspace(host: string, token: string, target: TeamTarget, workspace: string): Api<z.infer<typeof WorkspaceDefaultSchema>>;
+export declare function listSourceRoles(host: string, token: string, source: string): Api<z.infer<typeof RoleListSchema>>;
+export declare function createSourceRole(host: string, token: string, source: string, body: {
+    name: string;
+    displayName: string;
+    description?: string;
+    hierarchyLevel: number;
+    permissions: string[];
+}): Api<z.infer<typeof RoleResultSchema>>;
+export declare function updateSourceRole(host: string, token: string, target: {
+    source: string;
+    role: string;
+}, body: {
+    displayName?: string;
+    description?: string;
+    hierarchyLevel?: number;
+    permissions?: string[];
+    grant?: string[];
+    revoke?: string[];
+}): Api<z.infer<typeof RoleUpdateSchema>>;
+export declare function deleteSourceRole(host: string, token: string, target: {
+    source: string;
+    role: string;
+}): Api<z.infer<typeof RoleResultSchema>>;
+export declare function listSourcePeople(host: string, token: string, source: string, query: {
+    search?: string;
+    page?: number;
+}): Api<SourcePeople>;
+export {};