qtype 0.1.12__py3-none-any.whl → 0.1.13__py3-none-any.whl

qtype/examples/data_processing/sample_article.txt

@@ -0,0 +1 @@
+Artificial intelligence is revolutionizing healthcare by enabling faster diagnoses and personalized treatment plans. Machine learning algorithms can analyze medical images with incredible accuracy, helping doctors detect diseases earlier. This technology is improving patient outcomes and reducing healthcare costs.

qtype/examples/data_processing/sample_documents.jsonl

@@ -0,0 +1,5 @@
+{"document": "The new quantum computing breakthrough could revolutionize AI processing speeds."}
+{"document": "Federal Reserve announces interest rate changes to combat inflation."}
+{"document": "New clinical trial shows promising results for cancer treatment."}
+{"document": "University expands online learning programs for remote students."}
+{"document": "Cryptocurrency markets experience volatility amid regulatory concerns."}

qtype/examples/language_features/optional_variables.qtype.yaml

@@ -0,0 +1,32 @@
+id: optional_variables_demo
+description: Demonstrates optional variables that can handle missing data gracefully
+
+flows:
+  - id: extract_optional_field
+    variables:
+      - id: user_profile
+        type: text
+      - id: email
+        type: text?
+
+    inputs:
+      - user_profile
+    outputs:
+      - email
+
+    steps:
+      # Try to extract email - may not exist, will return None if missing
+      - type: FieldExtractor
+        id: extract_email
+        inputs:
+          - user_profile
+        outputs:
+          - email
+        json_path: $.email
+
+      - type: Echo
+        id: show_result
+        inputs:
+          - email
+        outputs:
+          - email

qtype/examples/language_features/story_prompt.txt

@@ -0,0 +1,6 @@
+You are a creative storyteller. Write a short, engaging story based on the following theme:
+
+Theme: {theme}
+Tone: {tone}
+
+Create a story that is 3-4 paragraphs long. Make it captivating and appropriate for the specified tone.

qtype/examples/legacy/data/customers.csv

@@ -0,0 +1,6 @@
+name,region,purchases
+Alice,West,5
+Bob,East,3
+Charlie,West,7
+Diana,North,2
+Eve,East,4

qtype/examples/legacy/echo/readme.md

@@ -0,0 +1,29 @@
+# Echo Examples
+
+These examples are intended to be for testing purposes or early stage development. Output will be a replicate of the input.
+
+**Primitive types**
+```
+class PrimitiveTypeEnum(str, Enum):
+    """Represents the type of data a user or system input can accept within the DSL."""
+
+    audio = "audio"
+    boolean = "boolean"
+    bytes = "bytes"
+    citation_document = "citation_document"
+    citation_url = "citation_url"
+    date = "date"
+    datetime = "datetime"
+    int = "int"
+    file = "file"
+    float = "float"
+    image = "image"
+    text = "text"
+    time = "time"
+    video = "video"
+    thinking = "thinking"
+```
+To test out a primitive type:
+
+- Duplicate `examples/echo/video.qtype.yaml`
+- Replace all mentions of video with the primitive type you wish to test

qtype/examples/legacy/qtype_plugin_example.py

@@ -0,0 +1,51 @@
+"""
+Example QType CLI plugin.
+
+This demonstrates how to create a third-party plugin for the QType CLI.
+To use this as a plugin, you would:
+
+1. Put this code in a separate package
+2. Add an entry point in pyproject.toml:
+   [project.entry-points."qtype.commands"]
+   example = "your_package.qtype_example:parser"
+3. Install the package
+"""
+
+import argparse
+
+
+def parser(subparsers: argparse._SubParsersAction) -> None:
+    """Register the 'example' subcommand.
+
+    Args:
+        subparsers: The subparsers object to add the command to.
+    """
+    example_parser = subparsers.add_parser(
+        "example", help="Example plugin command for QType CLI"
+    )
+    example_parser.add_argument(
+        "--message",
+        default="Hello from QType plugin!",
+        help="Message to display (default: Hello from QType plugin!)",
+    )
+    example_parser.add_argument(
+        "--count",
+        type=int,
+        default=1,
+        help="Number of times to display the message (default: 1)",
+    )
+    # Set the function to call when this command is invoked
+    example_parser.set_defaults(func=example_command)
+
+
+def example_command(args: argparse.Namespace) -> None:
+    """Handle the 'example' subcommand.
+
+    Args:
+        args: Command-line arguments containing message and count.
+    """
+    for i in range(args.count):
+        print(f"{i + 1}: {args.message}")
+
+    print("\nThis command was loaded as a plugin!")
+    print("Plugin authors can extend QType CLI functionality this way.")

qtype/examples/legacy/sample_data.txt

@@ -0,0 +1,43 @@
+Sales Data Q1 2024
+==================
+
+Summary Statistics:
+- Total Records: 1,472 transactions
+- Date Range: January 1 - March 31, 2024
+- Products: A, B, C, D
+- Regions: North, South, East, West
+
+Top Performing Products:
+1. Product A: $1,245,890 total sales (avg $847/transaction)
+2. Product C: $1,123,450 total sales (avg $763/transaction)
+3. Product B: $987,230 total sales (avg $671/transaction)
+4. Product D: $856,340 total sales (avg $582/transaction)
+
+Regional Breakdown:
+- North Region: $1,089,450 (26.3% of total)
+- South Region: $1,045,230 (25.2% of total)
+- East Region: $1,012,890 (24.4% of total)
+- West Region: $1,001,340 (24.1% of total)
+
+Key Trends:
+- Product A shows consistent growth throughout Q1 (+15% month-over-month)
+- West region had strongest growth rate despite lower absolute numbers
+- Discount rates ranged from 0% to 20%, with 10% being most common
+- Average transaction size increased 8% from Jan to March
+- Customer count per transaction averaging 25 customers
+
+Notable Patterns:
+- Weekday sales 23% higher than weekend sales
+- Product D underperforming in South region specifically
+- Strong correlation between discount rate and quantity sold
+- North region showing premium pricing power (higher avg transaction)
+
+Concerns:
+- Product D sales declining 5% month-over-month
+- South region discount rates higher than other regions
+- Customer acquisition costs need monitoring
+
+Opportunities:
+- West region expansion showing strong ROI
+- Product A momentum could be leveraged for upselling
+- Cross-regional best practices could improve South region performance

qtype/examples/legacy/vertex/README.md

@@ -0,0 +1,11 @@
+To use a Vertex example, set the following environment variables manually:
+```
+export GOOGLE_CLOUD_PROJECT=
+export GOOGLE_CLOUD_LOCATION=
+export GOOGLE_APPLICATION_CREDENTIALS=
+```
+
+Using gcloud CLI:
+How to setup [Gemini CLI Authentication Setup](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.md)
+
+`profile_name`: Replace default with relevant GCP project name in `.config/gcloud/configurations/your-project-configuration-file`

qtype/examples/research_assistant/tavily.qtype.yaml

@@ -0,0 +1,216 @@
+auths:
+- id: tavily-api_bearerauth_token
+  token: ${TAVILY-API_BEARER}
+  type: bearer_token
+description: Tools created from API specification 
+  examples/research_assistant/tavily.oas.yaml
+flows: []
+id: tavily-api
+indexes: []
+memories: []
+models: []
+references: []
+tools:
+- auth: tavily-api_bearerauth_token
+  description: 'Perform a web search with various filtering and customization options.
+    Returns search results with content, URLs, scores, and optional answers. '
+  endpoint: https://api.tavily.com/search
+  headers: {}
+  id: search
+  inputs:
+  - id: query
+    type: text
+  - id: search_depth
+    type: text?
+  - id: topic
+    type: text?
+  - id: time_range
+    type: text?
+  - id: start_date
+    type: text?
+  - id: end_date
+    type: text?
+  - id: days
+    type: int?
+  - id: max_results
+    type: int?
+  - id: include_domains
+    type: list[text]?
+  - id: exclude_domains
+    type: list[text]?
+  - id: include_answer
+    type: text?
+  - id: include_raw_content
+    type: text?
+  - id: include_images
+    type: boolean?
+  - id: country
+    type: text?
+  - id: auto_parameters
+    type: boolean?
+  - id: include_favicon
+    type: boolean?
+  method: POST
+  name: Search the web
+  outputs:
+  - id: query
+    type: text?
+  - id: follow_up_questions
+    type: list[text]?
+  - id: answer
+    type: text?
+  - id: images
+    type: list[schema_4849029360]?
+  - id: results
+    type: list[schema_4849029792]?
+  - id: response_time
+    type: float?
+  parameters: []
+  type: APITool
+- auth: tavily-api_bearerauth_token
+  description: 'Extract and process content from one or more URLs with various formatting
+    options. Returns extracted content in text or markdown format. '
+  endpoint: https://api.tavily.com/extract
+  headers: {}
+  id: extract
+  inputs:
+  - id: urls
+    type: list[text]
+  - id: include_images
+    type: boolean?
+  - id: extract_depth
+    type: text?
+  - id: format
+    type: text?
+  - id: include_favicon
+    type: boolean?
+  method: POST
+  name: Extract content from URLs
+  outputs:
+  - id: results
+    type: list[schema_4849038576]?
+  - id: failed_results
+    type: list[schema_4849041168]?
+  parameters: []
+  type: APITool
+- auth: tavily-api_bearerauth_token
+  description: 'Crawl a website starting from a given URL with depth and breadth controls.
+    Extract content from discovered pages with various filtering options. '
+  endpoint: https://api.tavily.com/crawl
+  headers: {}
+  id: crawl
+  inputs:
+  - id: url
+    type: text
+  - id: max_depth
+    type: int?
+  - id: max_breadth
+    type: int?
+  - id: limit
+    type: int?
+  - id: instructions
+    type: text?
+  - id: select_paths
+    type: list[text]?
+  - id: select_domains
+    type: list[text]?
+  - id: exclude_paths
+    type: list[text]?
+  - id: exclude_domains
+    type: list[text]?
+  - id: allow_external
+    type: boolean?
+  - id: include_images
+    type: boolean?
+  - id: extract_depth
+    type: text?
+  - id: format
+    type: text?
+  - id: include_favicon
+    type: boolean?
+  method: POST
+  name: Crawl websites
+  outputs:
+  - id: results
+    type: list[schema_4849520304]?
+  parameters: []
+  type: APITool
+- auth: tavily-api_bearerauth_token
+  description: "Map the structure and links of a website starting from a given URL.
+    Discover the website's architecture and page hierarchy. "
+  endpoint: https://api.tavily.com/map
+  headers: {}
+  id: map
+  inputs:
+  - id: url
+    type: text
+  - id: max_depth
+    type: int?
+  - id: max_breadth
+    type: int?
+  - id: limit
+    type: int?
+  - id: instructions
+    type: text?
+  - id: select_paths
+    type: list[text]?
+  - id: select_domains
+    type: list[text]?
+  - id: exclude_paths
+    type: list[text]?
+  - id: exclude_domains
+    type: list[text]?
+  - id: allow_external
+    type: boolean?
+  - id: include_images
+    type: boolean?
+  method: POST
+  name: Map website structure
+  outputs:
+  - id: results
+    type: list[schema_4849527888]?
+  parameters: []
+  type: APITool
+types:
+- description: Generated from OpenAPI schema
+  id: schema_4849029360
+  properties:
+    alt_text: text?
+    title: text?
+    url: text?
+- description: Generated from OpenAPI schema
+  id: schema_4849029792
+  properties:
+    content: text?
+    favicon: text?
+    raw_content: text?
+    score: float?
+    title: text?
+    url: text?
+- description: Generated from OpenAPI schema
+  id: schema_4849038576
+  properties:
+    content: text?
+    favicon: text?
+    title: text?
+    url: text?
+- description: Generated from OpenAPI schema
+  id: schema_4849041168
+  properties:
+    error: text?
+    url: text?
+- description: Generated from OpenAPI schema
+  id: schema_4849520304
+  properties:
+    content: text?
+    favicon: text?
+    links: list[text]?
+    title: text?
+    url: text?
+- description: Generated from OpenAPI schema
+  id: schema_4849527888
+  properties:
+    depth: int?
+    links: list[text]?
+    title: text?
+    url: text?

{examples → qtype/examples}/tutorials/03_structured_data.qtype.yaml

@@ -9,7 +9,7 @@
 # Scenario: Analyze a product review to extract structured sentiment
 #
 # Run with:
-#   uv run run -i '{"review_text":"These headphones are amazing! Great sound quality and super comfortable. Battery lasts all day."}' examples/tutorials/03_structured_data.qtype.yaml 
+#   qtype run -i '{"review_text":"These headphones are amazing! Great sound quality and super comfortable. Battery lasts all day."}' examples/tutorials/03_structured_data.qtype.yaml 
 
 id: review_sentiment_analyzer
 description: |
@@ -116,7 +116,7 @@ flows:
       # Construct builds typed objects from the decoded fields
       - id: build_result
         type: Construct
-        field_mapping:
+        field_bindings:
           sentiment: sentiment
           confidence: confidence
           key_points: key_points

{examples → qtype/examples}/tutorials/04_tools_and_function_calling.qtype.yaml

@@ -8,7 +8,7 @@
 # Scenario: Calculate a deadline by adding days to the current time
 #
 # Run with:
-#   uv run qtype run -i '{"days_until_due": 3}' examples/tutorials/04_tools_and_function_calling.qtype.yaml
+#   qtype run -i '{"days_until_due": 3}' examples/tutorials/04_tools_and_function_calling.qtype.yaml
 
 id: deadline_calculator
 description: |
@@ -17,7 +17,7 @@ description: |
 
 # Import pre-built tools from the commons library
 references:
-  - !include https://raw.githubusercontent.com/bazaarvoice/qtype/refs/tags/v0.1.11/common/tools.qtype.yaml
+  - !include ../../common/tools.qtype.yaml
 
 flows:
   - id: calculate_deadline
@@ -50,7 +50,7 @@ flows:
         tool: qtype.application.commons.tools.get_current_timestamp
         input_bindings: {}
         output_bindings:
-          result: current_time
+          get_current_timestamp_result: current_time
         outputs:
           - current_time
 
@@ -71,7 +71,7 @@ flows:
           timestamp: current_time
           days: days_until_due
         output_bindings:
-          result: deadline_time
+          timedelta_result: deadline_time
         outputs:
           - deadline_time
 
@@ -84,6 +84,6 @@ flows:
           timestamp: deadline_time
           format_string: format_string
         output_bindings:
-          result: deadline_formatted
+          format_datetime_result: deadline_formatted
         outputs:
           - deadline_formatted

qtype/interpreter/base/stream_emitter.py

@@ -121,15 +121,15 @@ class ReasoningStreamContext:
     """
     Async context manager for reasoning streaming.
 
-    Automatically emits ReasoningStreamStartEvent on entry and
-    ReasoningStreamEndEvent on exit. Provides delta() method for emitting
-    reasoning chunks.
+    Only emits ReasoningStreamStartEvent on the first delta() call, and only
+    emits ReasoningStreamEndEvent if start was sent. This prevents empty
+    reasoning streams when models don't provide reasoning data.
 
     Example:
         ```python
         async with emitter.reasoning_stream("agent-reasoning") as streamer:
             async for chunk in agent.stream_reasoning():
-                await streamer.delta(chunk.text)
+                await streamer.delta(chunk.text)  # Start event on first call
         ```
     """
 
@@ -142,15 +142,10 @@ class ReasoningStreamContext:
         self.step = step
         self.stream_id = stream_id
         self.on_stream_event = on_stream_event
+        self._started = False
 
     async def __aenter__(self) -> ReasoningStreamContext:
-        """Emit ReasoningStreamStartEvent when entering context."""
-        if self.on_stream_event:
-            await self.on_stream_event(
-                ReasoningStreamStartEvent(
-                    step=self.step, stream_id=self.stream_id
-                )
-            )
+        """Enter context without emitting start event."""
         return self
 
     async def __aexit__(
@@ -159,8 +154,8 @@ class ReasoningStreamContext:
         exc_val: BaseException | None,
         exc_tb: Any,
     ) -> bool:
-        """Emit ReasoningStreamEndEvent when exiting context."""
-        if self.on_stream_event:
+        """Emit ReasoningStreamEndEvent only if stream was started."""
+        if self._started and self.on_stream_event:
             await self.on_stream_event(
                 ReasoningStreamEndEvent(
                     step=self.step, stream_id=self.stream_id
@@ -172,10 +167,21 @@ class ReasoningStreamContext:
         """
         Emit a reasoning delta chunk.
 
+        Sends ReasoningStreamStartEvent on first call, then delta events.
+
         Args:
             text: The incremental reasoning content to append to the stream
         """
         if self.on_stream_event:
+            # Emit start event on first delta
+            if not self._started:
+                await self.on_stream_event(
+                    ReasoningStreamStartEvent(
+                        step=self.step, stream_id=self.stream_id
+                    )
+                )
+                self._started = True
+
             await self.on_stream_event(
                 ReasoningStreamDeltaEvent(
                     step=self.step,