@dork-labs/cloud-api 0.75.1

package/dist/seats.js

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+import { IdSchema, TimestampSchema, pageOf } from './primitives.js';
+/** Whether an organization is one person`s own or a shared one. */
+export const OrgKindSchema = z
+    .enum(['personal', 'org'])
+    .describe('Whether an organization is one person`s own or a shared one.');
+/** What a member may do in an organization. */
+export const MemberRoleSchema = z
+    .enum(['owner', 'admin', 'member'])
+    .describe('What a member may do in an organization.');
+/** An organization: the unit seats, addresses and billing hang off. */
+export const OrgSchema = z
+    .object({
+    id: IdSchema,
+    slug: z.string().describe('The short name that appears in a canonical address.'),
+    name: z.string(),
+    kind: OrgKindSchema,
+    createdAt: TimestampSchema,
+})
+    .describe('An organization: the unit seats, addresses and billing hang off.');
+/** `POST /v1/orgs`. */
+export const OrgCreateRequestSchema = z
+    .object({ slug: z.string().min(1), name: z.string().min(1) })
+    .describe('Create an organization.');
+/** `PATCH /v1/orgs/{orgId}`. */
+export const OrgUpdateRequestSchema = z
+    .object({ name: z.string().min(1).optional(), slug: z.string().min(1).optional() })
+    .describe('Rename an organization or change its slug.');
+/** `GET /v1/orgs`. */
+export const OrgListResponseSchema = pageOf(OrgSchema, 'A page of the organizations the caller belongs to.');
+/** One person`s membership of one organization. */
+export const MemberSchema = z
+    .object({
+    id: IdSchema,
+    orgId: IdSchema,
+    userId: IdSchema,
+    role: MemberRoleSchema,
+    createdAt: TimestampSchema,
+})
+    .describe('One person`s membership of one organization.');
+/** `GET /v1/orgs/{orgId}/members`. */
+export const MemberListResponseSchema = pageOf(MemberSchema, 'A page of an organization`s members.');
+/** How far an invitation has got. */
+export const InvitationStatusSchema = z
+    .enum(['pending', 'accepted', 'rejected', 'canceled'])
+    .describe('How far an invitation has got.');
+/** An outstanding or settled invitation to join an organization. */
+export const InvitationSchema = z
+    .object({
+    id: IdSchema,
+    orgId: IdSchema,
+    email: z.string(),
+    role: MemberRoleSchema,
+    status: InvitationStatusSchema,
+    expiresAt: TimestampSchema,
+    createdAt: TimestampSchema,
+})
+    .describe('An outstanding or settled invitation to join an organization.');
+/** `POST /v1/orgs/{orgId}/invitations`. */
+export const InvitationCreateRequestSchema = z
+    .object({ email: z.string().min(1), role: MemberRoleSchema })
+    .describe('Invite somebody to an organization.');
+/** `GET /v1/orgs/{orgId}/invitations`. */
+export const InvitationListResponseSchema = pageOf(InvitationSchema, 'A page of an organization`s invitations.');
+/** An agent identity an organization has registered. */
+export const AgentSchema = z
+    .object({
+    id: IdSchema,
+    orgId: IdSchema,
+    ownerMemberId: IdSchema.nullable().describe('The member who owns this agent, or null when nobody does yet.'),
+    displayName: z.string(),
+    emoji: z.string().optional(),
+    color: z.string().optional(),
+    imageUrl: z.string().url().optional(),
+    createdAt: TimestampSchema,
+    retiredAt: TimestampSchema.optional(),
+})
+    .describe('An agent identity an organization has registered.');
+/**
+ * `POST /v1/orgs/{orgId}/agents` — an instance asserts a claim to an agent
+ * identity. It mints nothing; a person approves the claim separately.
+ */
+export const AgentClaimRequestSchema = z
+    .object({
+    displayName: z.string().min(1),
+    instanceId: IdSchema,
+    emoji: z.string().optional(),
+    color: z.string().optional(),
+})
+    .describe('An instance asserting a claim to an agent identity. Mints nothing until a person approves it.');
+/** The state of an agent claim. */
+export const AgentClaimSchema = z
+    .object({
+    claimId: IdSchema,
+    agentId: IdSchema,
+    instanceId: IdSchema,
+    status: z.enum(['pending', 'approved', 'rejected', 'expired']),
+    createdAt: TimestampSchema,
+    approvedAt: TimestampSchema.nullable(),
+})
+    .describe('The state of an agent claim awaiting a person`s approval.');
+/** `GET /v1/orgs/{orgId}/agents`. */
+export const AgentListResponseSchema = pageOf(AgentSchema, 'A page of an organization`s agents.');
+/** Whether a seat holds a person or an agent. */
+export const SeatKindSchema = z
+    .enum(['person', 'agent'])
+    .describe('Whether a seat holds a person or an agent.');
+/** Where a seat is in its lifecycle. */
+export const SeatStatusSchema = z
+    .enum(['unassigned', 'assigned', 'suspended', 'released'])
+    .describe('Where a seat is in its lifecycle.');
+/** Whether an address is live or has been retired. */
+export const AddressStatusSchema = z
+    .enum(['active', 'retired'])
+    .describe('Whether an address is live or has been retired.');
+/** A routable address issued to a seat. */
+export const AddressSchema = z
+    .object({
+    id: IdSchema,
+    orgId: IdSchema,
+    seatId: IdSchema,
+    handle: z.string().describe('The local part of the address, unique within the organization.'),
+    canonical: z.string().describe('The full `dork:<org-slug>/<handle>` form.'),
+    status: AddressStatusSchema,
+    issuedAt: TimestampSchema,
+    retiredAt: TimestampSchema.optional(),
+})
+    .describe('A routable address issued to a seat.');
+/** `POST /v1/addresses`. */
+export const AddressCreateRequestSchema = z
+    .object({ seatId: IdSchema, handle: z.string().min(1) })
+    .describe('Issue an address to a seat.');
+/** One seat in an organization. */
+export const SeatSchema = z
+    .object({
+    id: IdSchema,
+    orgId: IdSchema,
+    kind: SeatKindSchema,
+    status: SeatStatusSchema,
+    subject: z
+        .object({ kind: z.enum(['user', 'agent']), id: IdSchema })
+        .nullable()
+        .describe('Who or what currently occupies the seat, or null when nobody does.'),
+    address: AddressSchema.nullable(),
+    createdAt: TimestampSchema,
+    assignedAt: TimestampSchema.optional(),
+    releasedAt: TimestampSchema.optional(),
+})
+    .describe('One seat in an organization.');
+/** `GET /v1/orgs/{orgId}/seats`. */
+export const SeatListResponseSchema = pageOf(SeatSchema, 'A page of an organization`s seats.');
+/** `POST /v1/seats/{seatId}/assign`. */
+export const SeatAssignRequestSchema = z
+    .object({ subject: z.object({ kind: z.enum(['user', 'agent']), id: IdSchema }) })
+    .describe('Put a person or an agent into a seat.');
+/** Who may reach a seat, and for what. */
+export const GrantSchema = z
+    .object({
+    id: IdSchema,
+    seatId: IdSchema,
+    granteeKind: z
+        .enum(['org', 'seat', 'connected-channel', 'public'])
+        .describe('What kind of thing the grant is about.'),
+    granteeRef: IdSchema.nullable().describe('Which one, or null when the kind is enough (`public`).'),
+    capability: z
+        .enum(['address', 'trigger'])
+        .describe('What the grantee may do: reach the address, or trigger the seat.'),
+    effect: z.enum(['allow', 'deny']).describe('Deny wins over allow.'),
+})
+    .describe('One rule about who may reach a seat, and for what.');
+/** `PUT /v1/seats/{seatId}/grants` — replace the whole set in one call. */
+export const GrantReplaceRequestSchema = z
+    .object({ grants: z.array(GrantSchema.omit({ id: true, seatId: true })) })
+    .describe('Replace a seat`s entire grant set. A partial update is not offered, so no two clients can interleave.');
+/** `GET /v1/seats/{seatId}/grants`. */
+export const GrantListResponseSchema = z
+    .object({ grants: z.array(GrantSchema) })
+    .describe('A seat`s entire grant set.');
+/** Something attached to a seat beyond what it includes by default. */
+export const AddonSchema = z
+    .object({
+    id: IdSchema,
+    seatId: IdSchema,
+    kind: z
+        .string()
+        .describe('An opaque add-on identifier. The set is never enumerated in this package.'),
+    status: z.enum(['attached', 'detached']),
+    attachedAt: TimestampSchema,
+    detachedAt: TimestampSchema.optional(),
+})
+    .describe('Something attached to a seat beyond what it includes by default.');
+/** `POST /v1/seats/{seatId}/addons`. */
+export const AddonAttachRequestSchema = z
+    .object({ kind: IdSchema.describe('An opaque identifier the server supplied earlier.') })
+    .describe('Attach an add-on to a seat.');
+/** `GET /v1/seats/{seatId}/addons`. */
+export const AddonListResponseSchema = z
+    .object({ addons: z.array(AddonSchema) })
+    .describe('Everything attached to a seat.');
+/** Where something arrived from. */
+export const InboxSourceKindSchema = z
+    .enum(['email', 'a2a', 'seat', 'connected-channel'])
+    .describe('Where an inbox item arrived from.');
+/**
+ * One item leased from a seat`s inbox.
+ *
+ * `leaseToken` is the receipt that acknowledges exactly this delivery. It
+ * mirrors the connector event contract rather than inventing a second design.
+ */
+export const InboxItemSchema = z
+    .object({
+    id: IdSchema,
+    leaseToken: z.string().min(1).describe('The receipt that acknowledges exactly this delivery.'),
+    receivedAt: TimestampSchema,
+    expiresAt: TimestampSchema.describe('When the lease lapses and the item becomes pullable again.'),
+    sourceKind: InboxSourceKindSchema,
+    sourceRef: z.string().describe('Which sender, in whatever form that source names one.'),
+    envelope: z.unknown().describe('The source-shaped metadata of the item.'),
+    bodyUrl: z.string().url().describe('Where to fetch the item body.'),
+    sizeBytes: z.number().int().nonnegative(),
+})
+    .describe('One item leased from a seat`s inbox.');
+/** `POST /v1/seats/{seatId}/inbox/pull`. */
+export const InboxPullRequestSchema = z
+    .object({
+    limit: z.number().int().min(1).max(100).optional().describe('Defaults to 50, capped at 100.'),
+})
+    .describe('Lease a batch of inbox items. Cursor-free by design, exactly like the connector event pull.');
+/** A leased batch of inbox items. */
+export const InboxPullResponseSchema = z
+    .object({ items: z.array(InboxItemSchema) })
+    .describe('A leased batch of inbox items. No cursor, by design.');
+/** `POST /v1/seats/{seatId}/inbox/ack`. */
+export const InboxAckRequestSchema = z
+    .object({
+    items: z
+        .array(z.object({ id: IdSchema, leaseToken: z.string().min(1) }))
+        .min(1)
+        .max(100),
+})
+    .describe('Settle inbox leases with exact receipts. One to a hundred at a time.');
+/** How many inbox leases were settled. */
+export const InboxAckResponseSchema = z
+    .object({ acknowledged: z.number().int().nonnegative() })
+    .describe('How many inbox leases the server settled.');
+/**
+ * `GET /v1/seats/{seatId}/inbox` — a read-only cursor-paginated browse.
+ *
+ * Separate from the pull on purpose: it takes no lease and changes no status,
+ * which is what stops an interface refresh from acknowledging somebody`s mail.
+ */
+export const InboxBrowseResponseSchema = pageOf(InboxItemSchema.omit({ leaseToken: true }), 'A read-only page of a seat`s inbox. Takes no lease and changes no status.');
+/** How reachable a seat is right now. */
+export const PresenceStateSchema = z
+    .enum(['offline', 'unknown', 'reachable', 'active'])
+    .describe('How reachable a seat is right now.');
+/** `GET /v1/seats/{seatId}/presence`. */
+export const PresenceSchema = z
+    .object({
+    seatId: IdSchema,
+    state: PresenceStateSchema,
+    lastSeenAt: TimestampSchema.nullable(),
+    source: z.enum(['cloud-link', 'heartbeat']).describe('Which signal this reading came from.'),
+})
+    .describe('How reachable a seat is right now, and where that reading came from.');
+//# sourceMappingURL=seats.js.map

package/dist/seats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seats.js","sourceRoot":"","sources":["../src/seats.ts"],"names":[],"mappings":"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"}

package/dist/session.d.ts

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+/**
+ * The scopes a bearer token can carry.
+ *
+ * Mechanism, not catalog: a scope names an ability the protocol defines, and no
+ * subscription is inferable from the set.
+ */
+export declare const ScopeSchema: z.ZodEnum<{
+    "account:read": "account:read";
+    "account:write": "account:write";
+    "instances:read": "instances:read";
+    "instances:write": "instances:write";
+    "connections:read": "connections:read";
+    "connections:write": "connections:write";
+    "billing:read": "billing:read";
+    "billing:write": "billing:write";
+    "seats:read": "seats:read";
+    "seats:write": "seats:write";
+    "inference:mint": "inference:mint";
+    "remote:read": "remote:read";
+    "remote:write": "remote:write";
+}>;
+/** An ability a bearer token carries. */
+export type Scope = z.infer<typeof ScopeSchema>;
+/** The account a token or cookie resolves to. */
+export declare const AccountSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/** The person behind a token or cookie. */
+export type Account = z.infer<typeof AccountSchema>;
+/** `GET /v1/session` — introspection of the presented token or cookie. */
+export declare const SessionSchema: z.ZodObject<{
+    authenticated: z.ZodBoolean;
+    account: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    instanceId: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    seatId: z.ZodOptional<z.ZodString>;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "account:read": "account:read";
+        "account:write": "account:write";
+        "instances:read": "instances:read";
+        "instances:write": "instances:write";
+        "connections:read": "connections:read";
+        "connections:write": "connections:write";
+        "billing:read": "billing:read";
+        "billing:write": "billing:write";
+        "seats:read": "seats:read";
+        "seats:write": "seats:write";
+        "inference:mint": "inference:mint";
+        "remote:read": "remote:read";
+        "remote:write": "remote:write";
+    }>>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+/** What the presented credential resolves to. */
+export type Session = z.infer<typeof SessionSchema>;
+/** `POST /v1/account/export` — a request for a copy of everything the account holds. */
+export declare const AccountExportRequestSchema: z.ZodObject<{
+    notifyEmail: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** The accepted export job. */
+export declare const AccountExportResponseSchema: z.ZodObject<{
+    exportId: z.ZodString;
+    requestedAt: z.ZodISODateTime;
+    readyAt: z.ZodNullable<z.ZodISODateTime>;
+    downloadUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** The state of an account export. */
+export type AccountExport = z.infer<typeof AccountExportResponseSchema>;
+/**
+ * `POST /v1/device/code` — the device-authorization request of RFC 8628.
+ *
+ * One of the two unauthenticated routes in this contract; the other is the
+ * token poll below.
+ */
+export declare const DeviceCodeRequestSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The device-authorization response of RFC 8628.
+ *
+ * Field names are snake_case here and only here: RFC 8628 fixes them on the
+ * wire, and renaming them would make this contract describe something other
+ * than the standard it implements.
+ */
+export declare const DeviceCodeResponseSchema: z.ZodObject<{
+    device_code: z.ZodString;
+    user_code: z.ZodString;
+    verification_uri: z.ZodString;
+    verification_uri_complete: z.ZodOptional<z.ZodString>;
+    expires_in: z.ZodNumber;
+    interval: z.ZodNumber;
+}, z.core.$strip>;
+/** `POST /v1/device/token` — the token poll of RFC 8628. */
+export declare const DeviceTokenRequestSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    device_code: z.ZodString;
+    grant_type: z.ZodLiteral<"urn:ietf:params:oauth:grant-type:device_code">;
+}, z.core.$strip>;
+/** The granted token pair. */
+export declare const DeviceTokenResponseSchema: z.ZodObject<{
+    access_token: z.ZodString;
+    token_type: z.ZodLiteral<"Bearer">;
+    expires_in: z.ZodNumber;
+    refresh_token: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The pending-state errors RFC 8628 defines for the token poll.
+ *
+ * Mechanism, and fixed by the RFC rather than by us.
+ */
+export declare const DeviceTokenErrorSchema: z.ZodObject<{
+    error: z.ZodEnum<{
+        expired_token: "expired_token";
+        authorization_pending: "authorization_pending";
+        slow_down: "slow_down";
+        access_denied: "access_denied";
+    }>;
+    error_description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** The RFC 8628 token-poll error set. */
+export type DeviceTokenError = z.infer<typeof DeviceTokenErrorSchema>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;EAgB2E,CAAC;AAEpG,yCAAyC;AACzC,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;;iBAQyB,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,0EAA0E;AAC1E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBvB,CAAC;AAEJ,iDAAiD;AACjD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wFAAwF;AACxF,eAAO,MAAM,0BAA0B;;iBAOsC,CAAC;AAE9E,+BAA+B;AAC/B,eAAO,MAAM,2BAA2B;;;;;iBAW2B,CAAC;AAEpE,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;iBAQmD,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;iBAmBwD,CAAC;AAE9F,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB;;;;iBAQgC,CAAC;AAEtE,8BAA8B;AAC9B,eAAO,MAAM,yBAAyB;;;;;;iBAQgD,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;iBAOhC,CAAC;AAEJ,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/session.js

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+import { IdSchema, SecretValueSchema, TimestampSchema } from './primitives.js';
+/**
+ * The scopes a bearer token can carry.
+ *
+ * Mechanism, not catalog: a scope names an ability the protocol defines, and no
+ * subscription is inferable from the set.
+ */
+export const ScopeSchema = z
+    .enum([
+    'account:read',
+    'account:write',
+    'instances:read',
+    'instances:write',
+    'connections:read',
+    'connections:write',
+    'billing:read',
+    'billing:write',
+    'seats:read',
+    'seats:write',
+    'inference:mint',
+    'remote:read',
+    'remote:write',
+])
+    .describe('An ability a bearer token carries. Scopes describe the protocol, not a subscription.');
+/** The account a token or cookie resolves to. */
+export const AccountSchema = z
+    .object({
+    id: IdSchema,
+    email: z.string().describe("The account's primary email address."),
+    displayName: z.string().describe('The name to show for this account.'),
+    avatarUrl: z.string().url().optional().describe("A URL for the account's avatar image."),
+    createdAt: TimestampSchema,
+})
+    .describe('The person behind a token or cookie.');
+/** `GET /v1/session` — introspection of the presented token or cookie. */
+export const SessionSchema = z
+    .object({
+    authenticated: z
+        .boolean()
+        .describe('False when the credential is absent or unusable; every other field is then omitted.'),
+    account: AccountSchema.optional(),
+    instanceId: IdSchema.optional().describe('The instance this credential was issued to, when it was issued to one rather than to a person.'),
+    orgId: IdSchema.optional().describe('The organization this credential is scoped to.'),
+    seatId: IdSchema.optional().describe('The seat this credential is scoped to.'),
+    scopes: z.array(ScopeSchema).describe('Every scope this credential carries.'),
+    expiresAt: TimestampSchema.optional(),
+})
+    .describe('What the presented credential resolves to. Unauthenticated is a normal answer, not an error.');
+/** `POST /v1/account/export` — a request for a copy of everything the account holds. */
+export const AccountExportRequestSchema = z
+    .object({
+    notifyEmail: z
+        .boolean()
+        .optional()
+        .describe('Email the account when the export is ready. Defaults to the server policy.'),
+})
+    .describe('A request for a copy of everything the caller`s account holds.');
+/** The accepted export job. */
+export const AccountExportResponseSchema = z
+    .object({
+    exportId: IdSchema,
+    requestedAt: TimestampSchema,
+    readyAt: TimestampSchema.nullable().describe('Null while the export is still being assembled.'),
+    downloadUrl: z
+        .string()
+        .url()
+        .nullable()
+        .describe('A short-lived download link, null until the export is ready.'),
+})
+    .describe('The state of an account export the caller asked for.');
+/**
+ * `POST /v1/device/code` — the device-authorization request of RFC 8628.
+ *
+ * One of the two unauthenticated routes in this contract; the other is the
+ * token poll below.
+ */
+export const DeviceCodeRequestSchema = z
+    .object({
+    clientId: z.string().min(1).describe('The public client identifier of the program asking.'),
+    scope: z
+        .string()
+        .optional()
+        .describe('A space-delimited scope request, as RFC 8628 spells it.'),
+})
+    .describe('The device-authorization request of RFC 8628. Unauthenticated by design.');
+/**
+ * The device-authorization response of RFC 8628.
+ *
+ * Field names are snake_case here and only here: RFC 8628 fixes them on the
+ * wire, and renaming them would make this contract describe something other
+ * than the standard it implements.
+ */
+export const DeviceCodeResponseSchema = z
+    .object({
+    device_code: SecretValueSchema.describe('The device verification code. A credential: it is what the poll below exchanges for a token.'),
+    user_code: z.string().describe('The short code the person types into the verification page.'),
+    verification_uri: z.string().url().describe('The page the person opens to approve the device.'),
+    verification_uri_complete: z
+        .string()
+        .url()
+        .optional()
+        .describe('The verification page with the user code already filled in.'),
+    expires_in: z.number().int().positive().describe('Seconds until the device code expires.'),
+    interval: z
+        .number()
+        .int()
+        .positive()
+        .describe('Seconds to wait between polls of the token endpoint.'),
+})
+    .describe('The device-authorization response of RFC 8628, with the RFC`s own field names.');
+/** `POST /v1/device/token` — the token poll of RFC 8628. */
+export const DeviceTokenRequestSchema = z
+    .object({
+    clientId: z.string().min(1),
+    device_code: SecretValueSchema,
+    grant_type: z
+        .literal('urn:ietf:params:oauth:grant-type:device_code')
+        .describe('Fixed by RFC 8628.'),
+})
+    .describe('The token poll of RFC 8628. Unauthenticated by design.');
+/** The granted token pair. */
+export const DeviceTokenResponseSchema = z
+    .object({
+    access_token: SecretValueSchema,
+    token_type: z.literal('Bearer'),
+    expires_in: z.number().int().positive().describe('Seconds until the access token expires.'),
+    refresh_token: SecretValueSchema.optional(),
+    scope: z.string().optional().describe('The space-delimited scopes actually granted.'),
+})
+    .describe('The token pair RFC 8628 grants once the person has approved the device.');
+/**
+ * The pending-state errors RFC 8628 defines for the token poll.
+ *
+ * Mechanism, and fixed by the RFC rather than by us.
+ */
+export const DeviceTokenErrorSchema = z
+    .object({
+    error: z.enum(['authorization_pending', 'slow_down', 'expired_token', 'access_denied']),
+    error_description: z.string().optional(),
+})
+    .describe('The RFC 8628 token-poll error set. `authorization_pending` and `slow_down` mean keep polling.');
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/fixtures/v1/billing/balance-owed.json

@@ -0,0 +1,16 @@
+{
+  "allowance": {
+    "grantedMicro": "5000000",
+    "remainingMicro": "0",
+    "resetsAt": "2026-10-15T12:00:00.000Z"
+  },
+  "purchased": {
+    "remainingMicro": "0"
+  },
+  "heldMicro": "0",
+  "owedMicro": "31427",
+  "autoReload": {
+    "enabled": true,
+    "ceilingMicro": "20000000"
+  }
+}

package/fixtures/v1/billing/balance.json

@@ -0,0 +1,16 @@
+{
+  "allowance": {
+    "grantedMicro": "5000000",
+    "remainingMicro": "1250000",
+    "resetsAt": "2026-10-15T12:00:00.000Z"
+  },
+  "purchased": {
+    "remainingMicro": "0"
+  },
+  "heldMicro": "25000",
+  "owedMicro": "0",
+  "autoReload": {
+    "enabled": false,
+    "ceilingMicro": null
+  }
+}

package/fixtures/v1/billing/entitlements-free.json

@@ -0,0 +1,34 @@
+{
+  "planId": "pl_opaque_0000",
+  "planDisplayName": "the entitlement shown in your billing page",
+  "periodStart": "2026-09-15T12:00:00.000Z",
+  "periodEnd": "2026-10-15T12:00:00.000Z",
+  "limits": {
+    "personSeatsIncluded": 1,
+    "agentSeatsIncluded": 0,
+    "includedCreditsMicro": "0",
+    "cloudHours": 0,
+    "storageGb": 1,
+    "remoteAccess": "byo",
+    "alwaysAvailableInstances": 0,
+    "customAddress": "none",
+    "managedConnectionActions": null,
+    "support": "community",
+    "emailAddressPerSeat": false
+  },
+  "used": {
+    "personSeats": 1,
+    "agentSeats": 0
+  },
+  "seats": {
+    "total": 1,
+    "assigned": 1,
+    "byKind": {
+      "person": 1,
+      "agent": 0
+    }
+  },
+  "canCreateSeat": false,
+  "canInviteMember": false,
+  "staleAt": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/billing/hosted-page.json

@@ -0,0 +1,3 @@
+{
+  "url": "https://example.invalid/hosted/checkout/abc123"
+}

package/fixtures/v1/billing/nudge.json

@@ -0,0 +1,9 @@
+{
+  "trailing30Micro": "48000000",
+  "suggestedPlanId": "pl_opaque_0002",
+  "suggestedPlanDisplayName": "the subscription shown in your billing page",
+  "suggestedPlanPriceMicro": "20000000",
+  "savingMicro": "28000000",
+  "computedAt": "2026-09-15T12:00:00.000Z",
+  "dismissible": true
+}