An AI-powered search engine with a generative UI
TypeScript generative-aigenerative-uinextjsollamareactsearxngshadcn-uitailwindcsstavilytypescriptupstashvercel-ai-sdk
import type {
InferAgentUIMessage,
InferUITools,
ToolLoopAgent,
UIMessage,
UIToolInvocation
} from 'ai'
import type { createDraftTools } from '../tools/draft'
import type { fetchTool } from '../tools/fetch'
import type { createQuestionTool } from '../tools/question'
import type { createSearchTool } from '../tools/search'
import type { createTodoTools } from '../tools/todo'
import type { SearchMode } from './search'
// Define the tools type for researcher agent
export type ResearcherTools = {
search: ReturnType<typeof createSearchTool>
fetch: typeof fetchTool
askQuestion: ReturnType<typeof createQuestionTool>
} & ReturnType<typeof createTodoTools> &
ReturnType<typeof createDraftTools>
// Runtime context carried through the generation lifecycle. Included in
// telemetry so each observation keeps the metadata v6 attached via
// telemetry.metadata.
export type ResearcherRuntimeContext = {
modelId: string
agentType: string
searchMode: SearchMode
}
// Type alias for the researcher agent using ToolLoopAgent
// ToolLoopAgent generic signature is <CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>
export type ResearcherAgent = ToolLoopAgent<
never,
ResearcherTools,
ResearcherRuntimeContext
>
// Infer UI message type for researcher agent
export type ResearcherUIMessage = InferAgentUIMessage<ResearcherAgent>
// Infer UI tools type for researcher agent
export type ResearcherUITools = InferUITools<ResearcherTools>
// Tool invocation types for each tool
export type SearchToolInvocation = UIToolInvocation<ResearcherTools['search']>
export type FetchToolInvocation = UIToolInvocation<ResearcherTools['fetch']>
export type QuestionToolInvocation = UIToolInvocation<
ResearcherTools['askQuestion']
>
export type TodoWriteToolInvocation = UIToolInvocation<
ResearcherTools['todoWrite']
>
// Union type for all tool invocations
export type ResearcherToolInvocation =
| SearchToolInvocation
| FetchToolInvocation
| QuestionToolInvocation
| TodoWriteToolInvocation
// Helper type to extract tool names
export type ResearcherToolName = keyof ResearcherTools
// Type guard functions
export function isSearchToolInvocation(
invocation: ResearcherToolInvocation
): invocation is SearchToolInvocation {
return 'query' in (invocation as any).input
}
export function isFetchToolInvocation(
invocation: ResearcherToolInvocation
): invocation is FetchToolInvocation {
return 'url' in (invocation as any).input
}
// Response type for agent.respond()
export type ResearcherResponse = Response
// Options type for agent.respond()
export type ResearcherRespondOptions = {
messages: UIMessage<never, never, ResearcherUITools>[]
}