pinecall 0.11.4 → 0.11.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43bebb5ab4dd051ab2af6cc5cfbb32f2ca274a5c3737f0fcf0e80056e4d280fe
-  data.tar.gz: 634e434facf838d4932fc3452cef18bd547e1addec7909741016103007b3d094
+  metadata.gz: 66acc2b03dc885f895bb10ccd87704dee937ff8d95424b0e234d1b472e7b5b28
+  data.tar.gz: f123a4e58f6bde1752fbf23b7721833d38c1bbe206f04572965ad17e59225c4d
 SHA512:
-  metadata.gz: 36fa1b5a38640ae29d537479d82796f4a84ab3f0254cbeedea44bef81f47e06bfc49115aaf776a1d823bb251fc7d44669597c0e48f841f6678c0afd123dfc696
-  data.tar.gz: 84e024596243d33defe043627f2d0909fd956caa4b2c77e3801562530ab741c7b2262ae3a7af85226004941e71404efa7fc6e0198be0b9019202745fa5179b9a
+  metadata.gz: 0f4c8e96249c20f53d43f72637856f0252d545b516ca706ef841f998bb8b69b25b15b3d5b9b7705ee635c941d06944499ecab3847850071811772d279ecca6c7
+  data.tar.gz: a3354001ed6b79605e0d230e8e145ca362b517c59fdf5f9df870ec561c1cd06f6404134bc669a1a22af455d430f6e77688af71a0dd4eb0fa7f062aa8bac9e47b

data/CHANGELOG.md

@@ -4,6 +4,26 @@ 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.
 
+## [0.11.6] — Released with every other package (2026-10-19)
+
+- Nothing of the gem changed: published at 0.11.6 with every other package.
+
+## [0.11.5] — realtime: a voice call's model that hears and speaks itself, beside the llm (2026-10-19)
+
+- **A voice call runs on a realtime model while a written call keeps the LLM.** `realtime "xai/grok-voice-3.0", options: { voice: "eve" }` names the
+  model the agent's voice calls (phone and web) run on alone, one that hears and speaks itself — no
+  ears, its own voice — while the `llm` keeps answering its written calls. Its options run on the
+  org's own key for the vendor; an `llm` that names such a model is refused at registration.
+
+- **An agent an admin killed is declared no more.** An `error` coded `killed` on one agent
+  (`POST /v1/agents/{slug}/kill`) drops it from the agents the client declares: the socket stays,
+  the other agents go on, and a reconnect leaves the killed one out.
+
+- **An agent no longer says it will check and then stops.** The first protocol every agent is given now
+  says to call the tool in the same reply, that saying it is about to act does not act, and never to ask
+  the caller to wait: once it stops talking nothing happens until the caller speaks. Open models said
+  "Let me check the details of your order. Please wait." and ended the turn (2026-10-18).
+
 ## [0.11.4] — Released with every other package (2026-10-17)
 
 - Nothing of the Ruby SDK changed: published at 0.11.4 with every other package.

data/README.md

@@ -66,7 +66,7 @@ project laid out as `agents/<name>/agent.rb`, with this gem in its `Gemfile`:
 ```bash
 bundle add pinecall
 npm i -g pinecall                     # the CLI: Node, whatever the agent is written in
-pinecall link                         # this folder tied to your org: its key, in ./.env
+pinecall login                        # this machine signed in, once; pinecall.json names the org
 pinecall prompt --state agents/<name>/test/goldens/a.json   # the exact prompt a state produces. No gateway.
 pinecall chat                         # the agent served from this terminal, and a caller against it
 pinecall test                         # ring 1: the goldens, scored by the gateway
@@ -99,6 +99,10 @@ agent.on("turn.user") { |data, call| call.say("I heard: #{data[:text]}") }
 pc.connect
 ```
 
+`PINECALL_KEY` here is a server's token, made in the console's API keys screen for the org and the
+environment the process runs in — not your own sign-in, which stays on your machine. On a runtime
+of your own the URL is its gateway's (`http://127.0.0.1:8080` on your machine).
+
 ## Testing it
 
 Agent tests run with no network, key, model or gateway:

data/lib/pinecall/agent/config.rb

@@ -13,7 +13,7 @@ module Pinecall
       AS_WRITTEN = %i[phone whatsapp web channel_rules].freeze
 
       # The settings a class may declare. Must match the TypeScript package's `ENVIRONMENT`.
-      ENVIRONMENT = %i[language voice llm stt judge greeting hangup turn says hears knowledge docs memory record].freeze
+      ENVIRONMENT = %i[language voice llm realtime stt judge greeting hangup turn says hears knowledge docs memory record].freeze
 
       # The ones written as the wire's own fields, keyword by keyword: `greeting say: "…"`.
       AS_KEYWORDS = %i[turn knowledge docs memory].freeze
@@ -81,6 +81,15 @@ module Pinecall
           environment[:llm] = { **Config.model_of(model), temperature:, builds:, options: }.compact
         end
 
+        # The model a voice call runs on alone, one that hears and speaks itself; a written call
+        # keeps the `llm`: `realtime "xai/grok-voice-3.0", options: { voice: "eve" }`. Its options
+        # run on the org's own key for the vendor.
+        def realtime(model = NOTHING, options: nil)
+          return environment[:realtime] if model.equal?(NOTHING)
+
+          environment[:realtime] = { **Config.model_of(model), options: }.compact
+        end
+
         # The ears, `vendor/model` or a vendor alone, and who says the caller's turn is over:
         # `end_of_turn: "stt"` the ears themselves (Deepgram Flux), `"livekit"` or `"smart-turn"`.
         def stt(model = NOTHING, builds: nil, options: nil, end_of_turn: nil)

data/lib/pinecall/client.rb

@@ -33,6 +33,10 @@ module Pinecall
     # A stop from the org: the socket is closed for good and the app decides what comes next.
     STOPPED = "stopped"
 
+    # One agent an admin killed (`POST /v1/agents/{slug}/kill`): the gateway let go of it, and the
+    # client declares it no more when it reconnects. The other agents go on.
+    KILLED = "killed"
+
     # Seconds the running tools are given to answer once a drain was asked.
     TOOLS_FINISH_WITHIN_S = 30
 
@@ -173,11 +177,14 @@ module Pinecall
       return if agent.nil?
 
       guarded { agent.take(entry) }
+      @agents.delete(entry.agent) if killed?(entry)
     end
 
     # An `error` coded `stopped` for no agent: a member of the org pressed Stop.
     def stop?(entry) = entry.type == "error" && entry.agent.to_s.empty? && entry.data[:code] == STOPPED
 
+    def killed?(entry) = entry.type == "error" && entry.data[:code] == KILLED
+
     # With no stop listener the stop is reported as an error, so it is never silent.
     # Every agent registered again, then whoever asked to know.
     def opened

data/lib/pinecall/rules.rb

@@ -13,7 +13,8 @@ module Pinecall
     ].join("\n").freeze
 
     PROTOCOLS = [
-      "- To act, call a tool; saying you have done something does not do it.",
+      "- To act, call a tool in the same reply; saying you have done something, or that you are about to, " \
+      "does not do it. Never ask the caller to wait: once you stop talking, nothing happens until they speak again.",
       "- Before an irreversible action read back what you are about to do and wait for an explicit yes.",
       "- If you cannot solve it, say so and offer to hand over to a person."
     ].join("\n").freeze

data/lib/pinecall/version.rb

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

data/lib/pinecall/wire/shapes_doors.rb

@@ -22,6 +22,7 @@ module Pinecall
           greeting: { kind: :ref, ref: "GreetingConfig" },
           voice: { kind: :ref, ref: "VoiceConfig" },
           llm: { kind: :ref, ref: "ModelConfig" },
+          realtime: { kind: :ref, ref: "ModelConfig" },
           stt: { kind: :ref, ref: "ModelConfig" },
           judge: { kind: :ref, ref: "ModelConfig" },
           turn: { kind: :ref, ref: "TurnConfig" },

metadata

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