pinecall 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4205f3b294e177f7c8a8f20cebd3328905325b641ad75cd599b85df123d936bb
-  data.tar.gz: 755d0797bdea90ec719041d361dbee4303f94a90397fff5a436fb7bcd3b94aaf
+  metadata.gz: a2a10f0e074b767542af49bb9d9d6ae3251e230b371debee5d5e5628c92f67b2
+  data.tar.gz: 81be17cb2c53a7c5c6fc3d188f7b38abd16f265afafc8c3d0a089933fb126809
 SHA512:
-  metadata.gz: 3e15725d85b5b9c5c333c117885e7473e357505482beb8b174444832cd553dcb6d5872b98efd97b5b3ee125efb83fc817c1c30801d153c5580e3d546c6ec869d
-  data.tar.gz: 739b4d2818d539d9055631e37eb49ea9c9e2f5c68319d4fc73a449f5ede5027d80af84c9246096428f914fed381d51103a3525c7babc2f0f794df4e4b1e27eef
+  metadata.gz: f7baea4bcf9f7b72c71d24e24ddf698e3afa5d06863d60dbd32943b8648705857e8b209b43130fc1c9e435673f03666f50a9ee7694f970c19f6ca2eb868e4ef9
+  data.tar.gz: e966301764b4ce05390cae2821339012f95106dea20593fc0e1ffc00106c48d348ef6e1f56ab46ca5ad6ce0f67fb1bb5072f071334f2d0ac59fdc8309269bdb3

data/CHANGELOG.md

@@ -6,6 +6,20 @@ version number is the human's call.
 
 ## [Unreleased]
 
+## [0.0.4] — A tool announces itself (2026-10-09)
+
+### Added
+- **`tool announce: "Let me check the agenda."`**: what the agent says as the tool starts, when the
+  model's turn said nothing itself; a turn that spoke and then called the tool is not announced
+  twice. Needs runtime 0.1.11.
+
+## [0.0.3] — A call runs on the day a golden pinned (2026-10-09)
+
+### Added
+- **`call.today` is the day `call.started` names when a golden pinned one** (`today`), so an agent
+  resolves "on Monday" against the golden's day, as the model does; the day the call opened
+  otherwise, as before. Needs runtime 0.1.10. `Pinecall::Testing`'s `call_started` takes `today:`.
+
 ## [0.0.2] — A refused registration is a sentence (2026-10-09)
 
 ### Fixed

data/lib/pinecall/agent/spec.rb

@@ -36,6 +36,7 @@ module Pinecall
             side_effect: options[:confirm] ? "irreversible" : "read"
           }
           spec[:confirm] = options[:confirm] if options[:confirm]
+          spec[:announce] = options[:announce] if options[:announce]
           spec[:pii] = pii!(options, spec) if options[:pii]
           spec[:timeout_s] = options[:timeout].to_f if options[:timeout]
           Wire::Validate.call!("ToolSpec", spec, where: "tool #{name}")

data/lib/pinecall/agent/tools.rb

@@ -17,12 +17,13 @@ module Pinecall
         # @param when [Proc] visibility predicate, evaluated against the state
         # @param stage [Symbol, Array<Symbol>] shorthand for a `when` on the stage field
         # @param confirm [String] read-back spoken before running; marks the tool irreversible
+        # @param announce [String] what the agent says as the tool starts, when its turn said nothing
         # @param preview [Integer] rows of a list result the model sees
         # @param pii [Array<Symbol>] parameters with personal data, masked in the log
         # @param timeout [Numeric] seconds the platform waits for the method
         # @param params [Hash{Symbol=>Object}] parameter types, e.g. `{ day: String, how_many: Integer }`
         def tool(**options)
-          unknown = options.keys - %i[when stage confirm preview pii timeout params doc]
+          unknown = options.keys - %i[when stage confirm announce preview pii timeout params doc]
           raise DeclarationRefused, "@tool takes no #{unknown.join(", ")}" unless unknown.empty?
 
           @pending_tool = options

data/lib/pinecall/client/call.rb

@@ -97,13 +97,15 @@ module Pinecall
         line = data[:started]
         started(line)
         @state = data[:state].dup
-        @today = Time.at(line[:started_at]).strftime("%Y-%m-%d")
+        @today = line[:today] || Time.at(line[:started_at]).strftime("%Y-%m-%d")
         @claimed = data[:claimed]
       end
 
       def started(line)
         the_line(line, "active")
         @medium = line[:medium]
+        # A run's call says its day, which a golden may have pinned; a person's runs on the clock's.
+        @today = line[:today] if line[:today]
       end
 
       def the_line(line, status)

data/lib/pinecall/testing.rb

@@ -127,11 +127,15 @@ module Pinecall
       # Unhandled errors, for assertions.
       attr_reader :errors
 
-      # Start a call and return its `Fake` handle; `state:` is the state its opener asked for.
-      def call_started(id: nil, channel: "web", from: "+34600000000", to: "+34910000000", caller: nil, state: nil)
+      # Start a call and return its `Fake` handle; `state:` is the state its opener asked for,
+      # `today:` the day a golden pinned (YYYY-MM-DD).
+      def call_started(id: nil, channel: "web", from: "+34600000000", to: "+34910000000", caller: nil, state: nil,
+                       today: nil)
         id ||= "CA_#{next_seq}"
         started = { channel:, direction: "inbound", from:, to:, caller:, started_at: Time.now.to_f }
-        deliver("call.started", state.nil? ? started : started.merge(state:), call: id)
+        started = started.merge(state:) unless state.nil?
+        started = started.merge(today:) unless today.nil?
+        deliver("call.started", started, call: id)
         settle
         Fake.new(self, id)
       end

data/lib/pinecall/version.rb

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

data/lib/pinecall/wire/shapes_call_events.rb

@@ -98,7 +98,8 @@ module Pinecall
           env: { kind: :ref, ref: "Env" },
           worker: { kind: :str, null: true },
           medium: { kind: :ref, ref: "Medium", null: true },
-          state: { kind: :json }
+          state: { kind: :json },
+          today: { kind: :str, null: true }
         }.freeze,
         "CallSummary" => {
           reason: { kind: :ref, ref: "EndReason", required: true },

data/lib/pinecall/wire/shapes_doors.rb

@@ -12,6 +12,7 @@ module Pinecall
           parameters: { kind: :json, required: true },
           side_effect: { kind: :enum, values: %w[read write irreversible], default: "read" },
           confirm: { kind: :str },
+          announce: { kind: :str },
           pii: { kind: :list, items: { kind: :str } },
           timeout_s: { kind: :float }
         }.freeze,

metadata

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