@neuralis/brain-core 0.3.0 → 0.3.2

package/app/filesystem/ui/SourcesPanel.tsx

@@ -30,7 +30,7 @@ import {
   type LucideIcon,
 } from 'lucide-react';
 import { meetsRequires } from '@neuralis/package-system/access';
-import { SkillLauncher } from '@neuralis/package-system/client';
+import { SkillLauncher, createPackageApi } from '@neuralis/package-system/client';
 import { cn } from '../lib/cn';
 import {
   listSourceConfigs,
@@ -55,7 +55,7 @@ import {
   type DiscoverableSourceSuggestion,
 } from '../api';
 import { dimmedSourceTone, getSourceVisualTone, sourceLiveReasonLabel } from '../lib/treeVisualState';
-import { rootFieldMeta } from '../lib/sourceKindForm';
+import { fieldControl, rootFieldMeta, selectOptionsFrom, type OptionsRoute, type SelectOption } from '../lib/sourceKindForm';
 import { resolveIconWithFallback, resolveLucideIcon } from '../lib/iconResolver';
 import { useFilesystemStore } from '../store/filesystemStore';
 import { fileKey, sourceFromUri, sourceRootUri } from '../store/helpers';
@@ -479,6 +479,8 @@ export function SourcesPanel(props: Props) {
   const setPendingSourceSuggestion = useFilesystemStore((s) => s.setPendingSourceSuggestion);
   const refresh = useFilesystemStore((s) => s.refresh);
   const sourceSummaries = useFilesystemStore((s) => s.sources);
+  // A `devices` frame bumps it: the device `select` re-reads its options.
+  const deviceRevision = useFilesystemStore((s) => s.deviceRevision);
 
   // Source-key suggestion inputs: the signed-in user (for the user-scope
   // qualifier) and the active agent's name (for the agent-scope qualifier).
@@ -489,13 +491,13 @@ export function SourcesPanel(props: Props) {
   // `recognizesPackages` toggle in the UI. Server is the enforcement floor; this
   // only HIDES the control. Undefined priority (no signal) ⇒ hide (deny-by-default).
   const isOwnerEffective = (host.currentRole?.priority ?? 99) <= 2;
-  // warded-wren — affordance mirror for the `drive.mount` gate that now covers
+  // warded-wren — affordance mirror for the `sources.mount` gate that now covers
   // browse and the discoverable list. Same shape as `FileTree`'s: the ONE shared
   // kernel predicate, a copy at the boundary because the host keeps the grant
   // list readonly, and it authorizes NOTHING — the routes stay the boundary.
   // Hidden, never a disabled row (the S2 discipline).
   const canMount = useMemo(
-    () => meetsRequires({ grantedFeatures: [...(host.grantedFeatures ?? [])] }, { features: ['drive.mount'] }),
+    () => meetsRequires({ grantedFeatures: [...(host.grantedFeatures ?? [])] }, { features: ['sources.mount'] }),
     [host.grantedFeatures],
   );
   const agentSlug = useMemo(() => {
@@ -609,8 +611,8 @@ export function SourcesPanel(props: Props) {
   const selectedKindNeedsPath = rootField.needed;
   // The container-plane affordances: the `/mounts` volume picker, the
   // `neuralis:mount` callout, and Browse (which readdirs in the SERVER process,
-  // i.e. the wrong machine for a host-plane root — a host root's authority is
-  // the operator's broker ceiling, not this process's view of the disk).
+  // i.e. the wrong machine for a host-plane root — that root lives on the paired
+  // device chosen below, bounded by that device's own allowlist).
   const showContainerPathChrome = selectedKindNeedsPath && rootField.container;
 
   /**
@@ -1420,7 +1422,7 @@ export function SourcesPanel(props: Props) {
                 ? 'This connector does not need a local path. Choose the scope and URI scheme; the package owns the runtime binding.'
                 : rootField.container
                   ? 'Mount any folder from your system. The path must be accessible to the server process.'
-                  : 'A path on the operator\u2019s host machine, reached through the host broker. It needs no volume mount here, and the broker ceiling still clamps what is reachable.'}
+                  : 'A folder on the device you choose below \u2014 your own paired machine. It needs no volume mount here; that device\u2019s own allowlist (neuralis device grant) still limits what is reachable.'}
             </div>
           )}
           <div className="space-y-2">
@@ -1466,23 +1468,41 @@ export function SourcesPanel(props: Props) {
             </div>
             {Object.entries(schemaObject(selectedKind).properties)
               .filter(([key]) => key !== 'root')
-              .map(([key, prop]) => (
-                <div key={key} className="space-y-1">
-                  <div className="text-[9px] font-semibold uppercase tracking-wider text-white/35">
-                    {(prop as any)?.['x-neuralis']?.ui?.label ?? key}
+              .map(([key, prop]) => {
+                const field = fieldControl(prop, selectedKind?.packageId ?? '');
+                const setValue = (value: string) => setAddDraft((d) => ({
+                  ...d,
+                  config: { ...d.config, [key]: value },
+                }));
+                return (
+                  <div key={key} className="space-y-1">
+                    <div className="text-[9px] font-semibold uppercase tracking-wider text-white/35">
+                      {(prop as any)?.['x-neuralis']?.ui?.label ?? key}
+                    </div>
+                    {field.control === 'select' ? (
+                      <OptionsRouteSelect
+                        route={field.options}
+                        revision={deviceRevision}
+                        projectId={projectId}
+                        agentId={agentId}
+                        value={String(addDraft.config[key] ?? '')}
+                        onChange={setValue}
+                      />
+                    ) : (
+                      <input
+                        type={field.numeric ? 'number' : 'text'}
+                        value={String(addDraft.config[key] ?? '')}
+                        onChange={(e) => setValue(e.target.value)}
+                        placeholder={(prop as any)?.['x-neuralis']?.ui?.placeholder ?? (prop as any)?.description ?? key}
+                        className={inputCls}
+                      />
+                    )}
+                    {field.control === 'text' && field.refused ? (
+                      <div className="text-[9px] text-amber-300/80">{field.refused}</div>
+                    ) : null}
                   </div>
-                  <input
-                    type={(prop as any).type === 'number' || (prop as any).type === 'integer' ? 'number' : 'text'}
-                    value={String(addDraft.config[key] ?? '')}
-                    onChange={(e) => setAddDraft((d) => ({
-                      ...d,
-                      config: { ...d.config, [key]: e.target.value },
-                    }))}
-                    placeholder={(prop as any)?.['x-neuralis']?.ui?.placeholder ?? (prop as any)?.description ?? key}
-                    className={inputCls}
-                  />
-                </div>
-              ))}
+                );
+              })}
             {/* Directory browser (non-Docker only) */}
             {showContainerPathChrome && !isDocker && browseOpen && (
               <div className="rounded-md bg-white/[0.03] border border-white/[0.1] overflow-hidden">
@@ -1887,7 +1907,7 @@ export function SourcesPanel(props: Props) {
                       adjacent SkillLauncher hands the same uri-policy edit to
                       the agent. Its visibility is DERIVED from the host's
                       per-caller skill catalog (the `manage-uri-policy` skill
-                      declares `drive.policy` itself) — never re-stated here. */}
+                      declares `sources.policy` itself) — never re-stated here. */}
                   <div>
                     <div className="flex items-center gap-1.5 py-1">
                       <button type="button" onClick={() => toggleSubSection(config.source, 'perms')}
@@ -2355,3 +2375,83 @@ export function SourcesPanel(props: Props) {
     </div>
   );
 }
+
+// ---------------------------------------------------------------------------
+// `select` field: options answered by a route in the DECLARING package
+// ---------------------------------------------------------------------------
+
+/**
+ * A dimmed option (an offline device): a muted text colour mixed OPAQUE into
+ * the option's own surface, inline — the global `select option` rule outranks
+ * any utility class, while an inline colour wins. Never `opacity`: the muted
+ * colour is computed opaque against the same surface the option paints.
+ */
+const DIMMED_OPTION_STYLE = {
+  color: 'color-mix(in srgb, var(--control-text) 48%, rgb(var(--w-composer-bg-rgb, 30, 32, 38)))',
+} as const;
+
+/**
+ * A config field declared `x-neuralis.ui.control: "select"`. ONE request per
+ * mount (and per project/agent change) to the declaring package's
+ * `optionsRoute`, through that package's own route client — never this
+ * package's — and ONE quiet re-read per `revision` bump (a burst of `devices`
+ * frames): the shown list stays until the new answer replaces it. A failed
+ * load is SHOWN, never an empty list; the list is UX only, the declaring
+ * package re-checks the value when the source is created.
+ */
+function OptionsRouteSelect({
+  route,
+  revision,
+  projectId,
+  agentId,
+  value,
+  onChange,
+}: {
+  route: OptionsRoute;
+  revision: number;
+  projectId?: string | null;
+  agentId: string;
+  value: string;
+  onChange: (value: string) => void;
+}) {
+  const [options, setOptions] = useState<SelectOption[] | null>(null);
+  const [loadError, setLoadError] = useState<string | null>(null);
+  // The route is re-derived on every render; the effect keys on its VALUE.
+  const { slug, path } = route;
+  const query = new URLSearchParams(route.params).toString();
+  // A new route/project/agent starts from "Loading…"; a revision bump does not.
+  const scopeKey = `${slug}\n${path}\n${query}\n${projectId ?? ''}\n${agentId}`;
+  const loadedScope = useRef<string | null>(null);
+  useEffect(() => {
+    let live = true;
+    if (loadedScope.current !== scopeKey) {
+      loadedScope.current = scopeKey;
+      setOptions(null);
+    }
+    setLoadError(null);
+    const api = createPackageApi({
+      slug,
+      getProjectId: () => projectId ?? null,
+      getAgentId: () => agentId || null,
+    });
+    api.get<unknown>(path, Object.fromEntries(new URLSearchParams(query))).then(
+      (answer) => { if (live) setOptions(selectOptionsFrom(answer)); },
+      (err: unknown) => { if (live) setLoadError(err instanceof Error ? err.message : 'Could not load the options'); },
+    );
+    return () => { live = false; };
+  }, [slug, path, query, projectId, agentId, scopeKey, revision]);
+
+  if (loadError) return <div className="text-[9px] text-red-300/80">{loadError}</div>;
+  if (options === null) return <div className="text-[9px] text-white/30 animate-pulse">Loading…</div>;
+  if (options.length === 0) return <div className="text-[9px] text-white/40 italic">Nothing to choose from.</div>;
+  return (
+    <select value={value} onChange={(e) => onChange(e.target.value)} className={selectCls}>
+      <option value="" disabled>Choose…</option>
+      {options.map((o) => (
+        <option key={o.value} value={o.value} style={o.dimmed ? DIMMED_OPTION_STYLE : undefined}>
+          {o.label}
+        </option>
+      ))}
+    </select>
+  );
+}

package/app/filesystem/ui/VectorHealthPanel.tsx

@@ -76,8 +76,8 @@ const ACTION_COPY: Record<ActionKind, { label: string; explainer: string; toolti
 export function VectorHealthPanel({ agentId, projectId }: Props) {
   const client = useFilesystemStore((s) => s.client);
   const host = useFilesystemHost();
-  // A mirror only — the server's `drive.write` escalation is the gate.
-  const canWrite = hasFeature({ grantedFeatures: [...(host.grantedFeatures ?? [])] }, 'drive.write');
+  // A mirror only — the server's `files.write` escalation is the gate.
+  const canWrite = hasFeature({ grantedFeatures: [...(host.grantedFeatures ?? [])] }, 'files.write');
   const [report, setReport] = useState<HealthReport | null>(null);
   /** Snapshot taken right BEFORE a destructive action runs, so we can show a
    *  before/after delta on the stat cards once the post-action refetch lands. */