@almadar/ui 6.22.0 → 6.23.0

package/dist/{EntityBindingContext-DoK8Xq71.d.cts → EntityBindingContext-CTZw2DbY.d.cts}

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
         traitName: string;
         result: TransitionResult;
-    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/{EntityBindingContext-DoK8Xq71.d.ts → EntityBindingContext-CTZw2DbY.d.ts}

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
         traitName: string;
         result: TransitionResult;
-    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/providers/index.cjs

@@ -54647,7 +54647,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54667,7 +54667,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // `traits`" would make the mount-time case indistinguishable from
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
-        ...entityByTrait ? { entityByTrait } : {}
+        ...entityByTrait ? { entityByTrait } : {},
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54716,9 +54717,9 @@ function ServerBridgeProvider({
   );
   const tickRelay = React89.useMemo(
     () => createTickSendRelay(async (_key, snap) => {
-      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait);
+      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait, void 0, void 0, schema.name);
     }),
-    [transport]
+    [transport, schema.name]
   );
   React89.useEffect(() => () => tickRelay.clear(), [tickRelay]);
   const commandPump = React89.useMemo(createCommandSendPump, []);
@@ -54739,7 +54740,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};
@@ -54820,7 +54821,7 @@ function ServerBridgeProvider({
         return { effects: [], meta: { ...emptyMeta, error: msg } };
       }
     });
-  }, [connected, transport, eventBus, tickRelay, commandPump]);
+  }, [connected, transport, eventBus, tickRelay, commandPump, schema.name]);
   React89.useEffect(() => {
     if (!schema) return;
     let cancelled = false;

package/dist/providers/index.d.cts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.cjs';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.cjs';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.cjs';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.cjs';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';

package/dist/providers/index.d.ts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.js';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.js';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.js';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.js';
 import '../verificationRegistry-Cwa52VyK.js';

package/dist/providers/index.js

@@ -54573,7 +54573,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54593,7 +54593,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // `traits`" would make the mount-time case indistinguishable from
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
-        ...entityByTrait ? { entityByTrait } : {}
+        ...entityByTrait ? { entityByTrait } : {},
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54642,9 +54643,9 @@ function ServerBridgeProvider({
   );
   const tickRelay = useMemo(
     () => createTickSendRelay(async (_key, snap) => {
-      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait);
+      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait, void 0, void 0, schema.name);
     }),
-    [transport]
+    [transport, schema.name]
   );
   useEffect(() => () => tickRelay.clear(), [tickRelay]);
   const commandPump = useMemo(createCommandSendPump, []);
@@ -54665,7 +54666,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};
@@ -54746,7 +54747,7 @@ function ServerBridgeProvider({
         return { effects: [], meta: { ...emptyMeta, error: msg } };
       }
     });
-  }, [connected, transport, eventBus, tickRelay, commandPump]);
+  }, [connected, transport, eventBus, tickRelay, commandPump, schema.name]);
   useEffect(() => {
     if (!schema) return;
     let cancelled = false;

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.22.0",
+  "version": "6.23.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [