@5ss/ai-tools 2.11.1

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

@@ -0,0 +1,129 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { C as queueExtendVisibilityInputSchema, D as queueReceiveInputSchema, E as queueReceiptInputSchema, O as queueReceiveOutputSchema, S as queueEnqueueOutputSchema, T as queueMessageSchema, _ as QueueReceiveInput, b as queueAcknowledgeOutputSchema, d as QueueEnqueueOutput, f as QueueExtendVisibilityInput, g as QueueReceiptInput, h as QueueOps, l as QueueAcknowledgeOutput, m as QueueMessage, p as QueueExtendVisibilityOutput, s as SqsClientOptions, u as QueueEnqueueInput, v as QueueReceiveOutput, w as queueExtendVisibilityOutputSchema, x as queueEnqueueInputSchema } from "../../index-pwW1OsOx.js";
+import { z } from "zod";
+//#region src/modules/queue/contracts.d.ts
+declare const sqsQueueAuthSchema: z.ZodObject<{
+  access_key_id: z.ZodString;
+  secret_access_key: z.ZodString;
+  region: z.ZodString;
+  session_token: z.ZodOptional<z.ZodString>;
+  queue_url: z.ZodURL;
+  provider: z.ZodLiteral<"sqs">;
+}, z.core.$strip>;
+declare const queueAuthSchema: z.ZodObject<{
+  access_key_id: z.ZodString;
+  secret_access_key: z.ZodString;
+  region: z.ZodString;
+  session_token: z.ZodOptional<z.ZodString>;
+  queue_url: z.ZodURL;
+  provider: z.ZodLiteral<"sqs">;
+}, z.core.$strip>;
+type SqsQueueAuth = z.infer<typeof sqsQueueAuthSchema>;
+type QueueAuth = z.infer<typeof queueAuthSchema>;
+type QueueSeamOps = QueueOps;
+//#endregion
+//#region src/modules/queue/client.d.ts
+declare class QueueClient implements QueueSeamOps {
+  #private;
+  constructor(ops: QueueSeamOps);
+  static fromContext(ctx: ToolContext): QueueClient;
+  static fromAuth(auth: QueueAuth, ctx?: ToolContext): QueueClient;
+  enqueue(input: QueueEnqueueInput): Promise<{
+    message_id: string;
+    body_md5?: string | undefined;
+    sequence_number?: string | undefined;
+  }>;
+  receive(input?: QueueReceiveInput): Promise<{
+    messages: {
+      message_id: string;
+      receipt_handle: string;
+      body: string;
+      body_md5?: string | undefined;
+      attributes?: Record<string, string> | undefined;
+    }[];
+  }>;
+  acknowledge(input: QueueReceiptInput): Promise<{
+    acknowledged: true;
+  }>;
+  extendVisibility(input: QueueExtendVisibilityInput): Promise<{
+    extended: true;
+    visibility_timeout_seconds: number;
+  }>;
+}
+//#endregion
+//#region src/modules/queue/module.d.ts
+declare const queueEnqueueTool: ToolDefinition<{
+  body: string;
+  delay_seconds?: number | undefined;
+  message_group_id?: string | undefined;
+  deduplication_id?: string | undefined;
+}, {
+  message_id: string;
+  body_md5?: string | undefined;
+  sequence_number?: string | undefined;
+}>;
+declare const queueReceiveTool: ToolDefinition<{
+  max_messages?: number | undefined;
+  wait_seconds?: number | undefined;
+  visibility_timeout_seconds?: number | undefined;
+}, {
+  messages: {
+    message_id: string;
+    receipt_handle: string;
+    body: string;
+    body_md5?: string | undefined;
+    attributes?: Record<string, string> | undefined;
+  }[];
+}>;
+declare const queueAcknowledgeTool: ToolDefinition<{
+  receipt_handle: string;
+}, {
+  acknowledged: true;
+}>;
+declare const queueExtendVisibilityTool: ToolDefinition<{
+  receipt_handle: string;
+  visibility_timeout_seconds: number;
+}, {
+  extended: true;
+  visibility_timeout_seconds: number;
+}>;
+declare const queueModule: ModuleDefinition<{
+  access_key_id: string;
+  secret_access_key: string;
+  region: string;
+  session_token?: string | undefined;
+  queue_url: string;
+  provider: "sqs";
+}>;
+//#endregion
+//#region src/modules/queue/providers/sqs.d.ts
+type SqsQueueProviderOptions = SqsClientOptions;
+declare class SqsQueueProvider implements QueueSeamOps {
+  #private;
+  constructor(auth: SqsQueueAuth, options?: SqsQueueProviderOptions);
+  enqueue(input: QueueEnqueueInput): Promise<{
+    message_id: string;
+    body_md5?: string | undefined;
+    sequence_number?: string | undefined;
+  }>;
+  receive(input?: QueueReceiveInput): Promise<{
+    messages: {
+      message_id: string;
+      receipt_handle: string;
+      body: string;
+      body_md5?: string | undefined;
+      attributes?: Record<string, string> | undefined;
+    }[];
+  }>;
+  acknowledge(input: QueueReceiptInput): Promise<{
+    acknowledged: true;
+  }>;
+  extendVisibility(input: QueueExtendVisibilityInput): Promise<{
+    extended: true;
+    visibility_timeout_seconds: number;
+  }>;
+}
+//#endregion
+export { type QueueAcknowledgeOutput, type QueueAuth, QueueClient, type QueueEnqueueInput, type QueueEnqueueOutput, type QueueExtendVisibilityInput, type QueueExtendVisibilityOutput, type QueueMessage, type QueueReceiptInput, type QueueReceiveInput, type QueueReceiveOutput, type QueueSeamOps, type SqsQueueAuth, SqsQueueProvider, type SqsQueueProviderOptions, queueAcknowledgeOutputSchema, queueAcknowledgeTool, queueAuthSchema, queueEnqueueInputSchema, queueEnqueueOutputSchema, queueEnqueueTool, queueExtendVisibilityInputSchema, queueExtendVisibilityOutputSchema, queueExtendVisibilityTool, queueMessageSchema, queueModule, queueReceiptInputSchema, queueReceiveInputSchema, queueReceiveOutputSchema, queueReceiveTool, sqsQueueAuthSchema };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/queue/contracts.ts","../../../src/modules/queue/client.ts","../../../src/modules/queue/module.ts","../../../src/modules/queue/providers/sqs.ts"],"mappings":";;;;;cAwCa,oBAAkB,EAAA;;;;;;;GAE7B,EAAA,KAAA;cAEW,iBAAe,EAAA;;;;;;;GAAqB,EAAA,KAAA;KAErC,eAAe,EAAE,aAAa;KAC9B,YAAY,EAAE,aAAa;KAE3B,eAAe;;;cC1Bd,uBAAuB;;EAGnC,YAAY,KAAK;SAIV,YAAY,KAAK,cAAc;SAI/B,SAAS,MAAM,WAAW,MAAK,cAAmB;EAIzD,QAAQ,OAAO,oBAAiB;;;;;EAIhC,QAAQ,QAAO,oBAAsB;;;;;;;;;EAIrC,YAAY,OAAO,oBAAiB;;;EAIpC,iBAAiB,OAAO,6BAA0B;;;;;;;cCpCtC,kBAAA;;;;;;;;;;cAaA,kBAAA;;;;;;;;;;iBAAA;;;cAYA,sBAAA;;;;;cAYA,2BAAA;;;;;;;cAYA,aAAA;;;;;;;;;;KCpDD,0BAA0B;cAEzB,4BAA4B;;EAGxC,YAAY,MAAM,cAAc,UAAS;EAKzC,QAAQ,OAAO,oBAAiB;;;;;EAIhC,QAAQ,QAAO,oBAAsB;;;;;;;;;EAIrC,YAAY,OAAO,oBAAiB;;;EAIpC,iBAAiB,OAAO,6BAA0B"}

package/dist/modules/queue/index.js

@@ -0,0 +1,131 @@
+import { n as defineModule, r as defineTool } from "../../define-CvpJ_pNP.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { _ as sqsAuthSchema, c as queueAcknowledgeOutputSchema, d as queueExtendVisibilityInputSchema, f as queueExtendVisibilityOutputSchema, g as queueReceiveOutputSchema, h as queueReceiveInputSchema, l as queueEnqueueInputSchema, m as queueReceiptInputSchema, o as SqsClient, p as queueMessageSchema, u as queueEnqueueOutputSchema } from "../../sqs-DCwS1i2N.js";
+import { z } from "zod";
+//#region src/modules/queue/contracts.ts
+const sqsQueueAuthSchema = sqsAuthSchema.extend({ provider: z.literal("sqs") });
+const queueAuthSchema = sqsQueueAuthSchema;
+//#endregion
+//#region src/modules/queue/providers/sqs.ts
+var SqsQueueProvider = class {
+	#client;
+	constructor(auth, options = {}) {
+		const { provider: _provider, ...vendorAuth } = auth;
+		this.#client = new SqsClient(vendorAuth, options);
+	}
+	enqueue(input) {
+		return this.#client.enqueue(input);
+	}
+	receive(input = {}) {
+		return this.#client.receive(input);
+	}
+	acknowledge(input) {
+		return this.#client.acknowledge(input);
+	}
+	extendVisibility(input) {
+		return this.#client.extendVisibility(input);
+	}
+};
+//#endregion
+//#region src/modules/queue/client.ts
+function providerFor(auth, ctx) {
+	switch (auth.provider) {
+		case "sqs": return new SqsQueueProvider(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+}
+var QueueClient = class QueueClient {
+	#ops;
+	constructor(ops) {
+		this.#ops = ops;
+	}
+	static fromContext(ctx) {
+		return new QueueClient(providerFor(requireAuth(ctx, queueAuthSchema), ctx));
+	}
+	static fromAuth(auth, ctx = {}) {
+		return new QueueClient(providerFor(auth, ctx));
+	}
+	enqueue(input) {
+		return this.#ops.enqueue(input);
+	}
+	receive(input = {}) {
+		return this.#ops.receive(input);
+	}
+	acknowledge(input) {
+		return this.#ops.acknowledge(input);
+	}
+	extendVisibility(input) {
+		return this.#ops.extendVisibility(input);
+	}
+};
+//#endregion
+//#region src/modules/queue/module.ts
+const queueEnqueueTool = defineTool({
+	id: "queue-enqueue",
+	name: "enqueueMessage",
+	description: "Enqueue one message on the bound queue, with optional delivery delay and ordering controls when supported.",
+	inputSchema: queueEnqueueInputSchema,
+	outputSchema: queueEnqueueOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => QueueClient.fromContext(ctx).enqueue(input)
+});
+const queueReceiveTool = defineTool({
+	id: "queue-receive",
+	name: "receiveMessages",
+	description: "Receive a bounded batch of messages from the bound queue for processing.",
+	inputSchema: queueReceiveInputSchema,
+	outputSchema: queueReceiveOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => QueueClient.fromContext(ctx).receive(input)
+});
+const queueAcknowledgeTool = defineTool({
+	id: "queue-acknowledge",
+	name: "acknowledgeMessage",
+	description: "Acknowledge a received message after processing succeeds so it can be removed from the bound queue.",
+	inputSchema: queueReceiptInputSchema,
+	outputSchema: queueAcknowledgeOutputSchema,
+	sideEffect: "delete",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => QueueClient.fromContext(ctx).acknowledge(input)
+});
+const queueExtendVisibilityTool = defineTool({
+	id: "queue-extend-visibility",
+	name: "extendMessageVisibility",
+	description: "Change how long a received message remains unavailable to other consumers while work continues.",
+	inputSchema: queueExtendVisibilityInputSchema,
+	outputSchema: queueExtendVisibilityOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => QueueClient.fromContext(ctx).extendVisibility(input)
+});
+const queueModule = defineModule({
+	id: "queue",
+	title: "Queue",
+	description: "Enqueue, receive, acknowledge, and extend visibility for messages through the bound queue provider.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: queueAuthSchema
+	},
+	categories: ["queue", "async"],
+	classification: "standard",
+	tags: ["enqueue", "receive"],
+	tools: [
+		queueEnqueueTool,
+		queueReceiveTool,
+		queueAcknowledgeTool,
+		queueExtendVisibilityTool
+	]
+});
+//#endregion
+export { QueueClient, SqsQueueProvider, queueAcknowledgeOutputSchema, queueAcknowledgeTool, queueAuthSchema, queueEnqueueInputSchema, queueEnqueueOutputSchema, queueEnqueueTool, queueExtendVisibilityInputSchema, queueExtendVisibilityOutputSchema, queueExtendVisibilityTool, queueMessageSchema, queueModule, queueReceiptInputSchema, queueReceiveInputSchema, queueReceiveOutputSchema, queueReceiveTool, sqsQueueAuthSchema };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#client","#ops"],"sources":["../../../src/modules/queue/contracts.ts","../../../src/modules/queue/providers/sqs.ts","../../../src/modules/queue/client.ts","../../../src/modules/queue/module.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport {\n\tqueueAcknowledgeOutputSchema,\n\tqueueEnqueueInputSchema,\n\tqueueEnqueueOutputSchema,\n\tqueueExtendVisibilityInputSchema,\n\tqueueExtendVisibilityOutputSchema,\n\tqueueMessageSchema,\n\tqueueReceiptInputSchema,\n\tqueueReceiveInputSchema,\n\tqueueReceiveOutputSchema,\n\tsqsAuthSchema\n} from '../../vendors/sqs'\nimport type { QueueOps } from '../../vendors/sqs'\n\nexport {\n\tqueueAcknowledgeOutputSchema,\n\tqueueEnqueueInputSchema,\n\tqueueEnqueueOutputSchema,\n\tqueueExtendVisibilityInputSchema,\n\tqueueExtendVisibilityOutputSchema,\n\tqueueMessageSchema,\n\tqueueReceiptInputSchema,\n\tqueueReceiveInputSchema,\n\tqueueReceiveOutputSchema\n}\nexport type {\n\tQueueAcknowledgeOutput,\n\tQueueEnqueueInput,\n\tQueueEnqueueOutput,\n\tQueueExtendVisibilityInput,\n\tQueueExtendVisibilityOutput,\n\tQueueMessage,\n\tQueueOps,\n\tQueueReceiptInput,\n\tQueueReceiveInput,\n\tQueueReceiveOutput\n} from '../../vendors/sqs'\n\nexport const sqsQueueAuthSchema = sqsAuthSchema.extend({\n\tprovider: z.literal('sqs')\n})\n\nexport const queueAuthSchema = sqsQueueAuthSchema\n\nexport type SqsQueueAuth = z.infer<typeof sqsQueueAuthSchema>\nexport type QueueAuth = z.infer<typeof queueAuthSchema>\n\nexport type QueueSeamOps = QueueOps\n","import { SqsClient } from '../../../vendors/sqs'\nimport type { SqsClientOptions } from '../../../vendors/sqs'\nimport type {\n\tQueueEnqueueInput,\n\tQueueExtendVisibilityInput,\n\tQueueReceiptInput,\n\tQueueReceiveInput,\n\tQueueSeamOps,\n\tSqsQueueAuth\n} from '../contracts'\n\nexport type SqsQueueProviderOptions = SqsClientOptions\n\nexport class SqsQueueProvider implements QueueSeamOps {\n\treadonly #client: SqsClient\n\n\tconstructor(auth: SqsQueueAuth, options: SqsQueueProviderOptions = {}) {\n\t\tconst { provider: _provider, ...vendorAuth } = auth\n\t\tthis.#client = new SqsClient(vendorAuth, options)\n\t}\n\n\tenqueue(input: QueueEnqueueInput) {\n\t\treturn this.#client.enqueue(input)\n\t}\n\n\treceive(input: QueueReceiveInput = {}) {\n\t\treturn this.#client.receive(input)\n\t}\n\n\tacknowledge(input: QueueReceiptInput) {\n\t\treturn this.#client.acknowledge(input)\n\t}\n\n\textendVisibility(input: QueueExtendVisibilityInput) {\n\t\treturn this.#client.extendVisibility(input)\n\t}\n}\n","import { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tQueueAuth,\n\tQueueEnqueueInput,\n\tQueueExtendVisibilityInput,\n\tQueueReceiptInput,\n\tQueueReceiveInput,\n\tQueueSeamOps\n} from './contracts'\nimport { queueAuthSchema } from './contracts'\nimport { SqsQueueProvider } from './providers/sqs'\n\nfunction providerFor(auth: QueueAuth, ctx: ToolContext): QueueSeamOps {\n\tswitch (auth.provider) {\n\t\tcase 'sqs':\n\t\t\treturn new SqsQueueProvider(auth, {\n\t\t\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t\t\t...(ctx.signal && { signal: ctx.signal })\n\t\t\t})\n\t}\n}\n\nexport class QueueClient implements QueueSeamOps {\n\treadonly #ops: QueueSeamOps\n\n\tconstructor(ops: QueueSeamOps) {\n\t\tthis.#ops = ops\n\t}\n\n\tstatic fromContext(ctx: ToolContext): QueueClient {\n\t\treturn new QueueClient(providerFor(requireAuth(ctx, queueAuthSchema), ctx))\n\t}\n\n\tstatic fromAuth(auth: QueueAuth, ctx: ToolContext = {}): QueueClient {\n\t\treturn new QueueClient(providerFor(auth, ctx))\n\t}\n\n\tenqueue(input: QueueEnqueueInput) {\n\t\treturn this.#ops.enqueue(input)\n\t}\n\n\treceive(input: QueueReceiveInput = {}) {\n\t\treturn this.#ops.receive(input)\n\t}\n\n\tacknowledge(input: QueueReceiptInput) {\n\t\treturn this.#ops.acknowledge(input)\n\t}\n\n\textendVisibility(input: QueueExtendVisibilityInput) {\n\t\treturn this.#ops.extendVisibility(input)\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { QueueClient } from './client'\nimport {\n\tqueueAcknowledgeOutputSchema,\n\tqueueAuthSchema,\n\tqueueEnqueueInputSchema,\n\tqueueEnqueueOutputSchema,\n\tqueueExtendVisibilityInputSchema,\n\tqueueExtendVisibilityOutputSchema,\n\tqueueReceiptInputSchema,\n\tqueueReceiveInputSchema,\n\tqueueReceiveOutputSchema\n} from './contracts'\n\nexport const queueEnqueueTool = defineTool({\n\tid: 'queue-enqueue',\n\tname: 'enqueueMessage',\n\tdescription:\n\t\t'Enqueue one message on the bound queue, with optional delivery delay and ordering controls when supported.',\n\tinputSchema: queueEnqueueInputSchema,\n\toutputSchema: queueEnqueueOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\tnetwork: true,\n\texecute: async (input, ctx) => QueueClient.fromContext(ctx).enqueue(input)\n})\n\nexport const queueReceiveTool = defineTool({\n\tid: 'queue-receive',\n\tname: 'receiveMessages',\n\tdescription: 'Receive a bounded batch of messages from the bound queue for processing.',\n\tinputSchema: queueReceiveInputSchema,\n\toutputSchema: queueReceiveOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\tnetwork: true,\n\texecute: async (input, ctx) => QueueClient.fromContext(ctx).receive(input)\n})\n\nexport const queueAcknowledgeTool = defineTool({\n\tid: 'queue-acknowledge',\n\tname: 'acknowledgeMessage',\n\tdescription: 'Acknowledge a received message after processing succeeds so it can be removed from the bound queue.',\n\tinputSchema: queueReceiptInputSchema,\n\toutputSchema: queueAcknowledgeOutputSchema,\n\tsideEffect: 'delete',\n\truntime: 'both',\n\tnetwork: true,\n\texecute: async (input, ctx) => QueueClient.fromContext(ctx).acknowledge(input)\n})\n\nexport const queueExtendVisibilityTool = defineTool({\n\tid: 'queue-extend-visibility',\n\tname: 'extendMessageVisibility',\n\tdescription: 'Change how long a received message remains unavailable to other consumers while work continues.',\n\tinputSchema: queueExtendVisibilityInputSchema,\n\toutputSchema: queueExtendVisibilityOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\tnetwork: true,\n\texecute: async (input, ctx) => QueueClient.fromContext(ctx).extendVisibility(input)\n})\n\nexport const queueModule = defineModule({\n\tid: 'queue',\n\ttitle: 'Queue',\n\tdescription: 'Enqueue, receive, acknowledge, and extend visibility for messages through the bound queue provider.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: queueAuthSchema },\n\tcategories: ['queue', 'async'],\n\tclassification: 'standard',\n\ttags: ['enqueue', 'receive'],\n\ttools: [queueEnqueueTool, queueReceiveTool, queueAcknowledgeTool, queueExtendVisibilityTool]\n})\n"],"mappings":"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"}

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

@@ -0,0 +1,250 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { s as HttpServiceOptions } from "../../http-service-T7E5UjP8.js";
+import "../../index-CCivzmxO.js";
+import { z } from "zod";
+//#region src/modules/rag/contracts.d.ts
+declare const DEFAULT_CHUNK_MAX_CHARS = 1200;
+declare const DEFAULT_CHUNK_OVERLAP = 200;
+declare const MAX_CHUNK_MAX_CHARS = 8000;
+declare const MAX_INGEST_CHARS = 500000;
+declare const MAX_EMBED_BATCH = 32;
+declare const embedAuthSchema: z.ZodObject<{
+  base_url: z.ZodString;
+  api_key: z.ZodOptional<z.ZodString>;
+  model: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
+  dimensions: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ragAuthSchema: z.ZodObject<{
+  vector_store: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    base_url: z.ZodString;
+    api_key: z.ZodOptional<z.ZodString>;
+    default_collection: z.ZodOptional<z.ZodString>;
+    default_filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    provider: z.ZodLiteral<"qdrant">;
+  }, z.core.$strip>, z.ZodObject<{
+    api_key: z.ZodString;
+    base_url: z.ZodString;
+    default_namespace: z.ZodOptional<z.ZodString>;
+    default_filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    provider: z.ZodLiteral<"pinecone">;
+  }, z.core.$strip>, z.ZodObject<{
+    url: z.ZodString;
+    api_key: z.ZodString;
+    default_collection: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    id_column: z.ZodOptional<z.ZodString>;
+    embedding_column: z.ZodOptional<z.ZodString>;
+    metadata_column: z.ZodOptional<z.ZodString>;
+    match_rpc: z.ZodOptional<z.ZodString>;
+    default_filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    provider: z.ZodLiteral<"supabase">;
+  }, z.core.$strip>, z.ZodObject<{
+    connection_string: z.ZodString;
+    id: z.ZodString;
+    schema_name: z.ZodOptional<z.ZodString>;
+    default_index: z.ZodOptional<z.ZodString>;
+    dimension: z.ZodOptional<z.ZodNumber>;
+    auto_create_index: z.ZodOptional<z.ZodBoolean>;
+    disable_init: z.ZodOptional<z.ZodBoolean>;
+    default_filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    provider: z.ZodLiteral<"mastra">;
+  }, z.core.$strip>], "provider">;
+  embed: z.ZodObject<{
+    base_url: z.ZodString;
+    api_key: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    dimensions: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  default_collection: z.ZodOptional<z.ZodString>;
+  chunk: z.ZodOptional<z.ZodObject<{
+    max_chars: z.ZodOptional<z.ZodNumber>;
+    overlap: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ragIngestInputSchema: z.ZodObject<{
+  document_id: z.ZodString;
+  text: z.ZodString;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+  collection: z.ZodOptional<z.ZodString>;
+  namespace: z.ZodOptional<z.ZodString>;
+  chunk: z.ZodOptional<z.ZodObject<{
+    max_chars: z.ZodOptional<z.ZodNumber>;
+    overlap: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ragIngestOutputSchema: z.ZodObject<{
+  document_id: z.ZodString;
+  chunk_count: z.ZodNumber;
+  chunk_ids: z.ZodArray<z.ZodString>;
+  collection: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ragRetrieveInputSchema: z.ZodObject<{
+  query: z.ZodString;
+  top_k: z.ZodOptional<z.ZodNumber>;
+  collection: z.ZodOptional<z.ZodString>;
+  namespace: z.ZodOptional<z.ZodString>;
+  filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const ragRetrievedChunkSchema: z.ZodObject<{
+  id: z.ZodString;
+  score: z.ZodNumber;
+  text: z.ZodOptional<z.ZodString>;
+  document_id: z.ZodOptional<z.ZodString>;
+  chunk_index: z.ZodOptional<z.ZodNumber>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strip>;
+declare const ragRetrieveOutputSchema: z.ZodObject<{
+  matches: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    score: z.ZodNumber;
+    text: z.ZodOptional<z.ZodString>;
+    document_id: z.ZodOptional<z.ZodString>;
+    chunk_index: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+  }, z.core.$strip>>;
+  collection: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ragDeleteInputSchema: z.ZodObject<{
+  chunk_ids: z.ZodArray<z.ZodString>;
+  collection: z.ZodOptional<z.ZodString>;
+  namespace: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ragDeleteOutputSchema: z.ZodObject<{
+  deleted: z.ZodNumber;
+  collection: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type EmbedAuth = z.infer<typeof embedAuthSchema>;
+type RagAuth = z.infer<typeof ragAuthSchema>;
+type RagIngestInput = z.infer<typeof ragIngestInputSchema>;
+type RagIngestOutput = z.infer<typeof ragIngestOutputSchema>;
+type RagRetrieveInput = z.infer<typeof ragRetrieveInputSchema>;
+type RagRetrieveOutput = z.infer<typeof ragRetrieveOutputSchema>;
+type RagDeleteInput = z.infer<typeof ragDeleteInputSchema>;
+type RagDeleteOutput = z.infer<typeof ragDeleteOutputSchema>;
+//#endregion
+//#region src/modules/rag/client.d.ts
+type RagClientOptions = {
+  fetch?: HttpServiceOptions['fetch'] | undefined;
+  signal?: HttpServiceOptions['signal'] | undefined;
+};
+declare class RagClient {
+  #private;
+  constructor(auth: RagAuth, options?: RagClientOptions);
+  static fromContext(ctx: ToolContext): RagClient;
+  static fromAuth(auth: RagAuth, options?: RagClientOptions): RagClient;
+  ingest(input: RagIngestInput): Promise<RagIngestOutput>;
+  retrieve(input: RagRetrieveInput): Promise<RagRetrieveOutput>;
+  delete(input: RagDeleteInput): Promise<RagDeleteOutput>;
+}
+//#endregion
+//#region src/modules/rag/domain.d.ts
+/**
+ * Pure RAG helpers: text chunking (no HTTP).
+ */
+type ChunkOptions = {
+  max_chars?: number | undefined;
+  overlap?: number | undefined;
+};
+/**
+ * Split text into overlapping character windows.
+ * Prefers paragraph then newline boundaries when a soft break exists near the end of a window.
+ */
+declare function chunkText(text: string, options?: ChunkOptions): string[];
+declare function chunkId(documentId: string, index: number): string;
+//#endregion
+//#region src/modules/rag/module.d.ts
+declare const ragIngestTool: ToolDefinition<{
+  document_id: string;
+  text: string;
+  metadata?: Record<string, string | number | boolean | null> | undefined;
+  collection?: string | undefined;
+  namespace?: string | undefined;
+  chunk?: {
+    max_chars?: number | undefined;
+    overlap?: number | undefined;
+  } | undefined;
+}, {
+  document_id: string;
+  chunk_count: number;
+  chunk_ids: string[];
+  collection?: string | undefined;
+}>;
+declare const ragRetrieveTool: ToolDefinition<{
+  query: string;
+  top_k?: number | undefined;
+  collection?: string | undefined;
+  namespace?: string | undefined;
+  filter?: Record<string, unknown> | undefined;
+}, {
+  matches: {
+    id: string;
+    score: number;
+    text?: string | undefined;
+    document_id?: string | undefined;
+    chunk_index?: number | undefined;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+  }[];
+  collection?: string | undefined;
+}>;
+declare const ragDeleteTool: ToolDefinition<{
+  chunk_ids: string[];
+  collection?: string | undefined;
+  namespace?: string | undefined;
+}, {
+  deleted: number;
+  collection?: string | undefined;
+}>;
+declare const ragModule: ModuleDefinition<{
+  vector_store: {
+    base_url: string;
+    api_key?: string | undefined;
+    default_collection?: string | undefined;
+    default_filter?: Record<string, unknown> | undefined;
+    provider: "qdrant";
+  } | {
+    api_key: string;
+    base_url: string;
+    default_namespace?: string | undefined;
+    default_filter?: Record<string, unknown> | undefined;
+    provider: "pinecone";
+  } | {
+    url: string;
+    api_key: string;
+    default_collection?: string | undefined;
+    schema?: string | undefined;
+    id_column?: string | undefined;
+    embedding_column?: string | undefined;
+    metadata_column?: string | undefined;
+    match_rpc?: string | undefined;
+    default_filter?: Record<string, unknown> | undefined;
+    provider: "supabase";
+  } | {
+    connection_string: string;
+    id: string;
+    schema_name?: string | undefined;
+    default_index?: string | undefined;
+    dimension?: number | undefined;
+    auto_create_index?: boolean | undefined;
+    disable_init?: boolean | undefined;
+    default_filter?: Record<string, unknown> | undefined;
+    provider: "mastra";
+  };
+  embed: {
+    base_url: string;
+    api_key?: string | undefined;
+    model: string;
+    path?: string | undefined;
+    dimensions?: number | undefined;
+  };
+  default_collection?: string | undefined;
+  chunk?: {
+    max_chars?: number | undefined;
+    overlap?: number | undefined;
+  } | undefined;
+}>;
+//#endregion
+export { type ChunkOptions, DEFAULT_CHUNK_MAX_CHARS, DEFAULT_CHUNK_OVERLAP, type EmbedAuth, MAX_CHUNK_MAX_CHARS, MAX_EMBED_BATCH, MAX_INGEST_CHARS, type RagAuth, RagClient, type RagClientOptions, type RagDeleteInput, type RagDeleteOutput, type RagIngestInput, type RagIngestOutput, type RagRetrieveInput, type RagRetrieveOutput, chunkId, chunkText, embedAuthSchema, ragAuthSchema, ragDeleteInputSchema, ragDeleteOutputSchema, ragDeleteTool, ragIngestInputSchema, ragIngestOutputSchema, ragIngestTool, ragModule, ragRetrieveInputSchema, ragRetrieveOutputSchema, ragRetrieveTool, ragRetrievedChunkSchema };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/rag/contracts.ts","../../../src/modules/rag/client.ts","../../../src/modules/rag/domain.ts","../../../src/modules/rag/module.ts"],"mappings":";;;;;;cAca;cACA;cACA;cACA;cACA;cAEA,iBAAe,EAAA;;;;;;GAW1B,EAAA,KAAA;cAmBW,eAAa,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAcxB,EAAA,KAAA;cAEW,sBAAoB,EAAA;;;;;;;;;;GAW/B,EAAA,KAAA;cAEW,uBAAqB,EAAA;;;;;GAKhC,EAAA,KAAA;cAEW,wBAAsB,EAAA;;;;;;GAMjC,EAAA,KAAA;cAEW,yBAAuB,EAAA;;;;;;;GAOlC,EAAA,KAAA;cAEW,yBAAuB,EAAA;;;;;;;;;;GAGlC,EAAA,KAAA;cAEW,sBAAoB,EAAA;;;;GAQ/B,EAAA,KAAA;cAEW,uBAAqB,EAAA;;;GAGhC,EAAA,KAAA;KAEU,YAAY,EAAE,aAAa;KAC3B,UAAU,EAAE,aAAa;KACzB,iBAAiB,EAAE,aAAa;KAChC,kBAAkB,EAAE,aAAa;KACjC,mBAAmB,EAAE,aAAa;KAClC,oBAAoB,EAAE,aAAa;KACnC,iBAAiB,EAAE,aAAa;KAChC,kBAAkB,EAAE,aAAa;;;KCxGjC;EACX,QAAQ;EACR,SAAS;;cAGG;;EAOZ,YAAY,MAAM,SAAS,UAAS;SAyB7B,YAAY,KAAK,cAAc;SAQ/B,SAAS,MAAM,SAAS,UAAS,mBAAwB;EAI1D,OAAO,OAAO,iBAAiB,QAAQ;EA0DvC,SAAS,OAAO,mBAAmB,QAAQ;EA4C3C,OAAO,OAAO,iBAAiB,QAAQ;;;;;;;KC3KlC;EACX;EACA;;;;;;iBAOe,UAAU,cAAc,UAAS;iBA6BjC,QAAQ,oBAAoB;;;cC7B/B,eAAA;;;aAAA;;;;;;;;;;;;;cAYA;;;;;;;;;;;;;;;;;cAYA,eAAA;;;;;;;;cAWA"}