File Coverage

blib/lib/SignalWire/Agents/Skills/Builtin/Joke.pm

Criterion	Covered	Total	%
statement	23	23	100.0
branch			n/a
condition	4	4	100.0
subroutine	10	10	100.0
pod	0	4	0.0
total	37	41	90.2

package SignalWire::Agents::Skills::Builtin::Joke;
use strict;
use warnings;
use Moo;
use JSON ();
extends 'SignalWire::Agents::Skills::SkillBase';

use SignalWire::Agents::Skills::SkillRegistry;
SignalWire::Agents::Skills::SkillRegistry->register_skill('joke', __PACKAGE__);

has '+skill_name'        => (default => sub { 'joke' });
has '+skill_description' => (default => sub { 'Tell jokes using the API Ninjas joke API' });
has '+supports_multiple_instances' => (default => sub { 0 });

sub setup { 1 }

sub register_tools {
    my ($self) = @_;
    my $tool_name = $self->params->{tool_name} // 'get_joke';

    # DataMap-style registration
    $self->agent->register_swaig_function({
        function    => $tool_name,
        description => 'Get a random joke from API Ninjas',
        parameters  => {
            type       => 'object',
            properties => {
                type => {
                    type        => 'string',
                    description => 'Type of joke',
                    enum        => ['jokes', 'dadjokes'],
                },
            },
            required => ['type'],
        },
        data_map => {
            webhooks => [{
                method  => 'GET',
                url     => 'https://api.api-ninjas.com/v1/${args.type}',
                headers => { 'X-Api-Key' => $self->params->{api_key} // '' },
                output  => {
                    response => 'Here\'s a joke: ${array[0].joke}',
                },
            }],
        },
    });
}

sub get_global_data {
    return { joke_skill_enabled => JSON::true };
}

sub _get_prompt_sections {
    return [{
        title   => 'Joke Telling',
        body    => 'You can tell jokes to lighten the mood.',
        bullets => [
            'Use the joke tool when the user asks for a joke',
            'Choose between regular jokes and dad jokes',
        ],
    }];
}

sub get_parameter_schema {
    return {
        %{ SignalWire::Agents::Skills::SkillBase->get_parameter_schema },
        api_key   => { type => 'string', required => 1, hidden => 1 },
        tool_name => { type => 'string', default => 'get_joke' },
    };
}

1;