README

JigsawStack tools for the Laravel AI SDK - sentiment, summary, embedding, translation, web search, scraping, vision, audio, and validation

Part of the shipfastlabs/toolkit catalog of reusable AI tools for the Laravel AI SDK.

Installation

composer require shipfastlabs/toolkit-jigsawstack

Usage

Register every JigsawStack tool at once with the JigsawStack helper:

use Shipfastlabs\Toolkit\JigsawStack\JigsawStack;

$tools = JigsawStack::all(); // Collection<int, Tool>

Or add individual tools to an agent's tools():

use Shipfastlabs\Toolkit\JigsawStack\JigsawStackWebSearch;
use Shipfastlabs\Toolkit\JigsawStack\JigsawStackSummary;

$tools = [
    new JigsawStackWebSearch,
    new JigsawStackSummary,
];

Tools

Each tool maps to a JigsawStack endpoint and returns the raw JSON response (pretty-printed) so the model can read every field.

General

Translation

Web

Vision

Audio

Validation

Configuration

Every tool reads its API key from Laravel's services config.

1. Add the JigsawStack service to config/services.php

// config/services.php

return [

    // ... existing services ...

    'jigsawstack' => [
        'key' => env('JIGSAWSTACK_API_KEY'),
    ],

];

2. Add the environment variable to .env

JIGSAWSTACK_API_KEY=your-key-here

Safety

• All tools validate required inputs before calling the API.
• Requests time out after 60 seconds.
• API errors and network failures are caught and returned as friendly string messages so the model can recover.
• Requires a valid JigsawStack API key; tools return a clear "not configured" message when it is missing.

JigsawStack API

These tools use the JigsawStack API. See the API reference for full details on each endpoint and its response shape.