notebooklm 4.7.0

data/lib/notebooklm/generated.rb

@@ -0,0 +1,2068 @@
+# frozen_string_literal: true
+
+# @generated by scripts/build-ruby-client.mjs from deployment/docs/openapi.yaml
+# — do not edit by hand. Run `npm run ruby:sync`.
+#
+# A hand-written client stops at the routes someone remembered. This one is
+# the specification, so a new operation reaches a Ruby caller on the release
+# that ships it.
+
+module NotebookLM
+  # The root route is not wrapped in the success envelope: it is the server's own banner, and it lists every other route.
+  class ServerInfo < Model
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :version, 'version'
+    # @return [String]
+    field :docs, 'docs'
+    # @return [Object]
+    field :endpoints, 'endpoints'
+  end
+
+  # The `GetHealthData` shape.
+  class GetHealthData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [Boolean]
+    field :authenticated, 'authenticated'
+    # @return [String]
+    field :notebook_url, 'notebook_url'
+    # @return [Integer]
+    field :active_sessions, 'active_sessions'
+    # @return [Integer]
+    field :max_sessions, 'max_sessions'
+    # @return [Integer]
+    field :session_timeout, 'session_timeout'
+    # @return [Integer]
+    field :total_messages, 'total_messages'
+    # @return [Boolean]
+    field :headless, 'headless'
+    # @return [Boolean]
+    field :auto_login_enabled, 'auto_login_enabled'
+    # @return [Boolean]
+    field :stealth_enabled, 'stealth_enabled'
+    # @return [String]
+    field :troubleshooting_tip, 'troubleshooting_tip'
+  end
+
+  # A UTCP manual, whose shape belongs to the client's own model rather than to this server. Every url is rebased onto the address the request arrived at.
+  class UtcpManual < Model
+    # @return [String]
+    field :utcp_version, 'utcp_version'
+    # @return [String]
+    field :manual_version, 'manual_version'
+    # @return [Array<UtcpManualToolsItem>]
+    field :tools, 'tools', type: 'UtcpManualToolsItem', array: true
+  end
+
+  # The `UtcpManualToolsItem` shape.
+  class UtcpManualToolsItem < Model
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [Object]
+    field :inputs, 'inputs'
+    # @return [Object]
+    field :outputs, 'outputs'
+    # @return [UtcpManualToolsItemToolCallTemplate]
+    field :tool_call_template, 'tool_call_template', type: 'UtcpManualToolsItemToolCallTemplate'
+  end
+
+  # The `UtcpManualToolsItemToolCallTemplate` shape.
+  class UtcpManualToolsItemToolCallTemplate < Model
+    # @return [String]
+    field :call_template_type, 'call_template_type'
+    # @return [String]
+    field :http_method, 'http_method'
+    # @return [String]
+    field :url, 'url'
+    # @return [String]
+    field :content_type, 'content_type'
+    # @return [String]
+    field :body_field, 'body_field'
+    # @return [UtcpManualToolsItemToolCallTemplateAuth]
+    field :auth, 'auth', type: 'UtcpManualToolsItemToolCallTemplateAuth'
+  end
+
+  # The `UtcpManualToolsItemToolCallTemplateAuth` shape.
+  class UtcpManualToolsItemToolCallTemplateAuth < Model
+    # @return [String]
+    field :auth_type, 'auth_type'
+    # @return [String]
+    field :api_key, 'api_key'
+    # @return [String]
+    field :var_name, 'var_name'
+    # @return [String]
+    field :location, 'location'
+  end
+
+  # The `SetupAuthData` shape.
+  class SetupAuthData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :message, 'message'
+  end
+
+  # The `DeAuthData` shape.
+  class DeAuthData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :message, 'message'
+    # @return [Boolean]
+    field :authenticated, 'authenticated'
+  end
+
+  # The `ReAuthData` shape.
+  class ReAuthData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :message, 'message'
+    # @return [Boolean]
+    field :authenticated, 'authenticated'
+    # @return [Float]
+    field :duration_seconds, 'duration_seconds'
+  end
+
+  # The `AskQuestionData` shape.
+  class AskQuestionData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :question, 'question'
+    # @return [String]
+    field :answer, 'answer'
+    # @return [String]
+    field :session_id, 'session_id'
+    # @return [String]
+    field :notebook_url, 'notebook_url'
+    # @return [AskQuestionDataSessionInfo]
+    field :session_info, 'session_info', type: 'AskQuestionDataSessionInfo'
+    # Present when the question asked for a source format other than `none`. The reference's second example, which its first does not show.
+    # @return [AskQuestionDataSources]
+    field :sources, 'sources', type: 'AskQuestionDataSources'
+  end
+
+  # The `AskQuestionDataSessionInfo` shape.
+  class AskQuestionDataSessionInfo < Model
+    # @return [Integer]
+    field :age_seconds, 'age_seconds'
+    # @return [Integer]
+    field :message_count, 'message_count'
+    # @return [Integer]
+    field :last_activity, 'last_activity'
+  end
+
+  # Present when the question asked for a source format other than `none`. The reference's second example, which its first does not show.
+  class AskQuestionDataSources < Model
+    # @return [String]
+    field :format, 'format'
+    # @return [Boolean]
+    field :extraction_success, 'extraction_success'
+    # @return [Array<AskQuestionDataSourcesCitationsItem>]
+    field :citations, 'citations', type: 'AskQuestionDataSourcesCitationsItem', array: true
+  end
+
+  # The `AskQuestionDataSourcesCitationsItem` shape.
+  class AskQuestionDataSourcesCitationsItem < Model
+    # @return [String]
+    field :marker, 'marker'
+    # @return [Integer]
+    field :number, 'number'
+    # The quoted passage. Empty when the citation resolved to a source with no excerpt — reported empty rather than filled with the filename.
+    # @return [String]
+    field :source_text, 'sourceText'
+    # @return [String, nil]
+    field :source_name, 'sourceName'
+  end
+
+  # The `ListNotebooksData` shape.
+  class ListNotebooksData < Model
+    # @return [Array<ListNotebooksDataNotebooksItem>]
+    field :notebooks, 'notebooks', type: 'ListNotebooksDataNotebooksItem', array: true
+    # @return [Integer]
+    field :count, 'count'
+  end
+
+  # The `ListNotebooksDataNotebooksItem` shape.
+  class ListNotebooksDataNotebooksItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [String]
+    field :url, 'url'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Array<String>]
+    field :use_cases, 'use_cases', array: true
+    # @return [Boolean]
+    field :active, 'active'
+  end
+
+  # The `AddNotebookData` shape.
+  class AddNotebookData < Model
+    # @return [AddNotebookDataNotebook]
+    field :notebook, 'notebook', type: 'AddNotebookDataNotebook'
+  end
+
+  # The `AddNotebookDataNotebook` shape.
+  class AddNotebookDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [String]
+    field :url, 'url'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Array<String>]
+    field :content_types, 'content_types', array: true
+    # @return [Array<String>]
+    field :use_cases, 'use_cases', array: true
+    # @return [String]
+    field :added_at, 'added_at'
+    # @return [String]
+    field :last_used, 'last_used'
+    # @return [Integer]
+    field :use_count, 'use_count'
+    # @return [Array<String>]
+    field :tags, 'tags', array: true
+    # @return [Boolean]
+    field :active, 'active'
+  end
+
+  # The `ListNotebooksFromNblmData` shape.
+  class ListNotebooksFromNblmData < Model
+    # @return [Array<ListNotebooksFromNblmDataNotebooksItem>]
+    field :notebooks, 'notebooks', type: 'ListNotebooksFromNblmDataNotebooksItem', array: true
+    # @return [Integer]
+    field :total, 'total'
+    # @return [String]
+    field :message, 'message'
+  end
+
+  # The `ListNotebooksFromNblmDataNotebooksItem` shape.
+  class ListNotebooksFromNblmDataNotebooksItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :url, 'url'
+  end
+
+  # The `ImportScrapedNotebooksData` shape.
+  class ImportScrapedNotebooksData < Model
+    # @return [Array<ImportScrapedNotebooksDataImportedItem>]
+    field :imported, 'imported', type: 'ImportScrapedNotebooksDataImportedItem', array: true
+    # @return [Array<ImportScrapedNotebooksDataErrorsItem>]
+    field :errors, 'errors', type: 'ImportScrapedNotebooksDataErrorsItem', array: true
+    # @return [Integer]
+    field :total_scraped, 'total_scraped'
+    # @return [Integer]
+    field :total_imported, 'total_imported'
+    # @return [Integer]
+    field :total_errors, 'total_errors'
+  end
+
+  # The `ImportScrapedNotebooksDataImportedItem` shape.
+  class ImportScrapedNotebooksDataImportedItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `ImportScrapedNotebooksDataErrorsItem` shape.
+  class ImportScrapedNotebooksDataErrorsItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :error, 'error'
+  end
+
+  # The `AutoDiscoverNotebookData` shape.
+  class AutoDiscoverNotebookData < Model
+    # @return [AutoDiscoverNotebookDataNotebook]
+    field :notebook, 'notebook', type: 'AutoDiscoverNotebookDataNotebook'
+  end
+
+  # The `AutoDiscoverNotebookDataNotebook` shape.
+  class AutoDiscoverNotebookDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :url, 'url'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Array<String>]
+    field :content_types, 'content_types', array: true
+    # @return [Array<String>]
+    field :use_cases, 'use_cases', array: true
+    # @return [String]
+    field :added_at, 'added_at'
+    # @return [String]
+    field :last_used, 'last_used'
+    # @return [Integer]
+    field :use_count, 'use_count'
+    # @return [Boolean]
+    field :auto_generated, 'auto_generated'
+  end
+
+  # The `SearchNotebooksData` shape.
+  class SearchNotebooksData < Model
+    # @return [Array<SearchNotebooksDataNotebooksItem>]
+    field :notebooks, 'notebooks', type: 'SearchNotebooksDataNotebooksItem', array: true
+  end
+
+  # The `SearchNotebooksDataNotebooksItem` shape.
+  class SearchNotebooksDataNotebooksItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :url, 'url'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Array<String>]
+    field :content_types, 'content_types', array: true
+    # @return [Array<String>]
+    field :use_cases, 'use_cases', array: true
+    # @return [String]
+    field :added_at, 'added_at'
+    # @return [String]
+    field :last_used, 'last_used'
+    # @return [Integer]
+    field :use_count, 'use_count'
+  end
+
+  # The `GetLibraryStatsData` shape.
+  class GetLibraryStatsData < Model
+    # @return [Integer]
+    field :total_notebooks, 'total_notebooks'
+    # @return [String, nil]
+    field :active_notebook_id, 'active_notebook_id'
+    # @return [Integer]
+    field :total_queries, 'total_queries'
+    # @return [GetLibraryStatsDataMostUsedNotebook]
+    field :most_used_notebook, 'most_used_notebook', type: 'GetLibraryStatsDataMostUsedNotebook'
+    # @return [Array<GetLibraryStatsDataRecentlyAddedItem>]
+    field :recently_added, 'recently_added', type: 'GetLibraryStatsDataRecentlyAddedItem', array: true
+  end
+
+  # The `GetLibraryStatsDataMostUsedNotebook` shape.
+  class GetLibraryStatsDataMostUsedNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [Integer]
+    field :use_count, 'use_count'
+  end
+
+  # The `GetLibraryStatsDataRecentlyAddedItem` shape.
+  class GetLibraryStatsDataRecentlyAddedItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :added_at, 'added_at'
+  end
+
+  # The `DeleteNotebooksFromNblmData` shape.
+  class DeleteNotebooksFromNblmData < Model
+    # @return [Array<String>]
+    field :deleted, 'deleted', array: true
+    # @return [Array<String>]
+    field :failed, 'failed', array: true
+    # @return [String]
+    field :message, 'message'
+  end
+
+  # The `GetNotebookData` shape.
+  class GetNotebookData < Model
+    # @return [GetNotebookDataNotebook]
+    field :notebook, 'notebook', type: 'GetNotebookDataNotebook'
+  end
+
+  # The `GetNotebookDataNotebook` shape.
+  class GetNotebookDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [String]
+    field :url, 'url'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Boolean]
+    field :active, 'active'
+  end
+
+  # The `UpdateNotebookData` shape.
+  class UpdateNotebookData < Model
+    # @return [UpdateNotebookDataNotebook]
+    field :notebook, 'notebook', type: 'UpdateNotebookDataNotebook'
+  end
+
+  # The `UpdateNotebookDataNotebook` shape.
+  class UpdateNotebookDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [String]
+    field :last_modified, 'last_modified'
+  end
+
+  # The `RemoveNotebookData` shape.
+  class RemoveNotebookData < Model
+    # @return [String]
+    field :message, 'message'
+    # @return [String]
+    field :id, 'id'
+  end
+
+  # The `SelectNotebookData` shape.
+  class SelectNotebookData < Model
+    # @return [String]
+    field :message, 'message'
+    # @return [SelectNotebookDataNotebook]
+    field :notebook, 'notebook', type: 'SelectNotebookDataNotebook'
+  end
+
+  # The `SelectNotebookDataNotebook` shape.
+  class SelectNotebookDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :description, 'description'
+    # @return [String]
+    field :url, 'url'
+    # @return [Array<String>]
+    field :topics, 'topics', array: true
+    # @return [Boolean]
+    field :active, 'active'
+    # @return [String]
+    field :last_used, 'last_used'
+  end
+
+  # The `CreateNotebookData` shape.
+  class CreateNotebookData < Model
+    # @return [String]
+    field :notebook_url, 'notebook_url'
+    # @return [String]
+    field :name, 'name'
+  end
+
+  # The `ListSessionsData` shape.
+  class ListSessionsData < Model
+    # @return [Array<ListSessionsDataSessionsItem>]
+    field :sessions, 'sessions', type: 'ListSessionsDataSessionsItem', array: true
+    # @return [Integer]
+    field :count, 'count'
+    # @return [Integer]
+    field :max_sessions, 'max_sessions'
+  end
+
+  # The `ListSessionsDataSessionsItem` shape.
+  class ListSessionsDataSessionsItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :notebook_url, 'notebook_url'
+    # @return [Integer]
+    field :message_count, 'message_count'
+    # @return [Integer]
+    field :age_seconds, 'age_seconds'
+    # @return [Integer]
+    field :inactive_seconds, 'inactive_seconds'
+    # @return [Integer]
+    field :last_activity, 'last_activity'
+  end
+
+  # The `CloseSessionData` shape.
+  class CloseSessionData < Model
+    # @return [String]
+    field :message, 'message'
+    # @return [String]
+    field :session_id, 'session_id'
+  end
+
+  # The `ResetSessionData` shape.
+  class ResetSessionData < Model
+    # @return [String]
+    field :message, 'message'
+    # @return [String]
+    field :session_id, 'session_id'
+    # @return [Integer]
+    field :previous_message_count, 'previous_message_count'
+  end
+
+  # The `AddSourceData` shape.
+  class AddSourceData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :source_id, 'sourceId'
+    # @return [String]
+    field :source_name, 'sourceName'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `DeleteSourceData` shape.
+  class DeleteSourceData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :source_id, 'sourceId'
+    # @return [String]
+    field :source_name, 'sourceName'
+  end
+
+  # The `DeleteSourceByIdData` shape.
+  class DeleteSourceByIdData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :source_id, 'sourceId'
+    # @return [String]
+    field :source_name, 'sourceName'
+  end
+
+  # The `DeleteContentData` shape.
+  class DeleteContentData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :content_id, 'contentId'
+    # @return [Boolean]
+    field :deleted, 'deleted'
+  end
+
+  # The `ListSourcesData` shape.
+  class ListSourcesData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [Integer]
+    field :count, 'count'
+    # @return [Array<ListSourcesDataSourcesItem>]
+    field :sources, 'sources', type: 'ListSourcesDataSourcesItem', array: true
+  end
+
+  # The `ListSourcesDataSourcesItem` shape.
+  class ListSourcesDataSourcesItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :title, 'title'
+  end
+
+  # The `ReadSourceData` shape.
+  class ReadSourceData < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :format, 'format'
+    # @return [String]
+    field :content, 'content'
+    # @return [Integer]
+    field :total_chars, 'totalChars'
+    # @return [Integer]
+    field :page_chars, 'pageChars'
+    # @return [Integer]
+    field :offset, 'offset'
+    # @return [Boolean]
+    field :has_more, 'hasMore'
+    # @return [Integer, nil]
+    field :next_cursor, 'nextCursor'
+    # @return [String, nil]
+    field :continue, 'continue'
+  end
+
+  # The `RenameSourceData` shape.
+  class RenameSourceData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :source_id, 'sourceId'
+    # @return [String]
+    field :title, 'title'
+  end
+
+  # The `GetSourceGuideData` shape.
+  class GetSourceGuideData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :summary, 'summary'
+    # @return [Array<String>]
+    field :key_topics, 'keyTopics', array: true
+  end
+
+  # The `SearchPassagesData` shape.
+  class SearchPassagesData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :query, 'query'
+    # @return [Integer]
+    field :count, 'count'
+    # @return [Array<SearchPassagesDataPassagesItem>]
+    field :passages, 'passages', type: 'SearchPassagesDataPassagesItem', array: true
+  end
+
+  # The `SearchPassagesDataPassagesItem` shape.
+  class SearchPassagesDataPassagesItem < Model
+    # @return [String]
+    field :source_id, 'sourceId'
+    # @return [String]
+    field :text, 'text'
+    # @return [Integer]
+    field :rank, 'rank'
+    # @return [Integer, nil]
+    field :start, 'start'
+    # @return [Integer, nil]
+    field :end_value, 'end'
+  end
+
+  # The `GetNotebookSummaryData` shape.
+  class GetNotebookSummaryData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :summary, 'summary'
+    # @return [Array<GetNotebookSummaryDataSuggestedTopicsItem>]
+    field :suggested_topics, 'suggestedTopics', type: 'GetNotebookSummaryDataSuggestedTopicsItem', array: true
+  end
+
+  # The `GetNotebookSummaryDataSuggestedTopicsItem` shape.
+  class GetNotebookSummaryDataSuggestedTopicsItem < Model
+    # @return [String]
+    field :question, 'question'
+    # @return [String]
+    field :prompt, 'prompt'
+  end
+
+  # The `CheckSourceFreshnessData` shape.
+  class CheckSourceFreshnessData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [Integer]
+    field :checked, 'checked'
+    # @return [Integer]
+    field :stale, 'stale'
+    # @return [Array<CheckSourceFreshnessDataSourcesItem>]
+    field :sources, 'sources', type: 'CheckSourceFreshnessDataSourcesItem', array: true
+  end
+
+  # The `CheckSourceFreshnessDataSourcesItem` shape.
+  class CheckSourceFreshnessDataSourcesItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String, nil]
+    field :stale, 'stale'
+  end
+
+  # The `GetChatHistoryData` shape.
+  class GetChatHistoryData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :conversation_id, 'conversationId'
+    # @return [Integer]
+    field :count, 'count'
+    # @return [Array<GetChatHistoryDataTurnsItem>]
+    field :turns, 'turns', type: 'GetChatHistoryDataTurnsItem', array: true
+  end
+
+  # The `GetChatHistoryDataTurnsItem` shape.
+  class GetChatHistoryDataTurnsItem < Model
+    # @return [String]
+    field :role, 'role'
+    # @return [String]
+    field :text, 'text'
+  end
+
+  # The `DeleteChatHistoryData` shape.
+  class DeleteChatHistoryData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :conversation_id, 'conversationId'
+    # @return [Boolean]
+    field :deleted, 'deleted'
+  end
+
+  # The `GetShareStatusData` shape.
+  class GetShareStatusData < Model
+    # @return [Boolean]
+    field :is_public, 'isPublic'
+    # @return [String]
+    field :public_link, 'publicLink'
+    # @return [Array<GetShareStatusDataCollaboratorsItem>]
+    field :collaborators, 'collaborators', type: 'GetShareStatusDataCollaboratorsItem', array: true
+  end
+
+  # The `GetShareStatusDataCollaboratorsItem` shape.
+  class GetShareStatusDataCollaboratorsItem < Model
+    # @return [String]
+    field :email, 'email'
+    # @return [String]
+    field :name, 'name'
+  end
+
+  # The `ShareNotebookData` shape.
+  class ShareNotebookData < Model
+    # @return [Boolean]
+    field :is_public, 'isPublic'
+    # @return [String]
+    field :public_link, 'publicLink'
+    # @return [Array<ShareNotebookDataCollaboratorsItem>]
+    field :collaborators, 'collaborators', type: 'ShareNotebookDataCollaboratorsItem', array: true
+  end
+
+  # The `ShareNotebookDataCollaboratorsItem` shape.
+  class ShareNotebookDataCollaboratorsItem < Model
+    # @return [String]
+    field :email, 'email'
+    # @return [String]
+    field :name, 'name'
+  end
+
+  # The `RetryContentData` shape.
+  class RetryContentData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :content_id, 'contentId'
+    # @return [String]
+    field :status, 'status'
+    # @return [Boolean]
+    field :retried, 'retried'
+  end
+
+  # The `ExportArtifactData` shape.
+  class ExportArtifactData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :artifact_id, 'artifactId'
+    # @return [String]
+    field :target, 'target'
+    # @return [String]
+    field :document_url, 'documentUrl'
+  end
+
+  # The `ReviseSlideData` shape.
+  class ReviseSlideData < Model
+    # @return [String]
+    field :notebook_id, 'notebookId'
+    # @return [String]
+    field :artifact_id, 'artifactId'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `ListLabelsData` shape.
+  class ListLabelsData < Model
+    # @return [Array<ListLabelsDataLabelsItem>]
+    field :labels, 'labels', type: 'ListLabelsDataLabelsItem', array: true
+  end
+
+  # The `ListLabelsDataLabelsItem` shape.
+  class ListLabelsDataLabelsItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :emoji, 'emoji'
+    # @return [Integer]
+    field :source_count, 'sourceCount'
+  end
+
+  # The `ManageLabelsData` shape.
+  class ManageLabelsData < Model
+    # @return [Array<ManageLabelsDataLabelsItem>]
+    field :labels, 'labels', type: 'ManageLabelsDataLabelsItem', array: true
+  end
+
+  # The `ManageLabelsDataLabelsItem` shape.
+  class ManageLabelsDataLabelsItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :emoji, 'emoji'
+    # @return [Integer]
+    field :source_count, 'sourceCount'
+  end
+
+  # The `GenerateStudyAidData` shape.
+  class GenerateStudyAidData < Model
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :artifact_id, 'artifactId'
+  end
+
+  # The `GenerateMindMapData` shape.
+  class GenerateMindMapData < Model
+    # @return [String]
+    field :mind_map_id, 'mindMapId'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :json, 'json'
+  end
+
+  # The `ResearchSourcesData` shape.
+  class ResearchSourcesData < Model
+    # @return [String]
+    field :task_id, 'taskId'
+    # @return [Integer]
+    field :imported, 'imported'
+    # @return [Array<ResearchSourcesDataSourcesItem>]
+    field :sources, 'sources', type: 'ResearchSourcesDataSourcesItem', array: true
+  end
+
+  # The `ResearchSourcesDataSourcesItem` shape.
+  class ResearchSourcesDataSourcesItem < Model
+    # @return [String]
+    field :url, 'url'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :description, 'description'
+  end
+
+  # The `GenerateContentData` shape.
+  class GenerateContentData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :type, 'type'
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :message, 'message'
+  end
+
+  # The `DownloadContentData` shape.
+  class DownloadContentData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :file_path, 'filePath'
+    # @return [String]
+    field :mime_type, 'mimeType'
+    # Present when the artifact was exported to Sheets.
+    # @return [String, nil]
+    field :google_sheets_url, 'googleSheetsUrl'
+    # Present when the artifact was exported to Slides.
+    # @return [String, nil]
+    field :google_slides_url, 'googleSlidesUrl'
+  end
+
+  # The `ListContentData` shape.
+  class ListContentData < Model
+    # @return [Array<ListContentDataSourcesItem>]
+    field :sources, 'sources', type: 'ListContentDataSourcesItem', array: true
+    # @return [Array<ListContentDataGeneratedContentItem>]
+    field :generated_content, 'generatedContent', type: 'ListContentDataGeneratedContentItem', array: true
+    # @return [Integer]
+    field :source_count, 'sourceCount'
+    # @return [Boolean]
+    field :has_audio_overview, 'hasAudioOverview'
+  end
+
+  # The `ListContentDataSourcesItem` shape.
+  class ListContentDataSourcesItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :type, 'type'
+    # @return [String]
+    field :status, 'status'
+    # @return [Integer]
+    field :passage_count, 'passageCount'
+    # @return [String]
+    field :added_at, 'addedAt'
+  end
+
+  # The `ListContentDataGeneratedContentItem` shape.
+  class ListContentDataGeneratedContentItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :type, 'type'
+    # @return [String]
+    field :name, 'name'
+    # @return [String]
+    field :status, 'status'
+    # @return [String]
+    field :created_at, 'createdAt'
+    # @return [Integer]
+    field :duration, 'duration'
+    # @return [String]
+    field :url, 'url'
+    # @return [String]
+    field :content, 'content'
+  end
+
+  # The `CreateNoteData` shape.
+  class CreateNoteData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :note_title, 'noteTitle'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `SaveChatToNoteData` shape.
+  class SaveChatToNoteData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :note_title, 'noteTitle'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `ConvertNoteToSourceData` shape.
+  class ConvertNoteToSourceData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :note_title, 'noteTitle'
+    # @return [String]
+    field :status, 'status'
+  end
+
+  # The `BatchToVaultData` shape.
+  class BatchToVaultData < Model
+    # @return [String]
+    field :vault_dir, 'vault_dir'
+    # @return [Integer]
+    field :total, 'total'
+    # @return [Integer]
+    field :succeeded, 'succeeded'
+    # @return [Integer]
+    field :failed, 'failed'
+    # @return [String]
+    field :session_id, 'session_id'
+    # @return [BatchToVaultDataNotebook]
+    field :notebook, 'notebook', type: 'BatchToVaultDataNotebook'
+    # @return [Array<BatchToVaultDataFilesItem>]
+    field :files, 'files', type: 'BatchToVaultDataFilesItem', array: true
+  end
+
+  # The `BatchToVaultDataNotebook` shape.
+  class BatchToVaultDataNotebook < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :url, 'url'
+  end
+
+  # The `BatchToVaultDataFilesItem` shape.
+  class BatchToVaultDataFilesItem < Model
+    # @return [String]
+    field :question, 'question'
+    # @return [String]
+    field :md_path, 'md_path'
+    # @return [String]
+    field :json_path, 'json_path'
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [Integer]
+    field :citations_count, 'citations_count'
+  end
+
+  # The `ListNotesData` shape.
+  class ListNotesData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [Array<ListNotesDataNotesItem>]
+    field :notes, 'notes', type: 'ListNotesDataNotesItem', array: true
+  end
+
+  # The `ListNotesDataNotesItem` shape.
+  class ListNotesDataNotesItem < Model
+    # @return [String]
+    field :id, 'id'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :details, 'details'
+  end
+
+  # The `GetNoteData` shape.
+  class GetNoteData < Model
+    # @return [Boolean]
+    field :success, 'success'
+    # @return [String]
+    field :title, 'title'
+    # @return [String]
+    field :content, 'content'
+  end
+
+  # The `CleanupDataData` shape.
+  class CleanupDataData < Model
+    # @return [String]
+    field :message, 'message'
+    # @return [Integer]
+    field :files_deleted, 'files_deleted'
+    # @return [Float]
+    field :space_freed_mb, 'space_freed_mb'
+    # @return [Boolean]
+    field :library_preserved, 'library_preserved'
+  end
+
+  # Every operation of the server's REST API.
+  #
+  # Included into {Client}, so these are called on a client rather than used
+  # directly. They are listed here so that the documentation of the plumbing
+  # and the documentation of the API stay separate things.
+  module Operations
+    # Every operation id, in specification order. The server exposes
+    # 56 of them.
+    OPERATION_IDS = %w[
+      get_server_info
+      get_health
+      get_utcp_manual
+      setup_auth
+      de_auth
+      re_auth
+      ask_question
+      list_notebooks
+      add_notebook
+      list_notebooks_from_nblm
+      import_scraped_notebooks
+      auto_discover_notebook
+      search_notebooks
+      get_library_stats
+      delete_notebooks_from_nblm
+      get_notebook
+      update_notebook
+      remove_notebook
+      select_notebook
+      create_notebook
+      list_sessions
+      close_session
+      reset_session
+      add_source
+      delete_source
+      delete_source_by_id
+      delete_content
+      list_sources
+      read_source
+      rename_source
+      get_source_guide
+      search_passages
+      get_notebook_summary
+      check_source_freshness
+      get_chat_history
+      delete_chat_history
+      get_share_status
+      share_notebook
+      retry_content
+      export_artifact
+      revise_slide
+      list_labels
+      manage_labels
+      generate_study_aid
+      generate_mind_map
+      research_sources
+      generate_content
+      download_content
+      list_content
+      create_note
+      save_chat_to_note
+      convert_note_to_source
+      batch_to_vault
+      list_notes
+      get_note
+      cleanup_data
+    ].freeze
+
+    # Server identity, version, and a pointer to the docs
+    #
+    # `GET /`
+    #
+    # @return [ServerInfo]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_server_info
+      payload = call('get_server_info', :get, '/', enveloped: false)
+      ServerInfo.new(payload)
+    end
+
+    # Server health check
+    #
+    # `GET /health`
+    #
+    # @return [GetHealthData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_health
+      payload = call('get_health', :get, '/health')
+      GetHealthData.new(payload)
+    end
+
+    # UTCP tool manual for this server
+    #
+    # The manual a Universal Tool Calling Protocol client reads before
+    # calling anything. UTCP has no protocol server: the client reads this
+    # once and then calls the routes below natively, so the manual is a
+    # description of this same API rather than a second way into it.
+    #
+    # Generated from this specification, with the call addresses rebased on
+    # the address the request arrived at. The same document is published
+    # statically at `/utcp.json` on the documentation site. Behind the token
+    # guard like every route but `/health`.
+    #
+    # `GET /utcp`
+    #
+    # @return [UtcpManual]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_utcp_manual
+      payload = call('get_utcp_manual', :get, '/utcp', enveloped: false)
+      UtcpManual.new(payload)
+    end
+
+    # First-time Google authentication (opens visible browser)
+    #
+    # `POST /setup-auth`
+    #
+    # @param show_browser [Boolean, nil]
+    # @param account [String, nil]
+    # @return [SetupAuthData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def setup_auth(show_browser: nil, account: nil)
+      body = {}
+      body['show_browser'] = show_browser unless show_browser.nil?
+      body['account'] = account unless account.nil?
+      payload = call('setup_auth', :post, '/setup-auth', body: body)
+      SetupAuthData.new(payload)
+    end
+
+    # Logout, clear all credentials
+    #
+    # `POST /de-auth`
+    #
+    # @return [DeAuthData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def de_auth
+      payload = call('de_auth', :post, '/de-auth')
+      DeAuthData.new(payload)
+    end
+
+    # Re-authenticate or switch account
+    #
+    # `POST /re-auth`
+    #
+    # @param account [String, nil]
+    # @return [ReAuthData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def re_auth(account: nil)
+      body = {}
+      body['account'] = account unless account.nil?
+      payload = call('re_auth', :post, '/re-auth', body: body)
+      ReAuthData.new(payload)
+    end
+
+    # Ask a question with citation-backed response
+    #
+    # `POST /ask`
+    #
+    # @param question [String]
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param session_id [String, nil]
+    # @param source_format [String, nil]
+    # @param show_browser [Boolean, nil]
+    # @return [AskQuestionData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def ask_question(question:, notebook_id: nil, notebook_url: nil, session_id: nil, source_format: nil, show_browser: nil)
+      body = {}
+      body['question'] = question
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['session_id'] = session_id unless session_id.nil?
+      body['source_format'] = source_format unless source_format.nil?
+      body['show_browser'] = show_browser unless show_browser.nil?
+      payload = call('ask_question', :post, '/ask', body: body)
+      AskQuestionData.new(payload)
+    end
+
+    # List all notebooks in the local library
+    #
+    # `GET /notebooks`
+    #
+    # @return [ListNotebooksData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_notebooks
+      payload = call('list_notebooks', :get, '/notebooks')
+      ListNotebooksData.new(payload)
+    end
+
+    # Manually add a notebook to the library
+    #
+    # `POST /notebooks`
+    #
+    # @param id [String]
+    # @param name [String]
+    # @param url [String]
+    # @param description [String, nil]
+    # @param topics [Array<String>, nil]
+    # @return [AddNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def add_notebook(id:, name:, url:, description: nil, topics: nil)
+      body = {}
+      body['id'] = id
+      body['name'] = name
+      body['url'] = url
+      body['description'] = description unless description.nil?
+      body['topics'] = topics unless topics.nil?
+      payload = call('add_notebook', :post, '/notebooks', body: body)
+      AddNotebookData.new(payload)
+    end
+
+    # Scrape all notebooks from NotebookLM UI
+    #
+    # `GET /notebooks/scrape`
+    #
+    # @return [ListNotebooksFromNblmData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_notebooks_from_nblm
+      payload = call('list_notebooks_from_nblm', :get, '/notebooks/scrape')
+      ListNotebooksFromNblmData.new(payload)
+    end
+
+    # Bulk import scraped notebooks into local library
+    #
+    # `POST /notebooks/import-from-scrape`
+    #
+    # @return [ImportScrapedNotebooksData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def import_scraped_notebooks
+      payload = call('import_scraped_notebooks', :post, '/notebooks/import-from-scrape')
+      ImportScrapedNotebooksData.new(payload)
+    end
+
+    # Generate notebook metadata autonomously via NotebookLM queries
+    #
+    # `POST /notebooks/auto-discover`
+    #
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @return [AutoDiscoverNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def auto_discover_notebook(notebook_id: nil, notebook_url: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      payload = call('auto_discover_notebook', :post, '/notebooks/auto-discover', body: body)
+      AutoDiscoverNotebookData.new(payload)
+    end
+
+    # Search the local library by keyword
+    #
+    # `GET /notebooks/search`
+    #
+    # @param q [String, nil]
+    # @return [SearchNotebooksData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def search_notebooks(q: nil)
+      query = {}
+      query['q'] = q unless q.nil?
+      payload = call('search_notebooks', :get, '/notebooks/search', query: query)
+      SearchNotebooksData.new(payload)
+    end
+
+    # Library statistics
+    #
+    # `GET /notebooks/stats`
+    #
+    # @return [GetLibraryStatsData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_library_stats
+      payload = call('get_library_stats', :get, '/notebooks/stats')
+      GetLibraryStatsData.new(payload)
+    end
+
+    # Delete multiple notebooks at once
+    #
+    # `DELETE /notebooks/bulk-delete`
+    #
+    # @param ids [Array<String>, nil]
+    # @return [DeleteNotebooksFromNblmData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def delete_notebooks_from_nblm(ids: nil)
+      body = {}
+      body['ids'] = ids unless ids.nil?
+      payload = call('delete_notebooks_from_nblm', :delete, '/notebooks/bulk-delete', body: body)
+      DeleteNotebooksFromNblmData.new(payload)
+    end
+
+    # Get notebook details
+    #
+    # `GET /notebooks/{id}`
+    #
+    # @param id [String]
+    # @return [GetNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_notebook(id:)
+      payload = call('get_notebook', :get, "/notebooks/#{id}")
+      GetNotebookData.new(payload)
+    end
+
+    # Update notebook metadata
+    #
+    # `PUT /notebooks/{id}`
+    #
+    # @param id [String]
+    # @return [UpdateNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def update_notebook(id:)
+      payload = call('update_notebook', :put, "/notebooks/#{id}")
+      UpdateNotebookData.new(payload)
+    end
+
+    # Delete a notebook from the library
+    #
+    # `DELETE /notebooks/{id}`
+    #
+    # @param id [String]
+    # @return [RemoveNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def remove_notebook(id:)
+      payload = call('remove_notebook', :delete, "/notebooks/#{id}")
+      RemoveNotebookData.new(payload)
+    end
+
+    # Set notebook as the default active notebook
+    #
+    # `PUT /notebooks/{id}/activate`
+    #
+    # @param id [String]
+    # @return [SelectNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def select_notebook(id:)
+      payload = call('select_notebook', :put, "/notebooks/#{id}/activate")
+      SelectNotebookData.new(payload)
+    end
+
+    # Create a new notebook in NotebookLM
+    #
+    # `POST /notebooks/create`
+    #
+    # @param name [String, nil]
+    # @param description [String, nil]
+    # @return [CreateNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def create_notebook(name: nil, description: nil)
+      body = {}
+      body['name'] = name unless name.nil?
+      body['description'] = description unless description.nil?
+      payload = call('create_notebook', :post, '/notebooks/create', body: body)
+      CreateNotebookData.new(payload)
+    end
+
+    # List active sessions
+    #
+    # `GET /sessions`
+    #
+    # @return [ListSessionsData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_sessions
+      payload = call('list_sessions', :get, '/sessions')
+      ListSessionsData.new(payload)
+    end
+
+    # Close a session
+    #
+    # `DELETE /sessions/{id}`
+    #
+    # @param id [String]
+    # @return [CloseSessionData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def close_session(id:)
+      payload = call('close_session', :delete, "/sessions/#{id}")
+      CloseSessionData.new(payload)
+    end
+
+    # Reset a session's history
+    #
+    # `POST /sessions/{id}/reset`
+    #
+    # @param id [String]
+    # @return [ResetSessionData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def reset_session(id:)
+      payload = call('reset_session', :post, "/sessions/#{id}/reset")
+      ResetSessionData.new(payload)
+    end
+
+    # Add a source (file, url, text, youtube, drive) to the active notebook
+    #
+    # `POST /content/sources`
+    #
+    # @param source_type [String]
+    # @param file_path [String, nil]
+    # @param url [String, nil]
+    # @param text [String, nil]
+    # @param title [String, nil]
+    # @param notebook_url [String, nil]
+    # @param session_id [String, nil]
+    # @return [AddSourceData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def add_source(source_type:, file_path: nil, url: nil, text: nil, title: nil, notebook_url: nil, session_id: nil)
+      body = {}
+      body['source_type'] = source_type
+      body['file_path'] = file_path unless file_path.nil?
+      body['url'] = url unless url.nil?
+      body['text'] = text unless text.nil?
+      body['title'] = title unless title.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['session_id'] = session_id unless session_id.nil?
+      payload = call('add_source', :post, '/content/sources', body: body)
+      AddSourceData.new(payload)
+    end
+
+    # Delete source by name (query parameter)
+    #
+    # `DELETE /content/sources`
+    #
+    # @param name [String, nil]
+    # @return [DeleteSourceData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def delete_source(name: nil)
+      query = {}
+      query['name'] = name unless name.nil?
+      payload = call('delete_source', :delete, '/content/sources', query: query)
+      DeleteSourceData.new(payload)
+    end
+
+    # Delete source by id
+    #
+    # `DELETE /content/sources/{id}`
+    #
+    # @param id [String]
+    # @return [DeleteSourceByIdData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def delete_source_by_id(id:)
+      payload = call('delete_source_by_id', :delete, "/content/sources/#{id}")
+      DeleteSourceByIdData.new(payload)
+    end
+
+    # Delete a generated Studio artifact
+    #
+    # RPC-backed (no browser). Irreversible. Note-backed mind maps are not
+    # covered — they live in the notes system, not the Studio library.
+    #
+    # `DELETE /content/{contentId}`
+    #
+    # @param content_id [String]
+    # @param notebook_url [String, nil]
+    # @param notebook_id [String, nil]
+    # @return [DeleteContentData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def delete_content(content_id:, notebook_url: nil, notebook_id: nil)
+      query = {}
+      query['notebook_url'] = notebook_url unless notebook_url.nil?
+      query['notebook_id'] = notebook_id unless notebook_id.nil?
+      payload = call('delete_content', :delete, "/content/#{content_id}", query: query)
+      DeleteContentData.new(payload)
+    end
+
+    # List a notebook's sources with their ids and titles
+    #
+    # RPC-backed (no browser). Returns `{ notebookId, count, sources: [{ id, title }] }`.
+    # This is where the source ids for `/notebooks/{id}/sources/{sourceId}` come from.
+    #
+    # `GET /notebooks/{id}/sources`
+    #
+    # @param id [String]
+    # @return [ListSourcesData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_sources(id:)
+      payload = call('list_sources', :get, "/notebooks/#{id}/sources")
+      ListSourcesData.new(payload)
+    end
+
+    # Read a source's indexed text, one page at a time
+    #
+    # RPC-backed (no browser). Returns the exact content NotebookLM reasons
+    # over. Sources are long — the first PDF measured ran to 157,716
+    # characters — so the response is paginated by default and carries
+    # `totalChars`, `pageChars`, `offset`, `hasMore`, `nextCursor` and a
+    # plain-language `continue` instruction. Pages are cut at the nearest
+    # line break (tag close, in HTML), and concatenating every page
+    # reproduces the document exactly. Pass `paginate=false` for the whole
+    # document in one response. The `html` rendition preserves structure but
+    # inlines images as base64 and is bigger.
+    #
+    # `GET /notebooks/{id}/sources/{sourceId}`
+    #
+    # @param id [String]
+    # @param source_id [String]
+    # @param format [String, nil]
+    # @param paginate [Boolean, nil] Set to `false` to return the whole document in one response.
+    # @param max_chars [Integer, nil] Page size in characters. Ignored when `paginate=false`.
+    # @param cursor [Integer, nil] Resume point — the `nextCursor` returned by the previous page.
+    # @return [ReadSourceData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def read_source(id:, source_id:, format: nil, paginate: nil, max_chars: nil, cursor: nil)
+      query = {}
+      query['format'] = format unless format.nil?
+      query['paginate'] = paginate unless paginate.nil?
+      query['max_chars'] = max_chars unless max_chars.nil?
+      query['cursor'] = cursor unless cursor.nil?
+      payload = call('read_source', :get, "/notebooks/#{id}/sources/#{source_id}", query: query)
+      ReadSourceData.new(payload)
+    end
+
+    # Rename one source in place
+    #
+    # RPC-backed (no browser). An empty `title` is a 400.
+    #
+    # `PATCH /notebooks/{id}/sources/{sourceId}`
+    #
+    # @param id [String]
+    # @param source_id [String]
+    # @param title [String]
+    # @return [RenameSourceData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def rename_source(id:, source_id:, title:)
+      body = {}
+      body['title'] = title
+      payload = call('rename_source', :patch, "/notebooks/#{id}/sources/#{source_id}", body: body)
+      RenameSourceData.new(payload)
+    end
+
+    # NotebookLM's own summary and key topics for one source
+    #
+    # RPC-backed (no browser). A source NotebookLM has not summarised yet
+    # returns an empty `summary` and no topics.
+    #
+    # `GET /notebooks/{id}/sources/{sourceId}/guide`
+    #
+    # @param id [String]
+    # @param source_id [String]
+    # @return [GetSourceGuideData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_source_guide(id:, source_id:)
+      payload = call('get_source_guide', :get, "/notebooks/#{id}/sources/#{source_id}/guide")
+      GetSourceGuideData.new(payload)
+    end
+
+    # Ranked passages from the notebook's index, without generating an answer
+    #
+    # RPC-backed (no browser). Retrieval rather than question answering:
+    # nothing is generated and no generation quota is spent. Rank is global
+    # across sources and lower is better. `start` / `end` are character
+    # offsets into the source's full text, and are `null` when the server
+    # did not give them.
+    #
+    # `POST /notebooks/{id}/search`
+    #
+    # @param id [String]
+    # @param query [String]
+    # @param source_ids [Array<String>, nil] Restrict to these source UUIDs. Omit to search them all.
+    # @param source_names [Array<String>, nil] Restrict by source title; an ambiguous title is an error.
+    # @param limit [Integer, nil] Keep at most this many passages, best rank first.
+    # @return [SearchPassagesData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def search_passages(id:, query:, source_ids: nil, source_names: nil, limit: nil)
+      body = {}
+      body['query'] = query
+      body['source_ids'] = source_ids unless source_ids.nil?
+      body['source_names'] = source_names unless source_names.nil?
+      body['limit'] = limit unless limit.nil?
+      payload = call('search_passages', :post, "/notebooks/#{id}/search", body: body)
+      SearchPassagesData.new(payload)
+    end
+
+    # A notebook's own summary of its sources, and the questions it suggests
+    #
+    # RPC-backed (no browser). Cheaper than asking a question to find out
+    # what a notebook holds.
+    #
+    # `GET /notebooks/{id}/summary`
+    #
+    # @param id [String]
+    # @return [GetNotebookSummaryData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_notebook_summary(id:)
+      payload = call('get_notebook_summary', :get, "/notebooks/#{id}/summary")
+      GetNotebookSummaryData.new(payload)
+    end
+
+    # Have the notebook's URL / Drive sources drifted?
+    #
+    # RPC-backed (no browser). Checks every source unless `source_id`
+    # narrows it. `stale: null` means the server did not answer for that
+    # source — not that it is current.
+    #
+    # `GET /notebooks/{id}/freshness`
+    #
+    # @param id [String]
+    # @param source_id [String, nil]
+    # @return [CheckSourceFreshnessData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def check_source_freshness(id:, source_id: nil)
+      query = {}
+      query['source_id'] = source_id unless source_id.nil?
+      payload = call('check_source_freshness', :get, "/notebooks/#{id}/freshness", query: query)
+      CheckSourceFreshnessData.new(payload)
+    end
+
+    # Read back the recorded questions and answers, newest first
+    #
+    # RPC-backed (no browser). NotebookLM exposes only the most recent
+    # conversation per notebook; older ones cannot be listed.
+    #
+    # `GET /notebooks/{id}/chat`
+    #
+    # @param id [String]
+    # @param conversation_id [String, nil]
+    # @param limit [Integer, nil]
+    # @return [GetChatHistoryData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_chat_history(id:, conversation_id: nil, limit: nil)
+      query = {}
+      query['conversation_id'] = conversation_id unless conversation_id.nil?
+      query['limit'] = limit unless limit.nil?
+      payload = call('get_chat_history', :get, "/notebooks/#{id}/chat", query: query)
+      GetChatHistoryData.new(payload)
+    end
+
+    # Clear the chat history
+    #
+    # The web UI's "Delete history". NotebookLM has no per-turn delete, so
+    # the whole conversation goes. Nothing to delete is reported as
+    # `deleted: false`, not as a failure.
+    #
+    # `DELETE /notebooks/{id}/chat`
+    #
+    # @param id [String]
+    # @param conversation_id [String, nil]
+    # @return [DeleteChatHistoryData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def delete_chat_history(id:, conversation_id: nil)
+      query = {}
+      query['conversation_id'] = conversation_id unless conversation_id.nil?
+      payload = call('delete_chat_history', :delete, "/notebooks/#{id}/chat", query: query)
+      DeleteChatHistoryData.new(payload)
+    end
+
+    # Read a notebook's sharing status
+    #
+    # `GET /notebooks/{id}/share`
+    #
+    # @param id [String]
+    # @return [GetShareStatusData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_share_status(id:)
+      payload = call('get_share_status', :get, "/notebooks/#{id}/share")
+      GetShareStatusData.new(payload)
+    end
+
+    # Toggle the public link
+    #
+    # `PUT /notebooks/{id}/share`
+    #
+    # @param id [String]
+    # @param public [Boolean]
+    # @return [ShareNotebookData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def share_notebook(id:, public:)
+      body = {}
+      body['public'] = public
+      payload = call('share_notebook', :put, "/notebooks/#{id}/share", body: body)
+      ShareNotebookData.new(payload)
+    end
+
+    # Retry a failed generation, keeping the same artifact id
+    #
+    # RPC-backed. The artifact is not deleted and not replaced: the same id
+    # goes back to `generating`, so a reference the caller already holds
+    # stays valid. Deleting and regenerating instead mints a new id.
+    #
+    # A refusal (rate limit, quota, or an artifact the backend will not
+    # retry) comes back as an error. An accepted retry can still fail again
+    # on Google's side — poll `GET /content` for the outcome.
+    #
+    # `POST /content/{artifactId}/retry`
+    #
+    # @param artifact_id [String]
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @return [RetryContentData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def retry_content(artifact_id:, notebook_id: nil, notebook_url: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      payload = call('retry_content', :post, "/content/#{artifact_id}/retry", body: body)
+      RetryContentData.new(payload)
+    end
+
+    # Export a finished artifact to Google Docs or Sheets
+    #
+    # RPC-backed. `documentUrl` is `null` when the reply carried no Drive
+    # link — the export may still have succeeded; check Drive.
+    #
+    # `POST /content/{artifactId}/export`
+    #
+    # @param artifact_id [String]
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param target [String, nil]
+    # @param title [String, nil]
+    # @return [ExportArtifactData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def export_artifact(artifact_id:, notebook_id: nil, notebook_url: nil, target: nil, title: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['target'] = target unless target.nil?
+      body['title'] = title unless title.nil?
+      payload = call('export_artifact', :post, "/content/#{artifact_id}/export", body: body)
+      ExportArtifactData.new(payload)
+    end
+
+    # Revise one slide of an existing deck from a prompt
+    #
+    # RPC-backed. `slide_index` is zero-based. Returns as soon as the
+    # revision is accepted; poll `GET /content` for the finished deck.
+    #
+    # `POST /content/{artifactId}/revise-slide`
+    #
+    # @param artifact_id [String]
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param slide_index [Integer]
+    # @param prompt [String]
+    # @return [ReviseSlideData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def revise_slide(artifact_id:, slide_index:, prompt:, notebook_id: nil, notebook_url: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['slide_index'] = slide_index
+      body['prompt'] = prompt
+      payload = call('revise_slide', :post, "/content/#{artifact_id}/revise-slide", body: body)
+      ReviseSlideData.new(payload)
+    end
+
+    # List a notebook's source labels
+    #
+    # `GET /notebooks/{id}/labels`
+    #
+    # @param id [String]
+    # @return [ListLabelsData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_labels(id:)
+      payload = call('list_labels', :get, "/notebooks/#{id}/labels")
+      ListLabelsData.new(payload)
+    end
+
+    # Create or delete source labels
+    #
+    # `POST /notebooks/{id}/labels`
+    #
+    # @param id [String]
+    # @param action [String, nil]
+    # @param name [String, nil]
+    # @param emoji [String, nil]
+    # @param label_ids [Array<String>, nil]
+    # @return [ManageLabelsData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def manage_labels(id:, action: nil, name: nil, emoji: nil, label_ids: nil)
+      body = {}
+      body['action'] = action unless action.nil?
+      body['name'] = name unless name.nil?
+      body['emoji'] = emoji unless emoji.nil?
+      body['label_ids'] = label_ids unless label_ids.nil?
+      payload = call('manage_labels', :post, "/notebooks/#{id}/labels", body: body)
+      ManageLabelsData.new(payload)
+    end
+
+    # Generate a study aid (flashcards or quiz)
+    #
+    # `POST /content/study-aid`
+    #
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param kind [String]
+    # @param focus [String, nil]
+    # @return [GenerateStudyAidData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def generate_study_aid(kind:, notebook_id: nil, notebook_url: nil, focus: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['kind'] = kind
+      body['focus'] = focus unless focus.nil?
+      payload = call('generate_study_aid', :post, '/content/study-aid', body: body)
+      GenerateStudyAidData.new(payload)
+    end
+
+    # Generate and save a mind map
+    #
+    # `POST /content/mind-map`
+    #
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param title [String, nil]
+    # @return [GenerateMindMapData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def generate_mind_map(notebook_id: nil, notebook_url: nil, title: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['title'] = title unless title.nil?
+      payload = call('generate_mind_map', :post, '/content/mind-map', body: body)
+      GenerateMindMapData.new(payload)
+    end
+
+    # Discover web sources for a notebook (Fast Research), optionally importing them
+    #
+    # `POST /content/research`
+    #
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param query [String]
+    # @param import [Boolean, nil]
+    # @return [ResearchSourcesData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def research_sources(query:, notebook_id: nil, notebook_url: nil, import: nil)
+      body = {}
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['query'] = query
+      body['import'] = import unless import.nil?
+      payload = call('research_sources', :post, '/content/research', body: body)
+      ResearchSourcesData.new(payload)
+    end
+
+    # Generate Studio content (audio, video, infographic, report, presentation, data table)
+    #
+    # `POST /content/generate`
+    #
+    # @param content_type [String]
+    # @param language [String, nil]
+    # @param custom_instructions [String, nil]
+    # @param video_style [String, nil]
+    # @param video_format [String, nil]
+    # @param infographic_format [String, nil]
+    # @param report_format [String, nil]
+    # @param presentation_style [String, nil]
+    # @param presentation_length [String, nil]
+    # @return [GenerateContentData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def generate_content(content_type:, language: nil, custom_instructions: nil, video_style: nil, video_format: nil, infographic_format: nil, report_format: nil, presentation_style: nil, presentation_length: nil)
+      body = {}
+      body['content_type'] = content_type
+      body['language'] = language unless language.nil?
+      body['custom_instructions'] = custom_instructions unless custom_instructions.nil?
+      body['video_style'] = video_style unless video_style.nil?
+      body['video_format'] = video_format unless video_format.nil?
+      body['infographic_format'] = infographic_format unless infographic_format.nil?
+      body['report_format'] = report_format unless report_format.nil?
+      body['presentation_style'] = presentation_style unless presentation_style.nil?
+      body['presentation_length'] = presentation_length unless presentation_length.nil?
+      payload = call('generate_content', :post, '/content/generate', body: body)
+      GenerateContentData.new(payload)
+    end
+
+    # Download a generated artifact (WAV, MP4, PNG)
+    #
+    # `GET /content/download`
+    #
+    # @param content_id [String, nil]
+    # @return [DownloadContentData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def download_content(content_id: nil)
+      query = {}
+      query['content_id'] = content_id unless content_id.nil?
+      payload = call('download_content', :get, '/content/download', query: query)
+      DownloadContentData.new(payload)
+    end
+
+    # List sources and generated content for the active notebook
+    #
+    # `GET /content`
+    #
+    # @return [ListContentData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_content
+      payload = call('list_content', :get, '/content')
+      ListContentData.new(payload)
+    end
+
+    # Create a note in the active notebook
+    #
+    # `POST /content/notes`
+    #
+    # @return [CreateNoteData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def create_note
+      payload = call('create_note', :post, '/content/notes')
+      CreateNoteData.new(payload)
+    end
+
+    # Save the current chat discussion as a note
+    #
+    # `POST /content/chat-to-note`
+    #
+    # @return [SaveChatToNoteData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def save_chat_to_note
+      payload = call('save_chat_to_note', :post, '/content/chat-to-note')
+      SaveChatToNoteData.new(payload)
+    end
+
+    # Convert a note into a NotebookLM source
+    #
+    # `POST /content/notes/{noteTitle}/to-source`
+    #
+    # @param note_title [String]
+    # @return [ConvertNoteToSourceData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def convert_note_to_source(note_title:)
+      payload = call('convert_note_to_source', :post, "/content/notes/#{note_title}/to-source")
+      ConvertNoteToSourceData.new(payload)
+    end
+
+    # Run a batch of questions and write each answer to a vault directory
+    #
+    # Long-running: one NotebookLM answer per question, written as a markdown
+    # file conforming to the `nblm-answer-v1` schema. Size the client timeout
+    # accordingly (and the reverse-proxy read timeout, if any).
+    #
+    # `POST /batch-to-vault`
+    #
+    # @param questions [Array<String>]
+    # @param notebook_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param vault_dir [String, nil]
+    # @param slug_prefix [String, nil]
+    # @param source_format [String, nil]
+    # @param sleep_between_ms [Integer, nil]
+    # @param session_id [String, nil]
+    # @return [BatchToVaultData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def batch_to_vault(questions:, notebook_id: nil, notebook_url: nil, vault_dir: nil, slug_prefix: nil, source_format: nil, sleep_between_ms: nil, session_id: nil)
+      body = {}
+      body['questions'] = questions
+      body['notebook_id'] = notebook_id unless notebook_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['vault_dir'] = vault_dir unless vault_dir.nil?
+      body['slug_prefix'] = slug_prefix unless slug_prefix.nil?
+      body['source_format'] = source_format unless source_format.nil?
+      body['sleep_between_ms'] = sleep_between_ms unless sleep_between_ms.nil?
+      body['session_id'] = session_id unless session_id.nil?
+      payload = call('batch_to_vault', :post, '/batch-to-vault', body: body)
+      BatchToVaultData.new(payload)
+    end
+
+    # List the notebook's notes
+    #
+    # `POST /content/notes/list`
+    #
+    # @param notebook_url [String, nil]
+    # @param session_id [String, nil]
+    # @return [ListNotesData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def list_notes(notebook_url: nil, session_id: nil)
+      body = {}
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['session_id'] = session_id unless session_id.nil?
+      payload = call('list_notes', :post, '/content/notes/list', body: body)
+      ListNotesData.new(payload)
+    end
+
+    # Read one note's content, by title or id
+    #
+    # `POST /content/notes/get`
+    #
+    # @param note_title [String, nil]
+    # @param note_id [String, nil]
+    # @param notebook_url [String, nil]
+    # @param session_id [String, nil]
+    # @return [GetNoteData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def get_note(note_title: nil, note_id: nil, notebook_url: nil, session_id: nil)
+      body = {}
+      body['note_title'] = note_title unless note_title.nil?
+      body['note_id'] = note_id unless note_id.nil?
+      body['notebook_url'] = notebook_url unless notebook_url.nil?
+      body['session_id'] = session_id unless session_id.nil?
+      payload = call('get_note', :post, '/content/notes/get', body: body)
+      GetNoteData.new(payload)
+    end
+
+    # Wipe all local data (requires confirmation)
+    #
+    # `POST /cleanup-data`
+    #
+    # @param confirm [Boolean, nil]
+    # @return [CleanupDataData]
+    # @raise [NotebookLM::Refused] when the server declines the request
+    def cleanup_data(confirm: nil)
+      body = {}
+      body['confirm'] = confirm unless confirm.nil?
+      payload = call('cleanup_data', :post, '/cleanup-data', body: body)
+      CleanupDataData.new(payload)
+    end
+  end
+
+  class Client
+    include Operations
+  end
+end