#pragma once // The ONE table of every REST call this module makes. Each row is checked // against Google's Discovery document by tools/check_discovery.py (method id, // HTTP verb, path, request schema fields, query parameters), and every // request builder in this module takes its verb and path from here. // // Surface: aiplatform v1beta1. Probed live (2026-10-24): v1 answers 401 // "API keys are not supported" for sessions and memories, v1beta1 accepts an // express API key (404 for a missing engine). See SPEC.md. // // Row: {Call, verb, path template, discovery method (under // aiplatform.projects.locations.reasoningEngines.), request schema suffix // (after GoogleCloudAiplatformV1beta1), request fields used, query params used}. #include #include "clients/client.h" namespace molo::google::sessions { inline constexpr const char* kDiscoveryService = "aiplatform"; inline constexpr const char* kDiscoveryVersion = "v1beta1"; inline constexpr const char* kDiscoveryPrefix = "aiplatform.projects.locations.reasoningEngines."; enum class Call { kSessionCreate, kSessionGet, kSessionList, kSessionPatch, kSessionDelete, kSessionAppendEvent, kSessionCompact, kEventList, kMemoryGenerate, kMemoryRetrieve, kMemoryRetrieveProfiles, kMemoryCreate, kMemoryGet, kMemoryList, kMemoryPatch, kMemoryDelete, kMemoryPurge, kMemoryRollback, kMemoryIngestEvents, kRevisionList, kRevisionGet, kOperationGet, kOperationCancel, kCount }; struct CallSpec { Call call; const char* verb; const char* path; const char* method; const char* request; const char* fields; const char* query; }; // clang-format off inline constexpr CallSpec kCalls[] = { {Call::kSessionCreate, "POST", "/{parent}/sessions", "sessions.create", "Session", "userId displayName labels sessionState ttl", "sessionId"}, {Call::kSessionGet, "GET", "/{name}", "sessions.get", "", "", ""}, {Call::kSessionList, "GET", "/{parent}/sessions", "sessions.list", "", "", "filter orderBy pageSize pageToken"}, {Call::kSessionPatch, "PATCH", "/{name}", "sessions.patch", "Session", "displayName labels sessionState ttl", "updateMask"}, {Call::kSessionDelete, "DELETE", "/{name}", "sessions.delete", "", "", ""}, {Call::kSessionAppendEvent, "POST", "/{name}:appendEvent", "sessions.appendEvent", "SessionEvent", "author invocationId timestamp content actions errorCode errorMessage eventMetadata rawEvent", ""}, {Call::kSessionCompact, "POST", "/{name}:compact", "sessions.compact", "CompactSessionRequest", "compaction", ""}, {Call::kEventList, "GET", "/{parent}/events", "sessions.events.list", "", "", "filter orderBy pageSize pageToken"}, {Call::kMemoryGenerate, "POST", "/{parent}/memories:generate", "memories.generate", "GenerateMemoriesRequest", "scope disableConsolidation allowedTopics vertexSessionSource directContentsSource directMemoriesSource metadata metadataMergeStrategy timeZone revisionLabels revisionTtl revisionExpireTime disableMemoryRevisions", ""}, {Call::kMemoryRetrieve, "POST", "/{parent}/memories:retrieve", "memories.retrieve", "RetrieveMemoriesRequest", "scope filter filterGroups memoryTypes similaritySearchParams simpleRetrievalParams", ""}, {Call::kMemoryRetrieveProfiles, "POST", "/{parent}/memories:retrieveProfiles", "memories.retrieveProfiles", "RetrieveProfilesRequest", "scope", ""}, {Call::kMemoryCreate, "POST", "/{parent}/memories", "memories.create", "Memory", "fact scope displayName description context topics ttl metadata revisionLabels revisionTtl disableMemoryRevisions memoryType structuredContent", "memoryId"}, {Call::kMemoryGet, "GET", "/{name}", "memories.get", "", "", ""}, {Call::kMemoryList, "GET", "/{parent}/memories", "memories.list", "", "", "filter orderBy pageSize pageToken"}, {Call::kMemoryPatch, "PATCH", "/{name}", "memories.patch", "Memory", "fact displayName description context topics ttl metadata revisionLabels revisionTtl disableMemoryRevisions structuredContent", "updateMask"}, {Call::kMemoryDelete, "DELETE", "/{name}", "memories.delete", "", "", ""}, {Call::kMemoryPurge, "POST", "/{parent}/memories:purge", "memories.purge", "PurgeMemoriesRequest", "filter filterGroups force", ""}, {Call::kMemoryRollback, "POST", "/{name}:rollback", "memories.rollback", "RollbackMemoryRequest", "targetRevisionId", ""}, {Call::kMemoryIngestEvents, "POST", "/{parent}/memories:ingestEvents", "memories.ingestEvents", "IngestEventsRequest", "scope streamId forceFlush directContentsSource generationTriggerConfig revisionTtl disableMemoryRevisions revisionLabels metadata metadataMergeStrategy", ""}, {Call::kRevisionList, "GET", "/{parent}/revisions", "memories.revisions.list", "", "", "filter pageSize pageToken"}, {Call::kRevisionGet, "GET", "/{name}", "memories.revisions.get", "", "", ""}, {Call::kOperationGet, "GET", "/{name}", "operations.get", "", "", ""}, {Call::kOperationCancel, "POST", "/{name}:cancel", "operations.cancel", "", "", ""}, }; // clang-format on inline const CallSpec& spec_of(Call call) { for (const CallSpec& row : kCalls) if (row.call == call) return row; return kCalls[0]; // Unreachable: every enumerator has a row (tested). } inline clients::Method verb_of(const CallSpec& spec) { std::string v = spec.verb; if (v == "POST") return clients::Method::kPost; if (v == "PATCH") return clients::Method::kPatch; if (v == "DELETE") return clients::Method::kDelete; return clients::Method::kGet; } // Substitutes the single {parent} or {name} placeholder with a validated // resource name and appends an encoded query string. inline std::string expand(Call call, const std::string& resource, const std::string& query = "") { std::string path = spec_of(call).path; std::size_t open = path.find('{'); std::size_t close = path.find('}'); return path.substr(0, open) + resource + path.substr(close + 1) + query; } } // namespace molo::google::sessions