@camelai/run-svelte 0.0.0 → 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qaml-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,24 @@
 # @camelai/run-svelte
 
-Placeholder. The first release is 0.11.0, from https://github.com/qaml-ai/run.
+Svelte stores for a chat with an agent on camelRun, through your server's route
+(`createAgentHandler` from `@camelai/run/server`; see the Frontend guide). They follow the
+store contract, so they work in Svelte 4 and 5 (`$messages`), and have no dependency on Svelte.
+
+```svelte
+<script lang="ts">
+  import { agentChat } from "@camelai/run-svelte";
+  const { messages, status, send, stop } = agentChat({ endpoint: "/api/agent" });
+  let text = "";
+</script>
+
+{#each $messages as message (message.id)}
+  {#if message.role === "user"}<p>{message.text}</p>
+  {:else}{#each message.parts as part (part.id)}{#if part.type === "text"}<p>{part.text}</p>{/if}{/each}{/if}
+{/each}
+<form on:submit|preventDefault={() => { send(text); text = ""; }}><input bind:value={text} /><button>Send</button></form>
+{#if $status === "streaming"}<button on:click={() => stop()}>Stop</button>{/if}
+```
+
+`agentChat(options | chat)` returns stores (`messages`, `status`, `inputs`, `error`, `hasOlder`,
+`snapshot`) and actions (`send`, `answer`, `decline`, `stop`, `retry`, `loadOlder`, `fileUrl`). The
+chat connects with the first subscriber and disconnects after the last.

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Svelte bindings for an agent chat: stores over the chat with the user's agent, connected while
+ * anything subscribes. They follow the store contract, so `$messages` works in Svelte 4 and 5.
+ *
+ *   const chat = agentChat({ endpoint: "/api/agent" });
+ *   const { messages, status } = chat;   // then $messages, $status in markup
+ *   chat.send("Hello");
+ */
+import { type AgentChat, type AgentChatOptions, type ChatSnapshot } from "@camelai/run/chat";
+export type * from "@camelai/run/chat";
+export { answerValue, createAgentChat } from "@camelai/run/chat";
+/** A Svelte store (the store contract), readable only. */
+export interface Readable<T> {
+    subscribe(run: (value: T) => void): () => void;
+}
+export interface AgentChatStores {
+    chat: AgentChat;
+    snapshot: Readable<ChatSnapshot>;
+    messages: Readable<ChatSnapshot["messages"]>;
+    status: Readable<ChatSnapshot["status"]>;
+    inputs: Readable<ChatSnapshot["inputs"]>;
+    error: Readable<ChatSnapshot["error"]>;
+    hasOlder: Readable<boolean>;
+    send: AgentChat["send"];
+    answer: AgentChat["answer"];
+    decline: AgentChat["decline"];
+    stop: AgentChat["stop"];
+    retry: AgentChat["retry"];
+    loadOlder: AgentChat["loadOlder"];
+    fileUrl: AgentChat["fileUrl"];
+}
+/**
+ * Stores over a chat: `options` makes one, connected in a browser from the first subscriber to the last
+ * (a chat you pass stays as you left it). Each store notifies only when its part of the snapshot changes.
+ */
+export declare function agentChat(options: Omit<AgentChatOptions, "autoConnect"> | AgentChat): AgentChatStores;

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * Svelte bindings for an agent chat: stores over the chat with the user's agent, connected while
+ * anything subscribes. They follow the store contract, so `$messages` works in Svelte 4 and 5.
+ *
+ *   const chat = agentChat({ endpoint: "/api/agent" });
+ *   const { messages, status } = chat;   // then $messages, $status in markup
+ *   chat.send("Hello");
+ */
+import { createAgentChat } from "@camelai/run/chat";
+export { answerValue, createAgentChat } from "@camelai/run/chat";
+/**
+ * Stores over a chat: `options` makes one, connected in a browser from the first subscriber to the last
+ * (a chat you pass stays as you left it). Each store notifies only when its part of the snapshot changes.
+ */
+export function agentChat(options) {
+    const own = !("getSnapshot" in options);
+    const chat = own ? createAgentChat({ ...options, autoConnect: false }) : options;
+    let subscribers = 0;
+    const select = (pick) => ({
+        subscribe(run) {
+            // Server rendering subscribes too: a chat connects only in a browser.
+            if (subscribers++ === 0 && own && typeof window !== "undefined")
+                chat.connect();
+            let last = pick(chat.getSnapshot());
+            run(last);
+            const off = chat.subscribe(() => {
+                const next = pick(chat.getSnapshot());
+                if (!Object.is(next, last)) {
+                    last = next;
+                    run(next);
+                }
+            });
+            return () => { off(); if (--subscribers === 0 && own)
+                chat.disconnect(); };
+        },
+    });
+    return {
+        chat,
+        snapshot: select(snapshot => snapshot), messages: select(snapshot => snapshot.messages), status: select(snapshot => snapshot.status),
+        inputs: select(snapshot => snapshot.inputs), error: select(snapshot => snapshot.error), hasOlder: select(snapshot => snapshot.hasOlder),
+        send: chat.send, answer: chat.answer, decline: chat.decline, stop: chat.stop, retry: chat.retry, loadOlder: chat.loadOlder, fileUrl: chat.fileUrl,
+    };
+}

package/package.json

@@ -1 +1,36 @@
-{ "name": "@camelai/run-svelte", "version": "0.0.0", "description": "Placeholder: the first release (0.11.0) comes from github.com/qaml-ai/run.", "license": "MIT", "publishConfig": { "access": "public" } }
+{
+  "name": "@camelai/run-svelte",
+  "version": "0.11.0",
+  "description": "Svelte bindings for chatting with agents on camelRun.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qaml-ai/run.git",
+    "directory": "packages/svelte"
+  },
+  "homepage": "https://agents.camelai.dev",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@camelai/run": "0.11.0"
+  }
+}