@agent-native/core 0.131.4 → 0.131.6

package/corpus/templates/brain/actions/enqueue-captures-distillation.ts

@@ -1,18 +1,11 @@
 import { defineAction } from "@agent-native/core";
-import { writeAppState } from "@agent-native/core/application-state";
-import { and, desc, eq, inArray } from "drizzle-orm";
 import { z } from "zod";
 
-import { getDb, schema } from "../server/db/index.js";
 import {
   getAccessibleCapture,
-  nanoid,
-  nowIso,
-  parseJson,
   readBrainAgentGuidance,
-  serializeDistillationQueue,
-  stableJson,
 } from "../server/lib/brain.js";
+import { enqueueCaptureDistillation } from "../server/lib/distillation-queue.js";
 import { redactSensitiveText } from "../server/lib/search.js";
 import { optionalJsonRecordSchema, stringArrayCliSchema } from "./_schemas.js";
 
@@ -20,33 +13,6 @@ type BrainAgentGuidance = Awaited<
   ReturnType<typeof readBrainAgentGuidance>
 >["guidance"];
 
-async function writeDistillationRequest(values: {
-  captureId: string;
-  queueId: string;
-  sourceId: string;
-  requestedAt: string;
-  instructions?: string | null;
-  guidance: BrainAgentGuidance;
-}) {
-  await writeAppState(`brain-distill-request-${values.captureId}`, {
-    kind: "distill-capture",
-    captureId: values.captureId,
-    queueId: values.queueId,
-    sourceId: values.sourceId,
-    requestedAt: values.requestedAt,
-    instructions: values.instructions ?? null,
-    guidance: values.guidance,
-    message:
-      `Distill Brain capture ${values.captureId} for ${values.guidance.identity.companyName ?? "this workspace"}. ` +
-      `Apply the Brain settings guidance in context. Use get-capture with ` +
-      `includeRawContent=true when you need exact quote validation, extract ` +
-      `only durable company knowledge with exact evidence quotes, ` +
-      `call write-knowledge for supported entries or proposals, then call ` +
-      `mark-capture-distilled when finished. If the capture is personal or ` +
-      `out of scope, call mark-capture-distilled with status ignored.`,
-  });
-}
-
 function errorMessage(error: unknown) {
   const message = error instanceof Error ? error.message : String(error);
   return redactSensitiveText(message);
@@ -84,101 +50,20 @@ async function enqueueOneCapture(values: {
       };
     }
 
-    const db = getDb();
-    const now = nowIso();
-    const [existing] = await db
-      .select()
-      .from(schema.brainIngestQueue)
-      .where(
-        and(
-          eq(schema.brainIngestQueue.captureId, values.captureId),
-          eq(schema.brainIngestQueue.operation, "distill"),
-          inArray(schema.brainIngestQueue.status, ["queued", "processing"]),
-        ),
-      )
-      .orderBy(desc(schema.brainIngestQueue.updatedAt))
-      .limit(1);
-
-    if (existing) {
-      if (access.capture.status !== "distilling") {
-        await db
-          .update(schema.brainRawCaptures)
-          .set({ status: "distilling", updatedAt: now })
-          .where(eq(schema.brainRawCaptures.id, values.captureId));
-      }
-      const payload = parseJson<Record<string, unknown>>(
-        existing.payloadJson,
-        {},
-      );
-      const existingInstructions =
-        typeof payload.instructions === "string"
-          ? payload.instructions
-          : undefined;
-      await writeDistillationRequest({
-        captureId: values.captureId,
-        queueId: existing.id,
-        sourceId: access.capture.sourceId,
-        requestedAt: now,
-        instructions: values.instructions ?? existingInstructions,
-        guidance: values.guidance,
-      });
-      return {
-        captureId: values.captureId,
-        sourceId: access.capture.sourceId,
-        outcome: "existing" as const,
-        existing: true,
-        queueItem: serializeDistillationQueue(existing),
-      };
-    }
-
-    const id = nanoid();
-    await db.insert(schema.brainIngestQueue).values({
-      id,
-      sourceId: access.capture.sourceId,
-      captureId: access.capture.id,
-      operation: "distill",
-      status: "queued",
+    const result = await enqueueCaptureDistillation({
+      capture: access.capture,
       priority: values.priority,
-      attempts: 0,
-      payloadJson: stableJson({
-        ...(values.payload ?? {}),
-        instructions: values.instructions,
-      }),
-      error: null,
-      runAfter: null,
-      createdAt: now,
-      updatedAt: now,
-    });
-    await db
-      .update(schema.brainRawCaptures)
-      .set({ status: "distilling", updatedAt: now })
-      .where(eq(schema.brainRawCaptures.id, values.captureId));
-    await writeDistillationRequest({
-      captureId: values.captureId,
-      queueId: id,
-      sourceId: access.capture.sourceId,
-      requestedAt: now,
-      instructions: values.instructions ?? null,
+      instructions: values.instructions,
+      payload: values.payload,
       guidance: values.guidance,
     });
 
     return {
       captureId: values.captureId,
       sourceId: access.capture.sourceId,
-      outcome: "queued" as const,
-      existing: false,
-      queueItem: {
-        id,
-        sourceId: access.capture.sourceId,
-        captureId: values.captureId,
-        status: "queued" as const,
-        priority: values.priority,
-        attempts: 0,
-        error: null,
-        runAfter: null,
-        createdAt: now,
-        updatedAt: now,
-      },
+      outcome: result.existing ? ("existing" as const) : ("queued" as const),
+      existing: result.existing,
+      queueItem: result.queueItem,
     };
   } catch (error) {
     return {

package/corpus/templates/brain/actions/enqueue-distillation.ts

@@ -1,47 +1,10 @@
 import { defineAction } from "@agent-native/core";
-import { writeAppState } from "@agent-native/core/application-state";
-import { and, desc, eq, inArray } from "drizzle-orm";
 import { z } from "zod";
 
-import { getDb, schema } from "../server/db/index.js";
-import {
-  getAccessibleCapture,
-  nanoid,
-  nowIso,
-  parseJson,
-  readBrainAgentGuidance,
-  serializeDistillationQueue,
-  stableJson,
-} from "../server/lib/brain.js";
+import { getAccessibleCapture } from "../server/lib/brain.js";
+import { enqueueCaptureDistillation } from "../server/lib/distillation-queue.js";
 import { optionalJsonRecordSchema } from "./_schemas.js";
 
-async function writeDistillationRequest(values: {
-  captureId: string;
-  queueId: string;
-  sourceId: string;
-  requestedAt: string;
-  instructions?: string | null;
-  guidance: Awaited<ReturnType<typeof readBrainAgentGuidance>>["guidance"];
-}) {
-  await writeAppState(`brain-distill-request-${values.captureId}`, {
-    kind: "distill-capture",
-    captureId: values.captureId,
-    queueId: values.queueId,
-    sourceId: values.sourceId,
-    requestedAt: values.requestedAt,
-    instructions: values.instructions ?? null,
-    guidance: values.guidance,
-    message:
-      `Distill Brain capture ${values.captureId} for ${values.guidance.identity.companyName ?? "this workspace"}. ` +
-      `Apply the Brain settings guidance in context. Use get-capture with ` +
-      `includeRawContent=true when you need exact quote validation, extract ` +
-      `only durable company knowledge with exact evidence quotes, ` +
-      `call write-knowledge for supported entries or proposals, then call ` +
-      `mark-capture-distilled when finished. If the capture is personal or ` +
-      `out of scope, call mark-capture-distilled with status ignored.`,
-  });
-}
-
 export default defineAction({
   description:
     "Queue a raw capture for distillation into durable Brain knowledge.",
@@ -52,7 +15,6 @@ export default defineAction({
     payload: optionalJsonRecordSchema,
   }),
   run: async (args) => {
-    const { guidance } = await readBrainAgentGuidance();
     const access = await getAccessibleCapture(args.captureId);
     if (!access) throw new Error(`No access to capture ${args.captureId}`);
     if (
@@ -63,94 +25,11 @@ export default defineAction({
         `Capture ${args.captureId} is already ${access.capture.status}`,
       );
     }
-    const db = getDb();
-    const now = nowIso();
-    const [existing] = await db
-      .select()
-      .from(schema.brainIngestQueue)
-      .where(
-        and(
-          eq(schema.brainIngestQueue.captureId, args.captureId),
-          eq(schema.brainIngestQueue.operation, "distill"),
-          inArray(schema.brainIngestQueue.status, ["queued", "processing"]),
-        ),
-      )
-      .orderBy(desc(schema.brainIngestQueue.updatedAt))
-      .limit(1);
-    if (existing) {
-      if (access.capture.status !== "distilling") {
-        await db
-          .update(schema.brainRawCaptures)
-          .set({ status: "distilling", updatedAt: now })
-          .where(eq(schema.brainRawCaptures.id, args.captureId));
-      }
-      const payload = parseJson<Record<string, unknown>>(
-        existing.payloadJson,
-        {},
-      );
-      const existingInstructions =
-        typeof payload.instructions === "string"
-          ? payload.instructions
-          : undefined;
-      await writeDistillationRequest({
-        captureId: args.captureId,
-        queueId: existing.id,
-        sourceId: access.capture.sourceId,
-        requestedAt: now,
-        instructions: args.instructions ?? existingInstructions,
-        guidance,
-      });
-      return {
-        queueItem: serializeDistillationQueue(existing),
-        existing: true,
-        guidance: guidance.distillation,
-      };
-    }
-    const id = nanoid();
-    await db.insert(schema.brainIngestQueue).values({
-      id,
-      sourceId: access.capture.sourceId,
-      captureId: access.capture.id,
-      operation: "distill",
-      status: "queued",
+    return enqueueCaptureDistillation({
+      capture: access.capture,
       priority: args.priority,
-      attempts: 0,
-      payloadJson: stableJson({
-        ...(args.payload ?? {}),
-        instructions: args.instructions,
-      }),
-      error: null,
-      runAfter: null,
-      createdAt: now,
-      updatedAt: now,
-    });
-    await db
-      .update(schema.brainRawCaptures)
-      .set({ status: "distilling", updatedAt: now })
-      .where(eq(schema.brainRawCaptures.id, args.captureId));
-    await writeDistillationRequest({
-      captureId: args.captureId,
-      queueId: id,
-      sourceId: access.capture.sourceId,
-      requestedAt: now,
-      instructions: args.instructions ?? null,
-      guidance,
+      instructions: args.instructions,
+      payload: args.payload,
     });
-    return {
-      queueItem: {
-        id,
-        sourceId: access.capture.sourceId,
-        captureId: args.captureId,
-        status: "queued",
-        priority: args.priority,
-        attempts: 0,
-        error: null,
-        runAfter: null,
-        createdAt: now,
-        updatedAt: now,
-      },
-      existing: false,
-      guidance: guidance.distillation,
-    };
   },
 });

package/corpus/templates/brain/actions/import-capture.ts

@@ -8,6 +8,7 @@ import {
   serializeCapture,
   serializeSource,
 } from "../server/lib/brain.js";
+import { enqueueCaptureDistillation } from "../server/lib/distillation-queue.js";
 import { captureKindSchema, optionalJsonRecordSchema } from "./_schemas.js";
 
 export default defineAction({
@@ -49,15 +50,26 @@ export default defineAction({
         source: source ? serializeSource(source) : undefined,
         capture: undefined,
         sensitivityReceipt: error.receipt,
-        nextAction: undefined,
+        distillation: undefined,
       };
     }
+    const distillation =
+      args.enqueueDistillation &&
+      capture.status !== "distilled" &&
+      capture.status !== "ignored"
+        ? await enqueueCaptureDistillation({ capture })
+        : undefined;
+    const serializedCapture = serializeCapture(capture);
     return {
       source: source ? serializeSource(source) : undefined,
-      capture: serializeCapture(capture),
-      nextAction: args.enqueueDistillation
-        ? "Call enqueue-distillation with this captureId."
-        : undefined,
+      capture: distillation
+        ? {
+            ...serializedCapture,
+            status: "distilling",
+            updatedAt: distillation.queueItem.updatedAt,
+          }
+        : serializedCapture,
+      distillation,
     };
   },
 });

package/corpus/templates/brain/actions/import-transcript.ts

@@ -9,6 +9,7 @@ import {
   serializeCapture,
   serializeSource,
 } from "../server/lib/brain.js";
+import { enqueueCaptureDistillation } from "../server/lib/distillation-queue.js";
 import { optionalJsonRecordSchema } from "./_schemas.js";
 
 export default defineAction({
@@ -68,15 +69,26 @@ export default defineAction({
         source: source ? serializeSource(source) : undefined,
         capture: undefined,
         sensitivityReceipt: error.receipt,
-        nextAction: undefined,
+        distillation: undefined,
       };
     }
+    const distillation =
+      args.enqueueDistillation &&
+      capture.status !== "distilled" &&
+      capture.status !== "ignored"
+        ? await enqueueCaptureDistillation({ capture })
+        : undefined;
+    const serializedCapture = serializeCapture(capture);
     return {
       source: source ? serializeSource(source) : undefined,
-      capture: serializeCapture(capture),
-      nextAction: args.enqueueDistillation
-        ? "Call enqueue-distillation with this captureId."
-        : undefined,
+      capture: distillation
+        ? {
+            ...serializedCapture,
+            status: "distilling",
+            updatedAt: distillation.queueItem.updatedAt,
+          }
+        : serializedCapture,
+      distillation,
     };
   },
 });

package/corpus/templates/brain/actions/update-source.ts

@@ -11,17 +11,27 @@ import {
   stableJson,
 } from "../server/lib/brain.js";
 import { assertSourceWorkspaceConnectionAvailable } from "../server/lib/source-credentials.js";
+import { withSourceAnswerPolicy } from "../server/lib/source-policy.js";
 import { normalizeSlackChannelConfig } from "../shared/slack-source-config.js";
-import { optionalJsonRecordSchema } from "./_schemas.js";
+import {
+  optionalJsonRecordSchema,
+  sourceAnswerPolicySchema,
+} from "./_schemas.js";
 
 export default defineAction({
-  description: "Update a Brain source's title, status, config, or cursor.",
+  description:
+    "Update a Brain source's title, status, config, cursor, or trusted-answer policy.",
   schema: z.object({
     id: z.string().min(1),
     title: z.string().min(1).optional(),
     status: z.enum(["active", "paused", "archived", "error"]).optional(),
     config: optionalJsonRecordSchema,
     cursor: optionalJsonRecordSchema,
+    policy: sourceAnswerPolicySchema
+      .optional()
+      .describe(
+        "Merge trust, answer eligibility, authority, freshness, review, or conflict behavior into the source answer policy",
+      ),
   }),
   run: async (args) => {
     const access = await assertAccess("brain-source", args.id, "editor");
@@ -29,13 +39,23 @@ export default defineAction({
     const updates: Record<string, unknown> = { updatedAt: nowIso() };
     if (args.title !== undefined) updates.title = args.title;
     if (args.status !== undefined) updates.status = args.status;
-    if (args.config !== undefined) {
+    if (args.config !== undefined || args.policy !== undefined) {
       let nextConfig: Record<string, unknown> = {
         ...parseJson<Record<string, unknown>>(existing.configJson, {}),
-        ...args.config,
+        ...(args.config ?? {}),
       };
+      if (
+        args.policy !== undefined ||
+        (args.config &&
+          Object.prototype.hasOwnProperty.call(args.config, "answerPolicy"))
+      ) {
+        nextConfig = withSourceAnswerPolicy(
+          nextConfig,
+          args.policy ?? nextConfig.answerPolicy,
+        );
+      }
       if (existing.provider === "slack") {
-        nextConfig = normalizeSlackChannelConfig(nextConfig, args.config);
+        nextConfig = normalizeSlackChannelConfig(nextConfig, args.config ?? {});
       }
       const workspaceConnectionId =
         typeof nextConfig.workspaceConnectionId === "string"

package/corpus/templates/brain/app/components/layout/Sidebar.tsx

@@ -432,7 +432,7 @@ export function Sidebar({
       <div className="mt-auto shrink-0">
         {!collapsed ? (
           <div className="px-3 py-2">
-            <OrgSwitcher reserveSpace />
+            <OrgSwitcher />
           </div>
         ) : null}
 

package/corpus/templates/brain/changelog/2026-07-30-blessed-resources-can-feed-cited-company-answers.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-30
+---
+
+Blessed FAQs, docs, and other resources can publish updates to Brain for automatic distillation and cited, policy-aware answers.

package/corpus/templates/brain/changelog/2026-07-30-the-left-sidebar-no-longer-shows-a-blank-organization-placeh.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+The left sidebar no longer shows a blank organization placeholder in its footer.

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

@@ -693,6 +693,12 @@ async function findUpstreamDeletionReceipt(
     : null;
 }
 
+function captureMetadataFingerprint(metadata: Record<string, unknown>) {
+  const comparable = { ...metadata };
+  delete comparable.captureSanitization;
+  return stableJson(comparable);
+}
+
 export async function createCapture(values: {
   id?: string;
   sourceId: string;
@@ -773,13 +779,31 @@ export async function createCapture(values: {
     throw new BrainCaptureBlockedError(receipt);
   }
   const nextContentHash = await contentHash(sanitized.content);
+  const nextMetadataJson = stableJson(sanitized.metadata);
   const nextCapturedAt = values.capturedAt ?? existing?.capturedAt ?? now;
   const contentChanged = existing?.contentHash !== nextContentHash;
+  const metadataChanged = Boolean(
+    existing &&
+    captureMetadataFingerprint(
+      parseJson<Record<string, unknown>>(existing.metadataJson, {}),
+    ) !== captureMetadataFingerprint(sanitized.metadata),
+  );
   const indexedMetadataChanged = Boolean(
     existing &&
     (existing.title !== sanitized.title ||
       existing.capturedAt !== nextCapturedAt),
   );
+  const derivedInputChanged =
+    !existing || contentChanged || metadataChanged || indexedMetadataChanged;
+  const nextStatus =
+    values.status ??
+    (derivedInputChanged ? "queued" : (existing?.status ?? "queued"));
+  const nextDistilledAt =
+    values.status === "distilled"
+      ? now
+      : values.status !== undefined || derivedInputChanged
+        ? null
+        : (existing?.distilledAt ?? null);
   const captureId = existing?.id ?? id;
   try {
     if (!existing) {
@@ -791,11 +815,11 @@ export async function createCapture(values: {
         kind: values.kind,
         content: sanitized.content,
         contentHash: nextContentHash,
-        metadataJson: stableJson(sanitized.metadata),
+        metadataJson: nextMetadataJson,
         capturedAt: nextCapturedAt,
         importedBy: requireUserEmail(),
-        status: values.status ?? "queued",
-        distilledAt: values.status === "distilled" ? now : null,
+        status: nextStatus,
+        distilledAt: nextDistilledAt,
         sensitivityDisposition: "pending",
         sensitivityPolicyVersion: sanitized.decision.policyVersion,
         audienceAclHash: null,
@@ -875,10 +899,10 @@ export async function createCapture(values: {
       kind: values.kind,
       content: sanitized.content,
       contentHash: nextContentHash,
-      metadataJson: stableJson(sanitized.metadata),
+      metadataJson: nextMetadataJson,
       capturedAt: nextCapturedAt,
-      status: values.status ?? "queued",
-      distilledAt: values.status === "distilled" ? now : null,
+      status: nextStatus,
+      distilledAt: nextDistilledAt,
       sensitivityDisposition: "allowed",
       sensitivityPolicyVersion: sanitized.decision.policyVersion,
       audienceAclHash: audience.aclHash,
@@ -901,7 +925,7 @@ export async function createCapture(values: {
     if (receipt) throw new BrainCaptureBlockedError(receipt);
     throw new Error("Capture finalization was blocked");
   }
-  if (existing?.contentHash && contentChanged) {
+  if (existing?.contentHash && derivedInputChanged) {
     await invalidateDerivedForCapture(captureId);
   }
   const [capture] = await db
@@ -909,14 +933,13 @@ export async function createCapture(values: {
     .from(schema.brainRawCaptures)
     .where(eq(schema.brainRawCaptures.id, captureId))
     .limit(1);
-  const invalidationReason =
-    !existing || contentChanged || indexedMetadataChanged
-      ? "content-changed"
-      : existing.audienceAclHash !== audience.aclHash
-        ? "access-changed"
-        : existing.sensitivityPolicyVersion !== sanitized.decision.policyVersion
-          ? "sensitivity-changed"
-          : null;
+  const invalidationReason = derivedInputChanged
+    ? "content-changed"
+    : existing.audienceAclHash !== audience.aclHash
+      ? "access-changed"
+      : existing.sensitivityPolicyVersion !== sanitized.decision.policyVersion
+        ? "sensitivity-changed"
+        : null;
   if (!invalidationReason) return capture;
   try {
     await enqueueCaptureInvalidation({
@@ -1495,10 +1518,17 @@ async function evidenceSourceReviewPolicy(
       ),
     );
   if (sources.length !== sourceIds.length) return "required";
-  const values = sources.map(
-    (source) =>
-      parseJson<Record<string, unknown>>(source.configJson, {}).reviewRequired,
-  );
+  const values = sources.map((source) => {
+    const config = parseJson<Record<string, unknown>>(source.configJson, {});
+    const answerPolicy =
+      config.answerPolicy &&
+      typeof config.answerPolicy === "object" &&
+      !Array.isArray(config.answerPolicy)
+        ? (config.answerPolicy as Record<string, unknown>)
+        : null;
+    if (answerPolicy?.conflictBehavior === "require-review") return true;
+    return answerPolicy?.reviewRequired ?? config.reviewRequired;
+  });
   if (values.includes(true)) return "required";
   return values.every((value) => value === false) ? "disabled" : "legacy";
 }