@sveda-ai/protocol 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sveda AI Contributors
+
+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

@@ -0,0 +1,7 @@
+# @sveda-ai/protocol
+
+Sveda Wire Protocol — stream event schemas and constants used by the JS client packages.
+
+```bash
+npm install @sveda-ai/protocol
+```

package/contracts/sidecar.v1.json

@@ -0,0 +1,88 @@
+{
+  "version": "1.0",
+  "prefix": "/sveda",
+  "accept": {
+    "svedaStream": "application/vnd.sveda.stream+json",
+    "sse": "text/event-stream"
+  },
+  "headers": {
+    "inbound": [
+      "Accept",
+      "Authorization",
+      "Content-Type",
+      "X-Sveda-Admin-Key",
+      "X-Sveda-Embed-Token",
+      "X-Sveda-Host-Key",
+      "X-Sveda-Protocol"
+    ],
+    "streamResponse": {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      "X-Accel-Buffering": "no",
+      "X-Sveda-Protocol-Version": "1.0"
+    },
+    "mcpOutbound": [
+      "X-Sveda-Page-Context",
+      "X-Sveda-Chat-Id"
+    ]
+  },
+  "cors": {
+    "allowedHeaders": [
+      "Accept",
+      "Authorization",
+      "Content-Type",
+      "X-Requested-With",
+      "X-Sveda-Embed-Token",
+      "X-Sveda-Host-Key",
+      "X-Sveda-Admin-Key",
+      "X-Sveda-Protocol"
+    ],
+    "allowedMethods": ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"]
+  },
+  "routes": [
+    { "method": "POST", "path": "/sveda/stream", "mode": "sse" },
+    { "method": "POST", "path": "/sveda/message", "mode": "json" },
+    { "method": "GET", "path": "/sveda/chat-histories", "mode": "json" },
+    { "method": "GET", "path": "/sveda/chat-histories/{chatId}", "mode": "json" },
+    { "method": "PATCH", "path": "/sveda/chat-histories/{chatId}", "mode": "json" },
+    { "method": "DELETE", "path": "/sveda/chat-histories/{chatId}", "mode": "json" },
+    { "method": "POST", "path": "/sveda/documents/extract", "mode": "json" },
+    { "method": "GET", "path": "/sveda/embed/config", "mode": "json" },
+    { "method": "POST", "path": "/sveda/embed/token", "mode": "json" }
+  ],
+  "streamEvents": [
+    "message.start",
+    "text.delta",
+    "reasoning.delta",
+    "tool.call",
+    "tool.result",
+    "tool.progress",
+    "context.usage",
+    "chat.title",
+    "max_steps",
+    "message.end",
+    "error"
+  ],
+  "sseDoneLine": "data: [DONE]",
+  "embedToken": {
+    "request": ["visitor_id", "host_mcp_url", "host_mcp_token"],
+    "responseRequired": ["token", "visitor_id", "expires_in"],
+    "responseOptional": ["appearance"]
+  },
+  "message": {
+    "responseRequired": ["explanation", "tokens_used", "chat_id"]
+  },
+  "histories": {
+    "listKey": "histories",
+    "detailKey": "history",
+    "summaryRequired": ["id", "chatId", "title", "preview", "tokensUsed", "version", "createdAt", "updatedAt"],
+    "detailRequired": ["id", "chatId", "title", "messages", "conversationHistory", "tokensUsed", "version", "createdAt", "updatedAt"],
+    "patchRequest": ["title"],
+    "mutationResponseRequired": ["success"]
+  },
+  "documentsExtract": {
+    "requestField": "files",
+    "responseKey": "items",
+    "itemRequired": ["filename", "ok"]
+  }
+}

package/dist/events.d.ts

@@ -0,0 +1,102 @@
+export declare const SVEDA_PROTOCOL_VERSION: "1.0";
+export declare const SVEDA_STREAM_EVENTS: readonly ["message.start", "text.delta", "reasoning.delta", "tool.call", "tool.result", "tool.progress", "context.usage", "chat.title", "max_steps", "message.end", "error"];
+export type SvedaStreamEventType = (typeof SVEDA_STREAM_EVENTS)[number];
+export type SvedaToolTarget = 'backend' | 'frontend';
+export type SvedaRenderHint = 'confirm_dialog' | 'resource_links' | 'plain' | 'custom';
+export interface SvedaStreamEventBase {
+    type: SvedaStreamEventType;
+    chatId?: string;
+    messageId?: string;
+    timestamp?: string;
+}
+export interface SvedaMessageStartEvent extends SvedaStreamEventBase {
+    type: 'message.start';
+}
+export interface SvedaTextDeltaEvent extends SvedaStreamEventBase {
+    type: 'text.delta';
+    delta: string;
+}
+export interface SvedaReasoningDeltaEvent extends SvedaStreamEventBase {
+    type: 'reasoning.delta';
+    delta: string;
+}
+export interface SvedaToolCallEvent extends SvedaStreamEventBase {
+    type: 'tool.call';
+    toolCallId: string;
+    toolName: string;
+    target: SvedaToolTarget;
+    input: Record<string, unknown>;
+}
+export interface SvedaToolResultEvent extends SvedaStreamEventBase {
+    type: 'tool.result';
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    renderHint?: SvedaRenderHint;
+    renderData?: Record<string, unknown>;
+}
+export interface SvedaToolProgressTask {
+    id: string;
+    label: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    detail?: string;
+}
+export interface SvedaToolProgressEvent extends SvedaStreamEventBase {
+    type: 'tool.progress';
+    phase?: string;
+    tasks: SvedaToolProgressTask[];
+}
+export interface SvedaContextUsageEvent extends SvedaStreamEventBase {
+    type: 'context.usage';
+    usedTokens: number;
+    maxTokens: number;
+    percent: number;
+}
+export interface SvedaChatTitleEvent extends SvedaStreamEventBase {
+    type: 'chat.title';
+    title: string;
+}
+export interface SvedaMaxStepsEvent extends SvedaStreamEventBase {
+    type: 'max_steps';
+    maxSteps: number;
+    canContinue: boolean;
+}
+export interface SvedaMessageEndEvent extends SvedaStreamEventBase {
+    type: 'message.end';
+    finishReason?: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+}
+export interface SvedaErrorEvent extends SvedaStreamEventBase {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export type SvedaStreamEvent = SvedaMessageStartEvent | SvedaTextDeltaEvent | SvedaReasoningDeltaEvent | SvedaToolCallEvent | SvedaToolResultEvent | SvedaToolProgressEvent | SvedaContextUsageEvent | SvedaChatTitleEvent | SvedaMaxStepsEvent | SvedaMessageEndEvent | SvedaErrorEvent;
+export interface SvedaClientToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface SvedaChatMessage {
+    id?: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content?: string;
+    parts?: Array<Record<string, unknown>>;
+}
+export interface SvedaStreamRequest {
+    messages: SvedaChatMessage[];
+    prompt?: string;
+    chatId?: string;
+    context?: Record<string, unknown>;
+    clientTools?: SvedaClientToolDefinition[];
+    model?: string;
+    provider?: string;
+    options?: Record<string, unknown>;
+}
+export declare function isSvedaStreamEvent(value: unknown): value is SvedaStreamEvent;
+export declare function parseSvedaStreamLine(line: string): SvedaStreamEvent | null;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,42 @@
+export const SVEDA_PROTOCOL_VERSION = '1.0';
+export const SVEDA_STREAM_EVENTS = [
+    'message.start',
+    'text.delta',
+    'reasoning.delta',
+    'tool.call',
+    'tool.result',
+    'tool.progress',
+    'context.usage',
+    'chat.title',
+    'max_steps',
+    'message.end',
+    'error',
+];
+export function isSvedaStreamEvent(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const type = value.type;
+    return typeof type === 'string' && SVEDA_STREAM_EVENTS.includes(type);
+}
+export function parseSvedaStreamLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('data:')) {
+        return null;
+    }
+    const payload = trimmed.slice(5).trim();
+    if (!payload || payload === '[DONE]') {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(payload);
+        if (isSvedaStreamEvent(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAc,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,eAAe;IACf,YAAY;IACZ,iBAAiB;IACjB,WAAW;IACX,aAAa;IACb,eAAe;IACf,eAAe;IACf,YAAY;IACZ,WAAW;IACX,aAAa;IACb,OAAO;CACC,CAAC;AAsIX,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QAC9C,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './events.js';
+export * from './vercelAdapter.js';
+//# 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,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './events.js';
+export * from './vercelAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/vercelAdapter.d.ts

@@ -0,0 +1,9 @@
+import type { SvedaStreamEvent } from './events.js';
+export type VercelDataPart = {
+    type: string;
+    [key: string]: unknown;
+};
+export declare function svedaEventToVercelDataPart(event: SvedaStreamEvent): VercelDataPart | null;
+export declare function vercelDataPartToSvedaEvent(part: VercelDataPart): SvedaStreamEvent | null;
+export declare function encodeSvedaStreamEvent(event: SvedaStreamEvent): string;
+//# sourceMappingURL=vercelAdapter.d.ts.map

package/dist/vercelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercelAdapter.d.ts","sourceRoot":"","sources":["../src/vercelAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,GAAG,IAAI,CAuDzF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAsExF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEtE"}

package/dist/vercelAdapter.js

@@ -0,0 +1,125 @@
+export function svedaEventToVercelDataPart(event) {
+    switch (event.type) {
+        case 'text.delta':
+            return { type: 'text-delta', textDelta: event.delta };
+        case 'reasoning.delta':
+            return { type: 'reasoning-delta', reasoningDelta: event.delta };
+        case 'tool.call':
+            return {
+                type: 'tool-call',
+                toolCallId: event.toolCallId,
+                toolName: event.toolName,
+                args: event.input,
+                target: event.target,
+            };
+        case 'tool.result':
+            return {
+                type: 'tool-result',
+                toolCallId: event.toolCallId,
+                toolName: event.toolName,
+                result: event.output,
+                renderHint: event.renderHint,
+                renderData: event.renderData,
+            };
+        case 'tool.progress':
+            return {
+                type: 'data-toolProgress',
+                data: { phase: event.phase, tasks: event.tasks },
+            };
+        case 'context.usage':
+            return {
+                type: 'data-contextUsage',
+                data: {
+                    usedTokens: event.usedTokens,
+                    maxTokens: event.maxTokens,
+                    percent: event.percent,
+                },
+            };
+        case 'chat.title':
+            return { type: 'data-chatTitle', data: { title: event.title } };
+        case 'max_steps':
+            return {
+                type: 'data-maxStepsReached',
+                data: { maxSteps: event.maxSteps, canContinue: event.canContinue },
+            };
+        case 'message.end':
+            return {
+                type: 'finish',
+                finishReason: event.finishReason ?? 'stop',
+                usage: event.usage,
+            };
+        case 'error':
+            return { type: 'error', error: { code: event.code, message: event.message } };
+        default:
+            return null;
+    }
+}
+export function vercelDataPartToSvedaEvent(part) {
+    const data = (part.data ?? {});
+    switch (part.type) {
+        case 'text-delta':
+            return { type: 'text.delta', delta: String(part.textDelta ?? '') };
+        case 'reasoning-delta':
+            return { type: 'reasoning.delta', delta: String(part.reasoningDelta ?? '') };
+        case 'tool-call':
+            return {
+                type: 'tool.call',
+                toolCallId: String(part.toolCallId ?? ''),
+                toolName: String(part.toolName ?? ''),
+                target: part.target === 'frontend' ? 'frontend' : 'backend',
+                input: part.args ?? {},
+            };
+        case 'tool-result':
+            return {
+                type: 'tool.result',
+                toolCallId: String(part.toolCallId ?? ''),
+                toolName: String(part.toolName ?? ''),
+                output: part.result,
+                renderHint: part.renderHint,
+                renderData: part.renderData,
+            };
+        case 'data-toolProgress': {
+            const tasks = Array.isArray(data.tasks) ? data.tasks : [];
+            return {
+                type: 'tool.progress',
+                phase: typeof data.phase === 'string' ? data.phase : undefined,
+                tasks: tasks,
+            };
+        }
+        case 'data-contextUsage':
+            return {
+                type: 'context.usage',
+                usedTokens: Number(data.usedTokens ?? 0),
+                maxTokens: Number(data.maxTokens ?? 0),
+                percent: Number(data.percent ?? 0),
+            };
+        case 'data-chatTitle':
+            return { type: 'chat.title', title: String(data.title ?? '') };
+        case 'data-maxStepsReached':
+            return {
+                type: 'max_steps',
+                maxSteps: Number(data.maxSteps ?? 0),
+                canContinue: Boolean(data.canContinue ?? true),
+            };
+        case 'finish':
+            return {
+                type: 'message.end',
+                finishReason: String(part.finishReason ?? 'stop'),
+                usage: part.usage,
+            };
+        case 'error': {
+            const error = (part.error ?? {});
+            return {
+                type: 'error',
+                code: String(error.code ?? 'unknown'),
+                message: String(error.message ?? 'Unknown error'),
+            };
+        }
+        default:
+            return null;
+    }
+}
+export function encodeSvedaStreamEvent(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+//# sourceMappingURL=vercelAdapter.js.map

package/dist/vercelAdapter.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sveda-ai/protocol",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Sveda Wire Protocol — stream event schemas and constants.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neresson/sveda.git",
+    "directory": "packages/protocol"
+  },
+  "homepage": "https://github.com/neresson/sveda/tree/main/packages/protocol",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schemas/*": "./schemas/*",
+    "./contracts/*": "./contracts/*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "schemas",
+    "contracts"
+  ],
+  "devDependencies": {
+    "typescript": "^5.8.2",
+    "vitest": "^4.1.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "echo 'no lint configured'"
+  }
+}

package/schemas/stream-event.schema.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sveda-ai.dev/schemas/v1/stream-event.schema.json",
+  "title": "Sveda Wire Protocol v1 — Stream Event",
+  "description": "Server-to-client SSE event envelope. Every event is a JSON object sent as one SSE `data:` frame.",
+  "oneOf": [
+    { "$ref": "#/$defs/messageStart" },
+    { "$ref": "#/$defs/textDelta" },
+    { "$ref": "#/$defs/reasoningDelta" },
+    { "$ref": "#/$defs/toolCall" },
+    { "$ref": "#/$defs/toolResult" },
+    { "$ref": "#/$defs/toolProgress" },
+    { "$ref": "#/$defs/contextUsage" },
+    { "$ref": "#/$defs/chatTitle" },
+    { "$ref": "#/$defs/maxSteps" },
+    { "$ref": "#/$defs/messageEnd" },
+    { "$ref": "#/$defs/error" }
+  ],
+  "$defs": {
+    "base": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": { "type": "string" },
+        "chatId": { "type": "string" },
+        "messageId": { "type": "string" },
+        "timestamp": { "type": "string", "format": "date-time" }
+      }
+    },
+    "messageStart": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        { "type": "object", "properties": { "type": { "const": "message.start" } } }
+      ]
+    },
+    "textDelta": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["delta"],
+          "properties": { "type": { "const": "text.delta" }, "delta": { "type": "string" } }
+        }
+      ]
+    },
+    "reasoningDelta": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["delta"],
+          "properties": { "type": { "const": "reasoning.delta" }, "delta": { "type": "string" } }
+        }
+      ]
+    },
+    "toolCall": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["toolCallId", "toolName", "target", "input"],
+          "properties": {
+            "type": { "const": "tool.call" },
+            "toolCallId": { "type": "string" },
+            "toolName": { "type": "string" },
+            "target": { "enum": ["backend", "frontend"] },
+            "input": { "type": "object" }
+          }
+        }
+      ]
+    },
+    "toolResult": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["toolCallId", "toolName", "output"],
+          "properties": {
+            "type": { "const": "tool.result" },
+            "toolCallId": { "type": "string" },
+            "toolName": { "type": "string" },
+            "output": true,
+            "renderHint": { "enum": ["confirm_dialog", "resource_links", "plain", "custom"] },
+            "renderData": { "type": "object" }
+          }
+        }
+      ]
+    },
+    "toolProgress": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["tasks"],
+          "properties": {
+            "type": { "const": "tool.progress" },
+            "phase": { "type": "string" },
+            "tasks": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["id", "label", "status"],
+                "properties": {
+                  "id": { "type": "string" },
+                  "label": { "type": "string" },
+                  "status": { "enum": ["pending", "running", "completed", "failed"] },
+                  "detail": { "type": "string" }
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "contextUsage": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["usedTokens", "maxTokens", "percent"],
+          "properties": {
+            "type": { "const": "context.usage" },
+            "usedTokens": { "type": "integer", "minimum": 0 },
+            "maxTokens": { "type": "integer", "minimum": 0 },
+            "percent": { "type": "number", "minimum": 0, "maximum": 100 }
+          }
+        }
+      ]
+    },
+    "chatTitle": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["title"],
+          "properties": { "type": { "const": "chat.title" }, "title": { "type": "string" } }
+        }
+      ]
+    },
+    "maxSteps": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["maxSteps", "canContinue"],
+          "properties": {
+            "type": { "const": "max_steps" },
+            "maxSteps": { "type": "integer", "minimum": 1 },
+            "canContinue": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "messageEnd": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "properties": {
+            "type": { "const": "message.end" },
+            "finishReason": { "type": "string" },
+            "usage": {
+              "type": "object",
+              "properties": {
+                "promptTokens": { "type": "integer" },
+                "completionTokens": { "type": "integer" },
+                "totalTokens": { "type": "integer" }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "error": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        {
+          "type": "object",
+          "required": ["code", "message"],
+          "properties": {
+            "type": { "const": "error" },
+            "code": { "type": "string" },
+            "message": { "type": "string" }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/stream-request.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sveda-ai.dev/schemas/v1/stream-request.schema.json",
+  "title": "Sveda Wire Protocol v1 — Stream Request",
+  "description": "Client-to-server POST body for /sveda/stream.",
+  "type": "object",
+  "required": ["messages"],
+  "properties": {
+    "messages": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["role"],
+        "properties": {
+          "id": { "type": "string" },
+          "role": { "enum": ["user", "assistant", "system", "tool"] },
+          "content": { "type": "string" },
+          "parts": { "type": "array", "items": { "type": "object" } }
+        }
+      }
+    },
+    "chatId": { "type": "string" },
+    "context": {
+      "type": "object",
+      "description": "Host-provided context: page, host page, global readables."
+    },
+    "clientTools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "description", "parameters"],
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "parameters": { "type": "object", "description": "JSON Schema of tool input" }
+        }
+      }
+    },
+    "model": { "type": "string" },
+    "provider": { "type": "string" },
+    "options": { "type": "object" }
+  }
+}

package/src/events.ts

@@ -0,0 +1,179 @@
+export const SVEDA_PROTOCOL_VERSION = '1.0' as const;
+
+export const SVEDA_STREAM_EVENTS = [
+  'message.start',
+  'text.delta',
+  'reasoning.delta',
+  'tool.call',
+  'tool.result',
+  'tool.progress',
+  'context.usage',
+  'chat.title',
+  'max_steps',
+  'message.end',
+  'error',
+] as const;
+
+export type SvedaStreamEventType = (typeof SVEDA_STREAM_EVENTS)[number];
+
+export type SvedaToolTarget = 'backend' | 'frontend';
+
+export type SvedaRenderHint =
+  | 'confirm_dialog'
+  | 'resource_links'
+  | 'plain'
+  | 'custom';
+
+export interface SvedaStreamEventBase {
+  type: SvedaStreamEventType;
+  chatId?: string;
+  messageId?: string;
+  timestamp?: string;
+}
+
+export interface SvedaMessageStartEvent extends SvedaStreamEventBase {
+  type: 'message.start';
+}
+
+export interface SvedaTextDeltaEvent extends SvedaStreamEventBase {
+  type: 'text.delta';
+  delta: string;
+}
+
+export interface SvedaReasoningDeltaEvent extends SvedaStreamEventBase {
+  type: 'reasoning.delta';
+  delta: string;
+}
+
+export interface SvedaToolCallEvent extends SvedaStreamEventBase {
+  type: 'tool.call';
+  toolCallId: string;
+  toolName: string;
+  target: SvedaToolTarget;
+  input: Record<string, unknown>;
+}
+
+export interface SvedaToolResultEvent extends SvedaStreamEventBase {
+  type: 'tool.result';
+  toolCallId: string;
+  toolName: string;
+  output: unknown;
+  renderHint?: SvedaRenderHint;
+  renderData?: Record<string, unknown>;
+}
+
+export interface SvedaToolProgressTask {
+  id: string;
+  label: string;
+  status: 'pending' | 'running' | 'completed' | 'failed';
+  detail?: string;
+}
+
+export interface SvedaToolProgressEvent extends SvedaStreamEventBase {
+  type: 'tool.progress';
+  phase?: string;
+  tasks: SvedaToolProgressTask[];
+}
+
+export interface SvedaContextUsageEvent extends SvedaStreamEventBase {
+  type: 'context.usage';
+  usedTokens: number;
+  maxTokens: number;
+  percent: number;
+}
+
+export interface SvedaChatTitleEvent extends SvedaStreamEventBase {
+  type: 'chat.title';
+  title: string;
+}
+
+export interface SvedaMaxStepsEvent extends SvedaStreamEventBase {
+  type: 'max_steps';
+  maxSteps: number;
+  canContinue: boolean;
+}
+
+export interface SvedaMessageEndEvent extends SvedaStreamEventBase {
+  type: 'message.end';
+  finishReason?: string;
+  usage?: {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+  };
+}
+
+export interface SvedaErrorEvent extends SvedaStreamEventBase {
+  type: 'error';
+  code: string;
+  message: string;
+}
+
+export type SvedaStreamEvent =
+  | SvedaMessageStartEvent
+  | SvedaTextDeltaEvent
+  | SvedaReasoningDeltaEvent
+  | SvedaToolCallEvent
+  | SvedaToolResultEvent
+  | SvedaToolProgressEvent
+  | SvedaContextUsageEvent
+  | SvedaChatTitleEvent
+  | SvedaMaxStepsEvent
+  | SvedaMessageEndEvent
+  | SvedaErrorEvent;
+
+export interface SvedaClientToolDefinition {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>;
+}
+
+export interface SvedaChatMessage {
+  id?: string;
+  role: 'user' | 'assistant' | 'system' | 'tool';
+  content?: string;
+  parts?: Array<Record<string, unknown>>;
+}
+
+export interface SvedaStreamRequest {
+  messages: SvedaChatMessage[];
+  prompt?: string;
+  chatId?: string;
+  context?: Record<string, unknown>;
+  clientTools?: SvedaClientToolDefinition[];
+  model?: string;
+  provider?: string;
+  options?: Record<string, unknown>;
+}
+
+export function isSvedaStreamEvent(value: unknown): value is SvedaStreamEvent {
+  if (!value || typeof value !== 'object') {
+    return false;
+  }
+
+  const type = (value as { type?: unknown }).type;
+  return typeof type === 'string' && (SVEDA_STREAM_EVENTS as readonly string[]).includes(type);
+}
+
+export function parseSvedaStreamLine(line: string): SvedaStreamEvent | null {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('data:')) {
+    return null;
+  }
+
+  const payload = trimmed.slice(5).trim();
+  if (!payload || payload === '[DONE]') {
+    return null;
+  }
+
+  try {
+    const parsed = JSON.parse(payload) as unknown;
+    if (isSvedaStreamEvent(parsed)) {
+      return parsed;
+    }
+
+    return null;
+  } catch {
+    return null;
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './events.js';
+export * from './vercelAdapter.js';

package/src/vercelAdapter.ts

@@ -0,0 +1,139 @@
+import type { SvedaRenderHint, SvedaStreamEvent } from './events.js';
+
+export type VercelDataPart = {
+  type: string;
+  [key: string]: unknown;
+};
+
+export function svedaEventToVercelDataPart(event: SvedaStreamEvent): VercelDataPart | null {
+  switch (event.type) {
+    case 'text.delta':
+      return { type: 'text-delta', textDelta: event.delta };
+    case 'reasoning.delta':
+      return { type: 'reasoning-delta', reasoningDelta: event.delta };
+    case 'tool.call':
+      return {
+        type: 'tool-call',
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        args: event.input,
+        target: event.target,
+      };
+    case 'tool.result':
+      return {
+        type: 'tool-result',
+        toolCallId: event.toolCallId,
+        toolName: event.toolName,
+        result: event.output,
+        renderHint: event.renderHint,
+        renderData: event.renderData,
+      };
+    case 'tool.progress':
+      return {
+        type: 'data-toolProgress',
+        data: { phase: event.phase, tasks: event.tasks },
+      };
+    case 'context.usage':
+      return {
+        type: 'data-contextUsage',
+        data: {
+          usedTokens: event.usedTokens,
+          maxTokens: event.maxTokens,
+          percent: event.percent,
+        },
+      };
+    case 'chat.title':
+      return { type: 'data-chatTitle', data: { title: event.title } };
+    case 'max_steps':
+      return {
+        type: 'data-maxStepsReached',
+        data: { maxSteps: event.maxSteps, canContinue: event.canContinue },
+      };
+    case 'message.end':
+      return {
+        type: 'finish',
+        finishReason: event.finishReason ?? 'stop',
+        usage: event.usage,
+      };
+    case 'error':
+      return { type: 'error', error: { code: event.code, message: event.message } };
+    default:
+      return null;
+  }
+}
+
+export function vercelDataPartToSvedaEvent(part: VercelDataPart): SvedaStreamEvent | null {
+  const data = (part.data ?? {}) as Record<string, unknown>;
+
+  switch (part.type) {
+    case 'text-delta':
+      return { type: 'text.delta', delta: String(part.textDelta ?? '') };
+    case 'reasoning-delta':
+      return { type: 'reasoning.delta', delta: String(part.reasoningDelta ?? '') };
+    case 'tool-call':
+      return {
+        type: 'tool.call',
+        toolCallId: String(part.toolCallId ?? ''),
+        toolName: String(part.toolName ?? ''),
+        target: part.target === 'frontend' ? 'frontend' : 'backend',
+        input: (part.args as Record<string, unknown>) ?? {},
+      };
+    case 'tool-result':
+      return {
+        type: 'tool.result',
+        toolCallId: String(part.toolCallId ?? ''),
+        toolName: String(part.toolName ?? ''),
+        output: part.result,
+        renderHint: part.renderHint as SvedaRenderHint | undefined,
+        renderData: part.renderData as Record<string, unknown> | undefined,
+      };
+    case 'data-toolProgress': {
+      const tasks = Array.isArray(data.tasks) ? data.tasks : [];
+      return {
+        type: 'tool.progress',
+        phase: typeof data.phase === 'string' ? data.phase : undefined,
+        tasks: tasks as Array<{
+          id: string;
+          label: string;
+          status: 'pending' | 'running' | 'completed' | 'failed';
+          detail?: string;
+        }>,
+      };
+    }
+    case 'data-contextUsage':
+      return {
+        type: 'context.usage',
+        usedTokens: Number(data.usedTokens ?? 0),
+        maxTokens: Number(data.maxTokens ?? 0),
+        percent: Number(data.percent ?? 0),
+      };
+    case 'data-chatTitle':
+      return { type: 'chat.title', title: String(data.title ?? '') };
+    case 'data-maxStepsReached':
+      return {
+        type: 'max_steps',
+        maxSteps: Number(data.maxSteps ?? 0),
+        canContinue: Boolean(data.canContinue ?? true),
+      };
+    case 'finish':
+      return {
+        type: 'message.end',
+        finishReason: String(part.finishReason ?? 'stop'),
+        usage: part.usage as { promptTokens?: number; completionTokens?: number; totalTokens?: number } | undefined,
+      };
+    case 'error': {
+      const error = (part.error ?? {}) as Record<string, unknown>;
+      return {
+        type: 'error',
+        code: String(error.code ?? 'unknown'),
+        message: String(error.message ?? 'Unknown error'),
+      };
+    }
+    default:
+      return null;
+  }
+}
+
+export function encodeSvedaStreamEvent(event: SvedaStreamEvent): string {
+  return `data: ${JSON.stringify(event)}\n\n`;
+}