pinecall 0.11.20 → 0.11.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92fa7d36f3fea184946e3f008f6bb5c3af02036ec34c0d98c668057d5d0026dc
-  data.tar.gz: a9d00558ca5de5bd5c7458d0dbae44c9400fee3071aa13705042d6eb380111b0
+  metadata.gz: f69d47743412da64cc63fde25f84698b2d956b746a18fdf7b386f91de0a71af1
+  data.tar.gz: 39228564448fddccb6d58528ac06df22e56e5fef66d5955823cf405d234cf41b
 SHA512:
-  metadata.gz: 3aee7697d3c30fe185597092ab61435e14368adac8cacd8effb3fcfe987057f3a3fef6b181a9b01bce201f2f39e9f70da0b779e5fa15d62424ce5fbb024f3037
-  data.tar.gz: 00dcd1199414dcfabb589a52114f2e44997368a1e9707c3dc5d45c4aefcc8e583785faa0a64759b64a426175234ca4ecbf49038753eb518d7be33f214147a60d
+  metadata.gz: 78569b72357c0e3cdc2d82cd7dfcc7f55a89212fbcbfa2fdfe494c8a8613df1e67a589c245d8feca87a18a2be01b3ddf8f5492c2b17a8dda2546ab8c62f498ee
+  data.tar.gz: 737ee767f0139182c3916601be8eb328273a310e4283d753b89048f94674da6819035d54c9bf76f76d71244ce5c27689ab64f251e75e014feac26c4d38dd384e

data/CHANGELOG.md

@@ -4,6 +4,20 @@ Every change a person using this gem would notice. The format is
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version numbers and tags are the
 maintainer's call.
 
+## [Unreleased]
+
+## [0.11.21] — released with the tutor's walks (2026-10-25)
+
+- **`call.participant(id).mute` works**: it sent a `muted:` field `participant.mute` does not have, and
+  the gateway refused every one. The wire has no unmute. (2026-10-24 tools eval, R F5)
+- **A view that names what nothing answers says the name**, in the log and on the terminal, instead of
+  Ruby's NameError with the view's context inspected — the state's private values among it. (R F6)
+- **A class refused as it loads is one sentence through `pinecall start` and `prompt`**, exit 2, never a
+  backtrace; an option `tool` does not take is refused as `tool takes no …`. (R F19 · R F1)
+- **The view's `resumed` is true on a call handed over mid-conversation**, and `remembers?` matches case
+  aside, as in every SDK.
+- `docs/writing-an-agent.md`: every refusal at load, the ones past the table's seven included. (R F1)
+
 ## [0.11.20] — released with the runtime's live readers (2026-10-24)
 
 - Nothing of the gem changed: published at 0.11.20 with every other package.

data/lib/pinecall/agent/tools.rb

@@ -24,7 +24,7 @@ module Pinecall
         # @param params [Hash{Symbol=>Object}] parameter types, e.g. `{ day: String, how_many: Integer }`
         def tool(**options)
           unknown = options.keys - %i[when stage confirm announce preview pii timeout params doc]
-          raise DeclarationRefused, "@tool takes no #{unknown.join(", ")}" unless unknown.empty?
+          raise DeclarationRefused, "tool takes no #{unknown.join(", ")}" unless unknown.empty?
 
           @pending_tool = options
         end

data/lib/pinecall/bridge.rb

@@ -22,8 +22,9 @@ module Pinecall
     # One served call: its instance, what was last sent, and a thread running its jobs in order.
     class Live
       attr_reader :agent, :world, :sent, :stops
-      # What memory recalled about this caller in this call: what `remembers?` answers from.
-      attr_accessor :tools_shown, :remembered
+      # What memory recalled about this caller in this call: what `remembers?` answers from; and whether
+      # the call was handed over mid-conversation, the view's `resumed`.
+      attr_accessor :tools_shown, :remembered, :resumed
 
       def initialize(agent, world)
         @agent = agent
@@ -31,6 +32,7 @@ module Pinecall
         @sent = {}
         @tools_shown = nil
         @remembered = []
+        @resumed = false
         @stops = {}
         @work = Thread::Queue.new
         @thread = Thread.new { work }
@@ -100,6 +102,7 @@ module Pinecall
       instance = klass.new.seal
       instance.reads_last_from(last) unless last.nil?
       serving = Live.new(instance, world_for(call, client))
+      serving.resumed = true
       instance.serving(serving.world)
       live[call.id] = serving
       serving.later do
@@ -250,7 +253,7 @@ module Pinecall
     def sync(serving, call)
       line = { channel: call.channel || "web", from: call.from, claimed: serving.world.claimed }
       begin
-        rendered = Prompt.render(serving.agent, remembered: serving.remembered, line:)
+        rendered = Prompt.render(serving.agent, resumed: serving.resumed, remembered: serving.remembered, line:)
         visible = serving.agent.visible_tools
       rescue StandardError => e
         return failed_to_render(call, e)
@@ -269,8 +272,26 @@ module Pinecall
 
     # A view that fails fails its call, never the process: the model keeps the view it had, and the log says why.
     def failed_to_render(call, error)
-      call.log("render.failed", { error: error.class.to_s, message: error.message })
-      warn("pinecall: #{call.id} could not render its view and goes on with the one it had: #{error.message}")
+      said = failure_of(error)
+      call.log("render.failed", { error: error.class.to_s, message: said })
+      warn("pinecall: #{call.id} could not render its view and goes on with the one it had: #{said}")
+    end
+
+    # A NameError's message is Ruby's, with the view's whole context inspected, its state's private values
+    # among them (R F6): the name it missed is the sentence, which a person can act on.
+    def failure_of(error)
+      case error
+      when NoMethodError then "the view calls #{error.name} on #{receiver_of(error)}, which does not answer it"
+      when NameError then "the view names #{error.name}, which is no field of the state, no call and no method of the class"
+      else error.message
+      end
+    end
+
+    # The class of what the method was called on (nil, most often): the value itself may be private.
+    def receiver_of(error)
+      error.receiver.nil? ? "nil" : error.receiver.class.to_s
+    rescue ArgumentError
+      "something"
     end
 
     # A hook that raises fails its call, never the process: the call goes on with what the hook wrote

data/lib/pinecall/call_world/room.rb

@@ -17,7 +17,8 @@ module Pinecall
         @send = send
       end
 
-      def mute(muted: true) = @send.call("participant.mute", { identity: @identity, muted: })
+      # For the rest of the call: the wire has no unmute (`participant.mute` carries the identity alone).
+      def mute = @send.call("participant.mute", { identity: @identity })
 
       def remove = @send.call("participant.remove", { identity: @identity })
     end

data/lib/pinecall/reading.rb

@@ -20,7 +20,8 @@ module Pinecall
 
     # Whether a remembered fact contains `text`. Views may branch on facts but never print them;
     # facts reach the model only as tool results.
-    def remembers?(text) = @remembered.any? { |fact| fact.to_s.include?(text.to_s) }
+    # Case aside, as in every SDK: "usual doctor" is in "Usual doctor is Dr. Vidal.".
+    def remembers?(text) = @remembered.any? { |fact| fact.to_s.downcase.include?(text.to_s.downcase) }
 
     def respond_to_missing?(name, include_private = false)
       @state.key?(name) || super

data/lib/pinecall/serve.rb

@@ -32,7 +32,8 @@ module Pinecall
       when "prompt" then prompt(Loading.parse(rest), out:)
       else err.puts(USAGE) || 2
       end
-    rescue CannotServe, NotConnected, Refused => e
+    # A class refused as it loads is one sentence too, never a backtrace (R F19).
+    rescue CannotServe, NotConnected, Refused, DeclarationRefused => e
       err.puts(e.message)
       2
     end

data/lib/pinecall/version.rb

@@ -2,5 +2,5 @@
 
 module Pinecall
   # Set by the maintainer at release time.
-  VERSION = "0.11.20"
+  VERSION = "0.11.21"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pinecall
 version: !ruby/object:Gem::Version
-  version: 0.11.20
+  version: 0.11.21
 platform: ruby
 authors:
 - Pinecall