@typeship-ax/mcp 0.19.0 → 0.20.0

package/src/resources/files.ts

@@ -0,0 +1,68 @@
+// typeship — files resource.
+// Generated by typeship — https://typeship.dev
+
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import {
+  ResponseParseError,
+  TransportError,
+  UnexpectedApiError,
+  ValidationError,
+  BadRequestError,
+  ForbiddenError,
+  InternalServerError,
+  NotFoundError,
+  RateLimitedError,
+  UnauthorizedError,
+} from "../errors.js";
+import type { FileId, FileResponse, FileResponseRead } from "../types.js";
+
+export class FilesResource {
+  constructor(private readonly _core: HttpCore) {}
+  /**
+   * Get a file
+   *
+   * Returns one bounded chunk of an immutable file: at most 24 KiB, as UTF-8 text or, for binary
+   * bytes, base64. When next_cursor is not null, repeat the request with cursor and concatenate the
+   * chunks in order. A file ID always returns the same bytes.
+   * `GET /files/{file_id}`
+   */
+  async get(fileId: FileId, params?: FilesGetParams, options?: RequestOptions): Promise<FileResponseRead> {
+    return this._core.requestData<FileResponseRead, FilesGetError>({
+      method: "GET",
+      path: `/files/${encodeURIComponent(String(fileId))}`,
+      security: [{"apiKey":[]}],
+      query: {
+        cursor: params?.cursor,
+      },
+      errors: {
+        "400": BadRequestError,
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+        "500": InternalServerError,
+      },
+      idempotent: true,
+      schemaKey: "files.get",
+      options,
+    });
+  }
+}
+
+export interface FilesGetParams {
+  /** next_cursor from the preceding chunk of this file. */
+  cursor?: string;
+}
+
+/** Typed errors `get` can throw. */
+export type FilesGetError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;

package/src/resources/generate.ts

@@ -1,7 +1,7 @@
 // typeship — generate resource.
 // Generated by typeship — https://typeship.dev
 
-import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
+import { HttpCore, type RequestOptions } from "../core/http.js";
 import {
   ResponseParseError,
   TransportError,
@@ -23,7 +23,7 @@ import type { GenerateRequest, GenerationResult, GenerationResultRead } from "..
 export class GenerateResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * Generate one package from a Definition
+   * Generate one package from a Spec
    *
    * Returns one generated package without creating a Project.
    *
@@ -33,12 +33,12 @@ export class GenerateResource {
    * Use `download.url` to save the complete ZIP, verify `download.sha256`, and extract it into an
    * empty directory. The link expires at `download.expires_at` and grants access to anyone who has
    * it. CLI, MCP, and SDK calls supply an idempotency key automatically. Agents should request
-   * `fields=["download","meta","warnings","limits","claim"]` to keep the MCP result compact; files
-   * can exceed the response limit. Download the ZIP instead of repeating generation to retrieve
-   * omitted files.
+   * `fields=["download","coverage","warnings","claim"]` to keep the MCP result compact; files can
+   * exceed the response limit. Download the ZIP instead of repeating generation to retrieve omitted
+   * files.
    *
    * Anonymous and Free requests include the first 25 operations. Paid plans include all operations.
-   * Anonymous requests are rate limited by IP address. Check `limits` for omitted operations; an
+   * Anonymous requests are rate limited by IP address. Check `coverage` for omitted operations; an
    * invalid API key returns `401`.
    *
    * An anonymous URL request without source headers may return `claim.url`. Sign in through that
@@ -51,8 +51,8 @@ export class GenerateResource {
     body: GenerateRequest,
     params?: GenerateRunParams,
     options?: RequestOptions,
-  ): Promise<ApiResult<GenerationResultRead, GenerateRunError>> {
-    return this._core.request<GenerationResultRead, GenerateRunError>({
+  ): Promise<GenerationResultRead> {
+    return this._core.requestData<GenerationResultRead, GenerateRunError>({
       method: "POST",
       path: "/generate",
       security: [{},{"apiKey":[]}],
@@ -90,11 +90,8 @@ export class GenerateResource {
    * creates a new download.
    * `GET /generate/download`
    */
-  async downloadPackage(
-    params: GenerateDownloadPackageParams,
-    options?: RequestOptions,
-  ): Promise<ApiResult<Blob, GenerateDownloadPackageError>> {
-    return this._core.request<Blob, GenerateDownloadPackageError>({
+  async downloadPackage(params: GenerateDownloadPackageParams, options?: RequestOptions): Promise<Blob> {
+    return this._core.requestData<Blob, GenerateDownloadPackageError>({
       method: "GET",
       path: "/generate/download",
       security: [{}],
@@ -116,15 +113,15 @@ export class GenerateResource {
 
 export interface GenerateRunParams {
   /**
-   * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
-   * operation; account-less generation uses a hashed network identity. Retrying the same method,
-   * path, query, If-Match header, and JSON body replays the original response. Reusing the key with
-   * changed intent returns 409. After expiry the key starts a new write.
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated organization
+   * and operation; generation without an organization uses a hashed network identity. Retrying the
+   * same method, path, query, If-Match header, and JSON body replays the original response. Reusing
+   * the key with changed intent returns 409. After expiry the key starts a new write.
    */
   idempotencyKey?: string;
 }
 
-/** Every error `run` can produce, as a discriminated union. */
+/** Typed errors `run` can throw. */
 export type GenerateRunError =
   | BadRequestError
   | UnauthorizedError
@@ -145,7 +142,7 @@ export interface GenerateDownloadPackageParams {
   token: string;
 }
 
-/** Every error `downloadPackage` can produce, as a discriminated union. */
+/** Typed errors `downloadPackage` can throw. */
 export type GenerateDownloadPackageError =
   | BadRequestError
   | NotFoundError

package/src/resources/generations.ts

@@ -1,7 +1,8 @@
 // typeship — generations resource.
 // Generated by typeship — https://typeship.dev
 
-import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { paginate, PagePromise } from "../core/pagination.js";
 import {
   ResponseParseError,
   TransportError,
@@ -14,24 +15,77 @@ import {
   RateLimitedError,
   UnauthorizedError,
 } from "../errors.js";
-import type { GenerationId, GenerationResponse, GenerationResponseRead } from "../types.js";
+import type {
+  FileList,
+  FileListRead,
+  FileModel,
+  FileModelRead,
+  GenerationId,
+  GenerationList,
+  GenerationListRead,
+  GenerationResponse,
+  GenerationResponseRead,
+  GenerationStatus,
+  GenerationSummary,
+  GenerationSummaryRead,
+  ProjectId,
+  TargetId,
+} from "../types.js";
 
 export class GenerationsResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * Retrieve a generation
+   * List generations
    *
-   * Returns the current Generation status. `queued` and `running` mean generation is still in
-   * progress. `succeeded` means generated files are saved, not that repository delivery or a Draft
-   * is complete. Successful results include files, or a file index when the package is too large to
-   * inline.
-   * `GET /generations/{generation_id}`
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /generations`
    */
-  async retrieve(
-    generationId: GenerationId,
+  list(
+    params?: GenerationsListParams,
     options?: RequestOptions,
-  ): Promise<ApiResult<GenerationResponseRead, GenerationsRetrieveError>> {
-    return this._core.request<GenerationResponseRead, GenerationsRetrieveError>({
+  ): PagePromise<GenerationSummaryRead, GenerationsListError> {
+    return paginate<GenerationSummaryRead, GenerationsListError>(this._core, {
+      method: "GET",
+      path: "/generations",
+      security: [{"apiKey":[]}],
+      query: {
+        limit: params?.limit,
+        cursor: params?.cursor,
+        project_id: params?.projectId,
+        target_id: params?.targetId,
+        status: params?.status,
+      },
+      errors: {
+        "400": BadRequestError,
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+        "500": InternalServerError,
+      },
+      idempotent: true,
+      schemaKey: "generations.list",
+      options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
+    });
+  }
+
+  /**
+   * Get a generation
+   *
+   * Returns the status of that Generation. `queued` and `running` mean generation is still in
+   * progress. `completed` means generated files are saved, not that repository delivery or a Draft
+   * is complete. List its files with listGenerationFiles and read each with getFile.
+   * `GET /generations/{generation_id}`
+   */
+  async get(generationId: GenerationId, options?: RequestOptions): Promise<GenerationResponseRead> {
+    return this._core.requestData<GenerationResponseRead, GenerationsGetError>({
       method: "GET",
       path: `/generations/${encodeURIComponent(String(generationId))}`,
       security: [{"apiKey":[]}],
@@ -43,29 +97,31 @@ export class GenerationsResource {
         "500": InternalServerError,
       },
       idempotent: true,
-      schemaKey: "generations.retrieve",
+      schemaKey: "generations.get",
       options,
     });
   }
 
   /**
-   * Fetch one file from a generation
+   * List a Generation's files
    *
-   * Returns one file's raw content. Use a path from `files_index` when the Generation reports
-   * `files_omitted: true`.
-   * `GET /generations/{generation_id}/file`
+   * Lists the generated package's files, ordered by path. Read content with getFile.
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /generations/{generation_id}/files`
    */
-  async retrieveFile(
+  listFiles(
     generationId: GenerationId,
-    params: GenerationsRetrieveFileParams,
+    params?: GenerationsListFilesParams,
     options?: RequestOptions,
-  ): Promise<ApiResult<string, GenerationsRetrieveFileError>> {
-    return this._core.request<string, GenerationsRetrieveFileError>({
+  ): PagePromise<FileModelRead, GenerationsListFilesError> {
+    return paginate<FileModelRead, GenerationsListFilesError>(this._core, {
       method: "GET",
-      path: `/generations/${encodeURIComponent(String(generationId))}/file`,
+      path: `/generations/${encodeURIComponent(String(generationId))}/files`,
       security: [{"apiKey":[]}],
       query: {
-        path: params.path,
+        limit: params?.limit,
+        cursor: params?.cursor,
       },
       errors: {
         "400": BadRequestError,
@@ -76,8 +132,15 @@ export class GenerationsResource {
         "500": InternalServerError,
       },
       idempotent: true,
-      schemaKey: "generations.retrieveFile",
+      schemaKey: "generations.listFiles",
       options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
     });
   }
 
@@ -85,15 +148,15 @@ export class GenerationsResource {
   async wait(
     generationId: GenerationId,
     options: RequestOptions & { intervalMs?: number; waitTimeoutMs?: number } = {},
-  ): Promise<ApiResult<GenerationResponseRead, GenerationsRetrieveError>> {
-    const { intervalMs = 1_000, waitTimeoutMs = 600_000, ...requestOptions } = options;
+  ): Promise<GenerationResponseRead> {
+    const { intervalMs = 3_000, waitTimeoutMs = 600_000, ...requestOptions } = options;
     const deadline = Date.now() + waitTimeoutMs;
     while (true) {
       if (requestOptions.signal?.aborted) {
         throw requestOptions.signal.reason ?? new Error("Generation wait aborted.");
       }
-      const result = await this.retrieve(generationId, requestOptions);
-      if (!result.ok || (result.data.status !== "queued" && result.data.status !== "running")) return result;
+      const result = await this.get(generationId, requestOptions);
+      if (result.status !== "queued" && result.status !== "running") return result;
       if (Date.now() >= deadline) throw new Error("Timed out waiting for Generation " + generationId + ".");
       await new Promise<void>((resolve) =>
         setTimeout(resolve, Math.min(intervalMs, deadline - Date.now())));
@@ -101,8 +164,44 @@ export class GenerationsResource {
   }
 }
 
-/** Every error `retrieve` can produce, as a discriminated union. */
-export type GenerationsRetrieveError =
+export interface GenerationsListParams {
+  /**
+   * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
+   * representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400
+   * invalid_request. List query parameters must appear only once; unrecognized parameters also
+   * return 400.
+   */
+  limit?: number;
+  /**
+   * Opaque cursor from the preceding page's next_cursor. Valid only for the same organization,
+   * operation, filters, and ordering that issued it. Omit to start at the first page. Empty,
+   * malformed, or repeated cursors return 400 invalid_request. The page limit may change between
+   * requests.
+   */
+  cursor?: string;
+  /** Only Generations in this Project. */
+  projectId?: ProjectId;
+  /** Only Generations of this Target. */
+  targetId?: TargetId;
+  /** Only Generations with this status. */
+  status?: GenerationStatus;
+}
+
+/** Typed errors `list` can throw. */
+export type GenerationsListError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+/** Typed errors `get` can throw. */
+export type GenerationsGetError =
   | UnauthorizedError
   | ForbiddenError
   | NotFoundError
@@ -113,13 +212,25 @@ export type GenerationsRetrieveError =
   | TransportError
   | ValidationError;
 
-export interface GenerationsRetrieveFileParams {
-  /** Repo-relative path inside the generated package. */
-  path: string;
+export interface GenerationsListFilesParams {
+  /**
+   * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
+   * representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400
+   * invalid_request. List query parameters must appear only once; unrecognized parameters also
+   * return 400.
+   */
+  limit?: number;
+  /**
+   * Opaque cursor from the preceding page's next_cursor. Valid only for the same organization,
+   * operation, filters, and ordering that issued it. Omit to start at the first page. Empty,
+   * malformed, or repeated cursors return 400 invalid_request. The page limit may change between
+   * requests.
+   */
+  cursor?: string;
 }
 
-/** Every error `retrieveFile` can produce, as a discriminated union. */
-export type GenerationsRetrieveFileError =
+/** Typed errors `listFiles` can throw. */
+export type GenerationsListFilesError =
   | BadRequestError
   | UnauthorizedError
   | ForbiddenError

package/src/resources/{account.ts → organization.ts}

@@ -1,7 +1,7 @@
-// typeship — account resource.
+// typeship — organization resource.
 // Generated by typeship — https://typeship.dev
 
-import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
+import { HttpCore, type RequestOptions } from "../core/http.js";
 import {
   ResponseParseError,
   TransportError,
@@ -12,21 +12,21 @@ import {
   RateLimitedError,
   UnauthorizedError,
 } from "../errors.js";
-import type { Account, AccountRead } from "../types.js";
+import type { Organization, OrganizationRead } from "../types.js";
 
-export class AccountResource {
+export class OrganizationResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * The account behind the presented credentials
+   * The organization behind the presented credentials
    *
-   * Returns the account associated with your credential. The Typeship CLI uses this endpoint for
-   * `whoami`.
-   * `GET /me`
+   * Returns the organization associated with your credential. The Typeship CLI uses this endpoint
+   * for `whoami`.
+   * `GET /organization`
    */
-  async retrieve(options?: RequestOptions): Promise<ApiResult<AccountRead, AccountRetrieveError>> {
-    return this._core.request<AccountRead, AccountRetrieveError>({
+  async get(options?: RequestOptions): Promise<OrganizationRead> {
+    return this._core.requestData<OrganizationRead, OrganizationGetError>({
       method: "GET",
-      path: "/me",
+      path: "/organization",
       security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
@@ -35,14 +35,14 @@ export class AccountResource {
         "500": InternalServerError,
       },
       idempotent: true,
-      schemaKey: "account.retrieve",
+      schemaKey: "organization.get",
       options,
     });
   }
 }
 
-/** Every error `retrieve` can produce, as a discriminated union. */
-export type AccountRetrieveError =
+/** Typed errors `get` can throw. */
+export type OrganizationGetError =
   | UnauthorizedError
   | ForbiddenError
   | RateLimitedError