@dork-labs/cloud-api 0.75.1

package/dist/connections.d.ts

@@ -0,0 +1,281 @@
+import { z } from 'zod';
+/**
+ * How a toolkit is authenticated.
+ *
+ * Mechanism: it tells a client which flow to run, and names no vendor.
+ */
+export declare const AuthenticationKindSchema: z.ZodEnum<{
+    none: "none";
+    oauth2: "oauth2";
+    api_key: "api_key";
+    basic: "basic";
+    bearer: "bearer";
+}>;
+/** The lifecycle of one managed connection. */
+export declare const ConnectionStatusSchema: z.ZodEnum<{
+    active: "active";
+    pending: "pending";
+    degraded: "degraded";
+    expired: "expired";
+    revoked: "revoked";
+}>;
+/** One toolkit the catalog offers. */
+export declare const ToolkitSummarySchema: z.ZodObject<{
+    toolkit: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    authentication: z.ZodEnum<{
+        none: "none";
+        oauth2: "oauth2";
+        api_key: "api_key";
+        basic: "basic";
+        bearer: "bearer";
+    }>;
+    version: z.ZodString;
+}, z.core.$strip>;
+/** One toolkit the managed-connection catalog offers. */
+export type ToolkitSummary = z.infer<typeof ToolkitSummarySchema>;
+/** `GET /v1/connections/catalog` — every toolkit on offer. */
+export declare const ConnectionCatalogResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        toolkit: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        iconUrl: z.ZodOptional<z.ZodString>;
+        authentication: z.ZodEnum<{
+            none: "none";
+            oauth2: "oauth2";
+            api_key: "api_key";
+            basic: "basic";
+            bearer: "bearer";
+        }>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** `GET /v1/connections/toolkits/{toolkit}/version`. */
+export declare const ToolkitVersionResponseSchema: z.ZodObject<{
+    toolkit: z.ZodString;
+    version: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/** One callable operation a toolkit exposes. */
+export declare const ToolkitOperationSchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    inputSchema: z.ZodUnknown;
+    outputSchema: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/** `GET /v1/connections/toolkits/{toolkit}/operations`. */
+export declare const ToolkitOperationsResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodUnknown;
+        outputSchema: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** One event a toolkit can deliver. */
+export declare const ToolkitEventSchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    payloadSchema: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/** `GET /v1/connections/toolkits/{toolkit}/events`. */
+export declare const ToolkitEventsResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        payloadSchema: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** One managed connection belonging to the caller. */
+export declare const ConnectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    toolkit: z.ZodString;
+    displayName: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        pending: "pending";
+        degraded: "degraded";
+        expired: "expired";
+        revoked: "revoked";
+    }>;
+    orgId: z.ZodNullable<z.ZodString>;
+    seatId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodNullable<z.ZodISODateTime>;
+    lastUsedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+/** One managed connection belonging to the caller. */
+export type Connection = z.infer<typeof ConnectionSchema>;
+/** `GET /v1/connections`. */
+export declare const ConnectionListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        toolkit: z.ZodString;
+        displayName: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            pending: "pending";
+            degraded: "degraded";
+            expired: "expired";
+            revoked: "revoked";
+        }>;
+        orgId: z.ZodNullable<z.ZodString>;
+        seatId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        expiresAt: z.ZodNullable<z.ZodISODateTime>;
+        lastUsedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** `POST /v1/connections/authentication-flows` — begin connecting a toolkit. */
+export declare const AuthenticationFlowRequestSchema: z.ZodObject<{
+    toolkit: z.ZodString;
+    seatId: z.ZodOptional<z.ZodString>;
+    redirectUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** An authentication flow in progress. */
+export declare const AuthenticationFlowSchema: z.ZodObject<{
+    flowId: z.ZodString;
+    toolkit: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        expired: "expired";
+        awaiting_user: "awaiting_user";
+        succeeded: "succeeded";
+        failed: "failed";
+    }>;
+    redirectUrl: z.ZodNullable<z.ZodString>;
+    connectionId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/** An authentication flow in progress, or its outcome. */
+export type AuthenticationFlow = z.infer<typeof AuthenticationFlowSchema>;
+/**
+ * `POST /v1/connections/authority-commands` — an operation on a connection
+ * that only the issuing authority can perform.
+ */
+export declare const AuthorityCommandRequestSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+    command: z.ZodEnum<{
+        refresh: "refresh";
+        reauthorize: "reauthorize";
+        disable: "disable";
+        enable: "enable";
+        delete: "delete";
+    }>;
+    idempotencyKey: z.ZodString;
+}, z.core.$strip>;
+/** The state of an authority command. */
+export declare const AuthorityCommandSchema: z.ZodObject<{
+    commandId: z.ZodString;
+    connectionId: z.ZodString;
+    status: z.ZodEnum<{
+        succeeded: "succeeded";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+    }>;
+    createdAt: z.ZodISODateTime;
+    completedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+/** `POST /v1/connections/executions` — run one toolkit operation. */
+export declare const ExecutionRequestSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+    operation: z.ZodString;
+    input: z.ZodUnknown;
+    idempotencyKey: z.ZodString;
+}, z.core.$strip>;
+/** One attempt at a toolkit operation. */
+export declare const ExecutionSchema: z.ZodObject<{
+    attemptId: z.ZodString;
+    connectionId: z.ZodString;
+    operation: z.ZodString;
+    status: z.ZodEnum<{
+        succeeded: "succeeded";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        canceled: "canceled";
+    }>;
+    startedAt: z.ZodISODateTime;
+    completedAt: z.ZodNullable<z.ZodISODateTime>;
+    output: z.ZodOptional<z.ZodUnknown>;
+    failure: z.ZodNullable<z.ZodObject<{
+        reason: z.ZodString;
+        retriable: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One attempt at a toolkit operation. */
+export type Execution = z.infer<typeof ExecutionSchema>;
+/**
+ * `POST /v1/connections/events/pull` — lease a batch of pending events.
+ *
+ * Lease-based and deliberately cursor-free: a pull hands out work, and only an
+ * exact lease receipt acknowledges it. The seat inbox is this route's sibling
+ * rather than a second design.
+ */
+export declare const ConnectionEventPullRequestSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** One leased connector event. */
+export declare const ConnectionEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    leaseToken: z.ZodString;
+    connectionId: z.ZodString;
+    toolkit: z.ZodString;
+    event: z.ZodString;
+    receivedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+/** A leased batch of connector events. */
+export declare const ConnectionEventPullResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        leaseToken: z.ZodString;
+        connectionId: z.ZodString;
+        toolkit: z.ZodString;
+        event: z.ZodString;
+        receivedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+        payload: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** `POST /v1/connections/events/ack` — settle leases. */
+export declare const ConnectionEventAckRequestSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        leaseToken: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** How many leases were settled. */
+export declare const ConnectionEventAckResponseSchema: z.ZodObject<{
+    acknowledged: z.ZodNumber;
+}, z.core.$strip>;
+/** `GET /v1/connections/usage` and `GET /v1/connections/{id}/usage`. */
+export declare const ConnectionUsageResponseSchema: z.ZodObject<{
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    rows: z.ZodArray<z.ZodObject<{
+        connectionId: z.ZodString;
+        toolkit: z.ZodString;
+        actions: z.ZodNumber;
+        events: z.ZodNumber;
+    }, z.core.$strip>>;
+    totals: z.ZodObject<{
+        actions: z.ZodNumber;
+        events: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+//# sourceMappingURL=connections.d.ts.map

package/dist/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../src/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;EAEwD,CAAC;AAE9F,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB;;;;;;EAEwB,CAAC;AAE5D,sCAAsC;AACtC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBASgC,CAAC;AAElE,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,8DAA8D;AAC9D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;iBAG3C,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,4BAA4B;;;;iBAMiB,CAAC;AAE3D,gDAAgD;AAChD,eAAO,MAAM,sBAAsB;;;;;;iBAaqB,CAAC;AAEzD,2DAA2D;AAC3D,eAAO,MAAM,+BAA+B;;;;;;;;;iBAG3C,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,kBAAkB;;;;;iBAUgB,CAAC;AAEhD,uDAAuD;AACvD,eAAO,MAAM,2BAA2B;;;;;;;;iBAGvC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAYiC,CAAC;AAE/D,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,6BAA6B;AAC7B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBAGxC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,+BAA+B;;;;iBAYzC,CAAC;AAEJ,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAkB6B,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;iBAa8C,CAAC;AAEzF,yCAAyC;AACzC,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAQc,CAAC;AAElD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB;;;;;iBASmC,CAAC;AAEvE,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAiBsB,CAAC;AAEnD,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC;;iBAUmC,CAAC;AAEjF,kCAAkC;AAClC,eAAO,MAAM,qBAAqB;;;;;;;;;iBAgBuD,CAAC;AAE1F,0CAA0C;AAC1C,eAAO,MAAM,iCAAiC;;;;;;;;;;;iBAE0B,CAAC;AAEzE,yDAAyD;AACzD,eAAO,MAAM,+BAA+B;;;;;iBAOuC,CAAC;AAEpF,oCAAoC;AACpC,eAAO,MAAM,gCAAgC;;iBAEK,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;iBAuBvC,CAAC"}

package/dist/connections.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+import { IdSchema, TimestampSchema, pageOf } from './primitives.js';
+/**
+ * How a toolkit is authenticated.
+ *
+ * Mechanism: it tells a client which flow to run, and names no vendor.
+ */
+export const AuthenticationKindSchema = z
+    .enum(['oauth2', 'api_key', 'basic', 'bearer', 'none'])
+    .describe('Which authentication flow a toolkit needs. Mechanism only; no vendor is named.');
+/** The lifecycle of one managed connection. */
+export const ConnectionStatusSchema = z
+    .enum(['pending', 'active', 'degraded', 'expired', 'revoked'])
+    .describe('The lifecycle state of a managed connection.');
+/** One toolkit the catalog offers. */
+export const ToolkitSummarySchema = z
+    .object({
+    toolkit: z.string().describe('The opaque toolkit identifier.'),
+    displayName: z.string(),
+    description: z.string().optional(),
+    iconUrl: z.string().url().optional(),
+    authentication: AuthenticationKindSchema,
+    version: z.string().describe('The catalog version of this toolkit, as an opaque string.'),
+})
+    .describe('One toolkit the managed-connection catalog offers.');
+/** `GET /v1/connections/catalog` — every toolkit on offer. */
+export const ConnectionCatalogResponseSchema = pageOf(ToolkitSummarySchema, 'A page of the toolkits the managed-connection catalog offers.');
+/** `GET /v1/connections/toolkits/{toolkit}/version`. */
+export const ToolkitVersionResponseSchema = z
+    .object({
+    toolkit: z.string(),
+    version: z.string().describe('An opaque version string. Compare for equality; never parse it.'),
+    updatedAt: TimestampSchema,
+})
+    .describe('The current catalog version of one toolkit.');
+/** One callable operation a toolkit exposes. */
+export const ToolkitOperationSchema = z
+    .object({
+    slug: z.string().describe('The opaque operation identifier.'),
+    displayName: z.string(),
+    description: z.string().optional(),
+    inputSchema: z
+        .unknown()
+        .describe('A JSON Schema for the operation`s input, as published by the toolkit.'),
+    outputSchema: z
+        .unknown()
+        .optional()
+        .describe('A JSON Schema for the operation`s output, where one is published.'),
+})
+    .describe('One callable operation a toolkit exposes.');
+/** `GET /v1/connections/toolkits/{toolkit}/operations`. */
+export const ToolkitOperationsResponseSchema = pageOf(ToolkitOperationSchema, 'A page of the operations one toolkit exposes.');
+/** One event a toolkit can deliver. */
+export const ToolkitEventSchema = z
+    .object({
+    slug: z.string().describe('The opaque event identifier.'),
+    displayName: z.string(),
+    description: z.string().optional(),
+    payloadSchema: z
+        .unknown()
+        .optional()
+        .describe('A JSON Schema for the event payload, where one is published.'),
+})
+    .describe('One event a toolkit can deliver.');
+/** `GET /v1/connections/toolkits/{toolkit}/events`. */
+export const ToolkitEventsResponseSchema = pageOf(ToolkitEventSchema, 'A page of the events one toolkit can deliver.');
+/** One managed connection belonging to the caller. */
+export const ConnectionSchema = z
+    .object({
+    id: IdSchema,
+    toolkit: z.string(),
+    displayName: z.string(),
+    status: ConnectionStatusSchema,
+    orgId: IdSchema.nullable(),
+    seatId: IdSchema.nullable(),
+    createdAt: TimestampSchema,
+    expiresAt: TimestampSchema.nullable(),
+    lastUsedAt: TimestampSchema.nullable(),
+})
+    .describe('One managed connection belonging to the caller.');
+/** `GET /v1/connections`. */
+export const ConnectionListResponseSchema = pageOf(ConnectionSchema, 'A page of the caller`s managed connections.');
+/** `POST /v1/connections/authentication-flows` — begin connecting a toolkit. */
+export const AuthenticationFlowRequestSchema = z
+    .object({
+    toolkit: z.string(),
+    seatId: IdSchema.optional().describe('The seat the resulting connection belongs to.'),
+    redirectUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe('Where to send the person after the hosted flow completes.'),
+})
+    .describe('Begin connecting a toolkit. The hosted page is a runtime value; no origin is baked into this package.');
+/** An authentication flow in progress. */
+export const AuthenticationFlowSchema = z
+    .object({
+    flowId: IdSchema,
+    toolkit: z.string(),
+    status: z
+        .enum(['pending', 'awaiting_user', 'succeeded', 'failed', 'expired'])
+        .describe('How far the flow has got.'),
+    redirectUrl: z
+        .string()
+        .url()
+        .nullable()
+        .describe('The hosted page to send the person to, or null when no redirect is needed.'),
+    connectionId: IdSchema.nullable().describe('The connection this flow produced, once it succeeded.'),
+    createdAt: TimestampSchema,
+    expiresAt: TimestampSchema,
+})
+    .describe('An authentication flow in progress, or its outcome.');
+/**
+ * `POST /v1/connections/authority-commands` — an operation on a connection
+ * that only the issuing authority can perform.
+ */
+export const AuthorityCommandRequestSchema = z
+    .object({
+    connectionId: IdSchema,
+    command: z
+        .enum(['refresh', 'reauthorize', 'disable', 'enable', 'delete'])
+        .describe('What to do to the connection. Mechanism only.'),
+    idempotencyKey: z
+        .string()
+        .min(1)
+        .describe('A client-chosen key. Repeating a command with the same key repeats its result, not its effect.'),
+})
+    .describe('An operation on a connection that only the issuing authority can perform.');
+/** The state of an authority command. */
+export const AuthorityCommandSchema = z
+    .object({
+    commandId: IdSchema,
+    connectionId: IdSchema,
+    status: z.enum(['queued', 'running', 'succeeded', 'failed']),
+    createdAt: TimestampSchema,
+    completedAt: TimestampSchema.nullable(),
+})
+    .describe('The state of an authority command.');
+/** `POST /v1/connections/executions` — run one toolkit operation. */
+export const ExecutionRequestSchema = z
+    .object({
+    connectionId: IdSchema,
+    operation: z.string().describe('The opaque operation slug to run.'),
+    input: z
+        .unknown()
+        .describe('The operation input, matching the operation`s published input schema.'),
+    idempotencyKey: z.string().min(1),
+})
+    .describe('Run one toolkit operation through a managed connection.');
+/** One attempt at a toolkit operation. */
+export const ExecutionSchema = z
+    .object({
+    attemptId: IdSchema,
+    connectionId: IdSchema,
+    operation: z.string(),
+    status: z.enum(['queued', 'running', 'succeeded', 'failed', 'canceled']),
+    startedAt: TimestampSchema,
+    completedAt: TimestampSchema.nullable(),
+    output: z
+        .unknown()
+        .optional()
+        .describe('The operation output, present once the attempt succeeded.'),
+    failure: z
+        .object({ reason: z.string(), retriable: z.boolean() })
+        .nullable()
+        .describe('Why the attempt failed, and whether repeating it could succeed.'),
+})
+    .describe('One attempt at a toolkit operation.');
+/**
+ * `POST /v1/connections/events/pull` — lease a batch of pending events.
+ *
+ * Lease-based and deliberately cursor-free: a pull hands out work, and only an
+ * exact lease receipt acknowledges it. The seat inbox is this route's sibling
+ * rather than a second design.
+ */
+export const ConnectionEventPullRequestSchema = z
+    .object({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('How many events to lease. Defaults to 50, capped at 100.'),
+})
+    .describe('Lease a batch of pending connector events. Cursor-free by design.');
+/** One leased connector event. */
+export const ConnectionEventSchema = z
+    .object({
+    id: IdSchema,
+    leaseToken: z
+        .string()
+        .min(1)
+        .describe('The receipt that acknowledges exactly this delivery of exactly this event.'),
+    connectionId: IdSchema,
+    toolkit: z.string(),
+    event: z.string().describe('The opaque event slug.'),
+    receivedAt: TimestampSchema,
+    expiresAt: TimestampSchema.describe('When the lease lapses and the event becomes pullable again.'),
+    payload: z.unknown(),
+})
+    .describe('One connector event, leased to exactly one puller until its lease expires.');
+/** A leased batch of connector events. */
+export const ConnectionEventPullResponseSchema = z
+    .object({ items: z.array(ConnectionEventSchema) })
+    .describe('A leased batch of connector events. No cursor, by design.');
+/** `POST /v1/connections/events/ack` — settle leases. */
+export const ConnectionEventAckRequestSchema = z
+    .object({
+    items: z
+        .array(z.object({ id: IdSchema, leaseToken: z.string().min(1) }))
+        .min(1)
+        .max(100),
+})
+    .describe('Settle event leases with exact receipts. One to a hundred at a time.');
+/** How many leases were settled. */
+export const ConnectionEventAckResponseSchema = z
+    .object({ acknowledged: z.number().int().nonnegative() })
+    .describe('How many leases the server settled.');
+/** `GET /v1/connections/usage` and `GET /v1/connections/{id}/usage`. */
+export const ConnectionUsageResponseSchema = z
+    .object({
+    periodStart: TimestampSchema,
+    periodEnd: TimestampSchema,
+    rows: z.array(z.object({
+        connectionId: IdSchema,
+        toolkit: z.string(),
+        actions: z.number().int().nonnegative().describe('How many operations ran in the period.'),
+        events: z
+            .number()
+            .int()
+            .nonnegative()
+            .describe('How many events were delivered in the period.'),
+    })),
+    totals: z.object({
+        actions: z.number().int().nonnegative(),
+        events: z.number().int().nonnegative(),
+    }),
+})
+    .describe('Counts of managed-connection activity for a period. Counts only; no amount appears here.');
+//# sourceMappingURL=connections.js.map

package/dist/connections.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@dork-labs/cloud-api` — the public wire contract for DorkOS Cloud.
+ *
+ * The root export is schemas, inferred types and route paths only. There is no
+ * network code here on purpose: a program can validate a payload against this
+ * contract without pulling in a client. The thin `fetch` client lives at
+ * `@dork-labs/cloud-api/client`.
+ *
+ * Two rules govern everything in this file, and both are enforced by tests in
+ * `src/__tests__/`:
+ *
+ * 1. **Additive within `/v1`.** New endpoints and new optional fields only.
+ *    Removing a field, or making an optional one required, is `/v2`.
+ * 2. **Catalog blindness.** No type here enumerates the plan catalog or the
+ *    model catalog. `planId`, `skuId`, `modelId`, add-on kinds and every
+ *    catalog-shaped identifier are opaque strings — never an enum, a literal
+ *    union, a const array or a value named in a description.
+ *
+ * @packageDocumentation
+ */
+export * from './primitives.js';
+export * from './problem.js';
+export * from './routes.js';
+export * from './session.js';
+export * from './instances.js';
+export * from './connections.js';
+export * from './billing.js';
+export * from './inference.js';
+export * from './seats.js';
+export * from './remote.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * `@dork-labs/cloud-api` — the public wire contract for DorkOS Cloud.
+ *
+ * The root export is schemas, inferred types and route paths only. There is no
+ * network code here on purpose: a program can validate a payload against this
+ * contract without pulling in a client. The thin `fetch` client lives at
+ * `@dork-labs/cloud-api/client`.
+ *
+ * Two rules govern everything in this file, and both are enforced by tests in
+ * `src/__tests__/`:
+ *
+ * 1. **Additive within `/v1`.** New endpoints and new optional fields only.
+ *    Removing a field, or making an optional one required, is `/v2`.
+ * 2. **Catalog blindness.** No type here enumerates the plan catalog or the
+ *    model catalog. `planId`, `skuId`, `modelId`, add-on kinds and every
+ *    catalog-shaped identifier are opaque strings — never an enum, a literal
+ *    union, a const array or a value named in a description.
+ *
+ * @packageDocumentation
+ */
+export * from './primitives.js';
+export * from './problem.js';
+export * from './routes.js';
+export * from './session.js';
+export * from './instances.js';
+export * from './connections.js';
+export * from './billing.js';
+export * from './inference.js';
+export * from './seats.js';
+export * from './remote.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}