feat(clients): sessions: Agent Sessions and Memory Bank, discovery-checked call table, guarded purge, live read probes
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,99 @@
|
||||
#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
|
||||
Reference in New Issue
Block a user