@sudobility/raidr_agent_lib 0.0.5 → 0.0.7

package/dist/business/runner/stepSchemas.js

@@ -0,0 +1,511 @@
+export const STEP_ENDPOINTS = {
+    understand: 'understand-intent',
+    'rank-sites': 'rank-sites',
+    prepare: 'prepare-site',
+    plan: 'plan-calls',
+    extract: 'extract-results',
+    'pick-best': 'pick-best',
+};
+const str = (description, extra = {}) => ({
+    type: 'string',
+    description,
+    ...extra,
+});
+const location = {
+    type: 'object',
+    description: 'Device position in decimal degrees.',
+    properties: {
+        latitude: { type: 'number', description: 'Latitude, -90 to 90.' },
+        longitude: { type: 'number', description: 'Longitude, -180 to 180.' },
+        accuracy: { type: 'number', description: 'Accuracy radius in meters.' },
+    },
+    required: ['latitude', 'longitude'],
+};
+const intentInput = {
+    type: 'object',
+    description: 'The understood request (output of understand-intent): intent, labels, slots, resultKind, query, what, who, how, when, where, why, selection, location_needed.',
+};
+const site = {
+    type: 'object',
+    description: 'The site being worked on.',
+    properties: {
+        apiHost: str('API host, e.g. api.example.com.'),
+        title: str('Site name.'),
+        description: str('What the site is.'),
+    },
+    required: ['apiHost', 'title'],
+};
+const understandInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request, in their words."),
+        vocabulary: {
+            type: 'array',
+            description: 'Every site label in the catalog. Pick labels from this list only.',
+            items: { type: 'string' },
+        },
+        country: str("ISO 3166-1 alpha-2 of the user's region, e.g. US."),
+        locale: str("BCP 47 locale of the user's device, e.g. en-US."),
+        timeZone: str("IANA time zone of the user's device, e.g. America/New_York."),
+        now: str("The device's current date-time, ISO 8601 with offset."),
+    },
+    required: ['request', 'vocabulary'],
+};
+const understandOutput = {
+    type: 'object',
+    properties: {
+        intent: str('Short lowercase slug of the task, e.g. recipe, event_search, flight_booking, apartment_rental, bank_transactions.', { maxLength: 60 }),
+        labels: {
+            type: 'array',
+            description: 'Up to 6 labels from the vocabulary that a site able to answer this would carry, most relevant first.',
+            items: { type: 'string' },
+            maxItems: 6,
+        },
+        slots: {
+            type: 'array',
+            description: 'Concrete values named in the request (dish, artist, budget, cuisine...). Empty when none.',
+            items: {
+                type: 'object',
+                properties: {
+                    name: str('snake_case name, e.g. dish, price_max.'),
+                    value: str('The value as the user said it.'),
+                },
+                required: ['name', 'value'],
+            },
+            maxItems: 10,
+        },
+        resultKind: str('The shape of an answer; picks the result view.', {
+            enum: [
+                'recipe',
+                'product',
+                'article',
+                'place',
+                'media',
+                'financial',
+                'generic',
+            ],
+        }),
+        query: str('A short search query to send to the sites (keywords, no filler).', { maxLength: 300 }),
+        what: str('The action in a few words, e.g. find events, book a flight.', {
+            maxLength: 200,
+        }),
+        who: {
+            type: 'object',
+            description: 'Who it is for, or null when the request does not say or it does not matter.',
+            properties: {
+                kind: str('self: just the user; party: several people.', {
+                    enum: ['self', 'party'],
+                }),
+                partySize: {
+                    type: 'integer',
+                    description: 'Number of people including the user, when known.',
+                    minimum: 1,
+                    maximum: 100,
+                },
+                description: str('e.g. 2 adults, 1 child.'),
+            },
+            required: ['kind'],
+        },
+        how: str('Constraints or preferences (cheapest, under $2000/month, vegetarian, 4+ stars), or null.'),
+        when: {
+            type: 'object',
+            description: 'When, or null when the request has no time. Resolve start/end against now and timeZone.',
+            properties: {
+                text: str('The words the user used, e.g. tonight, next weekend.'),
+                start: str('ISO 8601 date or date-time with offset.'),
+                end: str('ISO 8601 date or date-time with offset.'),
+            },
+            required: ['text'],
+        },
+        where: {
+            type: 'object',
+            description: "Where, or null when place does not matter. current: near the user's device (near me, nearby, tonight in town); place: one named place; places: several (origin and destination).",
+            properties: {
+                kind: str('current, place or places.', {
+                    enum: ['current', 'place', 'places'],
+                }),
+                places: {
+                    type: 'array',
+                    description: 'Named places; empty for current.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: str('Place name as the user said it, e.g. Paris, SFO.'),
+                            role: str('Its role.', {
+                                enum: ['area', 'origin', 'destination', 'stop'],
+                            }),
+                        },
+                        required: ['name'],
+                    },
+                },
+            },
+            required: ['kind', 'places'],
+        },
+        why: str('The purpose when the user states it (a birthday dinner), or null.'),
+        selection: str('single: one site, one answer; best: compare several sites and pick one; all: list everything from several sites.', { enum: ['single', 'best', 'all'] }),
+        location_needed: {
+            type: 'boolean',
+            description: 'true exactly when where.kind is current.',
+        },
+    },
+    required: [
+        'intent',
+        'labels',
+        'slots',
+        'resultKind',
+        'query',
+        'what',
+        'who',
+        'how',
+        'when',
+        'where',
+        'why',
+        'selection',
+        'location_needed',
+    ],
+};
+const rankInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request."),
+        intent: intentInput,
+        country: str("ISO 3166-1 alpha-2 of the user's region."),
+        sites: {
+            type: 'array',
+            description: 'Candidate sites from the catalog.',
+            items: {
+                type: 'object',
+                properties: {
+                    apiHost: str('API host; copy it exactly into the answer.'),
+                    title: str('Site name.'),
+                    description: str('What the site is.'),
+                    labels: { type: 'array', items: { type: 'string' } },
+                    toolCount: { type: 'integer', description: 'Number of API tools.' },
+                },
+                required: ['apiHost', 'title'],
+            },
+        },
+    },
+    required: ['request', 'intent', 'sites'],
+};
+const rankOutput = {
+    type: 'object',
+    properties: {
+        sites: {
+            type: 'array',
+            description: 'The sites that can really serve this request, best first. Leave unsuitable ones out.',
+            items: {
+                type: 'object',
+                properties: {
+                    apiHost: str('Exactly as given in the input.'),
+                    reason: str('One short sentence for the user: why this site fits the request.', { maxLength: 300 }),
+                },
+                required: ['apiHost', 'reason'],
+            },
+            maxItems: 12,
+        },
+    },
+    required: ['sites'],
+};
+const prepareInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request."),
+        intent: intentInput,
+        location,
+        site,
+        tools: {
+            type: 'array',
+            description: "The site's API tools, most likely useful first.",
+            items: {
+                type: 'object',
+                properties: {
+                    name: str('Tool name.'),
+                    description: str('What it does.'),
+                    inputSchema: {
+                        type: 'object',
+                        description: 'JSON Schema of its arguments.',
+                    },
+                    auth: str("none: works signed out; user: needs the user's account; api_key: needs a site key; unknown: not documented.", { enum: ['none', 'user', 'api_key', 'unknown'] }),
+                },
+                required: ['name', 'description', 'auth'],
+            },
+        },
+    },
+    required: ['request', 'intent', 'site', 'tools'],
+};
+const formFieldOutput = {
+    type: 'object',
+    properties: {
+        name: str('Canonical snake_case name: keyword, category, start_date, end_date, price_min, price_max, party_size, origin, destination, bedrooms...'),
+        label: str('Short label shown to the user.'),
+        type: str('Input control.', {
+            enum: [
+                'text',
+                'number',
+                'date',
+                'datetime',
+                'select',
+                'multiselect',
+                'boolean',
+            ],
+        }),
+        required: {
+            type: 'boolean',
+            description: 'true only when the tools cannot run without it.',
+        },
+        description: str('One line of help, optional.'),
+        options: {
+            type: 'array',
+            description: 'Choices for select/multiselect (from the tool schema enum).',
+            items: {
+                type: 'object',
+                properties: {
+                    value: str('Value sent to the tool.'),
+                    label: str('Shown to the user.'),
+                },
+                required: ['value', 'label'],
+            },
+        },
+        default: {
+            description: 'Prefilled value taken from the intent (string, number, boolean, or array of strings for multiselect).',
+        },
+    },
+    required: ['name', 'label', 'type', 'required'],
+};
+const prepareOutput = {
+    type: 'object',
+    properties: {
+        tools: {
+            type: 'array',
+            description: 'Up to 6 tool names (exactly as listed) worth calling for this request, most useful first.',
+            items: { type: 'string' },
+            maxItems: 6,
+        },
+        login: str("required: the request is about the user's own data/account, or every useful tool needs the user's account and is personal; fallback: tools are flagged user but the request is public, so try signed out first; none: no sign-in.", { enum: ['required', 'fallback', 'none'] }),
+        loginReason: str('When login is not none: one short sentence for the user on why signing in helps.'),
+        unsupported: str('Only when this site cannot serve the request at all: why, in one sentence. Otherwise omit it.'),
+        fields: {
+            type: 'array',
+            description: 'Inputs to ask the user for: only what the chosen tools need that the intent does not already answer. Empty when nothing is missing.',
+            items: formFieldOutput,
+            maxItems: 8,
+        },
+    },
+    required: ['tools', 'login', 'fields'],
+};
+const planInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request."),
+        intent: str('Intent slug.'),
+        query: str('Search query.'),
+        what: str('The action.'),
+        who: { type: 'object', description: 'Who it is for, or null.' },
+        how: str('Constraints or preferences, or null.'),
+        when: {
+            type: 'object',
+            description: 'When (text, start, end ISO 8601), or null.',
+        },
+        where: {
+            type: 'object',
+            description: 'Where (kind, places), or null.',
+        },
+        location,
+        inputs: {
+            type: 'object',
+            description: "The user's answers to the prepared form, by field name. Use them as tool arguments.",
+        },
+        preferredTools: {
+            type: 'array',
+            description: 'Tools chosen for this request; prefer them.',
+            items: { type: 'string' },
+        },
+        site,
+        tools: {
+            type: 'array',
+            description: 'Every tool you may call (name, description, inputSchema).',
+            items: { type: 'object' },
+        },
+        history: {
+            type: 'array',
+            description: 'Calls made so far: tool, arguments, status (HTTP status or error), excerpt of the response.',
+            items: { type: 'object' },
+        },
+    },
+    required: ['request', 'intent', 'query', 'site', 'tools', 'history'],
+};
+const planOutput = {
+    type: 'object',
+    properties: {
+        done: {
+            type: 'boolean',
+            description: 'true when the history already holds enough to answer (or nothing more can help).',
+        },
+        calls: {
+            type: 'array',
+            description: 'Up to 3 calls to make now; empty when done.',
+            items: {
+                type: 'object',
+                properties: {
+                    tool: str('Tool name, exactly as listed.'),
+                    arguments: str('The arguments as a JSON object encoded in a string, matching the tool inputSchema, e.g. {"q":"pad thai","limit":10}.'),
+                    reason: str('Why this call, a few words.'),
+                },
+                required: ['tool', 'arguments'],
+            },
+            maxItems: 3,
+        },
+    },
+    required: ['done', 'calls'],
+};
+const extractInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request."),
+        resultKind: str('The kind of answer wanted.'),
+        location,
+        site,
+        responses: {
+            type: 'array',
+            description: 'Successful API responses of this run.',
+            items: {
+                type: 'object',
+                properties: {
+                    callId: str('Id of the call; copy it into ref.callId.'),
+                    tool: str('Tool that was called.'),
+                    endpoint: str('Its endpoint, e.g. GET /events/search.'),
+                    excerpt: str('The response body (JSON), possibly cut off.'),
+                },
+                required: ['callId', 'tool', 'endpoint', 'excerpt'],
+            },
+        },
+    },
+    required: ['request', 'resultKind', 'site', 'responses'],
+};
+const extractOutput = {
+    type: 'object',
+    properties: {
+        items: {
+            type: 'array',
+            description: 'Up to 10 results that answer the request, best first. Only things present in the responses.',
+            maxItems: 10,
+            items: {
+                type: 'object',
+                properties: {
+                    title: str('Name of the thing.'),
+                    summary: str('One or two sentences from the data.'),
+                    imageUrl: str('An absolute image URL copied verbatim from the data, or empty.'),
+                    sourceUrl: str('An absolute URL copied verbatim from the data, or empty. Never build or guess one.'),
+                    location: {
+                        type: 'object',
+                        description: 'Coordinates when the data gives them for this result, else null.',
+                        properties: {
+                            latitude: { type: 'number', description: '-90 to 90.' },
+                            longitude: { type: 'number', description: '-180 to 180.' },
+                        },
+                        required: ['latitude', 'longitude'],
+                    },
+                    recipe: {
+                        type: 'object',
+                        description: 'For recipe results only; null otherwise.',
+                        properties: {
+                            ingredients: {
+                                type: 'array',
+                                description: 'With amounts, e.g. 200 g rice noodles.',
+                                items: { type: 'string' },
+                            },
+                            steps: {
+                                type: 'array',
+                                description: 'Steps in order.',
+                                items: { type: 'string' },
+                            },
+                            totalMinutes: {
+                                type: 'number',
+                                description: 'Total time in minutes, or null.',
+                            },
+                            servings: { type: 'number', description: 'Servings, or null.' },
+                        },
+                        required: ['ingredients', 'steps', 'totalMinutes', 'servings'],
+                    },
+                    fields: {
+                        type: 'array',
+                        description: 'Key facts as label/value pairs (price, date, venue, rating...).',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                label: str('e.g. Price.'),
+                                value: str('e.g. $25.'),
+                            },
+                            required: ['label', 'value'],
+                        },
+                    },
+                    ref: {
+                        type: 'object',
+                        description: 'Where this result is in the responses.',
+                        properties: {
+                            callId: str('callId of the response it came from.'),
+                            itemPath: str('JSON path of the result object inside that body: dotted keys and [index] counted from 0, e.g. entries[3] or data.events[0]; empty string for the whole body.'),
+                        },
+                        required: ['callId', 'itemPath'],
+                    },
+                },
+                required: [
+                    'title',
+                    'summary',
+                    'imageUrl',
+                    'sourceUrl',
+                    'location',
+                    'recipe',
+                    'fields',
+                    'ref',
+                ],
+            },
+        },
+    },
+    required: ['items'],
+};
+const pickBestInput = {
+    type: 'object',
+    properties: {
+        request: str("The user's request."),
+        intent: intentInput,
+        results: {
+            type: 'array',
+            description: 'Results from every site.',
+            items: {
+                type: 'object',
+                properties: {
+                    id: str('Result id; copy it into bestId.'),
+                    siteTitle: str('Site it came from.'),
+                    title: str('Title.'),
+                    summary: str('Summary.'),
+                    fields: {
+                        type: 'array',
+                        items: { type: 'object' },
+                        description: 'label/value facts.',
+                    },
+                },
+                required: ['id', 'title'],
+            },
+        },
+    },
+    required: ['request', 'intent', 'results'],
+};
+const pickBestOutput = {
+    type: 'object',
+    properties: {
+        bestId: str('id of the single best result, exactly as given.'),
+        reason: str('One or two sentences for the user: why this one beats the others, citing the facts that decided it.'),
+    },
+    required: ['bestId', 'reason'],
+};
+export const STEP_SCHEMAS = {
+    understand: { input: understandInput, output: understandOutput },
+    'rank-sites': { input: rankInput, output: rankOutput },
+    prepare: { input: prepareInput, output: prepareOutput },
+    plan: { input: planInput, output: planOutput },
+    extract: { input: extractInput, output: extractOutput },
+    'pick-best': { input: pickBestInput, output: pickBestOutput },
+};
+//# sourceMappingURL=stepSchemas.js.map

package/dist/business/runner/stepSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepSchemas.js","sourceRoot":"","sources":["../../../src/business/runner/stepSchemas.ts"],"names":[],"mappings":"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"}

package/dist/business/runner/steps.d.ts

@@ -0,0 +1,37 @@
+import type { AgentIntent, BestData, CandidateSite, FormField, GeoLocation, PrepareResponse, ResultItem } from '@sudobility/raidr_agent_types';
+import type { AiTransport, SiteCatalog, SiteContextSource } from './runner';
+export interface UnderstandInput {
+    request: string;
+    vocabulary?: string[];
+    country?: string;
+    locale?: string;
+    timeZone?: string;
+    now?: string;
+}
+export declare function understandIntent(ai: AiTransport, input: UnderstandInput): Promise<AgentIntent>;
+export declare const MAX_RANKED_SITES = 12;
+export interface RankSitesInput {
+    request: string;
+    intent: AgentIntent;
+    country?: string;
+    candidates: CandidateSite[];
+}
+export declare function rankSites(ai: AiTransport, input: RankSitesInput): Promise<CandidateSite[]>;
+export declare const MAX_MERGED_FIELDS = 12;
+export declare function mergeForm(fieldLists: FormField[][]): FormField[];
+export interface PrepareSitesInput {
+    request: string;
+    intent: AgentIntent;
+    location?: GeoLocation;
+    sites: string[];
+}
+export declare const MAX_PREPARE_TOOLS = 40;
+export declare function prepareSites(ai: AiTransport, catalog: SiteContextSource | SiteCatalog, input: PrepareSitesInput): Promise<PrepareResponse>;
+export declare const MAX_BEST_CANDIDATES = 40;
+export interface PickBestInput {
+    request: string;
+    intent: AgentIntent;
+    results: ResultItem[];
+}
+export declare function pickBest(ai: AiTransport, input: PickBestInput): Promise<BestData | null>;
+//# sourceMappingURL=steps.d.ts.map

package/dist/business/runner/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/business/runner/steps.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EAGX,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAc5E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,WAAW,CAAC,CAetB;AAOD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAQD,wBAAsB,SAAS,CAC7B,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAOD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAOpC,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,GAAG,SAAS,EAAE,CA0BhE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAGD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAiBpC,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,iBAAiB,GAAG,WAAW,EACxC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAwFD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAQD,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAyB1B"}