@agent-native/core 0.111.4 → 0.113.0

package/corpus/templates/brain/app/lib/brain.ts

@@ -97,7 +97,13 @@ export interface ReviewItem {
     url?: string | null;
     timestampMs?: number | null;
   }>;
-  status?: "pending" | "queued" | "approved" | "rejected" | "needs_changes";
+  status?:
+    | "pending"
+    | "queued"
+    | "approved"
+    | "rejected"
+    | "needs_changes"
+    | "quarantine";
   visibility?: string;
   reviewerNotes?: string | null;
   createdBy?: string | null;
@@ -136,6 +142,11 @@ export interface BrainSource {
   } | null;
 }
 
+export interface CreateSourceResponse {
+  source: BrainSource;
+  ingestToken?: string;
+}
+
 export interface BrainOverviewResponse {
   metrics?: BrainMetric[];
   reviewQueue?: ReviewItem[];
@@ -182,6 +193,8 @@ export interface SearchEverythingResult {
   confidence?: number | null;
   updatedAt?: string | null;
   score?: number | null;
+  matchLane?: "semantic" | "keyword" | "hybrid" | string | null;
+  retrievalReason?: string | null;
 }
 
 export interface SearchEverythingResponse {
@@ -197,6 +210,20 @@ export interface SearchEverythingResponse {
   };
 }
 
+export interface BrainProject {
+  id: string;
+  title: string;
+  description?: string | null;
+  visibility?: string | null;
+  sourceIds?: string[];
+  isDefault?: boolean;
+  updatedAt?: string | null;
+}
+
+export interface BrainProjectsResponse {
+  projects?: BrainProject[];
+}
+
 export interface ReviewQueueResponse {
   count?: number;
   items?: ReviewItem[];
@@ -282,6 +309,25 @@ export interface BrainHealthResponse {
     lastCapturedAt?: string | null;
     counts?: Record<string, number>;
   };
+  privacy: {
+    classifier: {
+      configured: boolean;
+      model: string | null;
+      engine: string | null;
+      warning: string | null;
+    };
+    events: {
+      total: number;
+      suppressed: number;
+      quarantined: number;
+      released: number;
+      discarded: number;
+      expired: number;
+      counts?: Record<string, number>;
+      confidenceCounts?: Record<string, number>;
+    };
+    policyVersion: string;
+  };
   proposals: {
     pending: number;
     approved: number;
@@ -304,6 +350,37 @@ export interface BrainHealthResponse {
     total: number;
     counts?: Record<string, number>;
   };
+  searchIndex: {
+    indexVersion: string;
+    coverage: {
+      eligibleCaptures: number;
+      activeArtifacts: number;
+      indexedCaptures: number;
+      missingCaptures: number;
+      percent: number;
+    };
+    artifacts: {
+      total: number;
+      active: number;
+      stale: number;
+      deleted: number;
+      counts?: Record<string, number>;
+    };
+    embeddings: {
+      total: number;
+      active: number;
+      stale: number;
+      deleted: number;
+      counts?: Record<string, number>;
+    };
+    queue: {
+      pending: number;
+      failed: number;
+      stale: number;
+      total: number;
+      counts?: Record<string, number>;
+    };
+  };
   retrieval: {
     lastEval?: {
       mode: "product-demo" | "retrieval" | string;
@@ -867,6 +944,11 @@ export interface BrainSettings {
   requireCitations?: boolean;
   autoArchiveResolved?: boolean;
   notifyOnSourceErrors?: boolean;
+  privacyClassifierModel?: string;
+  privacyClassifierEngine?: string;
+  sensitivityCustomInstructions?: string;
+  publicChannelExclusionPatterns?: string[];
+  quarantineRetentionHours?: number;
 }
 
 export interface SettingsResponse {
@@ -951,6 +1033,11 @@ export const defaultSettings: BrainSettings = {
   requireCitations: true,
   autoArchiveResolved: true,
   notifyOnSourceErrors: true,
+  privacyClassifierModel: "",
+  privacyClassifierEngine: "",
+  sensitivityCustomInstructions: "",
+  publicChannelExclusionPatterns: [],
+  quarantineRetentionHours: 72,
 };
 
 export function viewFromPath(pathname: string): BrainView {

package/corpus/templates/brain/app/lib/ingest-handoff.ts

@@ -0,0 +1,35 @@
+import type { BrainSource, CreateSourceResponse } from "./brain";
+
+export const BRAIN_INGEST_PATH = "/api/_agent-native/brain/ingest";
+
+export interface OneTimeIngestHandoff {
+  endpoint: string;
+  ingestToken: string;
+  provider: "clips" | "generic";
+  source: BrainSource;
+  sourceKey: string;
+}
+
+export function createOneTimeIngestHandoff({
+  origin,
+  provider,
+  result,
+  sourceKey,
+}: {
+  origin: string;
+  provider: string;
+  result: CreateSourceResponse;
+  sourceKey: string;
+}): OneTimeIngestHandoff | null {
+  if (provider !== "clips" && provider !== "generic") return null;
+  const ingestToken = result.ingestToken?.trim();
+  const normalizedSourceKey = sourceKey.trim();
+  if (!ingestToken || !normalizedSourceKey) return null;
+  return {
+    endpoint: new URL(BRAIN_INGEST_PATH, origin).toString(),
+    ingestToken,
+    provider,
+    source: result.source,
+    sourceKey: normalizedSourceKey,
+  };
+}

package/corpus/templates/brain/app/routes/ops.tsx

@@ -44,6 +44,7 @@ import {
   type BrainDistillationQueueStatus,
   type BrainOpsQueueItem,
   type BrainOpsQueueResponse,
+  type BrainHealthResponse,
   statusLabel,
 } from "@/lib/brain";
 import { cn } from "@/lib/utils";
@@ -135,6 +136,21 @@ export default function OpsRoute() {
     RetryDistillationResponse,
     RetryDistillationRequest
   >("retry-distillation" as any);
+  const healthQuery = useActionQuery<BrainHealthResponse>(
+    "get-brain-health" as any,
+    {} as any,
+    { refetchInterval: 30_000 },
+  );
+  const semantic = (
+    healthQuery.data as BrainHealthResponse & {
+      semanticIndex?: {
+        coverage?: number;
+        embeddingLag?: number;
+        aclFreshness?: number;
+        suppressed?: number;
+      };
+    }
+  )?.semanticIndex;
 
   const items = (queueQuery.data?.items ?? []) as BrainOpsQueueItemWithReason[];
   const summary = queueQuery.data?.summary ?? emptySummary;
@@ -377,6 +393,37 @@ export default function OpsRoute() {
           />
         </div>
 
+        <section className="grid gap-3 rounded-md border border-border bg-muted/20 p-4">
+          <div>
+            <p className="text-sm font-medium">{t("ops.semanticIndex")}</p>
+            <p className="mt-1 text-xs leading-5 text-muted-foreground">
+              {t("ops.semanticIndexDescription")}
+            </p>
+          </div>
+          <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
+            <MetricCard
+              label={t("ops.indexCoverage")}
+              value={semantic?.coverage ?? "—"}
+              detail={t("ops.adminOnly")}
+            />
+            <MetricCard
+              label={t("ops.embeddingLag")}
+              value={semantic?.embeddingLag ?? "—"}
+              detail={t("ops.adminOnly")}
+            />
+            <MetricCard
+              label={t("ops.aclFreshness")}
+              value={semantic?.aclFreshness ?? "—"}
+              detail={t("ops.adminOnly")}
+            />
+            <MetricCard
+              label={t("ops.suppressed")}
+              value={semantic?.suppressed ?? "—"}
+              detail={t("ops.adminOnly")}
+            />
+          </div>
+        </section>
+
         <div className="flex flex-col gap-3 rounded-md border border-border bg-card p-4 sm:flex-row sm:items-center sm:justify-between">
           <div className="min-w-0">
             <p className="text-sm font-medium">{t("ops.retryControls")}</p>

package/corpus/templates/brain/app/routes/review.tsx

@@ -65,7 +65,7 @@ import { cn } from "@/lib/utils";
 
 type BrainT = ReturnType<typeof useT>;
 
-type ProposalStatus = "pending" | "approved" | "rejected";
+type ProposalStatus = "pending" | "approved" | "rejected" | "quarantine";
 
 interface ProposalDraft {
   title?: string;
@@ -337,6 +337,9 @@ export default function ReviewRoute() {
                 <SelectItem value="pending">{t("review.pending")}</SelectItem>
                 <SelectItem value="approved">{t("review.approved")}</SelectItem>
                 <SelectItem value="rejected">{t("review.rejected")}</SelectItem>
+                <SelectItem value="quarantine">
+                  {t("review.quarantine")}
+                </SelectItem>
               </SelectContent>
             </Select>
           </div>
@@ -349,6 +352,11 @@ export default function ReviewRoute() {
         ) : proposals.length ? (
           <div className="grid gap-4">
             {proposals.map((proposal) => {
+              if (status === "quarantine") {
+                return (
+                  <QuarantineMetadataCard key={proposal.id} item={proposal} />
+                );
+              }
               const evidence = proposal.evidence ?? [];
               const sourceUrl = firstSourceUrl(proposal);
               const canReview = proposal.status === "pending";
@@ -641,10 +649,41 @@ export default function ReviewRoute() {
 }
 
 function proposalStatus(value: string | null): ProposalStatus {
-  if (value === "approved" || value === "rejected") return value;
+  if (value === "approved" || value === "rejected" || value === "quarantine")
+    return value;
   return "pending";
 }
 
+function QuarantineMetadataCard({ item }: { item: ReviewItem }) {
+  const t = useT();
+  return (
+    <Card>
+      <CardHeader className="pb-3">
+        <div className="flex items-start justify-between gap-3">
+          <div className="min-w-0">
+            <CardTitle className="text-base">
+              {t("review.quarantineEvent")}
+            </CardTitle>
+            <p className="mt-1 text-sm text-muted-foreground">
+              {item.reason ?? t("review.quarantineNoReason")}
+            </p>
+          </div>
+          <Badge variant="outline">{t("review.metadataOnly")}</Badge>
+        </div>
+      </CardHeader>
+      <CardContent className="grid gap-2 text-sm text-muted-foreground sm:grid-cols-3">
+        <span>{t("review.quarantineId", { id: item.id })}</span>
+        <span>
+          {t("review.quarantineSource", {
+            source: item.sourceName ?? item.sourceId ?? t("review.notRecorded"),
+          })}
+        </span>
+        <span>{formatDate(item.createdAt, t)}</span>
+      </CardContent>
+    </Card>
+  );
+}
+
 function cleanNote(value: string | undefined) {
   const trimmed = value?.trim();
   return trimmed ? trimmed : undefined;

package/corpus/templates/brain/app/routes/search.tsx

@@ -42,6 +42,7 @@ import {
   SheetTrigger,
 } from "@/components/ui/sheet";
 import {
+  type BrainProjectsResponse,
   type KnowledgeRow,
   type SearchEverythingResponse,
   type SearchEverythingResult,
@@ -83,6 +84,7 @@ export default function SearchRoute() {
   const type = params.get("type") ?? "all";
   const provider = params.get("provider") ?? "all";
   const status = params.get("status") ?? "all";
+  const projectId = params.get("projectId") ?? "all";
   const limit = params.get("limit") ?? "25";
 
   const actionParams = useMemo(
@@ -90,10 +92,11 @@ export default function SearchRoute() {
       query: query.trim() || undefined,
       type: type === "all" ? undefined : type,
       provider: provider === "all" ? undefined : provider,
+      projectId: projectId === "all" ? undefined : projectId,
       status: status === "all" ? undefined : status,
       limit: Number.parseInt(limit, 10) || 25,
     }),
-    [limit, provider, query, status, type],
+    [limit, projectId, provider, query, status, type],
   );
 
   const searchQuery = useActionQuery<SearchEverythingResponse>(
@@ -101,6 +104,10 @@ export default function SearchRoute() {
     actionParams as any,
     { enabled: Boolean(query.trim()), retry: false },
   );
+  const projectsQuery = useActionQuery<BrainProjectsResponse>(
+    "list-projects" as any,
+    {} as any,
+  );
 
   const results = useMemo(
     () => filterResults(normalizeResults(searchQuery.data), provider, status),
@@ -110,6 +117,7 @@ export default function SearchRoute() {
     Boolean(query.trim()) ||
     type !== "all" ||
     provider !== "all" ||
+    projectId !== "all" ||
     status !== "all";
   const groupedResults = useMemo(() => groupResults(results), [results]);
   const resultFacets = useMemo(
@@ -168,6 +176,24 @@ export default function SearchRoute() {
             </div>
 
             <div className="brain-search-filter-grid grid gap-2">
+              <Select
+                value={projectId}
+                onValueChange={(value) => updateParam("projectId", value)}
+              >
+                <SelectTrigger>
+                  <SelectValue placeholder={t("searchPage.project")} />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="all">
+                    {t("searchPage.allProjects")}
+                  </SelectItem>
+                  {(projectsQuery.data?.projects ?? []).map((project) => (
+                    <SelectItem key={project.id} value={project.id}>
+                      {project.title}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
               <Select
                 value={type}
                 onValueChange={(value) => updateParam("type", value)}
@@ -346,6 +372,9 @@ function SearchResultRow({
                 {displayLabel(sourceProvider)}
               </Badge>
             ) : null}
+            {result.matchLane ? (
+              <Badge variant="outline">{result.matchLane}</Badge>
+            ) : null}
           </div>
           <h3 className="mt-3 text-base font-semibold leading-6 text-foreground">
             {result.title || t("searchPage.untitledResult")}
@@ -356,7 +385,9 @@ function SearchResultRow({
           {whyMatched ? (
             <div className="mt-3 flex min-w-0 items-center gap-2 text-xs text-muted-foreground">
               <IconCircleCheck className="size-3.5 shrink-0 text-foreground" />
-              <span className="truncate">{whyMatched}</span>
+              <span className="truncate">
+                {result.retrievalReason ?? whyMatched}
+              </span>
             </div>
           ) : null}
         </div>

package/corpus/templates/brain/app/routes/settings.tsx

@@ -16,6 +16,7 @@ import {
   IconDeviceFloppy,
   IconFileText,
   IconGauge,
+  IconLock,
   IconMessageCircle,
   IconShieldCheck,
   IconUsersGroup,
@@ -50,6 +51,7 @@ import { Textarea } from "@/components/ui/textarea";
 import {
   type BrainSettings,
   type SettingsResponse,
+  type BrainHealthResponse,
   defaultSettings,
 } from "@/lib/brain";
 import {
@@ -267,6 +269,152 @@ function PublishingReviewSettings({
   );
 }
 
+function PrivacySensitivitySettings({
+  settings,
+  update,
+}: {
+  settings: BrainSettings;
+  update: UpdateBrainSettings;
+}) {
+  const t = useT();
+  const healthQuery = useActionQuery<BrainHealthResponse>(
+    "get-brain-health" as any,
+    {} as any,
+  );
+  const privacy = (
+    healthQuery.data as BrainHealthResponse & {
+      privacy?: {
+        classifierReady?: boolean;
+        classifierModel?: string | null;
+        quarantineRetentionDays?: number | null;
+      };
+    }
+  )?.privacy;
+  return (
+    <div className="mx-auto w-full max-w-3xl">
+      <Card id="privacy-sensitivity" className="scroll-mt-4">
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2 text-base">
+            <IconLock className="size-4 text-primary" />
+            {t("settings.privacySensitivityTitle")}
+          </CardTitle>
+          <CardDescription>
+            {t("settings.privacySensitivityDescription")}
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="grid gap-4 text-sm">
+          <div className="grid gap-3 rounded-md border border-border bg-muted/20 p-3 sm:grid-cols-3">
+            <PolicyRow
+              label={t("settings.privacyClassifier")}
+              value={
+                privacy?.classifierReady
+                  ? t("settings.ready")
+                  : t("settings.readinessPending")
+              }
+            />
+            <PolicyRow
+              label={t("settings.privacyModel")}
+              value={privacy?.classifierModel ?? t("settings.notSet")}
+            />
+            <PolicyRow
+              label={t("settings.quarantineRetention")}
+              value={
+                privacy?.quarantineRetentionDays
+                  ? t("settings.days", {
+                      count: privacy.quarantineRetentionDays,
+                    })
+                  : t("settings.notSet")
+              }
+            />
+          </div>
+          <p className="rounded-md border border-border bg-background p-3 text-xs leading-5 text-muted-foreground">
+            {t("settings.tightenOnly")}
+          </p>
+          <div className="grid gap-4 sm:grid-cols-2">
+            <TextField
+              id="privacy-classifier-model"
+              label={t("settings.privacyClassifierModel")}
+              value={settings.privacyClassifierModel ?? ""}
+              placeholder={t("settings.privacyClassifierModelPlaceholder")}
+              onChange={(value) => update("privacyClassifierModel", value)}
+            />
+            <TextField
+              id="privacy-classifier-engine"
+              label={t("settings.privacyClassifierEngine")}
+              value={settings.privacyClassifierEngine ?? ""}
+              placeholder={t("settings.privacyClassifierEnginePlaceholder")}
+              onChange={(value) => update("privacyClassifierEngine", value)}
+            />
+          </div>
+          <div className="grid gap-2">
+            <Label htmlFor="quarantine-retention-hours">
+              {t("settings.quarantineRetentionHours")}
+            </Label>
+            <Input
+              id="quarantine-retention-hours"
+              type="number"
+              min={1}
+              max={8760}
+              value={settings.quarantineRetentionHours ?? 72}
+              onChange={(event) =>
+                update(
+                  "quarantineRetentionHours",
+                  Math.max(1, Math.min(8760, Number(event.target.value) || 1)),
+                )
+              }
+            />
+            <p className="text-xs leading-5 text-muted-foreground">
+              {t("settings.quarantineRetentionHoursDescription")}
+            </p>
+          </div>
+          <div className="grid gap-2">
+            <Label htmlFor="sensitivity-custom-instructions">
+              {t("settings.sensitivityCustomInstructions")}
+            </Label>
+            <Textarea
+              id="sensitivity-custom-instructions"
+              value={settings.sensitivityCustomInstructions ?? ""}
+              placeholder={t(
+                "settings.sensitivityCustomInstructionsPlaceholder",
+              )}
+              onChange={(event) =>
+                update("sensitivityCustomInstructions", event.target.value)
+              }
+            />
+            <p className="text-xs leading-5 text-muted-foreground">
+              {t("settings.sensitivityCustomInstructionsDescription")}
+            </p>
+          </div>
+          <div className="grid gap-2">
+            <Label htmlFor="public-channel-exclusion-patterns">
+              {t("settings.publicChannelExclusionPatterns")}
+            </Label>
+            <Textarea
+              id="public-channel-exclusion-patterns"
+              value={(settings.publicChannelExclusionPatterns ?? []).join("\n")}
+              placeholder={t(
+                "settings.publicChannelExclusionPatternsPlaceholder",
+              )}
+              onChange={(event) =>
+                update(
+                  "publicChannelExclusionPatterns",
+                  event.target.value
+                    .split("\n")
+                    .map((value) => value.trim())
+                    .filter(Boolean),
+                )
+              }
+            />
+            <p className="text-xs leading-5 text-muted-foreground">
+              {t("settings.publicChannelExclusionPatternsDescription")}
+            </p>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}
+
 function SafetyEvidenceSettings({
   settings,
   update,
@@ -399,6 +547,16 @@ export default function SettingsRoute() {
 
   const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
     () => [
+      {
+        id: "privacy-sensitivity",
+        label: t("settings.privacySensitivityTitle"),
+        icon: IconLock,
+        keywords:
+          "privacy sensitivity classifier quarantine retention tighten only",
+        content: (
+          <PrivacySensitivitySettings settings={settings} update={update} />
+        ),
+      },
       {
         id: "brain-identity",
         label: t("settings.identityTitle"),

package/corpus/templates/brain/app/routes/sources.tsx

@@ -112,6 +112,7 @@ interface SourceFormState {
   sourceKey: string;
   autoSync: boolean;
   reviewRequired: boolean;
+  includePublicChannels: boolean;
 }
 
 const providers: Array<{
@@ -200,6 +201,7 @@ function defaultForm(
     autoSync:
       provider === "slack" || provider === "granola" || provider === "github",
     reviewRequired: true,
+    includePublicChannels: false,
   };
 }
 
@@ -251,6 +253,7 @@ function formFromSource(source: BrainSource): SourceFormState {
     sourceKey: "",
     autoSync: sourceAutoSync(source),
     reviewRequired: sourceReviewRequired(source),
+    includePublicChannels: config.includePublicChannels === true,
   };
 }
 
@@ -281,6 +284,7 @@ function buildConfig(form: SourceFormState) {
   if (form.provider === "slack") {
     config.channelIds = splitLines(form.channelRefs);
     config.historyLimit = numberValue(form.historyLimit, 15, 1, 15);
+    config.includePublicChannels = form.includePublicChannels;
   }
   if (form.provider === "granola") {
     config.pageSize = numberValue(form.granolaPageSize, 10, 1, 30);
@@ -2393,6 +2397,17 @@ export default function SourcesRoute() {
 
             {form.provider === "slack" && (
               <div className="grid gap-4 rounded-md border border-border p-4">
+                <div className="grid gap-3 rounded-md border border-border bg-muted/20 p-3 text-xs leading-5 text-muted-foreground">
+                  <p>
+                    <span className="font-medium text-foreground">
+                      {t("sources.slackDiscoveryMode")}
+                    </span>{" "}
+                    — {t("sources.slackDiscoveryModeDescription")}
+                  </p>
+                  <p>{t("sources.slackExclusions")}</p>
+                  <p>{t("sources.slackManualInvite")}</p>
+                  <p>{t("sources.sensitivityPreviewDescription")}</p>
+                </div>
                 <div className="rounded-md border border-border bg-muted/25 p-3">
                   <div className="flex items-center gap-2 text-sm font-medium">
                     <IconShieldCheck className="size-4 text-muted-foreground" />
@@ -2419,6 +2434,22 @@ export default function SourcesRoute() {
                     {t("sources.allowedChannelsDescription")}
                   </p>
                 </div>
+                <label className="flex items-center justify-between gap-4 rounded-md border border-border bg-muted/20 p-3">
+                  <span>
+                    <span className="block text-sm font-medium">
+                      {t("sources.includePublicChannels")}
+                    </span>
+                    <span className="mt-1 block text-xs leading-5 text-muted-foreground">
+                      {t("sources.includePublicChannelsDescription")}
+                    </span>
+                  </span>
+                  <Switch
+                    checked={form.includePublicChannels}
+                    onCheckedChange={(includePublicChannels) =>
+                      updateForm({ includePublicChannels })
+                    }
+                  />
+                </label>
                 <div className="grid gap-2 sm:grid-cols-2">
                   <div className="grid gap-2">
                     <Label htmlFor="history-limit">

package/corpus/templates/brain/changelog/2026-07-19-added-private-source-safe-semantic-search.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-19
+---
+
+Brain now searches approved public, private, and meeting knowledge semantically while keeping sensitive material out of retrieval.

package/corpus/templates/brain/changelog/2026-07-19-slack-backfills-can-now-join-configured-public-channels-befo.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-19
+---
+
+Slack backfills can now join configured public channels before reading their history.

package/corpus/templates/brain/changelog/2026-07-19-slack-backfills-now-continue-across-the-configured-number-of.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-19
+---
+
+Slack backfills now continue across the configured number of history pages.