@5ss/ai-tools 2.11.1

package/dist/modules/artifacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#backend","#storage","#ops"],"sources":["../../../src/modules/artifacts/contracts.ts","../../../src/modules/artifacts/providers/host.ts","../../../src/modules/artifacts/providers/object.ts","../../../src/modules/artifacts/client.ts","../../../src/modules/artifacts/module.ts"],"sourcesContent":["/**\n * ArtifactRef creation and bounded read contracts.\n * Host-mapped and object-store backends share the same model-facing verbs.\n */\n\nimport { isFunction } from 'es-toolkit'\nimport { z } from 'zod'\n\nimport { artifactRefSchema } from '../../shared/artifact'\nimport { MAX_OBJECT_BYTES, s3AuthSchema } from '../../vendors/s3'\n\nexport const MAX_ARTIFACT_READ_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_CREATE_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_INLINE_CHARS = Math.ceil((MAX_ARTIFACT_CREATE_BYTES * 4) / 3) + 4\n\nexport const artifactsCreateInputSchema = z.object({\n\tkey: z.string().min(1).max(1_024).describe('Destination key for the new artifact'),\n\tbody: z.string().max(MAX_ARTIFACT_INLINE_CHARS).describe('Artifact body encoded as specified by encoding'),\n\tencoding: z.enum(['utf8', 'base64']).describe('How body is encoded'),\n\tmedia_type: z.string().min(1).max(200).optional().describe('MIME type when known'),\n\tfilename: z.string().min(1).max(512).optional().describe('Display filename when different from the key')\n})\n\nexport const artifactsCreateOutputSchema = z.object({\n\tartifact: artifactRefSchema.describe('Reference to the created artifact')\n})\n\nexport const artifactsReadRangeInputSchema = z\n\t.object({\n\t\tsource: artifactRefSchema.describe('Artifact to read'),\n\t\tstart_byte: z.int().min(0).describe('Inclusive zero-based start byte'),\n\t\tend_byte: z.int().min(0).describe('Inclusive zero-based end byte')\n\t})\n\t.superRefine((input, ctx) => {\n\t\tconst byteLength = input.end_byte - input.start_byte + 1\n\t\tif (byteLength < 1) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: 'end_byte must be greater than or equal to start_byte'\n\t\t\t})\n\t\t}\n\t\tif (byteLength > MAX_ARTIFACT_READ_BYTES) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: `Byte range cannot exceed ${MAX_ARTIFACT_READ_BYTES} bytes`\n\t\t\t})\n\t\t}\n\t})\n\nexport const artifactsReadRangeOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\tbody_base64: z.string().describe('Requested bytes encoded as base64'),\n\tstart_byte: z.int().min(0),\n\tend_byte: z.int().min(0),\n\ttotal_bytes: z.int().min(0).optional(),\n\tmedia_type: z.string().optional()\n})\n\nexport const artifactsReadLinesInputSchema = z\n\t.object({\n\t\tsource: artifactRefSchema.describe('UTF-8 text artifact to read'),\n\t\tstart_line: z.int().min(1).describe('Inclusive one-based start line'),\n\t\tend_line: z.int().min(1).describe('Inclusive one-based end line')\n\t})\n\t.refine((input) => input.end_line >= input.start_line, {\n\t\tpath: ['end_line'],\n\t\tmessage: 'end_line must be greater than or equal to start_line'\n\t})\n\nexport const artifactsReadLinesOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\ttext: z.string().describe('Selected UTF-8 lines'),\n\tstart_line: z.int().min(1),\n\tend_line: z.int().min(1),\n\ttotal_lines: z.int().min(0)\n})\n\nexport const artifactResolveInputSchema = z.object({\n\tsource: artifactRefSchema,\n\tmax_bytes: z.int().min(0)\n})\n\nexport const resolvedArtifactSchema = z.object({\n\tartifact: artifactRefSchema,\n\tbytes: z.custom<Uint8Array>((value) => value instanceof Uint8Array, 'bytes must be a Uint8Array')\n})\n\nexport type ArtifactsCreateInput = z.infer<typeof artifactsCreateInputSchema>\nexport type ArtifactsCreateOutput = z.infer<typeof artifactsCreateOutputSchema>\nexport type ArtifactsReadRangeInput = z.infer<typeof artifactsReadRangeInputSchema>\nexport type ArtifactsReadRangeOutput = z.infer<typeof artifactsReadRangeOutputSchema>\nexport type ArtifactsReadLinesInput = z.infer<typeof artifactsReadLinesInputSchema>\nexport type ArtifactsReadLinesOutput = z.infer<typeof artifactsReadLinesOutputSchema>\nexport type ArtifactResolveInput = z.infer<typeof artifactResolveInputSchema>\nexport type ResolvedArtifact = z.infer<typeof resolvedArtifactSchema>\n\nexport type ArtifactsOps = {\n\tcreate(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput>\n\treadRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput>\n\treadLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput>\n}\n\nexport type ArtifactResolverOps = {\n\tresolve(input: ArtifactResolveInput): Promise<ResolvedArtifact>\n}\n\nexport type ArtifactsClientOps = ArtifactsOps & ArtifactResolverOps\n\nexport const artifactsBackendSchema = z.object({\n\tcreate: z.custom<ArtifactsOps['create']>(isFunction, 'create must be a function'),\n\treadRange: z.custom<ArtifactsOps['readRange']>(isFunction, 'readRange must be a function'),\n\treadLines: z.custom<ArtifactsOps['readLines']>(isFunction, 'readLines must be a function'),\n\tresolve: z.custom<ArtifactResolverOps['resolve']>(isFunction, 'resolve must be a function').optional()\n})\n\nexport const objectArtifactsAuthSchema = z.object({\n\tprovider: z.literal('object'),\n\tstorage: s3AuthSchema.describe('S3-compatible object storage for ArtifactRef bytes')\n})\n\nexport const hostArtifactsAuthSchema = z.object({\n\tprovider: z.literal('host'),\n\tbackend: artifactsBackendSchema.describe('Host artifact operations for host-mapped ArtifactRefs')\n})\n\nexport const artifactsAuthSchema = z.discriminatedUnion('provider', [\n\tobjectArtifactsAuthSchema,\n\thostArtifactsAuthSchema\n])\n\nexport type ArtifactsAuth = z.infer<typeof artifactsAuthSchema>\nexport type ObjectArtifactsAuth = z.infer<typeof objectArtifactsAuthSchema>\nexport type HostArtifactsAuth = z.infer<typeof hostArtifactsAuthSchema>\n","import { ToolError } from '../../../core/errors'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tHostArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport {\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeOutputSchema,\n\tresolvedArtifactSchema\n} from '../contracts'\n\nfunction requireHostStore(store: 'object' | 'host'): void {\n\tif (store !== 'host') {\n\t\tthrow new ToolError('The host artifact provider only resolves host-mapped references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nexport class HostArtifactsProvider implements ArtifactsClientOps {\n\treadonly #backend: HostArtifactsAuth['backend']\n\n\tconstructor(auth: HostArtifactsAuth) {\n\t\tthis.#backend = auth.backend\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst output = artifactsCreateOutputSchema.parse(await this.#backend.create(input))\n\t\trequireHostStore(output.artifact.store)\n\t\treturn output\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadRangeOutputSchema.parse(await this.#backend.readRange(input))\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadLinesOutputSchema.parse(await this.#backend.readLines(input))\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireHostStore(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\t\tif (!this.#backend.resolve) {\n\t\t\tthrow new ToolError('The host artifact backend does not support byte resolution', {\n\t\t\t\tcode: 'unsupported'\n\t\t\t})\n\t\t}\n\n\t\tconst output = resolvedArtifactSchema.parse(await this.#backend.resolve(input))\n\t\trequireHostStore(output.artifact.store)\n\t\tif (output.artifact.key !== input.source.key) {\n\t\t\tthrow new ToolError('The host artifact backend resolved a different artifact', {\n\t\t\t\tcode: 'internal'\n\t\t\t})\n\t\t}\n\t\tif (output.bytes.byteLength > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...input.source,\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../../core/errors'\nimport { artifactRefSchema } from '../../../shared/artifact'\nimport { base64ToBytes, bytesToBase64, bytesToUtf8, utf8ToBytes } from '../../../shared/bytes'\nimport { mediaTypeFromPath } from '../../../shared/content-type'\nimport type { HttpServiceOptions } from '../../../transport/http-service'\nimport { S3Client } from '../../../vendors/s3'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tObjectArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport { MAX_ARTIFACT_CREATE_BYTES, MAX_ARTIFACT_READ_BYTES } from '../contracts'\n\nexport type ObjectArtifactsProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nfunction requireObjectSource(store: 'object' | 'host'): void {\n\tif (store !== 'object') {\n\t\tthrow new ToolError('The object artifact provider only resolves object-store references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nfunction artifactBytes(input: ArtifactsCreateInput): Uint8Array {\n\tconst bytes = input.encoding === 'base64' ? base64ToBytes(input.body) : utf8ToBytes(input.body)\n\tif (bytes.byteLength > MAX_ARTIFACT_CREATE_BYTES) {\n\t\tthrow new ToolError('Artifact body exceeds create limit', {\n\t\t\tcode: 'too_large',\n\t\t\tdetails: { max_bytes: MAX_ARTIFACT_CREATE_BYTES, content_length: bytes.byteLength }\n\t\t})\n\t}\n\treturn bytes\n}\n\nfunction textLines(text: string): string[] {\n\treturn text.split('\\n').map((line) => (line.endsWith('\\r') ? line.slice(0, -1) : line))\n}\n\nexport class ObjectArtifactsProvider implements ArtifactsClientOps {\n\treadonly #storage: S3Client\n\n\tconstructor(auth: ObjectArtifactsAuth, options: ObjectArtifactsProviderOptions = {}) {\n\t\tthis.#storage = new S3Client(auth.storage, options)\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst bytes = artifactBytes(input)\n\t\tconst mediaType = input.media_type ?? mediaTypeFromPath(input.filename ?? input.key)\n\t\tawait this.#storage.putBytes(input.key, bytes, mediaType)\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\tstore: 'object',\n\t\t\t\tkey: input.key,\n\t\t\t\tbyte_length: bytes.byteLength,\n\t\t\t\t...(mediaType && { media_type: mediaType }),\n\t\t\t\t...(input.filename && { filename: input.filename })\n\t\t\t})\n\t\t}\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst result = await this.#storage.getBytesRange(input.source.key, {\n\t\t\tstart_byte: input.start_byte,\n\t\t\tend_byte: input.end_byte\n\t\t})\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\tbody_base64: bytesToBase64(result.bytes),\n\t\t\tstart_byte: result.start_byte,\n\t\t\tend_byte: result.end_byte,\n\t\t\t...(result.total_bytes !== undefined && { total_bytes: result.total_bytes }),\n\t\t\t...(result.content_type && { media_type: result.content_type })\n\t\t}\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: MAX_ARTIFACT_READ_BYTES })\n\t\tconst lines = textLines(bytesToUtf8(bytes))\n\t\tif (input.start_line > lines.length) {\n\t\t\tthrow new ToolError('start_line is beyond the end of the artifact', {\n\t\t\t\tcode: 'bad_input',\n\t\t\t\tdetails: { start_line: input.start_line, total_lines: lines.length }\n\t\t\t})\n\t\t}\n\t\tconst selected = lines.slice(input.start_line - 1, input.end_line)\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\ttext: selected.join('\\n'),\n\t\t\tstart_line: input.start_line,\n\t\t\tend_line: input.start_line + selected.length - 1,\n\t\t\ttotal_lines: lines.length\n\t\t}\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireObjectSource(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\n\t\tconst head = await this.#storage.head({ key: input.source.key })\n\t\tif (!head.exists) {\n\t\t\tthrow new ToolError('Artifact not found', { code: 'not_found' })\n\t\t}\n\t\tif (head.content_length !== undefined && head.content_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: head.content_length }\n\t\t\t})\n\t\t}\n\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: input.max_bytes })\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\t...input.source,\n\t\t\t\t...(!input.source.media_type && head.content_type && { media_type: head.content_type }),\n\t\t\t\tbyte_length: bytes.byteLength\n\t\t\t}),\n\t\t\tbytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsAuth,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadRangeInput,\n\tResolvedArtifact\n} from './contracts'\nimport { artifactResolveInputSchema, artifactsAuthSchema, resolvedArtifactSchema } from './contracts'\nimport { HostArtifactsProvider } from './providers/host'\nimport { ObjectArtifactsProvider } from './providers/object'\n\nfunction transportOptions(ctx: ToolContext) {\n\treturn {\n\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t...(ctx.signal && { signal: ctx.signal })\n\t}\n}\n\nfunction providerFor(auth: ArtifactsAuth, ctx: ToolContext): ArtifactsClientOps {\n\tswitch (auth.provider) {\n\t\tcase 'object':\n\t\t\treturn new ObjectArtifactsProvider(auth, transportOptions(ctx))\n\t\tcase 'host':\n\t\t\treturn new HostArtifactsProvider(auth)\n\t}\n}\n\nexport class ArtifactsClient implements ArtifactsClientOps {\n\treadonly #ops: ArtifactsClientOps\n\n\tconstructor(ops: ArtifactsClientOps) {\n\t\tthis.#ops = ops\n\t}\n\n\tstatic fromContext(ctx: ToolContext): ArtifactsClient {\n\t\tconst auth = requireAuth(ctx, artifactsAuthSchema)\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tstatic fromAuth(auth: ArtifactsAuth, ctx: ToolContext = {}): ArtifactsClient {\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tcreate(input: ArtifactsCreateInput) {\n\t\treturn this.#ops.create(input)\n\t}\n\n\treadRange(input: ArtifactsReadRangeInput) {\n\t\treturn this.#ops.readRange(input)\n\t}\n\n\treadLines(input: ArtifactsReadLinesInput) {\n\t\treturn this.#ops.readLines(input)\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\tconst parsedInput = artifactResolveInputSchema.parse(input)\n\t\tconst output = resolvedArtifactSchema.parse(await this.#ops.resolve(parsedInput))\n\t\tif (output.bytes.byteLength > parsedInput.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: parsedInput.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { ArtifactsClient } from './client'\nimport {\n\tartifactsAuthSchema,\n\tartifactsCreateInputSchema,\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesInputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeInputSchema,\n\tartifactsReadRangeOutputSchema\n} from './contracts'\n\nexport const artifactsCreateTool = defineTool({\n\tid: 'artifacts-create',\n\tname: 'createArtifact',\n\tdescription:\n\t\t'Persist small, already-serialized UTF-8 or base64 content and return its ArtifactRef. Use for raw bytes or text when no structured builder is required. Do not use this to invent DOCX, XLSX, PPTX, PDF, or image formats.',\n\tinputSchema: artifactsCreateInputSchema,\n\toutputSchema: artifactsCreateOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).create(input)\n})\n\nexport const artifactsReadRangeTool = defineTool({\n\tid: 'artifacts-read-range',\n\tname: 'readArtifactRange',\n\tdescription:\n\t\t'Read an explicit inclusive byte range from an existing ArtifactRef as base64. Use for bounded binary inspection or chunked transfer, not for understanding a supported document when a format-aware reader is available.',\n\tinputSchema: artifactsReadRangeInputSchema,\n\toutputSchema: artifactsReadRangeOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readRange(input)\n})\n\nexport const artifactsReadLinesTool = defineTool({\n\tid: 'artifacts-read-lines',\n\tname: 'readArtifactLines',\n\tdescription:\n\t\t'Read an explicit inclusive line range from a UTF-8 text artifact. Use for bounded inspection instead of loading the whole file into context.',\n\tinputSchema: artifactsReadLinesInputSchema,\n\toutputSchema: artifactsReadLinesOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readLines(input)\n})\n\nexport const artifactsModule = defineModule({\n\tid: 'artifacts',\n\ttitle: 'Artifacts',\n\tdescription:\n\t\t'Persist small serialized content and inspect bounded byte or text ranges. ArtifactRef is the handoff between tools; structured document creation belongs to purpose-built builders.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: artifactsAuthSchema },\n\tcategories: ['storage', 'artifacts'],\n\tclassification: 'pii',\n\ttags: ['artifact-ref', 'object-store'],\n\ttools: [artifactsCreateTool, artifactsReadRangeTool, artifactsReadLinesTool]\n})\n"],"mappings":"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"}

package/dist/modules/browser/index.d.ts

@@ -0,0 +1,516 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { c as BrowserSessionIdInput, g as browserStreamSchema, h as browserStartSessionInputSchema, l as BrowserSessionOutput, m as browserSessionOutputSchema, o as BedrockAgentCoreBrowserClientOptions, p as browserSessionIdInputSchema, u as BrowserStartSessionInput } from "../../index-DuOGj7vc.js";
+import { p as CloudflareBrowserClientOptions } from "../../index-Cuh6eMWc.js";
+import { z } from "zod";
+//#region src/modules/browser/contracts.d.ts
+declare const agentCoreBrowserSeamAuthSchema: z.ZodObject<{
+  access_key_id: z.ZodString;
+  secret_access_key: z.ZodString;
+  region: z.ZodString;
+  session_token: z.ZodOptional<z.ZodString>;
+  browser_id: z.ZodOptional<z.ZodString>;
+  provider: z.ZodLiteral<"bedrock-agentcore">;
+}, z.core.$strip>;
+/** Optional storage for screenshot ArtifactRef on Cloudflare. */
+declare const cloudflareBrowserSeamAuthSchema: z.ZodObject<{
+  account_id: z.ZodString;
+  api_token: z.ZodString;
+  browser: z.ZodOptional<z.ZodEnum<{
+    chromium: "chromium";
+    kitesurf: "kitesurf";
+  }>>;
+  storage: z.ZodOptional<z.ZodObject<{
+    access_key_id: z.ZodString;
+    secret_access_key: z.ZodString;
+    region: z.ZodString;
+    bucket: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    session_token: z.ZodOptional<z.ZodString>;
+    key_prefix: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  provider: z.ZodLiteral<"cloudflare">;
+}, z.core.$strip>;
+declare const browserAuthSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  access_key_id: z.ZodString;
+  secret_access_key: z.ZodString;
+  region: z.ZodString;
+  session_token: z.ZodOptional<z.ZodString>;
+  browser_id: z.ZodOptional<z.ZodString>;
+  provider: z.ZodLiteral<"bedrock-agentcore">;
+}, z.core.$strip>, z.ZodObject<{
+  account_id: z.ZodString;
+  api_token: z.ZodString;
+  browser: z.ZodOptional<z.ZodEnum<{
+    chromium: "chromium";
+    kitesurf: "kitesurf";
+  }>>;
+  storage: z.ZodOptional<z.ZodObject<{
+    access_key_id: z.ZodString;
+    secret_access_key: z.ZodString;
+    region: z.ZodString;
+    bucket: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    session_token: z.ZodOptional<z.ZodString>;
+    key_prefix: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  provider: z.ZodLiteral<"cloudflare">;
+}, z.core.$strip>], "provider">;
+type AgentCoreBrowserSeamAuth = z.infer<typeof agentCoreBrowserSeamAuthSchema>;
+type CloudflareBrowserSeamAuth = z.infer<typeof cloudflareBrowserSeamAuthSchema>;
+type BrowserAuth = z.infer<typeof browserAuthSchema>;
+declare const browserNavigateInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  url: z.ZodURL;
+}, z.core.$strip>;
+declare const browserNavigateOutputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  url: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  html: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const browserSnapshotInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  url: z.ZodOptional<z.ZodURL>;
+  format: z.ZodOptional<z.ZodEnum<{
+    html: "html";
+    text: "text";
+  }>>;
+}, z.core.$strip>;
+declare const browserSnapshotOutputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  format: z.ZodEnum<{
+    html: "html";
+    text: "text";
+  }>;
+  content: z.ZodString;
+  url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const browserClickInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  selector: z.ZodString;
+}, z.core.$strip>;
+declare const browserTypeInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  selector: z.ZodString;
+  text: z.ZodString;
+  clear: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const browserWaitInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  selector: z.ZodOptional<z.ZodString>;
+  timeout_ms: z.ZodOptional<z.ZodInt>;
+  url: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+declare const browserScreenshotInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  url: z.ZodOptional<z.ZodURL>;
+  output_key: z.ZodOptional<z.ZodString>;
+  full_page: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const browserScreenshotOutputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  result: z.ZodObject<{
+    store: z.ZodEnum<{
+      host: "host";
+      object: "object";
+    }>;
+    key: z.ZodString;
+    media_type: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    byte_length: z.ZodOptional<z.ZodInt>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const browserGetStateInputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+}, z.core.$strip>;
+declare const browserGetStateOutputSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  status: z.ZodOptional<z.ZodString>;
+  url: z.ZodOptional<z.ZodString>;
+  title: z.ZodOptional<z.ZodString>;
+  streams: z.ZodOptional<z.ZodObject<{
+    automation_stream_endpoint: z.ZodOptional<z.ZodString>;
+    automation_stream_status: z.ZodOptional<z.ZodString>;
+    live_view_stream_endpoint: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserActionOkSchema: z.ZodObject<{
+  session_id: z.ZodString;
+  ok: z.ZodLiteral<true>;
+}, z.core.$strip>;
+type BrowserNavigateInput = z.infer<typeof browserNavigateInputSchema>;
+type BrowserNavigateOutput = z.infer<typeof browserNavigateOutputSchema>;
+type BrowserSnapshotInput = z.infer<typeof browserSnapshotInputSchema>;
+type BrowserSnapshotOutput = z.infer<typeof browserSnapshotOutputSchema>;
+type BrowserClickInput = z.infer<typeof browserClickInputSchema>;
+type BrowserTypeInput = z.infer<typeof browserTypeInputSchema>;
+type BrowserWaitInput = z.infer<typeof browserWaitInputSchema>;
+type BrowserScreenshotInput = z.infer<typeof browserScreenshotInputSchema>;
+type BrowserScreenshotOutput = z.infer<typeof browserScreenshotOutputSchema>;
+type BrowserGetStateInput = z.infer<typeof browserGetStateInputSchema>;
+type BrowserGetStateOutput = z.infer<typeof browserGetStateOutputSchema>;
+type BrowserActionOk = z.infer<typeof browserActionOkSchema>;
+type BrowserOps = {
+  startSession(input?: BrowserStartSessionInput): Promise<BrowserSessionOutput>;
+  getSession(input: BrowserSessionIdInput): Promise<BrowserSessionOutput>;
+  stopSession(input: BrowserSessionIdInput): Promise<BrowserSessionOutput>;
+  navigate(input: BrowserNavigateInput): Promise<BrowserNavigateOutput>;
+  snapshot(input: BrowserSnapshotInput): Promise<BrowserSnapshotOutput>;
+  click(input: BrowserClickInput): Promise<BrowserActionOk>;
+  type(input: BrowserTypeInput): Promise<BrowserActionOk>;
+  wait(input: BrowserWaitInput): Promise<BrowserActionOk>;
+  screenshot(input: BrowserScreenshotInput): Promise<BrowserScreenshotOutput>;
+  getState(input: BrowserGetStateInput): Promise<BrowserGetStateOutput>;
+};
+//#endregion
+//#region src/modules/browser/client.d.ts
+declare class BrowserClient implements BrowserOps {
+  #private;
+  constructor(ops: BrowserOps);
+  static fromContext(ctx: ToolContext): BrowserClient;
+  static fromAuth(auth: BrowserAuth, ctx?: ToolContext): BrowserClient;
+  startSession(input?: BrowserStartSessionInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  getSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  stopSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  navigate(input: BrowserNavigateInput): Promise<{
+    session_id: string;
+    url: string;
+    title?: string | undefined;
+    html?: string | undefined;
+  }>;
+  snapshot(input: BrowserSnapshotInput): Promise<{
+    session_id: string;
+    format: "html" | "text";
+    content: string;
+    url?: string | undefined;
+  }>;
+  click(input: BrowserClickInput): Promise<{
+    session_id: string;
+    ok: true;
+  }>;
+  type(input: BrowserTypeInput): Promise<{
+    session_id: string;
+    ok: true;
+  }>;
+  wait(input: BrowserWaitInput): Promise<{
+    session_id: string;
+    ok: true;
+  }>;
+  screenshot(input: BrowserScreenshotInput): Promise<{
+    session_id: string;
+    result: {
+      store: "host" | "object";
+      key: string;
+      media_type?: string | undefined;
+      filename?: string | undefined;
+      byte_length?: number | undefined;
+    };
+  }>;
+  getState(input: BrowserGetStateInput): Promise<{
+    session_id: string;
+    status?: string | undefined;
+    url?: string | undefined;
+    title?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+}
+//#endregion
+//#region src/modules/browser/domain.d.ts
+/** Connection handle for a CDP client (Playwright `connectOverCDP`, puppeteer, AgentBrowser). */
+type BrowserCdpConnection = {
+  session_id: string;
+  /** WebSocket debugger URL for Chrome DevTools Protocol. */
+  websocket_url: string;
+  /**
+   * Optional HTTP headers for the WebSocket upgrade.
+   * Empty for most providers when the URL already embeds credentials / signed query.
+   */
+  headers: Record<string, string>;
+  /** Hosted live-view / DevTools UI when the provider returns one. */
+  live_view_url?: string;
+  status?: string;
+};
+type MintBrowserCdpOptions = {
+  /**
+   * Extra WebSocket headers (e.g. Authorization for custom proxies).
+   * Merged after provider defaults; caller keys win.
+   */
+  headers?: Record<string, string>;
+};
+/**
+ * Build a CDP connection object from a browser session (start/get/get-state).
+ * Prefer this over driving click/type tools when the host runs a hybrid agent browser.
+ *
+ * @throws ToolError `bad_input` when the session has no automation stream endpoint.
+ */
+declare function mintBrowserCdpConnection(session: BrowserSessionOutput, options?: MintBrowserCdpOptions): BrowserCdpConnection;
+//#endregion
+//#region src/modules/browser/module.d.ts
+declare const browserStartSessionTool: ToolDefinition<{
+  name?: string | undefined;
+  session_timeout_seconds?: number | undefined;
+  viewport_width?: number | undefined;
+  viewport_height?: number | undefined;
+}, {
+  session_id: string;
+  browser_id?: string | undefined;
+  created_at?: string | undefined;
+  status?: string | undefined;
+  streams?: {
+    automation_stream_endpoint?: string | undefined;
+    automation_stream_status?: string | undefined;
+    live_view_stream_endpoint?: string | undefined;
+  } | undefined;
+}>;
+declare const browserGetSessionTool: ToolDefinition<{
+  session_id: string;
+}, {
+  session_id: string;
+  browser_id?: string | undefined;
+  created_at?: string | undefined;
+  status?: string | undefined;
+  streams?: {
+    automation_stream_endpoint?: string | undefined;
+    automation_stream_status?: string | undefined;
+    live_view_stream_endpoint?: string | undefined;
+  } | undefined;
+}>;
+declare const browserStopSessionTool: ToolDefinition<{
+  session_id: string;
+}, {
+  session_id: string;
+  browser_id?: string | undefined;
+  created_at?: string | undefined;
+  status?: string | undefined;
+  streams?: {
+    automation_stream_endpoint?: string | undefined;
+    automation_stream_status?: string | undefined;
+    live_view_stream_endpoint?: string | undefined;
+  } | undefined;
+}>;
+declare const browserNavigateTool: ToolDefinition<{
+  session_id: string;
+  url: string;
+}, {
+  session_id: string;
+  url: string;
+  title?: string | undefined;
+  html?: string | undefined;
+}>;
+declare const browserSnapshotTool: ToolDefinition<{
+  session_id: string;
+  url?: string | undefined;
+  format?: "html" | "text" | undefined;
+}, {
+  session_id: string;
+  format: "html" | "text";
+  content: string;
+  url?: string | undefined;
+}>;
+declare const browserClickTool: ToolDefinition<{
+  session_id: string;
+  selector: string;
+}, {
+  session_id: string;
+  ok: true;
+}>;
+declare const browserTypeTool: ToolDefinition<{
+  session_id: string;
+  selector: string;
+  text: string;
+  clear?: boolean | undefined;
+}, {
+  session_id: string;
+  ok: true;
+}>;
+declare const browserWaitTool: ToolDefinition<{
+  session_id: string;
+  selector?: string | undefined;
+  timeout_ms?: number | undefined;
+  url?: string | undefined;
+}, {
+  session_id: string;
+  ok: true;
+}>;
+declare const browserScreenshotTool: ToolDefinition<{
+  session_id: string;
+  url?: string | undefined;
+  output_key?: string | undefined;
+  full_page?: boolean | undefined;
+}, {
+  session_id: string;
+  result: {
+    store: "host" | "object";
+    key: string;
+    media_type?: string | undefined;
+    filename?: string | undefined;
+    byte_length?: number | undefined;
+  };
+}>;
+declare const browserGetStateTool: ToolDefinition<{
+  session_id: string;
+}, {
+  session_id: string;
+  status?: string | undefined;
+  url?: string | undefined;
+  title?: string | undefined;
+  streams?: {
+    automation_stream_endpoint?: string | undefined;
+    automation_stream_status?: string | undefined;
+    live_view_stream_endpoint?: string | undefined;
+  } | undefined;
+}>;
+declare const browserModule: ModuleDefinition<{
+  access_key_id: string;
+  secret_access_key: string;
+  region: string;
+  session_token?: string | undefined;
+  browser_id?: string | undefined;
+  provider: "bedrock-agentcore";
+} | {
+  account_id: string;
+  api_token: string;
+  browser?: "chromium" | "kitesurf" | undefined;
+  storage?: {
+    access_key_id: string;
+    secret_access_key: string;
+    region: string;
+    bucket: string;
+    endpoint?: string | undefined;
+    session_token?: string | undefined;
+    key_prefix?: string | undefined;
+  } | undefined;
+  provider: "cloudflare";
+}>;
+//#endregion
+//#region src/modules/browser/providers/bedrock-agentcore.d.ts
+type AgentCoreBrowserProviderOptions = BedrockAgentCoreBrowserClientOptions;
+declare class AgentCoreBrowserProvider implements BrowserOps {
+  #private;
+  constructor(auth: AgentCoreBrowserSeamAuth, options?: AgentCoreBrowserProviderOptions);
+  startSession(input?: BrowserStartSessionInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  getSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  stopSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  navigate(_input: BrowserNavigateInput): Promise<BrowserNavigateOutput>;
+  snapshot(_input: BrowserSnapshotInput): Promise<BrowserSnapshotOutput>;
+  click(_input: BrowserClickInput): Promise<BrowserActionOk>;
+  type(_input: BrowserTypeInput): Promise<BrowserActionOk>;
+  wait(_input: BrowserWaitInput): Promise<BrowserActionOk>;
+  screenshot(_input: BrowserScreenshotInput): Promise<BrowserScreenshotOutput>;
+  getState(input: BrowserGetStateInput): Promise<BrowserGetStateOutput>;
+}
+//#endregion
+//#region src/modules/browser/providers/cloudflare.d.ts
+type CloudflareBrowserProviderOptions = CloudflareBrowserClientOptions;
+declare class CloudflareBrowserProvider implements BrowserOps {
+  #private;
+  constructor(auth: CloudflareBrowserSeamAuth, options?: CloudflareBrowserProviderOptions);
+  startSession(input?: BrowserStartSessionInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  getSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  stopSession(input: BrowserSessionIdInput): Promise<{
+    session_id: string;
+    browser_id?: string | undefined;
+    created_at?: string | undefined;
+    status?: string | undefined;
+    streams?: {
+      automation_stream_endpoint?: string | undefined;
+      automation_stream_status?: string | undefined;
+      live_view_stream_endpoint?: string | undefined;
+    } | undefined;
+  }>;
+  navigate(input: BrowserNavigateInput): Promise<BrowserNavigateOutput>;
+  snapshot(input: BrowserSnapshotInput): Promise<BrowserSnapshotOutput>;
+  click(_input: BrowserClickInput): Promise<BrowserActionOk>;
+  type(_input: BrowserTypeInput): Promise<BrowserActionOk>;
+  wait(_input: BrowserWaitInput): Promise<BrowserActionOk>;
+  screenshot(input: BrowserScreenshotInput): Promise<BrowserScreenshotOutput>;
+  getState(input: BrowserGetStateInput): Promise<BrowserGetStateOutput>;
+}
+//#endregion
+export { AgentCoreBrowserProvider, type AgentCoreBrowserProviderOptions, type AgentCoreBrowserSeamAuth, type BrowserActionOk, type BrowserAuth, type BrowserCdpConnection, type BrowserClickInput, BrowserClient, type BrowserGetStateInput, type BrowserGetStateOutput, type BrowserNavigateInput, type BrowserNavigateOutput, type BrowserOps, type BrowserScreenshotInput, type BrowserScreenshotOutput, type BrowserSessionIdInput, type BrowserSessionOutput, type BrowserSnapshotInput, type BrowserSnapshotOutput, type BrowserStartSessionInput, type BrowserTypeInput, type BrowserWaitInput, CloudflareBrowserProvider, type CloudflareBrowserProviderOptions, type CloudflareBrowserSeamAuth, type MintBrowserCdpOptions, agentCoreBrowserSeamAuthSchema, browserActionOkSchema, browserAuthSchema, browserClickInputSchema, browserClickTool, browserGetSessionTool, browserGetStateInputSchema, browserGetStateOutputSchema, browserGetStateTool, browserModule, browserNavigateInputSchema, browserNavigateOutputSchema, browserNavigateTool, browserScreenshotInputSchema, browserScreenshotOutputSchema, browserScreenshotTool, browserSessionIdInputSchema, browserSessionOutputSchema, browserSnapshotInputSchema, browserSnapshotOutputSchema, browserSnapshotTool, browserStartSessionInputSchema, browserStartSessionTool, browserStopSessionTool, browserStreamSchema, browserTypeInputSchema, browserTypeTool, browserWaitInputSchema, browserWaitTool, cloudflareBrowserSeamAuthSchema, mintBrowserCdpConnection };
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/browser/contracts.ts","../../../src/modules/browser/client.ts","../../../src/modules/browser/domain.ts","../../../src/modules/browser/module.ts","../../../src/modules/browser/providers/bedrock-agentcore.ts","../../../src/modules/browser/providers/cloudflare.ts"],"mappings":"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"}