@aventurevc/aventure-cli 0.7.301 → 0.7.328

package/dist/chunks/text-field-_7ZvrzAF.js

@@ -0,0 +1 @@
+import{stripVTControlCharacters as e}from"node:util";var t=[{operationId:`answerAgentHelpQuestion`,method:`POST`,path:`/v1/agents/help`,resource:`agents`,intent:`search`,summary:`Deprecated: answer a natural-language platform help question`,description:`Deprecated: use help ask (POST /v1/help) with the same body.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,inputName:`model`,in:`body`,required:!1,description:`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.`,schemaType:`string`},{name:`question`,inputName:`question`,in:`body`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`},{name:`scope`,inputName:`scope`,in:`body`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all.`,schemaRef:`HelpScope`,schemaType:`string`,schemaEnum:[`READ`,`WRITE`,`ALL`]}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/help`,schemaName:`AgentHelpSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`agents`,intent:`search`,cliPath:[`agents`,`help`,`answer`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`getAgentInstructionManifestAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/manifest`,resource:`agents`,intent:`read`,summary:`Deprecated: get the agent instruction manifest`,description:`Deprecated: use help instructions manifest get (GET /v1/help/instructions/manifest).`,security:[{requirement:{bearerAuth:[]}}],parameter:[],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-manifest`,schemaName:`AgentInstructionManifestSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`manifest`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getAgentInstructionAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}`,resource:`agents`,intent:`read`,summary:`Deprecated: get one agent instruction document`,description:`Deprecated: use help instructions get (GET /v1/help/instructions/{kind}/{name}).`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`kind`,inputName:`kind`,in:`path`,required:!0,description:`Document kind: prompt, skill, or agent`,schemaRef:`AgentInstructionKind`,schemaType:`string`,schemaEnum:[`PROMPT`,`SKILL`,`AGENT`]},{name:`name`,inputName:`name`,in:`path`,required:!0,description:`Manifest name of the document`,schemaType:`string`}],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-detail`,schemaName:`AgentInstructionDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getAgentInstructionVersionAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}/versions/{version}`,resource:`agents`,intent:`read`,summary:`Deprecated: get one agent instruction document version`,description:`Deprecated: use help instructions versions get (GET /v1/help/instructions/{kind}/{name}/versions/{version}).`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`kind`,inputName:`kind`,in:`path`,required:!0,description:`Document kind: prompt, skill, or agent`,schemaRef:`AgentInstructionKind`,schemaType:`string`,schemaEnum:[`PROMPT`,`SKILL`,`AGENT`]},{name:`name`,inputName:`name`,in:`path`,required:!0,description:`Manifest name of the document`,schemaType:`string`},{name:`version`,inputName:`version`,in:`path`,required:!0,description:`Immutable content version`,schemaType:`string`}],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-detail`,schemaName:`AgentInstructionDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`versions`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getCurrentApiKey`,method:`GET`,path:`/v1/auth/api-key`,resource:`auth`,intent:`read`,summary:`Get current API key`,description:`Returns provider metadata for the API key authenticating this request.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/api/key`,schemaName:`ApiKeySchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`auth`,intent:`read`,cliPath:[`auth`,`api-key`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`revokeCurrentApiKey`,method:`DELETE`,path:`/v1/auth/api-key`,resource:`auth`,intent:`delete`,summary:`Revoke current API key`,description:`Revokes the stored API key and returns provider metadata so the CLI can confirm remote revocation before removing local bytes.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/api/key`,schemaName:`ApiKeySchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`auth`,intent:`delete`,cliPath:[`auth`,`api-key`,`revoke`],scope:`write`,auth:`bearer`,stdinBody:!1,destructive:!0}},{operationId:`getCurrentAuthPermissions`,method:`GET`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`read`,summary:`Current user permissions`,description:`Returns the current caller's resolved roles and permissions.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/auth/permission-grant`,schemaName:`AuthPermissionGrantSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`auth`,intent:`read`,cliPath:[`auth`,`me`,`permissions`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`authorizeOperations`,method:`POST`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`write`,summary:`Authorize API operations`,description:`Returns the supplied generated API operations that the current caller may call, alongside its existing permission grant and access class. Candidate operations are checked without being executed.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/auth/operation-filter`,schemaName:`AuthOperationFilterSchema`,kind:`json`,contentType:`application/json`,description:`Bounded generated API operations to authorize for the current session.`,required:!0,requiredPath:[`operation`,`operation[].authorizationPath`,`operation[].method`,`operation[].operationId`,`operation[].path`],parameter:[{name:`operation[].authorizationPath`,inputName:`operationAuthorizationPath`,in:`body`,required:!1,description:`Concrete path for authorization. Preserve the path template's literal segments and substitute its parameters with values matching their generated schema. No request is executed against this path.`,schemaType:`string`},{name:`operation[].method`,inputName:`operationMethod`,in:`body`,required:!1,description:`HTTP method of the operation.`,schemaRef:`AuthOperationMethod`,schemaType:`string`,schemaEnum:[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`]},{name:`operation[].operationId`,inputName:`operationOperationId`,in:`body`,required:!1,description:`Generated OpenAPI operation id.`,schemaType:`string`},{name:`operation[].path`,inputName:`operationPath`,in:`body`,required:!1,description:`Absolute API path. A whole path segment may be an OpenAPI placeholder such as {entityId}.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/auth/operation-authorization`,schemaName:`AuthOperationAuthorizationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`auth`,intent:`write`,cliPath:[`auth`,`me`,`permissions`,`authorize`],scope:`write`,auth:`bearer`,stdinBody:!0,destructive:!1}},{operationId:`getAuthProviderCatalog`,method:`GET`,path:`/v1/auth/providers`,resource:`auth`,intent:`read`,summary:`Get the public authentication provider catalog`,description:`Sign-in provider availability and CLI OAuth configuration. Public — callers read it before any session exists. A non-null Clerk publishable key offers browser sign-in; a non-null OAuth client offers the PKCE CLI sign-in lane.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/auth/provider-catalog`,schemaName:`AuthProviderCatalogSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`auth`,intent:`read`,cliPath:[`auth`,`providers`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getAiCredits`,method:`GET`,path:`/v1/billing/ai-credits`,resource:`billing`,intent:`read`,summary:`Read the current AI credit allowance`,description:`AI credits are Researchly messages sent in Researchly's current billing period; the cap comes from the caller's tier and resetAt is Researchly's period end.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/research/allowance`,schemaName:`ResearchAllowanceSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`billing`,intent:`read`,cliPath:[`billing`,`ai-credits`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`createBillingCheckoutSession`,method:`POST`,path:`/v1/billing/checkout-sessions`,resource:`billing`,intent:`write`,summary:`Create or recover a hosted Checkout Session`,description:`Start the selected AI Plus or AI Pro plan through hosted Checkout. A caller with a continuing subscription manages it through a Billing Portal Session instead.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/checkout-mutation`,schemaName:`BillingCheckoutMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan for server-owned hosted Checkout creation.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,inputName:`plan`,in:`body`,required:!0,description:`AI Plus or AI Pro plan to start through hosted Checkout`,schemaRef:`BillingPlanType`,schemaType:`string`,schemaEnum:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`]}]}],response:[{status:`201`,description:`Created`,schemaImport:`@aventurevc/api-schemas/billing/checkout`,schemaName:`BillingCheckoutSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`billing`,intent:`write`,cliPath:[`billing`,`checkout-sessions`,`create`],scope:`write`,auth:`bearer`,stdinBody:!0,destructive:!1}},{operationId:`listPlans`,method:`GET`,path:`/v1/billing/plans`,resource:`billing`,intent:`read`,summary:`List subscription tiers and plans`,description:`Return every self-serve tier with its monthly allowance caps and every Checkout plan with its recurring price. Public; needs no credentials.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/billing/catalog`,schemaName:`BillingCatalogSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`billing`,intent:`read`,cliPath:[`billing`,`plans`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`createBillingPortalSession`,method:`POST`,path:`/v1/billing/portal-sessions`,resource:`billing`,intent:`write`,summary:`Create a hosted Billing Portal Session`,description:`Open the authenticated user's Stripe Billing Portal to manage the continuing subscription.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`201`,description:`Created`,schemaImport:`@aventurevc/api-schemas/billing/portal`,schemaName:`BillingPortalSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`billing`,intent:`write`,cliPath:[`billing`,`portal-sessions`,`create`],scope:`write`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getBillingSubscription`,method:`GET`,path:`/v1/billing/subscription`,resource:`billing`,intent:`read`,summary:`Read the current billing subscription`,description:`Return sanitized Essential, AI Plus, AI Pro, or Unlimited subscription, entitlement, monthly allowance usage, and additional usage spent and available.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/billing/subscription`,schemaName:`BillingSubscriptionSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`billing`,intent:`read`,cliPath:[`billing`,`subscription`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listClassifications`,method:`GET`,path:`/v1/classifications`,resource:`classifications`,intent:`read`,summary:`List classifications`,description:`Returns a paginated list of editorial tags and standardized classifications. Filter by category using any bucket or standardized category spelling listed by the catalog. Results expose writable/creatable policy so callers know whether to join by id or create by type plus name. Sorting is not supported — sort returns 422.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`category`,inputName:`category`,in:`query`,required:!1,description:`Classification bucket or standardized category. Case- and punctuation-insensitive.`,schemaType:`string`},{name:`q`,inputName:`q`,in:`query`,required:!1,description:`Case-insensitive name substring filter (e.g. 'enterprise').`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`classifications`,intent:`read`,cliPath:[`classifications`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getClassificationCatalog`,method:`GET`,path:`/v1/classifications/catalog`,resource:`classifications`,intent:`read`,summary:`Get the company classification taxonomy`,description:"Returns active classification buckets with optional tag lists. Each bucket carries its canonical `type`, accepted `alias[]` spellings, `tagCount`, and (when includeTags=true) the active `tag[]`. Use bucketType to scope to one bucket and includeTags=false to fetch metadata only. For tag ids, prefer `classifications list --category <bucket> --q <name>` over broad catalog JSON; use returned tag.id as EntityClassificationMutation.tagId when writing classifications. Dormant registry tags are intentionally omitted; type + name writes that find one return 409 with inactiveTagOverride recovery choices.",security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`bucketType`,inputName:`bucketType`,in:`query`,required:!1,description:`Optional classification bucket. Accepts the same values as the tags endpoint type parameter.`,schemaType:`string`},{name:`includeTags`,inputName:`includeTags`,in:`query`,required:!1,description:"When false, returns bucket metadata without tag arrays. For tag ids, prefer `classifications list` with category and q filters instead of broad catalog JSON.",schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/classification/catalog`,schemaName:`ClassificationCatalogSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`classifications`,intent:`read`,cliPath:[`classifications`,`catalog`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listContent`,method:`GET`,path:`/v1/content`,resource:`content`,intent:`read`,summary:`List content`,description:`Returns a paged public content index across supported source owners. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`topic`,inputName:`topic`,in:`query`,required:!1,description:`Topic key or source category.`,schemaType:`string`},{name:`contentType`,inputName:`contentType`,in:`query`,required:!1,description:`Public content type filter.`,schemaRef:`PublicationType`,schemaType:`string`,schemaEnum:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`]},{name:`relation`,inputName:`relation`,in:`query`,required:!1,description:`Owner relation filter.`,schemaRef:`PublicationRelation`,schemaType:`string`,schemaEnum:[`by`,`about`]},{name:`year`,inputName:`year`,in:`query`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`},{name:`existenceProbe`,inputName:`existenceProbe`,in:`query`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`content`,intent:`read`,cliPath:[`content`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`searchContent`,method:`POST`,path:`/v1/content/search`,resource:`content`,intent:`search`,summary:`Search content`,description:`Searches news, posts, repositories, sites, and papers published by or about companies and people from a plain-English query. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,inputName:`mode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`model`,inputName:`model`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`query`,inputName:`query`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`content`,intent:`search`,cliPath:[`content`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`listEntityTypeCounts`,method:`GET`,path:`/v1/entities/counts`,resource:`entities`,intent:`read`,summary:`Count records by type`,description:`Return total visible entity count for each entity type`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/type-count`,schemaName:`EntityTypeCountSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`counts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityFilters`,method:`GET`,path:`/v1/entities/filters`,resource:`entities`,intent:`read`,summary:`List the company filter options`,description:`Get available filter options`,security:[],parameter:[{name:`typeGroup`,inputName:`typeGroup`,in:`query`,required:!1,description:`Type group for default filter scope. Ignored when typeRecord is provided.`,schemaRef:`EntityTypeGroup`,schemaType:`string`,schemaEnum:[`Organization`,`Investor`]},{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Filter by entity type (Company, Investor, etc.)`,schemaType:`string`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Include governed expanded values available to authorized callers`,schemaType:`boolean`,schemaDefault:!1},{name:`includeDistribution`,inputName:`includeDistribution`,in:`query`,required:!1,description:`Include range distribution charts`,schemaType:`boolean`,schemaDefault:!1},{name:`distributionKey`,inputName:`distributionKey`,in:`query`,required:!1,description:`Comma-separated or repeated filter keys for chart distribution (for example amountRaised,totalRaised)`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-option-set`,schemaName:`EntityFilterOptionSetSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityFilterCounts`,method:`GET`,path:`/v1/entities/filters/counts`,resource:`entities`,intent:`read`,summary:`List the company filter tag counts`,description:`Return tag counts for entities by repeated name query parameters`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Entity type (Company, Investment Firm, etc.)`,schemaType:`string`},{name:`name`,inputName:`name`,in:`query`,required:!1,description:`Tag name values to filter counts`,schemaType:`array`,itemSchemaType:`string`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`Maximum number of results`,schemaType:`integer`,schemaFormat:`int32`},{name:`minCount`,inputName:`minCount`,in:`query`,required:!1,description:`Minimum count threshold`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-count-result`,schemaName:`EntityFilterCountResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`counts`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`refineEntityFilters`,method:`POST`,path:`/v1/entities/filters/refine`,resource:`entities`,intent:`lookup`,summary:`Refine the company filter options`,description:`Return filter metadata scoped by current filters. Each filter entry reports choiceOptionTotal and choiceOptionTruncated so CLI and MCP callers can tell when the displayed choiceOption list is only the top scoped subset. Use the filter search endpoint with the same scopeFilter to look up values not shown in the refine response.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter`,schemaName:`EntityFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list and search filters. GET flattens these fields as query parameters; POST accepts the same shape as JSON.`,required:!0,requiredPath:[],parameter:[{name:`acceleratorBrand`,inputName:`acceleratorBrand`,in:`body`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorCohort`,inputName:`acceleratorCohort`,in:`body`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorName`,inputName:`acceleratorName`,in:`body`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorStatus`,inputName:`acceleratorStatus`,in:`body`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`affinity`,inputName:`affinity`,in:`body`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`employeeCountRange[].max`,inputName:`employeeCountRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`employeeCountRange[].min`,inputName:`employeeCountRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`entityId`,inputName:`entityId`,in:`body`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`entityName`,inputName:`entityName`,in:`body`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`featured`,inputName:`featured`,in:`body`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`fundraiseActivity.amountInvestedRange[].max`,inputName:`fundraiseActivityAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountInvestedRange[].min`,inputName:`fundraiseActivityAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountRaisedRange[].max`,inputName:`fundraiseActivityAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountRaisedRange[].min`,inputName:`fundraiseActivityAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investedCompanyName`,inputName:`fundraiseActivityInvestedCompanyName`,in:`body`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.lastRoundYearRange[].max`,inputName:`fundraiseActivityLastRoundYearRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.lastRoundYearRange[].min`,inputName:`fundraiseActivityLastRoundYearRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.round`,inputName:`fundraiseActivityRound`,in:`body`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.totalRaisedRange[].max`,inputName:`fundraiseActivityTotalRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.totalRaisedRange[].min`,inputName:`fundraiseActivityTotalRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.valuationRange[].max`,inputName:`fundraiseActivityValuationRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.valuationRange[].min`,inputName:`fundraiseActivityValuationRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`hasFundraising`,inputName:`hasFundraising`,in:`body`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`headquartersCity`,inputName:`headquartersCity`,in:`body`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersCountry`,inputName:`headquartersCountry`,in:`body`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersState`,inputName:`headquartersState`,in:`body`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`industry`,inputName:`industry`,in:`body`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`letter`,inputName:`letter`,in:`body`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`body`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`logoOption.sortPriority`,inputName:`logoOptionSortPriority`,in:`body`,required:!1,description:`Logo sort priority.`,schemaType:`string`,schemaEnum:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`]},{name:`mainProduct`,inputName:`mainProduct`,in:`body`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`operatingStatus`,inputName:`operatingStatus`,in:`body`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`person`,inputName:`person`,in:`body`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersCity`,inputName:`portfolioHeadquartersCity`,in:`body`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersCountry`,inputName:`portfolioHeadquartersCountry`,in:`body`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersState`,inputName:`portfolioHeadquartersState`,in:`body`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`qualityGate`,inputName:`qualityGate`,in:`body`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`stage`,inputName:`stage`,in:`body`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`suppressNonOperating`,inputName:`suppressNonOperating`,in:`body`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`suppressZeroTotalRaised`,inputName:`suppressZeroTotalRaised`,in:`body`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`tag`,inputName:`tag`,in:`body`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`textSearch`,inputName:`textSearch`,in:`body`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`typeCustomer`,inputName:`typeCustomer`,in:`body`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeModel`,inputName:`typeModel`,in:`body`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeOwnership`,inputName:`typeOwnership`,in:`body`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeRecord`,inputName:`typeRecord`,in:`body`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`typeRevenue`,inputName:`typeRevenue`,in:`body`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeTechnologyUsed`,inputName:`typeTechnologyUsed`,in:`body`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`body`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`body`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`urlType`,inputName:`urlType`,in:`body`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`yearFoundedRange[].max`,inputName:`yearFoundedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`yearFoundedRange[].min`,inputName:`yearFoundedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-refined-filters`,schemaName:`EntityFilterRefinedFiltersSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`refine`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchEntityFilters`,method:`POST`,path:`/v1/entities/filters/search`,resource:`entities`,intent:`search`,summary:`Look up filter values inside the current search`,description:`Live search within the full eligible filter universe using current entity filters. Pass the same scopeFilter used for list/refine work; the searched filter excludes its own current values so callers can expand a facet without clearing the rest of the query.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter-search`,schemaName:`EntityFilterSearchSchema`,kind:`json`,contentType:`application/json`,description:`Record representing a filter search request`,required:!0,requiredPath:[`filterKey`,`limit`,`query`,`scopeFilter`],parameter:[{name:`filterKey`,inputName:`filterKey`,in:`body`,required:!0,description:`Filter key`,schemaType:`string`},{name:`limit`,inputName:`limit`,in:`body`,required:!0,description:`Maximum number of search results`,schemaType:`integer`,schemaFormat:`int32`},{name:`query`,inputName:`query`,in:`body`,required:!0,description:`Query`,schemaType:`string`},{name:`scopeFilter.acceleratorBrand`,inputName:`scopeFilterAcceleratorBrand`,in:`body`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.acceleratorCohort`,inputName:`scopeFilterAcceleratorCohort`,in:`body`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.acceleratorName`,inputName:`scopeFilterAcceleratorName`,in:`body`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.acceleratorStatus`,inputName:`scopeFilterAcceleratorStatus`,in:`body`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.affinity`,inputName:`scopeFilterAffinity`,in:`body`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.employeeCountRange[].max`,inputName:`scopeFilterEmployeeCountRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.employeeCountRange[].min`,inputName:`scopeFilterEmployeeCountRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.entityId`,inputName:`scopeFilterEntityId`,in:`body`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`scopeFilter.entityName`,inputName:`scopeFilterEntityName`,in:`body`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.featured`,inputName:`scopeFilterFeatured`,in:`body`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].max`,inputName:`scopeFilterFundraiseActivityAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].min`,inputName:`scopeFilterFundraiseActivityAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].max`,inputName:`scopeFilterFundraiseActivityAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].min`,inputName:`scopeFilterFundraiseActivityAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investedCompanyName`,inputName:`scopeFilterFundraiseActivityInvestedCompanyName`,in:`body`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`scopeFilterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`scopeFilterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`scopeFilterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`scopeFilterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`scopeFilterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`scopeFilterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`scopeFilterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`scopeFilterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,inputName:`scopeFilterFundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,inputName:`scopeFilterFundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].max`,inputName:`scopeFilterFundraiseActivityLastRoundYearRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].min`,inputName:`scopeFilterFundraiseActivityLastRoundYearRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.fundraiseActivity.round`,inputName:`scopeFilterFundraiseActivityRound`,in:`body`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].max`,inputName:`scopeFilterFundraiseActivityTotalRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].min`,inputName:`scopeFilterFundraiseActivityTotalRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.valuationRange[].max`,inputName:`scopeFilterFundraiseActivityValuationRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.fundraiseActivity.valuationRange[].min`,inputName:`scopeFilterFundraiseActivityValuationRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`scopeFilter.hasFundraising`,inputName:`scopeFilterHasFundraising`,in:`body`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`scopeFilter.headquartersCity`,inputName:`scopeFilterHeadquartersCity`,in:`body`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.headquartersCountry`,inputName:`scopeFilterHeadquartersCountry`,in:`body`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.headquartersState`,inputName:`scopeFilterHeadquartersState`,in:`body`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.industry`,inputName:`scopeFilterIndustry`,in:`body`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.letter`,inputName:`scopeFilterLetter`,in:`body`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`scopeFilter.location`,inputName:`scopeFilterLocation`,in:`body`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.logoOption.sortPriority`,inputName:`scopeFilterLogoOptionSortPriority`,in:`body`,required:!1,description:`Logo sort priority.`,schemaType:`string`,schemaEnum:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`]},{name:`scopeFilter.mainProduct`,inputName:`scopeFilterMainProduct`,in:`body`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.operatingStatus`,inputName:`scopeFilterOperatingStatus`,in:`body`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`scopeFilter.person`,inputName:`scopeFilterPerson`,in:`body`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.portfolioHeadquartersCity`,inputName:`scopeFilterPortfolioHeadquartersCity`,in:`body`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.portfolioHeadquartersCountry`,inputName:`scopeFilterPortfolioHeadquartersCountry`,in:`body`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.portfolioHeadquartersState`,inputName:`scopeFilterPortfolioHeadquartersState`,in:`body`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.qualityGate`,inputName:`scopeFilterQualityGate`,in:`body`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`scopeFilter.slug`,inputName:`scopeFilterSlug`,in:`body`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.stage`,inputName:`scopeFilterStage`,in:`body`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.suppressNonOperating`,inputName:`scopeFilterSuppressNonOperating`,in:`body`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`scopeFilter.suppressZeroTotalRaised`,inputName:`scopeFilterSuppressZeroTotalRaised`,in:`body`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`scopeFilter.tag`,inputName:`scopeFilterTag`,in:`body`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.textSearch`,inputName:`scopeFilterTextSearch`,in:`body`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`scopeFilter.typeCustomer`,inputName:`scopeFilterTypeCustomer`,in:`body`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.typeModel`,inputName:`scopeFilterTypeModel`,in:`body`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.typeOwnership`,inputName:`scopeFilterTypeOwnership`,in:`body`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.typeRecord`,inputName:`scopeFilterTypeRecord`,in:`body`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`scopeFilter.typeRevenue`,inputName:`scopeFilterTypeRevenue`,in:`body`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.typeTechnologyUsed`,inputName:`scopeFilterTypeTechnologyUsed`,in:`body`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`scopeFilter.url`,inputName:`scopeFilterUrl`,in:`body`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`scopeFilter.urlDomain`,inputName:`scopeFilterUrlDomain`,in:`body`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`scopeFilter.urlMatchMode`,inputName:`scopeFilterUrlMatchMode`,in:`body`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`scopeFilter.urlType`,inputName:`scopeFilterUrlType`,in:`body`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`scopeFilter.yearFoundedRange[].max`,inputName:`scopeFilterYearFoundedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`scopeFilter.yearFoundedRange[].min`,inputName:`scopeFilterYearFoundedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-search-result`,schemaName:`EntityFilterSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`search`,cliPath:[`entities`,`filters`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`getEntityLookup`,method:`GET`,path:`/v1/entities/lookup`,resource:`entities`,intent:`read`,summary:`Read full entity detail by exact slug, URL, or domain`,description:`Exact read: returns the full detail of the one entity a slug, URL, or domain proves, and 404 or 409 instead of guessing. To identify a company by name and clues, use the POST lookup on this path (CLI entities lookup). Detail qualifiers and visibility rules apply. UUIDs use the item route; id query parameters are rejected. Changed slugs redirect canonically. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[],parameter:[{name:`slug`,inputName:`slug`,in:`query`,required:!1,description:`Exact entity slug.`,schemaType:`string`},{name:`companySlug`,inputName:`companySlug`,in:`query`,required:!1,description:`Provider slug for Product/Service slug lookup. Historically named companySlug; providerTypeRecord can narrow this to Company, Nonprofit, or Government routes.`,schemaType:`string`},{name:`providerTypeRecord`,inputName:`providerTypeRecord`,in:`query`,required:!1,description:"Concrete provider type qualifier for a Product/Service provider route; group-only Organization is invalid. Use with companySlug when resolving `/companies/{slug}/products-services/{product}`, `/non-profits/{slug}/products-services/{product}`, or `/government/{slug}/products-services/{product}`.",schemaType:`string`},{name:`url`,inputName:`url`,in:`query`,required:!1,description:`Entity URL matched by host and path unless urlMatchMode=domain.`,schemaType:`string`},{name:`urlType`,inputName:`urlType`,in:`query`,required:!1,description:`URL type qualifier. List the accepted tokens with GET /v1/lookup/url-types (CLI: lookup url-types list).`,schemaType:`string`},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`query`,required:!1,description:`URL matching mode: hostPath (default for url) or domain. Omit when urlDomain is supplied; urlDomain selects domain mode automatically.`,schemaType:`string`},{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities types list).`,schemaType:`string`},{name:`name`,inputName:`name`,in:`query`,required:!1,description:`Primary entity name candidate.`,schemaType:`string`},{name:`nameBrand`,inputName:`nameBrand`,in:`query`,required:!1,description:`Brand name candidate.`,schemaType:`string`},{name:`nameLegal`,inputName:`nameLegal`,in:`query`,required:!1,description:`Legal name candidate.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`query`,required:!1,description:`Location candidate: city, state, or country.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`query`,required:!1,description:`Website domain candidate without protocol or path.`,schemaType:`string`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`Entity detail as canonical JSON or the same data rendered as compact text/plain.`,schemaImport:`@aventurevc/api-schemas/entity/detail`,schemaName:`EntityDetailSchema`},{status:`301`,description:`Redirect to new slug location`},{status:`400`,description:`Conflicting or unusable identity input: name, nameBrand, and nameLegal must identify the same entity, and exactly one identifier form may be supplied.`},{status:`404`,description:"No entity resolved: fuzzy candidate signals below the review threshold without identity proof are exhausted, which does not prove the record is absent or safe to create — search POST /v1/entities/search with textSearch first (searchEntities). An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (retry with includePrivate=true; CLI: `--include-private` true), Product Not Public: Missing Provider Relationship, or Fund Not Public: No Public Manager Firm."},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Ambiguous identity: review-level candidates, unresolved identity proof, multiple exact normalized-name matches, or a Product/Service slug shared across provider pairs. ProblemDetail carries candidates; read each returned id with GET /v1/entities/{entityId}. Resolve the Product/Service ambiguity with companySlug plus slug or a provider's productService relationship.`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`400`,description:`Conflicting or unusable identity input: name, nameBrand, and nameLegal must identify the same entity, and exactly one identifier form may be supplied.`},{status:`404`,description:"No entity resolved: fuzzy candidate signals below the review threshold without identity proof are exhausted, which does not prove the record is absent or safe to create — search POST /v1/entities/search with textSearch first (searchEntities). An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (retry with includePrivate=true; CLI: `--include-private` true), Product Not Public: Missing Provider Relationship, or Fund Not Public: No Public Manager Firm."},{status:`409`,description:`Ambiguous identity: review-level candidates, unresolved identity proof, multiple exact normalized-name matches, or a Product/Service slug shared across provider pairs. ProblemDetail carries candidates; read each returned id with GET /v1/entities/{entityId}. Resolve the Product/Service ambiguity with companySlug plus slug or a provider's productService relationship.`}],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`lookup`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`lookupEntity`,method:`POST`,path:`/v1/entities/lookup`,resource:`entities`,intent:`lookup`,summary:`Find which company a name refers to, or confirm it is new`,description:`Returns status MATCHED, NO_MATCH, or NEEDS_REVIEW. MATCHED: match.record.id is the company; read its detail with entities get --entity-id. NO_MATCH: no record you can see is this company; create it, using officialUrl as its website when present. NEEDS_REVIEW: show candidate (most probable first) to the user and ask which one it is or whether it is new; never create on NEEDS_REVIEW. stage names the step that settled it: DETERMINISTIC (URL or registry-id proof, no model call), JUDGMENT (decision model), or WEB_EVIDENCE (added a web search). Send the website and LinkedIn company URL whenever you have them, location and context to tell namesakes apart, and the article as sourceUrl or sourceNewsId. A parent, subsidiary, or namesake is a different company. For the full detail of an exact slug, URL, or domain use entities lookup get. Example: entities lookup --name "Acme AI" --url https://acme.ai --location "Austin, TX". Output: --text (default) is compact text, --json the full envelope, --data the Identification object for scripts.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[`name`],parameter:[{name:`context`,inputName:`context`,in:`body`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`body`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`},{name:`name`,inputName:`name`,in:`body`,required:!0,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe.`,schemaType:`string`},{name:`sourceNewsId`,inputName:`sourceNewsId`,in:`body`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`},{name:`sourceUrl`,inputName:`sourceUrl`,in:`body`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`}]}],response:[{status:`200`,description:`The identification as canonical JSON or compact text/plain.`,schemaImport:`@aventurevc/api-schemas/identification/identification`,schemaName:`IdentificationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`lookupEntityBatch`,method:`POST`,path:`/v1/entities/lookup/batch`,resource:`entities`,intent:`lookup`,summary:`Look up companies in bulk by id, slug, or URL`,description:`Returns a page envelope of entity detail records by id, slug, and/or current joined URL. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. For public reads totalElements counts the entities visible to the caller, so requested identifiers that do not resolve or fail the public visibility filter are excluded. For privileged reads totalElements counts the requested identifiers that resolved to an entity id, which can exceed the number of records returned when an id no longer exists. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden, unverified, and not-yet-published entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL`,required:!1,requiredPath:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`body`,required:!1,description:`Entity UUID values`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`body`,required:!1,description:`Permit monogram fallbacks`,schemaType:`boolean`,schemaDefault:!0},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`Entity slug values`,schemaType:`array`,itemSchemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`Current joined entity URL values`,schemaType:`array`,itemSchemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/detail`,schemaName:`EntityDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`,`batch`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`lookupEntityMatches`,method:`POST`,path:`/v1/entities/lookup/matches`,resource:`entities`,intent:`lookup`,summary:`Look up which company each identifier matches`,description:`Resolves each queried id, slug, and current joined URL to exactly one outcome row that echoes the raw input: MATCHED with full detail, AMBIGUOUS with candidate ids when a URL is currently owned by more than one entity, or MISSING. Unlike the batch detail read, no input is silently dropped and every row maps back to its source identifier. URL matching is host+path exact: scheme and a leading www are ignored, but distinct paths stay distinct (stripe.com does not match stripe.com/payments). A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Returns hidden, unverified, and not-yet-published entities instead of resolving them as MISSING when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL`,required:!1,requiredPath:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`body`,required:!1,description:`Entity UUID values`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`body`,required:!1,description:`Permit monogram fallbacks`,schemaType:`boolean`,schemaDefault:!0},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`Entity slug values`,schemaType:`array`,itemSchemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`Current joined entity URL values`,schemaType:`array`,itemSchemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/resolution`,schemaName:`EntityResolutionSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`,`matches`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchEntitiesByNaturalLanguage`,method:`POST`,path:`/v1/entities/natural-search`,resource:`entities`,intent:`search`,summary:`Deprecated: find companies in natural language`,description:`Deprecated: use search natural entities (POST /v1/search/natural/entities) with the same body and parameters.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`When false, generated monogram logos are stripped from entity rows.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],explain:!0,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/natural-search`,schemaName:`EntityNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.acceleratorBrand`,inputName:`filterAcceleratorBrand`,in:`body`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorCohort`,inputName:`filterAcceleratorCohort`,in:`body`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorName`,inputName:`filterAcceleratorName`,in:`body`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorStatus`,inputName:`filterAcceleratorStatus`,in:`body`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.affinity`,inputName:`filterAffinity`,in:`body`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.employeeCountRange[].max`,inputName:`filterEmployeeCountRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.employeeCountRange[].min`,inputName:`filterEmployeeCountRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.entityId`,inputName:`filterEntityId`,in:`body`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`filter.entityName`,inputName:`filterEntityName`,in:`body`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.featured`,inputName:`filterFeatured`,in:`body`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`filter.fundraiseActivity.amountInvestedRange[].max`,inputName:`filterFundraiseActivityAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountInvestedRange[].min`,inputName:`filterFundraiseActivityAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountRaisedRange[].max`,inputName:`filterFundraiseActivityAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountRaisedRange[].min`,inputName:`filterFundraiseActivityAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investedCompanyName`,inputName:`filterFundraiseActivityInvestedCompanyName`,in:`body`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,inputName:`filterFundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,inputName:`filterFundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.lastRoundYearRange[].max`,inputName:`filterFundraiseActivityLastRoundYearRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.lastRoundYearRange[].min`,inputName:`filterFundraiseActivityLastRoundYearRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.round`,inputName:`filterFundraiseActivityRound`,in:`body`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.fundraiseActivity.totalRaisedRange[].max`,inputName:`filterFundraiseActivityTotalRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.totalRaisedRange[].min`,inputName:`filterFundraiseActivityTotalRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.valuationRange[].max`,inputName:`filterFundraiseActivityValuationRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.valuationRange[].min`,inputName:`filterFundraiseActivityValuationRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.hasFundraising`,inputName:`filterHasFundraising`,in:`body`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`filter.headquartersCity`,inputName:`filterHeadquartersCity`,in:`body`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.headquartersCountry`,inputName:`filterHeadquartersCountry`,in:`body`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.headquartersState`,inputName:`filterHeadquartersState`,in:`body`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.industry`,inputName:`filterIndustry`,in:`body`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.letter`,inputName:`filterLetter`,in:`body`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`filter.location`,inputName:`filterLocation`,in:`body`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.logoOption.sortPriority`,inputName:`filterLogoOptionSortPriority`,in:`body`,required:!1,description:`Logo sort priority.`,schemaType:`string`,schemaEnum:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`]},{name:`filter.mainProduct`,inputName:`filterMainProduct`,in:`body`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.operatingStatus`,inputName:`filterOperatingStatus`,in:`body`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`filter.person`,inputName:`filterPerson`,in:`body`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersCity`,inputName:`filterPortfolioHeadquartersCity`,in:`body`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersCountry`,inputName:`filterPortfolioHeadquartersCountry`,in:`body`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersState`,inputName:`filterPortfolioHeadquartersState`,in:`body`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.qualityGate`,inputName:`filterQualityGate`,in:`body`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`filter.slug`,inputName:`filterSlug`,in:`body`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.stage`,inputName:`filterStage`,in:`body`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.suppressNonOperating`,inputName:`filterSuppressNonOperating`,in:`body`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`filter.suppressZeroTotalRaised`,inputName:`filterSuppressZeroTotalRaised`,in:`body`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`filter.tag`,inputName:`filterTag`,in:`body`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.textSearch`,inputName:`filterTextSearch`,in:`body`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`filter.typeCustomer`,inputName:`filterTypeCustomer`,in:`body`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeModel`,inputName:`filterTypeModel`,in:`body`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeOwnership`,inputName:`filterTypeOwnership`,in:`body`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeRecord`,inputName:`filterTypeRecord`,in:`body`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`filter.typeRevenue`,inputName:`filterTypeRevenue`,in:`body`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeTechnologyUsed`,inputName:`filterTypeTechnologyUsed`,in:`body`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.url`,inputName:`filterUrl`,in:`body`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`filter.urlDomain`,inputName:`filterUrlDomain`,in:`body`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`filter.urlMatchMode`,inputName:`filterUrlMatchMode`,in:`body`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`filter.urlType`,inputName:`filterUrlType`,in:`body`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`filter.yearFoundedRange[].max`,inputName:`filterYearFoundedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.yearFoundedRange[].min`,inputName:`filterYearFoundedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`search.mode`,inputName:`searchMode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`search.model`,inputName:`searchModel`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`search.query`,inputName:`searchQuery`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/natural/search-result`,schemaName:`NaturalSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`search`,cliPath:[`entities`,`natural-search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`listEntityRelationshipTypes`,method:`GET`,path:`/v1/entities/relationships/types`,resource:`entities`,intent:`read`,summary:`List the accepted values for --type`,description:`Returns canonical EntityRelationshipType values, aliases, and policy flags. Use joinable=true values with entities relationships create; acquisitionManaged=true values route through entity acquisitions; exclusiveRelationshipType lists relationship types that cannot coexist for the same unordered entity pair; readOnly=true values are emitted by reads only.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/relationship-type-option`,schemaName:`EntityRelationshipTypeOptionSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityRelationship`,method:`GET`,path:`/v1/entities/relationships/{relationshipId}`,resource:`entities`,intent:`read`,summary:`Get one relationship by id`,description:`Returns one relationship by row id, including historic and non-primary rows. The response includes isCurrent and isPrimary so hidden-row cause is explicit.`,security:[],parameter:[{name:`relationshipId`,inputName:`relationshipId`,in:`path`,required:!0,description:`Integer entity_relationship.id row id from EntityRelationship.id, not an entity UUID.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/relationship`,schemaName:`EntityRelationshipSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityResearchDetailTypes`,method:`GET`,path:`/v1/entities/research/details/types`,resource:`entities`,intent:`read`,summary:`List the accepted research detail types`,description:`Returns research detail type tokens and their write metadata. The metadata includes valueShape, allowedToken, range, and timeSeries. When timeSeries=true, each believable dated observation is historical data: add a new current row and delete only rows believed false.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/research/detail-type`,schemaName:`ResearchDetailTypeSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`details`,`types`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityResearchSnippetTypes`,method:`GET`,path:`/v1/entities/research/snippets/types`,resource:`entities`,intent:`read`,summary:`List the accepted research snippet types`,description:`Lists the recognized research snippet types. A textType in this list is validated against its length and paragraph rules on write and defaults to visible; a textType not in this list is still saved but defaults to visible=false (hidden from default reads). The per-row visible flag overrides the default either way. The curated and analysisRenderable flags mark public Analysis-page eligibility, not snippet display.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/research/snippet-type`,schemaName:`ResearchSnippetTypeSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`snippets`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`searchEntities`,method:`POST`,path:`/v1/entities/search`,resource:`entities`,intent:`search`,summary:`Search companies, products, and services`,description:"Run keyword, semantic, or explicit structured entity filtering with an EntityListFilter JSON body; Organization expands to the canonical organization type group; semanticQuery ranks by stored content embeddings. For plain English use search natural entities `--query` (POST /v1/search/natural/entities). Semantic results can emit signed cursors; reuse the same filters, sort, size, and visibility scope. countOnly is unsupported with semanticQuery or cursor; count-only pages have no content; read totalElements.",security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`countOnly`,inputName:`countOnly`,in:`query`,required:!1,description:`Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque entity cursor; reuse filters and sort. Cursor is unsupported with countOnly; semanticQuery depends on the endpoint.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`},{name:`includeFullDetail`,inputName:`includeFullDetail`,in:`query`,required:!1,description:`Privileged read flag. Must be true to return the /v1/entities/detail payload.`,schemaType:`boolean`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/list-filter`,schemaName:`EntityListFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery.`,required:!1,requiredPath:[],parameter:[{name:`acceleratorBrand`,inputName:`acceleratorBrand`,in:`body`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorCohort`,inputName:`acceleratorCohort`,in:`body`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorName`,inputName:`acceleratorName`,in:`body`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorStatus`,inputName:`acceleratorStatus`,in:`body`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`affinity`,inputName:`affinity`,in:`body`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`employeeCountRange[].max`,inputName:`employeeCountRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`employeeCountRange[].min`,inputName:`employeeCountRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`entityId`,inputName:`entityId`,in:`body`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`entityName`,inputName:`entityName`,in:`body`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`featured`,inputName:`featured`,in:`body`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`fundraiseActivity.amountInvestedRange[].max`,inputName:`fundraiseActivityAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountInvestedRange[].min`,inputName:`fundraiseActivityAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountRaisedRange[].max`,inputName:`fundraiseActivityAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountRaisedRange[].min`,inputName:`fundraiseActivityAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investedCompanyName`,inputName:`fundraiseActivityInvestedCompanyName`,in:`body`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.lastRoundYearRange[].max`,inputName:`fundraiseActivityLastRoundYearRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.lastRoundYearRange[].min`,inputName:`fundraiseActivityLastRoundYearRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.round`,inputName:`fundraiseActivityRound`,in:`body`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.totalRaisedRange[].max`,inputName:`fundraiseActivityTotalRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.totalRaisedRange[].min`,inputName:`fundraiseActivityTotalRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.valuationRange[].max`,inputName:`fundraiseActivityValuationRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.valuationRange[].min`,inputName:`fundraiseActivityValuationRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`hasFundraising`,inputName:`hasFundraising`,in:`body`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`headquartersCity`,inputName:`headquartersCity`,in:`body`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersCountry`,inputName:`headquartersCountry`,in:`body`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersState`,inputName:`headquartersState`,in:`body`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`industry`,inputName:`industry`,in:`body`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`letter`,inputName:`letter`,in:`body`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`body`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`logoOption.sortPriority`,inputName:`logoOptionSortPriority`,in:`body`,required:!1,description:`Logo sort priority.`,schemaType:`string`,schemaEnum:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`]},{name:`mainProduct`,inputName:`mainProduct`,in:`body`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`operatingStatus`,inputName:`operatingStatus`,in:`body`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`person`,inputName:`person`,in:`body`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersCity`,inputName:`portfolioHeadquartersCity`,in:`body`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersCountry`,inputName:`portfolioHeadquartersCountry`,in:`body`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersState`,inputName:`portfolioHeadquartersState`,in:`body`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`qualityGate`,inputName:`qualityGate`,in:`body`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`semanticQuery`,inputName:`semanticQuery`,in:`body`,required:!1,description:`Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay.`,schemaType:`string`},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`stage`,inputName:`stage`,in:`body`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`suppressNonOperating`,inputName:`suppressNonOperating`,in:`body`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`suppressZeroTotalRaised`,inputName:`suppressZeroTotalRaised`,in:`body`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`tag`,inputName:`tag`,in:`body`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`textSearch`,inputName:`textSearch`,in:`body`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`typeCustomer`,inputName:`typeCustomer`,in:`body`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeModel`,inputName:`typeModel`,in:`body`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeOwnership`,inputName:`typeOwnership`,in:`body`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeRecord`,inputName:`typeRecord`,in:`body`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`typeRevenue`,inputName:`typeRevenue`,in:`body`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeTechnologyUsed`,inputName:`typeTechnologyUsed`,in:`body`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`body`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`body`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`urlType`,inputName:`urlType`,in:`body`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`yearFoundedRange[].max`,inputName:`yearFoundedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`yearFoundedRange[].min`,inputName:`yearFoundedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`}]}],response:[{status:`200`,description:`OK`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`search`,cliPath:[`entities`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`listEntitySummaries`,method:`GET`,path:`/v1/entities/summary`,resource:`entities`,intent:`read`,summary:`List compact company summaries`,description:`List lean entity rows for homepage and card surfaces: core identity, funding rollup, and fundraise rounds without the heavier list enrichment sections.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`query`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`slug`,inputName:`slug`,in:`query`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`entityName`,inputName:`entityName`,in:`query`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`person`,inputName:`person`,in:`query`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`industry`,inputName:`industry`,in:`query`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`location`,inputName:`location`,in:`query`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`tag`,inputName:`tag`,in:`query`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`mainProduct`,inputName:`mainProduct`,in:`query`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeTechnologyUsed`,inputName:`typeTechnologyUsed`,in:`query`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeModel`,inputName:`typeModel`,in:`query`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeOwnership`,inputName:`typeOwnership`,in:`query`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeCustomer`,inputName:`typeCustomer`,in:`query`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`typeRevenue`,inputName:`typeRevenue`,in:`query`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorBrand`,inputName:`acceleratorBrand`,in:`query`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorName`,inputName:`acceleratorName`,in:`query`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorCohort`,inputName:`acceleratorCohort`,in:`query`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`acceleratorStatus`,inputName:`acceleratorStatus`,in:`query`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`affinity`,inputName:`affinity`,in:`query`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersCountry`,inputName:`headquartersCountry`,in:`query`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersState`,inputName:`headquartersState`,in:`query`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`headquartersCity`,inputName:`headquartersCity`,in:`query`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`stage`,inputName:`stage`,in:`query`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`yearFoundedRange`,inputName:`yearFoundedRange`,in:`query`,required:!1,description:`Inclusive founding-year ranges, in calendar years.`,schemaType:`array`,itemSchemaRef:`IntRange`,itemSchemaType:`object`,itemProperty:[{name:`yearFoundedRange[0].min`,inputName:`yearFoundedRangeMin`,in:`query`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`yearFoundedRange[0].max`,inputName:`yearFoundedRangeMax`,in:`query`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`}]},{name:`employeeCountRange`,inputName:`employeeCountRange`,in:`query`,required:!1,description:`Inclusive reported employee-count ranges, in employees.`,schemaType:`array`,itemSchemaRef:`IntRange`,itemSchemaType:`object`,itemProperty:[{name:`employeeCountRange[0].min`,inputName:`employeeCountRangeMin`,in:`query`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`employeeCountRange[0].max`,inputName:`employeeCountRangeMax`,in:`query`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`}]},{name:`operatingStatus`,inputName:`operatingStatus`,in:`query`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`createdAtRange.min`,inputName:`createdAtRangeMin`,in:`query`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`},{name:`createdAtRange.max`,inputName:`createdAtRangeMax`,in:`query`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`},{name:`updatedAtRange.min`,inputName:`updatedAtRangeMin`,in:`query`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`},{name:`updatedAtRange.max`,inputName:`updatedAtRangeMax`,in:`query`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`},{name:`letter`,inputName:`letter`,in:`query`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`hasLogo`,inputName:`hasLogo`,in:`query`,required:!1,description:`Privileged filter to entities with any logo.`,schemaType:`boolean`},{name:`isHidden`,inputName:`isHidden`,in:`query`,required:!1,description:`Privileged filter by hidden status.`,schemaType:`boolean`},{name:`showOnSitemap`,inputName:`showOnSitemap`,in:`query`,required:!1,description:`Privileged filter by public sitemap inclusion.`,schemaType:`boolean`},{name:`hasRealLogo`,inputName:`hasRealLogo`,in:`query`,required:!1,description:`Privileged filter to entities with a real uploaded logo.`,schemaType:`boolean`},{name:`hasFundraising`,inputName:`hasFundraising`,in:`query`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`featured`,inputName:`featured`,in:`query`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`suppressZeroTotalRaised`,inputName:`suppressZeroTotalRaised`,in:`query`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`suppressNonOperating`,inputName:`suppressNonOperating`,in:`query`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`qualityGate`,inputName:`qualityGate`,in:`query`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`url`,inputName:`url`,in:`query`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`query`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`urlType`,inputName:`urlType`,in:`query`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`query`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`portfolioHeadquartersCountry`,inputName:`portfolioHeadquartersCountry`,in:`query`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersState`,inputName:`portfolioHeadquartersState`,in:`query`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`portfolioHeadquartersCity`,inputName:`portfolioHeadquartersCity`,in:`query`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.round`,inputName:`fundraiseActivityRound`,in:`query`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.amountRaisedRange`,inputName:`fundraiseActivityAmountRaisedRange`,in:`query`,required:!1,description:`Per-round amount-raised ranges in USD. Use plain JSON numbers.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.amountRaisedRange[0].min`,inputName:`fundraiseActivityAmountRaisedRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountRaisedRange[0].max`,inputName:`fundraiseActivityAmountRaisedRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.amountInvestedRange`,inputName:`fundraiseActivityAmountInvestedRange`,in:`query`,required:!1,description:`Investor-level amount-invested ranges in the transaction currency. Use plain JSON numbers.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.amountInvestedRange[0].min`,inputName:`fundraiseActivityAmountInvestedRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.amountInvestedRange[0].max`,inputName:`fundraiseActivityAmountInvestedRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.totalRaisedRange`,inputName:`fundraiseActivityTotalRaisedRange`,in:`query`,required:!1,description:`Total-raised ranges across all rounds in USD. Use plain JSON numbers.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.totalRaisedRange[0].min`,inputName:`fundraiseActivityTotalRaisedRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.totalRaisedRange[0].max`,inputName:`fundraiseActivityTotalRaisedRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.valuationRange`,inputName:`fundraiseActivityValuationRange`,in:`query`,required:!1,description:`Post-money valuation ranges in USD.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.valuationRange[0].min`,inputName:`fundraiseActivityValuationRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.valuationRange[0].max`,inputName:`fundraiseActivityValuationRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.lastRoundYearRange`,inputName:`fundraiseActivityLastRoundYearRange`,in:`query`,required:!1,description:`Last-round-year ranges for each entity's most recent fundraise round.`,schemaType:`array`,itemSchemaRef:`IntRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.lastRoundYearRange[0].min`,inputName:`fundraiseActivityLastRoundYearRangeMin`,in:`query`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.lastRoundYearRange[0].max`,inputName:`fundraiseActivityLastRoundYearRangeMax`,in:`query`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`}]},{name:`fundraiseActivity.investedCompanyName`,inputName:`fundraiseActivityInvestedCompanyName`,in:`query`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRange`,in:`query`,required:!1,description:`Distinct fundraise-deal count ranges for an investor, with inclusive integer bounds.`,schemaType:`array`,itemSchemaRef:`IntRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].min`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`query`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].max`,inputName:`fundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`query`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`}]},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRange`,in:`query`,required:!1,description:`Total USD amount-invested ranges with inclusive bounds.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].min`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].max`,inputName:`fundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRange`,in:`query`,required:!1,description:`Average USD amount-invested ranges with inclusive bounds.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].min`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].max`,inputName:`fundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRange`,in:`query`,required:!1,description:`Largest USD amount-invested ranges with inclusive bounds.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].min`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].max`,inputName:`fundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRange`,in:`query`,required:!1,description:`Smallest USD amount-invested ranges with inclusive bounds.`,schemaType:`array`,itemSchemaRef:`DecimalRange`,itemSchemaType:`object`,itemProperty:[{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].min`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`query`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].max`,inputName:`fundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`query`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`}]},{name:`textSearch`,inputName:`textSearch`,in:`query`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/list-summary`,schemaName:`EntityListSummarySchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`summary`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityTextTypes`,method:`GET`,path:`/v1/entities/texts/types`,resource:`entities`,intent:`read`,summary:`List the accepted company text types`,description:`Returns text type values accepted by entity text rows.`,security:[],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Include private text types for callers with read access`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/text/type-option`,schemaName:`TextTypeOptionSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityTypeRecords`,method:`GET`,path:`/v1/entities/types`,resource:`entities`,intent:`read`,summary:`List the accepted typeRecord values`,description:`Returns typeRecord alias guidance for API help and CLI command suggestions.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/type-alias`,schemaName:`EntityTypeAliasSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntity`,method:`GET`,path:`/v1/entities/{entityId}`,resource:`entities`,intent:`read`,summary:`Get one company, product, or service by id`,description:`Returns entity detail by exact UUID. Use lookup for a slug, URL, or candidate signals. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Exact entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities types list).`,schemaType:`string`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`Entity detail as canonical JSON or the same data rendered as compact text/plain.`,schemaImport:`@aventurevc/api-schemas/entity/detail`,schemaName:`EntityDetailSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityAcquisitions`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions`,resource:`entities`,intent:`read`,summary:`List a company's acquisitions`,description:`VISIBILITY-GATED READ: a row is returned only when BOTH the acquired and acquirer entities are publicly visible. An acquisition relationship that already exists (and is visible in the entity relationships resource) but returns 404 here means one counterpart entity is still hidden -- publish that entity (statusSitemapShow=true, statusHidePage=false) -- it is an unmet visibility prerequisite, not data-layer inconsistency or projection lag. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter only selects which side the path entity occupies in the WHERE clause: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired. List responses are ordered by most recent acquisition event first.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`},{name:`role`,inputName:`role`,in:`query`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` lists both sides.",schemaRef:`EntityAcquisitionRole`,schemaType:`string`,schemaDefault:`acquired`,schemaEnum:[`acquired`,`acquirer`,`all`]},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:20},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/acquisition`,schemaName:`EntityAcquisitionSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityAcquisition`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions/{relationshipId}`,resource:`entities`,intent:`read`,summary:`Get one company acquisition`,description:`VISIBILITY-GATED READ: a row is returned only when BOTH the acquired and acquirer entities are publicly visible. An acquisition relationship that already exists (and is visible in the entity relationships resource) but returns 404 here means one counterpart entity is still hidden -- publish that entity (statusSitemapShow=true, statusHidePage=false) -- it is an unmet visibility prerequisite, not data-layer inconsistency or projection lag. A gated miss on an existing row returns 404 with title 'Acquisition Exists but a Counterpart Entity Is Not Public'. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter only selects which side the path entity occupies in the WHERE clause: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`},{name:`relationshipId`,inputName:`relationshipId`,in:`path`,required:!0,description:`Acquisition relationship row id (entity_relationship.id).`,schemaType:`integer`,schemaFormat:`int32`},{name:`role`,inputName:`role`,in:`query`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` reads either side.",schemaRef:`EntityAcquisitionRole`,schemaType:`string`,schemaDefault:`acquired`,schemaEnum:[`acquired`,`acquirer`,`all`]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/acquisition`,schemaName:`EntityAcquisitionSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityAddresses`,method:`GET`,path:`/v1/entities/{entityId}/addresses`,resource:`entities`,intent:`read`,summary:`List a company's locations`,description:"Returns current physical addresses with their role-period associations, ordered HQ-first, primary-next, most-recent-first (`updated_at DESC`). Reads directly from the base tables so fresh writes surface immediately (bypassing the mv_entity_addresses materialized view). Set includeInactive=true as a signed-in user or with read credentials to include inactive/historical rows.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive rows`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/address/address`,schemaName:`AddressSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityAddress`,method:`GET`,path:`/v1/entities/{entityId}/addresses/{addressJoinId}`,resource:`entities`,intent:`read`,summary:`Get one company address`,description:`Returns the physical address group containing the selected entity address association. Requires read auth.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`addressJoinId`,inputName:`addressJoinId`,in:`path`,required:!0,description:`Address join id parameter`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/address/address`,schemaName:`AddressSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityBlogPosts`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts`,resource:`entities`,intent:`read`,summary:`List a company's blog posts`,description:"Returns active external blog post links stored in research.res_blog_article. NOT FOR: News/press coverage; use `news list`.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the blog post rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive research blog post rows`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:10},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,schemaDefault:[`publishedAt,desc`],itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/blog/post`,schemaName:`BlogPostSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityBlogPost`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts/{blogPostId}`,resource:`entities`,intent:`read`,summary:`Get one company blog post`,description:`Returns one entity-owned external link by id. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the blog post row`,schemaType:`string`,schemaFormat:`uuid`},{name:`blogPostId`,inputName:`blogPostId`,in:`path`,required:!0,description:`Blog post UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/blog/post`,schemaName:`BlogPostSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityClassifications`,method:`GET`,path:`/v1/entities/{entityId}/classifications`,resource:`entities`,intent:`read`,summary:`List a company's classifications`,description:`Returns joins grouped by bucket. The default view includes current rows; includeInactive=true adds historical rows and requires read auth. Callers with private-visibility authority can also resolve hidden or private entities; setting includePrivate=true requires that authority. Signed-in callers without it can access public entities, while hidden entities return 404.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive/historical entity classification join rows; default false returns only current joins.`,schemaType:`boolean`,schemaDefault:!1},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private or hidden entity classification rows when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/classification`,schemaName:`EntityClassificationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityClassificationSuggestions`,method:`GET`,path:`/v1/entities/{entityId}/classifications/suggestions`,resource:`entities`,intent:`read`,summary:`Suggest classifications for a company`,description:`Default classification discovery path for enrichment agents. Returns ranked embedding-derived tag and standardized-code suggestions; empty array means no embedding neighbors. Create joins with the entity classifications create endpoint. A signed-in user is admitted for public entities; callers with private-visibility authority can also resolve hidden or private entities; setting includePrivate=true requires that authority. Signed-in callers without it can access public entities, while hidden entities return 404.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`limit`,inputName:`limit`,in:`query`,required:!1,description:`Maximum suggestions to return; default 12, maximum 50.`,schemaType:`integer`,schemaFormat:`int32`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private or hidden entity suggestions when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/classification-suggestion`,schemaName:`EntityClassificationSuggestionSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`suggestions`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityContent`,method:`GET`,path:`/v1/entities/{entityId}/content`,resource:`entities`,intent:`read`,summary:`List a company's publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to an entity. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`},{name:`topic`,inputName:`topic`,in:`query`,required:!1,description:`Topic key or source category.`,schemaType:`string`},{name:`contentType`,inputName:`contentType`,in:`query`,required:!1,description:`Public content type filter.`,schemaRef:`PublicationType`,schemaType:`string`,schemaEnum:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`]},{name:`relation`,inputName:`relation`,in:`query`,required:!1,description:`Owner relation filter.`,schemaRef:`PublicationRelation`,schemaType:`string`,schemaEnum:[`by`,`about`]},{name:`year`,inputName:`year`,in:`query`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`},{name:`existenceProbe`,inputName:`existenceProbe`,in:`query`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityContentFacets`,method:`GET`,path:`/v1/entities/{entityId}/content/facets`,resource:`entities`,intent:`read`,summary:`Count a company's publications`,description:`Counts one entity's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/facet`,schemaName:`PublicationFacetSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`facets`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`searchEntityContent`,method:`POST`,path:`/v1/entities/{entityId}/content/search`,resource:`entities`,intent:`search`,summary:`Search a company's publications`,description:`Translates plain-English constraints for one entity's content index. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,inputName:`mode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`model`,inputName:`model`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`query`,inputName:`query`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`search`,cliPath:[`entities`,`content`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`listEntityEmployeeCounts`,method:`GET`,path:`/v1/entities/{entityId}/employee-counts`,resource:`entities`,intent:`read`,summary:`List a company's headcount over time`,description:`Returns employee-count time series for the entity at this address. Results are sorted newest first. This endpoint does not support custom sorting.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID)`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; maximum 500.`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/employee/count`,schemaName:`EmployeeCountSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`employee-counts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`enrichEntity`,method:`POST`,path:`/v1/entities/{entityId}/enrichments`,resource:`entities`,intent:`write`,summary:`Enrich one company, product, or service`,description:`Queues an enrichment run for the addressed entity, owned by the authenticated principal. The run targets that entity's canonical aVenture profile, so it is billed as an update of a known record and reuses the entity's already-active run.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`mode`,inputName:`mode`,in:`query`,required:!1,description:`Enrichment breadth; omitted requests the comprehensive default.`,schemaRef:`EnrichmentMode`,schemaType:`string`,schemaEnum:[`COMPREHENSIVE`,`INDIVIDUAL`]},{name:`model`,inputName:`model`,in:`query`,required:!1,description:`Orchestrator model override; omitted uses the configured role default.`,schemaType:`string`},{name:`userPrompt`,inputName:`userPrompt`,in:`query`,required:!1,description:`Optional steering prompt.`,schemaType:`string`},{name:`taskPresetKey`,inputName:`taskPresetKey`,in:`query`,required:!1,description:`Task preset keys that scope or emphasize this run.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`The queued enrichment run for the addressed entity.`,schemaImport:`@aventurevc/api-schemas/harness/run`,schemaName:`HarnessRunSchema`,detailField:[`hasSourceDocument`,`lane`,`latestStatus`,`maxScoutConcurrent`,`nextAttemptAt`,`subagentModel`,`taskPresetKey`,`updatedAt`]},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`}],projection:{resource:`entities`,intent:`write`,cliPath:[`entities`,`enrichments`,`enrich`],scope:`write`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityFundraiseInvestorJoins`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins`,resource:`entities`,intent:`read`,summary:`List the investors in a funding round`,description:"Lists entity or person investors joined to a fundraise round, including join-level amountInvested attribution. amountInvested is a plain decimal number in the fundraise transaction currency. API and MCP request bodies use JSON numbers such as 220000 or 123456.78; CLI callers use `--amount-invested` 220000 or `--amount-invested` 123456.78. Do not send currency signs, currency codes, comma grouping, quoted numeric strings, or abbreviations such as 220k or 0.22M. PATCH with amountInvested:null clears the value. Use entityId for the fundraising/portfolio company that raised the round — always a company, never the fund or investment firm that supplied the capital. For an Investment Firm's outgoing investment, pass the portfolio company that received the money here and identify the firm with `--investor-entity-id` or `--investor-entity-slug`. Use transactionId for the round id, or round plus dateAnnounced when transactionId is unknown. Investor entity/person selectors reference existing records only. Create a referenced investor entity first with POST /v1/entities/detail or a referenced investor person first with POST /v1/people, then create the join.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`joinId`,inputName:`joinId`,in:`query`,required:!1,description:`Join identifier. When present, lookup ignores transaction and investor query parameters.`,schemaType:`string`,schemaFormat:`uuid`},{name:`transactionId`,inputName:`transactionId`,in:`query`,required:!1,description:`Fundraise round transaction id. The target entity id/slug is the entity that raised the round; for an Investment Firm investment, use the portfolio/fundraising company as target and identify the firm with investorEntityId or investorEntitySlug. When omitted, lookup uses the target entity plus round/dateAnnounced.`,schemaType:`string`,schemaFormat:`uuid`},{name:`round`,inputName:`round`,in:`query`,required:!1,description:`Raw fundraise round label used when transactionId is omitted`,schemaType:`string`},{name:`dateAnnounced`,inputName:`dateAnnounced`,in:`query`,required:!1,description:`Exact announced timestamp used to disambiguate same-label rounds`,schemaType:`string`,schemaFormat:`date-time`},{name:`investorEntityId`,inputName:`investorEntityId`,in:`query`,required:!1,description:`Existing investor entity identifier. The entity must already exist; create a referenced investor entity first with POST /v1/entities/detail.`,schemaType:`string`,schemaFormat:`uuid`},{name:`investorEntitySlug`,inputName:`investorEntitySlug`,in:`query`,required:!1,description:`Existing investor entity slug when investorEntityId is omitted. The entity must already exist; create it first with POST /v1/entities/detail.`,schemaType:`string`},{name:`investorPersonId`,inputName:`investorPersonId`,in:`query`,required:!1,description:`Existing investor person identifier. The person must already exist; create a referenced investor person first with POST /v1/people.`,schemaType:`string`,schemaFormat:`uuid`},{name:`investorPersonSlug`,inputName:`investorPersonSlug`,in:`query`,required:!1,description:`Existing investor person slug when investorPersonId is omitted. The person must already exist; create it first with POST /v1/people.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-investor-join`,schemaName:`EntityFundraiseInvestorJoinSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityFundraiseInvestorJoin`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins/{joinId}`,resource:`entities`,intent:`read`,summary:`Get one investor on a funding round`,description:`Gets one entity or person investor join by join id.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`joinId`,inputName:`joinId`,in:`path`,required:!0,description:`Fundraise investor join identifier`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-investor-join`,schemaName:`EntityFundraiseInvestorJoinSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityFundraiseRounds`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds`,resource:`entities`,intent:`read`,summary:`List a company's funding rounds`,description:`Lists fundraise rounds for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`round`,inputName:`round`,in:`query`,required:!1,description:`Round label contains filter`,schemaType:`string`},{name:`dateFrom`,inputName:`dateFrom`,in:`query`,required:!1,description:`Inclusive minimum announced date`,schemaType:`string`,schemaFormat:`date`},{name:`dateTo`,inputName:`dateTo`,in:`query`,required:!1,description:`Inclusive maximum announced date`,schemaType:`string`,schemaFormat:`date`},{name:`minAmount`,inputName:`minAmount`,in:`query`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`},{name:`maxAmount`,inputName:`maxAmount`,in:`query`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit monogram fallback`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-transaction`,schemaName:`EntityFundraiseTransactionSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityFundraiseRound`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}`,resource:`entities`,intent:`read`,summary:`Get one funding round`,description:`Gets one fundraise round for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id. Use fundraiseRoundId for the round id.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`fundraiseRoundId`,inputName:`fundraiseRoundId`,in:`path`,required:!0,description:`Fundraise round id. Use this with the entityId path segment that owns the round.`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-transaction`,schemaName:`EntityFundraiseTransactionSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityInvestments`,method:`GET`,path:`/v1/entities/{entityId}/investments`,resource:`entities`,intent:`read`,summary:`List the investments a company made`,description:"Lists investments made by the requesting investor entity. Use entityId to select the investor, then filter by round, dateFrom/dateTo, minAmount/maxAmount, and latestPerEntity. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc or `--sort` amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. Deep traversal uses cursor: pass the prior X-Next-Cursor value as cursor and reuse the same filters and sort.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`round`,inputName:`round`,in:`query`,required:!1,description:`Round label contains filter`,schemaType:`string`},{name:`dateFrom`,inputName:`dateFrom`,in:`query`,required:!1,description:`Inclusive minimum announced date`,schemaType:`string`,schemaFormat:`date`},{name:`dateTo`,inputName:`dateTo`,in:`query`,required:!1,description:`Inclusive maximum announced date`,schemaType:`string`,schemaFormat:`date`},{name:`minAmount`,inputName:`minAmount`,in:`query`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`},{name:`maxAmount`,inputName:`maxAmount`,in:`query`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit monogram fallback`,schemaType:`boolean`},{name:`latestPerEntity`,inputName:`latestPerEntity`,in:`query`,required:!1,description:`Return latest transaction per entity`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-transaction`,schemaName:`EntityFundraiseTransactionSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`investments`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityInvestorActivity`,method:`GET`,path:`/v1/entities/{entityId}/investor-activity`,resource:`entities`,intent:`read`,summary:`Get investor activity`,description:`Gets the investor-perspective activity aggregate (total investments, current portfolio count, exits, and top investment stages) for an investor. Use entityId for the investor — the fund, investment firm, or company that supplied the capital — not a portfolio company that raised a round.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-investor-activity`,schemaName:`EntityFundraiseInvestorActivitySchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`investor-activity`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityInvestors`,method:`GET`,path:`/v1/entities/{entityId}/investors`,resource:`entities`,intent:`read`,summary:`List a company's investors`,description:"Lists entity investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc or `--sort` amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram fallback`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/investor-participation`,schemaName:`EntityInvestorParticipationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`investors`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityMedia`,method:`GET`,path:`/v1/entities/{entityId}/media/{mediaType}`,resource:`entities`,intent:`read`,summary:`Get a company media slot`,description:`Returns the selected square or standard entity logo. Empty slots return 404.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`mediaType`,inputName:`mediaType`,in:`path`,required:!0,description:`Media slot; entities serve logo.`,schemaRef:`MediaSlot`,schemaType:`string`,schemaEnum:[`logo`,`photo`,`thumbnail`]},{name:`logoType`,inputName:`logoType`,in:`query`,required:!1,description:`Entity logo variant; defaults to square.`,schemaRef:`EntityLogoType`,schemaType:`string`,schemaEnum:[`SQUARE`,`STANDARD`]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/media/upload`,schemaName:`MediaUploadSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`media`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityPersonAssociations`,method:`GET`,path:`/v1/entities/{entityId}/people`,resource:`entities`,intent:`read`,summary:`List the people at a company`,description:`Returns people associated with one entity. Public results exclude hidden entities; callers with private-visibility authority can include them.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`search`,inputName:`search`,in:`query`,required:!1,description:`Search term filter`,schemaType:`string`},{name:`role`,inputName:`role`,in:`query`,required:!1,description:`Match the complete titleName, ignoring case (for example, Co-Founder & CEO). Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`},{name:`isCurrent`,inputName:`isCurrent`,in:`query`,required:!1,description:`Current association filter`,schemaType:`boolean`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Include person URL records`,schemaType:`boolean`},{name:`includeAddress`,inputName:`includeAddress`,in:`query`,required:!1,description:`Include person address records`,schemaType:`boolean`},{name:`personSlug`,inputName:`personSlug`,in:`query`,required:!1,description:`Person slug fallback for entity-keyed writes`,schemaType:`string`},{name:`countOnly`,inputName:`countOnly`,in:`query`,required:!1,description:`Return count metadata without full content`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram fallback`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes associations on hidden entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/person-association`,schemaName:`EntityPersonAssociationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityPersonAssociation`,method:`GET`,path:`/v1/entities/{entityId}/people/{associationId}`,resource:`entities`,intent:`read`,summary:`Get one person's role at a company`,description:`Returns one entity-scoped association detail. Public results hide associations to hidden entities; callers with private-visibility authority can include them.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`associationId`,inputName:`associationId`,in:`path`,required:!0,description:`Association id`,schemaType:`integer`,schemaFormat:`int32`},{name:`search`,inputName:`search`,in:`query`,required:!1,description:`Search term filter`,schemaType:`string`},{name:`role`,inputName:`role`,in:`query`,required:!1,description:`Match the complete titleName, ignoring case (for example, Co-Founder & CEO). Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`},{name:`isCurrent`,inputName:`isCurrent`,in:`query`,required:!1,description:`Current association filter`,schemaType:`boolean`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Include person URL records`,schemaType:`boolean`},{name:`includeAddress`,inputName:`includeAddress`,in:`query`,required:!1,description:`Include person address records`,schemaType:`boolean`},{name:`personSlug`,inputName:`personSlug`,in:`query`,required:!1,description:`Person slug fallback for entity-keyed writes`,schemaType:`string`},{name:`countOnly`,inputName:`countOnly`,in:`query`,required:!1,description:`Return count metadata without full content`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram fallback`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes associations on hidden entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/person-association`,schemaName:`EntityPersonAssociationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityPersonInvestors`,method:`GET`,path:`/v1/entities/{entityId}/person-investors`,resource:`entities`,intent:`read`,summary:`List person investors`,description:"Lists person investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc or `--sort` amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.",security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram fallback`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/investor-participation`,schemaName:`PersonInvestorParticipationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`person-investors`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityProductSuggestions`,method:`GET`,path:`/v1/entities/{entityId}/products/suggestions`,resource:`entities`,intent:`read`,summary:`Suggest a company's products or services`,description:`Semantic suggestions for this slot only. NOT a completeness signal. Each candidate is a hypothesis — verify with web search before writing. exhaustive is always false. See coverage for the remaining details and the owning read that proves each.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`limit`,inputName:`limit`,in:`query`,required:!1,description:`Maximum suggestions to return; default 12, maximum 50.`,schemaType:`integer`,schemaFormat:`int32`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private completion coverage when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/suggestion-result`,schemaName:`EntitySuggestionResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`products`,`suggestions`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityRelationships`,method:`GET`,path:`/v1/entities/{entityId}/relationships`,resource:`entities`,intent:`read`,summary:`List a company's relationships`,description:`Returns relationship rows touching the path entity. Defaults to renderable-only rows where isCurrent=true and isPrimary=true. Set includeNonRenderable=true to surface historic and non-primary curation rows; returned rows include id, isCurrent, and isPrimary so hidden-row cause is explicit. Use entities relationships get to retrieve one row by id without an entity path.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`type`,inputName:`type`,in:`query`,required:!1,description:`Optional EntityRelationshipType filter, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. Use entities relationships types list for valid values.`,schemaType:`string`},{name:`includeNonRenderable`,inputName:`includeNonRenderable`,in:`query`,required:!1,description:`Include historic or non-primary rows. Default false returns only rows where isCurrent=true and isPrimary=true.`,schemaType:`boolean`,schemaDefault:!1},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`},{name:`transitive`,inputName:`transitive`,in:`query`,required:!1,description:`When true, returns direct curated competitors with each competitor's provider comparison signals (sells-to, pricing, ownership, funding, website) nested under its productService row. Competition is not transitively closed: A-B plus B-C surfaces B from A, never C. Only supported for type=competingProductService; the result is capped, so cursor and includeNonRenderable are not accepted alongside transitive=true.`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/relationship`,schemaName:`EntityRelationshipSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityRelationshipSuggestions`,method:`GET`,path:`/v1/entities/{entityId}/relationships/suggestions`,resource:`entities`,intent:`read`,summary:`Suggest relationships for a company`,description:`Semantic suggestions for this slot only. NOT a completeness signal. Each candidate is a hypothesis — verify with web search before writing. exhaustive is always false. See coverage for the remaining details and the owning read that proves each.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`limit`,inputName:`limit`,in:`query`,required:!1,description:`Maximum suggestions to return; default 12, maximum 50.`,schemaType:`integer`,schemaFormat:`int32`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private completion coverage when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/suggestion-result`,schemaName:`EntitySuggestionResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`suggestions`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityRepositories`,method:`GET`,path:`/v1/entities/{entityId}/repositories`,resource:`entities`,intent:`read`,summary:`List a company's GitHub repositories`,description:`Returns the entity's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the repositories`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:50},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/github/repo`,schemaName:`GithubRepoSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`repositories`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getEntityResearch`,method:`GET`,path:`/v1/entities/{entityId}/research`,resource:`entities`,intent:`read`,summary:`Get the research gathered about a company`,description:`Returns the consolidated research projection for an entity. Callers with private-visibility authority can include hidden research snippets and off-sitemap entities.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden research snippets and off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/research`,schemaName:`EntityResearchSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityResearchDetails`,method:`GET`,path:`/v1/entities/{entityId}/research-details`,resource:`entities`,intent:`read`,summary:`List research details`,description:`Returns paginated research details for an entity. Optionally filter by detail type. Rows for timeSeries=true types are history, not stale current state.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25},{name:`type`,inputName:`type`,in:`query`,required:!1,description:`Research detail type token. Run GET /v1/entities/research/details/types (CLI: entities research details types list) for the token inventory and each token's value shape.`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/research-detail`,schemaName:`EntityResearchDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getEntityResearchDetail`,method:`GET`,path:`/v1/entities/{entityId}/research-details/{detailId}`,resource:`entities`,intent:`read`,summary:`Get research detail`,description:`Returns one research detail for an entity.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`detailId`,inputName:`detailId`,in:`path`,required:!0,description:`Research detail id.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/research-detail`,schemaName:`EntityResearchDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityResearchSnippets`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets`,resource:`entities`,intent:`read`,summary:`List research snippets`,description:`Returns paginated research snippets for one entity. Public reads omit hidden rows and private provenance fields; privileged private reads include hidden rows. Sorting is fixed by the server.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/research-snippet`,schemaName:`EntityResearchSnippetSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getEntityResearchSnippet`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets/{snippetId}`,resource:`entities`,intent:`read`,summary:`Get research snippet`,description:`Returns one research snippet for an entity. Public reads omit private provenance fields.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`snippetId`,inputName:`snippetId`,in:`path`,required:!0,description:`Research snippet id.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/research-snippet`,schemaName:`EntityResearchSnippetSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntitySimilarEntities`,method:`GET`,path:`/v1/entities/{entityId}/similar`,resource:`entities`,intent:`read`,summary:`Get similar companies by id`,description:`Returns similar entities for the UUID at this address, ordered by similarity score. Rows include the entity and similarity provenance. Use relationshipType to filter stored relationships. Custom sorting is unsupported. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID)`,schemaType:`string`,schemaFormat:`uuid`},{name:`relationshipType`,inputName:`relationshipType`,in:`query`,required:!1,description:`Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor.`,schemaType:`string`},{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Optional entity typeRecord filter. Repeat to allow multiple entity types.`,schemaType:`array`,itemSchemaType:`string`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit monogram fallback`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:10}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/similarity-result`,schemaName:`EntitySimilarityResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getEntitySlug`,method:`GET`,path:`/v1/entities/{entityId}/slug`,resource:`entities`,intent:`read`,summary:`Get a company's slug`,description:`Returns the current slug, canonical path, and public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/slug/location`,schemaName:`SlugLocationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`slug`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityTexts`,method:`GET`,path:`/v1/entities/{entityId}/texts`,resource:`entities`,intent:`read`,summary:`List a company's text`,description:`Returns paginated text rows owned by the entity. Inactive or private rows require read auth.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the text rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive text rows`,schemaType:`boolean`,schemaDefault:!1},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Include private text rows for callers with read access`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/text`,schemaName:`EntityTextSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityText`,method:`GET`,path:`/v1/entities/{entityId}/texts/{textId}`,resource:`entities`,intent:`read`,summary:`Get one piece of company text`,description:`Returns one entity-owned text row by id. Requires read auth.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the text row`,schemaType:`string`,schemaFormat:`uuid`},{name:`textId`,inputName:`textId`,in:`path`,required:!0,description:`Text row id`,schemaType:`integer`,schemaFormat:`int64`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Include private text rows for callers with read access`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/text`,schemaName:`EntityTextSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityTrendingNews`,method:`GET`,path:`/v1/entities/{entityId}/trending-news`,resource:`entities`,intent:`read`,summary:`List trending news about a company`,description:`Returns trending news semantically related to the company named by the entity id path parameter.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:10}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/news/news`,schemaName:`NewsSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`trending-news`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityTypeRecord`,method:`GET`,path:`/v1/entities/{entityId}/type-record`,resource:`entities`,intent:`read`,summary:`Get a record's type`,description:`Returns the current canonical EntityType for an existing entity.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/type`,schemaName:`EntityTypeSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`type-record`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntityUniqueIds`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids`,resource:`entities`,intent:`read`,summary:`List a company's identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:50},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getEntityUniqueId`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids/{uniqueIdId}`,resource:`entities`,intent:`read`,summary:`Get one company identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`uniqueIdId`,inputName:`uniqueIdId`,in:`path`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityUrls`,method:`GET`,path:`/v1/entities/{entityId}/urls`,resource:`entities`,intent:`read`,summary:`List a company's URLs`,description:`Returns paged primary current URL rows owned by an entity. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the URL rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include secondary active and inactive/historical URL rows`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/url-link`,schemaName:`EntityUrlLinkSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityUrl`,method:`GET`,path:`/v1/entities/{entityId}/urls/{urlId}`,resource:`entities`,intent:`read`,summary:`Get one company URL`,description:`Returns one entity-owned URL row by id. Requires read auth.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity UUID owning the URL row`,schemaType:`string`,schemaFormat:`uuid`},{name:`urlId`,inputName:`urlId`,in:`path`,required:!0,description:`URL link id`,schemaType:`integer`,schemaFormat:`int64`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/url-link`,schemaName:`EntityUrlLinkSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listEntityValuations`,method:`GET`,path:`/v1/entities/{entityId}/valuations`,resource:`entities`,intent:`read`,summary:`List a company's valuation over time`,description:`Returns newest-first, per-UTC-month valuation points composed from stated latestValuation research details plus fundraise-round valuations. Only researchDetail points have detailId and can be changed here; fundraiseRound points are read-only here. Custom sort is not supported.`,security:[],parameter:[{name:`entityId`,inputName:`entityId`,in:`path`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/valuation-time-series-point`,schemaName:`EntityValuationTimeSeriesPointSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`entities`,intent:`read`,cliPath:[`entities`,`valuations`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`askHelpQuestion`,method:`POST`,path:`/v1/help`,resource:`help`,intent:`search`,summary:`Answer a natural-language platform help question`,description:`Retrieves the most relevant operations, skills, and completion gates, then returns a grounded, citation-bearing answer. Unsupported questions abstain (LOW confidence) rather than invent a command. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,inputName:`model`,in:`body`,required:!1,description:`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.`,schemaType:`string`},{name:`question`,inputName:`question`,in:`body`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`},{name:`scope`,inputName:`scope`,in:`body`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all.`,schemaRef:`HelpScope`,schemaType:`string`,schemaEnum:[`READ`,`WRITE`,`ALL`]}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/help`,schemaName:`AgentHelpSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`help`,intent:`search`,cliPath:[`help`,`ask`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`getAgentInstructionManifest`,method:`GET`,path:`/v1/help/instructions/manifest`,resource:`help`,intent:`read`,summary:`Get the agent instruction manifest`,description:`Returns the latest-pointer manifest of versioned prompt and skill documents. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-manifest`,schemaName:`AgentInstructionManifestSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`manifest`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getAgentInstruction`,method:`GET`,path:`/v1/help/instructions/{kind}/{name}`,resource:`help`,intent:`read`,summary:`Get one agent instruction document`,description:`Returns the current version and markdown content for one prompt, skill, or agent. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`kind`,inputName:`kind`,in:`path`,required:!0,description:`Document kind: prompt, skill, or agent`,schemaRef:`AgentInstructionKind`,schemaType:`string`,schemaEnum:[`PROMPT`,`SKILL`,`AGENT`]},{name:`name`,inputName:`name`,in:`path`,required:!0,description:`Manifest name of the document`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-detail`,schemaName:`AgentInstructionDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getAgentInstructionVersion`,method:`GET`,path:`/v1/help/instructions/{kind}/{name}/versions/{version}`,resource:`help`,intent:`read`,summary:`Get one agent instruction document version`,description:`Returns an immutable prompt, skill, or agent document by name and version. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`kind`,inputName:`kind`,in:`path`,required:!0,description:`Document kind: prompt, skill, or agent`,schemaRef:`AgentInstructionKind`,schemaType:`string`,schemaEnum:[`PROMPT`,`SKILL`,`AGENT`]},{name:`name`,inputName:`name`,in:`path`,required:!0,description:`Manifest name of the document`,schemaType:`string`},{name:`version`,inputName:`version`,in:`path`,required:!0,description:`Immutable content version`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/agent/instruction-detail`,schemaName:`AgentInstructionDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`versions`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`lookupHandle`,method:`GET`,path:`/v1/lookup`,resource:`lookup`,intent:`lookup`,summary:`Find the record behind an id, slug, or URL`,description:`Resolve any identifier token to its canonical entity or person. Tries UUID, then the stable public handle, then external registry ids, then the slug (with redirects). Returns 404 when nothing matches and 409 when an external id maps to multiple owners.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`token`,inputName:`token`,in:`query`,required:!0,description:`Any identifier: a stable public handle (e.g. eV1StGXR8Z5a), a UUID, an external registry id (ticker, LEI, EIN, ...), or a slug.`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/resolved/handle`,schemaName:`ResolvedHandleSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`lookup`,intent:`lookup`,cliPath:[`lookup`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`lookupSlugRedirect`,method:`GET`,path:`/v1/lookup/slug-redirects`,resource:`lookup`,intent:`lookup`,summary:`Resolve slug redirect path`,description:`Read-only public-path resolver used before front-end page rendering so changed slug, entity-family, and Business Line parent-family URLs return a permanent HTTP redirect to the current canonical public path, while missing slug URLs return a real 404 before the App Router starts streaming. One profile sub-path segment is preserved across family redirects; the front-end owns the tab inventory. Direct product/service alias paths /companies/products-services/{slug} return 204 for a public Product/Service with a non-hidden eligible provider, with curated alias redirect rows taking precedence; a 404 on a slug-backed path can also mean the record exists but is not yet publicly visible. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`path`,inputName:`path`,in:`query`,required:!0,description:`Public site path, such as /companies/old-slug`,schemaType:`string`}],response:[{status:`301`,description:`Permanent redirect to the canonical public route.`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`lookup`,intent:`lookup`,cliPath:[`lookup`,`slug-redirects`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`lookupUniqueId`,method:`GET`,path:`/v1/lookup/unique-ids`,resource:`lookup`,intent:`lookup`,summary:`Look up an identifier owner`,description:`Resolves an external identifier to its owner(s). idType accepts a canonical token or alias; the value is normalized per type before matching. Returns every owner that carries the identifier (a value can recur across owners, e.g. a reused ticker), each row carrying its entityId or personId.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`idType`,inputName:`idType`,in:`query`,required:!0,description:`Identifier type token or alias, for example ein.`,schemaType:`string`},{name:`identifier`,inputName:`identifier`,in:`query`,required:!0,description:`Identifier value to resolve.`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`lookup`,intent:`lookup`,cliPath:[`lookup`,`unique-ids`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listUniqueIdTypes`,method:`GET`,path:`/v1/lookup/unique-ids/types`,resource:`lookup`,intent:`read`,summary:`List the accepted unique identifier types`,description:`Lists the recognized external identifier types (ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid) with each type's label, accepted aliases, owner scope (entity and/or person), and the format pattern a value must match on write.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id-type-alias`,schemaName:`UniqueIdTypeAliasSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`lookup`,intent:`read`,cliPath:[`lookup`,`unique-ids`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listUrlTypes`,method:`GET`,path:`/v1/lookup/url-types`,resource:`lookup`,intent:`read`,summary:`List the accepted values for --url-type`,description:`Returns the canonical URL types and aliases accepted by entity and person URL rows. One catalog serves both owners.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/url/type-alias`,schemaName:`UrlTypeAliasSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`lookup`,intent:`read`,cliPath:[`lookup`,`url-types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getSystemGlobalMetrics`,method:`GET`,path:`/v1/metrics`,resource:`metrics`,intent:`read`,summary:`Get platform totals for companies, funding, and people`,description:`Global metrics snapshot. Companies tracked, total funding, trailing 30-day funding, investors, people, countries, cities. Cached for high-traffic homepage reads.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/system/global-metrics`,schemaName:`SystemGlobalMetricsSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`metrics`,intent:`read`,cliPath:[`metrics`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listNews`,method:`GET`,path:`/v1/news`,resource:`news`,intent:`read`,summary:`List news articles`,description:`Browse news articles in the canonical news domain, with optional filtering.`,security:[],parameter:[{name:`search`,inputName:`search`,in:`query`,required:!1,description:`Full-text news search term.`,schemaType:`string`},{name:`category`,inputName:`category`,in:`query`,required:!1,description:`News category slug to include or exclude.`,schemaType:`string`},{name:`owner.entityId`,inputName:`ownerEntityId`,in:`query`,required:!1,description:`Canonical entity UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`owner.personId`,inputName:`ownerPersonId`,in:`query`,required:!1,description:`Canonical person UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`excludeId`,inputName:`excludeId`,in:`query`,required:!1,description:`Exclude one news article by id.`,schemaType:`integer`,schemaFormat:`int32`},{name:`authorInitial`,inputName:`authorInitial`,in:`query`,required:!1,description:`Author initial filter.`,schemaType:`string`},{name:`publishedAfter`,inputName:`publishedAfter`,in:`query`,required:!1,description:`Earliest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`},{name:`publishedBefore`,inputName:`publishedBefore`,in:`query`,required:!1,description:`Latest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Cursor token returned by the previous thin page.`,schemaType:`string`},{name:`letter`,inputName:`letter`,in:`query`,required:!1,description:`Deprecated author-initial alias; use authorInitial.`,schemaType:`string`},{name:`mode`,inputName:`mode`,in:`query`,required:!1,description:`Response mode; use thin for cursor-paginated index reads.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/news/news`,schemaName:`NewsSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`news`,intent:`read`,cliPath:[`news`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`createNewsFeedback`,method:`POST`,path:`/v1/news/feedback`,resource:`news`,intent:`write`,summary:`Submit news feedback`,description:`Records feedback on a news article.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/news/feedback`,schemaName:`NewsFeedbackSchema`,kind:`json`,contentType:`application/json`,description:`Feedback submission for a news article`,required:!0,requiredPath:[],parameter:[{name:`comment`,inputName:`comment`,in:`body`,required:!1,description:`Free-form feedback text`,schemaType:`string`},{name:`newsId`,inputName:`newsId`,in:`body`,required:!1,description:`News article ID`,schemaType:`integer`,schemaFormat:`int32`},{name:`reaction`,inputName:`reaction`,in:`body`,required:!1,description:`Short reaction (like, dislike, etc.)`,schemaType:`string`},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`News article slug`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/news/feedback-acknowledgement`,schemaName:`NewsFeedbackAcknowledgementSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`news`,intent:`write`,cliPath:[`news`,`feedback`,`create`],scope:`write`,auth:`bearer`,stdinBody:!0,destructive:!1}},{operationId:`lookupNews`,method:`GET`,path:`/v1/news/lookup`,resource:`news`,intent:`lookup`,summary:`Look up one news article`,description:`Resolves news detail by slug, external ID, URL, or bounded title candidate signals. Use the numeric item route for an id; any id query is rejected. Canonical redirects are preserved.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`slug`,inputName:`slug`,in:`query`,required:!1,description:`Exact news article slug (URL-friendly identifier). Mutually exclusive with id, externalId, url, and title.`,schemaType:`string`},{name:`externalId`,inputName:`externalId`,in:`query`,required:!1,description:`External ID or RSS GUID for ingestion-key lookup. Mutually exclusive with id, slug, url, and title.`,schemaType:`string`},{name:`url`,inputName:`url`,in:`query`,required:!1,description:`Original article URL to resolve via strict host+path or domain-only match. Mutually exclusive with id, slug, and externalId. May pair with title and publication to narrow candidate recovery after an exact URL miss. Pair with urlMatchMode to disambiguate.`,schemaType:`string`},{name:`title`,inputName:`title`,in:`query`,required:!1,description:`Candidate lookup signal: article title. Mutually exclusive with id, slug, and externalId. Combine with publication, urlDomain, or url for bounded candidate search.`,schemaType:`string`},{name:`publication`,inputName:`publication`,in:`query`,required:!1,description:`Publication qualifier (e.g., 'TechCrunch', 'Forbes'). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`query`,required:!1,description:`Candidate lookup URL domain qualifier (host only, no path). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`query`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Narrows url and urlDomain matching. Not an identifier on its own.`,schemaType:`string`}],response:[{status:`200`,description:`News detail as canonical JSON or compact text.`,schemaImport:`@aventurevc/api-schemas/news/detail`,schemaName:`NewsDetailSchema`},{status:`301`,description:`Redirect to new slug location`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Ambiguous candidate signals: more than one article still matches the supplied title/URL bundle. ProblemDetail carries details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by id, slug, or externalId.`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`409`,description:`Ambiguous candidate signals: more than one article still matches the supplied title/URL bundle. ProblemDetail carries details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by id, slug, or externalId.`}],projection:{resource:`news`,intent:`lookup`,cliPath:[`news`,`lookup`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getNews`,method:`GET`,path:`/v1/news/{newsId}`,resource:`news`,intent:`read`,summary:`Get one news article`,description:`Returns news detail by exact positive ID. Use lookup for a slug, external ID, URL, or title candidates.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`newsId`,inputName:`newsId`,in:`path`,required:!0,description:`Exact positive news article id.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`News detail as canonical JSON or compact text.`,schemaImport:`@aventurevc/api-schemas/news/detail`,schemaName:`NewsDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`news`,intent:`read`,cliPath:[`news`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getNewsMedia`,method:`GET`,path:`/v1/news/{newsId}/media/{mediaType}`,resource:`news`,intent:`read`,summary:`Get news thumbnail`,description:`Returns the article's attached thumbnail. Empty slots return 404.`,security:[],parameter:[{name:`newsId`,inputName:`newsId`,in:`path`,required:!0,description:`Exact positive news article id`,schemaType:`integer`,schemaFormat:`int32`},{name:`mediaType`,inputName:`mediaType`,in:`path`,required:!0,description:`Media slot; news articles serve thumbnail.`,schemaRef:`MediaSlot`,schemaType:`string`,schemaEnum:[`logo`,`photo`,`thumbnail`]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/media/upload`,schemaName:`MediaUploadSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`news`,intent:`read`,cliPath:[`news`,`media`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listNewsRelatedEntities`,method:`GET`,path:`/v1/news/{newsId}/related-entities`,resource:`news`,intent:`read`,summary:`List the entities a news article is about`,description:`Returns entities semantically related to a news article.`,security:[],parameter:[{name:`newsId`,inputName:`newsId`,in:`path`,required:!0,description:`News article id whose semantic neighbors should be returned.`,schemaType:`integer`,schemaFormat:`int32`,legacyName:`id`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:10}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/entity`,schemaName:`EntitySchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`news`,intent:`read`,cliPath:[`news`,`related-entities`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listPersonFilters`,method:`GET`,path:`/v1/people/filters`,resource:`people`,intent:`read`,summary:`List person filter options`,description:`Returns available people filter facets.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-option-set`,schemaName:`EntityFilterOptionSetSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`filters`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`searchPersonFilters`,method:`GET`,path:`/v1/people/filters/search`,resource:`people`,intent:`search`,summary:`Search people filter options`,description:`Searches available people filter options.`,security:[],parameter:[{name:`filterKey`,inputName:`filterKey`,in:`query`,required:!0,description:`Filter key to search within`,schemaType:`string`},{name:`search`,inputName:`search`,in:`query`,required:!0,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Page index is fixed to 0 for filter search`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; filter-search default 20, maximum 100.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/filter-search-result`,schemaName:`EntityFilterSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`search`,cliPath:[`people`,`filters`,`search`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonLookup`,method:`GET`,path:`/v1/people/lookup`,resource:`people`,intent:`read`,summary:`Read one person's full detail by exact slug or URL`,description:`Exact read: returns the full detail of the one person a slug, URL, or candidate signals prove, and 404 or 409 instead of guessing. To identify a person by name and clues, use the POST lookup on this path (CLI people lookup). Use the UUID item route for an id; any id query is rejected. Canonical redirects are preserved. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[],parameter:[{name:`slug`,inputName:`slug`,in:`query`,required:!1,description:`Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C.`,schemaType:`string`},{name:`url`,inputName:`url`,in:`query`,required:!1,description:`Group B — current person URL to resolve via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback.`,schemaType:`string`},{name:`urlType`,inputName:`urlType`,in:`query`,required:!1,description:`Optional URL type qualifier for URL lookup (e.g., 'linkedin', 'twitter'). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own.`,schemaType:`string`},{name:`urlMatchMode`,inputName:`urlMatchMode`,in:`query`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Not an identifier on its own.`,schemaType:`string`},{name:`nameFull`,inputName:`nameFull`,in:`query`,required:!1,description:`Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`},{name:`nameAny`,inputName:`nameAny`,in:`query`,required:!1,description:`Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`query`,required:!1,description:`Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`},{name:`urlDomain`,inputName:`urlDomain`,in:`query`,required:!1,description:`Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`},{name:`includeAssociation`,inputName:`includeAssociation`,in:`query`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`},{name:`includeAddress`,inputName:`includeAddress`,in:`query`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`},{name:`maxAssociations`,inputName:`maxAssociations`,in:`query`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`Person detail as canonical JSON or compact text.`,schemaImport:`@aventurevc/api-schemas/person/detail`,schemaName:`PersonDetailSchema`},{status:`301`,description:`Canonical person URL redirect`},{status:`400`,description:`Bad Request`},{status:`404`,description:`No person resolved: exact URL and bounded candidate signals are exhausted, which does not prove the record is absent — search before creating. An existing but filtered row instead reports its reason as the ProblemDetail title: Person Exists but Is Not Public (retry with includePrivate=true).`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Ambiguous identity: a strict-URL match or candidate set still at the review threshold resolves to more than one person. ProblemDetail carries details.candidate; review those ids, update the matching candidate, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by personId.`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`404`,description:`No person resolved: exact URL and bounded candidate signals are exhausted, which does not prove the record is absent — search before creating. An existing but filtered row instead reports its reason as the ProblemDetail title: Person Exists but Is Not Public (retry with includePrivate=true).`},{status:`409`,description:`Ambiguous identity: a strict-URL match or candidate set still at the review threshold resolves to more than one person. ProblemDetail carries details.candidate; review those ids, update the matching candidate, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by personId.`}],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`lookup`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`lookupPerson`,method:`POST`,path:`/v1/people/lookup`,resource:`people`,intent:`lookup`,summary:`Find which person a name refers to, or confirm they are new`,description:`Returns status MATCHED, NO_MATCH, or NEEDS_REVIEW. MATCHED: match.record.id is the person; read their detail with people get --person-id. NO_MATCH: no record you can see is this person; create them. NEEDS_REVIEW: show candidate (most probable first) to the user and ask which one it is or whether the person is new; never create on NEEDS_REVIEW. stage names the step that settled it: DETERMINISTIC (URL proof, no model call), JUDGMENT (decision model), or WEB_EVIDENCE (added a web search). Send their LinkedIn or personal URL whenever you have it, and employer and title as context; the same name at a different employer is a different person. For the full detail of an exact slug or URL use people lookup get. Example: people lookup --name "Jane Doe" --context "CEO at Acme AI". Output: --text (default) is compact text, --json the full envelope, --data the Identification object for scripts.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[`name`],parameter:[{name:`context`,inputName:`context`,in:`body`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`},{name:`location`,inputName:`location`,in:`body`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`},{name:`name`,inputName:`name`,in:`body`,required:!0,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe.`,schemaType:`string`},{name:`sourceNewsId`,inputName:`sourceNewsId`,in:`body`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`},{name:`sourceUrl`,inputName:`sourceUrl`,in:`body`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`}]}],response:[{status:`200`,description:`The identification as canonical JSON or compact text/plain.`,schemaImport:`@aventurevc/api-schemas/identification/identification`,schemaName:`IdentificationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`lookupPersonBatch`,method:`POST`,path:`/v1/people/lookup/batch`,resource:`people`,intent:`lookup`,summary:`Look up people in bulk by id or slug`,description:`Enrich multiple people by id or slug with optional url, association, and address. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes private fields when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/person/lookup-batch`,schemaName:`PersonLookupBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for person detail enrichment. Each selector array accepts at most 200 values, and at most 200 selectors may be submitted across personId, slug, and url.`,required:!1,requiredPath:[],parameter:[{name:`hasImageFirst`,inputName:`hasImageFirst`,in:`body`,required:!1,description:`Sort results by image presence`,schemaType:`boolean`,schemaDefault:!1},{name:`includeAddress`,inputName:`includeAddress`,in:`body`,required:!1,description:`Include address values`,schemaType:`boolean`,schemaDefault:!0},{name:`includeAssociation`,inputName:`includeAssociation`,in:`body`,required:!1,description:`Include association values`,schemaType:`boolean`,schemaDefault:!0},{name:`includeUrl`,inputName:`includeUrl`,in:`body`,required:!1,description:`Include URL links`,schemaType:`boolean`,schemaDefault:!0},{name:`maxAssociations`,inputName:`maxAssociations`,in:`body`,required:!1,description:`Max association values per person`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:40},{name:`permitMonogram`,inputName:`permitMonogram`,in:`body`,required:!1,description:`Permit monogram fallbacks`,schemaType:`boolean`,schemaDefault:!0},{name:`personId`,inputName:`personId`,in:`body`,required:!1,description:`Person UUID values`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`slug`,inputName:`slug`,in:`body`,required:!1,description:`Person slug values`,schemaType:`array`,itemSchemaType:`string`},{name:`url`,inputName:`url`,in:`body`,required:!1,description:`Person URL values`,schemaType:`array`,itemSchemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/detail`,schemaName:`PersonDetailSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup`,`batch`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchPeopleByNaturalLanguage`,method:`POST`,path:`/v1/people/natural-search`,resource:`people`,intent:`search`,summary:`Deprecated: find people in natural language`,description:`Deprecated: use search natural people (POST /v1/search/natural/people) with the same body and parameters.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`When false, generated monogram pictures are stripped from person rows.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap people when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],explain:!0,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/natural-search`,schemaName:`PersonNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.arrayFilter.amountInvestedRange[].max`,inputName:`filterArrayFilterAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountInvestedRange[].min`,inputName:`filterArrayFilterAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountRaisedRange[].max`,inputName:`filterArrayFilterAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountRaisedRange[].min`,inputName:`filterArrayFilterAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.entityName`,inputName:`filterArrayFilterEntityName`,in:`body`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.investedCompany`,inputName:`filterArrayFilterInvestedCompany`,in:`body`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.personTitle`,inputName:`filterArrayFilterPersonTitle`,in:`body`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.round`,inputName:`filterArrayFilterRound`,in:`body`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.totalInvestmentCount[].max`,inputName:`filterArrayFilterTotalInvestmentCountMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.arrayFilter.totalInvestmentCount[].min`,inputName:`filterArrayFilterTotalInvestmentCountMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.arrayFilter.typeRecord`,inputName:`filterArrayFilterTypeRecord`,in:`body`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`filter.entityId`,inputName:`filterEntityId`,in:`body`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`filter.entitySlug`,inputName:`filterEntitySlug`,in:`body`,required:!1,description:`Associated entity slug.`,schemaType:`string`},{name:`filter.firstName`,inputName:`filterFirstName`,in:`body`,required:!1,description:`Person first name.`,schemaType:`string`},{name:`filter.includeAddress`,inputName:`filterIncludeAddress`,in:`body`,required:!1,description:`Include addresses on each person`,schemaType:`boolean`},{name:`filter.includeUrl`,inputName:`filterIncludeUrl`,in:`body`,required:!1,description:`Include URL links on each person`,schemaType:`boolean`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalInvestmentRange[].max`,inputName:`filterInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.investorActivity.totalInvestmentRange[].min`,inputName:`filterInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.isCurrent`,inputName:`filterIsCurrent`,in:`body`,required:!1,description:`Filter current associations.`,schemaType:`boolean`},{name:`filter.lastName`,inputName:`filterLastName`,in:`body`,required:!1,description:`Person last name.`,schemaType:`string`},{name:`filter.letter`,inputName:`filterLetter`,in:`body`,required:!1,description:`First-name initial.`,schemaType:`string`},{name:`filter.personId`,inputName:`filterPersonId`,in:`body`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`filter.personName`,inputName:`filterPersonName`,in:`body`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.role`,inputName:`filterRole`,in:`body`,required:!1,description:`Associated entity role or title.`,schemaType:`string`},{name:`filter.search`,inputName:`filterSearch`,in:`body`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`},{name:`filter.semanticQuery`,inputName:`filterSemanticQuery`,in:`body`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`},{name:`filter.status`,inputName:`filterStatus`,in:`body`,required:!1,description:`Person workflow status.`,schemaType:`string`},{name:`search.mode`,inputName:`searchMode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`search.model`,inputName:`searchModel`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`search.query`,inputName:`searchQuery`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/natural-search-result`,schemaName:`PersonNaturalSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`search`,cliPath:[`people`,`natural-search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchPeople`,method:`POST`,path:`/v1/people/search`,resource:`people`,intent:`search`,summary:`Search people`,description:`Browse, filter, and search person, people, and individual records in the people domain; returns a paginated people list matching a filter request body. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. Without semanticQuery or search, a default-sorted page emits an X-Next-Cursor keyset continuation; send it back as cursor, without sort, to read the next page.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`countOnly`,inputName:`countOnly`,in:`query`,required:!1,description:`When true, return only the page total in the body and skip the content payload.`,schemaType:`boolean`},{name:`hasImageFirst`,inputName:`hasImageFirst`,in:`query`,required:!1,description:`When true, sort people who have a photo before those who do not.`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`When false, monogram fallback logos are stripped from the response. Defaults to true.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden, unverified, and not-yet-published records when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque continuation from X-Next-Cursor. Repeat the same filters and size; a semantic cursor also repeats sort, a keyset cursor omits it.`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/person/filter`,schemaName:`PersonFilterSchema`,kind:`json`,contentType:`application/json`,description:`Canonical person criteria contract for GET/POST/batch endpoints`,required:!1,requiredPath:[],parameter:[{name:`arrayFilter.amountInvestedRange[].max`,inputName:`arrayFilterAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`arrayFilter.amountInvestedRange[].min`,inputName:`arrayFilterAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`arrayFilter.amountRaisedRange[].max`,inputName:`arrayFilterAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`arrayFilter.amountRaisedRange[].min`,inputName:`arrayFilterAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`arrayFilter.entityName`,inputName:`arrayFilterEntityName`,in:`body`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`},{name:`arrayFilter.investedCompany`,inputName:`arrayFilterInvestedCompany`,in:`body`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`},{name:`arrayFilter.personTitle`,inputName:`arrayFilterPersonTitle`,in:`body`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`},{name:`arrayFilter.round`,inputName:`arrayFilterRound`,in:`body`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`},{name:`arrayFilter.totalInvestmentCount[].max`,inputName:`arrayFilterTotalInvestmentCountMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`arrayFilter.totalInvestmentCount[].min`,inputName:`arrayFilterTotalInvestmentCountMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`arrayFilter.typeRecord`,inputName:`arrayFilterTypeRecord`,in:`body`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`entityId`,inputName:`entityId`,in:`body`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`entitySlug`,inputName:`entitySlug`,in:`body`,required:!1,description:`Associated entity slug.`,schemaType:`string`},{name:`firstName`,inputName:`firstName`,in:`body`,required:!1,description:`Person first name.`,schemaType:`string`},{name:`includeAddress`,inputName:`includeAddress`,in:`body`,required:!1,description:`Include addresses on each person`,schemaType:`boolean`},{name:`includeUrl`,inputName:`includeUrl`,in:`body`,required:!1,description:`Include URL links on each person`,schemaType:`boolean`},{name:`investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`investorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`investorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`investorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`investorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`investorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`investorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`investorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`investorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`investorActivity.totalInvestmentRange[].max`,inputName:`investorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`investorActivity.totalInvestmentRange[].min`,inputName:`investorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`isCurrent`,inputName:`isCurrent`,in:`body`,required:!1,description:`Filter current associations.`,schemaType:`boolean`},{name:`lastName`,inputName:`lastName`,in:`body`,required:!1,description:`Person last name.`,schemaType:`string`},{name:`letter`,inputName:`letter`,in:`body`,required:!1,description:`First-name initial.`,schemaType:`string`},{name:`personId`,inputName:`personId`,in:`body`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`personName`,inputName:`personName`,in:`body`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`},{name:`role`,inputName:`role`,in:`body`,required:!1,description:`Associated entity role or title.`,schemaType:`string`},{name:`search`,inputName:`search`,in:`body`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`},{name:`semanticQuery`,inputName:`semanticQuery`,in:`body`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`},{name:`status`,inputName:`status`,in:`body`,required:!1,description:`Person workflow status.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/person`,schemaName:`PersonSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`search`,cliPath:[`people`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`listPersonTextTypes`,method:`GET`,path:`/v1/people/texts/types`,resource:`people`,intent:`read`,summary:`List the accepted person text types`,description:`Returns text type values accepted by person text rows.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/text/type-option`,schemaName:`TextTypeOptionSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPerson`,method:`GET`,path:`/v1/people/{personId}`,resource:`people`,intent:`read`,summary:`Get one person by id`,description:`Returns person detail by exact UUID. Use lookup for a slug, URL, or candidate signals. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Exact person UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`},{name:`includeAssociation`,inputName:`includeAssociation`,in:`query`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`},{name:`includeAddress`,inputName:`includeAddress`,in:`query`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`},{name:`maxAssociations`,inputName:`maxAssociations`,in:`query`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.`,schemaType:`boolean`}],response:[{status:`200`,description:`Person detail as canonical JSON or compact text.`,schemaImport:`@aventurevc/api-schemas/person/detail`,schemaName:`PersonDetailSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listPersonAddresses`,method:`GET`,path:`/v1/people/{personId}/addresses`,resource:`people`,intent:`read`,summary:`List a person's addresses`,description:`Returns physical addresses with all role-period associations for one person.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/address/address`,schemaName:`AddressSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonAddress`,method:`GET`,path:`/v1/people/{personId}/addresses/{addressJoinId}`,resource:`people`,intent:`read`,summary:`Get one person's address`,description:`Returns the physical address group containing the selected person association.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`addressJoinId`,inputName:`addressJoinId`,in:`path`,required:!0,description:`Integer person-address association id`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/address/address`,schemaName:`AddressSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listPersonBlogPosts`,method:`GET`,path:`/v1/people/{personId}/blog-posts`,resource:`people`,intent:`read`,summary:`List a person's blog posts`,description:`Returns active external blog post links stored in research.res_blog_article.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the blog post rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive research blog post rows`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:10},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,schemaDefault:[`publishedAt,desc`],itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/blog/post`,schemaName:`BlogPostSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonBlogPost`,method:`GET`,path:`/v1/people/{personId}/blog-posts/{blogPostId}`,resource:`people`,intent:`read`,summary:`Get one person blog post`,description:`Returns one person-owned external link by id. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the blog post row`,schemaType:`string`,schemaFormat:`uuid`},{name:`blogPostId`,inputName:`blogPostId`,in:`path`,required:!0,description:`Blog post UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/blog/post`,schemaName:`BlogPostSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonContent`,method:`GET`,path:`/v1/people/{personId}/content`,resource:`people`,intent:`read`,summary:`List a person's publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to a person. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`},{name:`topic`,inputName:`topic`,in:`query`,required:!1,description:`Topic key or source category.`,schemaType:`string`},{name:`contentType`,inputName:`contentType`,in:`query`,required:!1,description:`Public content type filter.`,schemaRef:`PublicationType`,schemaType:`string`,schemaEnum:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`]},{name:`relation`,inputName:`relation`,in:`query`,required:!1,description:`Owner relation filter.`,schemaRef:`PublicationRelation`,schemaType:`string`,schemaEnum:[`by`,`about`]},{name:`year`,inputName:`year`,in:`query`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`},{name:`existenceProbe`,inputName:`existenceProbe`,in:`query`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`content`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonContentFacets`,method:`GET`,path:`/v1/people/{personId}/content/facets`,resource:`people`,intent:`read`,summary:`Count a person's publications`,description:`Counts one person's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/facet`,schemaName:`PublicationFacetSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`content`,`facets`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`searchPersonContent`,method:`POST`,path:`/v1/people/{personId}/content/search`,resource:`people`,intent:`search`,summary:`Search a person's publications`,description:`Translates plain-English constraints for one person's content index. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,inputName:`mode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`model`,inputName:`model`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`query`,inputName:`query`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/publication/publication`,schemaName:`PublicationSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`search`,cliPath:[`people`,`content`,`search`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`enrichPerson`,method:`POST`,path:`/v1/people/{personId}/enrichments`,resource:`people`,intent:`write`,summary:`Enrich one person`,description:`Queues an enrichment run for the addressed person, owned by the authenticated principal. The run targets that person's canonical aVenture profile, so it is billed as an update of a known record and reuses the person's already-active run.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`mode`,inputName:`mode`,in:`query`,required:!1,description:`Enrichment breadth; omitted requests the comprehensive default.`,schemaRef:`EnrichmentMode`,schemaType:`string`,schemaEnum:[`COMPREHENSIVE`,`INDIVIDUAL`]},{name:`model`,inputName:`model`,in:`query`,required:!1,description:`Orchestrator model override; omitted uses the configured role default.`,schemaType:`string`},{name:`userPrompt`,inputName:`userPrompt`,in:`query`,required:!1,description:`Optional steering prompt.`,schemaType:`string`},{name:`taskPresetKey`,inputName:`taskPresetKey`,in:`query`,required:!1,description:`Task preset keys that scope or emphasize this run.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`The queued enrichment run for the addressed person.`,schemaImport:`@aventurevc/api-schemas/harness/run`,schemaName:`HarnessRunSchema`,detailField:[`hasSourceDocument`,`lane`,`latestStatus`,`maxScoutConcurrent`,`nextAttemptAt`,`subagentModel`,`taskPresetKey`,`updatedAt`]},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`}],projection:{resource:`people`,intent:`write`,cliPath:[`people`,`enrichments`,`enrich`],scope:`write`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonEntityAssociations`,method:`GET`,path:`/v1/people/{personId}/entities`,resource:`people`,intent:`read`,summary:`List a person's roles at companies`,description:`Returns entity associations for one person.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`countOnly`,inputName:`countOnly`,in:`query`,required:!1,description:`Return count metadata without full content`,schemaType:`boolean`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Include entity URL records`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram logo fallback`,schemaType:`boolean`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor`,schemaType:`string`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden people and entity associations when the caller has private-visibility authority.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/person-association`,schemaName:`EntityPersonAssociationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonEntityAssociation`,method:`GET`,path:`/v1/people/{personId}/entities/{associationId}`,resource:`people`,intent:`read`,summary:`Get one of a person's roles at a company`,description:`Returns one person-scoped association join row.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`associationId`,inputName:`associationId`,in:`path`,required:!0,description:`Association id`,schemaType:`integer`,schemaFormat:`int32`},{name:`includeUrl`,inputName:`includeUrl`,in:`query`,required:!1,description:`Include entity URL records`,schemaType:`boolean`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit generated monogram logo fallback`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden people and entity associations when the caller has private-visibility authority.`,schemaType:`boolean`,schemaDefault:!1}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/person-association`,schemaName:`EntityPersonAssociationSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonGraph`,method:`GET`,path:`/v1/people/{personId}/graph`,resource:`people`,intent:`read`,summary:`Get person graph`,description:`Returns the precomputed person-graph document: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people) and co-investors. Lists are capped and pre-ranked; the response is the display order. Hidden people and entities are excluded at materialization. When no document has been materialized yet, returns empty lists with computedAt=null and schedules an asynchronous recompute.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/graph`,schemaName:`PersonGraphSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`graph`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listPersonInvestments`,method:`GET`,path:`/v1/people/{personId}/investments`,resource:`people`,intent:`read`,summary:`List a person's investments`,description:`Returns a paginated investment portfolio for a person with investorAttribution. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amount. Valid sort syntax is sort=amountInvested,desc or --sort amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person unique identifier (UUID)`,schemaType:`string`,schemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit monogram fallback`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:50},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/investment`,schemaName:`PersonInvestmentSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`investments`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonInvestorActivity`,method:`GET`,path:`/v1/people/{personId}/investor-activity`,resource:`people`,intent:`read`,summary:`Get person investor activity`,description:`Gets the investor-perspective activity aggregate (total investments, distinct portfolio companies, current portfolio count, exits, USD-attributed money totals, and top investment stages) for a person investor by personId. personId identifies the individual who supplied the capital — an angel or individual investor, not the company that raised the round.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person unique identifier (UUID)`,schemaType:`string`,schemaFormat:`uuid`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/fundraise-investor-activity`,schemaName:`EntityFundraiseInvestorActivitySchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`investor-activity`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonMedia`,method:`GET`,path:`/v1/people/{personId}/media/{mediaType}`,resource:`people`,intent:`read`,summary:`Get person photo`,description:`Returns the person's attached photo. Empty slots return 404.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID`,schemaType:`string`,schemaFormat:`uuid`},{name:`mediaType`,inputName:`mediaType`,in:`path`,required:!0,description:`Media slot; people serve photo.`,schemaRef:`MediaSlot`,schemaType:`string`,schemaEnum:[`logo`,`photo`,`thumbnail`]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/media/upload`,schemaName:`MediaUploadSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`media`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listPersonRepositories`,method:`GET`,path:`/v1/people/{personId}/repositories`,resource:`people`,intent:`read`,summary:`List a person's GitHub repositories`,description:`Returns the person's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the repositories`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:50},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/github/repo`,schemaName:`GithubRepoSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`repositories`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonSimilarPeople`,method:`GET`,path:`/v1/people/{personId}/similar`,resource:`people`,intent:`read`,summary:`List people similar to one person`,description:`Returns people similar to the person at this address. Rows carry the person shape and per-row similarity provenance; load full detail through the person read endpoint. Results are ordered by similarity score (highest first). This endpoint does not support custom sorting. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person unique identifier (UUID)`,schemaType:`string`,schemaFormat:`uuid`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Permit monogram fallback`,schemaType:`boolean`},{name:`X-Request-Origin`,inputName:`xRequestOrigin`,in:`header`,required:!1,description:`Attribution token identifying the requesting surface; metrics-only`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:10}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/person/similarity-result`,schemaName:`PersonSimilarityResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`similar`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonTexts`,method:`GET`,path:`/v1/people/{personId}/texts`,resource:`people`,intent:`read`,summary:`List text about a person`,description:`Returns paginated text rows owned by the person. Inactive rows require read auth.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the text rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include inactive text rows`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/text`,schemaName:`EntityTextSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonText`,method:`GET`,path:`/v1/people/{personId}/texts/{textId}`,resource:`people`,intent:`read`,summary:`Get one piece of text about a person`,description:`Returns one person-owned text row by id. Requires read auth.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the text row`,schemaType:`string`,schemaFormat:`uuid`},{name:`textId`,inputName:`textId`,in:`path`,required:!0,description:`Text row id`,schemaType:`integer`,schemaFormat:`int64`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/text`,schemaName:`EntityTextSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonUniqueIds`,method:`GET`,path:`/v1/people/{personId}/unique-ids`,resource:`people`,intent:`read`,summary:`List a person's identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:50},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getPersonUniqueId`,method:`GET`,path:`/v1/people/{personId}/unique-ids/{uniqueIdId}`,resource:`people`,intent:`read`,summary:`Get one person identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`uniqueIdId`,inputName:`uniqueIdId`,in:`path`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listPersonUrls`,method:`GET`,path:`/v1/people/{personId}/urls`,resource:`people`,intent:`read`,summary:`List person URLs`,description:`Returns paged primary current URL rows owned by a person. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,security:[],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the URL rows`,schemaType:`string`,schemaFormat:`uuid`},{name:`includeInactive`,inputName:`includeInactive`,in:`query`,required:!1,description:`Include secondary active and inactive/historical URL rows`,schemaType:`boolean`,schemaDefault:!1},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:25},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/url-link`,schemaName:`EntityUrlLinkSchema`},{status:`400`,description:`Bad Request`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonUrl`,method:`GET`,path:`/v1/people/{personId}/urls/{urlId}`,resource:`people`,intent:`read`,summary:`Get one person URL`,description:`Returns one person-owned URL row by id. Requires read auth.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`personId`,inputName:`personId`,in:`path`,required:!0,description:`Person UUID owning the URL row`,schemaType:`string`,schemaFormat:`uuid`},{name:`urlId`,inputName:`urlId`,in:`path`,required:!0,description:`URL link id`,schemaType:`integer`,schemaFormat:`int64`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/url-link`,schemaName:`EntityUrlLinkSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listProvenance`,method:`GET`,path:`/v1/provenance`,resource:`provenance`,intent:`read`,summary:`List where a record's data came from`,description:`Returns paginated field-level provenance rows ordered by effectiveAt DESC. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`tableName`,inputName:`tableName`,in:`query`,required:!0,description:"Tracked resource. Canonical form is the camelCase wire token (e.g. `entity`, `newsArticle`); the legacy Postgres table name (`res_entity`) is still accepted for backwards compatibility.",schemaRef:`DatasourceTrackedProvenanceTable`,schemaType:`string`,schemaEnum:[`entity`,`person`,`newsArticle`,`entityPersonJoin`,`newsArticleEntityJoin`,`newsArticlePersonJoin`,`entityRelationship`,`entityTypeJoin`,`entityAddressJoin`,`entityClassificationJoin`,`entityDetail`,`entityResearchSnippets`,`personAddressJoin`,`fundraiseTransaction`,`fundraiseTransactionInvestorJoin`,`text`,`urlLink`,`deployTarget`]},{name:`recordId`,inputName:`recordId`,in:`query`,required:!1,description:`Record key of the tracked row (text)`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:25}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/datasource/field-provenance`,schemaName:`DatasourceFieldProvenanceSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`provenance`,intent:`read`,cliPath:[`provenance`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getLatestSource`,method:`GET`,path:`/v1/provenance/latest`,resource:`provenance`,intent:`read`,summary:`Get the newest source for a record`,description:`Returns the most recent provenance row for a tracked record. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`tableName`,inputName:`tableName`,in:`query`,required:!0,description:"Tracked resource. Canonical form is the camelCase wire token (e.g. `entity`, `newsArticle`); the legacy Postgres table name (`res_entity`) is still accepted for backwards compatibility.",schemaRef:`DatasourceTrackedProvenanceTable`,schemaType:`string`,schemaEnum:[`entity`,`person`,`newsArticle`,`entityPersonJoin`,`newsArticleEntityJoin`,`newsArticlePersonJoin`,`entityRelationship`,`entityTypeJoin`,`entityAddressJoin`,`entityClassificationJoin`,`entityDetail`,`entityResearchSnippets`,`personAddressJoin`,`fundraiseTransaction`,`fundraiseTransactionInvestorJoin`,`text`,`urlLink`,`deployTarget`]},{name:`recordId`,inputName:`recordId`,in:`query`,required:!1,description:`Record key of the tracked row (text)`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/datasource/source-metadata`,schemaName:`DatasourceSourceMetadataSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`provenance`,intent:`read`,cliPath:[`provenance`,`latest`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getProvenance`,method:`GET`,path:`/v1/provenance/{provenanceId}`,resource:`provenance`,intent:`read`,summary:`Get one recorded source for a field`,description:`Returns one field-level provenance row by its surrogate id, in the same shape the entities provenance list returns. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`provenanceId`,inputName:`provenanceId`,in:`path`,required:!0,description:`Provenance row surrogate id`,schemaType:`integer`,schemaFormat:`int64`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/datasource/field-provenance`,schemaName:`DatasourceFieldProvenanceSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`provenance`,intent:`read`,cliPath:[`provenance`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getResolvedHandle`,method:`GET`,path:`/v1/resolve/{token}`,resource:`resolve`,intent:`read`,summary:`Deprecated: find the record behind an id, slug, or URL`,description:`Deprecated: use lookup (GET /v1/lookup?token=). Resolve any identifier token to its canonical entity or person. Tries UUID, then the stable public handle, then external registry ids, then the slug (with redirects). Returns 404 when nothing matches and 409 when an external id maps to multiple owners.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`token`,inputName:`token`,in:`path`,required:!0,description:`Any identifier: a stable public handle (e.g. eV1StGXR8Z5a), a UUID, an external registry id (ticker, LEI, EIN, ...), or a slug.`,schemaType:`string`}],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/resolved/handle`,schemaName:`ResolvedHandleSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`404`,description:`Not Found`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`resolve`,intent:`read`,cliPath:[`resolve`,`get`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`searchAll`,method:`POST`,path:`/v1/search/all`,resource:`search`,intent:`search`,summary:`Search companies, people, and news together`,description:`Searches enriched details across our company and people dataset from a plain-English query. Runs the canonical entity, person, and news search engines sequentially and returns their typed result pages with per-scope strategy provenance. Supports only auto and keyword modes; unsupported modes are rejected before any scope runs. Page and size apply to every scope; cross-domain sort is not supported.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`}],requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,inputName:`mode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`model`,inputName:`model`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`query`,inputName:`query`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`Ranked matches across every federated record type.`,schemaImport:`@aventurevc/api-schemas/federated/search`,schemaName:`FederatedSearchSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription does not include this search.`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],projection:{resource:`search`,intent:`search`,cliPath:[`search`,`all`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchLink`,method:`GET`,path:`/v1/search/link`,resource:`search`,intent:`search`,summary:`Search from a page URL`,description:`Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns 503, never an empty result. For direct URL-to-record identity resolution use the entities lookup operation with the url instead.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`url`,inputName:`url`,in:`query`,required:!0,description:`Public article or page URL to search from`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`Records reachable from the submitted link.`,schemaImport:`@aventurevc/api-schemas/link/search`,schemaName:`LinkSearchSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription does not include this search.`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],projection:{resource:`search`,intent:`search`,cliPath:[`search`,`link`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`searchNaturalEntities`,method:`POST`,path:`/v1/search/natural/entities`,resource:`search`,intent:`search`,summary:`Find companies, startups, and investors in natural language`,description:"Translate a plain-English company, startup, investor, investment firm, or investment manager search into the canonical EntityFilter contract, execute the existing entity list engine, and return both the interpretation and ranked entity list page. Unsupported constraints are named in the interpretation instead of being silently ignored. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset. CLI: search natural entities `--query` 'AI infrastructure companies founded since 2020' `--size` 3. The query accepts plain English; `--size` limits the page, `--page` starts at 0, and `--year-founded-range-min` 2020 imposes a hard founding-year constraint. Use `--include-private` false for publicly visible results and search natural entities `--help` for all available flags.",security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`When false, generated monogram logos are stripped from entity rows.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/natural-search`,schemaName:`EntityNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.acceleratorBrand`,inputName:`filterAcceleratorBrand`,in:`body`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorCohort`,inputName:`filterAcceleratorCohort`,in:`body`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorName`,inputName:`filterAcceleratorName`,in:`body`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.acceleratorStatus`,inputName:`filterAcceleratorStatus`,in:`body`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.affinity`,inputName:`filterAffinity`,in:`body`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.employeeCountRange[].max`,inputName:`filterEmployeeCountRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.employeeCountRange[].min`,inputName:`filterEmployeeCountRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.entityId`,inputName:`filterEntityId`,in:`body`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`filter.entityName`,inputName:`filterEntityName`,in:`body`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.featured`,inputName:`filterFeatured`,in:`body`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`},{name:`filter.fundraiseActivity.amountInvestedRange[].max`,inputName:`filterFundraiseActivityAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountInvestedRange[].min`,inputName:`filterFundraiseActivityAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountRaisedRange[].max`,inputName:`filterFundraiseActivityAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.amountRaisedRange[].min`,inputName:`filterFundraiseActivityAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investedCompanyName`,inputName:`filterFundraiseActivityInvestedCompanyName`,in:`body`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`filterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`filterFundraiseActivityInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,inputName:`filterFundraiseActivityInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,inputName:`filterFundraiseActivityInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.lastRoundYearRange[].max`,inputName:`filterFundraiseActivityLastRoundYearRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.lastRoundYearRange[].min`,inputName:`filterFundraiseActivityLastRoundYearRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.fundraiseActivity.round`,inputName:`filterFundraiseActivityRound`,in:`body`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.fundraiseActivity.totalRaisedRange[].max`,inputName:`filterFundraiseActivityTotalRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.totalRaisedRange[].min`,inputName:`filterFundraiseActivityTotalRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.valuationRange[].max`,inputName:`filterFundraiseActivityValuationRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.fundraiseActivity.valuationRange[].min`,inputName:`filterFundraiseActivityValuationRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.hasFundraising`,inputName:`filterHasFundraising`,in:`body`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`},{name:`filter.headquartersCity`,inputName:`filterHeadquartersCity`,in:`body`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.headquartersCountry`,inputName:`filterHeadquartersCountry`,in:`body`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.headquartersState`,inputName:`filterHeadquartersState`,in:`body`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.industry`,inputName:`filterIndustry`,in:`body`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.letter`,inputName:`filterLetter`,in:`body`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`filter.location`,inputName:`filterLocation`,in:`body`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.logoOption.sortPriority`,inputName:`filterLogoOptionSortPriority`,in:`body`,required:!1,description:`Logo sort priority.`,schemaType:`string`,schemaEnum:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`]},{name:`filter.mainProduct`,inputName:`filterMainProduct`,in:`body`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.operatingStatus`,inputName:`filterOperatingStatus`,in:`body`,required:!1,description:`Operating states to include; omit to include every state.`,schemaType:`array`,itemSchemaRef:`EntityOperatingStatus`,itemSchemaType:`string`,itemSchemaEnum:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`]},{name:`filter.person`,inputName:`filterPerson`,in:`body`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersCity`,inputName:`filterPortfolioHeadquartersCity`,in:`body`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersCountry`,inputName:`filterPortfolioHeadquartersCountry`,in:`body`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.portfolioHeadquartersState`,inputName:`filterPortfolioHeadquartersState`,in:`body`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.qualityGate`,inputName:`filterQualityGate`,in:`body`,required:!1,description:`Named server-owned list quality gate.`,schemaRef:`EntityListQualityGate`,schemaType:`string`,schemaEnum:[`NONE`,`COMPANY_LISTING_READY`]},{name:`filter.slug`,inputName:`filterSlug`,in:`body`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.stage`,inputName:`filterStage`,in:`body`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.suppressNonOperating`,inputName:`filterSuppressNonOperating`,in:`body`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`},{name:`filter.suppressZeroTotalRaised`,inputName:`filterSuppressZeroTotalRaised`,in:`body`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`},{name:`filter.tag`,inputName:`filterTag`,in:`body`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.textSearch`,inputName:`filterTextSearch`,in:`body`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`},{name:`filter.typeCustomer`,inputName:`filterTypeCustomer`,in:`body`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeModel`,inputName:`filterTypeModel`,in:`body`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeOwnership`,inputName:`filterTypeOwnership`,in:`body`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeRecord`,inputName:`filterTypeRecord`,in:`body`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`filter.typeRevenue`,inputName:`filterTypeRevenue`,in:`body`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.typeTechnologyUsed`,inputName:`filterTypeTechnologyUsed`,in:`body`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.url`,inputName:`filterUrl`,in:`body`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`},{name:`filter.urlDomain`,inputName:`filterUrlDomain`,in:`body`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`},{name:`filter.urlMatchMode`,inputName:`filterUrlMatchMode`,in:`body`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain.`,schemaRef:`UrlMatchMode`,schemaType:`string`,schemaEnum:[`hostPath`,`domain`]},{name:`filter.urlType`,inputName:`filterUrlType`,in:`body`,required:!1,description:`Restrict URL matching to one URL type.`,schemaRef:`EntityUrlType`,schemaType:`string`,schemaEnum:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`)},{name:`filter.yearFoundedRange[].max`,inputName:`filterYearFoundedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.yearFoundedRange[].min`,inputName:`filterYearFoundedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`search.mode`,inputName:`searchMode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`search.model`,inputName:`searchModel`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`search.query`,inputName:`searchQuery`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`Ranked entity matches for the interpreted query.`,schemaImport:`@aventurevc/api-schemas/natural/search-result`,schemaName:`NaturalSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription does not include this search.`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],projection:{resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`entities`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`searchNaturalPeople`,method:`POST`,path:`/v1/search/natural/people`,resource:`search`,intent:`search`,summary:`Find people with natural language`,description:`Translate a plain-English people search into the canonical PersonFilter contract, execute the existing people list engine, and return both the interpretation and ranked people page. Broad role and profile requests use person semantic search. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`When false, generated monogram pictures are stripped from person rows.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap people when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:40},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/natural-search`,schemaName:`PersonNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.arrayFilter.amountInvestedRange[].max`,inputName:`filterArrayFilterAmountInvestedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountInvestedRange[].min`,inputName:`filterArrayFilterAmountInvestedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountRaisedRange[].max`,inputName:`filterArrayFilterAmountRaisedRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.amountRaisedRange[].min`,inputName:`filterArrayFilterAmountRaisedRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.arrayFilter.entityName`,inputName:`filterArrayFilterEntityName`,in:`body`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.investedCompany`,inputName:`filterArrayFilterInvestedCompany`,in:`body`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.personTitle`,inputName:`filterArrayFilterPersonTitle`,in:`body`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.round`,inputName:`filterArrayFilterRound`,in:`body`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.arrayFilter.totalInvestmentCount[].max`,inputName:`filterArrayFilterTotalInvestmentCountMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.arrayFilter.totalInvestmentCount[].min`,inputName:`filterArrayFilterTotalInvestmentCountMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.arrayFilter.typeRecord`,inputName:`filterArrayFilterTypeRecord`,in:`body`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`filter.entityId`,inputName:`filterEntityId`,in:`body`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`},{name:`filter.entitySlug`,inputName:`filterEntitySlug`,in:`body`,required:!1,description:`Associated entity slug.`,schemaType:`string`},{name:`filter.firstName`,inputName:`filterFirstName`,in:`body`,required:!1,description:`Person first name.`,schemaType:`string`},{name:`filter.includeAddress`,inputName:`filterIncludeAddress`,in:`body`,required:!1,description:`Include addresses on each person`,schemaType:`boolean`},{name:`filter.includeUrl`,inputName:`filterIncludeUrl`,in:`body`,required:!1,description:`Include URL links on each person`,schemaType:`boolean`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityAverageAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityAverageAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityLargestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityLargestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivitySmallestAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivitySmallestAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].max`,inputName:`filterInvestorActivityTotalAmountInvestedUsdRangeMax`,in:`body`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].min`,inputName:`filterInvestorActivityTotalAmountInvestedUsdRangeMin`,in:`body`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`},{name:`filter.investorActivity.totalInvestmentRange[].max`,inputName:`filterInvestorActivityTotalInvestmentRangeMax`,in:`body`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.investorActivity.totalInvestmentRange[].min`,inputName:`filterInvestorActivityTotalInvestmentRangeMin`,in:`body`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`},{name:`filter.isCurrent`,inputName:`filterIsCurrent`,in:`body`,required:!1,description:`Filter current associations.`,schemaType:`boolean`},{name:`filter.lastName`,inputName:`filterLastName`,in:`body`,required:!1,description:`Person last name.`,schemaType:`string`},{name:`filter.letter`,inputName:`filterLetter`,in:`body`,required:!1,description:`First-name initial.`,schemaType:`string`},{name:`filter.personId`,inputName:`filterPersonId`,in:`body`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,itemSchemaFormat:`uuid`},{name:`filter.personName`,inputName:`filterPersonName`,in:`body`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`},{name:`filter.role`,inputName:`filterRole`,in:`body`,required:!1,description:`Associated entity role or title.`,schemaType:`string`},{name:`filter.search`,inputName:`filterSearch`,in:`body`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`},{name:`filter.semanticQuery`,inputName:`filterSemanticQuery`,in:`body`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`},{name:`filter.status`,inputName:`filterStatus`,in:`body`,required:!1,description:`Person workflow status.`,schemaType:`string`},{name:`search.mode`,inputName:`searchMode`,in:`body`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`.",schemaRef:`SearchMode`,schemaType:`string`,schemaDefault:`auto`,schemaEnum:[`auto`,`exact`,`keyword`,`semantic`,`natural`]},{name:`search.model`,inputName:`searchModel`,in:`body`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`},{name:`search.query`,inputName:`searchQuery`,in:`body`,required:!0,description:`Plain-English search request.`,schemaType:`string`}]}],response:[{status:`200`,description:`Ranked person matches for the interpreted query.`,schemaImport:`@aventurevc/api-schemas/person/natural-search-result`,schemaName:`PersonNaturalSearchResultSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`402`,description:`The authenticated caller's subscription does not include this search.`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],projection:{resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`people`],scope:`read`,auth:`read`,stdinBody:!0,destructive:!1}},{operationId:`lookupSecCompany`,method:`GET`,path:`/v1/sec/company`,resource:`sec`,intent:`lookup`,summary:`Get SEC EDGAR facts for a public company`,description:`Resolves a publicly traded US company by ticker (preferred) or company-name query. Returns the SEC EDGAR identity facts: legal name, former names, ticker, exchange, SIC industry, state of incorporation, headquarters, and whether it is an operating company. SEC supplies no brand name, website, or summary text — those stay enrichment-owned and are absent here. A 404 means the query matched no SEC registrant (e.g. a private company). Read live and never persisted.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`ticker`,inputName:`ticker`,in:`query`,required:!1,description:`Trading ticker symbol (preferred resolver)`,schemaType:`string`},{name:`name`,inputName:`name`,in:`query`,required:!1,description:`Company name query (used when no ticker is given)`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/sec/company`,schemaName:`SecCompanySchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sec`,intent:`lookup`,cliPath:[`sec`,`company`,`lookup`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listSitemapEntities`,method:`GET`,path:`/v1/sitemap/entities`,resource:`sitemap`,intent:`read`,summary:`Paginated thin entity directory`,description:`Large paginated list serving front-end directory and sitemap traversal; not an enrichment read or write surface. Returns thin Entity rows newest updatedAt first, filtered only by typeRecord and letter. totalElements counts every match; offset pages stop at 5000 rows, so follow X-Next-Cursor for deep traversal. Sort is fixed.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Entity types to include. Repeat for multiple types.`,schemaType:`array`,itemSchemaRef:`EntityType`,itemSchemaType:`string`,itemSchemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`letter`,inputName:`letter`,in:`query`,required:!1,description:`First letter of the display name.`,schemaType:`string`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Cursor for pagination (format: timestamp::uuid)`,schemaType:`string`},{name:`permitMonogram`,inputName:`permitMonogram`,in:`query`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`},{name:`includePrivate`,inputName:`includePrivate`,in:`query`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/entity`,schemaName:`EntitySchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntitySitemapBoundaries`,method:`GET`,path:`/v1/sitemap/entities/boundaries`,resource:`sitemap`,intent:`read`,summary:`Entity sitemap boundaries`,description:`Per-page boundary timestamps for entity sitemap index generation. Front-end sitemap.xml consumer metadata over large URL inventories; not an enrichment read or write surface.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!0,description:`Entity type filter (Company, Investment Firm, etc.)`,schemaType:`array`,itemSchemaType:`string`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; only 5000 is supported.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/location/sitemap-boundary-detail`,schemaName:`LocationSitemapBoundaryDetailSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`boundaries`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntityLetterCounts`,method:`GET`,path:`/v1/sitemap/entities/letter-counts`,resource:`sitemap`,intent:`read`,summary:`Entity letter counts`,description:`Returns available entity initials and counts scoped by typeRecord. Front-end directory-browse projection over the full entity inventory; not an enrichment read or write surface.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!1,description:`Filter by entity type (Company, Investment Firm, etc.)`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/letter/counts`,schemaName:`LetterCountsSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`letter-counts`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntitySitemapRoutes`,method:`GET`,path:`/v1/sitemap/entities/routes`,resource:`sitemap`,intent:`read`,summary:`Paginated sitemap-routes projection for an entity type`,description:`Large paginated list serving front-end sitemap.xml generation; not an enrichment read or write surface. Returns thin Entity rows enriched with EntitySitemap gate booleans plus a bounded list of product/service child slugs; one row per company. Eligibility for /analysis, /fundraising, /employees, /news, and /products-services/{slug} is served from a materialized projection refreshed asynchronously after writes, so rows are eventually consistent and can lag a recent relationship or visibility change.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!0,description:`Entity type whose sitemap rows to list.`,schemaRef:`EntityType`,schemaType:`string`,schemaEnum:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`]},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Cursor for pagination (format: timestamp::uuid)`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:5e3}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/entity`,schemaName:`EntitySchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`routes`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listEntitySitemapUrls`,method:`GET`,path:`/v1/sitemap/entities/urls`,resource:`sitemap`,intent:`read`,summary:`Paginated sitemap URL slots for entity types`,description:`Large paginated list serving front-end sitemap.xml generation; not an enrichment read or write surface. Returns one row per concrete entity URL; the slot path and lastmod come from a materialized projection refreshed asynchronously after writes, so rows are eventually consistent. XML page limits count URLs, not parent entities.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!0,description:`Entity type filters whose sitemap URLs to list. Repeat for multiple types.`,schemaType:`array`,itemSchemaType:`string`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Cursor for pagination (format: timestamp::slotKey)`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:5e3}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/entity/sitemap-url`,schemaName:`EntitySitemapUrlSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`urls`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getEntitySitemapUrlBoundaries`,method:`GET`,path:`/v1/sitemap/entities/urls/boundaries`,resource:`sitemap`,intent:`read`,summary:`Entity sitemap URL boundaries`,description:`Per-page URL-slot boundary timestamps for entity sitemap XML generation. Front-end sitemap.xml consumer metadata over large URL inventories; not an enrichment read or write surface.`,security:[],parameter:[{name:`typeRecord`,inputName:`typeRecord`,in:`query`,required:!0,description:`Entity type filter (Company, Investment Firm, etc.)`,schemaType:`array`,itemSchemaType:`string`},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; only 5000 is supported.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/location/sitemap-boundary-detail`,schemaName:`LocationSitemapBoundaryDetailSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`entities`,`urls`,`boundaries`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getSitemapIndexManifest`,method:`GET`,path:`/v1/sitemap/index-manifest`,resource:`sitemap`,intent:`read`,summary:`Sitemap index manifest`,description:`O(1) manifest of every dynamic sitemap family with its index path, index path mode, eligible URL count, derived page count, latest timestamp, change frequency, and priority. Front-end sitemap.xml consumer metadata; not an enrichment read or write surface.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/sitemap/index-manifest`,schemaName:`SitemapIndexManifestSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`index-manifest`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getNewsSitemapBoundaries`,method:`GET`,path:`/v1/sitemap/news/boundaries`,resource:`sitemap`,intent:`read`,summary:`News sitemap boundaries`,description:`Per-page boundary timestamps for news sitemap index generation. Front-end sitemap.xml consumer metadata over large URL inventories; not an enrichment read or write surface.`,security:[],parameter:[{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; only 5000 is supported.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/location/sitemap-boundary-detail`,schemaName:`LocationSitemapBoundaryDetailSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`news`,`boundaries`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getNewsLetterCounts`,method:`GET`,path:`/v1/sitemap/news/letter-counts`,resource:`sitemap`,intent:`read`,summary:`News author letter counts`,description:`Returns available news author initials and counts. Front-end directory-browse projection over the full news-author inventory; not an enrichment read or write surface.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/letter/counts`,schemaName:`LetterCountsSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`news`,`letter-counts`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonSitemapBoundaries`,method:`GET`,path:`/v1/sitemap/people/boundaries`,resource:`sitemap`,intent:`read`,summary:`Person sitemap boundaries`,description:`Per-page boundary timestamps for person sitemap index generation. Front-end sitemap.xml consumer metadata over large URL inventories; not an enrichment read or write surface.`,security:[],parameter:[{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned; only 5000 is supported.`,schemaType:`integer`,schemaFormat:`int32`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/location/sitemap-boundary-detail`,schemaName:`LocationSitemapBoundaryDetailSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`people`,`boundaries`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getPersonLetterCounts`,method:`GET`,path:`/v1/sitemap/people/letter-counts`,resource:`sitemap`,intent:`read`,summary:`People letter counts`,description:`Returns available people initials and counts. Front-end directory-browse projection over the full people inventory; not an enrichment read or write surface.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/letter/counts`,schemaName:`LetterCountsSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`people`,`letter-counts`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listSitemapUrlSlots`,method:`GET`,path:`/v1/sitemap/url-slots`,resource:`sitemap`,intent:`read`,summary:`Paginated sitemap URL slots`,description:`Returns backend-owned URL slots for people, news, people image, and company image sitemaps. Large paginated list serving front-end sitemap.xml generation; not an enrichment read or write surface.`,security:[],parameter:[{name:`family`,inputName:`family`,in:`query`,required:!0,description:`Sitemap family to list, for example person or personImage.`,schemaType:`string`},{name:`cursor`,inputName:`cursor`,in:`query`,required:!1,description:`Cursor for pagination (format: timestamp::slotKey)`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaFormat:`int32`,schemaDefault:5e3}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/sitemap/url-slot`,schemaName:`SitemapUrlSlotSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`url-slots`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`getSitemapUrlSlotBoundaries`,method:`GET`,path:`/v1/sitemap/url-slots/boundaries`,resource:`sitemap`,intent:`read`,summary:`Sitemap URL-slot boundaries`,description:`O(1) page boundaries for canonical 5000-row sitemap URL-slot families. Front-end sitemap.xml consumer metadata; not an enrichment read or write surface.`,security:[],parameter:[{name:`family`,inputName:`family`,in:`query`,required:!0,description:`Sitemap family to summarize, for example news or companyImage.`,schemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/location/sitemap-boundary-detail`,schemaName:`LocationSitemapBoundaryDetailSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`sitemap`,intent:`read`,cliPath:[`sitemap`,`url-slots`,`boundaries`,`get`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listSlugRedirects`,method:`GET`,path:`/v1/slug-redirects`,resource:`slug-redirects`,intent:`read`,summary:`List a record's slug redirects`,description:`Lists redirects whose newUrl targets the record's current public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT; blog and content redirects answer 403 unless the caller may view private records.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`resourceType`,inputName:`resourceType`,in:`query`,required:!0,description:`Type of the record whose redirects are listed`,schemaRef:`SlugResource`,schemaType:`string`,schemaEnum:[`entity`,`person`,`news`,`blog`,`content`]},{name:`resourceId`,inputName:`resourceId`,in:`query`,required:!0,description:`Record id: entity or person UUID, or news, blog, or page id`,schemaType:`string`},{name:`page`,inputName:`page`,in:`query`,required:!1,description:`Zero-based page index (0..N)`,schemaType:`integer`,schemaDefault:0},{name:`size`,inputName:`size`,in:`query`,required:!1,description:`The size of the page to be returned`,schemaType:`integer`,schemaDefault:20},{name:`sort`,inputName:`sort`,in:`query`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/url/slug-redirect`,schemaName:`UrlSlugRedirectSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`slug-redirects`,intent:`read`,cliPath:[`slug-redirects`,`list`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`lookupSlugRedirectAtRetiredAddress`,method:`GET`,path:`/v1/slug-redirects/lookup`,resource:`slug-redirects`,intent:`lookup`,summary:`Deprecated: resolve slug redirect path`,description:`Deprecated: use lookup slug-redirects (GET /v1/lookup/slug-redirects). Read-only public-path resolver used before front-end page rendering so changed slug, entity-family, and Business Line parent-family URLs return a permanent HTTP redirect to the current canonical public path, while missing slug URLs return a real 404 before the App Router starts streaming. One profile sub-path segment is preserved across family redirects; the front-end owns the tab inventory. Direct product/service alias paths /companies/products-services/{slug} return 204 for a public Product/Service with a non-hidden eligible provider, with curated alias redirect rows taking precedence; a 404 on a slug-backed path can also mean the record exists but is not yet publicly visible. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`path`,inputName:`path`,in:`query`,required:!0,description:`Public site path, such as /companies/old-slug`,schemaType:`string`}],deprecated:!0,response:[{status:`301`,description:`Permanent redirect to the canonical public route.`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`slug-redirects`,intent:`lookup`,cliPath:[`slug-redirects`,`lookup`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`getSystemStatus`,method:`GET`,path:`/v1/status`,resource:`status`,intent:`status`,summary:`Get system uptime`,description:`Returns Better Stack uptime SLA. Public — callable with zero credentials. Local CLI auth provenance is reported by its auth status builtin, which calls this endpoint for uptime and resolves credential sources locally.`,security:[],parameter:[],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/system/status`,schemaName:`SystemStatusSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`status`,intent:`status`,cliPath:[`status`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`lookupUniqueIdAtRetiredAddress`,method:`GET`,path:`/v1/unique-ids/lookup`,resource:`unique-ids`,intent:`lookup`,summary:`Deprecated: look up an identifier owner`,description:`Deprecated: use lookup unique-ids (GET /v1/lookup/unique-ids). Resolves an external identifier to its owner(s). idType accepts a canonical token or alias; the value is normalized per type before matching. Returns every owner that carries the identifier (a value can recur across owners, e.g. a reused ticker), each row carrying its entityId or personId.`,security:[{requirement:{bearerAuth:[]}}],parameter:[{name:`idType`,inputName:`idType`,in:`query`,required:!0,description:`Identifier type token or alias, for example ein.`,schemaType:`string`},{name:`identifier`,inputName:`identifier`,in:`query`,required:!0,description:`Identifier value to resolve.`,schemaType:`string`}],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id`,schemaName:`UniqueIdSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`unique-ids`,intent:`lookup`,cliPath:[`unique-ids`,`lookup`],scope:`read`,auth:`bearer`,stdinBody:!1,destructive:!1}},{operationId:`listUniqueIdTypesAtRetiredAddress`,method:`GET`,path:`/v1/unique-ids/types`,resource:`unique-ids`,intent:`read`,summary:`Deprecated: list the accepted unique identifier types`,description:`Deprecated: use lookup unique-ids types list (GET /v1/lookup/unique-ids/types). Lists the recognized external identifier types (ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid) with each type's label, accepted aliases, owner scope (entity and/or person), and the format pattern a value must match on write.`,security:[],parameter:[],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/unique/id-type-alias`,schemaName:`UniqueIdTypeAliasSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`unique-ids`,intent:`read`,cliPath:[`unique-ids`,`types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`listUrlTypesAtRetiredAddress`,method:`GET`,path:`/v1/url-types`,resource:`url-types`,intent:`read`,summary:`Deprecated: list the accepted values for --url-type`,description:`Deprecated: use lookup url-types list (GET /v1/lookup/url-types). One catalog serves entity and person URL rows.`,security:[],parameter:[],deprecated:!0,response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/url/type-alias`,schemaName:`UrlTypeAliasSchema`},{status:`400`,description:`Bad Request`},{status:`406`,description:`Not Acceptable`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`url-types`,intent:`read`,cliPath:[`url-types`,`list`],scope:`read`,auth:`none`,stdinBody:!1,destructive:!1}},{operationId:`searchWeb`,method:`POST`,path:`/v1/web/search`,resource:`web`,intent:`search`,summary:`Search the live web`,description:`Runs a live web search through SerpAPI, returns a stored result when a fresh version exists, and durably records fresh results in the source-document store. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,security:[{requirement:{bearerAuth:[]}}],parameter:[],requestBody:[{schemaImport:`@aventurevc/api-schemas/search/search`,schemaName:`SearchSchema`,kind:`json`,contentType:`application/json`,description:`Live web search request with cache controls`,required:!0,requiredPath:[`search`],parameter:[{name:`bypassCache`,inputName:`bypassCache`,in:`body`,required:!1,description:`Skip cache lookup and refresh from the search provider`,schemaType:`boolean`,schemaDefault:!1},{name:`cacheKey`,inputName:`cacheKey`,in:`body`,required:!1,description:`Stable lookup text for cache keying when generated search text varies between runs`,schemaType:`string`},{name:`language`,inputName:`language`,in:`body`,required:!1,description:`Search language code`,schemaType:`string`},{name:`region`,inputName:`region`,in:`body`,required:!1,description:`Search region code`,schemaType:`string`},{name:`resultLimit`,inputName:`resultLimit`,in:`body`,required:!1,description:`Maximum number of normalized results to keep`,schemaType:`integer`,schemaFormat:`int32`},{name:`search`,inputName:`search`,in:`body`,required:!0,description:`Search text sent to the upstream web search provider`,schemaType:`string`},{name:`source`,inputName:`source`,in:`body`,required:!1,description:`Optional caller identity for source-document attribution and abuse triage. Any non-blank string up to 64 characters is accepted and persisted with the resolved request context.`,schemaType:`string`}]}],response:[{status:`200`,description:`OK`,schemaImport:`@aventurevc/api-schemas/web/search`,schemaName:`WebSearchSchema`},{status:`400`,description:`Bad Request`},{status:`401`,description:`Unauthorized`},{status:`403`,description:`Forbidden`},{status:`406`,description:`Not Acceptable`},{status:`409`,description:`Conflict`},{status:`415`,description:`Unsupported Media Type`},{status:`422`,description:`Unprocessable Content`},{status:`429`,description:`Too Many Requests`},{status:`500`,description:`Internal Server Error`},{status:`503`,description:`Service Unavailable`}],errorResponse:[],projection:{resource:`web`,intent:`search`,cliPath:[`web`,`search`],scope:`write`,auth:`bearer`,stdinBody:!0,destructive:!1}}],n=new Map(t.flatMap(({operationId:e,response:t})=>{let n=t.find(e=>e.detailField!==void 0)?.detailField;return n===void 0?[]:[[e,new Set(n)]]})),r=!1;function i(e){r=e}function a(e,t){let i=r?void 0:n.get(e??``);if(i===void 0||t===void 0)return{response:t,hiddenNote:[]};let a=new Set,s=o(t,i,``,a),c=[...a].join(`, `);return{response:s,hiddenNote:a.size===0?[]:[`(${a.size} detail fields hidden: ${c}; --all-fields shows them)`]}}function o(e,t,n,r){return Array.isArray(e)?e.map(e=>o(e,t,n,r)):typeof e!=`object`||!e?e:Object.fromEntries(Object.entries(e).flatMap(([e,i])=>{let a=n.length===0?e:`${n}.${e}`;return t.has(a)?(r.add(e),[]):[[e,o(i,t,a,r)]]}))}var s=160;function c(t,n){if(t===null)return``;let r=e(String(t)).replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/gu,` `);return!f(n)&&d(r)?r.slice(0,10):r}function l(e,t){let n=typeof e==`string`&&!f(t)&&d(e)?new Date(e):void 0,r=(n!==void 0&&!Number.isNaN(n.getTime())?`${n.toISOString().slice(0,19)}Z`:c(e,t)).replace(/\s+/g,` `).trim();if(f(t)||r.length<=s)return r;let i=r.length-s,a=u(r)?` of JSON`:``;return`${r.slice(0,s)}... (+${i} chars${a}; narrow the read or use bounded --data-full)`}var u=e=>e.startsWith(`{`)&&e.endsWith(`}`)||e.startsWith(`[`)&&e.endsWith(`]`),d=e=>/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(e),f=e=>/(?:^|\.)[^.]*cursor$/i.test(e?.replace(/\[\d+]/g,``)??``);export{t as a,a as i,c as n,i as r,l as t};