@cef-ai/widget-runtime 2.2.2 → 2.3.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { buildWidgetManifest, type BuildManifestInput } from './manifest.js';
 export { injectWidgetBridge, type BridgeInput } from './bridge.js';
-export type { WidgetManifest, WidgetRuntimeApi, Identity, QueryResult } from './types.js';
+export type { WidgetManifest, WidgetRuntimeApi, Identity, QueryResult, PublishOptions } from './types.js';
 export { AgentNotConnectedError } from './types.js';
 export { validateConfig } from './validate-config.js';
 export { mountKind } from './mount.js';

package/dist/runtime.js

@@ -37,7 +37,7 @@ export function createWidgetRuntime(manifest, deps) {
     }
     return {
         async query(ref, params) { return (await ensureClient()).query(ref, params); },
-        async publish(type, payload, context) { return (await ensureClient()).publish(type, payload, context); },
+        async publish(type, payload, context, options) { return (await ensureClient()).publish(type, payload, context, options); },
         async identity() {
             await ensureClient();
             return { publicKey, status, ...(context ? { context } : {}) };

package/dist/types.d.ts

@@ -108,9 +108,21 @@ export interface QueryResult {
         rowCount: number;
     };
 }
+export interface PublishOptions {
+    /** The one agent this event is for, `<asPubkey>:<name>`. */
+    target?: string;
+}
 export interface WidgetRuntimeApi {
     query(ref: string, params?: unknown[]): Promise<QueryResult>;
-    publish(type: string, payload: unknown, context?: string): Promise<{
+    /**
+     * Publish an event into the widget's scope.
+     *
+     * `target` addresses one agent (`<asPubkey>:<name>`). A workflow is started
+     * this way: its manifest handles the runner's fixed set (`workflow.start`,
+     * …), never the trigger's own event type, so an untargeted `workflow.start`
+     * would start every workflow connected in the scope.
+     */
+    publish(type: string, payload: unknown, context?: string, options?: PublishOptions): Promise<{
         eventId: string;
     }>;
     identity(): Promise<Identity>;

package/dist/vault-client.d.ts

@@ -1,4 +1,4 @@
-import { type QueryResult, type WidgetManifest } from './types.js';
+import { type QueryResult, type WidgetManifest, type PublishOptions } from './types.js';
 export interface VaultSdkLike {
     vault: {
         ensure: (opts?: {
@@ -115,7 +115,7 @@ interface AgentHandleLike {
 }
 export interface VaultClient {
     query(ref: string, params?: unknown[]): Promise<QueryResult>;
-    publish(type: string, payload: unknown, context?: string): Promise<{
+    publish(type: string, payload: unknown, context?: string, options?: PublishOptions): Promise<{
         eventId: string;
     }>;
     connectAgent(): Promise<void>;

package/dist/vault-client.js

@@ -218,9 +218,14 @@ hostVaultId) {
             }
             return normaliseQueryResult(await queryService(decl ?? { id: ref, label: ref, sql: ref }, params ?? []));
         },
-        async publish(type, payload, context) {
+        async publish(type, payload, context, options) {
             const vault = await getVault();
-            return vault.scope(manifest.scope).publish({ type, context: context ?? '', payload });
+            return vault.scope(manifest.scope).publish({
+                type,
+                context: context ?? '',
+                payload,
+                ...(options?.target ? { target: options.target } : {}),
+            });
         },
         async connectAgent() {
             const vault = await getVault();