@aiworkbench/vibe-types 0.0.3 → 0.0.5

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * The Host injects a bridge object into each mini-app based on
  * the permissions declared in its manifest.json.
  */
-export type BridgeCapability = "auth" | "api" | "navigation" | "theme" | "toast" | "storage" | "events";
+export type BridgeCapability = "auth" | "api" | "navigation" | "theme" | "toast" | "storage" | "events" | "chat";
 export interface BridgeUser {
     id: string;
     name: string;
@@ -52,6 +52,54 @@ export interface EventsBridge {
     /** Subscribe once, then auto-unsubscribe. Returns an unsubscribe function. */
     once(event: string, handler: (payload: EventPayload) => void): () => void;
 }
+/** A single part within a chat message. */
+export type ChatPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "data";
+    data: unknown;
+} | {
+    type: "file";
+    file: {
+        name: string;
+        mimeType: string;
+        uri: string;
+    };
+};
+/** A server-sent event from the A2A stream. */
+export interface ChatStreamEvent {
+    kind: string;
+    [key: string]: unknown;
+}
+/** Options for sending a chat message. */
+export interface ChatSendOptions {
+    /** Conversation thread identifier. */
+    contextId?: string;
+    /** Caller-supplied message id. */
+    messageId?: string;
+    /** Arbitrary metadata forwarded to the agent. */
+    metadata?: unknown;
+    /** Abort signal to cancel the stream. */
+    signal?: AbortSignal;
+}
+/** An async-iterable stream of chat events with an abort handle. */
+export interface ChatStream {
+    [Symbol.asyncIterator](): AsyncIterableIterator<ChatStreamEvent>;
+    /** Cancel the in-flight stream. */
+    abort(): void;
+}
+export interface ChatBridge {
+    /**
+     * Send a message to an A2A-compatible agent and stream the response.
+     *
+     * @param serverUrl - Base URL of the A2A agent server.
+     * @param parts     - Message parts to send.
+     * @param options   - Optional context, message id, metadata, abort signal.
+     * @returns An async-iterable stream of `ChatStreamEvent` objects.
+     */
+    send(serverUrl: string, parts: ChatPart[], options?: ChatSendOptions): ChatStream;
+}
 export interface Bridge {
     auth: AuthBridge;
     navigation: NavigationBridge;
@@ -60,11 +108,20 @@ export interface Bridge {
     api: ApiBridge;
     storage: StorageBridge;
     events: EventsBridge;
+    chat: ChatBridge;
 }
 /** Props passed to every mini-app component. */
 export interface VibeProps {
     bridge: Bridge;
 }
+export interface VibeApiProxyHostConfig {
+    /** Default upstream target used by hosts that support proxy overrides. */
+    defaultTarget?: string;
+}
+export interface VibeHostConfig {
+    /** Host-managed settings for API proxy configuration. */
+    apiProxy?: VibeApiProxyHostConfig;
+}
 /** Manifest schema for a mini-app. */
 export interface VibeManifest {
     id: string;
@@ -73,6 +130,7 @@ export interface VibeManifest {
     permissions: BridgeCapability[];
     description: string;
     entry?: string;
+    hostConfig?: VibeHostConfig;
 }
 /** A published mini-app entry in the registry. */
 export interface RegistryEntry extends VibeManifest {

package/dist/index.d.ts.map

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

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@aiworkbench/vibe-types",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "publishConfig": { "access": "public" },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
@@ -19,5 +18,5 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build"
   },
-  "files": ["dist", "src"]
+  "files": ["dist"]
 }

package/src/index.ts

@@ -1,154 +0,0 @@
-/**
- * @aiworkbench/vibe-types
- *
- * Bridge interface — the contract between the Host application
- * and micro-frontend mini-apps.
- *
- * The Host injects a bridge object into each mini-app based on
- * the permissions declared in its manifest.json.
- */
-
-// ---------------------------------------------------------------------------
-// Capability type
-// ---------------------------------------------------------------------------
-
-export type BridgeCapability =
-  | "auth"
-  | "api"
-  | "navigation"
-  | "theme"
-  | "toast"
-  | "storage"
-  | "events";
-
-// ---------------------------------------------------------------------------
-// Auth
-// ---------------------------------------------------------------------------
-
-export interface BridgeUser {
-  id: string;
-  name: string;
-  email?: string;
-}
-
-export interface AuthBridge {
-  getUser(): BridgeUser;
-  getToken(): Promise<string>;
-}
-
-// ---------------------------------------------------------------------------
-// Navigation
-// ---------------------------------------------------------------------------
-
-export interface NavigationBridge {
-  navigate(path: string): void;
-}
-
-// ---------------------------------------------------------------------------
-// Theme
-// ---------------------------------------------------------------------------
-
-export interface ThemeBridge {
-  current(): "light" | "dark";
-}
-
-// ---------------------------------------------------------------------------
-// Toast
-// ---------------------------------------------------------------------------
-
-export interface ToastBridge {
-  show(
-    message: string,
-    options?: { type?: "info" | "success" | "error" },
-  ): void;
-}
-
-// ---------------------------------------------------------------------------
-// API
-// ---------------------------------------------------------------------------
-
-export interface ApiBridge {
-  fetch(endpoint: string, options?: RequestInit): Promise<Response>;
-}
-
-// ---------------------------------------------------------------------------
-// Storage — namespaced key-value persistence
-// ---------------------------------------------------------------------------
-
-export interface StorageBridge {
-  /** Get a value by key. Returns null if not found. */
-  get(key: string): Promise<string | null>;
-  /** Set a key-value pair. */
-  set(key: string, value: string): Promise<void>;
-  /** Remove a key. */
-  remove(key: string): Promise<void>;
-  /** List all keys in this mini-app's namespace. */
-  keys(): Promise<string[]>;
-}
-
-// ---------------------------------------------------------------------------
-// Events — typed pub/sub between mini-app and host
-// ---------------------------------------------------------------------------
-
-export interface EventPayload {
-  [key: string]: unknown;
-}
-
-export interface EventsBridge {
-  /** Emit an event to the host. */
-  emit(event: string, payload?: EventPayload): void;
-  /** Subscribe to events from the host. Returns an unsubscribe function. */
-  on(event: string, handler: (payload: EventPayload) => void): () => void;
-  /** Subscribe once, then auto-unsubscribe. Returns an unsubscribe function. */
-  once(event: string, handler: (payload: EventPayload) => void): () => void;
-}
-
-// ---------------------------------------------------------------------------
-// Composite Bridge
-// ---------------------------------------------------------------------------
-
-export interface Bridge {
-  auth: AuthBridge;
-  navigation: NavigationBridge;
-  theme: ThemeBridge;
-  toast: ToastBridge;
-  api: ApiBridge;
-  storage: StorageBridge;
-  events: EventsBridge;
-}
-
-/** Props passed to every mini-app component. */
-export interface VibeProps {
-  bridge: Bridge;
-}
-
-/** Manifest schema for a mini-app. */
-export interface VibeManifest {
-  id: string;
-  version: string;
-  framework: "react" | "vue" | "vanilla";
-  permissions: BridgeCapability[];
-  description: string;
-  entry?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Registry — published mini-app metadata
-// ---------------------------------------------------------------------------
-
-/** A published mini-app entry in the registry. */
-export interface RegistryEntry extends VibeManifest {
-  /** URL to the ES module bundle on storage. */
-  bundleUrl: string;
-  /** SRI hash (sha384-…). */
-  integrity: string;
-  /** Raw bundle size in bytes. */
-  bundleSizeBytes?: number;
-  /** ISO 8601 publish timestamp. */
-  publishedAt: string;
-  /** Publisher identity (e.g. GitHub username). */
-  publishedBy: string;
-}
-
-/** An environment's apps.json file — an array of published entries. */
-export type RegistryManifest = RegistryEntry[];