@vezham/tamizhi-core 0.0.0-stage → 26.3.1

package/LICENSE

@@ -0,0 +1,173 @@
+SPDX-License-Identifier: BUSL-1.1
+
+Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+---
+
+Parameters
+
+Licensor:             Vezham Technologies Private Limited
+
+Licensed Work:        The source code and packages in this repository (“the Licensed Work”).
+                      The Licensed Work is (c) 2025–present Vezham Technologies Private Limited
+
+Release Tag:          The applicable release tag or commit identifier (for example, “v1.0.0”)
+                      published by the Licensor for this version of the Licensed Work.
+                      Users must cross-check the tag or commit identifier to verify
+                      the release version and applicable Change Date.
+
+Additional Use Grant: 1. You may make non-production use of the Licensed Work.
+
+                      2. You may make production use of the Licensed Work, provided
+                         your use does not include offering the Licensed Work, or any
+                         derivative thereof, to third parties on a hosted, embedded,
+                         or managed basis in order to compete with the Licensor’s
+                         commercial offerings based on the Licensed Work, or offerings
+                         that provide substantially similar functionality.
+
+                         For purposes of this license:
+
+                         A “competitive offering” is a Product that is offered to third
+                         parties on a paid basis, including through paid support,
+                         consulting, managed service arrangements, or similar commercial
+                         relationships, that significantly overlaps with the capabilities
+                         or functionality of the Licensor’s commercial offerings based on
+                         the Licensed Work.
+
+                         If your Product is not a competitive offering when you first
+                         make it generally available, it will not become a competitive
+                         offering solely because the Licensor releases a new version of the
+                         Licensed Work with additional features or capabilities. Products
+                         that are not provided on a paid basis are not competitive offerings.
+
+                         “Product” means any software or service that is (a) offered to end
+                         users for deployment in their own environments (self-managed), or
+                         (b) offered as a hosted, cloud, or managed service by you or on
+                         your behalf.
+
+                         “Embedded” means including the source code or executable code of
+                         the Licensed Work in a competitive offering. “Embedded” also means
+                         packaging or distributing the competitive offering in a way that
+                         requires the Licensed Work to be accessed, invoked, or downloaded
+                         for the competitive offering to function.
+
+                         Hosting or using the Licensed Work internally within your own
+                         organization, including your affiliates under common control,
+                         is not considered a competitive offering.
+
+                      3. Educational institutions and legally recognised non-profit
+                         organizations may use the Licensed Work in a production
+                         environment without restriction, provided such use is not 
+                         for commercial profit.
+
+                      For binding interpretive guidance on using Vezham products under
+                      the Business Source License, please visit our licensing FAQ:
+                      https://trust.vezham.com/legal/license-faq
+
+Change Date:          Four (4) years from the date the Licensed Work is first publicly
+                      released under the specified Release Tag
+
+Change License:       GNU Affero General Public License v3.0 (AGPL-3.0-or-later)
+                      The full text of the Change License is available at:
+                      https://www.gnu.org/licenses/agpl-3.0.html
+
+For information about commercial licensing or alternative arrangements,
+please contact the Licensor at: https://vezham.com
+or email: license@vezham.com
+
+For formal legal notices or IP-related correspondence,
+please contact: licensor@vezham.com
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+For more information on the use of the Business Source License generally,
+please visit the Adopting and Developing Business Source License FAQ at:
+https://mariadb.com/bsl-faq-adopting
+
+---
+
+Business Source License 1.1
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work.
+The Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work, and the Change Date may
+vary for each version of the Licensed Work released by the Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of the
+Licensor or its affiliates (provided that you may use a trademark or logo of
+the Licensor as expressly required by this License).
+
+---
+
+Disclaimer
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+-----------------------------------------------------------------------------
+
+MariaDB hereby grants you permission to use this License’s text to license your
+works, and to refer to it using the trademark "Business Source License", as long
+as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 3.0 or any later version,
+   or a license that is compatible with GPL Version 3.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 3.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# TypeScript runtime prototype
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This package preserves the earlier Cordis/TanStack AI implementation and its comparison tests. The production Tamizhi backend is now Go in the sibling `vx-be-kit-lab` workspace. Static frontend applications use `@vezham/tamizhi-client` and must not import this package.
+
+See [the Tamizhi package guide](../README.md) for the current integration.
+
+Local example data defaults to `.vezham/tamizhi/data`, relative to the working directory. Set `TAMIZHI_DATA_DIRECTORY` to override it.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/types';
+export * from './lib/runtime';
+export * from './lib/plugins';
+export * from './lib/http';
+export * from './lib/tanstack-provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { createTamizhi } from "./lib/runtime.js";
+import { memoryStoragePlugin, permissionPolicyPlugin, toolPlugin } from "./lib/plugins.js";
+import { httpTransportPlugin } from "./lib/http.js";
+import { openaiCompatiblePlugin, tanstackProviderPlugin } from "./lib/tanstack-provider.js";
+export { createTamizhi, httpTransportPlugin, memoryStoragePlugin, openaiCompatiblePlugin, permissionPolicyPlugin, tanstackProviderPlugin, toolPlugin };

package/dist/lib/http.d.ts

@@ -0,0 +1,9 @@
+import { Principal, TamizhiPlugin } from './types';
+export interface HttpTransportOptions {
+    authenticate: (request: Request) => Principal | null | Promise<Principal | null>;
+    allowedOrigins?: string[];
+    basePath?: string;
+    maxBodyBytes?: number;
+}
+export declare const httpTransportPlugin: (options: HttpTransportOptions) => TamizhiPlugin;
+//# sourceMappingURL=http.d.ts.map

package/dist/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,CACZ,OAAO,EAAE,OAAO,KACb,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IACjD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA4BD,eAAO,MAAM,mBAAmB,GAC9B,SAAS,oBAAoB,KAC5B,aAuHD,CAAA"}

package/dist/lib/http.js

@@ -0,0 +1,120 @@
+import { createLinkedAbortController } from "./linked-abort.js";
+import { approvalDecisionSchema, runRequestSchema } from "@vezham/tamizhi-contracts";
+//#region src/lib/http.ts
+var readJson = async (request, maximum) => {
+	const reader = request.body?.getReader();
+	if (!reader) throw new Error("A JSON body is required");
+	const decoder = new TextDecoder();
+	let size = 0;
+	let text = "";
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			size += value.byteLength;
+			if (size > maximum) {
+				await reader.cancel();
+				throw new Error("Request is too large");
+			}
+			text += decoder.decode(value, { stream: true });
+		}
+		return JSON.parse(text + decoder.decode());
+	} finally {
+		reader.releaseLock();
+	}
+};
+var httpTransportPlugin = (options) => ({
+	name: "transport.http",
+	inject: ["tamizhi"],
+	apply: (context) => {
+		const base = (options.basePath ?? "/api/tamizhi").replace(/\/$/, "");
+		const handler = async (request) => {
+			const origin = request.headers.get("origin");
+			const headers = new Headers({
+				"Cache-Control": "no-store",
+				Vary: "Origin"
+			});
+			const localOrigin = new URL(request.url).origin;
+			if (origin && origin !== localOrigin && !options.allowedOrigins?.includes(origin)) return new Response("Origin is not allowed", { status: 403 });
+			if (origin) {
+				headers.set("Access-Control-Allow-Origin", origin);
+				headers.set("Access-Control-Allow-Credentials", "true");
+			}
+			const json = (value, status = 200) => Response.json(value, {
+				status,
+				headers
+			});
+			if (request.method === "OPTIONS") {
+				headers.set("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+				headers.set("Access-Control-Allow-Headers", "Authorization, Content-Type");
+				return new Response(null, {
+					status: 204,
+					headers
+				});
+			}
+			const principal = await options.authenticate(request);
+			if (!principal?.id) return json({ error: "Authentication is required" }, 401);
+			const path = new URL(request.url).pathname;
+			const host = context.tamizhi.host;
+			if (request.method === "GET" && path === `${base}/models`) return json(host.models());
+			if (request.method === "GET" && path === `${base}/plugins`) return json(host.plugins());
+			if (request.method === "GET" && path.startsWith(`${base}/conversations/`)) {
+				let id;
+				try {
+					id = decodeURIComponent(path.slice(`${base}/conversations/`.length));
+				} catch {
+					return json({ error: "Invalid conversation id" }, 400);
+				}
+				if (!id || id.length > 128) return json({ error: "Invalid conversation id" }, 400);
+				const conversation = await host.conversation(principal, id);
+				return conversation ? json(conversation) : json({ error: "Conversation not found" }, 404);
+			}
+			if (request.method !== "POST") return json({ error: "Route not found" }, 404);
+			if (path !== `${base}/chat` && path !== `${base}/approvals`) return json({ error: "Route not found" }, 404);
+			try {
+				const body = await readJson(request, options.maxBodyBytes ?? 256e3);
+				if (path === `${base}/approvals`) {
+					const decision = approvalDecisionSchema.parse(body);
+					const accepted = host.approve(principal, decision.runId, decision.callId, decision.approved);
+					return json({ accepted }, accepted ? 200 : 404);
+				}
+				const input = runRequestSchema.parse(body);
+				const { controller, abort, cleanup } = createLinkedAbortController(request.signal);
+				const iterator = host.run(input, principal, controller.signal)[Symbol.asyncIterator]();
+				let pending = await iterator.next();
+				const encoder = new TextEncoder();
+				const stream = new ReadableStream({
+					async pull(output) {
+						try {
+							const next = pending;
+							if (next.done) {
+								output.close();
+								cleanup();
+								return;
+							}
+							output.enqueue(encoder.encode(`data: ${JSON.stringify(next.value)}\n\n`));
+							pending = await iterator.next();
+						} catch (error) {
+							output.error(error);
+							abort();
+							cleanup();
+						}
+					},
+					async cancel() {
+						abort();
+						cleanup();
+						await iterator.return?.();
+					}
+				});
+				headers.set("Content-Type", "text/event-stream; charset=utf-8");
+				headers.set("X-Accel-Buffering", "no");
+				return new Response(stream, { headers });
+			} catch {
+				return json({ error: "Invalid or conflicting chat request" }, 400);
+			}
+		};
+		context.tamizhi.transports.register(context, "http", handler);
+	}
+});
+//#endregion
+export { httpTransportPlugin };

package/dist/lib/linked-abort.d.ts

@@ -0,0 +1,6 @@
+export declare const createLinkedAbortController: (signal: AbortSignal) => {
+    controller: AbortController;
+    abort: () => void;
+    cleanup: () => void;
+};
+//# sourceMappingURL=linked-abort.d.ts.map

package/dist/lib/linked-abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-abort.d.ts","sourceRoot":"","sources":["../../src/lib/linked-abort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,GAAI,QAAQ,WAAW;;;;CAO9D,CAAA"}

package/dist/lib/linked-abort.js

@@ -0,0 +1,15 @@
+//#region src/lib/linked-abort.ts
+var createLinkedAbortController = (signal) => {
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	signal.addEventListener("abort", abort, { once: true });
+	if (signal.aborted) abort();
+	const cleanup = () => signal.removeEventListener("abort", abort);
+	return {
+		controller,
+		abort,
+		cleanup
+	};
+};
+//#endregion
+export { createLinkedAbortController };

package/dist/lib/node.d.ts

@@ -0,0 +1,5 @@
+import { createTamizhi } from './runtime';
+import { TamizhiPlugin } from './types';
+export declare const fileStoragePlugin: (directory: string) => TamizhiPlugin;
+export declare const createTamizhiServer: (runtime: Pick<Awaited<ReturnType<typeof createTamizhi>>, "fetch">) => import('node:http').Server<typeof import('node:http').IncomingMessage, typeof import('node:http').ServerResponse>;
+//# sourceMappingURL=node.d.ts.map

package/dist/lib/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/lib/node.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,aA8CpD,CAAA;AAEF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,sHAmE/D,CAAA"}

package/dist/lib/node.js

@@ -0,0 +1,98 @@
+import { storedConversationSchema, wireMessageSchema } from "@vezham/tamizhi-contracts";
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { join } from "node:path";
+import { Readable } from "node:stream";
+//#region src/lib/node.ts
+var fileStoragePlugin = (directory) => ({
+	name: "storage.file",
+	inject: ["tamizhi"],
+	apply: (context) => {
+		const filename = (owner, id) => join(directory, `${createHash("sha256").update(JSON.stringify([owner, id])).digest("hex")}.json`);
+		context.tamizhi.storage.register(context, "default", {
+			get: async (owner, id) => {
+				try {
+					const item = storedConversationSchema.parse(JSON.parse(await readFile(filename(owner, id), "utf8")));
+					return {
+						...item,
+						messages: item.messages.map((message) => wireMessageSchema.parse(message))
+					};
+				} catch (error) {
+					if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+					throw error;
+				}
+			},
+			put: async (owner, conversation) => {
+				await mkdir(directory, {
+					recursive: true,
+					mode: 448
+				});
+				const target = filename(owner, conversation.id);
+				const temporary = `${target}.${randomUUID()}.tmp`;
+				await writeFile(temporary, JSON.stringify(storedConversationSchema.parse(conversation)), { mode: 384 });
+				await rename(temporary, target);
+			}
+		});
+	}
+});
+var createTamizhiServer = (runtime) => createServer(async (incoming, outgoing) => {
+	const controller = new AbortController();
+	outgoing.on("close", () => {
+		if (!outgoing.writableEnded) controller.abort();
+	});
+	try {
+		const headers = new Headers();
+		for (const [key, value] of Object.entries(incoming.headers)) if (Array.isArray(value)) for (const part of value) headers.append(key, part);
+		else if (value) headers.set(key, value);
+		const init = {
+			method: incoming.method,
+			headers,
+			signal: controller.signal
+		};
+		if (incoming.method !== "GET" && incoming.method !== "HEAD") {
+			init.body = Readable.toWeb(incoming);
+			init.duplex = "half";
+		}
+		const request = new Request(`http://localhost${incoming.url ?? "/"}`, init);
+		const response = await runtime.fetch(request);
+		outgoing.writeHead(response.status, Object.fromEntries(response.headers));
+		if (!response.body) {
+			outgoing.end();
+			return;
+		}
+		const reader = response.body.getReader();
+		try {
+			for (;;) {
+				controller.signal.throwIfAborted();
+				const { done, value } = await reader.read();
+				if (done) break;
+				if (!outgoing.write(value)) await new Promise((resolve, reject) => {
+					const clean = () => {
+						outgoing.off("drain", drained);
+						outgoing.off("close", closed);
+					};
+					const drained = () => {
+						clean();
+						resolve();
+					};
+					const closed = () => {
+						clean();
+						reject(/* @__PURE__ */ new Error("Connection closed"));
+					};
+					outgoing.once("drain", drained);
+					outgoing.once("close", closed);
+				});
+			}
+			outgoing.end();
+		} finally {
+			await reader.cancel().catch(() => void 0);
+			reader.releaseLock();
+		}
+	} catch {
+		if (!outgoing.headersSent) outgoing.writeHead(500, { "Content-Type": "application/json" });
+		outgoing.end(JSON.stringify({ error: "Tamizhi request failed" }));
+	}
+});
+//#endregion
+export { createTamizhiServer, fileStoragePlugin };

package/dist/lib/plugins.d.ts

@@ -0,0 +1,7 @@
+import { TamizhiPlugin, Tool } from './types';
+export declare const memoryStoragePlugin: () => TamizhiPlugin;
+export declare const permissionPolicyPlugin: (options?: {
+    allowFullAccess?: boolean;
+}) => TamizhiPlugin;
+export declare const toolPlugin: (tool: Tool) => TamizhiPlugin;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/lib/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/lib/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,aAAa,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAE7E,eAAO,MAAM,mBAAmB,QAAO,aAgCtC,CAAA;AAED,eAAO,MAAM,sBAAsB,GACjC,UAAS;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,KAC1C,aAaD,CAAA;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,aAItC,CAAA"}

package/dist/lib/plugins.js

@@ -0,0 +1,48 @@
+//#region src/lib/plugins.ts
+var memoryStoragePlugin = () => {
+	const owners = /* @__PURE__ */ new Map();
+	return {
+		name: "storage.memory",
+		inject: ["tamizhi"],
+		apply: (context) => {
+			context.tamizhi.storage.register(context, "default", {
+				get: async (owner, id) => {
+					const value = owners.get(owner)?.get(id);
+					return value ? structuredClone(value) : void 0;
+				},
+				put: async (owner, conversation) => {
+					let records = owners.get(owner);
+					if (!records) {
+						records = /* @__PURE__ */ new Map();
+						owners.set(owner, records);
+					}
+					records.delete(conversation.id);
+					records.set(conversation.id, structuredClone(conversation));
+					if (records.size > 100) {
+						const oldest = records.keys().next().value;
+						if (oldest) records.delete(oldest);
+					}
+				}
+			});
+			context.effect(() => () => owners.clear());
+		}
+	};
+};
+var permissionPolicyPlugin = (options = {}) => ({
+	name: "permissions.default",
+	inject: ["tamizhi"],
+	apply: (context) => {
+		context.tamizhi.permissions.register(context, "default", { evaluate: (mode, tool) => {
+			if (mode === "full" && options.allowFullAccess) return "allow";
+			if (mode === "safe" && tool.risk === "read") return "allow";
+			return "ask";
+		} });
+	}
+});
+var toolPlugin = (tool) => ({
+	name: `tool.${tool.name}`,
+	inject: ["tamizhi"],
+	apply: (context) => context.tamizhi.tools.register(context, tool.name, tool)
+});
+//#endregion
+export { memoryStoragePlugin, permissionPolicyPlugin, toolPlugin };

package/dist/lib/queue.d.ts

@@ -0,0 +1,7 @@
+export declare const createEventQueue: <T extends object>() => {
+    push: (value: T) => void;
+    fail: (error: Error) => void;
+    close: () => void;
+    stream: () => AsyncGenerator<T>;
+};
+//# sourceMappingURL=queue.d.ts.map

package/dist/lib/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/lib/queue.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM;kBAM/B,CAAC;kBAMD,KAAK;;kBAUS,cAAc,CAAC,CAAC,CAAC;CAahD,CAAA"}

package/dist/lib/queue.js

@@ -0,0 +1,38 @@
+//#region src/lib/queue.ts
+var createEventQueue = () => {
+	const values = [];
+	let wake;
+	let ended = false;
+	let failure;
+	return {
+		push: (value) => {
+			if (ended) return;
+			if (values.length >= 4096) throw new Error("Stream consumer is too slow");
+			values.push(value);
+			wake?.();
+		},
+		fail: (error) => {
+			failure = error;
+			ended = true;
+			values.length = 0;
+			wake?.();
+		},
+		close: () => {
+			ended = true;
+			wake?.();
+		},
+		stream: async function* () {
+			while (!ended || values.length || failure) {
+				if (failure) throw failure;
+				if (values.length) {
+					const value = values.shift();
+					if (value) yield value;
+				} else await new Promise((resolve) => {
+					wake = resolve;
+				});
+			}
+		}
+	};
+};
+//#endregion
+export { createEventQueue };

package/dist/lib/registry.d.ts

@@ -0,0 +1,3 @@
+import { Registry } from './types';
+export declare const createRegistry: <T>(onRemove?: () => void) => Registry<T>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,WAAW,MAAM,IAAI,KAAG,QAAQ,CAAC,CAAC,CAgBnE,CAAA"}

package/dist/lib/registry.js

@@ -0,0 +1,20 @@
+//#region src/lib/registry.ts
+var createRegistry = (onRemove) => {
+	const values = /* @__PURE__ */ new Map();
+	return {
+		register: (context, id, value) => {
+			if (values.has(id)) throw new Error(`Duplicate registration: ${id}`);
+			context.effect(() => {
+				values.set(id, value);
+				return () => {
+					values.delete(id);
+					onRemove?.();
+				};
+			});
+		},
+		get: (id) => values.get(id),
+		entries: () => [...values.entries()]
+	};
+};
+//#endregion
+export { createRegistry };

package/dist/lib/runtime.d.ts

@@ -0,0 +1,22 @@
+import { Context } from '@deepseek-ai/cordis';
+import { StreamEvent } from '@vezham/tamizhi-contracts';
+import { TamizhiPlugin } from './types';
+export interface RuntimeOptions {
+    plugins: TamizhiPlugin[];
+    defaultModel?: string;
+    approvalTimeoutMs?: number;
+    runTimeoutMs?: number;
+    maxConcurrentRuns?: number;
+}
+export declare const createTamizhi: (options: RuntimeOptions) => Promise<{
+    context: Context;
+    mount: (plugin: TamizhiPlugin) => Promise<() => Promise<void>>;
+    fetch: (request: Request) => Promise<Response>;
+    dispose: () => Promise<void>;
+    run: (request: import('@vezham/tamizhi-contracts').RunRequest, principal: import('./types').Principal, signal?: AbortSignal) => AsyncIterable<StreamEvent>;
+    approve: (principal: import('./types').Principal, runId: string, callId: string, approved: boolean) => boolean;
+    conversation: (principal: import('./types').Principal, id: string) => Promise<import('./types').StoredConversation | undefined>;
+    models: () => import('@vezham/tamizhi-contracts').ModelInfo[];
+    plugins: () => string[];
+}>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/lib/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE7C,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAK7E,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,aAAa,GAAU,SAAS,cAAc;;oBAuN5B,aAAa;qBA2BvB,OAAO;;iHAzNQ,CAAC;;;;;EAwOpC,CAAA"}

package/dist/lib/runtime.js

@@ -0,0 +1,248 @@
+import { createEventQueue } from "./queue.js";
+import { createRegistry } from "./registry.js";
+import { Context } from "@deepseek-ai/cordis";
+import { runRequestSchema } from "@vezham/tamizhi-contracts";
+//#region src/lib/runtime.ts
+var createTamizhi = async (options) => {
+	const context = new Context();
+	const running = /* @__PURE__ */ new Map();
+	const approvals = /* @__PURE__ */ new Map();
+	let disposed = false;
+	const cancelAll = () => {
+		for (const run of running.values()) run.abort();
+	};
+	const plugins = /* @__PURE__ */ new Map();
+	const services = {
+		providers: createRegistry(cancelAll),
+		tools: createRegistry(cancelAll),
+		storage: createRegistry(cancelAll),
+		permissions: createRegistry(cancelAll),
+		transports: createRegistry()
+	};
+	const host = {
+		conversation: (principal, id) => services.storage.get("default")?.get(principal.id, id) ?? Promise.resolve(void 0),
+		models: () => services.providers.entries().flatMap(([, provider]) => provider.models),
+		plugins: () => [...plugins.keys()],
+		approve: (principal, runId, callId, approved) => {
+			const pending = approvals.get(`${runId}:${callId}`);
+			if (!pending || pending.owner !== principal.id) return false;
+			pending.decide(approved);
+			return true;
+		},
+		run: async function* (input, principal, externalSignal) {
+			if (disposed) throw new Error("Tamizhi runtime has been disposed");
+			const request = runRequestSchema.parse(input);
+			const key = JSON.stringify([principal.id, request.conversationId]);
+			if (running.has(key)) throw new Error("A reply is already running for this conversation");
+			if (running.size >= (options.maxConcurrentRuns ?? 32)) throw new Error("Tamizhi is busy");
+			const controller = new AbortController();
+			const abort = () => controller.abort();
+			externalSignal?.addEventListener("abort", abort, { once: true });
+			if (externalSignal?.aborted) controller.abort();
+			running.set(key, controller);
+			const timeout = setTimeout(abort, options.runTimeoutMs ?? 12e4);
+			const queue = createEventQueue();
+			const identity = {
+				runId: crypto.randomUUID(),
+				conversationId: request.conversationId
+			};
+			const emit = (event) => {
+				queue.push(event);
+				context.parallel("tamizhi/event", event, principal).catch(() => context.logger("tamizhi").warn("An event observer failed"));
+			};
+			const waitForApproval = (approval) => new Promise((resolve, reject) => {
+				const id = `${approval.runId}:${approval.callId}`;
+				let settled = false;
+				const finish = (approved) => {
+					if (settled) return;
+					settled = true;
+					clearTimeout(timer);
+					controller.signal.removeEventListener("abort", canceled);
+					approvals.delete(id);
+					resolve(approved);
+				};
+				const canceled = () => {
+					finish(false);
+					reject(/* @__PURE__ */ new Error("Run canceled"));
+				};
+				const timer = setTimeout(() => finish(false), options.approvalTimeoutMs ?? 6e4);
+				approvals.set(id, {
+					owner: principal.id,
+					decide: finish
+				});
+				controller.signal.addEventListener("abort", canceled, { once: true });
+				if (controller.signal.aborted) canceled();
+				else emit({
+					...identity,
+					type: "approval",
+					...approval
+				});
+			});
+			const produce = async () => {
+				emit({
+					...identity,
+					type: "start"
+				});
+				try {
+					const model = request.model === "Auto" ? options.defaultModel : request.model ?? options.defaultModel;
+					const provider = services.providers.entries().find(([, item]) => !model || item.models.some((info) => info.id === model))?.[1];
+					if (!provider) throw new Error("No provider is configured for this model");
+					const storage = services.storage.get("default");
+					if (!storage) throw new Error("No conversation storage plugin is configured");
+					const policy = services.permissions.get("default");
+					if (!policy) throw new Error("No permission policy plugin is configured");
+					let text = "";
+					const executeTool = async (name, input, callId) => {
+						controller.signal.throwIfAborted();
+						const tool = services.tools.get(name);
+						if (!tool) throw new Error(`Unknown tool: ${name}`);
+						input = await tool.inputSchema.parseAsync(input);
+						emit({
+							...identity,
+							type: "tool",
+							name,
+							input,
+							callId
+						});
+						const decision = policy.evaluate(request.permission, tool, principal);
+						if (decision === "deny" || decision === "ask" && !await waitForApproval({
+							runId: identity.runId,
+							callId,
+							name,
+							input
+						})) {
+							const output = { error: "Tool request was not approved" };
+							emit({
+								...identity,
+								type: "tool-result",
+								name,
+								callId,
+								output
+							});
+							return output;
+						}
+						controller.signal.throwIfAborted();
+						const output = await tool.execute(input, {
+							principal,
+							conversationId: request.conversationId,
+							signal: controller.signal
+						});
+						emit({
+							...identity,
+							type: "tool-result",
+							name,
+							callId,
+							output
+						});
+						return output;
+					};
+					await storage.put(principal.id, {
+						id: request.conversationId,
+						messages: request.messages,
+						updatedAt: Date.now()
+					});
+					try {
+						for await (const delta of provider.stream({
+							...request,
+							model: model ?? provider.models[0]?.id,
+							signal: controller.signal,
+							tools: services.tools.entries().map(([, tool]) => tool),
+							executeTool
+						})) {
+							controller.signal.throwIfAborted();
+							if (text.length + delta.length > 1e5) throw new Error("Response is too large");
+							text += delta;
+							emit({
+								...identity,
+								type: "text",
+								delta
+							});
+						}
+					} finally {
+						if (text) await storage.put(principal.id, {
+							id: request.conversationId,
+							messages: [...request.messages, {
+								role: "assistant",
+								content: text
+							}].slice(-60),
+							updatedAt: Date.now()
+						});
+					}
+					emit({
+						...identity,
+						type: "finish",
+						reason: controller.signal.aborted ? "canceled" : "complete"
+					});
+				} catch (error) {
+					emit(controller.signal.aborted ? {
+						...identity,
+						type: "finish",
+						reason: "canceled"
+					} : {
+						...identity,
+						type: "error",
+						message: error instanceof Error && error.message.startsWith("No ") ? error.message : "The response could not be completed. Please retry."
+					});
+				} finally {
+					clearTimeout(timeout);
+					externalSignal?.removeEventListener("abort", abort);
+					running.delete(key);
+					queue.close();
+				}
+			};
+			const producer = produce().catch(() => {
+				controller.abort();
+				queue.fail(/* @__PURE__ */ new Error("The response stream could not be completed"));
+			});
+			try {
+				yield* queue.stream();
+			} finally {
+				controller.abort();
+				await producer;
+			}
+		}
+	};
+	const foundation = await context.plugin({
+		name: "tamizhi",
+		apply: (scope) => scope.provide("tamizhi", {
+			...services,
+			host
+		})
+	});
+	const mount = async (plugin) => {
+		const name = plugin.name;
+		if (!name) throw new Error("Tamizhi plugins need a name");
+		if (disposed) throw new Error("Tamizhi runtime has been disposed");
+		if (plugins.has(name)) throw new Error(`Duplicate plugin: ${name}`);
+		const fiber = await foundation.ctx.plugin(plugin);
+		plugins.set(name, fiber);
+		return async () => {
+			cancelAll();
+			await fiber.dispose();
+			plugins.delete(name);
+		};
+	};
+	try {
+		await options.plugins.reduce((ready, plugin) => ready.then(() => mount(plugin)), Promise.resolve());
+	} catch (error) {
+		await foundation.dispose();
+		throw error;
+	}
+	return {
+		...host,
+		context,
+		mount,
+		fetch: (request) => {
+			const handler = services.transports.get("http");
+			return handler ? handler(request) : Promise.resolve(new Response("HTTP transport is not installed", { status: 503 }));
+		},
+		dispose: async () => {
+			disposed = true;
+			cancelAll();
+			await foundation.dispose();
+			plugins.clear();
+		}
+	};
+};
+//#endregion
+export { createTamizhi };

package/dist/lib/tanstack-provider.d.ts

@@ -0,0 +1,22 @@
+import { AnyTextAdapter } from '@tanstack/ai';
+import { ModelInfo } from '@vezham/tamizhi-contracts';
+import { TamizhiPlugin } from './types';
+export interface TanStackProviderOptions {
+    id: string;
+    models: ModelInfo[];
+    adapter: (model: string, fast: boolean) => AnyTextAdapter;
+    systemPrompt?: string;
+    maxIterations?: number;
+}
+export declare const tanstackProviderPlugin: (options: TanStackProviderOptions) => TamizhiPlugin;
+export interface OpenAICompatibleOptions {
+    id: string;
+    apiKey: string;
+    baseURL?: string;
+    models: ModelInfo[];
+    systemPrompt?: string;
+    fastModel?: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare const openaiCompatiblePlugin: (options: OpenAICompatibleOptions) => TamizhiPlugin;
+//# sourceMappingURL=tanstack-provider.d.ts.map

package/dist/lib/tanstack-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-provider.d.ts","sourceRoot":"","sources":["../../src/lib/tanstack-provider.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,cAAc,CAAA;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,sBAAsB,GACjC,SAAS,uBAAuB,KAC/B,aA8CD,CAAA;AAEF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,eAAO,MAAM,sBAAsB,GACjC,SAAS,uBAAuB,KAC/B,aAcC,CAAA"}

package/dist/lib/tanstack-provider.js

@@ -0,0 +1,50 @@
+import { createLinkedAbortController } from "./linked-abort.js";
+import { chat, createModel, extendAdapter, maxIterations, toolDefinition } from "@tanstack/ai";
+import { createOpenaiChatCompletions } from "@tanstack/ai-openai";
+//#region src/lib/tanstack-provider.ts
+var tanstackProviderPlugin = (options) => ({
+	name: `provider.${options.id}`,
+	inject: ["tamizhi"],
+	apply: (context) => {
+		context.tamizhi.providers.register(context, options.id, {
+			models: options.models,
+			stream: async function* (request) {
+				const model = request.model ?? options.models[0]?.id;
+				if (!model) throw new Error("No model is configured");
+				const { controller, cleanup } = createLinkedAbortController(request.signal);
+				const tools = request.tools.map((tool) => toolDefinition({
+					name: tool.name,
+					description: tool.description,
+					inputSchema: tool.inputSchema
+				}).server((input, execution) => request.executeTool(tool.name, input, execution?.toolCallId ?? crypto.randomUUID())));
+				try {
+					for await (const event of chat({
+						adapter: options.adapter(model, request.fast),
+						messages: request.messages,
+						systemPrompts: [options.systemPrompt ?? "You are Tamizhi, a helpful assistant. Use tools only when needed."],
+						tools,
+						abortController: controller,
+						agentLoopStrategy: maxIterations(options.maxIterations ?? 8)
+					})) {
+						if (event.type === "TEXT_MESSAGE_CONTENT") yield event.delta;
+						if (event.type === "RUN_ERROR") throw new Error(event.message);
+					}
+				} finally {
+					cleanup();
+				}
+			}
+		});
+	}
+});
+var openaiCompatiblePlugin = (options) => tanstackProviderPlugin({
+	id: options.id,
+	models: options.models,
+	systemPrompt: options.systemPrompt,
+	adapter: (model, fast) => extendAdapter(createOpenaiChatCompletions, options.models.map((item) => createModel(item.id, ["text"])))(fast && options.fastModel ? options.fastModel : model, options.apiKey, {
+		baseURL: options.baseURL,
+		fetch: options.fetch,
+		maxRetries: 0
+	})
+});
+//#endregion
+export { openaiCompatiblePlugin, tanstackProviderPlugin };

package/dist/lib/types.d.ts

@@ -0,0 +1,69 @@
+import { Context, Plugin } from '@deepseek-ai/cordis';
+import { ZodType } from 'zod';
+import { ModelInfo, PermissionMode, RunRequest, StreamEvent, WireMessage } from '@vezham/tamizhi-contracts';
+export type TamizhiPlugin = Plugin.Object<void>;
+export interface Registry<T> {
+    register: (context: Context, id: string, value: T) => void;
+    get: (id: string) => T | undefined;
+    entries: () => [string, T][];
+}
+export interface Principal {
+    id: string;
+}
+export interface ToolContext {
+    principal: Principal;
+    conversationId: string;
+    signal: AbortSignal;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    risk: 'read' | 'write' | 'external';
+    inputSchema: ZodType;
+    execute: (input: unknown, context: ToolContext) => Promise<unknown>;
+}
+export interface ProviderRequest extends RunRequest {
+    signal: AbortSignal;
+    executeTool: (name: string, input: unknown, callId: string) => Promise<unknown>;
+    tools: Tool[];
+}
+export interface Provider {
+    models: ModelInfo[];
+    stream: (request: ProviderRequest) => AsyncIterable<string>;
+}
+export interface StoredConversation {
+    id: string;
+    messages: WireMessage[];
+    updatedAt: number;
+}
+export interface Storage {
+    get: (owner: string, id: string) => Promise<StoredConversation | undefined>;
+    put: (owner: string, conversation: StoredConversation) => Promise<void>;
+}
+export interface PermissionPolicy {
+    evaluate: (mode: PermissionMode, tool: Tool, principal: Principal) => 'allow' | 'ask' | 'deny';
+}
+export interface Host {
+    run: (request: RunRequest, principal: Principal, signal?: AbortSignal) => AsyncIterable<StreamEvent>;
+    approve: (principal: Principal, runId: string, callId: string, approved: boolean) => boolean;
+    conversation: (principal: Principal, id: string) => Promise<StoredConversation | undefined>;
+    models: () => ModelInfo[];
+    plugins: () => string[];
+}
+export interface TamizhiServices {
+    providers: Registry<Provider>;
+    tools: Registry<Tool>;
+    storage: Registry<Storage>;
+    permissions: Registry<PermissionPolicy>;
+    transports: Registry<(request: Request) => Promise<Response>>;
+    host: Host;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        tamizhi: TamizhiServices;
+    }
+    interface Events {
+        'tamizhi/event': (event: StreamEvent, principal: Principal) => void;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@vezham/tamizhi-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "26.3.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vezham/vx-fe-pkgs.git",
+    "directory": "packages/tamizhi/core"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "@vx/fe-kit": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./node": {
+      "@vx/fe-kit": "./src/lib/node.ts",
+      "types": "./dist/lib/node.d.ts",
+      "import": "./dist/lib/node.js",
+      "default": "./dist/lib/node.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "!**/*.tsbuildinfo",
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@tanstack/ai": "0.71.0",
+    "@tanstack/ai-openai": "0.31.0",
+    "@vezham/tamizhi-contracts": "26.3.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@vezham/tamizhi-client": "26.3.1"
+  }
 }