@typeship-ax/mcp 0.8.0 → 0.9.1

package/src/resources/targets.ts

@@ -4,6 +4,7 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
@@ -53,6 +54,7 @@ export class TargetsResource {
     return paginate<TargetRead, TargetsListError>(this._core, {
       method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}/targets`,
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -82,16 +84,23 @@ export class TargetsResource {
    *
    * Several Targets may use the same generator with distinct configuration, Deliveries, and release
    * streams.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /projects/{project_id}/targets`
    */
   async create(
     projectId: ProjectId,
     body: TargetFields,
+    params?: TargetsCreateParams,
     options?: RequestOptions,
   ): Promise<ApiResult<TargetResponseRead, TargetsCreateError>> {
     return this._core.request<TargetResponseRead, TargetsCreateError>({
       method: "POST",
       path: `/projects/${encodeURIComponent(String(projectId))}/targets`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
       body,
       errors: {
         "400": BadRequestError,
@@ -102,6 +111,7 @@ export class TargetsResource {
         "422": UnprocessableEntityError,
         "429": RateLimitedError,
       },
+      idempotencyKey: "Idempotency-Key",
       schemaKey: "targets.create",
       options,
     });
@@ -118,6 +128,7 @@ export class TargetsResource {
     return this._core.request<TargetResponseRead, TargetsRetrieveError>({
       method: "GET",
       path: `/targets/${encodeURIComponent(String(targetId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -144,6 +155,7 @@ export class TargetsResource {
     return this._core.request<DeletedTargetRead, TargetsDeleteError>({
       method: "DELETE",
       path: `/targets/${encodeURIComponent(String(targetId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -169,6 +181,7 @@ export class TargetsResource {
     return this._core.request<TargetResponseRead, TargetsUpdateError>({
       method: "PATCH",
       path: `/targets/${encodeURIComponent(String(targetId))}`,
+      security: [{"apiKey":[]}],
       body,
       errors: {
         "400": BadRequestError,
@@ -198,6 +211,7 @@ export class TargetsResource {
     return paginate<TargetReleaseRead, TargetsListReleasesError>(this._core, {
       method: "GET",
       path: `/targets/${encodeURIComponent(String(targetId))}/releases`,
+      security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
@@ -233,6 +247,7 @@ export class TargetsResource {
     return this._core.request<TargetReleaseResponseRead, TargetsRetrieveReleaseError>({
       method: "GET",
       path: `/target_releases/${encodeURIComponent(String(targetReleaseId))}`,
+      security: [{"apiKey":[]}],
       errors: {
         "401": UnauthorizedError,
         "403": ForbiddenError,
@@ -264,9 +279,20 @@ export type TargetsListError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
+export interface TargetsCreateParams {
+  /**
+   * 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, 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 `create` can produce, as a discriminated union. */
 export type TargetsCreateError =
   | BadRequestError
@@ -277,6 +303,7 @@ export type TargetsCreateError =
   | UnprocessableEntityError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -287,6 +314,7 @@ export type TargetsRetrieveError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -298,6 +326,7 @@ export type TargetsDeleteError =
   | ConflictError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -311,6 +340,7 @@ export type TargetsUpdateError =
   | UnprocessableEntityError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -332,6 +362,7 @@ export type TargetsListReleasesError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;
 
@@ -342,5 +373,6 @@ export type TargetsRetrieveReleaseError =
   | NotFoundError
   | RateLimitedError
   | UnexpectedApiError
+  | ResponseParseError
   | TransportError
   | ValidationError;

package/src/schemas.ts

@@ -44,11 +44,15 @@ export const DEFS: Record<string, unknown> = {
   "req:UrlDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
   "req:InlineDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
   "req:GeneratorKind": {"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"]},"docs_index_url":{"type":["string","null"]}}},
+  "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"},"auth":{"$ref":"req:AuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_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":{"command_name":{"type":["string","null"]},"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":{"registry_name":{"type":["string","null"]},"tool_mode":{"type":"string","enum":["auto","operations","meta"]},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"}}},
+  "req:AuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_server":{"anyOf":[{"$ref":"req:OAuthServer"},{"type":"null"}]},"oauth_applications":{"type":["object","null"]},"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"identity_verification":{"anyOf":[{"$ref":"req:IdentityVerification"},{"type":"null"}]},"approval_url":{"type":["string","null"]},"environments":{"type":["object","null"]}}},
+  "req:OAuthServer": {"type":"object","additionalProperties":false,"properties":{"issuer":{"type":["string","null"]},"discovery_url":{"type":["string","null"]},"authorization_url":{"type":["string","null"]},"token_url":{"type":["string","null"]},"device_authorization_url":{"type":["string","null"]},"scopes":{"type":["array","null"],"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":500,"pattern":"^\\S+$"}},"audience":{"type":["string","null"]},"resource":{"type":["string","null"]}}},
+  "req:IdentityVerification": {"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":"string","maxLength":512},"account_field":{"type":"string","maxLength":512},"organization_field":{"type":"string","maxLength":512}}},
+  "req:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
+  "req:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"registry_name":{"type":["string","null"]},"access":{"type":"object","additionalProperties":false,"properties":{"issuer":{"type":"string"},"resource":{"type":"string"},"jwks_url":{"type":"string"},"scopes":{"type":"array","maxItems":20,"items":{"type":"string"}}},"required":["issuer","resource"]},"tool_mode":{"type":"string","enum":["auto","operations","meta"]},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"},"reference_resolvers":{"type":"object"}}},
+  "req:ReadmeBehavior": {"type":"object","additionalProperties":false,"properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
   "req:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_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"]}]},"request_id":{"$ref":"res:RequestId"}},"required":["files","warnings","meta","request_id"]},
   "res:GeneratedFile": {"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]},
@@ -71,24 +75,23 @@ export const DEFS: Record<string, unknown> = {
   "req:DefinitionPatch": {"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"]},
   "req:DiagnosticPolicy": {"type":"object","additionalProperties":false,"properties":{"fail_on":{"type":"string","enum":["never","error","warning"]},"only_new":{"type":"boolean"},"suppressions":{"type":"array","maxItems":100,"items":{"$ref":"req:DiagnosticSuppression"}}},"required":["fail_on","only_new","suppressions"]},
   "req:DiagnosticSuppression": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
-  "req:InitialTargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]},"deliveries":{"type":"array","items":{"$ref":"req:DeliveryInput"}}},"required":["name","generator"]},
-  "req:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "req:InitialTargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","generator"]},
+  "req:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:TargetAuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "req:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
   "req:DeliveryInput": {"anyOf":[{"$ref":"req:RepositoryDeliveryInput"},{"$ref":"req:HostedMcpDeliveryInput"}]},
   "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]}},"required":["kind","repository"]},
   "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"hosted_mcp"}},"required":["kind"]},
-  "res:Project": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"targets":{"type":"array","items":{"$ref":"res:Target"}},"deliveries":{"type":"array","items":{"$ref":"res:Delivery"}},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfig"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","definition_id","targets","deliveries","auto_generate","relay_enabled","config","created_at","updated_at","request_id"]},
-  "res:Target": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":"string"},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"res:ProjectConfig"},{"type":"null"}]},"deliveries":{"type":"array","items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","state","edition","release_channel","version_policy","current_version","proposed_version","config","deliveries","created_at","updated_at"]},
-  "res:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
-  "res:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "req:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:AuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "res:Project": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfig"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","definition_id","auto_generate","relay_enabled","config","created_at","updated_at","request_id"]},
+  "res:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"res:AuthenticationConfig"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"readme":{"$ref":"res:ReadmeBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_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:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"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":{"registry_name":{"type":["string","null"]},"tool_mode":{"type":"string"},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"}}},
+  "res:AuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_server":{"anyOf":[{"$ref":"res:OAuthServer"},{"type":"null"}]},"oauth_applications":{"type":["object","null"]},"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"identity_verification":{"anyOf":[{"$ref":"res:IdentityVerification"},{"type":"null"}]},"approval_url":{"type":["string","null"]},"environments":{"type":["object","null"]}}},
+  "res:OAuthServer": {"type":"object","additionalProperties":false,"properties":{"issuer":{"type":["string","null"]},"discovery_url":{"type":["string","null"]},"authorization_url":{"type":["string","null"]},"token_url":{"type":["string","null"]},"device_authorization_url":{"type":["string","null"]},"scopes":{"type":["array","null"],"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":500,"pattern":"^\\S+$"}},"audience":{"type":["string","null"]},"resource":{"type":["string","null"]}}},
+  "res:IdentityVerification": {"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","maxLength":2000,"pattern":"^[\\w$]+\\.[\\w$]+$"},"subject_field":{"type":"string","maxLength":512},"account_field":{"type":"string","maxLength":512},"organization_field":{"type":"string","maxLength":512}}},
+  "res:CliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]}}},
+  "res:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"registry_name":{"type":["string","null"]},"access":{"type":"object","additionalProperties":false,"properties":{"issuer":{"type":"string"},"resource":{"type":"string"},"jwks_url":{"type":"string"},"scopes":{"type":"array","maxItems":20,"items":{"type":"string"}}},"required":["issuer","resource"]},"tool_mode":{"type":"string"},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"},"reference_resolvers":{"type":"object"}}},
+  "res:ReadmeBehavior": {"type":"object","additionalProperties":false,"properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
   "res:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_name":{"type":["string","null"]}}},
-  "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"},{"type":"object"}]},
-  "res:RepositoryDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","created_at","updated_at"]},
-  "res:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
-  "res:RepositoryReference": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string"},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
-  "res:HostedMcpDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","url","created_at","updated_at"]},
   "res:DeletedProject": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
   "req:UpdateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}}},
   "res:DiagnosticReport": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"format":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analyzed_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"patch_diagnostics":{"type":"array","items":{"type":"string"}},"summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"policy":{"$ref":"res:DiagnosticPolicy"},"evaluation":{"$ref":"res:DiagnosticEvaluation"},"delta":{"$ref":"res:DiagnosticDelta"},"request_id":{"$ref":"res:RequestId"}},"required":["object","format","project_id","definition_revision_id","source_sha256","analyzed_sha256","patch_diagnostics","summary","diagnostics","policy","evaluation","delta","request_id"]},
@@ -106,13 +109,17 @@ export const DEFS: Record<string, unknown> = {
   "res:DiagnosticRemediation": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"kind":{"type":"string"},"patches_applied":{"type":"integer","minimum":0},"review_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","kind","patches_applied","request_id"]},
   "res:RepositoryIntegrationHealth": {"type":"object","additionalProperties":false,"properties":{"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"status":{"type":"string"},"repositories":{"type":"array","items":{"$ref":"res:RepositoryHealth"}},"required_checks":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"array","items":{"type":"string"}},"destination":{"type":"array","items":{"type":"string"}}},"required":["source","destination"]},"last_event":{"anyOf":[{"$ref":"res:RepositoryEventHealth"},{"type":"null"}]},"request_id":{"$ref":"res:RequestId"}},"required":["object","project_id","status","repositories","required_checks","last_event","request_id"]},
   "res:RepositoryHealth": {"type":"object","additionalProperties":false,"properties":{"repository":{"$ref":"res:RepositoryReference"},"roles":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"default_branch":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"breaking_acknowledgement":{"type":["boolean","null"]},"definition":{"type":"string"},"issues":{"type":"array","items":{"$ref":"res:RepositoryHealthIssue"}}},"required":["repository","roles","status","issues"]},
+  "res:RepositoryReference": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string"},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
   "res:RepositoryHealthIssue": {"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
   "res:RepositoryEventHealth": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string"},"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string"},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["provider","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"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:Generation": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"type":"string"},"trigger":{"type":"string"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"type":"object","additionalProperties":false,"properties":{"generator_edition":{"type":"string"},"engine_build":{"type":"string"},"resolved_config":{"type":["object","null"]},"config_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"surface_plan":{"type":["object","null"]},"surface_plan_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"entitlement_cap":{"type":["integer","null"],"minimum":1},"package_version":{"type":["string","null"]}},"required":["generator_edition","engine_build","resolved_config","config_hash","surface_plan","surface_plan_hash","entitlement_cap","package_version"]},"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"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","error","created_at"]},
+  "res:GenerationList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:GenerationSummary": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","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"}]}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
+  "res:GenerationStatus": {"type":"string"},
+  "res:GenerationTrigger": {"type":"string"},
+  "res:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
+  "res:GenerationProvenance": {"type":"object","additionalProperties":false,"properties":{"generator_edition":{"type":"string"},"engine_build":{"type":"string"},"resolved_config":{"type":["object","null"]},"config_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"surface_plan":{"type":["object","null"]},"surface_plan_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"entitlement_cap":{"type":["integer","null"],"minimum":1},"package_version":{"type":["string","null"]}},"required":["generator_edition","engine_build","resolved_config","config_hash","surface_plan","surface_plan_hash","entitlement_cap","package_version"]},
+  "res:GenerationBatch": {"type":"object","additionalProperties":false,"properties":{"data":{"type":"array","items":{"anyOf":[{"$ref":"res:GenerationSummary"},{"$ref":"res:GenerationFailure"}]}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
   "res:GenerationFailure": {"type":"object","additionalProperties":false,"properties":{"target_id":{"$ref":"res:TargetId"},"generator":{"$ref":"res:GeneratorKind"},"status":{"type":"string"},"error":{"type":"string"}},"required":["target_id","generator","status","error"]},
   "res:Definition": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"source":{"$ref":"res:DefinitionSource"},"format":{"type":["string","null"]},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"res:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"res:DiagnosticPolicy"},"latest_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","source","format","patches","graphql","diagnostic_policy","latest_revision_id","created_at","updated_at","request_id"]},
   "res:DefinitionSource": {"anyOf":[{"$ref":"res:UrlDefinitionSource"},{"$ref":"res:RepositoryDefinitionSource"},{"type":"object"}]},
@@ -121,17 +128,26 @@ export const DEFS: Record<string, unknown> = {
   "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"},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
   "req:DefinitionUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:DefinitionSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}}},
   "res:TargetList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Target"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "req:TargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition_id":{"$ref":"req:DefinitionId"},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]},"deliveries":{"type":"array","items":{"$ref":"req:DeliveryInput"}}},"required":["name","definition_id","generator"]},
+  "res:Target": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":"string"},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"res:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","state","edition","release_channel","version_policy","current_version","proposed_version","config","deliveries","created_at","updated_at"]},
+  "res:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"res:TargetAuthenticationConfig"},"cli":{"$ref":"res:CliBehavior"},"mcp":{"$ref":"res:McpBehavior"},"readme":{"$ref":"res:ReadmeBehavior"},"package":{"$ref":"res:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "res:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
+  "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"},{"type":"object"}]},
+  "res:RepositoryDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","created_at","updated_at"]},
+  "res:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
+  "res:HostedMcpDelivery": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","url","created_at","updated_at"]},
+  "req:TargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition_id":{"$ref":"req:DefinitionId"},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","definition_id","generator"]},
   "req:DefinitionId": {"type":"string","pattern":"^def_[a-z0-9]{16}$"},
   "res:TargetResponse": {"allOf":[{"$ref":"res:Target"},{"$ref":"res:ResponseMetadata"}]},
   "res:ResponseMetadata": {"type":"object","properties":{"request_id":{"$ref":"res:RequestId"}},"required":["request_id"]},
   "res:DeletedTarget": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
-  "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]},"deliveries":{"type":"array","items":{"$ref":"req:DeliveryInput"}}}},
+  "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}}},
   "res:TargetReleaseList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:TargetRelease"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
   "res:TargetRelease": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:TargetReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"$ref":"res:GenerationId"},"version":{"type":"string"},"channel":{"type":"string"},"provider":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReference"},{"type":"null"}]},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"delivery_revision":{"type":"string"},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","provider","repository","definition_revision_id","delivery_revision","created_at"]},
   "res:TargetReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
   "res:TargetReleaseResponse": {"allOf":[{"$ref":"res:TargetRelease"},{"$ref":"res:ResponseMetadata"}]},
   "res:GenerationResponse": {"allOf":[{"$ref":"res:Generation"},{"$ref":"res:ResponseMetadata"}]},
+  "res:Generation": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"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"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","error","created_at"]},
+  "res:FileStub": {"type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer"}},"required":["path","bytes"]},
   "res:DefinitionRevisionList": {"type":"object","additionalProperties":false,"properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:DefinitionRevision"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
   "res:DefinitionRevision": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionRevisionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"format":{"type":"string"},"document_count":{"type":"integer","minimum":1},"documents":{"type":"array","items":{"$ref":"res:DefinitionDocument"}},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"source":{"anyOf":[{"$ref":"res:DefinitionRevisionSource"},{"type":"null"}]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","format","document_count","sha256","size_bytes","source","created_at"]},
   "res:DefinitionDocument": {"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"res:DefinitionDocumentId"},"role":{"type":"string"},"coordinate":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0}},"required":["id","role","coordinate","sha256","size_bytes"]},