@vezham/tamizhi-client 0.0.0-stage → 26.3.2

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,107 @@
-# Temporary Holding Version
+# Tamizhi client and local companion
 
-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.
+The standalone and embedded chat share this client. It connects to the Go
+companion over loopback HTTP/SSE and exposes `createTamizhiConnection` for
+TanStack AI. The normal Tamizhi UI uses `runTamizhiChat`, which lets TanStack
+assemble live messages while preserving the existing durable history, profiles,
+approvals, tools and sources. Go owns the only agent loop.
+
+## Start locally
+
+In the Go backend checkout:
+
+```sh
+pnpm exec nx run tamizhi-api:build
+./dist/tamizhi serve
+```
+
+Open **Connect companion** beside the composer in standalone or embed and click
+**Connect**. The browser supplies its current origin. For an unknown origin,
+compare the verification code and origin shown in the UI with the CLI prompt,
+then enter `y` to approve and remember it, or `n`/Enter to reject. No terminal
+input means rejection. `--origin` is optional preapproval, not a required UI flag.
+
+Approved origins are saved in owner-only `~/.vezham/tamizhi/allowed-origins.json`
+(or the selected `--data-dir`). Connections expire after five minutes; closing
+or cancelling the modal cancels its request. Reloading the UI or restarting the
+CLI requires clicking **Connect** again, but remembered origins do not prompt.
+The verification code is for comparison, not something to copy into an input.
+
+The default endpoint is `http://127.0.0.1:7331/api/tamizhi`. Hosted apps require
+HTTPS and may need browser local-network permission; localhost connects directly.
+HTTP `*.vezham.local` apps use the shared Vite development relay. After pairing,
+**AI settings** beside the connection control configures BYOK providers. Leo is the default built-in tool-workflow assistant and requires no model-provider
+key. Optional BYOK models provide broader reasoning and language generation. No extension or hosted
+Tamizhi service is required for local research.
+
+CLI clients use the same runtime:
+
+```sh
+./dist/tamizhi status
+./dist/tamizhi chat --permission safe 'What is the latest React version?'
+./dist/tamizhi chat --permission safe --json 'What is the latest React version?'
+```
+
+The default permission mode is `ask`; terminal approvals read `y`/`N` from stdin.
+`--json` emits structured stream events, and human progress/prompts go to stderr.
+Ctrl+C stops the active request and attempts to cancel its backend run. `serve`,
+`pair`, `status` and `chat` accept `--data-dir` and `--listen` as applicable; see
+`./dist/tamizhi <command> --help`. State defaults to `~/.vezham/tamizhi/`:
+SQLite conversations, an encryption key, and an owner-only CLI token. No Neon
+setup is needed for local mode. `tamizhi api --config path` retains configured
+hosted API/OIDC/Neon operation when wanted.
+
+## Connection boundaries
+
+- The service binds only to loopback. Only the bounded connection handshake is
+  exposed to an unknown origin; all normal API requests require a trusted origin
+  and authentication. Approval is saved before granting access.
+- Connection capabilities are one-use, origin-bound and expire after five minutes.
+  UI sessions expire
+  after eight hours, on explicit disconnect, or when the companion restarts.
+- UI bearer credentials stay in memory; the endpoint preference alone uses
+  localStorage. A reload requires re-pairing. CLI secrets never enter UI code.
+- The browser grants local-network access; CORS and that permission are separate.
+- If the companion is stopped or pairing expires, restart/re-pair through the
+  visible connection control. The local demo remains available when disconnected.
+- The public web connector reads server-rendered HTML/plain text, with SSRF,
+  byte/source/operation/time limits. It does not use your browser login or render
+  JavaScript. CAPTCHA, blocked sites and search-provider errors return failures.
+
+## TanStack integration
+
+`createTamizhiConnection(client, options)` returns a TanStack
+`ConnectConnectionAdapter`, usable as the `connection` for `useChat` or a headless
+`ChatClient`. It maps Go start/text/tool/result/finish/error events into AG-UI.
+Tamizhi-specific progress, approval and source events remain available through
+`onEvent`. Pairing/authentication and provider secrets belong to the companion;
+this adapter does not implement TanStack's separate provider-key forwarding flow.
+
+The existing low-level `createTamizhiClient` still owns authenticated requests,
+strict event validation, sequence deduplication and reconnect/replay. Aborting a
+TanStack request aborts its transport. The shared UI and CLI additionally cancel
+the active Go run explicitly. Both standalone and embed retain HeroUI components.
+
+## Verify
+
+```sh
+pnpm exec nx run-many -t test,typecheck,lint -p tamizhi-client,tamizhi-contracts,tamizhi-ui
+TAMIZHI_BACKEND_DIR=/path/to/vx-be-kit-lab pnpm exec nx run tamizhi-client:companion-test
+```
+
+The end-to-end fixture uses a real compiled CLI, pairing, Go HTTP/SSE, TanStack
+and Chromium with isolated temporary state. Inference and retrieved sites are
+controlled fixtures. It checks streamed answer/source delivery, CLI chat, and
+connection replay rejection, terminal approve/reject, and saved-origin reconnect
+after a real CLI restart. Live search/provider quality requires separate BYOK
+verification; these tests consume no real provider quota.
+
+HTTP `*.vezham.local` development apps can use the shared Vite app preset's
+local relay with the default companion URL. Restart the dev server once after
+this preset update. The relay preserves the app's origin for CLI approval and
+authenticated requests. The relay is development-only;
+production and preview still require HTTPS or localhost for direct connections.
+
+Leo is advertised by the normal model catalog as `leo/default`. The same TanStack
+adapter streams its responses and tool events. It uses Go workflow planners and
+tool results, with no separate frontend mock or second execution loop.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './lib/client';
+export * from './lib/stream';
+export * from './lib/connection';
+export * from './lib/companion';
+export * from './lib/companion-transport';
+export * from './lib/companion-connect';
+//# 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,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAE5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,2BAA2B,CAAA;AAEzC,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import { readEventStream } from "./lib/stream.js";
+import { createTamizhiClient } from "./lib/client.js";
+import { createTamizhiConnection, runTamizhiChat } from "./lib/connection.js";
+import { DEFAULT_COMPANION_URL, companionURL } from "./lib/companion.js";
+import { companionTransport } from "./lib/companion-transport.js";
+import { connectCompanion } from "./lib/companion-connect.js";
+export { DEFAULT_COMPANION_URL, companionTransport, companionURL, connectCompanion, createTamizhiClient, createTamizhiConnection, readEventStream, runTamizhiChat };

package/dist/lib/client.d.ts

@@ -0,0 +1,51 @@
+import type { ApprovalDecision, ModelInfo, RunRequest, StreamEvent, TamizhiAPI } from '@vezham/tamizhi-contracts';
+export interface TamizhiClient {
+    stream: (request: RunRequest, signal?: AbortSignal) => AsyncIterable<StreamEvent>;
+    conversation: (id: string, signal?: AbortSignal) => Promise<import('@vezham/tamizhi-contracts').StoredConversationData>;
+    models: (signal?: AbortSignal) => Promise<ModelInfo[]>;
+    subscribeProviderChanges?: (listener: () => void) => () => void;
+    api?: TamizhiAPIClient;
+    approve: (decision: ApprovalDecision, signal?: AbortSignal) => Promise<void>;
+}
+export interface TamizhiAPIClient {
+    authorizeProvider: (id: string, projectId: string, returnTo: string) => Promise<TamizhiAPI.ProviderAuthorization>;
+    providers: (signal?: AbortSignal) => Promise<TamizhiAPI.ProviderSettings[]>;
+    connectProvider: (id: string, apiKey: string, signal?: AbortSignal) => Promise<TamizhiAPI.ProviderSettings>;
+    setProviderSearch: (id: string, enabled: boolean) => Promise<TamizhiAPI.ProviderSettings>;
+    removeProvider: (id: string) => Promise<void>;
+    capabilities: (signal?: AbortSignal) => Promise<TamizhiAPI.Capabilities>;
+    session: (signal?: AbortSignal) => Promise<TamizhiAPI.SessionInfo>;
+    authSession: (signal?: AbortSignal) => Promise<TamizhiAPI.AuthSession>;
+    getLoginURL: (returnTo?: string, connection?: string) => string;
+    loginURL: string;
+    logout: () => Promise<void>;
+    conversations: (query?: string, cursor?: string, signal?: AbortSignal) => Promise<TamizhiAPI.ConversationPage>;
+    rename: (id: string, title: string) => Promise<TamizhiAPI.Conversation>;
+    deleteConversation: (id: string) => Promise<void>;
+    feedback: (id: string, message: string, rating: string) => Promise<TamizhiAPI.Conversation>;
+    tasks: (id: string, message: string, tasks: TamizhiAPI.Task[]) => Promise<TamizhiAPI.Conversation>;
+    branch: (id: string, messageId: string) => Promise<TamizhiAPI.Conversation>;
+    checkpoints: (id: string) => Promise<TamizhiAPI.Checkpoint[]>;
+    checkpoint: (id: string, label: string) => Promise<TamizhiAPI.Checkpoint>;
+    restore: (id: string, checkpoint: string) => Promise<TamizhiAPI.Conversation>;
+    compact: (id: string) => Promise<TamizhiAPI.Conversation>;
+    upload: (file: File, signal?: AbortSignal) => Promise<TamizhiAPI.Attachment>;
+    transcribe: (file: File, signal?: AbortSignal) => Promise<TamizhiAPI.Transcript>;
+    speech: (text: string, signal?: AbortSignal) => Promise<Blob>;
+    memory: (query?: string) => Promise<TamizhiAPI.Memory[]>;
+    remember: (text: string, tags?: string[]) => Promise<TamizhiAPI.Memory>;
+    forget: (id: string) => Promise<void>;
+    plugins: () => Promise<TamizhiAPI.PluginInfo[]>;
+    setPlugin: (name: string, enabled: boolean) => Promise<TamizhiAPI.PluginInfo[]>;
+    run: (id: string, signal?: AbortSignal) => Promise<TamizhiAPI.RunInfo>;
+    cancel: (id: string) => Promise<void>;
+    replay: (id: string, after?: number, signal?: AbortSignal) => AsyncIterable<StreamEvent>;
+}
+export interface ClientOptions {
+    baseURL: string;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    credentials?: RequestCredentials;
+    fetch?: typeof globalThis.fetch;
+}
+export declare const createTamizhiClient: (options: ClientOptions) => TamizhiClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,EACX,MAAM,2BAA2B,CAAA;AAIlC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CACN,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,WAAW,KACjB,aAAa,CAAC,WAAW,CAAC,CAAA;IAC/B,YAAY,EAAE,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,OAAO,2BAA2B,EAAE,sBAAsB,CAAC,CAAA;IACxE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACtD,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IAC/D,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7E;AACD,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAA;IAC9C,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAC3E,eAAe,EAAE,CACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACzC,iBAAiB,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACzC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IACxE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IAClE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IACtE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,aAAa,EAAE,CACb,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACzC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IACvE,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,QAAQ,EAAE,CACR,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IACrC,KAAK,EAAE,CACL,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,KACrB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IACrC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IAC3E,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAA;IAC7D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IACzE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IAC7E,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IACzD,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IAC5E,UAAU,EAAE,CACV,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IACnC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IACvE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAA;IAC/C,SAAS,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAA;IACrC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACtE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,KACjB,aAAa,CAAC,WAAW,CAAC,CAAA;CAChC;AACD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;IAClE,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS,aAAa,KAAG,aAkP5D,CAAA"}

package/dist/lib/client.js

@@ -0,0 +1,185 @@
+import { readEventStream } from "./stream.js";
+import { approvalDecisionSchema, modelInfoSchema, runRequestSchema, storedConversationSchema } from "@vezham/tamizhi-contracts";
+//#region src/lib/client.ts
+var createTamizhiClient = (options) => {
+	const providerListeners = /* @__PURE__ */ new Set();
+	const changed = () => {
+		for (const listener of providerListeners) listener();
+	};
+	const base = options.baseURL.replace(/\/$/, "");
+	const fetchRequest = async (path, init) => {
+		const headers = new Headers(typeof options.headers === "function" ? await options.headers() : options.headers);
+		headers.set("Accept", "application/json");
+		if (typeof init.body === "string") headers.set("Content-Type", "application/json");
+		if (path === "/chat" || path.includes("/events")) headers.set("Accept", "text/event-stream");
+		const response = await (options.fetch ?? globalThis.fetch)(`${base}${path}`, {
+			...init,
+			headers,
+			credentials: options.credentials ?? "same-origin"
+		});
+		if (!response.ok) {
+			const details = await response.json().catch(() => null);
+			const message = details && typeof details === "object" && "message" in details && typeof details.message === "string" ? details.message.slice(0, 500) : "";
+			throw new Error(`Tamizhi request failed (${response.status})${message ? `: ${message}` : ""}`);
+		}
+		return response;
+	};
+	const json = async (path, init = {}) => (await fetchRequest(path, init)).json();
+	const body = (value, method = "POST") => ({
+		method,
+		body: JSON.stringify(value)
+	});
+	const segment = encodeURIComponent;
+	const sessionPath = (id) => `/conversations/${segment(id)}`;
+	const upload = async (path, file, signal) => {
+		const data = new FormData();
+		data.set("file", file);
+		return json(path, {
+			method: "POST",
+			body: data,
+			signal
+		});
+	};
+	const replay = async function* (id, after = 0, signal) {
+		const response = await fetchRequest(`/runs/${segment(id)}/events?after=${after}`, { signal });
+		if (!response.body) throw new Error("Expected a Tamizhi event stream");
+		yield* readEventStream(response.body, signal);
+	};
+	return {
+		subscribeProviderChanges: (listener) => {
+			providerListeners.add(listener);
+			return () => {
+				providerListeners.delete(listener);
+			};
+		},
+		api: {
+			authorizeProvider: (id, projectId, returnTo) => json(`/providers/${segment(id)}/oauth`, body({
+				projectId,
+				returnTo
+			})),
+			providers: (signal) => json("/providers", { signal }),
+			connectProvider: async (id, apiKey, signal) => {
+				const result = await json(`/providers/${segment(id)}`, {
+					...body({ apiKey }, "PUT"),
+					signal
+				});
+				changed();
+				return result;
+			},
+			setProviderSearch: async (id, enabled) => {
+				const result = await json(`/providers/${segment(id)}/search`, body({ enabled }, "PUT"));
+				changed();
+				return result;
+			},
+			removeProvider: async (id) => {
+				await fetchRequest(`/providers/${segment(id)}`, { method: "DELETE" });
+				changed();
+			},
+			capabilities: (signal) => json("/capabilities", { signal }),
+			session: (signal) => json("/session", { signal }),
+			authSession: (signal) => json("/auth/session", { signal }),
+			getLoginURL: (returnTo, connection) => {
+				const query = new URLSearchParams();
+				if (returnTo) query.set("returnTo", returnTo);
+				if (connection) query.set("connection", connection);
+				return `${base}/auth/login${query.size ? `?${query}` : ""}`;
+			},
+			loginURL: `${base}/auth/login`,
+			logout: async () => {
+				await fetchRequest("/auth/logout", { method: "POST" });
+			},
+			conversations: (query = "", cursor = "", signal) => json(`/conversations?q=${segment(query)}&cursor=${segment(cursor)}`, { signal }),
+			rename: (id, title) => json(sessionPath(id), body({ title }, "PATCH")),
+			deleteConversation: async (id) => {
+				await fetchRequest(sessionPath(id), { method: "DELETE" });
+			},
+			feedback: (id, message, rating) => json(`${sessionPath(id)}/messages/${segment(message)}/feedback`, body({ rating }, "PUT")),
+			tasks: (id, message, tasks) => json(`${sessionPath(id)}/messages/${segment(message)}/tasks`, body({ tasks }, "PUT")),
+			branch: (id, messageId) => json(`${sessionPath(id)}/branches`, body({ messageId })),
+			checkpoints: (id) => json(`${sessionPath(id)}/checkpoints`),
+			checkpoint: (id, label) => json(`${sessionPath(id)}/checkpoints`, body({ label })),
+			restore: (id, checkpoint) => json(`${sessionPath(id)}/checkpoints/${segment(checkpoint)}/restore`, { method: "POST" }),
+			compact: (id) => json(`${sessionPath(id)}/compact`, { method: "POST" }),
+			upload: (file, signal) => upload("/attachments", file, signal),
+			transcribe: (file, signal) => upload("/audio/transcriptions", file, signal),
+			speech: async (text, signal) => (await fetchRequest("/audio/speech", {
+				...body({ text }),
+				signal
+			})).blob(),
+			memory: (query = "") => json(`/memory?q=${segment(query)}`),
+			remember: (text, tags) => json("/memory", body({
+				text,
+				tags
+			})),
+			forget: async (id) => {
+				await fetchRequest(`/memory/${segment(id)}`, { method: "DELETE" });
+			},
+			plugins: () => json("/plugins"),
+			setPlugin: async (name, enabled) => {
+				const installed = await json(`/plugins/${segment(name)}`, body({ enabled }, "PATCH"));
+				changed();
+				return installed;
+			},
+			run: (id, signal) => json(`/runs/${segment(id)}`, { signal }),
+			cancel: async (id) => {
+				await fetchRequest(`/runs/${segment(id)}/cancel`, { method: "POST" });
+			},
+			replay
+		},
+		stream: async function* (request, signal) {
+			const input = runRequestSchema.parse(request);
+			const response = await fetchRequest("/chat", {
+				method: "POST",
+				body: JSON.stringify(input),
+				signal
+			});
+			if (!response.headers.get("Content-Type")?.includes("text/event-stream") || !response.body) throw new Error("Expected a Tamizhi event stream");
+			let runId = response.headers.get("X-Tamizhi-Run-ID") ?? "";
+			let sequence = 0;
+			let current = response;
+			for (let attempt = 0;; attempt++) {
+				let terminal = false;
+				try {
+					if (!current.body) throw new Error("Expected a Tamizhi event stream");
+					for await (const event of readEventStream(current.body, signal)) {
+						runId = event.runId;
+						if (event.sequence !== void 0 && event.sequence <= sequence) continue;
+						sequence = event.sequence ?? sequence;
+						terminal ||= event.type === "finish" || event.type === "error";
+						yield event;
+					}
+					return;
+				} catch (error) {
+					if (signal?.aborted || terminal || !runId || attempt >= 3) throw error;
+					await new Promise((resolve, reject) => {
+						const onAbort = () => {
+							clearTimeout(timer);
+							reject(signal?.reason);
+						};
+						const timer = setTimeout(() => {
+							signal?.removeEventListener("abort", onAbort);
+							resolve();
+						}, Math.min(500 * 2 ** attempt, 4e3));
+						signal?.addEventListener("abort", onAbort, { once: true });
+					});
+					current = await fetchRequest(`/runs/${segment(runId)}/events?after=${sequence}`, { signal });
+				}
+			}
+		},
+		conversation: async (id, signal) => storedConversationSchema.parse(await (await fetchRequest(`/conversations/${encodeURIComponent(id)}`, { signal })).json()),
+		models: async (signal) => {
+			const data = await (await fetchRequest("/models", { signal })).json();
+			if (!Array.isArray(data)) throw new Error("Invalid model catalog");
+			return data.map((value) => modelInfoSchema.parse(value));
+		},
+		approve: async (decision, signal) => {
+			await fetchRequest("/approvals", {
+				method: "POST",
+				body: JSON.stringify(approvalDecisionSchema.parse(decision)),
+				signal
+			});
+		}
+	};
+};
+//#endregion
+export { createTamizhiClient };

package/dist/lib/companion-connect.d.ts

@@ -0,0 +1,9 @@
+import type { TamizhiAPI } from '@vezham/tamizhi-contracts';
+export type CompanionConnectionPrompt = Pick<TamizhiAPI.CompanionConnection, 'code' | 'expiresAt'>;
+export declare const connectCompanion: (options: {
+    baseURL: string;
+    signal?: AbortSignal;
+    fetch?: typeof globalThis.fetch;
+    onPending?: (prompt: CompanionConnectionPrompt) => void;
+}) => Promise<import("./client").TamizhiClient>;
+//# sourceMappingURL=companion-connect.d.ts.map

package/dist/lib/companion-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-connect.d.ts","sourceRoot":"","sources":["../../src/lib/companion-connect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAK3D,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,UAAU,CAAC,mBAAmB,EAC9B,MAAM,GAAG,WAAW,CACrB,CAAA;AA4BD,eAAO,MAAM,gBAAgB,GAAU,SAAS;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAA;CACxD,8CA8FA,CAAA"}

package/dist/lib/companion-connect.js

@@ -0,0 +1,109 @@
+import { createTamizhiClient } from "./client.js";
+import { companionURL } from "./companion.js";
+import { z } from "zod";
+//#region src/lib/companion-connect.ts
+var connectionSchema = z.object({
+	requestId: z.string().min(32).max(128),
+	code: z.string().min(6).max(12),
+	expiresAt: z.string().datetime()
+});
+var resultSchema = z.object({
+	status: z.enum([
+		"pending",
+		"approved",
+		"rejected"
+	]),
+	session: z.object({
+		token: z.string().min(32).max(128),
+		expiresAt: z.string().datetime()
+	}).optional()
+});
+var waitForPoll = (signal) => new Promise((resolve, reject) => {
+	const abort = () => {
+		clearTimeout(timer);
+		reject(signal.reason);
+	};
+	const timer = setTimeout(() => {
+		signal.removeEventListener("abort", abort);
+		resolve();
+	}, 750);
+	if (signal.aborted) abort();
+	else signal.addEventListener("abort", abort, { once: true });
+});
+var connectCompanion = async (options) => {
+	const base = companionURL(options.baseURL);
+	const fetcher = options.fetch ?? globalThis.fetch;
+	const controller = new AbortController();
+	const abort = () => controller.abort(options.signal?.reason);
+	if (options.signal?.aborted) abort();
+	else options.signal?.addEventListener("abort", abort, { once: true });
+	const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Connection request expired. Click Connect to try again.")), 300 * 1e3);
+	let requestId;
+	let complete = false;
+	let notified = false;
+	const post = async (path, body) => {
+		controller.signal.throwIfAborted();
+		let response;
+		try {
+			response = await fetcher(base + "/auth/connect" + path, {
+				method: "POST",
+				credentials: "omit",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(body),
+				signal: controller.signal
+			});
+		} catch (error) {
+			if (controller.signal.aborted) throw controller.signal.reason;
+			throw new Error("Cannot reach local Tamizhi. Start the companion and allow local network access in your browser.", { cause: error });
+		}
+		if (!response.ok) throw new Error(response.status === 409 ? "Another connection request is pending or the companion is busy. Try again shortly." : "Connection request expired or was refused by the companion. Click Connect to try again.");
+		return response.json();
+	};
+	try {
+		const connection = connectionSchema.parse(await post("", {}));
+		requestId = connection.requestId;
+		if (Date.parse(connection.expiresAt) <= Date.now()) throw new Error("Connection request expired. Click Connect to try again.");
+		while (true) {
+			const result = resultSchema.parse(await post("/poll", { requestId }));
+			if (result.status === "rejected") {
+				complete = true;
+				throw new Error("Connection rejected in the Tamizhi CLI.");
+			}
+			if (result.status === "approved") {
+				if (!result.session) throw new Error("The companion returned an invalid session.");
+				complete = true;
+				return createTamizhiClient({
+					baseURL: base,
+					headers: { Authorization: "Bearer " + result.session.token },
+					credentials: "omit",
+					fetch: options.fetch
+				});
+			}
+			if (!notified) {
+				notified = true;
+				options.onPending?.({
+					code: connection.code,
+					expiresAt: connection.expiresAt
+				});
+			}
+			await waitForPoll(controller.signal);
+		}
+	} finally {
+		clearTimeout(timeout);
+		options.signal?.removeEventListener("abort", abort);
+		if (requestId && !complete) {
+			const cleanup = new AbortController();
+			const cleanupTimeout = setTimeout(() => cleanup.abort(), 3e3);
+			fetcher(base + "/auth/connect/cancel", {
+				method: "POST",
+				credentials: "omit",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ requestId }),
+				signal: cleanup.signal,
+				keepalive: true
+			}).catch(() => {}).finally(() => clearTimeout(cleanupTimeout));
+		}
+	}
+};
+//#endregion
+export { connectCompanion };

package/dist/lib/companion-transport.d.ts

@@ -0,0 +1,10 @@
+interface Options {
+    baseURL: string;
+    origin: string;
+    isSecureContext: boolean;
+    signal?: AbortSignal;
+    fetch?: typeof globalThis.fetch;
+}
+export declare const companionTransport: (options: Options) => Promise<typeof globalThis.fetch>;
+export {};
+//# sourceMappingURL=companion-transport.d.ts.map

package/dist/lib/companion-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-transport.d.ts","sourceRoot":"","sources":["../../src/lib/companion-transport.ts"],"names":[],"mappings":"AAIA,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,KACf,OAAO,CAAC,OAAO,UAAU,CAAC,KAAK,CAgEjC,CAAA"}

package/dist/lib/companion-transport.js

@@ -0,0 +1,36 @@
+import { companionURL } from "./companion.js";
+//#region src/lib/companion-transport.ts
+var INFO = "/__tamizhi/companion-info";
+var PREFIX = "/__tamizhi/companion";
+var companionTransport = async (options) => {
+	const fetcher = options.fetch ?? globalThis.fetch;
+	const base = companionURL(options.baseURL);
+	if (options.isSecureContext) return fetcher;
+	const app = new URL(options.origin);
+	const developmentHost = app.hostname.endsWith(".vezham.local") || [
+		"localhost",
+		"127.0.0.1",
+		"[::1]"
+	].includes(app.hostname);
+	if (app.protocol === "http:" && developmentHost && base === "http://127.0.0.1:7331/api/tamizhi") try {
+		const response = await fetcher(app.origin + INFO, {
+			credentials: "omit",
+			signal: options.signal,
+			headers: { Accept: "application/json" }
+		});
+		if (response.ok && response.headers.get("Content-Type")?.includes("application/json")) {
+			const info = await response.json();
+			if (info && typeof info === "object" && "protocol" in info && info.protocol === "tamizhi-dev-proxy/v1" && "path" in info && info.path === PREFIX && "target" in info && info.target === base) return (input, init) => {
+				const url = new URL(typeof input === "string" ? input : input instanceof URL ? input.href : input.url);
+				if (url.href !== base && !url.href.startsWith(base + "/")) throw new Error("Development transport only supports its configured companion.");
+				const destination = app.origin + PREFIX + url.href.slice(base.length);
+				return fetcher(input instanceof Request ? new Request(destination, input) : destination, init);
+			};
+		}
+	} catch (error) {
+		if (options.signal?.aborted) throw error;
+	}
+	throw new Error("This HTTP origin cannot connect directly to the companion. For a .vezham.local Vite app, restart the dev server to enable its local relay. Otherwise use HTTPS or localhost.");
+};
+//#endregion
+export { companionTransport };

package/dist/lib/companion.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_COMPANION_URL = "http://127.0.0.1:7331/api/tamizhi";
+export declare const companionURL: (value: string) => string;
+//# sourceMappingURL=companion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../src/lib/companion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,sCAAsC,CAAA;AACxE,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAazC,CAAA"}

package/dist/lib/companion.js

@@ -0,0 +1,13 @@
+//#region src/lib/companion.ts
+var DEFAULT_COMPANION_URL = "http://127.0.0.1:7331/api/tamizhi";
+var companionURL = (value) => {
+	const url = new URL(value);
+	if (url.protocol !== "http:" || ![
+		"127.0.0.1",
+		"localhost",
+		"[::1]"
+	].includes(url.hostname) || url.username || url.password || url.search || url.hash || url.pathname.replace(/\/$/, "") !== "/api/tamizhi") throw new Error("Use a loopback companion URL ending in /api/tamizhi.");
+	return url.href.replace(/\/$/, "");
+};
+//#endregion
+export { DEFAULT_COMPANION_URL, companionURL };

package/dist/lib/connection.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectConnectionAdapter } from '@tanstack/ai-client';
+import type { RunRequest, StreamEvent } from '@vezham/tamizhi-contracts';
+import type { TamizhiClient } from './client';
+interface ConnectionOptions {
+    request?: RunRequest;
+    permission?: RunRequest['permission'];
+    model?: string;
+    fast?: boolean;
+    onEvent?: (event: StreamEvent) => void | Promise<void>;
+}
+export declare const createTamizhiConnection: (client: TamizhiClient, options?: ConnectionOptions) => ConnectConnectionAdapter;
+export declare const runTamizhiChat: (client: TamizhiClient, request: RunRequest, callbacks: {
+    onText: (text: string) => void;
+    onEvent: (event: StreamEvent) => void | Promise<void>;
+}, signal?: AbortSignal) => Promise<void>;
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/lib/connection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAa,MAAM,qBAAqB,CAAA;AAG9E,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD;AAYD,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,EACrB,UAAS,iBAAsB,KAC9B,wBAkFD,CAAA;AAGF,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,EACrB,SAAS,UAAU,EACnB,WAAW;IACT,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD,EACD,SAAS,WAAW,kBAyCrB,CAAA"}

package/dist/lib/connection.js

@@ -0,0 +1,125 @@
+import { runRequestSchema } from "@vezham/tamizhi-contracts";
+import { ChatClient } from "@tanstack/ai-client";
+import { EventType } from "@tanstack/ai/client";
+//#region src/lib/connection.ts
+var inputText = (message) => {
+	if ("parts" in message) return message.parts.filter((part) => part.type === "text").map((part) => part.type === "text" ? part.content : "").join("");
+	return typeof message.content === "string" ? message.content : JSON.stringify(message.content);
+};
+var createTamizhiConnection = (client, options = {}) => ({ async *connect(messages, _data, signal, context) {
+	const request = options.request ?? runRequestSchema.parse({
+		conversationId: context.threadId,
+		messages: messages.filter((message) => message.role === "user" || message.role === "assistant").map((message) => ({
+			id: message.id,
+			role: message.role,
+			content: inputText(message)
+		})),
+		permission: options.permission ?? "ask",
+		model: options.model,
+		fast: options.fast ?? false
+	});
+	let messageId = "";
+	let textStarted = false;
+	for await (const event of client.stream(request, signal)) {
+		signal?.throwIfAborted();
+		await options.onEvent?.(event);
+		if (event.type === "start") yield {
+			type: EventType.RUN_STARTED,
+			threadId: event.conversationId,
+			runId: event.runId
+		};
+		else if (event.type === "text") {
+			if (!textStarted) {
+				messageId = event.runId + ":assistant";
+				textStarted = true;
+				yield {
+					type: EventType.TEXT_MESSAGE_START,
+					messageId,
+					role: "assistant"
+				};
+			}
+			yield {
+				type: EventType.TEXT_MESSAGE_CONTENT,
+				messageId,
+				delta: event.delta
+			};
+		} else if (event.type === "tool") {
+			yield {
+				type: EventType.TOOL_CALL_START,
+				toolCallId: event.callId,
+				toolCallName: event.name
+			};
+			yield {
+				type: EventType.TOOL_CALL_ARGS,
+				toolCallId: event.callId,
+				delta: JSON.stringify(event.input)
+			};
+			yield {
+				type: EventType.TOOL_CALL_END,
+				toolCallId: event.callId
+			};
+		} else if (event.type === "tool-result") yield {
+			type: EventType.TOOL_CALL_RESULT,
+			toolCallId: event.callId,
+			messageId: event.callId + ":result",
+			content: JSON.stringify(event.output),
+			role: "tool"
+		};
+		else if (event.type === "finish") {
+			if (textStarted) yield {
+				type: EventType.TEXT_MESSAGE_END,
+				messageId
+			};
+			yield {
+				type: EventType.RUN_FINISHED,
+				threadId: event.conversationId,
+				runId: event.runId
+			};
+		} else if (event.type === "error") yield {
+			type: EventType.RUN_ERROR,
+			message: event.message
+		};
+		else yield {
+			type: EventType.CUSTOM,
+			name: "tamizhi",
+			value: event
+		};
+	}
+} });
+var runTamizhiChat = async (client, request, callbacks, signal) => {
+	let failure;
+	let previous = "";
+	const chat = new ChatClient({
+		threadId: request.conversationId,
+		connection: createTamizhiConnection(client, {
+			request,
+			onEvent: callbacks.onEvent
+		}),
+		onMessagesChange: (messages) => {
+			const text = [...messages].reverse().find((item) => item.role === "assistant")?.parts.filter((part) => part.type === "text").map((part) => part.type === "text" ? part.content : "").join("");
+			if (text !== void 0 && text !== previous) {
+				previous = text;
+				callbacks.onText(text);
+			}
+		},
+		onError: (error) => {
+			failure = error;
+		}
+	});
+	const abort = () => chat.stop();
+	if (signal?.aborted) {
+		chat.dispose();
+		signal.throwIfAborted();
+	}
+	signal?.addEventListener("abort", abort, { once: true });
+	try {
+		await chat.sendMessage(request.messages.at(-1)?.content ?? "");
+		signal?.throwIfAborted();
+		if (failure) throw failure;
+	} finally {
+		signal?.removeEventListener("abort", abort);
+		chat.dispose();
+	}
+};
+//#endregion
+export { createTamizhiConnection, runTamizhiChat };

package/dist/lib/stream.d.ts

@@ -0,0 +1,3 @@
+import type { StreamEvent } from '@vezham/tamizhi-contracts';
+export declare const readEventStream: (body: ReadableStream<Uint8Array>, signal?: AbortSignal) => AsyncGenerator<StreamEvent>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/lib/stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,eAAO,MAAM,eAAe,GAC1B,MAAM,cAAc,CAAC,UAAU,CAAC,EAChC,SAAS,WAAW,KACnB,cAAc,CAAC,WAAW,CA8C5B,CAAA"}

package/dist/lib/stream.js

@@ -0,0 +1,43 @@
+import { streamEventSchema } from "@vezham/tamizhi-contracts";
+//#region src/lib/stream.ts
+var readEventStream = async function* (body, signal) {
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	const abort = () => {
+		reader.cancel();
+	};
+	signal?.addEventListener("abort", abort, { once: true });
+	if (signal?.aborted) abort();
+	let finished = false;
+	try {
+		for (;;) {
+			signal?.throwIfAborted();
+			const { value, done } = await reader.read();
+			buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });
+			if (buffer.length > 1e6) throw new Error("Stream event exceeds the maximum size");
+			buffer = buffer.replace(/\r\n/g, "\n");
+			let boundary = buffer.indexOf("\n\n");
+			while (boundary >= 0) {
+				const frame = buffer.slice(0, boundary);
+				buffer = buffer.slice(boundary + 2);
+				const data = frame.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart()).join("\n");
+				if (data) {
+					const event = streamEventSchema.parse(JSON.parse(data));
+					if (event.type === "finish" || event.type === "error") finished = true;
+					yield event;
+				}
+				boundary = buffer.indexOf("\n\n");
+			}
+			if (done) break;
+		}
+		signal?.throwIfAborted();
+		if (!finished) throw new Error("The response stream ended before completion");
+	} finally {
+		signal?.removeEventListener("abort", abort);
+		await reader.cancel().catch(() => void 0);
+		reader.releaseLock();
+	}
+};
+//#endregion
+export { readEventStream };

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@vezham/tamizhi-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "26.3.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vezham/vx-fe-pkgs.git",
+    "directory": "packages/tamizhi/client"
+  },
+  "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"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "!**/*.tsbuildinfo",
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@tanstack/ai": "1.0.0",
+    "@tanstack/ai-client": "1.0.0",
+    "@vezham/tamizhi-contracts": "26.3.2",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.64.1",
+    "vite": "8.1.6"
+  }
 }