@percena/weft 0.4.0-next.4 → 0.4.0-next.6

package/dist/chat.d.cts

@@ -1,30 +1,30 @@
 export { EN_FALLBACK };
-import { AgentRuntime } from '@weft/runtime-core';
+import { AgentRuntime, AgentRuntimeKind } from '@weft/runtime-core';
 import '@weft/timeline';
 import '@weft/provider-flitro';
 
 /**
- * useAgentSession — the official L1 runtime-configuration API.
+ * useAgentSession — runtime-agnostic hook for managing an agent session.
  *
- * Wraps `createFlitroEmbedRuntime` in a hook: the host backend mints
- * `{ server, token, sessionId }` via `POST /v1/embed/sessions` and the
- * component renders `<TimelineAgentChatPanel runtime={session.runtime} />`.
+ * The hook is provider-agnostic: the caller supplies a `createRuntime`
+ * factory that returns any `AgentRuntime` implementation (Flitro, Claude
+ * Code, Codex, or a custom one).  The hook wraps it in a deferred
+ * lifecycle suitable for React 19 StrictMode.
  */
 
 interface UseAgentSessionOptions {
-    /** Agent server base URL, as returned by the embed bootstrap. */
-    server: string;
-    /** Scoped session token from the embed bootstrap. */
-    token: string;
-    /** Session bound to the token. */
+    /** Stable session identifier — runtime is recreated when this changes. */
     sessionId: string;
-    /** Fetch a fresh token from your backend when the current one expires. */
-    onTokenExpired?: () => Promise<string | undefined> | string | undefined;
+    /** Factory that produces the `AgentRuntime`. Called lazily on first interaction. */
+    createRuntime: () => AgentRuntime;
+    /** Provider name surfaced in the returned `AgentSession` (default `"agent"`). */
+    provider?: string;
+    /** Runtime kind surfaced before the real runtime is created (default `"app-server"`). */
+    runtimeKind?: AgentRuntimeKind;
 }
 interface AgentSession {
     runtime: AgentRuntime;
     sessionId: string;
-    server: string;
 }
 declare function useAgentSession(options: UseAgentSessionOptions): AgentSession;
 

package/dist/chat.d.ts

@@ -1,30 +1,30 @@
 export { EN_FALLBACK };
-import { AgentRuntime } from '@weft/runtime-core';
+import { AgentRuntime, AgentRuntimeKind } from '@weft/runtime-core';
 import '@weft/timeline';
 import '@weft/provider-flitro';
 
 /**
- * useAgentSession — the official L1 runtime-configuration API.
+ * useAgentSession — runtime-agnostic hook for managing an agent session.
  *
- * Wraps `createFlitroEmbedRuntime` in a hook: the host backend mints
- * `{ server, token, sessionId }` via `POST /v1/embed/sessions` and the
- * component renders `<TimelineAgentChatPanel runtime={session.runtime} />`.
+ * The hook is provider-agnostic: the caller supplies a `createRuntime`
+ * factory that returns any `AgentRuntime` implementation (Flitro, Claude
+ * Code, Codex, or a custom one).  The hook wraps it in a deferred
+ * lifecycle suitable for React 19 StrictMode.
  */
 
 interface UseAgentSessionOptions {
-    /** Agent server base URL, as returned by the embed bootstrap. */
-    server: string;
-    /** Scoped session token from the embed bootstrap. */
-    token: string;
-    /** Session bound to the token. */
+    /** Stable session identifier — runtime is recreated when this changes. */
     sessionId: string;
-    /** Fetch a fresh token from your backend when the current one expires. */
-    onTokenExpired?: () => Promise<string | undefined> | string | undefined;
+    /** Factory that produces the `AgentRuntime`. Called lazily on first interaction. */
+    createRuntime: () => AgentRuntime;
+    /** Provider name surfaced in the returned `AgentSession` (default `"agent"`). */
+    provider?: string;
+    /** Runtime kind surfaced before the real runtime is created (default `"app-server"`). */
+    runtimeKind?: AgentRuntimeKind;
 }
 interface AgentSession {
     runtime: AgentRuntime;
     sessionId: string;
-    server: string;
 }
 declare function useAgentSession(options: UseAgentSessionOptions): AgentSession;