feat(core): add pluggable web search (#35558)

Co-authored-by: Dax Raad <d@ironbay.co>

packages/schema/src/websearch.ts

@@ -0,0 +1,42 @@
+export * as WebSearch from "./websearch.js"
+
+import { Schema } from "effect"
+import { ephemeral, inventory } from "./event.js"
+import { optional } from "./schema.js"
+
+export const ID = Schema.String.pipe(Schema.brand("WebSearch.ID"))
+export type ID = typeof ID.Type
+
+export interface Provider extends Schema.Schema.Type<typeof Provider> {}
+export const Provider = Schema.Struct({
+  id: ID,
+  name: Schema.String,
+}).annotate({ identifier: "WebSearch.Provider" })
+
+export interface Input extends Schema.Schema.Type<typeof Input> {}
+export const Input = Schema.Struct({
+  query: Schema.String,
+  providerID: ID.pipe(optional),
+}).annotate({ identifier: "WebSearch.Input" })
+export type ProviderInput = Pick<Input, "query">
+
+export interface Result extends Schema.Schema.Type<typeof Result> {}
+export const Result = Schema.Struct({
+  url: Schema.String,
+  title: Schema.String.pipe(optional),
+  content: Schema.String.pipe(optional),
+  time: Schema.Struct({
+    published: Schema.Finite.pipe(optional),
+  }),
+}).annotate({ identifier: "WebSearch.Result" })
+
+export class Response extends Schema.Class<Response>("WebSearch.Response")({
+  providerID: ID,
+  results: Schema.Array(Result),
+}) {}
+
+const Updated = ephemeral({
+  type: "websearch.updated",
+  schema: {},
+})
+export const Event = { Updated, Definitions: inventory(Updated) }