notebooklm 4.7.0

data/lib/notebooklm/model.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module NotebookLM
+  # The base of every shape the server answers with.
+  #
+  # Ruby has no structs to generate, so a shape is a thin reader over the
+  # JSON the server actually sent. Three properties matter:
+  #
+  # - every field the specification documents has a reader, under its Ruby
+  #   name, so the shape is discoverable without reading the wire;
+  # - the body is kept verbatim in {#to_h}, and a field the server added
+  #   after this version was generated is still reachable with `[]` — an
+  #   unknown shape is never a wall;
+  # - an absent scalar reads as `nil`, never as `0` or `""`. A default of
+  #   zero for a missing offset is how a citation gets attributed to the
+  #   first page of a long document.
+  #
+  # Nested objects read as their own shape even when absent, so a chain like
+  # `answer.sources.citations` is safe on an answer that carried no sources.
+  class Model
+    # @param raw [Hash] the JSON object the server sent
+    def initialize(raw = {})
+      @raw = raw.is_a?(Hash) ? raw : {}
+      @read = {}
+    end
+
+    # @return [Hash] the body exactly as the server sent it
+    attr_reader :raw
+    alias to_h raw
+
+    # Any field, documented or not, under its wire name.
+    # @return [Object, nil]
+    def [](key)
+      @raw[key.to_s]
+    end
+
+    # @return [Boolean] whether the server sent this field at all
+    def key?(key)
+      @raw.key?(key.to_s)
+    end
+
+    def ==(other)
+      other.instance_of?(self.class) && other.raw == @raw
+    end
+    alias eql? ==
+
+    def hash
+      [self.class, @raw].hash
+    end
+
+    def inspect
+      "#<#{self.class.name} #{@raw.inspect}>"
+    end
+
+    def to_json(*args)
+      @raw.to_json(*args)
+    end
+
+    class << self
+      # Declare one documented field.
+      #
+      # `type` is a class *name*, not a class: the generated file defines
+      # shapes in the order the specification lists them, and a shape can
+      # name one that comes later or itself. Resolving the name on first read
+      # makes the order irrelevant.
+      #
+      # @param ruby [Symbol] the reader's name
+      # @param wire [String] the key the server uses
+      # @param type [String, nil] the nested shape's class name, if any
+      # @param array [Boolean] whether the field holds a list
+      def field(ruby, wire, type: nil, array: false)
+        fields[ruby] = { wire: wire, type: type, array: array }
+        define_method(ruby) { read_field(ruby) }
+      end
+
+      # @return [Hash{Symbol => Hash}] every declared field of this shape
+      def fields
+        @fields ||= {}
+      end
+    end
+
+    private
+
+    def read_field(ruby)
+      return @read[ruby] if @read.key?(ruby)
+
+      spec = self.class.fields.fetch(ruby)
+      @read[ruby] = coerce(@raw[spec[:wire]], spec)
+    end
+
+    def coerce(value, spec)
+      type = spec[:type]
+      if spec[:array]
+        list = value.is_a?(Array) ? value : []
+        type ? list.map { |item| resolve(type).new(item) } : list
+      elsif type
+        # Absent reads as an empty shape rather than nil, so a reader can be
+        # chained without a guard at every hop.
+        resolve(type).new(value.is_a?(Hash) ? value : {})
+      else
+        value
+      end
+    end
+
+    def resolve(name)
+      NotebookLM.const_get(name)
+    end
+  end
+end

data/lib/notebooklm/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module NotebookLM
+  # The gem tracks the server's version on purpose: it is a client for one
+  # API, and a reader comparing the two should not have to map between two
+  # numbering schemes. Kept in step by `npm run version:sync`.
+  VERSION = '4.7.0'
+end

data/lib/notebooklm.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'notebooklm/version'
+require_relative 'notebooklm/errors'
+require_relative 'notebooklm/model'
+require_relative 'notebooklm/client'
+require_relative 'notebooklm/generated'
+require_relative 'notebooklm/ergonomics'
+
+# A Ruby client for a local Gemini Notebook (NotebookLM) server.
+#
+# Google ships no public API for the consumer product, and the part that
+# cannot live in a gem is the Google session: the login is bound to the machine
+# it was made on, the session expires server-side while local cookies still
+# look valid, and the browser driving it has to stay patched against
+# detection. So this gem does not own a browser. It talks to a process that
+# does — `npx -y @roomi-fields/notebooklm-mcp`, listening on loopback — and
+# gives you its API with documented shapes instead of raw hashes.
+#
+# @example
+#   client = NotebookLM.local
+#   library = client.list_notebooks
+#   answer = client.ask(library.notebooks.first.id, 'What is this notebook about?')
+#   puts answer.answer
+#   answer.citations.each { |c| puts "  [#{c.number}] #{c.source_text}" }
+module NotebookLM
+  # A client for the usual loopback address and port.
+  #
+  # @param options [Hash] passed through to {Client#initialize}
+  # @return [Client]
+  def self.local(**options)
+    Client.new(**options)
+  end
+end

data/notebooklm.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'lib/notebooklm/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'notebooklm'
+  spec.version = NotebookLM::VERSION
+  spec.authors = ['Roomi Fields']
+  spec.license = 'MIT'
+
+  spec.summary = 'Ruby client for a local Gemini Notebook (NotebookLM) server'
+  spec.description = <<~TEXT
+    Google ships no public API for the consumer NotebookLM. This gem does not
+    own a browser: it talks to the local notebooklm-mcp server that does, and
+    gives you its 56 operations as documented Ruby methods, generated from the
+    server's OpenAPI specification. No runtime dependencies.
+  TEXT
+
+  spec.homepage = 'https://github.com/roomi-fields/notebooklm-mcp'
+  spec.metadata = {
+    'homepage_uri' => spec.homepage,
+    'source_code_uri' => 'https://github.com/roomi-fields/notebooklm-mcp/tree/main/gems/notebooklm',
+    'changelog_uri' => 'https://github.com/roomi-fields/notebooklm-mcp/blob/main/CHANGELOG.md',
+    'documentation_uri' => 'https://notebooklm.roomi-fields.com/',
+    'bug_tracker_uri' => 'https://github.com/roomi-fields/notebooklm-mcp/issues',
+    'rubygems_mfa_required' => 'true'
+  }
+
+  spec.required_ruby_version = '>= 3.1'
+
+  spec.files = Dir['lib/**/*.rb'] + ['README.md', 'notebooklm.gemspec']
+  spec.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: notebooklm
+version: !ruby/object:Gem::Version
+  version: 4.7.0
+platform: ruby
+authors:
+- Roomi Fields
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-11-07 00:00:00.000000000 Z
+dependencies: []
+description: |
+  Google ships no public API for the consumer NotebookLM. This gem does not
+  own a browser: it talks to the local notebooklm-mcp server that does, and
+  gives you its 56 operations as documented Ruby methods, generated from the
+  server's OpenAPI specification. No runtime dependencies.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/notebooklm.rb
+- lib/notebooklm/client.rb
+- lib/notebooklm/ergonomics.rb
+- lib/notebooklm/errors.rb
+- lib/notebooklm/generated.rb
+- lib/notebooklm/model.rb
+- lib/notebooklm/version.rb
+- notebooklm.gemspec
+homepage: https://github.com/roomi-fields/notebooklm-mcp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/roomi-fields/notebooklm-mcp
+  source_code_uri: https://github.com/roomi-fields/notebooklm-mcp/tree/main/gems/notebooklm
+  changelog_uri: https://github.com/roomi-fields/notebooklm-mcp/blob/main/CHANGELOG.md
+  documentation_uri: https://notebooklm.roomi-fields.com/
+  bug_tracker_uri: https://github.com/roomi-fields/notebooklm-mcp/issues
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby client for a local Gemini Notebook (NotebookLM) server
+test_files: []