@typeship-ax/cli 0.6.0

package/src/resources/spec-revisions.ts

@@ -0,0 +1,150 @@
+// typeship — specRevisions resource.
+// Generated by typeship — https://typeship.dev — do not edit by hand.
+
+import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
+import { paginate, PagePromise } from "../core/pagination.js";
+import {
+  TransportError,
+  UnexpectedApiError,
+  ValidationError,
+  BadRequestError,
+  ForbiddenError,
+  NotFoundError,
+  RateLimitedError,
+  UnauthorizedError,
+} from "../errors.js";
+import type { ProjectId, SpecRevision, SpecRevisionId, SpecRevisionList } from "../types.js";
+
+export class SpecRevisionsResource {
+  constructor(private readonly _core: HttpCore) {}
+  /**
+   * List specification revisions
+   *
+   * Immutable snapshots of the exact source text this project consumed, newest first. Raw content
+   * is available from each revision's content endpoint and is never embedded in a list response.
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /projects/{project_id}/spec_revisions`
+   */
+  list(
+    projectId: ProjectId,
+    params?: SpecRevisionsListParams,
+    options?: RequestOptions,
+  ): PagePromise<SpecRevision, SpecRevisionsListError> {
+    return paginate<SpecRevision, SpecRevisionsListError>(this._core, {
+      method: "GET",
+      path: `/projects/${encodeURIComponent(String(projectId))}/spec_revisions`,
+      query: {
+        limit: params?.limit,
+        cursor: params?.cursor,
+      },
+      errors: {
+        "400": BadRequestError,
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+      },
+      idempotent: true,
+      schemaKey: "specRevisions.list",
+      options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
+    });
+  }
+
+  /**
+   * Retrieve a specification revision
+   *
+   * Metadata for one immutable source snapshot. Fetch raw source text from the content endpoint so
+   * metadata responses stay small and predictable.
+   * `GET /spec_revisions/{spec_revision_id}`
+   */
+  async retrieve(
+    specRevisionId: SpecRevisionId,
+    options?: RequestOptions,
+  ): Promise<ApiResult<SpecRevision, SpecRevisionsRetrieveError>> {
+    return this._core.request<SpecRevision, SpecRevisionsRetrieveError>({
+      method: "GET",
+      path: `/spec_revisions/${encodeURIComponent(String(specRevisionId))}`,
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+      },
+      idempotent: true,
+      schemaKey: "specRevisions.retrieve",
+      options,
+    });
+  }
+
+  /**
+   * Retrieve a specification revision's raw text
+   *
+   * Returns the exact source text identified by the revision's SHA-256 digest, suitable for saving
+   * or piping directly into a diff.
+   * `GET /spec_revisions/{spec_revision_id}/content`
+   */
+  async retrieveContent(
+    specRevisionId: SpecRevisionId,
+    options?: RequestOptions,
+  ): Promise<ApiResult<string, SpecRevisionsRetrieveContentError>> {
+    return this._core.request<string, SpecRevisionsRetrieveContentError>({
+      method: "GET",
+      path: `/spec_revisions/${encodeURIComponent(String(specRevisionId))}/content`,
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+      },
+      idempotent: true,
+      schemaKey: "specRevisions.retrieveContent",
+      options,
+    });
+  }
+}
+
+export interface SpecRevisionsListParams {
+  /** Maximum number of resources to return. */
+  limit?: number;
+  /** Opaque cursor from the preceding page's next_cursor. */
+  cursor?: string;
+}
+
+/** Every error `list` can produce, as a discriminated union. */
+export type SpecRevisionsListError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | UnexpectedApiError
+  | TransportError
+  | ValidationError;
+
+/** Every error `retrieve` can produce, as a discriminated union. */
+export type SpecRevisionsRetrieveError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | UnexpectedApiError
+  | TransportError
+  | ValidationError;
+
+/** Every error `retrieveContent` can produce, as a discriminated union. */
+export type SpecRevisionsRetrieveContentError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | UnexpectedApiError
+  | TransportError
+  | ValidationError;

package/src/schemas.ts

@@ -0,0 +1,90 @@
+// typeship — schema tables for optional runtime validation.
+// Generated by typeship — https://typeship.dev
+// Consumed by core/http.ts when the client's validate option is enabled;
+// carries no code, only data derived from the spec. Named components are
+// deduplicated into DEFS and referenced by "req:Name" / "res:Name" keys.
+
+export const SCHEMAS: Record<string, { req?: unknown; res?: unknown }> = {
+  "generate.run": {"req":{"$ref":"req:GenerateRequest"},"res":{"$ref":"res:GenerationResult"}},
+  "projects.list": {"res":{"$ref":"res:ProjectList"}},
+  "projects.create": {"req":{"$ref":"req:CreateProjectRequest"},"res":{"$ref":"res:Project"}},
+  "projects.retrieve": {"res":{"$ref":"res:Project"}},
+  "projects.delete": {"res":{"$ref":"res:DeletedProject"}},
+  "projects.update": {"req":{"$ref":"req:UpdateProjectRequest"},"res":{"$ref":"res:Project"}},
+  "projects.retrieveGithubHealth": {"res":{"$ref":"res:GithubIntegrationHealth"}},
+  "projects.listGenerations": {"res":{"$ref":"res:GenerationList"}},
+  "projects.generate": {"res":{"$ref":"res:GenerationBatch"}},
+  "generations.retrieve": {"res":{"$ref":"res:Generation"}},
+  "generations.retrieveFile": {"res":{"type":"string"}},
+  "specRevisions.list": {"res":{"$ref":"res:SpecRevisionList"}},
+  "specRevisions.retrieve": {"res":{"$ref":"res:SpecRevision"}},
+  "specRevisions.retrieveContent": {"res":{"type":"string"}},
+  "account.retrieve": {"res":{"$ref":"res:Account"}},
+  "apiKeys.list": {"res":{"$ref":"res:ApiKeyList"}},
+  "apiKeys.revoke": {"res":{"$ref":"res:ApiKey"}},
+};
+
+export const DEFS: Record<string, unknown> = {
+  "req:GenerateRequest": {"type":"object","additionalProperties":false,"properties":{"spec":{"$ref":"req:SpecInput"},"outputs":{"type":"array","minItems":1,"maxItems":1,"items":{"$ref":"req:OutputId"}},"package_name":{"type":"string"},"config":{"$ref":"req:Config"}},"required":["spec","outputs"]},
+  "req:SpecInput": {"anyOf":[{"$ref":"req:UrlSpecInput"},{"$ref":"req:InlineSpecInput"}]},
+  "req:UrlSpecInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
+  "req:InlineSpecInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
+  "req:OutputId": {"type":"string","enum":["typescript-sdk","python-sdk","go-sdk","cli","mcp"]},
+  "req:Config": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"graphql":{"$ref":"req:GraphqlSettings"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]}}},
+  "req:RetryTuning": {"type":"object","additionalProperties":false,"properties":{"max_retries":{"type":"integer","minimum":0,"maximum":10},"statuses":{"type":"array","maxItems":20,"items":{"type":"integer"}},"initial_delay_ms":{"type":"integer","minimum":1},"max_delay_ms":{"type":"integer","minimum":1},"retry_non_idempotent":{"type":"boolean"},"disabled":{"type":"boolean"},"operations":{"type":"object"}}},
+  "req:GraphqlSettings": {"type":"object","additionalProperties":false,"properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string","enum":["bearer","basic","api_key","none"]},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
+  "req:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"whoami_operation":{"type":["string","null"]},"oauth_client_id":{"type":["string","null"]},"oauth_scopes":{"type":"array","maxItems":20,"items":{"type":"string"}},"oauth_audience":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"auth_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
+  "req:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"tool_mode":{"type":"string","enum":["auto","operations","meta"]},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"}}},
+  "req:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"version":{"type":["string","null"]},"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"bin_name":{"type":["string","null"]},"go_package_name":{"type":["string","null"]},"mcp_name":{"type":["string","null"]}}},
+  "res:GenerationResult": {"type":"object","properties":{"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"warnings":{"type":"array","items":{"type":"string"}},"meta":{"$ref":"res:GenerationMeta"},"limits":{"$ref":"res:GenerationLimits"},"claim":{"anyOf":[{"type":"null"},{"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"}},"required":["url","expires_at"]}]}},"required":["files","warnings","meta"]},
+  "res:GeneratedFile": {"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]},
+  "res:GenerationMeta": {"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string"},"spec_format":{"type":"string","enum":["openapi","graphql"]},"oas_version":{"type":"string"},"converted":{"type":"boolean"},"package_name":{"type":"string"},"client_name":{"type":"string"},"outputs":{"type":"array","items":{"$ref":"res:OutputId"}},"resource_count":{"type":"integer"},"operation_count":{"type":"integer"},"schema_count":{"type":"integer"},"paginated_operation_count":{"type":"integer"},"omitted_operation_count":{"type":"integer"},"pr_url":{"type":["string","null"]},"pr_number":{"type":["integer","null"]},"pr_status":{"type":"string","enum":["opened","no_changes","blocked"]},"pr_error":{"type":"string"},"changelog":{"type":"string"},"breaking_count":{"type":"integer"},"baseline":{"type":"string","enum":["destination","last-generation","none"]},"package_compatibility":{"type":"string","enum":["success","failure"]},"package_compatibility_note":{"type":"string"},"previous_version":{"type":"string"},"file_count":{"type":"integer"},"total_lines":{"type":"integer"}},"required":["title","version","oas_version","package_name","client_name","outputs"]},
+  "res:OutputId": {"type":"string","enum":["typescript-sdk","python-sdk","go-sdk","cli","mcp"]},
+  "res:GenerationLimits": {"type":"object","properties":{"max_operations":{"type":"integer"},"omitted_operations":{"type":"integer"},"reason":{"type":"string","enum":["anonymous","free_plan"]},"signup_url":{"type":"string"},"upgrade_url":{"type":"string"}},"required":["max_operations","omitted_operations","reason","upgrade_url"]},
+  "res:ProjectList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Project"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["object","data","has_more","next_cursor"]},
+  "res:ListObject": {"type":"string","const":"list"},
+  "res:Project": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string","const":"project"},"name":{"type":"string","maxLength":80},"source":{"$ref":"res:ProjectSource"},"packages":{"$ref":"res:ProjectPackages"},"auto_regen":{"type":"boolean"},"spec_patches":{"type":"array","items":{"$ref":"res:SpecPatch"}},"config":{"anyOf":[{"$ref":"res:Config"},{"type":"null"}]},"mcp_enabled":{"type":"boolean"},"mcp_url":{"type":["string","null"]},"relay_enabled":{"type":"boolean"},"outputs":{"type":"array","minItems":1,"items":{"$ref":"res:OutputId"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","source","packages","auto_regen","spec_patches","config","mcp_enabled","mcp_url","relay_enabled","outputs","created_at","updated_at"]},
+  "res:ProjectId": {"type":"string","pattern":"^prj_[a-z0-9]{16}$"},
+  "res:ProjectSource": {"anyOf":[{"$ref":"res:UrlProjectSource"},{"$ref":"res:GithubProjectSource"}]},
+  "res:UrlProjectSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"url"},"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers_configured":{"type":"boolean"}},"required":["kind","url","headers_configured"]},
+  "res:GithubProjectSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"github"},"repository":{"type":"string","maxLength":202,"pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["kind","repository","path"]},
+  "res:ProjectPackages": {"type":"object","additionalProperties":false,"properties":{"typescript-sdk":{"$ref":"res:ProjectPackageDelivery"},"python-sdk":{"$ref":"res:ProjectPackageDelivery"},"go-sdk":{"$ref":"res:ProjectPackageDelivery"},"cli":{"$ref":"res:ProjectPackageDelivery"},"mcp":{"$ref":"res:ProjectPackageDelivery"}},"required":["typescript-sdk","python-sdk","go-sdk","cli","mcp"]},
+  "res:ProjectPackageDelivery": {"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"]},"version":{"type":["string","null"]},"destination":{"anyOf":[{"$ref":"res:ProjectDestination"},{"type":"null"}]}},"required":["name","version","destination"]},
+  "res:ProjectDestination": {"type":"object","additionalProperties":false,"properties":{"repo":{"type":["string","null"]},"directory":{"type":["string","null"]}},"required":["repo","directory"]},
+  "res:SpecPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string","enum":["set","append","remove","rename"]},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
+  "res:Config": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"graphql":{"$ref":"res:GraphqlSettings"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]}}},
+  "res:RetryTuning": {"type":"object","additionalProperties":false,"properties":{"max_retries":{"type":"integer","minimum":0,"maximum":10},"statuses":{"type":"array","maxItems":20,"items":{"type":"integer"}},"initial_delay_ms":{"type":"integer","minimum":1},"max_delay_ms":{"type":"integer","minimum":1},"retry_non_idempotent":{"type":"boolean"},"disabled":{"type":"boolean"},"operations":{"type":"object"}}},
+  "res:GraphqlSettings": {"type":"object","additionalProperties":false,"properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string","enum":["bearer","basic","api_key","none"]},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
+  "res:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"whoami_operation":{"type":["string","null"]},"oauth_client_id":{"type":["string","null"]},"oauth_scopes":{"type":"array","maxItems":20,"items":{"type":"string"}},"oauth_audience":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"auth_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
+  "res:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"tool_mode":{"type":"string","enum":["auto","operations","meta"]},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"}}},
+  "res:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"version":{"type":["string","null"]},"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"bin_name":{"type":["string","null"]},"go_package_name":{"type":["string","null"]},"mcp_name":{"type":["string","null"]}}},
+  "req:CreateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"source":{"$ref":"req:ProjectSourceInput"},"outputs":{"type":"array","minItems":1,"items":{"$ref":"req:OutputId"}},"packages":{"$ref":"req:Packages"},"auto_regen":{"type":"boolean"},"spec_patches":{"type":"array","maxItems":50,"items":{"$ref":"req:SpecPatch"}},"mcp_enabled":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:Config"},{"type":"null"}]}},"required":["name","source","outputs"]},
+  "req:ProjectSourceInput": {"anyOf":[{"$ref":"req:UrlProjectSourceInput"},{"$ref":"req:GithubProjectSourceInput"}]},
+  "req:UrlProjectSourceInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"url"},"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers":{"anyOf":[{"type":"object"},{"type":"null"}]}},"required":["kind","url"]},
+  "req:GithubProjectSourceInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"github"},"repository":{"type":"string","maxLength":202,"pattern":"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["kind","repository","path"]},
+  "req:Packages": {"type":"object","additionalProperties":false,"properties":{"typescript-sdk":{"$ref":"req:PackageDelivery"},"python-sdk":{"$ref":"req:PackageDelivery"},"go-sdk":{"$ref":"req:PackageDelivery"},"cli":{"$ref":"req:PackageDelivery"},"mcp":{"$ref":"req:PackageDelivery"}}},
+  "req:PackageDelivery": {"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"]},"version":{"type":["string","null"],"pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},"destination":{"anyOf":[{"$ref":"req:Destination"},{"type":"null"}]}}},
+  "req:Destination": {"type":"object","additionalProperties":false,"properties":{"repo":{"type":["string","null"]},"directory":{"type":["string","null"]}}},
+  "req:SpecPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string","enum":["set","append","remove","rename"]},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
+  "res:DeletedProject": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string","const":"project"},"deleted":{"type":"boolean","const":true}},"required":["id","object","deleted"]},
+  "req:UpdateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"source":{"$ref":"req:ProjectSourceInput"},"outputs":{"type":"array","minItems":1,"items":{"$ref":"req:OutputId"}},"packages":{"$ref":"req:Packages"},"auto_regen":{"type":"boolean"},"spec_patches":{"type":"array","maxItems":50,"items":{"$ref":"req:SpecPatch"}},"mcp_enabled":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:Config"},{"type":"null"}]}}},
+  "res:GithubIntegrationHealth": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string","const":"github_integration_health"},"project_id":{"$ref":"res:ProjectId"},"status":{"type":"string","enum":["ready","action_required"]},"repositories":{"type":"array","items":{"$ref":"res:GithubRepositoryHealth"}},"required_statuses":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"array","items":{"type":"string"}},"destination":{"type":"array","items":{"type":"string"}}},"required":["source","destination"]},"last_delivery":{"anyOf":[{"$ref":"res:GithubDeliveryHealth"},{"type":"null"}]}},"required":["object","project_id","status","repositories","required_statuses","last_delivery"]},
+  "res:GithubRepositoryHealth": {"type":"object","additionalProperties":false,"properties":{"repository":{"type":"string"},"roles":{"type":"array","items":{"type":"string","enum":["source","destination"]}},"status":{"type":"string","enum":["ready","action_required"]},"default_branch":{"type":"string"},"can_read":{"type":"boolean"},"can_write":{"type":"boolean"},"breaking_label":{"type":["boolean","null"]},"spec":{"type":"string","enum":["readable","missing"]},"issues":{"type":"array","items":{"$ref":"res:GithubHealthIssue"}}},"required":["repository","roles","status","issues"]},
+  "res:GithubHealthIssue": {"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["installation_missing","spec_unreadable","contents_write_missing","breaking_label_missing","github_unavailable"]},"message":{"type":"string"}},"required":["code","message"]},
+  "res:GithubDeliveryHealth": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string","enum":["queued","processing","succeeded","failed","superseded"]},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","event","status","error","created_at"]},
+  "res:GenerationList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Generation"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["object","data","has_more","next_cursor"]},
+  "res:Generation": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string","const":"generation"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"status":{"type":"string","enum":["succeeded","failed"]},"trigger":{"type":"string","enum":["manual","webhook","poll","preview"]},"output":{"$ref":"res:OutputId"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","object","project_id","status","trigger","output","meta","warnings","error","created_at"]},
+  "res:GenerationId": {"type":"string","pattern":"^gen_[a-z0-9]{16}$"},
+  "res:FileStub": {"type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer"}},"required":["path","bytes"]},
+  "res:GenerationBatch": {"type":"object","additionalProperties":false,"properties":{"data":{"type":"array","items":{"anyOf":[{"$ref":"res:Generation"},{"$ref":"res:GenerationFailure"}]}}},"required":["data"]},
+  "res:GenerationFailure": {"type":"object","additionalProperties":false,"properties":{"output":{"$ref":"res:OutputId"},"status":{"type":"string","const":"failed"},"error":{"type":"string"}},"required":["output","status","error"]},
+  "res:SpecRevisionList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:SpecRevision"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["object","data","has_more","next_cursor"]},
+  "res:SpecRevision": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:SpecRevisionId"},"object":{"type":"string","const":"spec_revision"},"project_id":{"$ref":"res:ProjectId"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"source":{"anyOf":[{"$ref":"res:SpecRevisionSource"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","object","project_id","sha256","size_bytes","source","created_at"]},
+  "res:SpecRevisionId": {"type":"string","pattern":"^spec_[a-z0-9]{16}$"},
+  "res:SpecRevisionSource": {"anyOf":[{"$ref":"res:UrlSpecRevisionSource"},{"$ref":"res:GithubSpecRevisionSource"}]},
+  "res:UrlSpecRevisionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"url"},"url":{"type":"string"}},"required":["kind","url"]},
+  "res:GithubSpecRevisionSource": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"github"},"repository":{"type":"string"},"path":{"type":"string"},"ref":{"type":["string","null"]},"commit_sha":{"type":["string","null"]}},"required":["kind","repository","path"]},
+  "res:Account": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^org_[A-Za-z0-9]+$"},"object":{"type":"string","const":"account"},"name":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"created_at":{"type":"string"}},"required":["id","object","name","plan","created_at"]},
+  "res:ApiKeyList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:ApiKey"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["object","data","has_more","next_cursor"]},
+  "res:ApiKey": {"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"object":{"type":"string","const":"api_key"},"name":{"type":"string"},"last4":{"type":"string"},"revoked":{"type":"boolean"},"last_used_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","object","name","last4","revoked","last_used_at","created_at"]},
+};