100 lines
5.8 KiB
C++
100 lines
5.8 KiB
C++
#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 <string>
|
|
|
|
#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
|