Files
waggle-os/apps/web/src/lib/agent-search.ts
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

60 lines
1.9 KiB
TypeScript

/**
* agent-search — FE types + helpers for the PR4 agent-pick suggestion box
* (screen 09's centered ask bar). Mirrors the POST /api/marketplace/agent-search
* response: each suggestion carries a deterministic "why" (matchReason) and an
* install descriptor telling the FE how to act (store install / starter-pack /
* Hub handoff / already-active).
*/
import type { InstallTarget } from './install-store';
export interface AgentSearchInstall {
mode: 'store' | 'starter-pack' | 'open-in' | 'active';
extensionId?: string;
type?: 'skill' | 'mcp' | 'connector';
kind?: 'package' | 'federated';
packageId?: number;
authType?: string;
/** starter-pack mode — the skill id to install. */
name?: string;
/** open-in mode — the app to deep-link to (e.g. an OAuth connector → Hub). */
appId?: string;
}
export interface AgentSearchSuggestion {
name: string;
type: string; // CapabilitySourceType: native | skill | marketplace | connector | …
availability: string;
description: string;
/** The deterministic "why" the engine matched this. */
matchReason: string;
matchScore: number;
install: AgentSearchInstall;
}
export interface AgentSearchResponse {
need: string;
gapDetected: boolean;
alreadyHandled: boolean;
recommendation: AgentSearchSuggestion | null;
candidates: AgentSearchSuggestion[];
picks: {
connector?: AgentSearchSuggestion;
skill?: AgentSearchSuggestion;
tool?: AgentSearchSuggestion;
};
}
/** Build an InstallTarget from a store-mode suggestion (null if not directly
* store-installable — connectors hand off to the Hub, starters to installPack). */
export function installTargetFor(s: AgentSearchSuggestion): InstallTarget | null {
const i = s.install;
if (i.mode !== 'store' || !i.extensionId || !i.type || !i.kind) return null;
return {
id: i.extensionId,
type: i.type,
kind: i.kind,
name: s.name,
...(i.packageId != null ? { packageId: i.packageId } : {}),
};
}