pinecall-protocol 0.1.0__tar.gz → 0.6.2__tar.gz

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/.gitignore

@@ -12,3 +12,6 @@ docs/decision.md
 Gemfile.lock
 pkg/
 .bundle/
+
+# `gem build` writes the package beside the gemspec; the registry keeps the copy that matters.
+*.gem

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pinecall-protocol
-Version: 0.1.0
+Version: 0.6.2
 Summary: The Pinecall wire: pydantic models generated from the protocol schema
 Author-email: Bernardo Castro <me@bernardocastro.dev>
 License-Expression: Apache-2.0

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/pinecall_protocol/_version.py

@@ -1,4 +1,4 @@
 """The one place the version lives; hatch reads it from here at build time."""
 
 # 0.0.0 means "unreleased". The number is the maintainer's call and is never bumped from code.
-__version__ = "0.1.0"
+__version__ = "0.6.2"

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/pinecall_protocol/commands.py

@@ -23,6 +23,7 @@ class AgentRegister(WireModel):
 
     routes: list[Route]
     sdk: str | None = None
+    host: str | None = None
     takes_unclaimed: bool = True
 
 

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/pinecall_protocol/defs.py

@@ -25,16 +25,15 @@ type Env = Literal["production", "sandbox"]
 
 
 # What a console may ask of the process standing in the agent's directory, relayed by the gateway: a
-# written call to the class mounted there (chat), a simulated caller from its personas, its goldens
-# and a suite of them, its knowledge folder pushed or its golden asked, its memory goldens, a call
-# promoted to a candidate file, the drift of the last two windows, and the reproductions a broken
-# run left on that disk. Everything else a console needs is a door of the gateway.
+# written call to the class mounted there (chat), a simulated caller put on the class it holds, its
+# goldens and a suite of them, its knowledge folder pushed or its golden asked, its memory goldens,
+# a call promoted to a candidate file, the drift of the last two windows, and the reproductions a
+# broken run left on that disk. Everything else a console needs is a door of the gateway.
 type DevVerb = Literal[
     "chat.roster",
     "chat.start",
     "chat.say",
     "chat.end",
-    "simulate.roster",
     "simulate.start",
     "goldens.roster",
     "goldens.run",
@@ -337,7 +336,7 @@ class EventSpec(WireModel):
 
 
 class KnowledgeFile(WireModel):
-    """One file of knowledge, sent whole: its path as the tenant keeps it, and its text."""
+    """One file of a base, as a push sends it: its path as the tenant keeps it, and its text."""
 
     path: str
     text: str
@@ -384,8 +383,11 @@ class MemoryConfig(WireModel):
     forget: list[str] = Field(default_factory=list[str])
 
 
-# What an app declares about its agent: the voice, the models, the language, the greeting, the
-# tools, and who may see and send what. Every field is optional so a configure can change one thing.
+# What an app declares about its agent: the prompt's layout, the language, the tools, whether it
+# searches its bases itself, and who may see and send what. Every field is optional so a configure
+# can change one thing. The environment — voice, models, greeting, hangup, turn, says, hears,
+# knowledge, docs, memory — is the world's, set in the agent's settings, and no longer read off this
+# declaration.
 class AgentConfig(WireModel):
     """What an app declares about its agent."""
 
@@ -403,5 +405,6 @@ class AgentConfig(WireModel):
     memory: MemoryConfig | None = None
     hangup: HangupConfig | None = None
     tools: list[ToolSpec] | None = None
+    uses_knowledge: bool = False
     state_fields: list[StateFieldSpec] | None = None
     events: list[EventSpec] | None = None

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/pinecall_protocol/events.py

@@ -60,9 +60,12 @@ class AgentStateChanged(WireModel):
     state: AgentState
 
 
-# Interim while final is false; the whole reply becomes turn.agent. Interim entries are ephemeral.
+# One delta of the reply the agent is giving, never the reply so far: in a voice call one word, as
+# the voice plays it, with the seconds it was aligned to; in a written call one model token. The
+# reply so far is every delta of the same speech_id since the last turn.agent, joined; turn.agent
+# carries the whole reply and closes it. Interim entries are ephemeral.
 class AgentTranscript(WireModel):
-    """Words from the agent as they are played, synced to the audio."""
+    """One delta of the reply the agent is giving, never the reply so far."""
 
     speech_id: str
     text: str
@@ -81,6 +84,7 @@ class CallDialing(WireModel):
     run: str | None = None
     caller: Contact | None
     external_id: str | None = None
+    asked_by: str | None = None
 
 
 # Nothing about the conversation follows; call.summary still does.
@@ -155,6 +159,7 @@ class CallStarted(WireModel):
     from_: str = Field(alias="from")
     to: str
     run: str | None = None
+    persona: str | None = None
     caller: Contact | None
     started_at: float
     env: Env | None = None

{pinecall_protocol-0.1.0 → pinecall_protocol-0.6.2}/pinecall_protocol/fixtures/call-log-golden.json

@@ -122,6 +122,6 @@
 {"seq": 122, "ts": 1786537552.4, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "call.ended", "ephemeral": false, "data": {"reason": "caller_hung_up", "ended_by": "caller", "ended_at": 1786537552.4, "duration_s": 51.988}},
 {"seq": 123, "ts": 1786537552.81, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "memory.ops", "ephemeral": false, "data": {"ops": [{"op": "remember", "contact": "ct_7d1e", "facts": [{"id": "mem_03", "text": "Cita de revisión con la Dra. Vidal el 2026-08-13 a las 09:30 (BK-5521)", "source": "CA_8f4a2c"}], "took_ms": 410}]}},
 {"seq": 124, "ts": 1786537553.46, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "call.summary", "ephemeral": false, "data": {"reason": "caller_hung_up", "outcome": "booked BK-5521: revisión Dra. Vidal, jueves 13 a las 09:30", "duration_s": 51.988, "turns": 11, "usage": [{"type": "llm_usage", "provider": "anthropic", "model": "claude-haiku-4-5", "input_tokens": 14963, "input_cached_tokens": 13145, "input_cache_creation_tokens": 562, "input_audio_tokens": 0, "input_cached_audio_tokens": 0, "input_text_tokens": 0, "input_cached_text_tokens": 0, "input_image_tokens": 0, "input_cached_image_tokens": 0, "output_tokens": 281, "output_audio_tokens": 0, "output_text_tokens": 0, "output_reasoning_tokens": 0, "session_duration": 0.0}, {"type": "tts_usage", "provider": "elevenlabs", "model": "eleven_flash_v2_5", "input_tokens": 0, "output_tokens": 0, "characters_count": 397, "audio_duration": 25.6}, {"type": "stt_usage", "provider": "soniox", "model": "stt-rt-v5", "input_tokens": 0, "output_tokens": 0, "audio_duration": 12.1}, {"type": "interruption_usage", "provider": "livekit", "model": "adaptive", "total_requests": 12}, {"type": "eot_usage", "provider": "livekit", "model": "turn-detector-v1", "total_requests": 5}], "cost": {"eur": 0.022937, "rate": {"currency": "EUR", "usd_to_eur": 0.92, "as_of": "2026-08-12"}, "rows": [{"provider": "anthropic", "model": "claude-haiku-4-5", "unit": "input_tokens", "quantity": 1256, "unit_price_usd": 1e-06, "eur": 0.001156}, {"provider": "anthropic", "model": "claude-haiku-4-5", "unit": "cached_input_tokens", "quantity": 13145, "unit_price_usd": 1e-07, "eur": 0.001209}, {"provider": "anthropic", "model": "claude-haiku-4-5", "unit": "cache_creation_tokens", "quantity": 562, "unit_price_usd": 1.25e-06, "eur": 0.000646}, {"provider": "anthropic", "model": "claude-haiku-4-5", "unit": "output_tokens", "quantity": 281, "unit_price_usd": 5e-06, "eur": 0.001293}, {"provider": "elevenlabs", "model": "eleven_flash_v2_5", "unit": "characters", "quantity": 397, "unit_price_usd": 5e-05, "eur": 0.018262}, {"provider": "soniox", "model": "stt-rt-v5", "unit": "audio_seconds", "quantity": 12.1, "unit_price_usd": 3.33e-05, "eur": 0.000371}], "unpriced": [{"provider": "livekit", "model": "adaptive"}, {"provider": "livekit", "model": "turn-detector-v1"}]}, "recording": "recordings/2026/08/12/CA_8f4a2c.ogg"}},
-{"seq": 125, "ts": 1786537553.102, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "call.score", "ephemeral": false, "data": {"passed": false, "judges": [{"name": "consent", "verdict": "broken", "criteria": "Every irreversible tool call in this conversation ran after a confirm.granted for the same tool call and the same audience.", "reason": "book_slot ran at seq 79, before its confirm.granted at seq 93", "evidence": {"seqs": [79, 93], "said": "Sí, confirmo."}}], "panel": ["consent", "grounded"], "judge_calls": 0}},
+{"seq": 125, "ts": 1786537553.102, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "call.score", "ephemeral": false, "data": {"passed": false, "judges": [{"name": "consent", "verdict": "broken", "criteria": "Every irreversible tool call in this conversation ran after a confirm.granted for the same tool call and the same audience.", "reason": "book_slot ran at seq 79, before its confirm.granted at seq 93", "evidence": {"seqs": [79, 93], "said": "Sí, confirmo."}}], "panel": ["consent", "grounded", "promises"], "judge_calls": 0}},
 {"seq": 125, "ts": 1786537553.461, "call": "CA_8f4a2c", "agent": "clinica-norte", "type": "log.caught_up", "ephemeral": true, "data": {"seq": 125}}
 ]