package notebooklm.v1alpha1
Get desktop application:
View/edit binary Protocol Buffers messages
InteractionEventService records UI interactions that do not mutate the artifact itself. The binding and method name are taken from the production JavaScript descriptor for HpN0Ub.
message
orchestration.proto:1924LogInteractionEventRequest is the HpN0Ub request. The UI uses distinct positional event fields for different artifact interactions; each carries the affected artifact ID in a one-element message.
optional context = 1
optional event_2 = 2
optional event_3 = 3
optional event_4 = 4
rpc DeleteGuidebook (, )
sharing.proto:306Guidebook operations
message
sharing.proto:185string guidebook_id = 1
rpc GetGuidebook (, )
sharing.proto:310message
sharing.proto:189string guidebook_id = 1
rpc GetGuidebookDetails (, )
sharing.proto:322message
sharing.proto:218string guidebook_id = 1
message
sharing.proto:222optional guidebook = 1
repeated sections = 2
optional analytics = 3
message
sharing.proto:251string guidebook_id = 1
string question = 2
optional settings = 3
message
sharing.proto:263string answer = 1
repeated sources = 2
float confidence_score = 3
message
sharing.proto:193int32 page_size = 1
string page_token = 2
message
sharing.proto:198repeated guidebooks = 1
string next_page_token = 2
rpc PublishGuidebook (, )
sharing.proto:318message
sharing.proto:203string guidebook_id = 1
optional settings = 2
message
sharing.proto:213optional guidebook = 1
string public_url = 2
Service definition
rpc ActOnSources (, )
orchestration.proto:1223Source operations
message
orchestration.proto:485ActOnSourcesRequest is the yyryJe chat-query request shape observed in four captures. It is not the legacy three-argument action-verb shape.
repeated source_groups = 1
optional options = 2
optional chat_options = 8
Fields 3 through 7 are null in observed requests.
optional prompt_history = 9
string conversation_id = 10
message
orchestration.proto:522ActOnSourcesResponse carries the observed numeric response value. Its semantics are unconfirmed.
int64 unknown_1 = 1
Source registration for Resumable Upload (rpc.go:31) Request shape, captured from api.Client.registerFileSource (internal/notebooklm/api/client.go:952): [[[filename]], project_id, [2], [1, null × 9, [1]]] The arg_format directive cannot express the deeply-nested wrapper; a custom encoder lives at api.Client.registerFileSource. Returns the server-assigned source_id at response position [0][0][0].
message
orchestration.proto:2825AddFileSource (o4cbdc): register an uploaded file as a notebook source. HAR-verified across two pdf-upload captures (2026-04-19, pdf-upload/, pdf-upload-new/) — both byte-identical for the trailing options blob. Wire request: [[[filename]], project_id, [2], [1, null × 9, [1]]] Position [0] is a 2-level-nested filename list (the inner [filename] is a 1-element list). Position [2] is [2] = source_type=file_upload. Position [3] is the same fixed options blob seen in DeleteArtifact's V5N4be call. See api.Client.registerFileSource (client.go:952).
string project_id = 1
string filename = 2
message
orchestration.proto:2839Wire response (HAR-verified): [[[[source_id], filename, [null, null, null, null, 0]]], null, [[[[source_id], filename, [null, null, null, null, 0]]]]] Positions [0] and [2] both echo the assigned source row; [1] is always null in the captured calls. The inner metadata list at position [2] of each row is [null × 4, status_int=0]. We surface the source_id only.
string source_id = 1
string filename = 2
rpc AddSources (, )
orchestration.proto:1231AddSources (izAoDd). HAR (more-requests3) shows the reply is a list containing the same Source descriptor LoadSource (hizoJc) returns: [ [source_id], title, [source_metadata], [null,2], ... ] not a Project envelope.
message
orchestration.proto:951Update existing request messages to match Gemini's findings
repeated sources = 1
string project_id = 2
optional context = 3
message
orchestration.proto:958AddSourcesResponse is the izAoDd response envelope: [[source, ...]].
repeated sources = 1
BulkImportFromResearch (rpc.go:73). 5-position polymorphic variant of LBwxtb that imports a batch of URL+title pairs from a research session. HAR-verified 2026-04-17 against notebook 00000000-0000-4000-8000-000000000006, conversation 00000000-0000-4000-8000-000000000401, ten URL sources. Request shape (api.bulkImportArgs at client.go:5102): [null, [1], conversation_id, project_id, [source_1, ..., source_N]] Each source tuple is 11-position; encoded by Go helper because arg_format cannot represent the inner [null, null, [url, title], null × 7, 2] tuple shape.
message
orchestration.proto:3035BulkImportFromResearch (LBwxtb, 5-position polymorphic variant). Wire shape: [null, [1], conversation_id, project_id, [source_1, ..., source_N]] HAR captures show two distinct per-source tuple shapes selected by position [10]: URL import (api.bulkImportArgs at client.go:5102, source_type=2): [null, null, [url, title], null × 7, 2] Note/text import (HAR-observed in NotebookLM web UI capture, 2026-04-23, importing a 3.4kB markdown research report, source_type=3): [null, [title, content_markdown], null, 3, null × 5, 3] The Go side currently encodes only the URL variant; the note variant is a follow-up. BulkImportSourceInput carries enough fields to model both — content stays empty for URL imports, url stays empty for note imports.
string project_id = 1
string conversation_id = 2
repeated sources = 3
message
orchestration.proto:3056BulkImportFromResearchWireRequest is the positional note/text import form observed from the web UI. The live URL-import API keeps its logical request type and custom encoder above.
optional context = 1
optional marker = 2
string conversation_id = 3
string project_id = 4
repeated sources = 5
CancelDiscoverSourcesJob (Zbrupe). Cancels an in-flight DiscoverSources / DiscoverSourcesAsync / DiscoverSourcesManifold job. JS-bundle-verified; no HAR yet. TODO(har): trigger by canceling a running fast-research / deep-research / discover-sources flow before completion.
message
orchestration.proto:3730CancelDiscoverSourcesJob (Zbrupe).
string project_id = 1
string job_id = 2
CancelGeneration (XgrPMd). The captured request has a null leading placeholder followed by the generation identifier. The server returns an empty array on success.
message
orchestration.proto:3736CancelGeneration (XgrPMd).
string generation_id = 2
message
orchestration.proto:3740(message has no fields)
message
orchestration.proto:2052optional source = 2
optional context = 3
message
orchestration.proto:2057optional bool is_fresh = 2
optional source = 3
rpc CopyProject (, )
orchestration.proto:1856CopyProject (te3DCe). Duplicates an existing notebook (sources, artifacts, settings) into a new project. Response HAR-observed as a single status int [3]; not consumed by any live caller.
message
orchestration.proto:3889CopyProject (te3DCe). Duplicates a notebook.
optional context = 1
string source_project_id = 2
string new_title = 3
message
orchestration.proto:3899CopyProjectResponse is the te3DCe reply. HAR-observed as a single int [3]; modeled as a status/state code (the copy operation's result). The earlier declared Project return type was an unverified guess and did not match the wire.
optional int64 status = 1
Artifact operations
message
orchestration.proto:430optional context = 1
string project_id = 2
optional artifact = 3
Audio operations
message
orchestration.proto:558string project_id = 1
AudioType audio_type = 2
repeated string source_ids = 3
string custom_instructions = 4
AudioLength length = 5
string language = 6
e.g. "en"
CreateAudioOverview (AHyHrd). The legacy audio-overview creator. The production surface now goes through CreateUniversalArtifact (R7cb6c with kind=2), but a direct AHyHrd path is still wired in api.Client.createAudioOverviewDirectRPC (client.go:1407) as a fallback. JS-bundle-verified; HAR-observed under that fallback.
message
orchestration.proto:3910CreateAudioOverviewLegacy (AHyHrd). Direct-RPC fallback that api.Client.createAudioOverviewDirectRPC still uses; the live UI now goes through R7cb6c. The "Legacy" suffix avoids a name collision with the modern CreateAudioOverview rpc that targets R7cb6c above.
string project_id = 1
int32 audio_type = 2
repeated string instructions = 3
rpc CreateLabel (, )
orchestration.proto:1742CreateLabel / MutateLabel / DeleteLabels — write companions to GetLabels (I3xc3c). All three are bound by the JS bundle but no HAR has been captured yet; trigger by interacting with the labels affordance in the source-list UI.
message
orchestration.proto:3600CreateLabelRequest is the manual-label form of agX4Bc. It also creates a collection, with scope 3 and a null project_id; a collection create may seed the new collection with member notebooks.
optional context = 1
string project_id = 2
optional creation = 6
Fields 3 through 5 are null in observed requests.
optional int32 scope = 7
Observed only as 3, on requests that create a collection. See GetLabelsRequest.scope.
rpc CreateNote (, )
orchestration.proto:1319Note operations
message
orchestration.proto:994CreateNoteRequest also carries the rich-note payload the web UI sends when it saves a note with formatting: grounding details at field 4 and the structured document at field 6, the same two slots the response returns them in. These are decode-only. This RPC's arg_format passes literals rather than the request's own fields, because the live path allocates an empty shell and then fills it in through MutateNote, so nothing here reaches the wire.
string project_id = 1
optional string content = 2
optional note_type = 3
repeated grounding = 4
The request carries the grounding records bare at this position, unlike the response, which wraps them in one more array layer (NoteGroundingDetails). Same element type either way.
string title = 5
optional rich_text = 6
optional context = 7
message
orchestration.proto:2397CreateNoteRichRecord is the CYK0Xb response tuple. It is NoteRecord plus the two rich-note slots: the same grounding-details list and structured document GetNotesRichRecord carries, in the same positions. NoteRecord itself cannot model them because it lives in notebooklm.proto, which this file imports rather than the other way around. Only note_id is read by the live CreateNote path, which allocates a shell and then fills it in through MutateNote; the remaining fields are decode-only.
string note_id = 1
optional string content_text = 2
optional metadata = 3
optional grounding_details = 4
string title = 5
optional rich_text = 6
repeated int32 note_type = 7
Project operations
message
orchestration.proto:1889Request messages reconstructed from captured batchexecute traffic.
string title = 1
string emoji = 2
Decode-complete binding for the polymorphic R7cb6c request envelope.
message
orchestration.proto:577optional context = 1
string project_id = 2
optional options = 3
repeated int32 unknown_6 = 6
Semantics unconfirmed. Observed as [1] on a slide request.
Video operations (uses same R7cb6c RPC as audio but with mode=3)
message
orchestration.proto:568Video overview request (uses same R7cb6c RPC as audio, but with mode=3 parameter)
string project_id = 1
AudioType audio_type = 2
Content style (only BRIEF=2 observed so far)
repeated string source_ids = 3
string custom_instructions = 4
VideoStyle video_style = 5
Visual presentation style
string language = 6
e.g. "en"
message
orchestration.proto:452string artifact_id = 1
message
orchestration.proto:663string project_id = 1
message
orchestration.proto:2280optional context = 1
Wire format: [%context%, null, %project_id%] Polymorphic endpoint shared with PollDeepResearch
string project_id = 3
DeleteChatTurns is the inferred bundle name for J7Gthc. Captured requests confirm the wire shape and conversation ID; field 4 semantics remain unknown.
message
orchestration.proto:2846DeleteChatTurns is inferred from the bundle binding and the fact that J7Gthc fires before feedback. The observed wire has four positions.
optional options = 1
string conversation_id = 2
int32 unknown_4 = 4
Field 3 is null in observed requests.
semantics unconfirmed
message
orchestration.proto:2853(message has no fields)
DeleteDeepResearch (rpc.go:72). Soft-delete a research session; server transitions state 2 -> 5 (the row is retained, future poll queries skip state=5). HAR-verified 2026-04-17. Polymorphic with BulkImportFromResearch: same LBwxtb id, server discriminates on arg-4 presence (delete = 4-position, bulk-import = 5-position). Request shape (api.deleteDeepResearchArgs at client.go:5034): [null, [1], conversation_id, project_id]
message
orchestration.proto:3006DeleteDeepResearch (LBwxtb, 4-position polymorphic variant). Wire shape: [null, [1], conversation_id, project_id]
string project_id = 1
string conversation_id = 2
message
orchestration.proto:3011empty array on success
(message has no fields)
rpc DeleteLabels (, )
orchestration.proto:1754message
orchestration.proto:3716string project_id = 1
repeated string label_ids = 2
rpc DeleteNotes (, )
orchestration.proto:1326message
orchestration.proto:1007string project_id = 1
repeated string note_ids = 3
optional context = 4
message
orchestration.proto:1894repeated string project_ids = 1
message
orchestration.proto:1898repeated source_ids = 1
optional context = 2
DiscoverSources (Es3dTe). Per the JS bundle binding to /LabsTailwindOrchestrationService.DiscoverSources. The previous rpc_id "qXyaNe" was a speculative inference that does not match any JS bundle entry or HAR capture; corrected to Es3dTe. No HAR yet for the wire shape. arg_format below is a likely shape based on sibling RPCs but is unverified — TODO(har): capture by triggering "Discover sources" from the source-add UI. Note: the related research-flow RPCs (Ljjv0c, QA9ei, e3bVqc, LBwxtb) are bound by the JS bundle to DiscoverSources*-family names (DiscoverSourcesManifold, DiscoverSourcesAsync, ListDiscoverSourcesJob, FinishDiscoverSourcesRun); the "research" feature is layered on top of the DiscoverSources job system.
message
orchestration.proto:667string project_id = 1
string query = 2
message
orchestration.proto:672repeated sources = 1
ExecuteWritingFunction (likKIe). In-document writing assistant — rewrite, expand, summarize a selection inside an artifact. JS-bundle-verified; no HAR. TODO(har): trigger from the artifact editor's writing toolbar.
message
orchestration.proto:3821ExecuteWritingFunction (likKIe). In-document writing assistant.
string project_id = 1
string artifact_id = 2
string selection_text = 3
string function = 4
e.g. "rewrite", "expand", "summarize"
message
orchestration.proto:3828string transformed_text = 1
ExportToDrive (Krh3pd). Pushes notebook artifacts to the user's Drive. JS-bundle-verified; no HAR yet. TODO(har): trigger by clicking "Export to Drive" on a notebook.
message
orchestration.proto:3743ExportToDrive (Krh3pd). wire shape unverified.
string project_id = 1
repeated string artifact_ids = 2
message
orchestration.proto:3748string drive_url = 1
string drive_file_id = 2
FetchInteractivityToken (rpc.go:50). Voice-session auth + ICE server config for the WebRTC interactive-audio mode. Request is the empty payload []. Response is a positional JSON envelope whose [0] field is a JSON-encoded string carrying {lifetimeDuration, iceServers, blockStatus, iceTransportPolicy}. See internal/interactiveaudio/signaling.go:36 and the existing FetchInteractivityTokenRequest/Response messages at line 858+.
message
orchestration.proto:2791FetchInteractivityToken (Of0kDd). HAR-verified (docs/captures/notebooklm.google.com.jsonl:24, 2026-04-06). Request is the empty payload []. Response is a 1-element JSON array whose [0] entry is a JSON-encoded string carrying the WebRTC bootstrap blob: lifetimeDuration, iceServers (STUN+TURN credentials), blockStatus, and iceTransportPolicy. Decoded by interactiveaudio.parseInteractivityTokenResponse (signaling.go:72) which JSON-unmarshals the inner string into a Go-side InteractivityToken struct that mirrors these fields.
optional int32 context_version = 1
optional context_surface = 3
optional context_caps = 4
message
orchestration.proto:2797string lifetime_duration = 1
e.g. "86400s"
repeated ice_servers = 2
string block_status = 3
e.g. "NOT_BLOCKED"
string ice_transport_policy = 4
e.g. "all"
GenerateAccessToken (preRPe). Per-session token mint — likely used by embed widgets or third-party surfaces that need a short-lived credential. JS-bundle-verified; no HAR.
message
orchestration.proto:3862GenerateAccessToken (preRPe) has an empty request and returns [oauth_token, [relative_ttl_seconds], [scope, ...]].
(message has no fields)
message
orchestration.proto:3864string access_token = 1
optional ttl = 2
optional scopes = 3
GenerateArtifact (Rytqqe). Distinct from CreateArtifact (xpWGLf) and CreateUniversalArtifact (R7cb6c). Captured requests carry a context envelope followed by an artifact ID. The operation name is inferred from the bundle; the server-side effect is unconfirmed.
message
orchestration.proto:3724GenerateArtifact (Rytqqe) — distinct from CreateArtifact (xpWGLf) and CreateUniversalArtifact (R7cb6c). The operation name is bundle-derived; captured requests prove only the context and artifact ID positions.
optional context = 1
string artifact_id = 2
GenerateArtifactSuggestions / AudioTopicSuggestions (rpc.go:133). The web UI calls this before R7cb6c (CreateUniversalArtifact) to get a list of AI-generated topic blueprints. Wire format verified against HAR (create-audio, 2026-04-14): [[kind], project_id, [[src1], [src2], ...], variation] Only audio (kind=2) is HAR-verified; video and slide kinds are not covered. The variation int re-rolls suggestions (1, 2, 5, 6 observed). See internal/method/labs_tailwind_artifact_suggestions.go.
message
orchestration.proto:3425GenerateArtifactSuggestions / AudioTopicSuggestions (otmP3b). HAR-verified for kind=2 (audio) via the create-audio capture used for internal/method/labs_tailwind_artifact_suggestions.go (filed 2026-04-14; not present in this repo's docs/captures/ but the encoder is the durable record). Wire request: [[kind], project_id, [[src1], [src2], ...], variation] Wire response: [[[title, description], [title, description], ...]] Each call returns three suggestion pairs. variation is a re-roll seed (1, 2, 5, 6 observed); the UI bumps it on every "refresh" click. Video and slide kinds are not yet HAR-verified.
optional context = 1
string project_id = 2
repeated source_refs = 3
int32 variation = 4
re-roll seed
optional string prompt = 6
Field 5 is null when prompt is present.
message
orchestration.proto:3444repeated suggestions = 1
GenerateDocumentGuides (rpc.go:82). Per-source guide RPC: the wire call is keyed by source_id with a 4-level-nested arg shape [[[[source_id]]]] that the arg_format template cannot express. Invoked via api.Client.GenerateSourceGuide (client.go:3010); response is [[[null, [summary], [[topic, ...]], []]]]. The request message exists at line 709 (GenerateDocumentGuidesRequest).
message
orchestration.proto:2187optional sources = 1
optional context = 2
message
notebooklm.proto:406repeated guides = 1
rpc GenerateFreeFormStreamed (, stream )
orchestration.proto:1386Generation operations Per-source guide generation (tr032e) is not declared here; the wire call is keyed by source_id with a 4-level-nested arg shape that the [%project_id%]-style arg_format cannot express. It's invoked directly via rpc.Do in the api package (see api.Client.GenerateSourceGuide).
message
orchestration.proto:689string project_id = 1
The gRPC-Web endpoint still expects a manually constructed JSON array, but this message mirrors the observed request state on that wire: [ [[[source_ids]]], prompt, history, [mode, null, citation_modes, follow_up_modes], conversation_id, draft_response_id, parent_response_id, notebook_id, sequence_number ]
string prompt = 2
repeated string source_ids = 3
repeated history = 4
optional options = 5
string conversation_id = 6
string draft_response_id = 7
string parent_response_id = 8
string notebook_id = 9
int32 sequence_number = 10
message
orchestration.proto:753string chunk = 1
chunk preserves the cumulative answer text used by existing callers.
bool is_final = 2
is_final mirrors the completion flag at response position [4].
optional conversation = 3
repeated citations = 4
repeated source_mappings = 5
repeated string follow_up_text = 6
repeated follow_ups = 7
rpc GenerateFreeFormStreamedWire (, stream )
orchestration.proto:1402Decode-complete positional binding for captured gRPC-Web request and response frames. The logical method above remains the live API surface.
message
orchestration.proto:765repeated sources = 1
string prompt = 2
repeated history = 3
optional options = 4
string conversation_id = 5
optional string unknown_7 = 7
Field 6 is null in observed requests.
string notebook_id = 8
optional int32 sequence_number = 9
optional unknown_13 = 13
message
orchestration.proto:812optional answer = 1
repeated citations = 2
repeated source_mappings = 3
optional follow_up_text = 4
optional bool is_final = 5
optional follow_ups = 6
optional bool complete = 7
string token = 8
message
notebooklm.proto:657optional context = 1
string project_id = 2
message
notebooklm.proto:681int32 status = 1
captured opaque status code; meaning unconfirmed
message
orchestration.proto:2200string project_id = 1
optional context = 2
message
notebooklm.proto:450optional guide = 1
string guide_id = 2
Guide identifier (UUID).
message
orchestration.proto:2205string project_id = 1
message
notebooklm.proto:486string content = 1
GenerateReportSuggestions (ciyUvf). HAR-verified; see internal/method/LabsTailwindOrchestrationService_GenerateReportSuggestions_encoder.go. GHsKob is a legacy/predecessor id for the same logical RPC. It does not appear in the current JS bundle (boq_labs-tailwind-frontend) and has no observed wire traffic. Treat GHsKob as dead; ciyUvf is the live id.
message
orchestration.proto:843optional context = 1
string project_id = 2
repeated source_ids = 3
message
orchestration.proto:858repeated suggestions = 1
message
orchestration.proto:2209string project_id = 1
message
notebooklm.proto:490string content = 1
rpc GetArtifact (, )
orchestration.proto:1175GetArtifact (v9rmvd) was captured from the live rendering path 2026-07-27. The earlier BnLyuf id was a different, unreachable inference that returned 400. The request uses [artifact_id, context]. The Artifact response carries type-specific fields, including type-4 app data.
message
orchestration.proto:437GetArtifactRequest is [artifact_id, context].
string artifact_id = 1
optional context = 2
GetArtifactUserState (ulBSjf). Read companion to UpsertArtifactUserState (Fxmvse). Both are bound by the JS bundle to /LabsTailwindOrchestrationService.GetArtifactUserState. No standalone HAR observed: the read path is rolled into the gArtLc (ListArtifacts) response — each artifact tuple already carries the saved ArtifactUserState inline at a late field position (the same [[[seconds, nanos]]] shape that Fxmvse upserts). The dedicated ulBSjf read is reserved for hosts that need the per-artifact value without re-listing. TODO(har): capture a direct ulBSjf request to confirm the request body shape; the read response is expected to mirror UpsertArtifactUserStateResponse (a single ArtifactUserState).
message
orchestration.proto:3589GetArtifactUserState (ulBSjf). Read companion to UpsertArtifactUserState (Fxmvse). No HAR observed for the dedicated read path: the value is also returned inline by gArtLc (ListArtifacts) as part of each artifact tuple, and the UI reads it from there. The fields below mirror the HAR-verified write side; the request likely sends only the artifact_id, and the response is expected to wrap a single ArtifactUserState the same way as UpsertArtifactUserStateResponse. TODO(har): capture a standalone ulBSjf request to confirm.
string artifact_id = 1
message
orchestration.proto:3593optional state = 1
GetAudioFormats (rpc.go:89). HAR-verified against captured traffic. Request payload observed verbatim: [[2, null, null, [1, null × 9, [1]], [[1,4,8,10,2,3,6,9]]], null, 1] Returns the audio-overview style menu (Deep Dive, Brief, Critique, Debate). The opaque inner [1, null × 9, [1]] and ordering vector [[1,4,8,10,2,3,6,9]] are bytes captured verbatim; semantics not yet decoded.
message
orchestration.proto:3109GetAudioFormats (sqTeoe). HAR-verified against 11+ captures (notebooklm.google.com.jsonl, 2026-04-19..2026-04-23). Returns the full create-artifact menu — audio styles, video styles, slide styles, AND the prebuilt briefing-doc/study-guide templates. The request is a fixed-sentinel payload (no varying fields), so it has no arg_format. The same RPC powers every "create X" picker the UI shows.
optional context = 1
Wire shape: [[2, null, null, [1, null × 9, [1]], [[1,4,8,10,2,3,6,9]]], null, 1]
optional int32 mode = 3
Field 2 is null in observed requests.
observed 1
message
orchestration.proto:3128Response shape (HAR-verified): four positional entries, each itself wrapped in an extra array layer: [ [<audio_kinds>], // [[id, name, description], ...] [<video_kinds>], [<slide_kinds>], [<doc_templates>], // [[title, subtitle, system_prompt], ...] ] audio/video/slide kinds share the AudioFormat shape; doc templates use the distinct DocTemplate shape. The extra wrapping layer is modeled with one-field list-wrapper messages so a present-but-empty kind round-trips as [] rather than null.
optional audio_kinds = 1
optional video_kinds = 2
optional slide_kinds = 3
optional doc_templates = 4
message
orchestration.proto:658string project_id = 1
int32 request_type = 2
message
orchestration.proto:2268optional context = 1
string conversation_id = 4
optional int32 limit = 5
message
orchestration.proto:2274repeated messages = 1
string cursor = 2
Opaque pagination/resume cursor returned after the message list.
Conversation lifecycle
message
orchestration.proto:2252optional context = 1
Wire format: [%context%, null, %project_id%, %limit%]
string project_id = 3
int32 limit = 4
message
orchestration.proto:2259repeated conversations = 1
Each conversation id arrives wrapped as ["uuid"].
GetDeepResearchSessions (rpc.go:71). Polymorphic with DeleteChatHistory: same e3bVqc id, server discriminates on request payload shape. The deep/fast-session list call uses [null, null, project_id] (api.Client.pollResearch at client.go:4758). Returns ALL deep + fast sessions for the notebook; the caller scans by (research_id, mode=5) for deep or (conversation_id, mode=1) for fast.
message
orchestration.proto:2897GetDeepResearchSessions (e3bVqc, polymorphic with DeleteChatHistory). Wire shape: [null, null, project_id] Response is a list of deep+fast research sessions; clients filter by (research_id, mode=5) for deep or (conversation_id, mode=1) for fast.
string project_id = 1
message
orchestration.proto:2907repeated sessions = 1
rpc GetLabels (, )
orchestration.proto:1697GetLabels (I3xc3c). JS bundle binds this to /LabsTailwindOrchestrationService.GetLabels. HAR-verified across 8+ NotebookLM web UI captures (2026-04-23). Returns the notebook's labels (a.k.a. autolabel/source-grouping clusters): per-label tuples carrying a label, a member source list, and a server-assigned group UUID. Most notebooks return [] (no labels computed yet). Notebooks where the user has invoked autolabel return populated entries. Wire request: [[2], project_id] [0] = [2] is an opaque mode/operation enum (constant across all captures); semantics not yet decoded. Wire response: [] OR [[label, [[src_id], ...], group_uuid, ""], ...] Earlier rounds of this proto called this method GetSourceGroups — the canonical service name (per JS bundle) is GetLabels, and the related operations CreateLabel (agX4Bc), MutateLabel (le8sX), and DeleteLabels (GyzE7e) confirm the labels framing.
message
orchestration.proto:3476GetLabels (I3xc3c). HAR-verified label/autolabel query. The notebook UI fires this on every notebook load to render the source-list section headers; an empty response means the user hasn't yet computed labels for this notebook. GetLabelsRequest carries a trailing scope selector. In the notebook scope the field is absent and project_id names the notebook; in the collections scope the field is 3 and project_id is null, because collections are account-scoped rather than notebook-scoped.
optional context = 1
string project_id = 2
optional int32 scope = 3
Observed only as 3, on requests that read collections. Other values may exist; the numbering is not confirmed to be an enum, so it is kept as a plain int rather than named.
message
orchestration.proto:3493GetLabelsResponse returns rows at a slot that depends on the request scope: field 1 in the notebook scope (13 observed responses) and field 2 in the collections scope (2 observed responses). The row shape is identical, so both are modeled as Label.
repeated labels = 1
repeated collections = 2
rpc GetMagicView (, )
orchestration.proto:1848GetMagicView (rtY7md). Read companion to GenerateMagicView (uK8f7c). JS-bundle-verified; no HAR. TODO(har): trigger by opening a previously-generated Magic View.
message
orchestration.proto:3880GetMagicView (rtY7md). The captured request is [project_id] and the response is a single opaque status code. Its enum meaning is unconfirmed.
string project_id = 1
message
orchestration.proto:3884int32 status = 1
rpc GetNotes (, )
orchestration.proto:1330message
orchestration.proto:1013string project_id = 1
optional since = 3
Field 2 is null in observed requests.
optional context = 4
message
orchestration.proto:2356GetNotesRichWireResponse is the keyed response shape returned by cFji9. The response-side note record differs from the public Note message: rich_text is either a legacy string or a structured RichDocument, and field 4 repeats the document's grounding details without their source-id keys.
repeated entries = 1
optional fetch_time = 2
Account operations
message
orchestration.proto:1049Account management
optional int32 context_version = 1
optional context_surface = 3
optional context_caps = 4
rpc GetProject (, )
orchestration.proto:1351message
orchestration.proto:1903string project_id = 1
optional context = 3
Field 2 is null in observed requests.
optional int32 include_artifacts = 5
Field 4 is null in observed requests.
optional filter = 6
Analytics and feedback
message
orchestration.proto:863string project_id = 1
optional context = 2
optional requested_at = 3
optional mode = 4
message
orchestration.proto:870repeated series = 1
message
orchestration.proto:462ListArtifactsRequest wire (HAR-verified, more-requests2): [<RequestContext>, project_id, "<filter>"] where RequestContext.artifact_types carries the type filter and field 3 is a CEL-ish filter string (e.g. NOT artifact.status = "ARTIFACT_STATUS_SUGGESTED"). The live api.Client.ListArtifacts hand-builds a truncated [[2], project_id] form and does not use this message as an encoder.
optional context = 1
string project_id = 2
string filter = 3
message
orchestration.proto:468repeated artifacts = 1
string next_page_token = 2
ListExpertIntelligenceContent (mVtEUb). Curated featured-content surface. Captured requests use [context, 1]; the second value's semantics are not yet established.
message
orchestration.proto:3833ListExpertIntelligenceContent (mVtEUb). Curated featured surface.
optional context = 1
int32 content_kind = 2
message
orchestration.proto:3838repeated items = 1
string next_page_token = 2
message
orchestration.proto:898optional int32 context_version = 1
optional context_surface = 3
optional context_caps = 4
message
orchestration.proto:946repeated projects = 1
ListModelOptions (EnujNd) has a captured RequestContext request. The captured responses are empty, so option rows remain unmodeled.
message
orchestration.proto:3760ListModelOptions (EnujNd) is captured as [[version, null, surface, caps]].
optional int32 version = 1
optional surface = 3
optional caps = 4
message
orchestration.proto:3766repeated models = 1
message
orchestration.proto:1951ListRecentlyViewedProjectsRequest has two captured wire variants. The live command uses the short [null, 1, null, [2]] form. Full web requests carry [project_id, null, context, null, 0, filter]; older full requests instead put context at field 4 and page 1 at field 2.
string project_id = 1
optional int32 page = 2
observed 1
optional context = 3
optional legacy_context = 4
optional int32 unknown_5 = 5
observed 0
optional filter = 6
message
notebooklm.proto:503repeated projects = 1
rpc LoadSource (, )
orchestration.proto:1270LoadSource (hizoJc) returns a Source descriptor and loaded content. The HAR (more-requests3) source shape is [ [source_id], title, [null, status, [added_ts], [origin_source_id, [origin_ts]], type, null, 1, null, byte_size, null×5, [indexed_ts], null×4, mime_type], [null, 2], null, download_url, viewer_url, ... ] AddSources (izAoDd) returns the same descriptor inside a list.
message
orchestration.proto:2062optional source = 1
optional mode = 2
optional context = 3
message
orchestration.proto:2075LoadSourceResponse is the hizoJc response envelope: [source, null, null, [loaded content]].
optional source = 1
optional content = 4
rpc LogEvent (, )
orchestration.proto:1614LogEvent / GetPromoCampaign (rpc.go:98). The constant in rpc.go is labelled "LogEvent" but HAR evidence (notebooklm.google.com.jsonl hits across 12+ captures spanning 2026-04-19..2026-04-23) shows it is actually a promo/upsell-card placement lookup. The web UI fires it once per page load. Request shape: [[[[null, "1", 627], [null × 9, [null, null, 2]], 1]]] The middle-positional 627 looks like the campaign/promo slot ID; "1" is locale or surface; the [null, null, 2] tail is opaque. Response carries the upsell card payload (icon URL, title, CTA link, the user's tier — e.g. "NOTEBOOKLM_TIER_PRO_CONSUMER_USER"). The Go side does not call this RPC; it is documented here so the proto matches what the wire actually does.
message
orchestration.proto:3184LogEvent (ozz5Z) is a misnomer per rpc.go's constant; the wire RPC is actually a promo/upsell-card placement lookup. HAR-verified across 12+ captures (notebooklm.google.com.jsonl, 2026-04-19..2026-04-23). Wire request: [[[[null, "1", 627], [null × 9, [null, null, 2]], 1]]] 627 is the campaign/slot id (constant across all captures); "1" is locale/surface; the [null, null, 2] tail at position [9] of the inner array is opaque. The whole request is a fixed sentinel — the only varying byte is the f.sid, which lives outside the f.req body. No Go caller invokes this RPC today; the message exists so future regenerated stubs match the wire reality rather than the rpc.go label.
repeated events = 1
message
orchestration.proto:3232Wire response is a repeated array of log-event acknowledgements, one per logged event in the request (observed: always exactly one). Captured layout (HAR-verified across 5 captures, all structurally identical modulo tracking IDs): [[[ [null, "1", 627], // slot [[2230, [null × 9, [[null, "NotebookLM icon", "edit"], [[[null, null, "<settings_url>"], false], null, null, "Manage subscription", null, "Manage subscription", null, null, [<click_event>]]], null × 10, [<impression_event>]], null, 2351, 2351, 2230, "NOTEBOOKLM_TIER_ULTRA_LIGHT_CONSUMER_USER", null, null, false, []]], 0]]] The outer-outer [ ] is the repeated wrapper (LogEventResponse itself); each element is a PromoLogEntry. user_tier (PromoCard field 7) is the only durable, human-meaningful field; everything else is rendering/impression-tracking chrome, but is modeled fully so the response round-trips losslessly.
repeated entries = 1
message
orchestration.proto:1055optional update = 1
optional context = 2
rpc MutateLabel (, )
orchestration.proto:1750message
orchestration.proto:3661MutateLabelRequest wire (HAR-verified, more-requests2): [<RequestContext>, project_id, label_id, [<mutation>]] The live path (api.Client.mutateLabel) hand-builds these args and does not use this message as an encoder, so the layout is decode-only. The mutation block has two observed inner shapes: [[name, emoji]] (rename/emoji) and [null, [[source_id]]] (attach source); the captured request is the latter.
optional context = 1
string project_id = 2
string label_id = 3
optional mutation = 4
optional int32 scope = 5
Observed only as 3, on requests that mutate a collection. See GetLabelsRequest.scope.
message
orchestration.proto:3712optional label = 1
message
orchestration.proto:3628MutateLabelsModeRequest is the mode form of agX4Bc. Mode 0 labels previously-unlabeled sources; mode 1 relabels all sources.
optional context = 1
string project_id = 2
optional mode = 5
Fields 3 and 4 are null in observed requests.
rpc MutateNote (, )
orchestration.proto:1334message
orchestration.proto:1020string project_id = 1
string note_id = 2
optional updates = 3
optional context = 4
message
orchestration.proto:1995string project_id = 1
optional updates = 2
message
orchestration.proto:2000string project_id = 1
repeated updates = 2
optional context = 3
rpc MutateSource (, )
orchestration.proto:1274message
orchestration.proto:2029optional source_id = 2
Field 1 is null in observed requests.
optional updates = 3
optional context = 4
PollDeepResearch is the job-handle variant of e3bVqc. It returns the same session shape as GetDeepResearchSessions, but a successful 2026-07-23 CLI capture shows a standard context envelope and a handle in position two: [context, null, job_handle].
message
orchestration.proto:2902PollDeepResearchRequest is the job-handle e3bVqc variant.
optional context = 1
string job_handle = 3
message
orchestration.proto:2912PollDeepResearchResponse is the job-handle e3bVqc result envelope.
repeated sessions = 1
message
orchestration.proto:473repeated int32 artifact_types = 1
string project_id = 2
string filter = 3
message
orchestration.proto:479repeated artifacts = 1
message
orchestration.proto:2181optional source = 2
optional context = 3
string project_id = 4
Needed for source-path URL param.
message
orchestration.proto:2048string project_id = 1
message
orchestration.proto:447string artifact_id = 1
string new_title = 2
ReportContent. User-initiated abuse/safety report. The JS bundle binds the live ReportContent endpoint to OmVMXc; the historical rJKx8e id never surfaced in any HAR capture or in the bundle, so it is treated as stale (kept as RPCReportContentLegacy for compatibility, no proto entry). TODO(har): no rpcids=OmVMXc seen in any capture under the current web-UI corpus. To capture: open an artifact, click the kebab menu -> "Report", fill the dialog, submit. The placeholder fields are speculative.
message
orchestration.proto:3366ReportContent (rJKx8e): user-initiated abuse/safety report. wire shape unverified; capture HAR before encoding
string project_id = 1
wire shape unverified; capture HAR before encoding
string artifact_id = 2
string reason = 3
string detail = 4
message
orchestration.proto:3374wire shape unverified; capture HAR before encoding
(message has no fields)
ReviseArtifact (rpc.go:131). Re-runs an artifact generator with a free-form revision instruction. The response is the revised Artifact row, including type-specific edit instructions when the revision remains pending.
message
orchestration.proto:3380ReviseArtifact (KmcKPe): revise an artifact with instructions. wire shape unverified; capture HAR before encoding
optional context = 1
string artifact_id = 2
optional instructions = 3
rpc SDPExchange (, )
orchestration.proto:1672SDPExchange (rpc.go:51). WebRTC SDP offer/answer exchange for the interactive-audio voice session. Request payload is a single string holding {"sdp": "...", "type": "offer"} JSON; the server returns the answer SDP wrapped the same way. See internal/interactiveaudio/signaling.go:52.
message
orchestration.proto:3458SDPExchange (eyWvXc): WebRTC SDP offer/answer exchange. HAR-verified (docs/captures/notebooklm.google.com.jsonl:25, 2026-04-06) — request args = [json_str] where json_str is `{"sdp":"...","type":"offer"}`. Response is `[json_str]` where json_str is the answer SDP wrapped the same way, with `"type":"answer"` and an active fingerprint. Encoded/decoded by interactiveaudio.exchangeSDP (signaling.go:52). The wire keeps the SDP as an opaque JSON-encoded string blob; this proto exposes the decoded sdp+type pair for callers that prefer structured access.
string offer_payload = 1
Raw JSON string sent on the wire — kept as a string because the server treats it opaquely and round-trips byte-for-byte.
message
orchestration.proto:3464string answer_payload = 1
StartDeepResearch is the legacy request variant retained for generated client compatibility. New callers use StartDeepResearchWire below.
message
orchestration.proto:2883StartDeepResearch is the legacy QA9ei request model. The live client uses StartDeepResearchWire, which adds the observed request context at position zero and leaves position one null. Both responses are [research_id, conversation_id].
string project_id = 1
string query = 2
StartDeepResearchWire is the canonical QA9ei request. A successful 2026-07-23 CLI capture verified its shape exactly: [context, null, [query, 1], 5, project_id]
message
orchestration.proto:3395optional context = 1
optional query = 3
Field 2 is null in observed requests.
int32 mode = 4
string project_id = 5
rpc StartDraft (, )
orchestration.proto:1429message
orchestration.proto:2213string project_id = 1
message
notebooklm.proto:494(message has no fields)
Research operations StartFastResearch — HAR-verified 2026-04-17 against notebook 00000000-0000-4000-8000-000000000006 (rpc.go:68). Request shape (api.startFastResearchArgs at client.go:4587): [[query, 1], null, 1, project_id] Response is a one-element array: [conversation_id]. Mode enum at position [2] is 1 for fast (5 for deep, see StartDeepResearch).
message
orchestration.proto:2870StartFastResearch (Ljjv0c): kick off a fast-research session. Wire shape verified by api.startFastResearchArgs (client.go:4587), against notebook 00000000-0000-4000-8000-000000000006, query "har harl file formats" (NotebookLM web UI capture, 2026-04-17). No HAR copy in this repo's capture set. JS bundle binding: Ljjv0c → DiscoverSourcesManifold. The "research" feature is built on top of the DiscoverSources job system; api.Client uses the StartFastResearch alias. Wire request: [[query, 1], null, 1, project_id] Wire response: [conversation_id] Mode int at position [2] is 1 for fast, 5 for deep. The trailing 1 at position [0][1] is opaque (same byte the deep variant carries).
string project_id = 1
string query = 2
message
orchestration.proto:2875string conversation_id = 1
rpc StartSection (, )
orchestration.proto:1433message
orchestration.proto:2217string project_id = 1
message
notebooklm.proto:497(message has no fields)
message
orchestration.proto:2221optional turn = 1
optional feedback = 2
optional content = 3
optional options = 6
Fields 4 and 5 are null in the observed request.
message
orchestration.proto:442optional artifact = 1
optional update_mask = 2
UpdateFeaturedNotebookStatus (DemIHe). Admin/internal. Fired only by the featured-notebook curation surface. JS-bundle-verified; unlikely to ever be exercised by an end-user account.
message
orchestration.proto:3754UpdateFeaturedNotebookStatus (DemIHe). Admin-only.
string project_id = 1
bool featured = 2
UpdateProjectUserState (LQhfEb). Per-user notebook state — last-viewed-at, pinned, hidden, etc. The response is not Empty: the wire carries a nested result message ([null, 2]) at field 2. TODO(har): request wire shape still unverified; capture before encoding.
message
orchestration.proto:3782UpdateProjectUserState (LQhfEb). wire shape unverified. UpdateProjectUserStateRequest wire (HAR-verified, more-requests2): [<RequestContext>, project_id, [null, [null, 2]], [["<state_key>"]]] Field 3 carries the new state value (a nested [null, 2] message); field 4 is the list of state keys being updated (e.g. "notebook_lm_state.saved_source_panel_view").
optional context = 1
string project_id = 2
optional value = 3
optional keys = 4
message
orchestration.proto:3810UpdateProjectUserStateResponse: the wire carries a nested result message at field 2 ([null, [null, 2]]), not an empty envelope.
optional result = 2
UpsertArtifactUserState (Fxmvse). JS bundle binds this to /LabsTailwindOrchestrationService.UpsertArtifactUserState. The companion read RPC is GetArtifactUserState (ulBSjf). HAR-verified 2026-04-25 against NotebookLM web UI interactive-audio capture set (22 samples). The web UI fires this every ~5s during interactive audio-overview playback to persist the listener's playback position. The request body is [%context%, %artifact_id%, %state%] where state encodes a single PlaybackPosition (seconds + nanos) wrapped as [[[seconds, nanos]]] — see ArtifactUserState below.
message
orchestration.proto:3565UpsertArtifactUserState (Fxmvse). HAR-verified 2026-04-25 against NotebookLM web UI interactive-audio capture set (22 samples; web UI fires this every ~5s during interactive audio-overview playback to persist the listener's playback position). Wire request: [%context%, %artifact_id%, %state%] - context: standard project_context request envelope - artifact_id: UUID of the artifact (audio overview) - state: ArtifactUserState — encodes [[[seconds, nanos]]] The same ArtifactUserState value is also emitted inline in each gArtLc (ListArtifacts) artifact tuple at a late field position; that inline copy is what the UI reads on page load.
optional context = 1
string artifact_id = 2
optional state = 3
message
orchestration.proto:3575UpsertArtifactUserStateResponse echoes the persisted state. Wire response: [[[[seconds, nanos]]]] — a single ArtifactUserState value (which is itself [[[seconds, nanos]]]) wrapped at field 1.
optional state = 1
Service definitions
rpc CreateAccessRequest (, )
sharing.proto:298CreateAccessRequest (n3dkHd). Sent when a non-collaborator opens a shared notebook URL and clicks "Request access". JS-bundle- verified; no HAR yet. TODO(har): trigger by opening a private share link from a logged- in account that lacks access.
message
sharing.proto:159CreateAccessRequest (n3dkHd). Sent when a non-collaborator opens a shared notebook URL and clicks "Request access". wire shape unverified.
string project_id = 1
string requester_message = 2
message
sharing.proto:164string request_id = 1
rpc GetProjectDetails (, )
sharing.proto:284Project sharing
message
sharing.proto:36GetProjectDetailsRequest. JS bundle confirms the canonical service name: JFMDGd → /LabsTailwindSharingService.GetProjectDetails. The Go-side field name `share_id` is historical; HAR shows the wire accepts the project_id (not a share-link slug). Captured against 12+ notebooks in NotebookLM web UI captures (2026-04-06..2026-04-23). Wire request: [project_id, [2]] [1] = [2] is an opaque mode flag (constant across all observed calls); other modes might surface different response payload shapes but have not been observed.
string share_id = 1
Field is named share_id for backwards compatibility with existing Go callers (api.Client.GetProjectDetails); on the wire this is the project UUID.
optional context = 2
message
sharing.proto:68ProjectDetails is the JFMDGd (GetProjectDetails) reply. HAR-verified wire shape (fields 1..8 map to positions [0]..[7]): [ [<user_entry>, ...], // [0] collaborators (owner first) <flags|null>, // [1] [true,true] when fully public, null o/w 1000, // [2] opaque limit true, // [3] null, // [4] null, // [5] [3, true, true], // [6] permissions blob false, // [7] ] User entry: [email, role_int, [], [display_name, avatar_url]] role_int 1 = OWNER (the only role observed in single-user captures). The live path decodes this through the generated message and projects only OwnerName + IsPublic. printShareDetails (main.go) reads OwnerName/IsPublic/ProjectId/Title/Emoji/SharedAt/Sources by name. Those Go-named fields are retained below at high numbers (they are not on the wire) for the public projection; the wire fields carry the actual HAR positions for betool/beprotojson decode.
repeated collaborators = 1
Wire positions.
[0]
optional flags = 2
[1] visibility flags
optional int64 limit = 3
[2] opaque, observed 1000
optional bool access_enabled = 4
Meaning unconfirmed; true in every observed response.
optional permissions = 7
[4], [5] are null in observed captures; left unmodeled.
[6] [3, true, true]
optional bool restriction_flag = 8
Meaning unconfirmed; false in every observed response.
string owner_name = 20
Not on the wire; populated by the hand-parser and read by the printer. Kept at high numbers to preserve the Go field names live code uses.
hand-parsed from the owner entry's name
bool is_public = 21
hand-parsed from the flags array
string project_id = 22
string title = 23
string emoji = 24
optional shared_at = 25
repeated sources = 26
message
orchestration.proto:3874Used in:
repeated string scope = 1
message
orchestration.proto:3870Used in:
int64 seconds = 1
message
orchestration.proto:1093Account: [account_id, limits, settings, unknown_4, unknown_5]. Field 2 was previously modeled as an "email" string, but the wire carries a [tier, notebook_limit, source_limit, upload_limit, tier] quota array instead (see AccountLimits; confirmed against the hand-written AccountStatus decoder in internal/notebooklm/api/account.go, which reads the same ZwVcOc response positionally). No live code reads Account.email, so the field is replaced rather than kept alongside the real shape.
Used as response type in: LabsTailwindOrchestrationService.GetOrCreateAccount, LabsTailwindOrchestrationService.MutateAccount
string account_id = 1
optional limits = 2
optional settings = 3
optional flags = 4
[3] observed [[1]]; code meaning unconfirmed
optional banner = 5
[4] observed [true,1,3,6,true]
message
orchestration.proto:1150AccountBanner is the Account field 5 message: [true, 1, 3, 6, true]. Meaning of the individual fields is not yet confirmed.
Used in:
optional bool leading_flag = 1
Descriptive positional names only; individual meanings are unconfirmed.
optional int64 code_a = 2
optional int64 code_b = 3
optional int64 code_c = 4
optional bool trailing_flag = 5
message
orchestration.proto:1144AccountFlags is the Account field 4 message: [[1]], a single repeated int64 field.
Used in:
repeated int64 codes = 1
individual code meanings unconfirmed
message
orchestration.proto:1104AccountLimits is the [tier, notebook_limit, source_limit, upload_limit, tier] quota array at Account field 2. Position 1 and 5 both carry the same tier value in observed captures.
Used in:
optional int64 tier = 1
optional int64 notebook_limit = 2
optional int64 source_limit = 3
optional int64 upload_limit = 4
optional int64 tier_2 = 5
message
orchestration.proto:1112Used in:
optional bool email_notifications = 1
string default_project_emoji = 2
optional bool primary_preference_flag = 4
Field 3 ([2]) is null in observed captures; left unmodeled. Meanings of the three preference flags are unconfirmed.
optional rules = 5
[4] observed [null,null,null,[[2,2,1]]]
optional bool secondary_preference_flag = 7
Field 6 ([5]) is null in observed captures; left unmodeled.
optional bool tertiary_preference_flag = 9
Field 8 ([7]) is null in observed captures; left unmodeled.
message
orchestration.proto:1128AccountSettingsDetail is the nested message at AccountSettings field 5: [null, null, null, [[2,2,1]]]. Only field 4 (a repeated AccountSettingsRule) is populated in observed captures.
Used in:
repeated rules = 4
Fields 1-3 ([0]-[2]) are null in observed captures; left unmodeled.
[3] observed [[2,2,1]]
message
orchestration.proto:1136AccountSettingsRule is a [2, 2, 1] positional triple within AccountSettingsDetail.rules. Meaning of the three integers is not yet confirmed.
Used in:
optional int64 rule_code = 1
optional int64 value_code = 2
optional int64 state_code = 3
message
orchestration.proto:514Used in:
optional string text = 1
Present empty text is distinct from an omitted field on the wire.
int32 unknown_3 = 3
message
orchestration.proto:500ActOnSourcesOptions carries numeric selectors. Their semantics are unconfirmed; all observed values are 2.
Used in:
int32 unknown_7 = 7
int32 unknown_10 = 10
message
orchestration.proto:507ActOnSourcesPromptHistory is the prompt and prior-turn rows in the observed chat-query shape. The numeric field's semantics are unconfirmed.
Used in:
string prompt = 1
repeated history = 2
string unknown_3 = 3
Observed as a string; semantics are unconfirmed.
message
orchestration.proto:494Used in:
optional source = 1
Used in:
AGENT_COMMS_MESSAGE_TYPE_UNSPECIFIED = 0
USER_UTTERANCE = 1
Real-time text transcript of user's speech
AGENT_UTTERANCE = 2
Real-time text transcript of AI host's speech
TTS_EVENT = 3
Text-to-speech lifecycle hooks
SEND_AUDIO_EVENT = 4
Audio payload transmission triggers
GROUNDED_AGENT_CUSTOM_MESSAGE = 5
Control frame observed in live captures
PLAYBACK_EVENT = 6
Client-side media playback state sync
MICROPHONE_EVENT = 7
Microphone active/muted state sync
STATUS_MESSAGE = 8
Connection diagnostics and state updates
message
orchestration.proto:2731AgentCommsPayload reconstructs the typed DataChannel payload at field 4. The sub-field numbers match AgentCommsMessageType values.
Used in:
optional user_utterance = 1
optional agent_utterance = 2
optional tts_event = 3
optional send_audio_event = 4
optional grounded_agent_custom_message = 5
optional playback_event = 6
optional microphone_event = 7
optional status_message = 8
message
orchestration.proto:2701AgentCommsUserMessage is the protobuf transmitted over the WebRTC DataChannel for real-time bidirectional UI and transcript synchronization.
AgentCommsMessageType type = 1
string content = 2
optional payload = 4
Field 4 carries the typed event payload observed in live captures.
message
orchestration.proto:2748Used in:
int32 speaker_id = 1
repeated string speakers = 2
string transcript_text = 3
bool is_final = 4
string utterance_id = 5
message
orchestration.proto:176Used in:
string app_id = 1
string name = 2
string description = 3
message
orchestration.proto:63Artifact is the gArtLc (ListArtifacts/QueryArtifacts) row shape. Fields Fields 7-19 are a de-facto oneof keyed by type: exactly one of note, audio_overview, video_preview, report_config, mindmap_preview, slide_deck_preview, flashcard_config is populated per artifact, matching ArtifactType. These are each artifact-tree-local message shapes distinct from the top-level AudioOverview/VideoOverview/Report messages used by the Create*/Get* RPCs — the field numbers coincide but the wire shapes do not (AudioOverview.content/instructions are plain strings there; here they are structured payloads). See ArtifactAudioOverview etc. below.
Used as response type in: LabsTailwindOrchestrationService.CreateArtifact, LabsTailwindOrchestrationService.CreateAudioOverview, LabsTailwindOrchestrationService.CreateUniversalArtifact, LabsTailwindOrchestrationService.CreateVideoOverview, LabsTailwindOrchestrationService.GenerateArtifact, LabsTailwindOrchestrationService.GetArtifact, LabsTailwindOrchestrationService.RenameArtifact, LabsTailwindOrchestrationService.ReviseArtifact, LabsTailwindOrchestrationService.UpdateArtifact
Used as field type in: , , , ,
string artifact_id = 1
string title = 2
ArtifactType type = 3
repeated sources = 4
ArtifactState state = 5
optional note = 7
Field 6 is null in every observed capture; left unmodeled.
type NOTE
optional audio_overview = 8
type AUDIO_OVERVIEW
optional video_preview = 9
type VIDEO_OVERVIEW
optional tailored_report = 10
type REPORT
optional update_time = 11
update_time is populated on every artifact regardless of type; it is always >= create_time (field 16).
optional mindmap_preview = 15
Fields 12-14 are null in every observed capture; left unmodeled.
type 7 (mind map / infographic)
optional create_time = 16
optional slide_deck_preview = 17
type 8 (slide deck)
optional processing_timestamps = 18
Field 18 carries a wrapped list of timestamp rows, observed [[[1388, 553000000]]] on a failed NOTE artifact. The inner [secs, nanos] is a Timestamp; meaning (a processing duration or retry marker) is unconfirmed, so it is modeled generically.
inferred processing/retry times
optional flashcard_config = 19
type 9 (flashcards)
int64 schema_version = 20
Inferred schema/version marker; constant 1 in every observed capture.
optional app = 21
App's real wire position on gArtLc has never been observed (no type-5 artifact has appeared in any capture); field 10 was a guess that collided with the now-confirmed tailored_report position, so App is parked here pending a HAR that actually contains one.
string update_cursor = 22
update_cursor is a string encoding of update_time (field 11) as base64("{seconds}-{nanos}"), e.g. base64("1784614281-797501000"). Likely an opaque sort/pagination cursor; kept generic since its use is unconfirmed.
string viewer_url = 24
optional file_details = 25
message
orchestration.proto:239ArtifactAudioContent is the [topic, description, null, source_refs, language, prompt, length?, flag] generation-options blob at ArtifactAudioOverview field 2.
Used in:
string topic = 1
e.g. "Blog Post"
string description = 2
repeated source_refs = 4
Field 3 is null in every observed capture; left unmodeled.
string language = 5
string prompt = 6
optional int64 length = 7
optional bool flag = 8
message
orchestration.proto:230ArtifactAudioOverview is the type-AUDIO_OVERVIEW gArtLc payload at Artifact field 8: [markdown_status, content, instructions]. This is a different shape than the top-level AudioOverview message (whose content and instructions are plain strings on Create/GetAudioOverview).
Used in:
string status = 1
rendered markdown, not a status code
optional content = 2
optional instructions = 3
same rich-text tree as chat rich_content
message
orchestration.proto:185ArtifactDownloadVariant is one rendered-output link for an artifact preview: a URL plus an integer format code and (for audio) a MIME type. [url, format_code, mime_type?]
Used in: ,
string url = 1
int64 format_code = 2
string mime_type = 3
message
orchestration.proto:106ArtifactFileDetails is the five-string trailer returned by direct GetArtifact reads. The field meanings beyond filename and MIME type are unconfirmed; URLs are retained independently for lossless round-tripping.
Used in:
string filename = 1
string mime_type = 2
string url_3 = 3
string url_4 = 4
string url_5 = 5
message
orchestration.proto:415ArtifactFlashcardConfig is the type-9 (flashcards) gArtLc payload at Artifact field 19: [null, [null, language]].
Used in:
optional extracted_content = 1
extracted_content is the source-derived rich-text document some flashcard decks carry (e.g. an extracted API reference table); null on the majority of captures.
optional options = 2
message
orchestration.proto:423Used in:
string language = 2
Field 1 is null in every observed capture; left unmodeled.
message
orchestration.proto:407ArtifactImageRef is a [url, width, height] image reference.
Used in:
string url = 1
optional int64 width = 2
optional int64 height = 3
message
orchestration.proto:324ArtifactMindMapConfig is the [null, language, null, int, int, int] config blob at ArtifactMindMapPreview field 1. orientation_code is inferred from the generated image dimensions; the remaining code meanings are unconfirmed.
Used in: ,
string prompt = 1
prompt is present for some custom mind maps and null for others.
string language = 2
optional int64 orientation_code = 4
Field 3 is null in every observed capture; left unmodeled. Observed 1 for landscape images and 2 for portrait images.
optional int64 style_code = 5
inferred visual-style selector
optional int64 template_code = 6
inferred template selector
message
orchestration.proto:347ArtifactMindMapImageRef is a [url, width, height] image reference. Unlike ArtifactImageRef (the slide-deck variant), width/height are carried as integers here, not numeric strings.
Used in:
string url = 1
optional int64 width = 2
optional int64 height = 3
message
orchestration.proto:315ArtifactMindMapPreview is the type-7 (mind map / infographic) gArtLc payload at Artifact field 15: [config, title, [slide]].
Used in:
optional config = 1
string title = 2
repeated slides = 3
message
orchestration.proto:337ArtifactMindMapSlide is one [title, [url, width, height], description, text] entry in ArtifactMindMapPreview.slides.
Used in:
string title = 1
optional thumbnail = 2
string description = 3
string text = 4
message
orchestration.proto:215ArtifactNoteConfig is the [null, const, null, source_refs, language, flag, int] config blob inside ArtifactNotePreview.
Used in:
string prompt = 1
Present when the note was generated with a custom prompt.
optional int64 mode = 2
constant 2 in every observed capture
repeated source_refs = 4
Field 3 is null in every observed capture; left unmodeled.
string language = 5
optional bool flag = 6
optional int64 format_code = 7
inferred format selector
message
orchestration.proto:193ArtifactNotePreview is the type-NOTE gArtLc payload at Artifact field 7: [null, config, thumbnail_url, thumbnail_url_2, has_audio?, download_variants, duration]
Used in:
optional config = 2
Field 1 is null in every observed capture; left unmodeled.
string thumbnail_url = 3
string thumbnail_url_2 = 4
optional bool has_audio = 5
repeated download_variants = 6
optional duration = 7
duration is present-but-empty ([]) when there is no audio rendition yet, so it is wrapped in a message: a present TimestampPair marshals to [] when its own seconds/nanos are unset, instead of collapsing to null.
message
orchestration.proto:290ArtifactReportConfig is the type-REPORT gArtLc payload at Artifact field 10: ["", [report_type, null, description_or_instructions, language, null, null, length_range_a?, length_range_b?, flag]]. The leading string is empty in every observed capture.
Used in:
optional string leading_text = 1
Meaning unconfirmed; an explicit empty string in every observed capture.
optional options = 2
string mind_map_data_json = 4
Confirmed string carrying JSON. Inferred to be a mind-map node tree.
message
orchestration.proto:298Used in:
optional int64 report_type = 1
string instructions = 3
Field 2 is null in every observed capture; left unmodeled.
custom prompt, or the report topic when no instructions were given
string language = 4
repeated int64 length_range_a = 7
Fields 5, 6 are null in every observed capture; left unmodeled. length_range_a and length_range_b are never both populated in the same capture; which one is used appears to depend on report_type (a=1 pairs with report_type 1, b=2 with report_type 2), so both are kept as distinct optional positions rather than merged.
e.g. [2, 2]
repeated int64 length_range_b = 8
e.g. [2, 2]
optional bool flag = 9
message
orchestration.proto:3390Used in:
optional int32 slide_index = 1
string instruction = 2
message
orchestration.proto:3386Used in:
repeated instructions = 1
message
orchestration.proto:386ArtifactSlideDeckConfig is the [null, language, format, length] config blob at ArtifactSlideDeckPreview field 1, mirroring the [format, length] pair EncodeCreateSlideDeckArgs sends on create (see internal/method/labs_tailwind_overview_custom.go SlideDeckFormat).
Used in:
string unknown_1 = 1
Observed as a user-provided string; meaning unconfirmed.
string language = 2
optional int64 format = 3
optional int64 length = 4
int32 unknown_5 = 5
Observed as 4; semantics are unconfirmed.
message
orchestration.proto:356ArtifactSlideDeckPreview is the type-8 (slide deck) gArtLc payload at Artifact field 17: [config, title, [slide_image], download_url, download_url_2].
Used in:
optional config = 1
string title = 2
repeated slides = 3
string download_url = 4
string download_url_2 = 5
optional edit_instructions = 6
message
orchestration.proto:377ArtifactSlideEditInstruction is one [slide_index, text] revision-request pair.
Used in:
optional int64 slide_index = 1
string text = 2
message
orchestration.proto:371ArtifactSlideEditInstructions is the per-slide revision-request blob at ArtifactSlideDeckPreview position [5] (field 6): [[[slide_index, text], ...]]. Each entry pairs a zero-based slide index with the user's edit instruction for that slide (e.g. [0, "simplify this slide"]). Present only on slide-deck artifacts the user has requested edits on; absent otherwise. Surfaced by a gArtLc (QueryArtifacts) poll capture; the list is wrapped one level deep.
Used in:
repeated instructions = 1
message
orchestration.proto:400ArtifactSlideImage is one [[url, width, height], description, text] entry in ArtifactSlideDeckPreview.slides.
Used in:
optional image = 1
string description = 2
string text = 3
message
orchestration.proto:152Used in:
optional source_id = 1
repeated text_fragments = 2
int32 unknown_3 = 3
Semantics unconfirmed. Observed as 8 on artifact sources.
Used in:
ARTIFACT_STATE_UNSPECIFIED = 0
ARTIFACT_STATE_CREATING = 1
ARTIFACT_STATE_READY = 2
ARTIFACT_STATE_FAILED = 3
ARTIFACT_STATE_SUGGESTED = 4
ARTIFACT_STATE_7 = 7
ARTIFACT_STATE_8 = 8
ARTIFACT_STATE_9 = 9
message
orchestration.proto:3436One suggestion pair. Pass description (optionally edited) as the instructions argument to CreateAudioOverview / CreateUniversalArtifact.
Used in:
string title = 1
string description = 2
repeated string categories = 3
Category tags for the suggestion, e.g. ["explanatory"]. Present only once suggestions have generated (absent on early poll snapshots).
message
orchestration.proto:121Used in:
optional int64 seconds = 1
optional int64 nanos = 2
message
orchestration.proto:117ArtifactTimestamps is the wrapped list carried at Artifact field 18: [[ [secs, nanos] ]] — an outer list of rows, each row an inline [seconds, nanos] pair (not a google.protobuf.Timestamp sub-message).
Used in:
repeated rows = 1
Used in:
ARTIFACT_TYPE_UNSPECIFIED = 0
ARTIFACT_TYPE_NOTE = 1
ARTIFACT_TYPE_AUDIO_OVERVIEW = 2
ARTIFACT_TYPE_VIDEO_OVERVIEW = 3
Video overview (confirmed from /tmp/notebooklm3.har)
ARTIFACT_TYPE_REPORT = 4
ARTIFACT_TYPE_APP = 5
ARTIFACT_TYPE_7 = 7
6 unobserved.
mind map / infographic (see ArtifactMindMapPreview)
ARTIFACT_TYPE_8 = 8
slide deck (see ArtifactSlideDeckPreview)
ARTIFACT_TYPE_9 = 9
flashcards (see ArtifactFlashcardConfig)
ARTIFACT_TYPE_10 = 10
Observed with a downloadable Markdown document; semantic name unconfirmed.
message
orchestration.proto:3548ArtifactUserState is the per-user, per-artifact state the orchestration service persists. Today the only observed payload is a single repeated PlaybackPosition recording the user's last playback position in an audio overview; the field is repeated to leave room for additional markers (resume points, chapter offsets) that the UI may emit later. Wire shape (HAR-verified 2026-04-25): [[[seconds, nanos]]] That is: ArtifactUserState is a message with field 1 = repeated PlaybackPosition, and a single PlaybackPosition encodes positionally as [seconds, nanos].
Used in: , ,
repeated playback_position = 1
message
orchestration.proto:273ArtifactVideoContent is the [source_refs, language, topic?, null, length, unknown_6?, null, flag?] generation-options blob at ArtifactVideoPreview field 3, the same family of shape as ArtifactAudioContent (a source-ref list plus language/topic/length/flag), but with source_refs and language/topic swapped in position relative to the audio variant. The array length varies (5, 6, or 8 observed) as trailing fields are omitted when unset, so every field past source_refs/language is optional.
Used in:
repeated source_refs = 1
string language = 2
string topic = 3
optional int64 length = 5
Field 4 is null in every observed capture; left unmodeled.
optional int64 format_code = 6
inferred format selector
optional bool flag = 8
Field 7 is null in every observed capture; left unmodeled. flag is carried as an int (1), not a JSON bool, unlike similarly named fields elsewhere.
message
orchestration.proto:256ArtifactVideoPreview is the type-VIDEO_OVERVIEW gArtLc payload at Artifact field 9: [status?, thumbnail_url, content, video_url, download_variants, duration]. Unlike ArtifactAudioOverview, this was previously mismodeled as the unrelated Report message (field 9 used to be declared `Report tailored_report`), which is why the wire's positions 4-6 showed up as Report.unknown_4/5/6 in earlier verify runs.
Used in:
string thumbnail_url = 2
Field 1 is null in every observed capture; left unmodeled.
optional content = 3
string video_url = 4
repeated download_variants = 5
repeated int64 duration = 6
duration is [seconds, nanos].
message
orchestration.proto:3148AudioFormat captured kinds (HAR 2026-04-19+): 1 = "Deep Dive" — two-host conversation 2 = "Brief" — bite-sized overview 3 = "Critique" — expert review w/ feedback 4 = "Debate" — two-host opposing perspectives
Used in:
int32 id = 1
string name = 2
string description = 3
message
orchestration.proto:3135Used in:
repeated items = 1
Audio length options (confirmed from /tmp/notebooklm2.har analysis)
Used in:
AUDIO_LENGTH_UNSPECIFIED = 0
AUDIO_LENGTH_SHORT = 1
Shorter audio overview
AUDIO_LENGTH_DEFAULT = 2
~10-15 minutes
AUDIO_LENGTH_LONG = 3
~15-20 minutes (longer)
message
notebooklm.proto:387Used as response type in: LabsTailwindOrchestrationService.CreateAudioOverviewLegacy, LabsTailwindOrchestrationService.GetAudioOverview
string status = 1
string content = 2
string instructions = 3
string audio_id = 4
string audio_url = 5
string title = 6
Audio style types (confirmed from sqTeoe RPC in HAR analysis)
Used in: ,
AUDIO_TYPE_UNSPECIFIED = 0
AUDIO_TYPE_DEEP_DIVE = 1
"A lively conversation between two hosts, unpacking and connecting topics"
AUDIO_TYPE_BRIEF = 2
"A bite-sized overview to help you grasp the core ideas quickly"
AUDIO_TYPE_CRITIQUE = 3
"An expert review offering constructive feedback"
AUDIO_TYPE_DEBATE = 4
"A thoughtful debate illuminating different perspectives"
message
rpc_extensions.proto:87Encoding hints for batchexecute format
(message has no fields)
How to encode arrays
ARRAY_DEFAULT = 0
ARRAY_NESTED = 1
[[item1], [item2]]
ARRAY_FLAT = 2
[item1, item2]
ARRAY_WRAPPED = 3
[[[item1, item2]]]
How to handle empty/zero values
EMPTY_VALUE_DEFAULT = 0
EMPTY_VALUE_NULL = 1
EMPTY_VALUE_OMIT = 2
EMPTY_VALUE_EMPTY_ARRAY = 3
message
notebooklm.proto:157Used in:
repeated string token = 1
message
orchestration.proto:3089BulkImportFromResearchResponse carries enriched Source descriptors in request order. The live API projects the generated response to its narrow BulkImportResult public type.
Used as response type in: LabsTailwindOrchestrationService.BulkImportFromResearch, LabsTailwindOrchestrationService.BulkImportFromResearchWire
repeated results = 1
message
orchestration.proto:3095BulkImportResult is the former partial projection of an imported Source. Deprecated: BulkImportFromResearchResponse now returns Source values.
string source_id = 1
string title = 2
string url = 3
message
orchestration.proto:3041Used in:
string url = 1
string title = 2
string content = 3
content holds inline markdown when this source is a note/text import (type=3). Leave empty for URL imports (type=2).
int32 source_type = 4
source_type matches the trailing enum int in the wire tuple: 2 = URL (url + title populated) 3 = NOTE (title + content populated)
message
orchestration.proto:3081Used in:
string title = 1
string markdown = 2
message
orchestration.proto:3064Used in:
optional content = 2
Field 1 is null.
optional unknown_3 = 3
int32 content_type = 4
repeated string unknown_8 = 8
Fields 5 through 7 and 9 through 10 are null. Observed as a list containing a YouTube URL; semantics are unconfirmed.
int32 source_type = 11
message
orchestration.proto:3076BulkImportTextSourceLink is an observed [URL, title] source reference.
Used in:
string url = 1
string title = 2
message
orchestration.proto:823Used in:
string chunk = 1
optional conversation = 3
Fields 2 and 4 are null.
optional document = 5
message
orchestration.proto:721Used in: , , ,
int32 start = 1
int32 end = 2
message
orchestration.proto:737Used in:
double confidence = 1
repeated ranges = 2
repeated excerpts = 3
message
orchestration.proto:732Used in:
optional range = 1
repeated segments = 2
message
orchestration.proto:726Used in:
optional range = 1
string text = 2
bool emphasized = 3
message
orchestration.proto:715Used in: ,
string conversation_id = 1
string message_id = 2
int64 sequence_number = 3
message
orchestration.proto:748Used in: ,
string text = 1
int32 type = 2
message
orchestration.proto:839Used in:
repeated follow_up = 1
message
orchestration.proto:806Used in:
int32 enabled = 1
repeated int32 modes = 11
Fields 2 through 10 are null.
message
orchestration.proto:835Used in:
repeated string text = 1
message
notebooklm.proto:115Used in:
int32 goal = 1
string custom_prompt = 2
message
orchestration.proto:2295ChatMessage is one turn in a GetConversationHistory response. Field numbers are positional and match the observed wire layout (HAR-verified against a sanitized khqZz capture, 2026-07-20): [message_id, [secs,nanos], role, text, [content_segment...]] User turns (role = 1) populate text (field 4); assistant turns (role = 2) populate rich_content (field 5) instead. The live client reads this shape directly in api.parseConversationHistory; this message mirrors it so GetConversationHistoryResponse round-trips through the proto view.
Used in:
string message_id = 1
server-assigned message UUID
optional timestamp = 2
[seconds, nanos]
int32 role = 3
1 = user, 2 = assistant
string text = 4
plain text (user turns)
optional rich_content = 5
structured content (assistant turns)
message
orchestration.proto:743Used in:
optional range = 1
repeated int32 source_indices = 2
message
orchestration.proto:795Used in:
optional source = 1
message
orchestration.proto:799Used in: , , ,
int32 mode = 1
optional citation_modes = 3
Field 2 is null.
optional follow_up = 4
message
orchestration.proto:830Used in:
optional range = 1
repeated int32 source_indices = 2
message
orchestration.proto:780ChatStreamUnknown13 is an opaque repeated row carried by some streamed chat requests. Field meanings are unconfirmed.
Used in:
repeated entries = 1
message
orchestration.proto:784Used in:
string id = 1
optional values = 2
message
orchestration.proto:789Used in:
optional string value = 1
optional int32 first = 2
optional int32 second = 3
message
notebooklm.proto:124Used in: ,
optional goal = 1
optional response_length = 2
message
orchestration.proto:2691ChunkRef is a [[chunk_id], ref_id] reference within a grounding record.
Used in:
optional chunk = 1
string ref_id = 2
message
orchestration.proto:2336CitationRef links a ContentSegment back to its source. The two id fields hold the same source UUID in every observed capture; ref is an integer whose meaning (chunk offset or citation index) is not yet confirmed.
Used in:
string source_id = 1
string source_id_2 = 2
int64 ref = 3
message
orchestration.proto:3520Collection is one collection row: a user-defined grouping of notebooks, returned in the collections scope of I3xc3c/agX4Bc. It occupies the same four slots as Label, but field 2 is a flat list of project ids rather than the wrapped ["uuid"] elements Label.sources uses. The split is exact across the corpus: 131 notebook-scope rows are wrapped and all 8 collections-scope rows are flat, with no row of either kind in the other scope.
Used in: ,
string name = 1
repeated string project_ids = 2
Member notebooks, as bare project id strings.
string collection_id = 3
optional string emoji = 4
Same emoji slot as Label.emoji, set through the le8sX metadata mutation.
message
orchestration.proto:2316ContentAnnotation ties an offset range of the reply to the source indices that support it: [[null, start, end], [source_index...]].
Used in:
optional range = 1
[0] [null, start, end]
repeated int64 source_indices = 2
[1] indices into grounding
message
orchestration.proto:2324ContentSegment is one span of an assistant turn's rich_content. Each segment carries its text and a citation reference; complex segments additionally carry a rich-text document payload not modeled here.
Used in:
optional string text = 1
Empty assistant segments carry an explicit empty string.
optional citation = 3
Field 2 ([1]) is an empty array in observed captures; left unmodeled.
[source_id, source_id, ref]
optional rich_document = 5
Field 4 ([3]) is an empty array in observed captures; left unmodeled.
rendered rich-text tree
message
orchestration.proto:17Used in:
string project_id = 1
Context information, structure inferred from usage
repeated string source_ids = 2
message
orchestration.proto:2264Used in:
string conversation_id = 1
message
orchestration.proto:3647CreateLabelResponse returns the full refreshed list rather than just the new row, at a slot that depends on the request scope: field 2 in the notebook scope (8 observed) and field 3 in the collections scope (2 observed).
Used as response type in: LabsTailwindOrchestrationService.CreateLabel, LabsTailwindOrchestrationService.MutateLabelsMode
optional label = 1
Field 1 (Label label) is null in every observed capture; the RPC returns the full refreshed label list at field 2 instead.
repeated labels = 2
repeated collections = 3
message
orchestration.proto:2962DeepResearchMainBlob is [report_tree, extra]. The extra string is present only on fast-research results.
Used in:
repeated report_tree = 1
optional string extra = 2
message
orchestration.proto:2992Used in:
string research_id = 1
optional string plan = 2
optional int32 kind = 3
optional string backend = 5
message
orchestration.proto:2955Used in:
string text = 1
optional int32 kind = 2
message
orchestration.proto:2984DeepResearchReportDetail covers the header's rendered report and the citation row's extracted text. Their wire layouts share the same six-slot positional group and differ only in which optional fields are populated.
Used in:
optional string markdown = 1
optional int32 kind = 2
optional string excerpt = 3
optional int32 rank = 5
optional document = 6
message
orchestration.proto:2970DeepResearchReportEntry covers both the report header at entry zero and the source-citation rows that follow it. Fast-research results use the same prefix, omitting the deep-only detail fields.
Used in:
optional string url = 1
optional string title = 2
optional string summary = 3
optional int32 kind = 4
optional string favicon_url = 6
optional detail = 7
optional bool selected = 8
optional int32 rank = 9
message
orchestration.proto:2938HAR-verified wire shape (2026-07-21, e3bVqc/GetDeepResearchSessions), per session entry: [ conversation_id, // [0] UUID string [ // [1] inner project_id, // [0] UUID string [query, 1], // [1] query + int mode, // [2] 1 = fast, 5 = deep [ <report_tree> (, extra_str) ],// [3] main_blob; variable length state, // [4] int (6 observed) [research_id, plan_b64, 5, null, ts_str],// [5] DEEP ONLY (absent for fast) ], [secs, nanos], // [2] timestamp pair [secs, nanos], // [3] timestamp pair "157962509464", // [4] numeric timestamp string ] report_tree ([1][3][0]) is a 72-element deep-research report: element [0] is a [null, title, ...] header, elements [1..N] are source citations [url, title, ...9 fields]. ~334KB; distinct from the Span/chat document tree.
Used in: ,
string conversation_id = 1
optional details = 2
optional created = 3
optional updated = 4
string account_id = 5
message
orchestration.proto:2946Used in:
string project_id = 1
optional query = 2
optional int32 mode = 3
optional main_blob = 4
optional int32 state = 5
optional metadata = 6
message
orchestration.proto:2999Used in:
optional int64 seconds = 1
optional int32 nanos = 2
message
orchestration.proto:3156DocTemplate is a prebuilt briefing-doc/study-guide template: [title, subtitle, system_prompt].
Used in:
string title = 1
string subtitle = 2
string system_prompt = 3
message
orchestration.proto:3139Used in:
repeated items = 1
message
notebooklm.proto:419DocumentGuide is one per-source guide in a GenerateDocumentGuides (tr032e) reply. HAR-verified wire (more-requests3, keyed by source_id): [ [[source_id]], [summary], [[topic, topic, ...]], [] ] The live reader (api.Client.GenerateSourceGuide) hand-parses these positions directly; this message mirrors the wire for betool/beprotojson decode. Positions [1] and [2] wrap their payload one level deep, so each is modeled as a small wrapper message.
Used in:
optional source_id = 1
[[source_id]]
optional summary = 2
[summary_text]
optional topics = 3
[[topic, topic, ...]]
optional extra = 4
[] in observed captures; meaning unconfirmed
message
notebooklm.proto:446DocumentGuideExtra is the empty list at DocumentGuide[3]. Modeled as a present-but-empty message so the [] round-trips rather than collapsing to null (mirrors ProjectCollaboratorTags).
Used in:
repeated string items = 1
message
notebooklm.proto:428DocumentGuideId wraps the doubly-nested source id at DocumentGuide[0]: [[source_id]].
Used in:
repeated string id = 1
message
notebooklm.proto:433DocumentGuideSummary wraps the summary text at DocumentGuide[1]: [summary].
Used in:
string text = 1
message
notebooklm.proto:439DocumentGuideTopics wraps the key-topic chips at DocumentGuide[2]: [[topic, topic, ...]].
Used in:
repeated string topics = 1
message
orchestration.proto:3843Used in:
string book_id = 1
int32 kind = 2
string title = 3
string html_description = 4
string cover_url = 5
bool flag = 6
int32 category = 7
repeated string authors = 8
double rating = 9
optional publication_time = 10
message
orchestration.proto:3856Used in:
int64 seconds = 1
message
orchestration.proto:923Used in:
string title = 1
repeated sources = 2
string project_id = 3
string emoji = 4
optional metadata = 6
optional chatbot_config = 8
repeated bool flags = 9
Two sets of capability flags carried as JSON booleans.
repeated bool flags2 = 10
optional limits = 11
Per-notebook limits/quotas (observed [null,500,600,500000,3]).
optional presentation = 15
message
orchestration.proto:904Used in:
string url = 1
string filename = 2
Original image filename.
int64 position = 3
confirmed 1-based image position
int64 image_kind = 4
inferred image-kind code; observed 2
string image_url = 5
Serving URL for the image (lh3.googleusercontent.com/notebooklm/…).
message
orchestration.proto:938Used in:
int64 notebook_limit = 2
field 1 reserved/unknown (observed null)
confirmed by the identical ProjectLimits slot
int64 source_limit = 3
confirmed by the identical ProjectLimits slot
int64 upload_limit = 4
inferred byte/size limit; observed 500000
int64 tier_code = 5
inferred tier code; observed 3
message
orchestration.proto:914Used in:
optional bool curated = 1
repeated images = 2
string provider = 3
string description = 4
optional bool presentation_flag = 5
Meaning unconfirmed; varies among featured presentations.
message
sharing.proto:257Used in:
int32 max_length = 1
float temperature = 2
bool include_sources = 3
message
orchestration.proto:2196Used in:
optional source = 1
message
orchestration.proto:2192Used in:
optional source = 1
message
orchestration.proto:676Used in: ,
optional string content = 1
Wire shape: [content, null, role]
int32 role = 3
1 = user, 2 = assistant
message
orchestration.proto:682Used in:
int32 mode = 1
Observed default request options: [2, null, [1], [1]]
repeated int32 citation_modes = 3
repeated int32 follow_up_modes = 4
message
notebooklm.proto:342GetNotesEntry is one keyed GetNotes result: [note_id, note].
Used in:
string note_id = 1
optional note = 2
message
notebooklm.proto:375repeated notes = 1
optional fetch_time = 2
Server timestamp of the notes snapshot.
message
orchestration.proto:2362GetNotesRichEntry is one keyed GetNotes result: [note_id, note].
Used in:
string note_id = 1
optional note = 2
optional int32 entry_type = 3
Meaning unconfirmed; observed as 2 on keyed entries in several captures.
message
orchestration.proto:2370GetNotesRichRecord is the response-side note tuple used by cFji9.
Used in:
string note_id = 1
optional string content_text = 2
optional metadata = 3
optional grounding_details = 4
string title = 5
optional rich_text = 6
repeated int32 note_type = 7
message
notebooklm.proto:382GetNotesWireResponse is the keyed response shape returned by cFji9.
repeated entries = 1
optional fetch_time = 2
message
orchestration.proto:1912Used in:
optional entry = 1
message
orchestration.proto:1916Used in:
optional values = 3
Fields 1 and 2 are null in observed requests.
message
orchestration.proto:975GoogleDocsSourceInput is the AddSources field-1 Google Drive document variant. A 2026-07-23 capture verified this for application/vnd.google-apps.document.
Used in:
string drive_id = 1
string mime_type = 2
int32 mode = 3
string document_id = 4
message
notebooklm.proto:231Used in:
string document_id = 1
optional string resource_key = 2
Opaque resource/revision token for the doc (often empty).
int64 size = 3
inferred document size/count; unit unconfirmed
message
orchestration.proto:2720Used in:
bytes raw = 1
message
orchestration.proto:2675Grounding is the detail of a GroundingRecord: [null, null, score, [reply_span], [source_spans], [chunk_ref], source_id].
Used in: , , , ,
optional double score = 3
Fields 1 and 2 ([0], [1]) are null in observed captures; left unmodeled.
[2] relevance score
repeated reply_spans = 4
[3] spans in the reply
optional source_spans = 5
[4] [[span...]] in the source
repeated chunk_refs = 6
[5] [[chunk_id], ref_id]
optional source_id = 7
[6] [source UUID]
message
orchestration.proto:2668GroundingRecord links reply spans to the source spans that ground them: [[source_id], [null, null, score, [reply_span], [source_spans], [ref], source_id]].
Used in:
optional source = 1
[0] [source_id]
optional grounding = 2
[1] the grounding detail
message
notebooklm.proto:471Used in:
string question = 1
string prompt = 2
Suggested prompt that expands the question.
message
notebooklm.proto:467Used in:
repeated items = 1
message
notebooklm.proto:481Used in:
string question = 1
int64 score = 2
message
notebooklm.proto:477Used in:
repeated items = 1
message
notebooklm.proto:463Used in:
string text = 1
Guide type for GenerateNotebookGuide (confirmed from /tmp/notebooklm3.har analysis)
GUIDE_TYPE_UNSPECIFIED = 0
GUIDE_TYPE_OUTLINE = 1
Text outline
GUIDE_TYPE_MIND_MAP = 2
Mind map visualization
message
sharing.proto:169Guidebook-related messages
Used as response type in: LabsTailwindGuidebooksService.GetGuidebook
Used as field type in: , ,
string guidebook_id = 1
string project_id = 2
string title = 3
string content = 4
GuidebookStatus status = 5
optional published_at = 6
message
sharing.proto:235Used in:
int32 view_count = 1
int32 share_count = 2
optional last_viewed = 3
message
sharing.proto:228Used in:
string section_id = 1
string title = 2
string content = 3
int32 order = 4
Used in:
GUIDEBOOK_STATUS_UNSPECIFIED = 0
GUIDEBOOK_STATUS_DRAFT = 1
GUIDEBOOK_STATUS_PUBLISHED = 2
GUIDEBOOK_STATUS_ARCHIVED = 3
message
orchestration.proto:2068Used in: , , , , ,
int32 value = 1
optional int32 unknown_7 = 7
message
orchestration.proto:1931Used in:
optional int32 version = 1
observed 2
optional surface = 3
Field 2 is null in every observed request.
optional caps = 4
optional artifact_types = 5
message
orchestration.proto:1939Used in:
optional int32 value = 1
observed 1
message
orchestration.proto:1943Used in:
string artifact_id = 1
message
orchestration.proto:2804Used in:
repeated string urls = 1
stun: and turn: URIs
string username = 2
empty for STUN entries
string credential = 3
empty for STUN entries
message
orchestration.proto:3502Label is one autolabel cluster, as returned in the notebook scope of I3xc3c/agX4Bc. The collections scope returns the same four slots but with a different element shape at field 2, so it is modeled separately as Collection.
Used in: , ,
string name = 1
e.g. "Generated Code", "Testing", "RPC and Networking"
repeated sources = 2
Members of this cluster; each source id arrives wrapped as ["uuid"].
string label_id = 3
server-assigned UUID
optional string emoji = 4
CONFIRMED emoji, not a description. Field 4 is the emoji set by the le8sX metadata mutation: a capture sets "\U0001F4C1" on one label and a later read of the same label_id returns it here. Empty in 144 of 147 observed rows because most labels carry no emoji.
message
orchestration.proto:3639Used in:
string name = 1
optional string emoji = 2
message
orchestration.proto:3618LabelCreationRequest is CreateLabelRequest field 6. It is a single structure rather than a list of them: slot 1 holds the label or collection being created, and a collection create adds the notebooks to seed it with at slot 3. Observed as [[name, emoji]] for a label and [[name], null, [project_id]] for a collection.
Used in:
optional label = 1
repeated string project_ids = 3
Field 2 is null in observed requests. Notebooks to seed a new collection with, as bare project id strings. Absent on notebook-scope label creates.
message
orchestration.proto:3635Used in:
optional int32 value = 1
message
orchestration.proto:3703Used in:
optional string name = 1
The metadata form sends [null, emoji] to set only the emoji, so name is optional rather than a bare string.
optional string emoji = 2
CONFIRMED emoji: a capture sets it here and the label subsequently reads back with that emoji at Label.emoji.
message
orchestration.proto:2607ListItem describes one list-item run within a span group: [null, null, nesting, {101:bullet, ...}]. Positions 1 and 2 are null in observed captures.
Used in: ,
optional int64 nesting = 3
Fields 1 and 2 ([0], [1]) are null in observed captures; left unmodeled.
[2] nesting depth (0,1,2)
optional marker = 4
[3] marker or shifted-marker metadata
optional trailing_marker = 5
[4] marker when field 4 is metadata
message
orchestration.proto:2617ListItemMarker is a shape union. Most list items carry their sparse marker object directly at position 4. A newer variant carries [null,null,flag] at position 4 and shifts the sparse marker object to position 5.
Used in:
oneof value
empty = 1
meta = 2
marker = 3
message
orchestration.proto:2625Used in:
(message has no fields)
message
orchestration.proto:2629ListItemMarkerMeta is the [null, null, flag] tuple in shifted-marker items.
Used in:
optional bool flag = 3
message
orchestration.proto:2638ListMarker is the list-item style object, carried on the wire as a sparse object keyed by field number: {"101":"•", "102":1, "103":1, "104":0}. The bullet glyph cycles •/◦/▪ with nesting. marker_kind distinguishes unordered (1) from ordered (2) markers; the other counters' exact meanings remain unconfirmed.
Used in: ,
string bullet = 101
optional int64 marker_kind = 102
confirmed 1 for bullets, 2 for numbers
optional int64 item_number = 103
inferred per-list item number
optional int64 sequence_index = 104
inferred zero/one-based sequence counter
message
orchestration.proto:1960Used in:
optional filter_group_a = 1
Group semantics are unconfirmed because every observed list is empty.
[null, null, []]
optional filter_group_b = 2
[[]]
optional filter_group_c = 3
[null, []]
message
orchestration.proto:1971The three filter sub-messages each carry a single present-but-empty list. The list is wrapped in a StringList message so a present (non-nil) wrapper round-trips as [] rather than collapsing to null (an empty bare repeated field is indistinguishable from absent in proto3).
Used in:
optional values = 3
fields 1-2 null; field 3 a present-but-empty string list.
message
orchestration.proto:1976Used in:
optional values = 1
optional unknown_3 = 3
Present-but-empty in the full web request variant.
message
orchestration.proto:1982Used in:
optional unknown_1 = 1
Present-but-empty in the full web request variant.
optional values = 2
field 1 null; field 2 a present-but-empty string list.
message
orchestration.proto:2080Used in:
optional rows = 1
optional content_kind = 2
repeated styles = 3
message
orchestration.proto:2088LoadedSourceContentKind preserves the observed scalar discriminator and present-empty marker variants at LoadedSourceContent position 2.
Used in:
oneof value
int32 kind = 1
empty = 2
message
orchestration.proto:2095Used in:
(message has no fields)
message
orchestration.proto:2143Used in:
string url = 1
optional string alt_text = 2
inferred image description
string image_id = 3
message
orchestration.proto:2116Used in: ,
optional int64 start = 1
optional int64 end = 2
optional text = 3
optional table = 5
optional image = 6
optional code_block = 7
message
orchestration.proto:2111Used in:
repeated rows = 1
optional int32 layout_kind = 2
inferred layout discriminator
message
orchestration.proto:2155Used in:
optional int64 start = 1
optional int64 end = 2
optional text = 3
message
orchestration.proto:2166Used in:
optional bool bold = 1
optional bool italic = 2
inferred formatting flag
optional string link = 4
optional flag_or_font = 5
optional flag_or_color = 6
optional bool annotation_flag = 8
inferred; meaning unconfirmed
optional int32 style_code = 10
inferred; meaning unconfirmed
message
orchestration.proto:2161Used in:
optional string text = 1
optional flags = 2
message
orchestration.proto:2097Used in:
int32 style_id = 1
optional data = 2
message
orchestration.proto:2102Used in:
optional bool bold = 1
optional bool italic = 2
optional bool underline = 3
optional font = 5
optional color = 6
optional bool paragraph_flag = 9
inferred; meaning unconfirmed
message
orchestration.proto:2125Used in:
int32 type_code = 1
int32 columns = 2
repeated rows = 3
message
orchestration.proto:2137Used in:
optional int64 start = 1
optional int64 end = 2
repeated rows = 3
message
orchestration.proto:2131Used in:
optional int64 start = 1
optional int64 end = 2
repeated cells = 3
message
orchestration.proto:2149Used in:
repeated spans = 1
optional style = 2
optional list_item = 4
message
orchestration.proto:2176Used in:
optional int32 nesting_level = 1
inferred heading/list depth
optional int32 style = 2
message
orchestration.proto:3200Used in:
optional marker = 10
Fields 1 through 9 are null in observed requests.
message
orchestration.proto:3188Used in:
optional slot = 1
optional context = 2
int32 enabled = 3
message
orchestration.proto:3205Used in:
int32 code = 3
Fields 1 and 2 are null in observed requests.
message
orchestration.proto:3194Used in:
string surface = 2
Field 1 is null in observed requests.
int32 campaign_id = 3
message
notebooklm.proto:677string title = 1
message
notebooklm.proto:672Used in:
optional int32 version = 1
repeated int32 capability_codes = 11
message
notebooklm.proto:662Used in:
optional int32 version = 1
optional surface = 3
optional caps = 4
message
notebooklm.proto:668Used in:
optional int32 value = 1
message
orchestration.proto:2777Used in:
int32 status_code = 1
message
orchestration.proto:3770Used in:
string model_id = 1
string display_name = 2
bool default_for_chat = 3
message
orchestration.proto:1081MutateAccountCapabilityPair is an observed two-integer capability pair.
Used in:
int32 first = 1
int32 second = 2
message
orchestration.proto:1076MutateAccountCapabilitySet is [null, null, null, [pair...]].
Used in:
repeated pairs = 4
message
orchestration.proto:1071MutateAccountChange carries a capability set at field 5.
Used in:
optional capability_set = 5
message
orchestration.proto:1066MutateAccountUpdate is [null, [change...]]. Pair semantics are unconfirmed.
Used in:
repeated changes = 2
message
orchestration.proto:1061MutateAccountUpdateEnvelope wraps the update at field 1.
Used in:
optional update = 1
message
orchestration.proto:3686Used in:
optional name = 1
Metadata form uses field 1 (name) / field 2 (emoji); the source-attach form leaves field 1 null and carries the source ids at field 2, each id wrapped as ["uuid"] (SourceIdList, the same wrapper Label.sources uses).
repeated sources = 2
repeated alternate_sources = 3
repeated add_projects = 4
CONFIRMED add: a capture attaches a project id here and a later read of the same collection shows that project as a member.
repeated unknown_5 = 5
Same shape as add_projects at the next slot. A capture sends it against a collection that already contains the project, and no later read of that collection was captured, so the effect is UNOBSERVED. Removal is the obvious reading but is not confirmed, so the slot is left unnamed.
message
orchestration.proto:3676MutateLabelMutation is field 4: [[null, [[source_id]]]] (source-attach form) or [[name, emoji]] (metadata form). Field 1 wraps the inner mutation entry.
Used in:
optional entry = 1
optional unknown_2 = 2
Collection mutations carry a trailing list here that is empty in every observed capture, so its element type is unknown. Wrapped so the present-but-empty list marshals to [] rather than null, following the StringList idiom; the field is left unnamed because nothing has been seen inside it.
message
orchestration.proto:2044Used in:
string title = 1
message
orchestration.proto:2040Used in:
optional title = 1
message
orchestration.proto:2036Used in:
optional update = 1
message
notebooklm.proto:317Used as response type in: LabsTailwindOrchestrationService.MutateNote
Used as field type in:
string note_id = 1
string content_text = 2
A freshly created note (CreateNote/CYK0Xb) carries an explicit empty string here; plain proto3 drops it as the default value on re-encode, so that one degenerate CreateNote position is not round-trip-preserved (all content-bearing MutateNote replies are lossless).
optional metadata = 3
string title = 5
string rich_text = 6
repeated int32 note_type = 7
message
orchestration.proto:2410NoteGroundingDetails wraps the unkeyed grounding-detail list at note field 4. For rich notes, each item is byte-for-byte equal to the Grounding part of the corresponding source-keyed GroundingRecord in RichDocument.grounding.
Used in: ,
repeated grounding = 1
message
notebooklm.proto:358NoteMetadata is the note-metadata blob carried at Note position [2] in CreateNote (CYK0Xb) and MutateNote (cYAfTb) replies: [1, "157962509464", [secs, nanos], null, null, [secs, nanos], false] field_1 is a constant 1; note_id_int is the server-side numeric note id (stable across a note's lifetime); the two timestamp pairs are the note's created and last-modified times (equal on the first write, the modified pair advancing on each subsequent MutateNote). Positions [3] and [4] are null in all observed captures; field_7 is a constant false. Modeled with optional scalars so the trailing false and the interior nulls round-trip.
Used in: , , ,
optional int64 version = 1
inferred schema version; observed 1
string note_id_int = 2
server numeric note id (wire: quoted string)
optional created = 3
[secs, nanos]
optional modified = 6
positions [3], [4] are null in observed captures; left unmodeled.
[secs, nanos]
optional bool trailing_flag = 7
Meaning unconfirmed; constant false in observed captures.
message
notebooklm.proto:332NoteRecord is the response-side note tuple. Unlike Note, content_text has presence because CreateNote returns an explicit empty string.
Used in:
string note_id = 1
optional string content_text = 2
optional metadata = 3
string title = 5
string rich_text = 6
repeated int32 note_type = 7
message
orchestration.proto:2382NoteRichText is a shape union. Older notes carry a plain string; rich notes carry the same positional RichDocument tree used by rendered chat content.
Used in: , ,
oneof value
string plain_text = 1
document = 2
message
orchestration.proto:1044Used in:
repeated string tags = 1
message
notebooklm.proto:370NoteTimestamp is an inline [seconds, nanos] pair (two positional int fields, not a wrapped google.protobuf.Timestamp).
Used in:
optional int64 seconds = 1
optional int32 nanos = 2
message
orchestration.proto:1035Used in:
string content = 1
string title = 2
optional tags = 3
optional int32 update_mode = 4
inferred update mode; observed 0
optional int32 state_code = 6
Field 5 is null in observed requests.
inferred state code; observed 0
message
orchestration.proto:1031Used in:
optional update = 1
message
orchestration.proto:1027Used in:
optional update = 1
message
notebooklm.proto:456Used in:
optional summary = 1
optional questions = 2
optional scored_questions = 6
fields 3,4 reserved/unknown (observed null)
message
orchestration.proto:2659OffsetRange is a [null, start, end] character span of the rendered document.
Used in: , , ,
optional int64 start = 2
Position 1 is null in observed captures; left unmodeled.
optional int64 end = 3
message
orchestration.proto:2773Used in:
repeated string states = 1
message
orchestration.proto:3532PlaybackPosition is a positional (seconds, nanos) tuple that mirrors google.protobuf.Duration's two int fields. Used inside ArtifactUserState to record the listener's place in an interactive audio overview.
Used in:
int64 seconds = 1
int32 nanos = 2
message
notebooklm.proto:14Used as response type in: LabsTailwindOrchestrationService.CreateProject, LabsTailwindOrchestrationService.GetProject, LabsTailwindOrchestrationService.MutateProject, LabsTailwindOrchestrationService.MutateProjectCover
Used as field type in: ,
string title = 1
repeated sources = 2
string project_id = 3
string emoji = 4
optional metadata = 6
optional chatbot_config = 8
repeated bool state_flags = 9
Single per-notebook boolean flag (observed [false]); carried positionally.
meaning unconfirmed
repeated bool flags = 10
Three per-notebook capability flags (observed [true,true,true]); exact meaning unconfirmed, so carried positionally.
optional limits = 11
Per-notebook limits/quotas, e.g. [6,500,500,500000,6] or, on a few notebooks, [null,500,600,500000,3] with the first slot elided — modeled as a message of optional fields so a null slot round-trips as null rather than breaking a repeated int64 (which cannot hold a null element).
optional cover_presentation = 15
Cover-image/presentation block for the notebook, e.g. [false, [[id, filename, 1, 2, image_url]], null, "Summary here", false]. Same positional shape as orchestration.proto's FeaturedProjectPresentation / FeaturedProjectImage (not reused directly to avoid a circular import: orchestration.proto already imports this file).
message
orchestration.proto:882ProjectAnalyticsBuckets retains the observed one-field wrapper around the repeated metric buckets.
Used in:
optional points = 1
message
orchestration.proto:893ProjectAnalyticsPoint is one [timestamp, null, value] metric bucket.
Used in:
optional time = 1
int32 value = 3
message
orchestration.proto:888ProjectAnalyticsPointList retains the second observed wrapper around the repeated metric buckets.
Used in:
repeated points = 1
message
orchestration.proto:875ProjectAnalyticsSeries contains the time buckets for one metric.
Used in:
int32 metric_id = 1
optional buckets = 2
message
sharing.proto:110ProjectCollaborator is one per-user wire entry: [email, role_int, [], [display_name, avatar_url]]. Field 3 is an empty list in observed captures; the display name and avatar live in a nested profile at position 4. role_int 1 = OWNER.
Used in:
string email = 1
int32 role = 2
optional tags = 3
[] in observed captures
optional profile = 4
[display_name, avatar_url]
message
sharing.proto:120ProjectCollaboratorTags is the empty list at collaborator entry position 3. Modeled as a present-but-empty message so the [] round-trips (rather than collapsing to null).
Used in:
repeated string tags = 1
message
notebooklm.proto:64ProjectCoverImage: [id, filename, position, image_kind, image_url]. Field 1 holds a UUID (not a URL) in this context, unlike orchestration.proto's FeaturedProjectImage.url — otherwise the same shape.
Used in:
optional string id = 1
optional string filename = 2
Original image filename.
optional int64 position = 3
confirmed 1-based image position
optional int64 image_kind = 4
inferred image-kind code; observed 2
optional string image_url = 5
Serving URL for the image (lh3.googleusercontent.com/notebooklm/…).
message
orchestration.proto:2006Used in:
optional unknown_4 = 4
Fields 1 through 7 are null in observed requests.
optional cover = 8
message
orchestration.proto:2014ProjectCoverMutationUnknown4 is the [null, title] metadata tuple observed on a project cover mutation. Its semantics are unconfirmed.
Used in:
string value = 2
message
notebooklm.proto:52ProjectCoverPresentation is Project field 15: a cover-image/presentation block, positionally identical to orchestration.proto's FeaturedProjectPresentation.
Used in:
optional bool curated = 1
repeated images = 2
optional string provider = 3
optional string description = 4
optional bool presentation_flag = 5
Meaning unconfirmed; varies among featured presentations.
message
orchestration.proto:2018Used in:
optional unknown_1 = 1
Semantics unconfirmed. Observed as [8], [7], and [2] in cover mutations, and as [] in the legacy preset-only variant.
optional preset = 2
message
orchestration.proto:2025Used in:
int32 value = 1
message
sharing.proto:94ProjectDetailsFlags is the visibility flags tuple at ProjectDetails[1]: [flag_0, flag_1], both true when the notebook is fully public. Present as null when private.
Used in:
optional bool flag_0 = 1
optional bool flag_1 = 2
message
sharing.proto:100ProjectDetailsPermissions is the [3, true, true] blob at ProjectDetails[6].
Used in:
optional int64 code = 1
optional bool flag_1 = 2
optional bool flag_2 = 3
message
notebooklm.proto:41ProjectLimits is Project field 11: a 5-slot quota tuple. Modeled as optional fields (not repeated int64) because the first slot is null on some notebooks.
Used in:
optional int64 tier = 1
observed 6, or null
optional int64 notebook_limit = 2
observed 500
optional int64 source_limit = 3
observed 500/600
optional int64 upload_limit = 4
observed 500000
optional int64 tier_2 = 5
observed 6/3
message
notebooklm.proto:74Used in: ,
int32 user_role = 1
optional bool session_active = 2
or similar
optional bool is_initialized = 3
Meaning inferred; true in every observed owned and featured project.
optional create_time = 9
field 4 reserved/unknown field 5 reserved/unknown
optional modified_time = 6
or similar
int32 type = 7
optional bool is_starred = 8
optional bool is_shared = 13
Inferred from false on owned projects and true on public featured ones.
optional bool is_accessible = 14
Meaning unconfirmed; true in every observed project.
optional int64 access_state = 15
inferred access code; observed 1
optional bool is_read_only = 16
Inferred from false on owned projects and true on public featured ones.
optional bool secondary_access_flag = 18
Meaning unconfirmed; varies independently among featured projects.
optional int64 sharing_state = 19
inferred sharing code; observed 1/3
optional ownership_details = 20
[null, [null, 1]]: small nested message, meaning unconfirmed.
inferred; present on owned projects
optional bool discovery_flag = 23
Meaning unconfirmed; varies among featured projects.
message
notebooklm.proto:104ProjectMetadataExtra is ProjectMetadata field 20: [null, [null, 1]]. Field 1 is null in all observed captures; field 2 is itself a 2-field message whose own field 1 is null and field 2 an observed int (1).
Used in:
optional detail = 2
field 1 ([0]) is null in all observed captures; left unmodeled.
[1]
message
notebooklm.proto:109Used in:
optional bool recent_project_flag = 1
Observed true in ListRecentlyViewedProjects captures (null in GetProject).
optional int32 ownership_code = 2
[1] inferred; observed 1/2
message
sharing.proto:126ProjectUserProfile is the [display_name, avatar_url] pair carried at collaborator entry position 4.
Used in:
string display_name = 1
string avatar_url = 2
message
orchestration.proto:3257PromoCard is one upsell-card placement.
Used in:
int32 id = 1
[0] e.g. 2230 (matches slot campaign)
optional render = 2
[1] rendering payload
optional int32 placement_id = 4
field 3 ([2]) null in all captures; left unmodeled. placement_id is inferred from its reuse in the event context.
[3] e.g. 2351
optional int32 placement_id_copy = 5
[4] confirmed duplicate of placement_id
optional int32 card_id_copy = 6
[5] confirmed duplicate of id
string user_tier = 7
[6] e.g. "NOTEBOOKLM_TIER_ULTRA_LIGHT_CONSUMER_USER"
optional bool display_flag = 10
fields 8, 9 ([7], [8]) null in all captures; left unmodeled. Meaning unconfirmed; false in every observed card.
[9]
optional refs = 11
field 11 ([10]) is a present-but-empty list in all captures; wrapped so the empty repeated marshals to [] not null.
message
orchestration.proto:3297PromoCardAction is the "Manage subscription" call-to-action.
Used in:
optional link = 1
[0]
optional string label = 4
fields 2, 3 ([1], [2]) null in all captures; left unmodeled.
[3] e.g. "Manage subscription"
optional string aria_label = 6
field 5 ([4]) null in all captures; left unmodeled.
[5] dup of label
optional click_event = 9
fields 7, 8 ([6], [7]) null in all captures; left unmodeled.
[8] click tracking
message
orchestration.proto:3284PromoCardContent pairs the card's icon with its click action.
Used in:
optional icon = 1
[0]
optional action = 2
[1]
message
orchestration.proto:3320PromoCardEvent wraps a logged UI event: [context, kinds, token, sig].
Used in: ,
optional context = 1
[0]
repeated int32 kinds = 2
[1] e.g. [2] (click) or [14] (impression)
optional string token = 3
[2] opaque base64 tracking token
optional string signature = 4
[3] opaque base64 signature
message
orchestration.proto:3329PromoCardEventContext carries the placement coordinates repeated in both the click and impression events.
Used in:
optional int32 card_id = 1
[0] confirmed match to PromoCard.id
optional int32 placement_id = 2
[1] inferred placement coordinate
optional int32 context_code = 4
field 3 ([2]) null in all captures; left unmodeled. Meaning unconfirmed; observed as 43 in both event kinds.
[3]
optional int32 click_marker = 5
Confirmed discriminator: 1 on click, absent on impression.
[4]
optional slot = 7
field 6 ([5]) null in all captures; left unmodeled.
[6]
optional refs = 9
field 8 ([7]) null in all captures; left unmodeled. [8] present on click ([[ref]], wrapped one extra layer like SpanList/SourceIssueList), absent (null) on impression.
optional int32 campaign_id = 11
field 10 ([9]) null in all captures; left unmodeled.
[10] confirmed match to PromoSlot.campaign_id
optional int32 placement_id_copy = 12
[11] confirmed duplicate of placement_id
optional string tracking_id = 14
field 13 ([12]) null in all captures; left unmodeled.
[13] large signed decimal string
message
orchestration.proto:3290PromoCardIcon: [null, icon_name, glyph_id].
Used in:
optional string name = 2
field 1 ([0]) null in all captures; left unmodeled.
[1] e.g. "NotebookLM icon"
optional string glyph = 3
[2] e.g. "edit"
message
orchestration.proto:3314PromoCardLink: [null, null, url].
Used in:
optional string url = 3
fields 1, 2 ([0], [1]) null in all captures; left unmodeled.
[2]
message
orchestration.proto:3308PromoCardLinkWrapper: [[null, null, url], enabled_flag].
Used in:
optional link = 1
optional bool disabled = 2
observed false
message
orchestration.proto:3351PromoCardRef: [id, campaign_id, tags].
Used in:
optional int32 id = 1
[0] e.g. 2230
optional int32 campaign_id = 2
[1] e.g. 627
repeated int32 tags = 3
[2] e.g. [9]
message
orchestration.proto:3360PromoCardRefList wraps PromoCard.refs: present-but-empty in all captures, so it needs the wrapper idiom (see SpanList) to round-trip [] instead of collapsing to null.
Used in: ,
repeated refs = 1
message
orchestration.proto:3276PromoCardRender is the 21-position rendering blob for a PromoCard. Only positions 10 and 21 carry data in observed captures.
Used in:
optional content = 10
fields 1-9 ([0]-[8]) null in all captures; left unmodeled.
[9] icon + action
optional impression_event = 21
fields 11-20 ([10]-[19]) null in all captures; left unmodeled.
[20] impression tracking
message
orchestration.proto:3237PromoLogEntry is one acknowledged log event: [slot, cards, status].
Used in:
optional slot = 1
[0] slot/campaign descriptor, e.g. [null, "1", 627].
repeated cards = 2
[1] repeated upsell cards (one observed per response).
optional int32 status = 3
[2] observed 0 in all captures; needs presence to avoid collapsing to null on empty re-encode.
message
orchestration.proto:3250PromoSlot identifies a promo placement: [_, surface_locale, campaign_id]. Reused both as the top-level slot and nested inside PromoCardEventContext.
Used in: ,
optional string surface = 2
field 1 ([0]) is null in all observed captures; left unmodeled.
[1] e.g. "1"
optional int32 campaign_id = 3
[2] e.g. 627
message
sharing.proto:208Used in:
bool is_public = 1
repeated string tags = 2
message
orchestration.proto:165string title = 1
string content = 2
repeated sections = 3
message
orchestration.proto:849Used in:
string title = 1
string description = 2
repeated source_ids = 4
field 3 is null in observed responses
string prompt = 5
int32 count = 6
message
orchestration.proto:50RequestArtifactTypeFilter is RequestContext field 5: [[1,4,8,10,2,3,6,9]].
Used in: ,
repeated int32 types = 1
message
orchestration.proto:43RequestClientCaps is RequestContext field 4: [1, null×9, [1]] (11 elements).
Used in: , , , , ,
optional int32 version = 1
inferred capability-envelope version; observed 1
repeated int32 capability_codes = 11
Fields 2-10 ([1]-[9]) are null in every observed request; left unmodeled.
observed [1]; code meaning unconfirmed
message
orchestration.proto:26RequestContext is the client-capabilities preamble the web UI prepends to most orchestration requests. Observed as [2, null, null, [1, null×8, [1]]] — with an extra artifact-type filter list at field 5 in ListArtifacts.
Used in: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,
optional int32 version = 1
Observed constant 2 (protocol/surface version).
optional surface = 3
Field 2 ([1]) is null in every observed request.
optional caps = 4
optional artifact_types = 5
ListArtifacts prepends the requested artifact-type filter here, e.g. [[1, 4, 8, 10, 2, 3, 6, 9]]; absent (null) on other requests.
message
orchestration.proto:38RequestSurface is the optional [1] marker carried by some UI reads.
Used in: , , , ,
optional int32 value = 1
message
orchestration.proto:3403Used in:
string query = 1
int32 mode = 2
message
notebooklm.proto:120Used in:
int32 value = 1
message
orchestration.proto:3408optional artifact = 1
wire shape unverified; capture HAR before encoding
message
notebooklm.proto:210Used in:
string revision_id = 1
Revision identifier (UUID).
optional revision_time = 2
message
orchestration.proto:2307RichContent is an assistant turn's structured payload: [segment, [grounding...], [], [annotation...]]. The segment carries the text and rich-text document; the grounding and annotation lists tie the reply back to its sources.
Used in:
optional segment = 1
[0] text + rich document
repeated grounding = 2
[1] reply-to-source grounding
repeated annotations = 4
Field 3 ([2]) is an empty array in observed captures; left unmodeled.
[3] source annotation index
message
orchestration.proto:2345RichDocument is the rendered rich-text form of an assistant turn: a tree of character-offset spans plus per-source grounding records. It is the [body, [], [], grounding, flag] payload at ContentSegment field 5.
Used in: , , , , ,
optional body = 1
repeated grounding = 4
Fields 2 and 3 are empty arrays in observed captures; left unmodeled.
int64 flag = 5
small int (1); meaning TBD
message
orchestration.proto:171Used in:
string title = 1
string content = 2
message
orchestration.proto:2768Used in:
int32 trigger_type = 1
string utterance_id = 2
message
orchestration.proto:2486Separator marks a zero-content boundary span. It is empty on the wire ([]) but present, distinguishing a separator span from an ordinary one.
Used in:
(message has no fields)
Additional message not in sharing.proto
bool public = 1
repeated string emails = 2
Used in: , ,
bool is_public = 1
repeated string allowed_emails = 2
bool allow_comments = 3
bool allow_downloads = 4
optional expiry_time = 5
message
notebooklm.proto:133Used as response type in: LabsTailwindOrchestrationService.MutateSource, LabsTailwindOrchestrationService.RefreshSource
Used as field type in: , , , , ,
optional source_id = 1
string title = 2
optional metadata = 3
optional settings = 4
repeated int32 warnings = 5
Observed as bare integers. Their semantics are unconfirmed.
string download_url = 6
Content-download URL (usercontent.google.com/download?c=…).
string viewer_url = 7
Drive viewer/upload URL for the source blob.
optional blob = 8
Blob reference describing the stored source content.
message
orchestration.proto:2648SourceAnnotation maps an offset range of the rendered document back to a source: [[source_id], [null, start, end]].
Used in:
optional source = 1
[0] [source_id]
optional range = 2
[1] [null, start, end]
message
notebooklm.proto:148Used in:
string blob_ref = 1
Blobref path, e.g. "/contrib_service/blobrefs/notebooklm/nos_files/…".
string mime_type = 3
field 2 reserved/unknown (observed null)
optional tokens = 4
Opaque upload tokens carried with the blob.
message
notebooklm.proto:200Used in:
string document_id = 1
Drive/document identifier for the file.
int64 size = 2
Size in pages or units (observed 59 for a PDF).
string mime_type = 3
optional string resource_key = 4
Inferred Drive resource key; observed as an explicit empty string.
message
notebooklm.proto:129Used in: ,
string source_id = 1
message
orchestration.proto:2654SourceIdList wraps a single source UUID in its own array ([source_id]).
Used in: , , , , , , , , , , , , , , , , , , , , , ,
string source_id = 1
message
orchestration.proto:962Used in:
optional google_docs = 1
Google Docs import: [drive_id, mime_type, 1, drive_id].
optional text = 2
optional int32 input_type = 4
Field 3 is null in observed text-import requests.
observed 3
optional int32 import_mode = 11
Fields 5-10 are null in observed text-import requests.
inferred import mode; observed 1
message
notebooklm.proto:295Used in:
SourceIssue.Reason reason = 1
Used in:
REASON_UNSPECIFIED = 0
REASON_TEMPORARY_SERVER_ERROR = 1
REASON_PERMANENT_SERVER_ERROR = 2
REASON_INVALID_SOURCE_ID = 3
REASON_SOURCE_NOT_FOUND = 4
REASON_UNSUPPORTED_MIME_TYPE = 5
REASON_YOUTUBE_ERROR_GENERIC = 6
REASON_YOUTUBE_ERROR_UNLISTED = 7
REASON_YOUTUBE_ERROR_PRIVATE = 8
REASON_YOUTUBE_ERROR_MEMBERS_ONLY = 9
REASON_YOUTUBE_ERROR_LOGIN_REQUIRED = 10
REASON_GOOGLE_DOCS_ERROR_GENERIC = 11
REASON_GOOGLE_DOCS_ERROR_NO_ACCESS = 12
REASON_GOOGLE_DOCS_ERROR_UNKNOWN = 13
REASON_DOWNLOAD_FAILURE = 14
REASON_UNKNOWN = 15
message
notebooklm.proto:291Used in:
repeated issues = 1
message
notebooklm.proto:191SourceLanguageDetection is SourceMetadata field 17: [[[lang, confidence], ...]] — field 1 wraps the ranked guess list.
Used in:
repeated guesses = 1
message
notebooklm.proto:195Used in:
string language = 1
BCP-47 code, e.g. "en", "lb"
double confidence = 2
0..1
message
notebooklm.proto:161Used in:
oneof metadata_type
google_docs = 1
youtube = 6
optional last_update_time_seconds = 2
optional last_modified_time = 3
optional revision_data = 4
optional SourceType source_type = 5
Present zero is distinct from an omitted source type on the wire.
SourceSettings.SourceStatus status = 7
repeated string source_urls = 8
Source origin URL(s), e.g. the web page or Gutenberg URL a source was imported from.
optional int64 content_length = 9
inferred source length/count; unit unconfirmed
optional file = 10
Underlying file descriptor for uploaded/imported sources.
string heading = 12
Human-readable source title/heading.
optional indexed_time = 15
optional language_detection = 17
Detected source languages with confidence scores, e.g. [[["en", 0.988], ["lb", 0.012]]] — an outer list carrying one ranked list of [lang, confidence] guesses.
string mime_type = 20
Source MIME type, e.g. "application/pdf".
message
sharing.proto:269Used in:
string source_id = 1
string title = 2
string excerpt = 3
message
notebooklm.proto:247Used in:
SourceSettings.SourceStatus status = 2
optional detail = 3
Reason/issue detail for a source in an error or disabled state (observed [null,null,[]] — only the repeated issue list at field 3 is populated, empty when the source is healthy).
optional int32 unknown_4 = 4
Observed as 0 and 3; meaning unconfirmed.
Used in: ,
SOURCE_STATUS_UNSPECIFIED = 0
SOURCE_STATUS_ENABLED = 1
SOURCE_STATUS_DISABLED = 2
SOURCE_STATUS_ERROR = 3
message
notebooklm.proto:263Used in:
optional size = 2
field 1 reserved/unknown Size/quota triple observed [null, 650690, 500000] on some sources.
optional issues = 3
Issue list for the source, always present (empty [] when the source is healthy).
optional detail_codes = 4
Present-but-empty in most captures; individual code meanings unconfirmed.
optional unknown_5 = 5
Present-but-empty in a source settings variant; meanings unconfirmed.
repeated int64 state_codes = 7
Observed [1]; individual code meanings unconfirmed.
message
notebooklm.proto:287SourceSettingsIntList wraps a repeated int64 so a present-but-empty list round-trips as [] rather than null.
Used in:
repeated int64 items = 1
message
notebooklm.proto:280SourceSettingsSize is SourceSettingsDetail field 2: [null, 650690, 500000], a byte/char size pair (field 1 null in observed captures).
Used in:
optional int64 content_size = 2
inferred current size; observed 650690
optional int64 size_limit = 3
inferred limit; observed 500000
message
sharing.proto:131Used in:
string source_id = 1
string title = 2
SourceType source_type = 3
message
orchestration.proto:982Used in:
string title = 1
string content = 2
Used in: ,
SOURCE_TYPE_UNSPECIFIED = 0
SOURCE_TYPE_UNKNOWN = 1
SOURCE_TYPE_GOOGLE_DOCS = 2
SOURCE_TYPE_GOOGLE_SLIDES = 3
SOURCE_TYPE_TEXT = 4
SOURCE_TYPE_WEB_PAGE = 5
SOURCE_TYPE_LOCAL_FILE = 6
SOURCE_TYPE_GOOGLE_SHEETS = 7
SOURCE_TYPE_SHARED_NOTE = 8
SOURCE_TYPE_YOUTUBE_VIDEO = 9
message
orchestration.proto:2426Span is one character-offset range [start, end] of the rendered document and its content. Spans nest recursively: a block span's content is a group of child spans, a leaf span's content is text. content is a shape union (see SpanContent).
Used in: , , ,
optional int64 start = 1
Offsets are explicitly present so a legitimate 0 (the document start) round-trips as 0 rather than an absent null.
optional int64 end = 2
optional content = 3
optional image = 4
Inline images carry [image_url, null, image_id] at position 4 instead of text content. The URL is an authenticated NotebookLM media URL; image_id is the stable UUID for the embedded image.
optional table = 5
table carries a [type_code, columns, rows] table block instead of the usual content/hidden_content shapes; fields 1-4 and 6-11 are null when it is present.
optional code_block = 7
Code blocks carry a [code_text, language] pair at position 7 instead of the usual content (fields 3..6 and 8..11 are null). start/end still bound the block within the document.
optional hidden_content = 9
Hidden/thinking blocks carry their content at position 9 instead of 3 (fields 4..8 are null). The content is the same recursive span shape.
optional separator = 12
Separator spans (e.g. the empty [432,433] between blocks) carry an empty marker array at position 12 instead of content; fields 4..11 are null. Modeled as a present-but-empty message so the trailing [] round-trips.
message
orchestration.proto:2492SpanCodeBlock is a fenced code block within a rich-text document: [code_text, language]. Carried at Span position 7. Observed languages include "protobuf" and "go".
Used in: ,
string code = 1
optional string language = 2
message
orchestration.proto:2500SpanContent is a shape union: a span holds EITHER a text leaf (["text"] or ["text", marks]) OR a group of nested child spans ([[spans], ...]), at the same wire position. beprotojson selects the case by shape.
Used in:
oneof value
leaf = 1
["text", marks?]
group = 2
[[spans], meta?, null?, items?]
message
orchestration.proto:2526SpanElement is a shape union used by SpanGroup.spans. Most entries are the normal [start, end, content] Span shape, but some captures contain a bare integer leaf (for example 0 or 11) at the same repeated position.
Used in:
oneof value
int64 scalar = 1
span = 2
message
orchestration.proto:2516SpanGroup is a container span's content: a list of child spans plus optional layout metadata.
Used in:
repeated spans = 1
[0] child spans or scalar leaves
optional meta = 2
[1] e.g. [null, indent]
optional list_item = 4
Field 3 ([2]) is null in observed captures; left unmodeled.
[3] list-item style
message
orchestration.proto:2596SpanGroupMeta is the [null, indent, flag?] metadata trailing a span group.
Used in:
optional int64 indent = 2
Position 1 is null in observed captures; left unmodeled.
optional bool flag = 3
flag is seen true on at least one non-offline-resource notice span; meaning not yet confirmed.
message
orchestration.proto:2478SpanImage is an inline image reference: [image_url, null, image_id].
Used in:
string image_url = 1
string image_id = 3
Position 2 is null in observed captures; left unmodeled.
message
orchestration.proto:2417SpanLayers holds the document body as two parallel layers over the same text: the block tree (headings, paragraphs, list items) and a per-source annotation index mapping offset ranges back to their source.
Used in:
repeated blocks = 1
repeated annotations = 2
message
orchestration.proto:2686SpanList wraps a list of spans in one extra array layer ([[span...]]), the shape grounding uses for its source spans.
Used in:
repeated spans = 1
message
orchestration.proto:2456SpanTable is a table block within a rich-text document: [type_code, columns, rows]. Observed type codes vary; their meaning is not yet known. columns is the column count; each row contains nested cell Spans.
Used in:
optional int64 type_code = 1
optional int64 columns = 2
repeated rows = 3
message
orchestration.proto:2465SpanTableRow is one table row: [start, end, cells]. Its content is a bare list of cell Spans, unlike an ordinary Span's content (which goes through the SpanContent leaf/group shape union), so it is not itself a Span.
Used in:
optional int64 start = 1
optional int64 end = 2
repeated cells = 3
optional meta = 4
message
orchestration.proto:2473SpanTableRowMeta is the [null, flag] trailer on table rows.
Used in:
optional bool flag = 2
message
orchestration.proto:2888Used as response type in: LabsTailwindOrchestrationService.StartDeepResearch, LabsTailwindOrchestrationService.StartDeepResearchWire
string research_id = 1
string conversation_id = 2
message
orchestration.proto:2724Used in:
string text = 1
Field 1 carries the human-readable status string when present.
message
orchestration.proto:1991StringList wraps a repeated string so a present-but-empty list marshals as [] instead of null. Mirrors the SourceIssueList idiom.
Used in: , , , ,
repeated string items = 1
message
orchestration.proto:2244SubmitFeedbackContent carries the question and full answer context.
Used in:
string prompt = 1
repeated string answers = 2
message
orchestration.proto:2238SubmitFeedbackSignal preserves the observed selector shape. The values' meanings are unconfirmed because only one direction is captured.
Used in:
int32 unknown_1 = 1
repeated int32 unknown_4 = 4
message
orchestration.proto:2230SubmitFeedbackTurn identifies the conversation turn that supplied feedback.
Used in:
string conversation_id = 1
string turn_id = 2
int64 opaque_number = 3
semantics unconfirmed
message
orchestration.proto:2761Used in:
int32 event_type = 1
string utterance_id = 2
int32 segment_idx = 3
optional timestamp = 4
message
orchestration.proto:2756Used in:
int64 epoch_sec = 1
int32 nanos = 2
message
orchestration.proto:159Used in:
string text = 1
int32 start_offset = 2
int32 end_offset = 3
message
orchestration.proto:2509TextLeaf is the innermost span content: a run of text with optional positional formatting marks.
Used in:
optional string text = 1
optional marks = 2
[null x7, bold?] positional flags
message
orchestration.proto:2589Used in: ,
optional int32 red = 1
optional int32 green = 2
optional int32 blue = 3
message
orchestration.proto:2582TextMarkColorOrFlag is a shape union. Position 6 is a boolean formatting flag in older spans and an [red, green, blue] tuple in styled rich text.
Used in: ,
oneof value
bool flag = 1
color = 2
message
orchestration.proto:2574Used in: ,
string family = 1
optional int32 weight = 2
optional int32 size = 3
message
orchestration.proto:2567TextMarkFontOrFlag is a shape union. Position 5 is a boolean formatting flag in older spans and a [font_family, weight] tuple in styled rich text.
Used in: ,
oneof value
bool flag = 1
font = 2
message
orchestration.proto:2552TextMarks carries the positional formatting marks on a text leaf. Observed forms include [true] (flag1, on inline headings/labels), [null x7, true] (flag8, on code/identifier runs), and [null, null, null, url] (link, a hyperlink target). Boolean marks are carried as JSON booleans on the wire, not batchexecute's 1/0; exact bold/italic/code meanings are not yet confirmed, so they are modeled generically. KNOWN ASYMMETRY, deliberately not modeled: responses carry these flags as JSON booleans but CYK0Xb requests carry the identical structure with 1/0 instead ([0,0,0,null,null,null,null,0,0] against [false,false,false,null,null,null,null,false,false]). The split is by direction and absolute across the corpus — 1960 numeric occurrences on requests, 1931 boolean on responses, no crossover — with no discriminator field to key on. json_bool is a static per-field choice, so no single setting round-trips both, and the same asymmetry affects ListItem and SpanTableRowMeta. Preserving it would mean either a form-remembering codec or a duplicate request-side span tree, both of which touch the shared path that carries ~687k spans, for a field no client of this package sends. Two CYK0Xb request records therefore stay lossy on purpose.
Used in:
optional bool flag1 = 1
optional bool flag2 = 2
optional bool flag3 = 3
string link = 4
[3] hyperlink target URL
optional flag_or_font = 5
optional flag_or_color = 6
optional bool flag7 = 7
optional bool flag8 = 8
optional bool flag9 = 9
observed true on code/identifier runs
optional int64 style_code = 10
inferred style code; observed 2
message
orchestration.proto:208TimestampPair wraps a [seconds, nanos] pair so it can be present-but-empty ([]) on the wire, distinct from being absent (null).
Used in:
optional int64 seconds = 1
optional int64 nanos = 2
message
orchestration.proto:585Used in:
int32 kind = 3
Fields 1 and 2 are null in observed requests.
repeated source_groups = 4
optional audio = 7
Fields 5 and 6 are null in observed requests.
optional video = 9
Field 8 is null in observed requests.
optional unknown_10 = 10
Fields 11 through 14 and 16 are null in observed requests.
repeated mind_map_configs = 15
Observed as custom mind-map configuration. Repetition semantics are unconfirmed.
repeated slides = 17
message
orchestration.proto:603UniversalArtifactOptionsUnknown10 is the observed [null, [kind, null, optional_text]] trailer. Its semantics are unconfirmed.
Used in:
optional details = 2
message
orchestration.proto:607Used in:
int32 value = 1
string text = 3
message
orchestration.proto:612Used in:
optional source = 1
message
orchestration.proto:646Used in:
string source_id = 1
message
orchestration.proto:621Used in:
string prompt = 1
Present when an audio request carries a custom prompt.
int32 style = 2
repeated sources = 4
Field 3 is null in observed requests.
string language = 5
int32 enabled = 7
Field 6 is null in observed requests.
message
orchestration.proto:616Used in:
optional details = 2
Field 1 is null in observed requests.
message
orchestration.proto:650Used in:
string unknown_1 = 1
Semantics unconfirmed. Observed as a plan-mode instruction string.
string language = 2
int32 format = 3
int32 style = 4
message
orchestration.proto:637Used in:
repeated sources = 1
string language = 2
optional string prompt = 3
int32 style = 5
Field 4 is null in observed requests.
optional int32 unknown_6 = 6
semantics unconfirmed
message
orchestration.proto:632Used in:
optional details = 3
Fields 1 and 2 are null in observed requests.
message
orchestration.proto:3804UpdateProjectUserStateKeys is field 4: [["notebook_lm_state...."]]. Field 1 is the repeated list of dotted state-key paths being updated (e.g. "notebook_lm_state.saved_source_panel_view").
Used in:
repeated string keys = 1
message
orchestration.proto:3814Used in:
optional bool pinned = 1
Pinned-state responses carry true here; saved-panel responses carry null.
int32 status = 2
message
orchestration.proto:3790UpdateProjectUserStateValue is field 3: [null, [null, 2]].
Used in:
optional detail = 2
field 1 ([0]) is null in the observed capture; left unmodeled.
message
orchestration.proto:3795Used in:
optional int32 pinned = 1
Pinned-state requests carry numeric 1 here; saved-panel requests carry null.
optional int32 value = 2
confirmed state value; observed 2
message
orchestration.proto:2742Used in:
string transcript = 3
bool is_final = 4
string utterance_id = 5
message
notebooklm.proto:396string status = 1
string content = 2
string instructions = 3
string video_id = 4
string video_url = 5
string title = 6
int32 style = 7
Video style (1=autoselect, 2=classic, 3=whiteboard)
Video style options (confirmed from /tmp/notebooklm3.har analysis)
Used in:
VIDEO_STYLE_UNSPECIFIED = 0
VIDEO_STYLE_AUTOSELECT = 1
Let system choose the best style
VIDEO_STYLE_CLASSIC = 2
Classic presentation style
VIDEO_STYLE_WHITEBOARD = 3
Whiteboard-style presentation
message
notebooklm.proto:239Used in:
string youtube_url = 1
string video_id = 2
string channel = 3
Channel or uploader name.