@agent-native/core 0.99.2 → 0.100.0

package/corpus/templates/plan/app/root.tsx

@@ -13,6 +13,7 @@ import {
 } from "@agent-native/core/client";
 import { configureTracking } from "@agent-native/core/client";
 import {
+  IconBrain,
   IconMoon,
   IconScribble,
   IconShape2,
@@ -176,6 +177,13 @@ function AppContent() {
           <CommandMenu.Item onSelect={() => go("/recaps")}>
             {t("root.openRecaps")}
           </CommandMenu.Item>
+          <CommandMenu.Item
+            onSelect={() => go("/agent")}
+            keywords={["agent", "context", "connections", "jobs", "access"]}
+          >
+            <IconBrain size={16} />
+            {t("settings.openAgentSettings")}
+          </CommandMenu.Item>
         </CommandMenu.Group>
         <CommandMenu.Group heading={t("root.commandAppearance")}>
           <CommandMenu.Item

package/corpus/templates/plan/app/routes/agent.tsx

@@ -0,0 +1,15 @@
+import { AgentTabsPage, useT } from "@agent-native/core/client";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+
+import messages from "@/i18n/en-US";
+
+export function meta() {
+  return [{ title: messages.settings.agentTitle }];
+}
+
+export default function AgentRoute() {
+  const t = useT();
+  useSetPageTitle(t("settings.agentTitle"));
+
+  return <AgentTabsPage appName="Plan" />;
+}

package/corpus/templates/plan/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-13
+---
+
+New Agent page: see and manage your agent's context, files, connections, jobs, and external access in one place

package/corpus/templates/slides/app/components/layout/Header.tsx

@@ -11,6 +11,7 @@ import { useDecks } from "@/context/DeckContext";
 const pageTitleKeys: Record<string, string> = {
   "/": "header.decks",
   "/design-systems": "header.designSystems",
+  "/agent": "settings.agentTitle",
   "/settings": "header.settings",
   "/extensions": "header.extensions",
 };

package/corpus/templates/slides/app/components/layout/Layout.tsx

@@ -77,6 +77,7 @@ export function Layout({ children }: LayoutProps) {
         ]}
         scope={deckScope}
         browserTabId={TAB_ID}
+        agentPageHref="/agent"
       >
         <div className="agent-layout-shell flex h-screen w-full overflow-hidden bg-background text-foreground">
           {sidebarOpen && (

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

@@ -8,6 +8,7 @@ import { ExtensionsSidebarSection } from "@agent-native/core/client/extensions";
 import { OrgSwitcher } from "@agent-native/core/client/org";
 import {
   IconStack2,
+  IconBrain,
   IconPalette,
   IconSettings,
   IconLayoutSidebarLeftCollapse,
@@ -29,6 +30,7 @@ const navItems = [
     labelKey: "navigation.designSystems",
     href: "/design-systems",
   },
+  { icon: IconBrain, labelKey: "settings.agentTitle", href: "/agent" },
   { icon: IconSettings, labelKey: "navigation.settings", href: "/settings" },
 ];
 

package/corpus/templates/slides/app/root.tsx

@@ -15,7 +15,7 @@ import {
   getLocaleInitScript,
   getThemeInitScript,
 } from "@agent-native/core/client";
-import { IconSun, IconMoon } from "@tabler/icons-react";
+import { IconBrain, IconSun, IconMoon } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useTheme } from "next-themes";
 import { useCallback, useEffect, useState } from "react";
@@ -26,6 +26,7 @@ import {
   Scripts,
   ScrollRestoration,
   useLocation,
+  useNavigate,
 } from "react-router";
 import type { LinksFunction } from "react-router";
 
@@ -184,6 +185,7 @@ function AppContent() {
   const isDark = resolvedTheme === "dark";
   const [cmdkOpen, setCmdkOpen] = useState(false);
   const t = useT();
+  const navigate = useNavigate();
   useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
   const location = useLocation();
 
@@ -212,6 +214,13 @@ function AppContent() {
           <CommandMenu.Item onSelect={() => {}}>
             {t("root.searchDecks")}
           </CommandMenu.Item>
+          <CommandMenu.Item
+            onSelect={() => navigate("/agent")}
+            keywords={["agent", "context", "connections", "jobs", "access"]}
+          >
+            <IconBrain size={16} />
+            {t("settings.openAgentSettings")}
+          </CommandMenu.Item>
         </CommandMenu.Group>
         <CommandMenu.Group heading={t("root.commandAppearance")}>
           <CommandMenu.Item

package/corpus/templates/slides/app/routes/agent.tsx

@@ -0,0 +1,15 @@
+import { AgentTabsPage, useT } from "@agent-native/core/client";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+
+import messages from "@/i18n/en-US";
+
+export function meta() {
+  return [{ title: messages.settings.agentTitle }];
+}
+
+export default function AgentRoute() {
+  const t = useT();
+  useSetPageTitle(t("settings.agentTitle"));
+
+  return <AgentTabsPage appName="Slides" />;
+}

package/corpus/templates/slides/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-13
+---
+
+New Agent page: see and manage your agent's context, files, connections, jobs, and external access in one place

package/dist/agent/context-xray/actions/context-evict.js

@@ -2,8 +2,8 @@ import { z } from "zod";
 import { defineAction } from "../../../action.js";
 import { getRequestOrgId, getRequestUserEmail, } from "../../../server/request-context.js";
 import { callerOwnsThread } from "../../run-ownership.js";
-import { upsertContextDirective, writeContextManifestStatus, } from "../directives-store.js";
-import { contextXrayAuthError, contextXrayThreadNotFoundError, } from "./errors.js";
+import { readContextManifest, upsertContextDirective, writeContextManifestStatus, } from "../directives-store.js";
+import { contextXrayAuthError, contextXraySystemSegmentError, contextXrayThreadNotFoundError, isContextXraySystemSegment, } from "./errors.js";
 export default defineAction({
     description: "Evict a Context X-Ray segment from future model calls. This excludes the segment from context; it does not delete chat history and can be restored.",
     schema: z.object({
@@ -17,6 +17,9 @@ export default defineAction({
         if (!(await callerOwnsThread(ownerEmail, args.threadId))) {
             throw contextXrayThreadNotFoundError();
         }
+        if (isContextXraySystemSegment(await readContextManifest(args.threadId), args.segmentId)) {
+            throw contextXraySystemSegmentError();
+        }
         const directive = await upsertContextDirective({
             threadId: args.threadId,
             segmentId: args.segmentId,

package/dist/agent/context-xray/actions/context-evict.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-evict.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-evict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,qJAAqJ;IACvJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,OAAO;YACf,UAAU;YACV,KAAK,EAAE,eAAe,EAAE,IAAI,IAAI;SACjC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n} from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  upsertContextDirective,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXrayThreadNotFoundError,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Evict a Context X-Ray segment from future model calls. This excludes the segment from context; it does not delete chat history and can be restored.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    const directive = await upsertContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      action: \"evict\",\n      ownerEmail,\n      orgId: getRequestOrgId() ?? null,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"evicted\",\n    });\n    return { directive, manifest };\n  },\n});\n"]}
+{"version":3,"file":"context-evict.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-evict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,qJAAqJ;IACvJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,IACE,0BAA0B,CACxB,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxC,IAAI,CAAC,SAAS,CACf,EACD,CAAC;YACD,MAAM,6BAA6B,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,OAAO;YACf,UAAU;YACV,KAAK,EAAE,eAAe,EAAE,IAAI,IAAI;SACjC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n} from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  readContextManifest,\n  upsertContextDirective,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXraySystemSegmentError,\n  contextXrayThreadNotFoundError,\n  isContextXraySystemSegment,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Evict a Context X-Ray segment from future model calls. This excludes the segment from context; it does not delete chat history and can be restored.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    if (\n      isContextXraySystemSegment(\n        await readContextManifest(args.threadId),\n        args.segmentId,\n      )\n    ) {\n      throw contextXraySystemSegmentError();\n    }\n    const directive = await upsertContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      action: \"evict\",\n      ownerEmail,\n      orgId: getRequestOrgId() ?? null,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"evicted\",\n    });\n    return { directive, manifest };\n  },\n});\n"]}

package/dist/agent/context-xray/actions/context-pin.js

@@ -2,8 +2,8 @@ import { z } from "zod";
 import { defineAction } from "../../../action.js";
 import { getRequestOrgId, getRequestUserEmail, } from "../../../server/request-context.js";
 import { callerOwnsThread } from "../../run-ownership.js";
-import { upsertContextDirective, writeContextManifestStatus, } from "../directives-store.js";
-import { contextXrayAuthError, contextXrayThreadNotFoundError, } from "./errors.js";
+import { readContextManifest, upsertContextDirective, writeContextManifestStatus, } from "../directives-store.js";
+import { contextXrayAuthError, contextXraySystemSegmentError, contextXrayThreadNotFoundError, isContextXraySystemSegment, } from "./errors.js";
 export default defineAction({
     description: "Pin a Context X-Ray segment so it is preserved through future context compaction.",
     schema: z.object({
@@ -17,6 +17,9 @@ export default defineAction({
         if (!(await callerOwnsThread(ownerEmail, args.threadId))) {
             throw contextXrayThreadNotFoundError();
         }
+        if (isContextXraySystemSegment(await readContextManifest(args.threadId), args.segmentId)) {
+            throw contextXraySystemSegmentError();
+        }
         const directive = await upsertContextDirective({
             threadId: args.threadId,
             segmentId: args.segmentId,

package/dist/agent/context-xray/actions/context-pin.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-pin.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-pin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,mFAAmF;IACrF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK;YACb,UAAU;YACV,KAAK,EAAE,eAAe,EAAE,IAAI,IAAI;SACjC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n} from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  upsertContextDirective,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXrayThreadNotFoundError,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Pin a Context X-Ray segment so it is preserved through future context compaction.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    const directive = await upsertContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      action: \"pin\",\n      ownerEmail,\n      orgId: getRequestOrgId() ?? null,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"pinned\",\n    });\n    return { directive, manifest };\n  },\n});\n"]}
+{"version":3,"file":"context-pin.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-pin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,mFAAmF;IACrF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,IACE,0BAA0B,CACxB,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxC,IAAI,CAAC,SAAS,CACf,EACD,CAAC;YACD,MAAM,6BAA6B,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK;YACb,UAAU;YACV,KAAK,EAAE,eAAe,EAAE,IAAI,IAAI;SACjC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n} from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  readContextManifest,\n  upsertContextDirective,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXraySystemSegmentError,\n  contextXrayThreadNotFoundError,\n  isContextXraySystemSegment,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Pin a Context X-Ray segment so it is preserved through future context compaction.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    if (\n      isContextXraySystemSegment(\n        await readContextManifest(args.threadId),\n        args.segmentId,\n      )\n    ) {\n      throw contextXraySystemSegmentError();\n    }\n    const directive = await upsertContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      action: \"pin\",\n      ownerEmail,\n      orgId: getRequestOrgId() ?? null,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"pinned\",\n    });\n    return { directive, manifest };\n  },\n});\n"]}

package/dist/agent/context-xray/actions/context-preview-get.d.ts

@@ -0,0 +1,17 @@
+import { type ContextPreview } from "../../../shared/context-xray.js";
+export declare function buildContextPreview(input: {
+    ownerEmail: string;
+    orgId?: string | null;
+    scope: "user" | "org";
+    appId?: string;
+    compact?: boolean;
+    model?: string;
+}): Promise<ContextPreview>;
+declare const _default: import("../../../action.js").ActionDefinition<{
+    scope?: "org" | "user";
+    appId?: string;
+    compact?: boolean;
+    model?: string;
+}, ContextPreview>;
+export default _default;
+//# sourceMappingURL=context-preview-get.d.ts.map

package/dist/agent/context-xray/actions/context-preview-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-preview-get.d.ts","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-preview-get.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,iCAAiC,CAAC;AAWzC,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqD1B"}

package/dist/agent/context-xray/actions/context-preview-get.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { defineAction } from "../../../action.js";
+import { embedApp } from "../../../mcp/embed-app.js";
+import { SHARED_OWNER } from "../../../resources/store.js";
+import { buildFrameworkPrompts, buildSchemaBlock, } from "../../../server/agent-chat/framework-prompts.js";
+import { loadResourcesForPrompt, promptResourceManifestSections, } from "../../../server/agent-chat/prompt-resources.js";
+import { getRequestOrgId, getRequestUserEmail, } from "../../../server/request-context.js";
+import { buildSystemManifestSections } from "../manifest.js";
+import { contextXrayAuthError } from "./errors.js";
+function combineMethods(left, right) {
+    return left === "estimate" || right === "estimate" ? "estimate" : "exact";
+}
+export async function buildContextPreview(input) {
+    const compact = input.compact ?? false;
+    const prompts = buildFrameworkPrompts();
+    const resources = await loadResourcesForPrompt(input.scope === "org" ? SHARED_OWNER : input.ownerEmail, compact, input.appId, input.orgId ?? null);
+    const schemaBlock = compact
+        ? ""
+        : await buildSchemaBlock(input.ownerEmail, "read");
+    const sections = await buildSystemManifestSections([
+        {
+            label: "Framework core",
+            provenance: "framework-core",
+            governance: "required",
+            content: compact
+                ? prompts.PROD_FRAMEWORK_PROMPT_COMPACT
+                : prompts.PROD_FRAMEWORK_PROMPT,
+            sourceRef: { scope: "framework" },
+        },
+        ...promptResourceManifestSections(resources),
+        ...(schemaBlock
+            ? [
+                {
+                    label: "SQL schema",
+                    provenance: "db-schema",
+                    governance: "required",
+                    content: schemaBlock,
+                    sourceRef: { scope: "sql" },
+                },
+            ]
+            : []),
+    ]);
+    const systemTokens = sections.reduce((total, section) => total + section.tokenCount, 0);
+    const tokenCountMethod = sections.reduce((method, section) => combineMethods(method, section.tokenMethod), "exact");
+    return {
+        computedAt: Date.now(),
+        ...(input.model ? { model: input.model } : {}),
+        scope: input.scope,
+        totalTokens: systemTokens,
+        systemTokens,
+        tokenCountMethod,
+        sections,
+        source: "preview",
+    };
+}
+export default defineAction({
+    description: "Preview the system-prompt context that would be composed for the current user, organization, and app without a live chat thread.",
+    schema: z.object({
+        scope: z
+            .enum(["user", "org"])
+            .default("user")
+            .describe("Configuration scope to preview: user includes personal context; org includes inherited organization context."),
+        appId: z.string().optional().describe("Current app id, when available."),
+        compact: z.boolean().optional().describe("Use the compact startup prompt."),
+        model: z.string().optional().describe("Model id for display metadata."),
+    }),
+    http: { method: "GET" },
+    readOnly: true,
+    publicAgent: { expose: true, readOnly: true, requiresAuth: true },
+    mcpApp: {
+        compactCatalog: true,
+        resource: embedApp({
+            title: "Context preview",
+            description: "Preview the system-prompt context before starting a thread.",
+            iframeTitle: "Context preview",
+            openLabel: "Open context preview",
+            height: 720,
+        }),
+    },
+    run: async (args) => {
+        const ownerEmail = getRequestUserEmail();
+        if (!ownerEmail)
+            throw contextXrayAuthError();
+        return await buildContextPreview({
+            ownerEmail,
+            orgId: getRequestOrgId() ?? null,
+            scope: args.scope,
+            ...(args.appId ? { appId: args.appId } : {}),
+            ...(args.compact !== undefined ? { compact: args.compact } : {}),
+            ...(args.model ? { model: args.model } : {}),
+        });
+    },
+});
+//# sourceMappingURL=context-preview-get.js.map

package/dist/agent/context-xray/actions/context-preview-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-preview-get.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-preview-get.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport { embedApp } from \"../../../mcp/embed-app.js\";\nimport { SHARED_OWNER } from \"../../../resources/store.js\";\nimport {\n  buildFrameworkPrompts,\n  buildSchemaBlock,\n} from \"../../../server/agent-chat/framework-prompts.js\";\nimport {\n  loadResourcesForPrompt,\n  promptResourceManifestSections,\n} from \"../../../server/agent-chat/prompt-resources.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n} from \"../../../server/request-context.js\";\nimport {\n  type ContextPreview,\n  type ContextTokenCountMethod,\n} from \"../../../shared/context-xray.js\";\nimport { buildSystemManifestSections } from \"../manifest.js\";\nimport { contextXrayAuthError } from \"./errors.js\";\n\nfunction combineMethods(\n  left: ContextTokenCountMethod,\n  right: ContextTokenCountMethod,\n): ContextTokenCountMethod {\n  return left === \"estimate\" || right === \"estimate\" ? \"estimate\" : \"exact\";\n}\n\nexport async function buildContextPreview(input: {\n  ownerEmail: string;\n  orgId?: string | null;\n  scope: \"user\" | \"org\";\n  appId?: string;\n  compact?: boolean;\n  model?: string;\n}): Promise<ContextPreview> {\n  const compact = input.compact ?? false;\n  const prompts = buildFrameworkPrompts();\n  const resources = await loadResourcesForPrompt(\n    input.scope === \"org\" ? SHARED_OWNER : input.ownerEmail,\n    compact,\n    input.appId,\n    input.orgId ?? null,\n  );\n  const schemaBlock = compact\n    ? \"\"\n    : await buildSchemaBlock(input.ownerEmail, \"read\");\n  const sections = await buildSystemManifestSections([\n    {\n      label: \"Framework core\",\n      provenance: \"framework-core\",\n      governance: \"required\",\n      content: compact\n        ? prompts.PROD_FRAMEWORK_PROMPT_COMPACT\n        : prompts.PROD_FRAMEWORK_PROMPT,\n      sourceRef: { scope: \"framework\" },\n    },\n    ...promptResourceManifestSections(resources),\n    ...(schemaBlock\n      ? [\n          {\n            label: \"SQL schema\",\n            provenance: \"db-schema\" as const,\n            governance: \"required\" as const,\n            content: schemaBlock,\n            sourceRef: { scope: \"sql\" },\n          },\n        ]\n      : []),\n  ]);\n  const systemTokens = sections.reduce(\n    (total, section) => total + section.tokenCount,\n    0,\n  );\n  const tokenCountMethod = sections.reduce(\n    (method, section) => combineMethods(method, section.tokenMethod),\n    \"exact\" as ContextTokenCountMethod,\n  );\n  return {\n    computedAt: Date.now(),\n    ...(input.model ? { model: input.model } : {}),\n    scope: input.scope,\n    totalTokens: systemTokens,\n    systemTokens,\n    tokenCountMethod,\n    sections,\n    source: \"preview\",\n  };\n}\n\nexport default defineAction({\n  description:\n    \"Preview the system-prompt context that would be composed for the current user, organization, and app without a live chat thread.\",\n  schema: z.object({\n    scope: z\n      .enum([\"user\", \"org\"])\n      .default(\"user\")\n      .describe(\n        \"Configuration scope to preview: user includes personal context; org includes inherited organization context.\",\n      ),\n    appId: z.string().optional().describe(\"Current app id, when available.\"),\n    compact: z.boolean().optional().describe(\"Use the compact startup prompt.\"),\n    model: z.string().optional().describe(\"Model id for display metadata.\"),\n  }),\n  http: { method: \"GET\" },\n  readOnly: true,\n  publicAgent: { expose: true, readOnly: true, requiresAuth: true },\n  mcpApp: {\n    compactCatalog: true,\n    resource: embedApp({\n      title: \"Context preview\",\n      description:\n        \"Preview the system-prompt context before starting a thread.\",\n      iframeTitle: \"Context preview\",\n      openLabel: \"Open context preview\",\n      height: 720,\n    }),\n  },\n  run: async (args): Promise<ContextPreview> => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    return await buildContextPreview({\n      ownerEmail,\n      orgId: getRequestOrgId() ?? null,\n      scope: args.scope,\n      ...(args.appId ? { appId: args.appId } : {}),\n      ...(args.compact !== undefined ? { compact: args.compact } : {}),\n      ...(args.model ? { model: args.model } : {}),\n    });\n  },\n});\n"]}

package/dist/agent/context-xray/actions/context-restore.js

@@ -2,8 +2,8 @@ import { z } from "zod";
 import { defineAction } from "../../../action.js";
 import { getRequestUserEmail } from "../../../server/request-context.js";
 import { callerOwnsThread } from "../../run-ownership.js";
-import { deactivateContextDirective, writeContextManifestStatus, } from "../directives-store.js";
-import { contextXrayAuthError, contextXrayThreadNotFoundError, } from "./errors.js";
+import { deactivateContextDirective, readContextManifest, writeContextManifestStatus, } from "../directives-store.js";
+import { contextXrayAuthError, contextXraySystemSegmentError, contextXrayThreadNotFoundError, isContextXraySystemSegment, } from "./errors.js";
 export default defineAction({
     description: "Restore a Context X-Ray segment by deactivating its pin, evict, or summarize directive.",
     schema: z.object({
@@ -17,6 +17,9 @@ export default defineAction({
         if (!(await callerOwnsThread(ownerEmail, args.threadId))) {
             throw contextXrayThreadNotFoundError();
         }
+        if (isContextXraySystemSegment(await readContextManifest(args.threadId), args.segmentId)) {
+            throw contextXraySystemSegmentError();
+        }
         const restored = await deactivateContextDirective({
             threadId: args.threadId,
             segmentId: args.segmentId,

package/dist/agent/context-xray/actions/context-restore.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-restore.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,yFAAyF;IAC3F,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU;SACX,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport { getRequestUserEmail } from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  deactivateContextDirective,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXrayThreadNotFoundError,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Restore a Context X-Ray segment by deactivating its pin, evict, or summarize directive.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    const restored = await deactivateContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      ownerEmail,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"active\",\n    });\n    return { restored, manifest };\n  },\n});\n"]}
+{"version":3,"file":"context-restore.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/context-restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,yFAAyF;IAC3F,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU;YAAE,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,8BAA8B,EAAE,CAAC;QACzC,CAAC;QACD,IACE,0BAA0B,CACxB,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxC,IAAI,CAAC,SAAS,CACf,EACD,CAAC;YACD,MAAM,6BAA6B,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU;SACX,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../../action.js\";\nimport { getRequestUserEmail } from \"../../../server/request-context.js\";\nimport { callerOwnsThread } from \"../../run-ownership.js\";\nimport {\n  deactivateContextDirective,\n  readContextManifest,\n  writeContextManifestStatus,\n} from \"../directives-store.js\";\nimport {\n  contextXrayAuthError,\n  contextXraySystemSegmentError,\n  contextXrayThreadNotFoundError,\n  isContextXraySystemSegment,\n} from \"./errors.js\";\n\nexport default defineAction({\n  description:\n    \"Restore a Context X-Ray segment by deactivating its pin, evict, or summarize directive.\",\n  schema: z.object({\n    threadId: z.string(),\n    segmentId: z.string(),\n  }),\n  run: async (args) => {\n    const ownerEmail = getRequestUserEmail();\n    if (!ownerEmail) throw contextXrayAuthError();\n    if (!(await callerOwnsThread(ownerEmail, args.threadId))) {\n      throw contextXrayThreadNotFoundError();\n    }\n    if (\n      isContextXraySystemSegment(\n        await readContextManifest(args.threadId),\n        args.segmentId,\n      )\n    ) {\n      throw contextXraySystemSegmentError();\n    }\n    const restored = await deactivateContextDirective({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      ownerEmail,\n    });\n    const manifest = await writeContextManifestStatus({\n      threadId: args.threadId,\n      segmentId: args.segmentId,\n      status: \"active\",\n    });\n    return { restored, manifest };\n  },\n});\n"]}

package/dist/agent/context-xray/actions/errors.d.ts

@@ -1,7 +1,10 @@
+import type { ContextManifest } from "../../../shared/context-xray.js";
 export declare class ContextXrayActionError extends Error {
     readonly statusCode: number;
     constructor(message: string, statusCode: number);
 }
 export declare function contextXrayAuthError(): ContextXrayActionError;
 export declare function contextXrayThreadNotFoundError(): ContextXrayActionError;
+export declare function contextXraySystemSegmentError(): ContextXrayActionError;
+export declare function isContextXraySystemSegment(manifest: ContextManifest | null, segmentId: string): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/dist/agent/context-xray/actions/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAF7B,YACE,OAAO,EAAE,MAAM,EACN,UAAU,EAAE,MAAM,EAI5B;CACF;AAED,wBAAgB,oBAAoB,IAAI,sBAAsB,CAK7D;AAED,wBAAgB,8BAA8B,IAAI,sBAAsB,CAEvE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAF7B,YACE,OAAO,EAAE,MAAM,EACN,UAAU,EAAE,MAAM,EAI5B;CACF;AAED,wBAAgB,oBAAoB,IAAI,sBAAsB,CAK7D;AAED,wBAAgB,8BAA8B,IAAI,sBAAsB,CAEvE;AAED,wBAAgB,6BAA6B,IAAI,sBAAsB,CAKtE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}

package/dist/agent/context-xray/actions/errors.js

@@ -12,4 +12,10 @@ export function contextXrayAuthError() {
 export function contextXrayThreadNotFoundError() {
     return new ContextXrayActionError("Thread not found.", 404);
 }
+export function contextXraySystemSegmentError() {
+    return new ContextXrayActionError("System Context X-Ray sections are required and cannot be pinned, evicted, or restored.", 400);
+}
+export function isContextXraySystemSegment(manifest, segmentId) {
+    return (manifest?.systemSections?.some((section) => section.segmentId === segmentId) ?? false);
+}
 //# sourceMappingURL=errors.js.map

package/dist/agent/context-xray/actions/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAGpC,UAAU;IAFrB,YACE,OAAe,EACN,UAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;0BAFN,UAAU;QAGnB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,sBAAsB,CAC/B,0CAA0C,EAC1C,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,IAAI,sBAAsB,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["export class ContextXrayActionError extends Error {\n  constructor(\n    message: string,\n    readonly statusCode: number,\n  ) {\n    super(message);\n    this.name = \"ContextXrayActionError\";\n  }\n}\n\nexport function contextXrayAuthError(): ContextXrayActionError {\n  return new ContextXrayActionError(\n    \"Context X-Ray requires a signed-in user.\",\n    401,\n  );\n}\n\nexport function contextXrayThreadNotFoundError(): ContextXrayActionError {\n  return new ContextXrayActionError(\"Thread not found.\", 404);\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/agent/context-xray/actions/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAGpC,UAAU;IAFrB,YACE,OAAe,EACN,UAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;0BAFN,UAAU;QAGnB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,sBAAsB,CAC/B,0CAA0C,EAC1C,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,IAAI,sBAAsB,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,sBAAsB,CAC/B,wFAAwF,EACxF,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgC,EAChC,SAAiB;IAEjB,OAAO,CACL,QAAQ,EAAE,cAAc,EAAE,IAAI,CAC5B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAC7C,IAAI,KAAK,CACX,CAAC;AACJ,CAAC","sourcesContent":["import type { ContextManifest } from \"../../../shared/context-xray.js\";\n\nexport class ContextXrayActionError extends Error {\n  constructor(\n    message: string,\n    readonly statusCode: number,\n  ) {\n    super(message);\n    this.name = \"ContextXrayActionError\";\n  }\n}\n\nexport function contextXrayAuthError(): ContextXrayActionError {\n  return new ContextXrayActionError(\n    \"Context X-Ray requires a signed-in user.\",\n    401,\n  );\n}\n\nexport function contextXrayThreadNotFoundError(): ContextXrayActionError {\n  return new ContextXrayActionError(\"Thread not found.\", 404);\n}\n\nexport function contextXraySystemSegmentError(): ContextXrayActionError {\n  return new ContextXrayActionError(\n    \"System Context X-Ray sections are required and cannot be pinned, evicted, or restored.\",\n    400,\n  );\n}\n\nexport function isContextXraySystemSegment(\n  manifest: ContextManifest | null,\n  segmentId: string,\n): boolean {\n  return (\n    manifest?.systemSections?.some(\n      (section) => section.segmentId === segmentId,\n    ) ?? false\n  );\n}\n"]}

package/dist/agent/context-xray/manifest.d.ts

@@ -1,6 +1,21 @@
-import { CONTEXT_XRAY_MANIFEST_KEY, type ContextDirective, type ContextManifest, type ContextManifestSource, type ContextSegmentStatus } from "../../shared/context-xray.js";
+import { CONTEXT_XRAY_MANIFEST_KEY, type ContextDirective, type ContextManifest, type ContextManifestSourceRef, type ContextManifestSystemSection, type ContextManifestSource, type ContextSegmentStatus, type ContextGovernanceTier, type ContextSystemProvenance } from "../../shared/context-xray.js";
 import type { EngineMessage } from "../engine/types.js";
 export { CONTEXT_XRAY_MANIFEST_KEY };
+export declare const CONTEXT_XRAY_REQUEST_SECTIONS_KEY = "__agentNativeContextXraySystemSections";
+export interface SystemManifestSectionInput {
+    label: string;
+    provenance: ContextSystemProvenance;
+    governance: ContextGovernanceTier;
+    content: string;
+    group?: string;
+    sourceRef?: ContextManifestSourceRef;
+}
+export declare function buildSystemManifestSections(inputs: SystemManifestSectionInput[]): Promise<ContextManifestSystemSection[]>;
+type ContextXRayEvent = {
+    context?: Record<string, unknown>;
+};
+export declare function setContextXraySystemSections(event: ContextXRayEvent, sections: ContextManifestSystemSection[]): void;
+export declare function readContextXraySystemSections(event: ContextXRayEvent): ContextManifestSystemSection[];
 export interface BuildManifestInput {
     threadId: string;
     turnId?: string;
@@ -12,7 +27,9 @@ export interface BuildManifestInput {
     protectedSegmentIds?: Set<string>;
     source?: ContextManifestSource;
     enforceable?: boolean;
+    systemSections?: ContextManifestSystemSection[];
 }
+export declare function contextXrayDeepLink(threadId: string): string;
 export declare function buildManifest(input: BuildManifestInput): Promise<ContextManifest>;
 export declare function writeContextManifest(threadId: string, manifest: ContextManifest): Promise<void>;
 export declare function updateManifestSegmentStatus(manifest: ContextManifest, segmentId: string, status: ContextSegmentStatus): ContextManifest;

package/dist/agent/context-xray/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/agent/context-xray/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAE1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0CD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,CAAC,CAgE1B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,GAC3B,eAAe,CAwBjB"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/agent/context-xray/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,eAAO,MAAM,iCAAiC,2CACJ,CAAC;AAE3C,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,uBAAuB,CAAC;IACpC,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAYD,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,0BAA0B,EAAE,GACnC,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAgCzC;AAED,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,4BAA4B,EAAE,GACvC,IAAI,CAGN;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,GACtB,4BAA4B,EAAE,CAKhC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,4BAA4B,EAAE,CAAC;CACjD;AAgCD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,CAAC,CA6E1B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,GAC3B,eAAe,CAwBjB"}

package/dist/agent/context-xray/manifest.js

@@ -1,9 +1,61 @@
+import { createHash } from "node:crypto";
 import { appStatePut } from "../../application-state/store.js";
 import { buildDeepLink } from "../../server/deep-link.js";
 import { CONTEXT_XRAY_MANIFEST_KEY, } from "../../shared/context-xray.js";
 import { computeSegments } from "./segments.js";
 import { countMessageTokens, countPartTokens, countTextTokens, } from "./tokenize.js";
 export { CONTEXT_XRAY_MANIFEST_KEY };
+export const CONTEXT_XRAY_REQUEST_SECTIONS_KEY = "__agentNativeContextXraySystemSections";
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function previewText(value) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (normalized.length <= 200)
+        return normalized;
+    return `${normalized.slice(0, 197)}...`;
+}
+export async function buildSystemManifestSections(inputs) {
+    const timestamp = Date.now();
+    return await Promise.all(inputs
+        .filter((input) => input.content.trim().length > 0)
+        .map(async (input, index) => {
+        const content = input.content.trim();
+        const count = await countTextTokens(content);
+        const identity = [
+            input.provenance,
+            input.label,
+            input.sourceRef?.resourceId ?? "",
+            input.sourceRef?.path ?? "",
+            content,
+            index,
+        ].join("\u0000");
+        return {
+            kind: "system",
+            segmentId: `system:${sha256(identity).slice(0, 16)}`,
+            group: input.group ?? "System",
+            label: input.label,
+            provenance: input.provenance,
+            governance: input.governance,
+            tokenCount: count.tokens,
+            tokenMethod: count.method,
+            ...(input.sourceRef ? { sourceRef: input.sourceRef } : {}),
+            contentHash: sha256(content),
+            preview: previewText(content),
+            timestamp,
+        };
+    }));
+}
+export function setContextXraySystemSections(event, sections) {
+    event.context = event.context ?? {};
+    event.context[CONTEXT_XRAY_REQUEST_SECTIONS_KEY] = sections;
+}
+export function readContextXraySystemSections(event) {
+    const sections = event.context?.[CONTEXT_XRAY_REQUEST_SECTIONS_KEY];
+    return Array.isArray(sections)
+        ? sections
+        : [];
+}
 function combineMethods(left, right) {
     return left === "estimate" || right === "estimate" ? "estimate" : "exact";
 }
@@ -24,7 +76,7 @@ async function summaryTokenCount(segmentId, status, directives) {
         return undefined;
     return (await countTextTokens(text)).tokens;
 }
-function contextXrayUrl(threadId) {
+export function contextXrayDeepLink(threadId) {
     const to = `/?contextXray=1&threadId=${encodeURIComponent(threadId)}`;
     return buildDeepLink({
         app: "agent-native",
@@ -63,8 +115,15 @@ export async function buildManifest(input) {
             partIndex: segment.partIndex,
         });
     }
-    const totalTokens = sentTokenTotals.tokens;
-    const rawTokens = rawTokenTotals.tokens;
+    const systemSections = input.systemSections ?? [];
+    const systemTokenTotals = systemSections.reduce((acc, section) => ({
+        tokens: acc.tokens + section.tokenCount,
+        method: combineMethods(acc.method, section.tokenMethod),
+    }), { tokens: 0, method: "exact" });
+    const conversationTokens = sentTokenTotals.tokens;
+    const rawConversationTokens = rawTokenTotals.tokens;
+    const totalTokens = systemTokenTotals.tokens + conversationTokens;
+    const rawTokens = systemTokenTotals.tokens + rawConversationTokens;
     return {
         threadId: input.threadId,
         ...(input.turnId ? { turnId: input.turnId } : {}),
@@ -72,12 +131,15 @@ export async function buildManifest(input) {
         ...(input.model ? { model: input.model } : {}),
         totalTokens,
         rawTokens,
-        reclaimedTokens: Math.max(0, rawTokens - totalTokens),
-        tokenCountMethod: combineMethods(rawTokenTotals.method, sentTokenTotals.method),
+        reclaimedTokens: Math.max(0, rawConversationTokens - conversationTokens),
+        tokenCountMethod: combineMethods(combineMethods(rawTokenTotals.method, sentTokenTotals.method), systemTokenTotals.method),
+        conversationTokens,
+        systemTokens: systemTokenTotals.tokens,
         source: input.source ?? "structured",
         enforceable: input.enforceable ?? true,
         segments,
-        url: contextXrayUrl(input.threadId),
+        ...(systemSections.length > 0 ? { systemSections } : {}),
+        url: contextXrayDeepLink(input.threadId),
     };
 }
 export async function writeContextManifest(threadId, manifest) {