@streamoid/agent 0.2.5 → 0.2.6

package/README.md

@@ -23,19 +23,6 @@ import "@streamoid/agent/style.css";
 - **API base:** use a relative base and proxy `/stream-agent/api/v1` to the agent
   backend from the host (same-origin → cookies flow, no CORS).
 
-## ⚠️ This package is a prebuilt bundle — do not edit `dist/` here
-
-The source and build live in the **stream-agent** repo (the chat shell is
-~14,700 lines and is bundled from there). This package only **ships** the built
-artifact. To update:
-
-```bash
-# in stream-agent
-cd frontend && npm run build:lib           # produces frontend/dist-lib/
-
-# copy the build into this package, then bump version + publish
-cp frontend/dist-lib/{index.js,style.css,index.d.ts} <npm-components>/packages/agent/dist/
-cd <npm-components>/packages/agent && npm version <x.y.z> && npm publish
-```
-
-(Superseded the iframe-backed `0.1.0`; that build's source remains in git history.)
+> This is the **built** package, committed for publish provenance. It is generated
+> from the stream-agent frontend via `npm run build:lib` — do not hand-edit.
+> Rebuild and `npm publish` from this directory.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { CSSProperties, ReactElement } from 'react';
+import type { CSSProperties, ReactElement, ReactNode } from 'react';
 
 /* Public types for the native @streamoid/agent package.
  *
@@ -48,6 +48,43 @@ export interface AgentChatShellAdapters {
   /** Backend recovered after an outage — host decides what to do (must NOT
    *  reload the host window). */
   onBackendRecovered?: () => void;
+  /**
+   * Supply the canvas as a component and the Dreamer panel drops its iframe:
+   * no embedded page, so no cross-origin auth, no postMessage handshake, no
+   * allowed-origins config per environment.
+   *
+   * The host owns the implementation because it must — the Artifax canvas is
+   * consumed cross-repo as SOURCE (a submodule compiled by the host's own Vite,
+   * with a forked PixiJS + shader loader), which this prebuilt package cannot
+   * import.
+   *
+   * `projectId` is often the literal `_`, Artifax's "resolve the default
+   * project" placeholder. Pass it through verbatim — Artifax's own canvas route
+   * does the same.
+   *
+   * Omit this and the iframe path runs unchanged; it is purely additive.
+   */
+  canvas?: HostCanvasContextValue;
+}
+
+export interface HostCanvasContextValue {
+  render(context: {
+    workspaceId: string;
+    projectId: string;
+    documentId: string;
+    sessionId: string;
+    threadId?: string;
+    /** External-session token under the `bridge` prompt transport; the canvas
+     *  needs it to run the Dreamer agent that executes the chat's commands.
+     *  Absent under `a2a`, where the Dreamer runs server-side. */
+    sessionToken?: string;
+    /** Call once the canvas is live and its external-session bridge can receive
+     *  work. Prompts are HELD until this fires — the backend drives the existing
+     *  browser session through Artifax A2A and assumes a listener is already
+     *  subscribed; sending early makes Artifax close the stream and the chat
+     *  hang. Replaces the iframe's `artifax:iframe-ready` postMessage. */
+    onCanvasReady(): void;
+  }): ReactNode;
 }
 
 export type AgentPanelAdapters = AgentChatShellAdapters;