signalwire-sdk 3.0.2.dev74__tar.gz → 3.0.2.dev77__tar.gz

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.0.2.dev74
+Version: 3.0.2.dev77
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -247,7 +247,7 @@ client = RestClient(project="...", token="...", host="example.signalwire.com")
 
 client.fabric.ai_agents.create(name="Support Bot", prompt={"text": "You are helpful."})
 client.calling.play(call_id, play=[{"type": "tts", "text": "Hello!"}])
-client.phone_numbers.search(area_code="512")
+client.phone_numbers.search(areacode="512")
 client.datasphere.documents.search(query_string="billing policy")
 ```
 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/README.md

@@ -149,7 +149,7 @@ client = RestClient(project="...", token="...", host="example.signalwire.com")
 
 client.fabric.ai_agents.create(name="Support Bot", prompt={"text": "You are helpful."})
 client.calling.play(call_id, play=[{"type": "tts", "text": "Hello!"}])
-client.phone_numbers.search(area_code="512")
+client.phone_numbers.search(areacode="512")
 client.datasphere.documents.search(query_string="billing policy")
 ```
 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire-sdk"
-version = "3.0.2.dev74"
+version = "3.0.2.dev77"
 description = "SignalWire SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -167,6 +167,15 @@ signalwire = [
 target-version = "py310"
 line-length = 88
 
+[tool.ruff.format]
+# Pin STABLE formatting explicitly. Without this, CI's `ruff format --check` was
+# resolving preview-mode formatting (it wanted the preview-only frozenset({...})
+# collapse) while a local stable run left the file unchanged — a local≠CI split
+# with no visible cause. An explicit `preview = false` overrides any ambient
+# RUFF_PREVIEW env / default drift so the gate is deterministic and matches a
+# plain local `ruff format`.
+preview = false
+
 [tool.ruff.lint]
 # E4/E7/E9 + F are the ruff defaults (E501 line-length intentionally excluded —
 # formatting is owned by `ruff format`, not the linter). B = flake8-bugbear

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/__init__.py

@@ -24,7 +24,7 @@ if TYPE_CHECKING:
 
 configure_logging()
 
-__version__ = "3.0.2.dev74"
+__version__ = "3.0.2.dev77"
 
 # Import core classes for easier access.
 # These imports are intentionally placed after configure_logging() so the SDK's

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/agent_server.py

@@ -68,7 +68,7 @@ class AgentServer:
         self.app = FastAPI(
             title="SignalWire AI Agents",
             description="Hosted SignalWire AI Agents",
-            version="3.0.2.dev74",
+            version="3.0.2.dev77",
             redirect_slashes=False,
             docs_url=None,
             redoc_url=None,

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/core/contexts.py

@@ -19,6 +19,23 @@ MAX_CONTEXTS = 50
 MAX_STEPS_PER_CONTEXT = 100
 
 
+#: Valid values for a step's or context's ``history`` visibility mode.
+#:
+#: ``keep``     nothing is cleared — every prior step's instructions *and*
+#:              dialogue stay in the model's context.
+#: ``default``  prior step instructions are hidden; the dialogue is kept.
+#: ``hide``     prior instructions hidden **and** the prior dialogue pulled
+#:              out of the model's context. The only way back in is an
+#:              explicit ``${step_history.*}`` reference in the new prompt.
+HISTORY_MODES = ("keep", "default", "hide")
+
+
+def _validate_history(mode: str) -> str:
+    if mode not in HISTORY_MODES:
+        raise ValueError(f"history must be one of {HISTORY_MODES}, got {mode!r}")
+    return mode
+
+
 class GatherQuestion:
     """Represents a single question in a gather_info configuration"""
 
@@ -30,6 +47,7 @@ class GatherQuestion:
         confirm: bool = False,
         prompt: str | None = None,
         functions: list[str] | None = None,
+        isolated: bool | None = None,
     ):
         self.key = key
         self.question = question
@@ -37,6 +55,8 @@ class GatherQuestion:
         self.confirm = confirm
         self.prompt = prompt
         self.functions = functions
+        # Tri-state: None means "inherit the gather_info default"
+        self.isolated = isolated
 
     def to_dict(self) -> dict[str, Any]:
         """Convert question to dictionary for SWML generation"""
@@ -49,6 +69,9 @@ class GatherQuestion:
             d["prompt"] = self.prompt
         if self.functions:
             d["functions"] = self.functions
+        # Emitted even when False, so it can override an isolated gather
+        if self.isolated is not None:
+            d["isolated"] = self.isolated
         return d
 
 
@@ -65,11 +88,13 @@ class GatherInfo:
         output_key: str | None = None,
         completion_action: str | None = None,
         prompt: str | None = None,
+        isolated: bool = False,
     ):
         self._questions: list[GatherQuestion] = []
         self._output_key = output_key
         self._completion_action = completion_action
         self._prompt = prompt
+        self._isolated = isolated
 
     def add_question(self, key: str, question: str, **kwargs: Any) -> "GatherInfo":
         """
@@ -78,7 +103,7 @@ class GatherInfo:
         Args:
             key: Key name for storing the answer in global_data
             question: The question text to ask
-            **kwargs: Optional fields - type, confirm, prompt, functions
+            **kwargs: Optional fields - type, confirm, prompt, functions, isolated
 
         Returns:
             Self for method chaining
@@ -90,6 +115,7 @@ class GatherInfo:
             confirm=kwargs.get("confirm", False),
             prompt=kwargs.get("prompt"),
             functions=kwargs.get("functions"),
+            isolated=kwargs.get("isolated"),
         )
         self._questions.append(q)
         return self
@@ -105,6 +131,8 @@ class GatherInfo:
             d["output_key"] = self._output_key
         if self._completion_action:
             d["completion_action"] = self._completion_action
+        if self._isolated:
+            d["isolated"] = True
         return d
 
 
@@ -130,6 +158,9 @@ class Step:
         self._skip_user_turn: bool = False
         self._skip_to_next_step: bool = False
 
+        # Visibility of everything that came before this step
+        self._history: str | None = None
+
         # Reset object for context switching from steps
         self._reset_system_prompt: str | None = None
         self._reset_user_prompt: str | None = None
@@ -339,11 +370,46 @@ class Step:
         self._skip_to_next_step = skip
         return self
 
+    def set_history(self, history: str) -> "Step":
+        """
+        Control what the model still sees when this step is entered.
+
+        The mode applies at the moment this step is entered and governs
+        everything that came before it — including the turn that triggered the
+        transition. It does not affect this step's own turns, which accumulate
+        fresh. Nothing is deleted: the call log keeps every message.
+
+        Args:
+            history: One of:
+                - "keep": clear nothing. Every prior step's instructions and
+                  dialogue stay visible to the model.
+                - "default": hide the prior step *instructions*, keep the
+                  user/assistant dialogue. This is the default when unset.
+                - "hide": hide the prior instructions *and* pull the prior
+                  dialogue out of the model's context. Pair it with a
+                  ``${step_history.*}`` reference in this step's text to choose
+                  exactly what comes back.
+
+        Raises:
+            ValueError: if history is not one of the three modes.
+
+        Returns:
+            Self for method chaining
+
+        Example:
+            >>> step.set_history("hide").set_text(
+            ...     "Previously: ${step_history.prev.summary}\\n\\nNow help them."
+            ... )
+        """
+        self._history = _validate_history(history)
+        return self
+
     def set_gather_info(
         self,
         output_key: str | None = None,
         completion_action: str | None = None,
         prompt: str | None = None,
+        isolated: bool = False,
     ) -> "Step":
         """
         Enable info gathering for this step. Questions are presented one at a time
@@ -362,12 +428,20 @@ class Step:
                 and named steps must exist in the same context.
             prompt: Preamble text injected once when entering the gather step, giving
                 the model personality/context for why it is asking these questions
+            isolated: Default for every question in this gather. When True, a
+                question is asked with the sibling Q&A hidden from the model, so
+                it must ask rather than derive the answer from an earlier one.
+                A question's own ``isolated`` overrides this. The hidden turns
+                remain in the call log.
 
         Returns:
             Self for method chaining
         """
         self._gather_info = GatherInfo(
-            output_key=output_key, completion_action=completion_action, prompt=prompt
+            output_key=output_key,
+            completion_action=completion_action,
+            prompt=prompt,
+            isolated=isolated,
         )
         return self
 
@@ -379,6 +453,7 @@ class Step:
         confirm: bool = False,
         prompt: str | None = None,
         functions: list[str] | None = None,
+        isolated: bool | None = None,
     ) -> "Step":
         """
         Add a question to this step's gather_info configuration.
@@ -412,6 +487,10 @@ class Step:
             functions: Names of functions to unlock for this question only.
                 These are activated on top of `gather_submit`. All other step
                 functions remain locked out.
+            isolated: Override the gather's ``isolated`` default for this one
+                question. True hides the sibling Q&A while this question is
+                asked; False keeps it visible even in an isolated gather.
+                None (default) inherits the gather's setting.
 
         Returns:
             Self for method chaining.
@@ -425,6 +504,7 @@ class Step:
             confirm=confirm,
             prompt=prompt,
             functions=functions,
+            isolated=isolated,
         )
         return self
 
@@ -538,6 +618,9 @@ class Step:
         if self._skip_to_next_step:
             step_dict["skip_to_next_step"] = True
 
+        if self._history is not None:
+            step_dict["history"] = self._history
+
         # Add reset object if any reset parameters are set
         reset_obj: dict[str, Any] = {}
         if self._reset_system_prompt is not None:
@@ -618,6 +701,9 @@ class Context:
         self._enter_fillers: dict[str, list[str]] | None = None
         self._exit_fillers: dict[str, list[str]] | None = None
 
+        # Default visibility mode for the steps in this context
+        self._history: str | None = None
+
     def add_step(
         self,
         name: str,
@@ -846,6 +932,25 @@ class Context:
         self._user_prompt = user_prompt
         return self
 
+    def set_history(self, history: str) -> "Context":
+        """
+        Set the default visibility mode for every step in this context.
+
+        A step's own ``set_history()`` overrides this. See ``Step.set_history``
+        for what each mode does.
+
+        Args:
+            history: One of "keep", "default", or "hide".
+
+        Raises:
+            ValueError: if history is not one of the three modes.
+
+        Returns:
+            Self for method chaining
+        """
+        self._history = _validate_history(history)
+        return self
+
     def set_isolated(self, isolated: bool) -> "Context":
         """
         Mark this context as isolated — entering it wipes conversation history.
@@ -1127,6 +1232,9 @@ class Context:
         if self._exit_fillers is not None:
             context_dict["exit_fillers"] = self._exit_fillers
 
+        if self._history is not None:
+            context_dict["history"] = self._history
+
         return context_dict
 
 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/rest/client.py

@@ -32,7 +32,7 @@ class RestClient(_GeneratedResourceTree):
         # Use namespaced resources
         client.fabric.ai_agents.list()
         client.calling.play(call_id, play=[...])
-        client.phone_numbers.search(area_code="512")
+        client.phone_numbers.search(areacode="512")
         client.video.rooms.create(name="standup")
 
     The resource object tree (flat resources + namespace containers) is generated from

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/README.md

@@ -84,9 +84,9 @@ See LICENSE file in the project root for full license information.
 
 from typing import List, Dict, Any
 
-from signalwire_agents.core.skill_base import SkillBase
-from signalwire_agents.core.data_map import DataMap
-from signalwire_agents.core.function_result import SwaigFunctionResult
+from signalwire.core.skill_base import SkillBase
+from signalwire.core.data_map import DataMap
+from signalwire.core.function_result import SwaigFunctionResult
 
 
 class YourSkillClass(SkillBase):
@@ -243,7 +243,7 @@ pip install . --force-reinstall
 ### 2. Test Skill Discovery
 
 ```python
-from signalwire_agents.skills.registry import skill_registry
+from signalwire.skills.registry import skill_registry
 
 skill_registry.discover_skills()
 skills = skill_registry.list_skills()
@@ -254,8 +254,9 @@ for skill in skills:
 
 ### 3. Test Skill Usage
 
+<!-- snippet: no-run illustrative skill name a reader would provide (not a built-in skill) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class TestAgent(AgentBase):
     def __init__(self):
@@ -313,7 +314,7 @@ Detailed explanation of the skill's purpose and capabilities.
 ### Basic Usage
 
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class MyAgent(AgentBase):
     def __init__(self):
@@ -359,7 +360,7 @@ This demo shows how to use your skill with the SignalWire Agents SDK.
 Run with: python examples/your_skill_demo.py
 """
 
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class YourSkillAgent(AgentBase):
     def __init__(self):
@@ -449,4 +450,4 @@ if __name__ == "__main__":
 - Test API calls independently first
 - Use `.error_keys()` to handle API errors
 
-Remember to always test your skill thoroughly and provide clear documentation for other developers! 
+Remember to always test your skill thoroughly and provide clear documentation for other developers! 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/claude_skills/README.md

@@ -26,8 +26,9 @@ Use $ARGUMENTS for context passed to this skill.
 
 ## Usage
 
+<!-- snippet: no-run add_skill('claude_skills') sets up against a real ~/.claude/skills directory (external dependency, not present in CI) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 agent = AgentBase(name="my-agent")
 
@@ -438,8 +439,9 @@ Directory structure:
 ```
 
 Agent code:
+<!-- snippet: no-run starts a blocking server/client (covered by SNIPPET-COMPILE + EXAMPLES-RUN) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 agent = AgentBase(name="code-assistant")
 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/info_gatherer/README.md

@@ -21,7 +21,7 @@ Each question object:
 ## Single Instance Usage
 
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 agent = AgentBase(name="intake", route="/intake")
 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/joke/README.md

@@ -33,8 +33,9 @@ The Joke skill provides joke-telling capabilities to your SignalWire AI agents u
 
 ### Basic Usage
 
+<!-- snippet: no-run starts a blocking server/client (covered by SNIPPET-COMPILE + EXAMPLES-RUN) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class MyAgent(AgentBase):
     def __init__(self):
@@ -146,4 +147,4 @@ logging.basicConfig(level=logging.DEBUG)
     "joke": "Why don't scientists trust atoms? Because they make up everything!"
   }
 ]
-``` 
+``` 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/mcp_gateway/README.md

@@ -46,8 +46,9 @@ Either Basic Auth credentials OR Bearer token:
 
 ### Basic Usage (All Services)
 
+<!-- snippet: no-run starts a blocking server/client (covered by SNIPPET-COMPILE + EXAMPLES-RUN) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class MyAgent(AgentBase):
     def __init__(self):
@@ -229,4 +230,4 @@ python3 gateway_service.py -c myconfig.json
 2. Use strong authentication credentials
 3. Limit service access to required tools only
 4. Monitor gateway logs for suspicious activity
-5. Set appropriate session timeouts
+5. Set appropriate session timeouts

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/swml_transfer/README.md

@@ -58,8 +58,9 @@ Each entry in the `transfers` dictionary should have:
 
 ### Basic Usage
 
+<!-- snippet: no-run starts a blocking server/client (covered by SNIPPET-COMPILE + EXAMPLES-RUN) -->
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 class MyAgent(AgentBase):
     def __init__(self):
@@ -392,4 +393,4 @@ def configure_transfers(self, query_params, body_params, headers, agent):
             }
         }
     })
-```
+```

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire/skills/wikipedia_search/README.md

@@ -39,7 +39,7 @@ This skill creates one SWAIG tool:
 ### Basic Usage
 
 ```python
-from signalwire_agents import AgentBase
+from signalwire import AgentBase
 
 agent = AgentBase("Wikipedia Assistant")
 
@@ -225,4 +225,4 @@ Enable debug logging to see detailed API interactions and error information.
 - **datasphere**: For searching custom knowledge bases
 - **datetime**: For current date/time context in historical queries
 
-The Wikipedia skill is perfect for factual, encyclopedic information, while web search is better for current events and specific products/services. 
+The Wikipedia skill is perfect for factual, encyclopedic information, while web search is better for current events and specific products/services. 

{signalwire_sdk-3.0.2.dev74 → signalwire_sdk-3.0.2.dev77}/signalwire/signalwire_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.0.2.dev74
+Version: 3.0.2.dev77
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -247,7 +247,7 @@ client = RestClient(project="...", token="...", host="example.signalwire.com")
 
 client.fabric.ai_agents.create(name="Support Bot", prompt={"text": "You are helpful."})
 client.calling.play(call_id, play=[{"type": "tts", "text": "Hello!"}])
-client.phone_numbers.search(area_code="512")
+client.phone_numbers.search(areacode="512")
 client.datasphere.documents.search(query_string="billing policy")
 ```