@terminaluse/vercel-ai-sdk-provider 0.1.1 → 0.3.0

package/README.md

@@ -36,9 +36,60 @@ const result = await streamText({
 | Option | Type | Description |
 |--------|------|-------------|
 | `taskId` | `string` | Task ID to send messages to (required) |
+| `event` | `object` | Optional explicit task event override (`content`, `persistMessage`, `idempotencyKey`) |
 
 Tasks must be created separately using the [`@terminaluse/sdk`](https://www.npmjs.com/package/@terminaluse/sdk).
 
+### Sending data events
+
+By default, the provider sends a text event derived from the last prompt message.
+If you need to send a structured task event (for example, AskUserQuestion answers),
+pass `providerOptions.terminaluse.event`:
+
+```typescript
+await streamText({
+  model: terminaluse.agent('namespace/agent-name'),
+  messages: [],
+  providerOptions: {
+    terminaluse: {
+      taskId,
+      event: {
+        content: {
+          type: 'data',
+          data: {
+            type: 'ask_user_answer',
+            answers: { 'Question?': 'Answer' },
+          },
+        },
+        persistMessage: false,
+        idempotencyKey: 'optional-idempotency-key',
+      },
+    },
+  },
+});
+```
+
+## Conversation Continuity
+
+To maintain conversation history across multiple interactions, create a task once
+and reuse its ID for all subsequent messages:
+
+```typescript
+import { TerminalUseClient } from '@terminaluse/sdk';
+
+// 1. Create task once (at conversation start)
+const client = new TerminalUseClient({ token: process.env.TERMINALUSE_API_KEY! });
+const task = await client.tasks.create({ agent_name: 'namespace/my-agent' });
+const taskId = task.id;  // Store this for the session
+
+// 2. Send messages to the same task
+const result = await streamText({
+  model: terminaluse.agent('namespace/my-agent'),
+  messages,
+  providerOptions: { terminaluse: { taskId } },
+});
+```
+
 ## Requirements
 
 - Node.js 18+

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { TerminalUse } from "@terminaluse/sdk";
 import { LanguageModel } from "ai";
 
 //#region src/provider.d.ts
@@ -18,6 +19,25 @@ interface TerminalUseProvider {
 interface TerminalUseProviderOptions {
   /** Task ID to send messages to (required) */
   taskId: string;
+  /**
+   * Optional override for the outbound task event. If omitted, provider sends
+   * a text event derived from the latest prompt message (default behavior).
+   */
+  event?: TerminalUseProviderTaskEventOptions;
+}
+interface TerminalUseProviderTaskEventOptions {
+  /**
+   * Explicit event content to send. Supports text and data task events.
+   */
+  content: NonNullable<TerminalUse.CreateTaskEventRequest['content']>;
+  /**
+   * Whether TerminalUse should persist this event as a message.
+   */
+  persistMessage?: boolean;
+  /**
+   * Optional idempotency key for retry-safe event delivery.
+   */
+  idempotencyKey?: string;
 }
 /**
  * Creates a custom AI SDK provider for TerminalUse agents.
@@ -48,4 +68,4 @@ interface TerminalUseProviderOptions {
  */
 declare function createTerminalUseProvider(config: TerminalUseProviderConfig): TerminalUseProvider;
 //#endregion
-export { type TerminalUseProvider, type TerminalUseProviderConfig, type TerminalUseProviderOptions, createTerminalUseProvider };
+export { type TerminalUseProvider, type TerminalUseProviderConfig, type TerminalUseProviderOptions, type TerminalUseProviderTaskEventOptions, createTerminalUseProvider };

package/dist/index.mjs

@@ -1,22 +1,8 @@
+import { TerminalUseClient } from "@terminaluse/sdk";
 import { UnsupportedFunctionalityError } from "ai";
 import { createEventSourceResponseHandler, getFromApi } from "@ai-sdk/provider-utils";
 import { z } from "zod";
 
-//#region src/http.ts
-/**
-* Fetch wrapper with TerminalUse authentication headers.
-*/
-async function terminaluseFetch(config, path, options = {}) {
-	const headers = new Headers(options.headers);
-	if (config.apiKey) headers.set("Authorization", `Bearer ${config.apiKey}`);
-	if (!headers.has("Content-Type") && options.body) headers.set("Content-Type", "application/json");
-	return fetch(`${config.baseURL}${path}`, {
-		...options,
-		headers
-	});
-}
-
-//#endregion
 //#region src/ndjson-stream.ts
 /**
 * SSE streaming utility for TerminalUse task events.
@@ -366,6 +352,10 @@ function createTerminalUseProvider(config) {
 		baseURL: config.baseURL,
 		apiKey: config.apiKey
 	};
+	const client = new TerminalUseClient({
+		environment: config.baseURL,
+		bearerAuth: { token: config.apiKey }
+	});
 	return { agent(agentName) {
 		return {
 			specificationVersion: "v3",
@@ -383,24 +373,29 @@ function createTerminalUseProvider(config) {
 				const tuOptions = providerOptions?.terminaluse;
 				if (!tuOptions?.taskId) throw new Error("taskId is required. Create a task via /api/tasks first.");
 				const { taskId } = tuOptions;
-				const userContent = prompt.at(-1)?.content;
-				let textContent;
-				if (Array.isArray(userContent)) {
-					const textPart = userContent.find((c) => c.type === "text");
-					if (textPart && textPart.type === "text") textContent = textPart.text;
-				} else if (typeof userContent === "string") textContent = userContent;
-				const sendResponse = await terminaluseFetch(tuConfig, `/tasks/${encodeURIComponent(taskId)}/events`, {
-					method: "POST",
-					body: JSON.stringify({ content: {
+				const explicitEvent = tuOptions.event;
+				const defaultEventContent = (() => {
+					const userContent = prompt.at(-1)?.content;
+					let textContent;
+					if (Array.isArray(userContent)) {
+						const textPart = userContent.find((c) => c.type === "text");
+						if (textPart && textPart.type === "text") textContent = textPart.text;
+					} else if (typeof userContent === "string") textContent = userContent;
+					return {
 						type: "text",
-						content: textContent || "",
-						author: "user",
-						format: "plain"
-					} })
-				});
-				if (!sendResponse.ok) {
-					const errorText = await sendResponse.text();
-					throw new Error(`Failed to send message: ${sendResponse.status} - ${errorText}`);
+						text: textContent || ""
+					};
+				})();
+				const requestBody = {
+					task_id: taskId,
+					content: explicitEvent?.content ?? defaultEventContent,
+					...explicitEvent?.idempotencyKey ? { idempotency_key: explicitEvent.idempotencyKey } : {},
+					...typeof explicitEvent?.persistMessage === "boolean" ? { persist_message: explicitEvent.persistMessage } : {}
+				};
+				try {
+					await client.tasks.sendEvent(requestBody);
+				} catch (error) {
+					throw new Error(`Failed to send message: ${error instanceof Error ? error.message : String(error)}`);
 				}
 				return { stream: createTerminalUseTransformStream(tuConfig, taskId, abortSignal) };
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminaluse/vercel-ai-sdk-provider",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Vercel AI SDK provider for TerminalUse agents",
   "repository": {
     "type": "git",
@@ -31,11 +31,13 @@
     "lint": "biome lint .",
     "format": "biome format --write .",
     "check": "biome check --write .",
-    "prepublishOnly": "bun run build"
+    "check:publish-manifest": "node ./scripts/check-publish-manifest.mjs",
+    "prepublishOnly": "bun run check:publish-manifest && bun run build"
   },
   "dependencies": {
     "@ai-sdk/provider": "^3.0.0",
     "@ai-sdk/provider-utils": "^4.0.0",
+    "@terminaluse/sdk": "^0.7.0",
     "zod": "^3.24.0"
   },
   "peerDependencies": {