@aventurevc/api-schemas 0.7.301 → 0.7.328

package/README.md

@@ -2,4 +2,10 @@
 
 Zod v4 schemas for the public aVenture API.
 
-This package is generated from the canonical back-end OpenAPI spec and must not be hand-edited.
+Generated from the published aVenture OpenAPI specification; do not edit by hand.
+
+```bash
+npm install @aventurevc/api-schemas --@aventurevc:registry=https://registry.npmjs.org/
+```
+
+Endpoint reference: https://docs.aventure.vc/api-reference

package/dist/address/address.d.ts

@@ -3,11 +3,7 @@ import { z } from "zod/v4";
  * Canonical address record for entity and person payloads
  *
  * @openapiSchema Address
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,16 +23,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityEnrichmentSchema
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema PersonEnrichmentSchema

package/dist/address/address.js

@@ -8,11 +8,7 @@ import { AddressStateSchema } from "./state.js";
  * Canonical address record for entity and person payloads
  *
  * @openapiSchema Address
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -32,16 +28,13 @@ import { AddressStateSchema } from "./state.js";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema EntityEnrichmentSchema
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema PersonEnrichmentSchema

package/dist/address/association-role.d.ts

@@ -3,11 +3,7 @@ import { z } from "zod/v4";
  * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,16 +23,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressAssociationSchema
  * @contractShape address.association-role
  * @contractRole canonical

package/dist/address/association-role.js

@@ -4,11 +4,7 @@ import { z } from "zod/v4";
  * Meaning of an entity or person address association. Domicile is a legal or registered seat and is not evidence of operational presence; dominant is the predominant display location; origin is the founding or historical location.
  *
  * @openapiSchema AddressAssociationRole
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,16 +24,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressAssociationSchema
  * @contractShape address.association-role
  * @contractRole canonical

package/dist/address/association.d.ts

@@ -15,11 +15,7 @@ type AddressAssociationDefinition = z.infer<typeof AddressAssociationSchemaDefin
  * One role and effective period for a physical address association
  *
  * @openapiSchema AddressAssociation
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -39,16 +35,13 @@ type AddressAssociationDefinition = z.infer<typeof AddressAssociationSchemaDefin
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.association
  * @contractRole canonical

package/dist/address/association.js

@@ -17,11 +17,7 @@ const AddressAssociationSchemaDefinition = z.object({
  * One role and effective period for a physical address association
  *
  * @openapiSchema AddressAssociation
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -41,16 +37,13 @@ const AddressAssociationSchemaDefinition = z.object({
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.association
  * @contractRole canonical

package/dist/address/city.d.ts

@@ -3,11 +3,7 @@ import { z } from "zod/v4";
  * City reference used inside an address
  *
  * @openapiSchema AddressCity
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,16 +23,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.city
  * @contractRole canonical

package/dist/address/city.js

@@ -4,11 +4,7 @@ import { z } from "zod/v4";
  * City reference used inside an address
  *
  * @openapiSchema AddressCity
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,16 +24,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.city
  * @contractRole canonical

package/dist/address/country.d.ts

@@ -3,11 +3,7 @@ import { z } from "zod/v4";
  * Country reference used inside an address
  *
  * @openapiSchema AddressCountry
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,16 +23,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.country
  * @contractRole canonical

package/dist/address/country.js

@@ -4,11 +4,7 @@ import { z } from "zod/v4";
  * Country reference used inside an address
  *
  * @openapiSchema AddressCountry
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,16 +24,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.country
  * @contractRole canonical

package/dist/address/state.d.ts

@@ -3,11 +3,7 @@ import { z } from "zod/v4";
  * State or region reference used inside an address
  *
  * @openapiSchema AddressState
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -27,16 +23,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.state
  * @contractRole canonical

package/dist/address/state.js

@@ -4,11 +4,7 @@ import { z } from "zod/v4";
  * State or region reference used inside an address
  *
  * @openapiSchema AddressState
- * @endpoint GET /v1/entities
- * @endpoint GET /v1/entities/detail
- * @endpoint GET /v1/entities/detail/similar
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -28,16 +24,13 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/entities
  * @usedBySchema AddressSchema
  * @contractShape address.state
  * @contractRole canonical

package/dist/agent/help-question.d.ts

@@ -14,6 +14,7 @@ type AgentHelpQuestionDefinition = z.infer<typeof AgentHelpQuestionSchemaDefinit
  *
  * @openapiSchema AgentHelpQuestion
  * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
  * @contractShape agent.help-question
  * @contractRole canonical
  */

package/dist/agent/help-question.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { HelpScopeSchema } from "../help/scope.js";
 const AgentHelpQuestionSchemaDefinition = z.object({
-    /** Optional chat model that answers the question; null uses the configured default. A CLIENT_SECRET (non-admin) caller may only choose a client-secret-eligible model (owned by app.inference.client-secret-eligible-chat-model); an ineligible model is rejected with 422. Admin keys are unrestricted. */
+    /** Optional chat model that answers the question; null uses the configured default. A caller without admin authority may only choose an allowlisted model; an ineligible model is rejected with 422. Admin callers are unrestricted. */
     model: z.string().nullish(),
     /** The question to answer, in natural language. */
     question: z.string().min(1),
@@ -14,6 +14,7 @@ const AgentHelpQuestionSchemaDefinition = z.object({
  *
  * @openapiSchema AgentHelpQuestion
  * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
  * @contractShape agent.help-question
  * @contractRole canonical
  */

package/dist/agent/help.d.ts

@@ -17,7 +17,6 @@ declare const AgentHelpSchemaDefinition: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
-    recommendedCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;
 /**
@@ -25,6 +24,7 @@ type AgentHelpDefinition = z.infer<typeof AgentHelpSchemaDefinition>;
  *
  * @openapiSchema AgentHelp
  * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
  * @contractShape agent.help
  * @contractRole canonical
  */

package/dist/agent/help.js

@@ -9,14 +9,13 @@ const AgentHelpSchemaDefinition = z.object({
     citation: z.array(HelpCitationSchema),
     /** Confidence the answer is fully supported by the cited corpus. LOW signals an abstention. */
     confidence: ConfidenceSchema,
-    /** Canonical CLI/MCP/API command the asker should run, when one is supported by the cited corpus; null when no single command applies or the model abstains. */
-    recommendedCommand: z.string().nullish(),
 });
 /**
  * Grounded natural-language help answer with citations to specific operations, skills, or completion gates. Unsupported questions abstain (LOW confidence) rather than guess.
  *
  * @openapiSchema AgentHelp
  * @endpoint POST /v1/agents/help
+ * @endpoint POST /v1/help
  * @contractShape agent.help
  * @contractRole canonical
  */

package/dist/agent/instruction-detail.d.ts

@@ -18,6 +18,8 @@ type AgentInstructionDetailDefinition = z.infer<typeof AgentInstructionDetailSch
  * @openapiSchema AgentInstructionDetail
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @contractShape agent.instruction-detail
  * @contractRole canonical
  */

package/dist/agent/instruction-detail.js

@@ -13,6 +13,8 @@ const AgentInstructionDetailSchemaDefinition = z.object({
  * @openapiSchema AgentInstructionDetail
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @contractShape agent.instruction-detail
  * @contractRole canonical
  */

package/dist/agent/instruction-kind.d.ts

@@ -5,6 +5,8 @@ import { z } from "zod/v4";
  * @openapiSchema AgentInstructionKind
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @usedBySchema AgentInstructionSchema
  * @contractShape agent.instruction-kind
  * @contractRole canonical

package/dist/agent/instruction-kind.js

@@ -6,6 +6,8 @@ import { z } from "zod/v4";
  * @openapiSchema AgentInstructionKind
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @usedBySchema AgentInstructionSchema
  * @contractShape agent.instruction-kind
  * @contractRole canonical

package/dist/agent/instruction-manifest.d.ts

@@ -28,6 +28,7 @@ type AgentInstructionManifestDefinition = z.infer<typeof AgentInstructionManifes
  *
  * @openapiSchema AgentInstructionManifest
  * @endpoint GET /v1/agents/instructions/manifest
+ * @endpoint GET /v1/help/instructions/manifest
  * @contractShape agent.instruction-manifest
  * @contractRole canonical
  */

package/dist/agent/instruction-manifest.js

@@ -14,6 +14,7 @@ const AgentInstructionManifestSchemaDefinition = z.object({
  *
  * @openapiSchema AgentInstructionManifest
  * @endpoint GET /v1/agents/instructions/manifest
+ * @endpoint GET /v1/help/instructions/manifest
  * @contractShape agent.instruction-manifest
  * @contractRole canonical
  */

package/dist/agent/instruction-pointer.d.ts

@@ -9,6 +9,7 @@ type AgentInstructionPointerDefinition = z.infer<typeof AgentInstructionPointerS
  *
  * @openapiSchema AgentInstructionPointer
  * @endpoint GET /v1/agents/instructions/manifest
+ * @endpoint GET /v1/help/instructions/manifest
  * @usedBySchema AgentInstructionManifestSchema
  * @contractShape agent.instruction-pointer
  * @contractRole canonical

package/dist/agent/instruction-pointer.js

@@ -11,6 +11,7 @@ const AgentInstructionPointerSchemaDefinition = z.object({
  *
  * @openapiSchema AgentInstructionPointer
  * @endpoint GET /v1/agents/instructions/manifest
+ * @endpoint GET /v1/help/instructions/manifest
  * @usedBySchema AgentInstructionManifestSchema
  * @contractShape agent.instruction-pointer
  * @contractRole canonical

package/dist/agent/instruction.d.ts

@@ -15,6 +15,8 @@ type AgentInstructionDefinition = z.infer<typeof AgentInstructionSchemaDefinitio
  * @openapiSchema AgentInstruction
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @usedBySchema AgentInstructionDetailSchema
  * @contractShape agent.instruction
  * @contractRole canonical

package/dist/agent/instruction.js

@@ -15,6 +15,8 @@ const AgentInstructionSchemaDefinition = z.object({
  * @openapiSchema AgentInstruction
  * @endpoint GET /v1/agents/instructions/{kind}/{name}
  * @endpoint GET /v1/agents/instructions/{kind}/{name}/versions/{version}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}
+ * @endpoint GET /v1/help/instructions/{kind}/{name}/versions/{version}
  * @usedBySchema AgentInstructionDetailSchema
  * @contractShape agent.instruction
  * @contractRole canonical

package/dist/{personal/api-key.d.ts → api/key.d.ts}

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-declare const PersonalApiKeySchemaDefinition: z.ZodObject<{
+declare const ApiKeySchemaDefinition: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     expiresAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -16,17 +16,17 @@ declare const PersonalApiKeySchemaDefinition: z.ZodObject<{
     subject: z.ZodString;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strip>;
-type PersonalApiKeyDefinition = z.infer<typeof PersonalApiKeySchemaDefinition>;
+type ApiKeyDefinition = z.infer<typeof ApiKeySchemaDefinition>;
 /**
- * Personal API-key metadata sourced from Clerk; never contains the key secret
+ * Clerk API-key metadata; never contains the key secret
  *
- * @openapiSchema PersonalApiKey
- * @endpoint GET /v1/auth/personal-api-key
- * @endpoint DELETE /v1/auth/personal-api-key
- * @contractShape personal.api-key
+ * @openapiSchema ApiKey
+ * @endpoint GET /v1/auth/api-key
+ * @endpoint DELETE /v1/auth/api-key
+ * @contractShape api.key
  * @contractRole canonical
  */
-export declare const PersonalApiKeySchema: z.ZodType<PersonalApiKeyDefinition>;
-export type PersonalApiKey = z.infer<typeof PersonalApiKeySchema>;
+export declare const ApiKeySchema: z.ZodType<ApiKeyDefinition>;
+export type ApiKey = z.infer<typeof ApiKeySchema>;
 export {};
-//# sourceMappingURL=api-key.d.ts.map
+//# sourceMappingURL=key.d.ts.map

package/dist/{personal/api-key.js → api/key.js}

@@ -1,6 +1,6 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
-const PersonalApiKeySchemaDefinition = z.object({
+const ApiKeySchemaDefinition = z.object({
     /** Provider creation timestamp */
     createdAt: z.iso.datetime({ offset: true }),
     /** Optional user-visible key description */
@@ -25,13 +25,13 @@ const PersonalApiKeySchemaDefinition = z.object({
     updatedAt: z.iso.datetime({ offset: true }),
 });
 /**
- * Personal API-key metadata sourced from Clerk; never contains the key secret
+ * Clerk API-key metadata; never contains the key secret
  *
- * @openapiSchema PersonalApiKey
- * @endpoint GET /v1/auth/personal-api-key
- * @endpoint DELETE /v1/auth/personal-api-key
- * @contractShape personal.api-key
+ * @openapiSchema ApiKey
+ * @endpoint GET /v1/auth/api-key
+ * @endpoint DELETE /v1/auth/api-key
+ * @contractShape api.key
  * @contractRole canonical
  */
-export const PersonalApiKeySchema = PersonalApiKeySchemaDefinition;
-//# sourceMappingURL=api-key.js.map
+export const ApiKeySchema = ApiKeySchemaDefinition;
+//# sourceMappingURL=key.js.map

package/dist/auth/client.d.ts

@@ -9,6 +9,7 @@ import { z } from "zod/v4";
 export declare const AuthClientSchema: z.ZodObject<{
     authorizationServer: z.ZodString;
     clientId: z.ZodString;
+    mcpResource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     redirectUri: z.ZodString;
     resource: z.ZodString;
     scope: z.ZodArray<z.ZodString>;

package/dist/auth/client.js

@@ -12,6 +12,8 @@ export const AuthClientSchema = z.object({
     authorizationServer: z.string(),
     /** Public OAuth client identifier */
     clientId: z.string(),
+    /** OAuth resource indicator accepted for this environment's MCP server */
+    mcpResource: z.string().nullish(),
     /** Registered loopback callback URI template */
     redirectUri: z.string(),
     /** OAuth resource indicator accepted by the API */

package/dist/auth/provider-catalog.d.ts

@@ -4,6 +4,7 @@ declare const AuthProviderCatalogSchemaDefinition: z.ZodObject<{
     oauthClient: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         authorizationServer: z.ZodString;
         clientId: z.ZodString;
+        mcpResource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         redirectUri: z.ZodString;
         resource: z.ZodString;
         scope: z.ZodArray<z.ZodString>;