griptape-nodes 0.36.2__tar.gz → 0.37.0__tar.gz

{griptape_nodes-0.36.2 → griptape_nodes-0.37.0}/.github/workflows/publish.yml

@@ -21,17 +21,16 @@ jobs:
       - name: uv Build
         run: uv build
       - name: uv Publish
-        run: uv publish --token ${{ secrets.PYPI_TOKEN }} 
-
+        run: uv publish --token ${{ secrets.PYPI_TOKEN }}
 
   push_to_registries:
-    name: Push Docker image to multiple registries
+    name: Push Docker images to multiple registries
     runs-on: ubuntu-latest
     permissions:
       packages: write
       contents: read
-      attestations: write
       id-token: write
+
     steps:
       - name: Check out the repo
         uses: actions/checkout@v4
@@ -42,7 +41,7 @@ jobs:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
-      - name: Log in to the Container registry
+      - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
         with:
           registry: ghcr.io
@@ -57,18 +56,50 @@ jobs:
             griptape/griptape-nodes
             ghcr.io/${{ github.repository }}
 
-      - name: Build and push Docker images
-        id: push
+      - name: Generate GPU tags
+        id: meta_gpu
+        run: |
+          # Read the comma‐separated list of CPU tags from metadata-action
+          CPU_TAGS="${{ steps.meta.outputs.tags }}"
+
+          # Split into array
+          IFS=',' read -r -a TAG_ARRAY <<< "$CPU_TAGS"
+
+          # Append "-gpu" to each tag name
+          GPU_TAGS=""
+          for full_ref in "${TAG_ARRAY[@]}"; do
+            # full_ref has form "repo:tag"
+            image_name="${full_ref%%:*}"
+            image_tag="${full_ref##*:}"
+            gpu_ref="${image_name}:${image_tag}-gpu"
+
+            if [ -z "$GPU_TAGS" ]; then
+              GPU_TAGS="$gpu_ref"
+            else
+              GPU_TAGS="$GPU_TAGS,$gpu_ref"
+            fi
+          done
+
+          echo "tags=$GPU_TAGS" >> $GITHUB_OUTPUT
+
+      - name: Build and push CPU image
+        id: push_cpu
         uses: docker/build-push-action@v6
         with:
           context: .
           push: true
+          build-args: |
+            BUILD_TYPE=cpu
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
 
-      - name: Generate artifact attestation
-        uses: actions/attest-build-provenance@v2
+      - name: Build and push GPU image
+        id: push_gpu
+        uses: docker/build-push-action@v6
         with:
-          subject-name: ghcr.io/${{ github.repository }}
-          subject-digest: ${{ steps.push.outputs.digest }}
-          push-to-registry: true
+          context: .
+          push: true
+          build-args: |
+            BUILD_TYPE=gpu
+          tags: ${{ steps.meta_gpu.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

{griptape_nodes-0.36.2 → griptape_nodes-0.37.0}/.gitignore

@@ -190,3 +190,4 @@ request_payload_schemas.json
 # JetBrains
 .idea/
 
+.vscode/settings.json

griptape_nodes-0.37.0/Dockerfile

@@ -0,0 +1,234 @@
+# Single Dockerfile for both CPU and GPU type builds.
+# Use --build-arg BUILD_TYPE=cpu (default) or BUILD_TYPE=gpu to switch modes.
+
+#────────────────────────────
+# 1) ARGs and base‐image definitions
+#────────────────────────────
+ARG BUILD_TYPE=cpu
+ARG BASE_IMAGE_CPU=ubuntu:22.04
+ARG BASE_IMAGE_GPU=nvidia/cuda:12.8.1-cudnn-runtime-ubuntu22.04
+
+#────────────────────────────
+# 2) Shared Python installation stage
+#────────────────────────────
+FROM ubuntu:22.04 AS python_base
+
+# Force noninteractive front‐end and set a dummy TZ so tzdata won't prompt
+ENV DEBIAN_FRONTEND=noninteractive
+ENV TZ=Etc/UTC
+
+# Install prerequisites and add Deadsnakes for Python 3.12
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+     software-properties-common \
+     wget \
+     tzdata \
+     gpg-agent \
+ && ln -fs /usr/share/zoneinfo/Etc/UTC /etc/localtime \
+ && dpkg-reconfigure -f noninteractive tzdata \
+ && wget -qO- https://keyserver.ubuntu.com/pks/lookup?op=get\&search=0xF23C5A6CF475977595C89F51BA6932366A755776 | gpg --dearmor > /etc/apt/trusted.gpg.d/deadsnakes.gpg \
+ && echo "deb https://ppa.launchpadcontent.net/deadsnakes/ppa/ubuntu jammy main" > /etc/apt/sources.list.d/deadsnakes-ppa.list \
+ && apt-get update \
+ && apt-get install -y --no-install-recommends \
+     git \
+     build-essential \
+     pkg-config \
+     cmake \
+     libprotobuf-dev \
+     protobuf-compiler \
+     python3.12 \
+     python3.12-dev \
+     python3.12-venv \
+ && rm -rf /var/lib/apt/lists/* \
+ && pkg-config --version \
+ && cmake --version
+
+#────────────────────────────
+# 3) CPU builder stage
+#────────────────────────────
+FROM python_base AS builder_cpu
+
+# Bring in uv/uvx binaries from the official Astral SH image
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+WORKDIR /app
+
+# Set virtual environment location outside of /app to avoid mount conflicts
+ENV UV_PROJECT_ENVIRONMENT=/opt/venv
+
+# Install dependencies (without yet installing the project itself)
+#     - Use BuildKit cache mounts for pip/uv caches
+ENV UV_LINK_MODE=copy
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_PYTHON_DOWNLOADS=never
+ENV UV_PYTHON=/usr/bin/python3.12
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-editable
+
+# Copy everything needed for the actual project sync
+COPY pyproject.toml pyproject.toml
+COPY uv.lock uv.lock
+COPY README.md README.md
+COPY src src
+COPY libraries libraries
+
+# Install the project (puts it into a venv at /opt/venv)
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-editable
+
+
+#────────────────────────────
+# 4) GPU builder stage
+#────────────────────────────
+FROM ${BASE_IMAGE_GPU} AS builder_gpu
+
+# Force noninteractive front‐end and set a dummy TZ so tzdata won’t prompt
+# Bring in uv/uvx binaries from the official Astral SH image
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+ENV DEBIAN_FRONTEND=noninteractive
+ENV TZ=Etc/UTC
+
+# Install prerequisites and add Deadsnakes for Python 3.12
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+      software-properties-common \
+      wget \
+      tzdata \
+ && ln -fs /usr/share/zoneinfo/Etc/UTC /etc/localtime \
+ && dpkg-reconfigure -f noninteractive tzdata \
+ && add-apt-repository ppa:deadsnakes/ppa \
+ && apt-get update \
+ && apt-get install -y --no-install-recommends \
+      git \
+      ffmpeg libgl1 \
+      libjpeg-dev zlib1g-dev libpng-dev libwebp-dev \
+      build-essential \
+      pkg-config \
+      cmake \
+      libprotobuf-dev \
+      protobuf-compiler \
+      python3.12 \
+      python3.12-dev \
+      python3.12-venv \
+ && rm -rf /var/lib/apt/lists/* \
+ && pkg-config --version \
+ && cmake --version
+
+WORKDIR /app
+
+# Set virtual environment location outside of /app to avoid mount conflicts
+ENV UV_PROJECT_ENVIRONMENT=/opt/venv
+
+# Install dependencies (without yet installing the project itself)
+#     - Use BuildKit cache mounts for pip/uv caches
+ENV UV_LINK_MODE=copy
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_PYTHON_DOWNLOADS=never
+ENV UV_PYTHON=/usr/bin/python3.12
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-editable
+
+# Copy everything needed for the actual project sync
+COPY pyproject.toml pyproject.toml
+COPY uv.lock uv.lock
+COPY README.md README.md
+COPY src src
+COPY libraries libraries
+
+# Install the project (puts it into a venv at /opt/venv)
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-editable
+
+
+#────────────────────────────
+# 5) "builder" alias: pick CPU or GPU builder based on BUILD_TYPE
+#────────────────────────────
+FROM builder_${BUILD_TYPE} AS builder
+
+
+#────────────────────────────
+# 6) CPU runtime stage
+#────────────────────────────
+FROM python_base AS runtime_cpu
+
+# Install additional runtime libraries for CPU
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+     libgl1-mesa-glx \
+     libglib2.0-0 \
+ && rm -rf /var/lib/apt/lists/* \
+ && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 \
+ && update-alternatives --install /usr/bin/python python /usr/bin/python3.12 1
+
+WORKDIR /app
+
+
+#────────────────────────────
+# 7) GPU runtime stage
+#────────────────────────────
+FROM ${BASE_IMAGE_GPU} AS runtime_gpu
+
+# Install additional libraries needed at runtime for GPU
+ENV DEBIAN_FRONTEND=noninteractive
+ENV TZ=Etc/UTC
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+      software-properties-common \
+      tzdata \
+ && ln -fs /usr/share/zoneinfo/Etc/UTC /etc/localtime \
+ && dpkg-reconfigure -f noninteractive tzdata \
+ && add-apt-repository ppa:deadsnakes/ppa \
+ && apt-get update \
+ && apt-get install -y --no-install-recommends \
+      git ffmpeg libgl1 \
+      libjpeg-dev zlib1g-dev libpng-dev libwebp-dev \
+      build-essential pkg-config cmake libprotobuf-dev protobuf-compiler \
+      python3.12 python3.12-dev python3.12-venv \
+ && rm -rf /var/lib/apt/lists/* \
+ && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 \
+ && update-alternatives --install /usr/bin/python python /usr/bin/python3.12 1
+
+WORKDIR /app
+
+
+#────────────────────────────
+# 8) Final stage: pick runtime_${BUILD_TYPE}, then add user / copy venv / entrypoint
+#────────────────────────────
+ARG BUILD_TYPE
+FROM runtime_${BUILD_TYPE} AS final
+
+# Create a non-root user and prepare /app/models
+RUN groupadd --gid 1000 appuser \
+ && useradd --uid 1000 --gid appuser --shell /bin/bash --create-home appuser 
+
+# Create app directory structure and set permissions for volume mount points
+RUN mkdir -p /app /opt/venv && \
+    chown -R appuser:appuser /app /opt/venv
+
+# Copy the venv from the chosen builder into /opt/venv, preserving ownership
+COPY --from=builder --chown=appuser:appuser /opt/venv /opt/venv
+
+LABEL org.opencontainers.image.source="https://github.com/griptape-ai/griptape-nodes"
+LABEL org.opencontainers.image.description="Griptape Nodes."
+LABEL org.opencontainers.image.licenses="Apache-2.0"
+
+#  Copy entrypoint and make sure it’s executable
+COPY --chown=appuser:appuser entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+#  Switch to non-root user and set working directory
+USER appuser
+WORKDIR /app
+
+# Ensure XDG directories and Python user base point to the user's home
+ENV HOME=/app
+
+EXPOSE 8124
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["/opt/venv/bin/griptape-nodes", "--no-update"]

{griptape_nodes-0.36.2 → griptape_nodes-0.37.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: griptape-nodes
-Version: 0.36.2
+Version: 0.37.0
 Summary: Add your description here
 License-File: LICENSE
 Requires-Python: ~=3.12
 Requires-Dist: fastapi>=0.115.12
-Requires-Dist: griptape[drivers-prompt-amazon-bedrock,drivers-prompt-anthropic,drivers-prompt-cohere,drivers-prompt-ollama,drivers-web-scraper-trafilatura,drivers-web-search-duckduckgo,loaders-image]>=1.7.1
+Requires-Dist: griptape[drivers-prompt-amazon-bedrock,drivers-prompt-anthropic,drivers-prompt-cohere,drivers-prompt-ollama,drivers-web-scraper-trafilatura,drivers-web-search-duckduckgo,drivers-web-search-exa,loaders-image]>=1.7.1
 Requires-Dist: httpx<1.0.0,>=0.28.0
+Requires-Dist: json-repair>=0.46.1
 Requires-Dist: packaging>=25.0
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.0.1

griptape_nodes-0.37.0/docs/nodes/text/date_and_time.md

@@ -0,0 +1,43 @@
+# Date and Time
+
+## What is it?
+
+The Date and Time tool is a utility that helps you format and manipulate date and time information as text.
+
+## When would I use it?
+
+Use this node when you want to:
+
+- Format dates and times in specific text formats
+- Convert between different date/time formats
+- Generate date/time strings for use in text
+- Create time-based text content
+
+## How to use it
+
+### Basic Setup
+
+1. Add the Date and Time tool to your workflow
+1. Configure the date/time parameters
+1. Connect its output to nodes that need formatted date/time text
+
+### Parameters
+
+- **prompt**: The thing you'd like to get the date for (e.g. "Christmas, 2027", "Next friday")
+- **format**: The format for the date/time (e.g., "%Y-%m-%d %H:%M:%S", "Fri 25, March, 9pm")
+
+### Outputs
+
+- **output**: The formatted date/time as text
+
+## Example
+
+Imagine you want to format a date in a specific way:
+
+1. Add a Date and Time tool to your workflow
+1. Set the desired date format
+1. Connect the "output" to another node that needs the formatted date/time
+
+## Implementation Details
+
+The Date and Time tool provides flexible date and time formatting capabilities. It supports various format strings and timezone handling to generate properly formatted date/time text.

griptape_nodes-0.37.0/docs/nodes/text/evaluate_text_result.md

@@ -0,0 +1,80 @@
+# Evaluate Text Result
+
+The Evaluate Text Result node allows you to evaluate text outputs against specific criteria using Griptape's Eval Engine. This node is useful for validating AI-generated content, checking factual accuracy, or assessing the quality of text outputs.
+
+## Inputs
+
+- **Examples** (Property): Choose from preset examples or create your own evaluation
+
+    - Options:
+
+        - Choose a preset..
+        - Paraphrase
+        - Factual
+        - Analogy
+
+- **Input** (Input/Property): The input text to be evaluated
+
+    - Supports multiline text input
+
+- **Expected Output** (Input/Property): The expected or reference output text
+
+    - Single line text input
+
+- **Actual Output** (Input/Property): The actual output text to be evaluated
+
+    - Single line text input
+
+- **Criteria** (Input/Property): The evaluation criteria to use
+
+    - Supports multiline text input
+    - Example: "Does the output accurately paraphrase the input without losing meaning?"
+
+## Outputs
+
+- **Score** (Output): A float value between 0 and 1 representing the evaluation score
+
+    - 1.0 indicates perfect match
+    - 0.0 indicates complete mismatch
+
+- **Reason** (Output): A detailed explanation of the evaluation result
+
+    - Provides feedback on why the score was given
+    - Explains any discrepancies found
+
+## Example Usage
+
+### Paraphrase Evaluation
+
+```python
+Input: "The quick brown fox jumps over the lazy dog."
+Expected Output: "A swift brown fox leaps above a sleeping dog."
+Actual Output: "A fast fox jumps over a dog that's not awake."
+Criteria: "Does the output accurately paraphrase the input without losing meaning?"
+```
+
+### Factual Evaluation
+
+```python
+Input: "The capital of France is Paris."
+Expected Output: "Paris is the capital city of France."
+Actual Output: "France's capital is Paris."
+Criteria: "Is the output factually correct based on the input?"
+```
+
+### Analogy Evaluation
+
+```python
+Input: "A bird is to sky as a fish is to ______."
+Expected Output: "water"
+Actual Output: "concrete"
+Criteria: "Does the output correctly complete the analogy?"
+```
+
+## Notes
+
+- The node uses Griptape's Eval Engine to perform the evaluation
+- The evaluation is based on the provided criteria
+- The score is normalized between 0 and 1
+- The reason provides detailed feedback about the evaluation
+- You can use preset examples or create your own custom evaluations

griptape_nodes-0.37.0/docs/nodes/text/scrape_web.md

@@ -0,0 +1,42 @@
+# Scrape Web
+
+## What is it?
+
+The Scrape Web tool is a utility that allows you to extract text content from web pages.
+
+## When would I use it?
+
+Use this node when you want to:
+
+- Extract text content from specific web pages
+- Gather information from websites
+- Collect data from online sources
+- Automate web content extraction
+
+## How to use it
+
+### Basic Setup
+
+1. Add the Scrape Web tool to your workflow
+1. Configure the scraping parameters
+1. Connect its output to nodes that need the scraped content
+
+### Parameters
+
+- **url**: The URL of the web page to scrape
+
+### Outputs
+
+- **output**: The text content extracted from the web page
+
+## Example
+
+Imagine you want to extract content from a specific web page:
+
+1. Add a Scrape Web tool to your workflow
+1. Set the URL of the page you want to scrape
+1. Connect the "output" to another node that needs the scraped content
+
+## Implementation Details
+
+The Scrape Web tool uses web scraping capabilities to extract text content from web pages. It can target specific content using CSS selectors and handles timeouts and errors gracefully.

griptape_nodes-0.37.0/docs/nodes/text/search_web.md

@@ -0,0 +1,44 @@
+# Search Web
+
+## What is it?
+
+The Search Web tool is a utility that allows you to search the web and retrieve text content from search results.
+
+## When would I use it?
+
+Use this node when you want to:
+
+- Search the web for specific information
+- Retrieve text content from search results
+- Gather information from multiple web sources
+- Research topics online
+
+## How to use it
+
+### Basic Setup
+
+1. Add the Search Web tool to your workflow
+1. Connect its output to nodes that need web search results
+
+### Parameters
+
+- **prompt**: The search query to use
+- **summarize**: Whether or not you want an LLM to summarize the text
+- **search_engine**: The search engine to use. Note: some engines require an API key.
+
+### Outputs
+
+- **output**: The text content retrieved from the search results
+
+## Example
+
+Imagine you want to search for information about a specific topic:
+
+1. Add a Search Web tool to your workflow
+1. Set the search query
+1. Connect the "output to another node that needs the search results
+1. The tool will return the text content from the search results
+
+## Implementation Details
+
+The Search Web tool uses web search capabilities to find relevant information and extracts text content from the search results. It's designed to help you gather information from the web in a structured way.

griptape_nodes-0.37.0/docs/nodes/text/summarize_text.md

@@ -0,0 +1,42 @@
+# Summarize Text
+
+## What is it?
+
+The Summarize Text Task tool is a utility that summarizes text for you.
+
+## When would I use it?
+
+Use this node when you want to:
+
+- Create tasks for summarizing text content
+- Define summarization requirements and parameters
+- Set up structured summarization workflows
+- Manage text summarization processes
+
+## How to use it
+
+### Basic Setup
+
+1. Add the Summarize Text Task tool to your workflow
+1. Configure the summarization parameters
+1. Connect its output to nodes that need summarization tasks
+
+### Parameters
+
+- **text**: The text content to be summarized
+
+### Outputs
+
+- **output**: The summary of the text
+
+## Example
+
+Imagine you want to create a summarization task for a long text:
+
+1. Add a Summarize Text Task tool to your workflow
+1. Connect the text input to your source text
+1. Connect the "output" to a node that can process the summarization task
+
+## Implementation Details
+
+The Summarize Text Task tool helps you summarize long amonts of text.

{griptape_nodes-0.36.2 → griptape_nodes-0.37.0}/docs/nodes/tools/calculator_tool.md

@@ -2,7 +2,7 @@
 
 ## What is it?
 
-The Calculator tool is a calculator. A calculator you give an agent. So the agent can do math.
+The Calculator tool is a mathematical calculation tool that can be given to an agent to help it perform precise calculations.
 
 ## When would I use it?
 
@@ -19,10 +19,6 @@ Use this node when you want to:
 1. Add the Calculator to your workflow
 1. Connect its output to nodes that need calculation capabilities (like an Agent)
 
-### Parameters
-
-- **off_prompt**: Whether to run calculations outside the main prompt (default is true)
-
 ### Outputs
 
 - **tool**: The configured calculator tool that other nodes can use
@@ -34,3 +30,7 @@ Imagine you want to create an agent that can perform calculations:
 1. Add a Calculator to your workflow
 1. Connect the "tool" output to an Agent's "tools" input
 1. Now that agent can perform calculations when needed in conversations
+
+## Implementation Details
+
+The Calculator tool is implemented using Griptape's `CalculatorTool` class and provides a simple interface for performing mathematical calculations. The tool is designed to be used by agents to handle numerical operations accurately and efficiently.

griptape_nodes-0.37.0/docs/nodes/tools/date_time_tool.md

@@ -0,0 +1,37 @@
+# Date Time
+
+## What is it?
+
+The Date Time tool is a utility that can be given to an agent to help it perform date and time operations.
+
+## When would I use it?
+
+Use this node when you want to:
+
+- Enable agents to work with dates and times
+- Perform date/time calculations and manipulations
+- Get current time information
+- Format dates and times in different ways
+
+## How to use it
+
+### Basic Setup
+
+1. Add the Date Time tool to your workflow
+1. Connect its output to nodes that need date/time capabilities (like an Agent)
+
+### Outputs
+
+- **tool**: The configured date time tool that other nodes can use
+
+## Example
+
+Imagine you want to create an agent that can work with dates and times:
+
+1. Add a Date Time tool to your workflow
+1. Connect the "tool" output to an Agent's "tools" input
+1. Now that agent can perform date and time operations when needed in conversations
+
+## Implementation Details
+
+The Date Time tool is implemented using Griptape's `DateTimeTool` class and provides a comprehensive interface for handling date and time operations. The tool is designed to be used by agents to manage temporal data and perform time-based calculations.