@agent-native/core 0.152.0 → 0.153.0

package/corpus/templates/factory/actions/provider-api-docs.ts

@@ -0,0 +1,11 @@
+import { createProviderApiDocsAction } from "@agent-native/core/provider-api/actions/provider-api";
+
+import { fetchProviderApiDocs } from "../server/lib/provider-api.js";
+
+export default createProviderApiDocsAction(
+  { fetchDocs: fetchProviderApiDocs },
+  {
+    description:
+      "Inspect the public API documentation or capability metadata for a connected workspace provider before making an arbitrary provider request.",
+  },
+);

package/corpus/templates/factory/actions/provider-api-request.ts

@@ -0,0 +1,17 @@
+import { createProviderApiRequestAction } from "@agent-native/core/provider-api/actions/provider-api";
+import { getCredentialContext } from "@agent-native/core/server/request-context";
+
+import {
+  executeProviderApiRequest,
+  FACTORY_APP_ID,
+} from "../server/lib/provider-api.js";
+
+export default createProviderApiRequestAction(
+  { executeRequest: executeProviderApiRequest },
+  {
+    description:
+      "Call a connected provider API with shared workspace credentials. Use this flexible escape hatch when a Factory workflow needs a provider, endpoint, filter, pagination mode, payload, or API version that a compatibility action does not model. Never ask for or store provider keys in Factory.",
+    appId: FACTORY_APP_ID,
+    getOwnerEmail: () => getCredentialContext()?.userEmail ?? null,
+  },
+);

package/corpus/templates/factory/actions/save-triage-config.ts

@@ -13,19 +13,19 @@ const workspaceSchema = z.enum(["primary", "secondary"]);
 
 export default defineAction({
   description:
-    "Save Factory source settings. This controls Slack, GitHub, and Sentry polling; organization automations decide when governed provider work may start.",
+    "Save Factory automation alert settings. Provider credentials live in shared workspace integrations; legacy source routing metadata is preserved for the default observer adapters.",
   schema: z.object({
-    slackWorkspace: workspaceSchema.default("primary"),
+    slackWorkspace: workspaceSchema.optional(),
     slackChannelId: z.string().trim().min(1).max(128).optional(),
     slackChannelName: z.string().trim().max(200).optional(),
-    pollingEnabled: z.boolean().default(false),
-    githubPollingEnabled: z.boolean().default(false),
-    sentryPollingEnabled: z.boolean().default(false),
+    pollingEnabled: z.boolean().optional(),
+    githubPollingEnabled: z.boolean().optional(),
+    sentryPollingEnabled: z.boolean().optional(),
     sentryOrgSlug: z.string().trim().max(200).optional(),
     sentryProjectSlug: z.string().trim().max(200).optional(),
     sentryEnvironment: z.string().trim().max(200).optional(),
     repository: z.string().trim().max(256).optional(),
-    automationFailureAlertsEnabled: z.boolean().default(true),
+    automationFailureAlertsEnabled: z.boolean().optional(),
     automationFailureAlertEmail: z.string().trim().email().optional(),
   }),
   http: { method: "POST" },
@@ -53,13 +53,62 @@ export default defineAction({
     const db = getDb();
     const existing = (
       await db
-        .select({
-          automationFailureAlertEmail: triageConfig.automationFailureAlertEmail,
-        })
+        .select()
         .from(triageConfig)
         .where(and(eq(triageConfig.id, orgId), eq(triageConfig.orgId, orgId)))
         .limit(1)
     )[0];
+    const persistText = (
+      next: string | undefined,
+      previous: string | null | undefined,
+    ) => (next === undefined ? (previous ?? null) : next || null);
+    const persistedSlackWorkspace =
+      slackWorkspace ?? existing?.slackWorkspace ?? "primary";
+    const persistedSlackChannelId = persistText(
+      slackChannelId,
+      existing?.slackChannelId,
+    );
+    const persistedSlackChannelName = persistText(
+      slackChannelName,
+      existing?.slackChannelName,
+    );
+    const persistedRepository = persistText(repository, existing?.repository);
+    const persistedSentryOrgSlug = persistText(
+      sentryOrgSlug,
+      existing?.sentryOrgSlug,
+    );
+    const persistedSentryProjectSlug = persistText(
+      sentryProjectSlug,
+      existing?.sentryProjectSlug,
+    );
+    const persistedSentryEnvironment = persistText(
+      sentryEnvironment,
+      existing?.sentryEnvironment,
+    );
+    const persistedPollingEnabled =
+      pollingEnabled === undefined
+        ? (existing?.pollingEnabled ?? 0)
+        : pollingEnabled
+          ? 1
+          : 0;
+    const persistedGithubPollingEnabled =
+      githubPollingEnabled === undefined
+        ? (existing?.githubPollingEnabled ?? 0)
+        : githubPollingEnabled
+          ? 1
+          : 0;
+    const persistedSentryPollingEnabled =
+      sentryPollingEnabled === undefined
+        ? (existing?.sentryPollingEnabled ?? 0)
+        : sentryPollingEnabled
+          ? 1
+          : 0;
+    const persistedAutomationFailureAlertsEnabled =
+      automationFailureAlertsEnabled === undefined
+        ? (existing?.automationFailureAlertsEnabled ?? 1)
+        : automationFailureAlertsEnabled
+          ? 1
+          : 0;
     const persistedAutomationFailureAlertEmail =
       automationFailureAlertEmail ??
       existing?.automationFailureAlertEmail ??
@@ -68,17 +117,17 @@ export default defineAction({
       .insert(triageConfig)
       .values({
         id: orgId,
-        slackWorkspace,
-        slackChannelId: slackChannelId ?? null,
-        slackChannelName: slackChannelName ?? null,
-        pollingEnabled: pollingEnabled ? 1 : 0,
-        githubPollingEnabled: githubPollingEnabled ? 1 : 0,
-        sentryPollingEnabled: sentryPollingEnabled ? 1 : 0,
-        sentryOrgSlug: sentryOrgSlug ?? null,
-        sentryProjectSlug: sentryProjectSlug ?? null,
-        sentryEnvironment: sentryEnvironment ?? null,
-        repository: repository ?? null,
-        automationFailureAlertsEnabled: automationFailureAlertsEnabled ? 1 : 0,
+        slackWorkspace: persistedSlackWorkspace,
+        slackChannelId: persistedSlackChannelId,
+        slackChannelName: persistedSlackChannelName,
+        pollingEnabled: persistedPollingEnabled,
+        githubPollingEnabled: persistedGithubPollingEnabled,
+        sentryPollingEnabled: persistedSentryPollingEnabled,
+        sentryOrgSlug: persistedSentryOrgSlug,
+        sentryProjectSlug: persistedSentryProjectSlug,
+        sentryEnvironment: persistedSentryEnvironment,
+        repository: persistedRepository,
+        automationFailureAlertsEnabled: persistedAutomationFailureAlertsEnabled,
         automationFailureAlertEmail: persistedAutomationFailureAlertEmail,
         createdAt: now,
         updatedAt: now,
@@ -88,19 +137,18 @@ export default defineAction({
       .onConflictDoUpdate({
         target: triageConfig.id,
         set: {
-          slackWorkspace,
-          slackChannelId: slackChannelId ?? null,
-          slackChannelName: slackChannelName ?? null,
-          pollingEnabled: pollingEnabled ? 1 : 0,
-          githubPollingEnabled: githubPollingEnabled ? 1 : 0,
-          sentryPollingEnabled: sentryPollingEnabled ? 1 : 0,
-          sentryOrgSlug: sentryOrgSlug ?? null,
-          sentryProjectSlug: sentryProjectSlug ?? null,
-          sentryEnvironment: sentryEnvironment ?? null,
-          repository: repository ?? null,
-          automationFailureAlertsEnabled: automationFailureAlertsEnabled
-            ? 1
-            : 0,
+          slackWorkspace: persistedSlackWorkspace,
+          slackChannelId: persistedSlackChannelId,
+          slackChannelName: persistedSlackChannelName,
+          pollingEnabled: persistedPollingEnabled,
+          githubPollingEnabled: persistedGithubPollingEnabled,
+          sentryPollingEnabled: persistedSentryPollingEnabled,
+          sentryOrgSlug: persistedSentryOrgSlug,
+          sentryProjectSlug: persistedSentryProjectSlug,
+          sentryEnvironment: persistedSentryEnvironment,
+          repository: persistedRepository,
+          automationFailureAlertsEnabled:
+            persistedAutomationFailureAlertsEnabled,
           automationFailureAlertEmail: persistedAutomationFailureAlertEmail,
           updatedAt: now,
           ownerEmail: userEmail,
@@ -108,11 +156,12 @@ export default defineAction({
       });
     return {
       ok: true,
-      pollingEnabled,
-      githubPollingEnabled,
-      sentryPollingEnabled,
-      slackChannelId: slackChannelId ?? null,
-      automationFailureAlertsEnabled,
+      pollingEnabled: persistedPollingEnabled === 1,
+      githubPollingEnabled: persistedGithubPollingEnabled === 1,
+      sentryPollingEnabled: persistedSentryPollingEnabled === 1,
+      slackChannelId: persistedSlackChannelId,
+      automationFailureAlertsEnabled:
+        persistedAutomationFailureAlertsEnabled === 1,
       automationFailureAlertEmail: persistedAutomationFailureAlertEmail,
     };
   },

package/corpus/templates/factory/app/components/factory/FactoryAuditView.tsx

@@ -143,12 +143,12 @@ export function FactoryAuditView({
               </div>
             </CardHeader>
             <CardContent className="p-0">
-              <div className="divide-y">
+              <div className="grid gap-1.5 p-2">
                 {runs.map((run) => (
                   <button
                     key={run.id}
                     type="button"
-                    className={`w-full cursor-pointer p-3 text-left transition-colors hover:bg-muted/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring ${selectedRun?.id === run.id ? "bg-muted/60" : ""}`}
+                    className={`w-full cursor-pointer rounded-lg bg-muted/20 p-3 text-left transition-colors hover:bg-muted/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring ${selectedRun?.id === run.id ? "bg-muted/60" : ""}`}
                     onClick={() => selectRun(run.id)}
                   >
                     <div className="flex items-center justify-between gap-3">
@@ -173,7 +173,7 @@ export function FactoryAuditView({
           </Card>
 
           <Card>
-            <CardHeader className="border-b px-4 py-3">
+            <CardHeader className="px-4 py-3">
               <div className="flex flex-wrap items-start justify-between gap-3">
                 <div className="min-w-0">
                   <CardTitle className="truncate text-base">
@@ -238,7 +238,7 @@ function AuditRunDetail({ run }: { run: FactoryAuditRun }) {
       </div>
 
       {run.error && (
-        <div className="mt-4 rounded-md border border-destructive/30 bg-destructive/5 p-3 text-sm">
+        <div className="mt-4 rounded-md bg-destructive/5 p-3 text-sm">
           <p className="font-medium text-destructive">
             {t("factoryRoute.auditRunError")}
           </p>
@@ -254,11 +254,11 @@ function AuditRunDetail({ run }: { run: FactoryAuditRun }) {
           </span>
         </div>
         {groups.length === 0 ? (
-          <p className="rounded-md border border-dashed p-4 text-sm text-muted-foreground">
+          <p className="rounded-md bg-muted/20 p-4 text-sm text-muted-foreground">
             {t("factoryRoute.auditNoEvents")}
           </p>
         ) : (
-          <div className="overflow-hidden rounded-md border">
+          <div className="grid gap-1.5">
             {groups.map((group) => (
               <AuditItemRow key={group.key} group={group} />
             ))}
@@ -277,8 +277,8 @@ function AuditItemRow({ group }: { group: AuditItemGroup }) {
     group.sourceUrl ?? group.events.find((event) => event.sourceUrl)?.sourceUrl;
 
   return (
-    <details className="group border-b last:border-b-0">
-      <summary className="flex cursor-pointer list-none items-center gap-3 px-3 py-3 hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring [&::-webkit-details-marker]:hidden">
+    <details className="group rounded-lg bg-muted/20">
+      <summary className="flex cursor-pointer list-none items-center gap-3 rounded-lg px-3 py-3 hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring [&::-webkit-details-marker]:hidden">
         <AuditSourceIcon source={group.source} />
         <div className="min-w-0 flex-1">
           <p className="truncate text-sm font-medium">{group.title}</p>
@@ -294,7 +294,7 @@ function AuditItemRow({ group }: { group: AuditItemGroup }) {
         <AuditStatus status={group.status} compact />
         <IconChevronDown className="size-4 shrink-0 text-muted-foreground transition-transform duration-200 ease-[var(--ease-collapse)] group-open:rotate-180 motion-reduce:transition-none" />
       </summary>
-      <div className="border-t bg-muted/20 px-4 pb-4 pt-3">
+      <div className="bg-muted/20 px-4 pb-4 pt-3">
         <div className="grid gap-3 sm:grid-cols-[minmax(0,1fr)_auto]">
           <div>
             <p className="text-[11px] font-medium uppercase tracking-wide text-muted-foreground">
@@ -308,7 +308,7 @@ function AuditItemRow({ group }: { group: AuditItemGroup }) {
           <AuditDecisionFacts event={decision} />
         </div>
 
-        <div className="mt-4 border-t border-border/70 pt-3">
+        <div className="mt-4 rounded-md bg-background/40 p-3">
           <p className="text-[11px] font-medium uppercase tracking-wide text-muted-foreground">
             Trace
           </p>
@@ -333,7 +333,7 @@ function AuditItemRow({ group }: { group: AuditItemGroup }) {
         </div>
 
         {(group.itemId || sourceLink) && (
-          <div className="mt-4 flex flex-wrap items-center gap-x-4 gap-y-2 border-t border-border/70 pt-3 text-xs">
+          <div className="mt-4 flex flex-wrap items-center gap-x-4 gap-y-2 bg-background/40 px-3 py-3 text-xs">
             {group.itemId && (
               <a
                 href={`/factory?tab=inbox&itemId=${encodeURIComponent(group.itemId)}`}
@@ -387,7 +387,9 @@ function AuditDecisionFacts({ event }: { event: FactoryAuditEvent | null }) {
       {ownerArea && (
         <AuditFact label={t("factoryRoute.auditOwnerArea")} value={ownerArea} />
       )}
-      {guards && <AuditFact label="Guards" value={guards} />}
+      {guards && (
+        <AuditFact label={t("factoryRoute.auditGuardsLabel")} value={guards} />
+      )}
     </div>
   );
 }

package/corpus/templates/factory/app/components/factory/FactoryCanvas.tsx

@@ -73,16 +73,12 @@ const CANVAS_HEIGHT = 660;
 interface FactoryCanvasProps {
   graph: FactoryCanvasGraph;
   nodeMetrics?: Record<string, number>;
-  commentCounts?: Record<string, number>;
+  preview?: boolean;
   selectedNodeId?: string | null;
   selectedEdgeId?: string | null;
-  onSelectNode: (nodeId: string) => void;
-  onSelectEdge: (edgeId: string) => void;
+  onSelectNode?: (nodeId: string) => void;
+  onSelectEdge?: (edgeId: string) => void;
   onMoveNode?: (nodeId: string, position: { x: number; y: number }) => void;
-  onComment: (
-    targetType: "canvas" | "node" | "edge",
-    targetId?: string,
-  ) => void;
 }
 
 type DragState = {
@@ -97,13 +93,12 @@ const DRAG_THRESHOLD = 6;
 export function FactoryCanvas({
   graph,
   nodeMetrics = {},
-  commentCounts = {},
+  preview = false,
   selectedNodeId,
   selectedEdgeId,
   onSelectNode,
   onSelectEdge,
   onMoveNode,
-  onComment,
 }: FactoryCanvasProps) {
   const t = useT();
   const [zoom, setZoom] = useState(0.72);
@@ -165,7 +160,7 @@ export function FactoryCanvas({
     event: React.PointerEvent<HTMLButtonElement>,
     node: FactoryCanvasNode,
   ) {
-    if (!onMoveNode) return;
+    if (preview || !onMoveNode) return;
     const target = event.currentTarget.closest("[data-factory-canvas]");
     if (!(target instanceof HTMLElement)) return;
     const rect = target.getBoundingClientRect();
@@ -216,12 +211,11 @@ export function FactoryCanvas({
   }
 
   return (
-    <div className="relative min-h-[560px] overflow-hidden rounded-xl border bg-muted/20">
-      <div className="absolute inset-x-0 top-0 z-10 flex items-center justify-between border-b bg-background/90 px-3 py-2 backdrop-blur">
-        <div className="flex min-w-0 items-center gap-2 text-xs text-muted-foreground">
-          <span className="truncate">{t("factoryCanvas.dragHint")}</span>
-        </div>
-        <div className="flex items-center gap-1">
+    <div
+      className={`relative overflow-hidden rounded-xl bg-muted/20 ${preview ? "min-h-[360px]" : "min-h-[560px]"}`}
+    >
+      {!preview && (
+        <div className="absolute right-3 top-3 z-10 flex items-center gap-1 rounded-lg bg-background/75 p-1 shadow-sm backdrop-blur">
           <Tooltip>
             <TooltipTrigger asChild>
               <Button
@@ -280,9 +274,14 @@ export function FactoryCanvas({
             <TooltipContent>{t("factoryCanvas.fitToView")}</TooltipContent>
           </Tooltip>
         </div>
-      </div>
+      )}
 
-      <div ref={viewportRef} className="h-[560px] overflow-auto pt-12">
+      <div
+        ref={viewportRef}
+        className={
+          preview ? "h-[360px] overflow-hidden" : "h-[560px] overflow-auto"
+        }
+      >
         <div
           data-factory-canvas
           className="relative origin-top-left"
@@ -345,48 +344,48 @@ export function FactoryCanvas({
               })}
             </svg>
 
-            {graph.edges.map((edge) => {
-              const source = nodesById.get(edge.source);
-              const target = nodesById.get(edge.target);
-              if (!source || !target) return null;
-              const x1 = source.position.x + NODE_WIDTH;
-              const y1 = source.position.y + NODE_HEIGHT / 2;
-              const x2 = target.position.x;
-              const y2 = target.position.y + NODE_HEIGHT / 2;
-              const middle = x1 + (x2 - x1) / 2;
-              const path = `M ${x1} ${y1} C ${middle} ${y1}, ${middle} ${y2}, ${x2} ${y2}`;
-              return (
-                <button
-                  key={`${edge.id}-hitbox`}
-                  type="button"
-                  aria-label={t("factoryCanvas.selectRoute", {
-                    route: edge.label || edge.id,
-                  })}
-                  className="absolute inset-0 z-[1] block cursor-pointer bg-transparent text-left"
-                  style={{
-                    clipPath: "none",
-                    pointerEvents: "none",
-                  }}
-                  onClick={() => onSelectEdge(edge.id)}
-                >
-                  <span
-                    className="pointer-events-auto absolute h-4 w-full -translate-y-1/2 bg-transparent"
+            {!preview &&
+              graph.edges.map((edge) => {
+                const source = nodesById.get(edge.source);
+                const target = nodesById.get(edge.target);
+                if (!source || !target) return null;
+                const x1 = source.position.x + NODE_WIDTH;
+                const y1 = source.position.y + NODE_HEIGHT / 2;
+                const x2 = target.position.x;
+                const y2 = target.position.y + NODE_HEIGHT / 2;
+                const middle = x1 + (x2 - x1) / 2;
+                const path = `M ${x1} ${y1} C ${middle} ${y1}, ${middle} ${y2}, ${x2} ${y2}`;
+                return (
+                  <button
+                    key={`${edge.id}-hitbox`}
+                    type="button"
+                    aria-label={t("factoryCanvas.selectRoute", {
+                      route: edge.label || edge.id,
+                    })}
+                    className="absolute inset-0 z-[1] block cursor-pointer bg-transparent text-left"
                     style={{
-                      left: `${Math.min(x1, x2)}px`,
-                      top: `${Math.min(y1, y2)}px`,
-                      width: `${Math.abs(x2 - x1)}px`,
-                      transform: `rotate(${Math.atan2(y2 - y1, x2 - x1)}rad)`,
-                      transformOrigin: "left center",
+                      clipPath: "none",
+                      pointerEvents: "none",
                     }}
-                  />
-                  <span className="sr-only">{path}</span>
-                </button>
-              );
-            })}
+                    onClick={() => onSelectEdge?.(edge.id)}
+                  >
+                    <span
+                      className="pointer-events-auto absolute h-4 w-full -translate-y-1/2 bg-transparent"
+                      style={{
+                        left: `${Math.min(x1, x2)}px`,
+                        top: `${Math.min(y1, y2)}px`,
+                        width: `${Math.abs(x2 - x1)}px`,
+                        transform: `rotate(${Math.atan2(y2 - y1, x2 - x1)}rad)`,
+                        transformOrigin: "left center",
+                      }}
+                    />
+                    <span className="sr-only">{path}</span>
+                  </button>
+                );
+              })}
 
             {graph.nodes.map((node) => {
               const selected = selectedNodeId === node.id;
-              const comments = commentCounts[node.id] ?? 0;
               const metric = nodeMetrics[node.id] ?? 0;
               return (
                 <button
@@ -395,12 +394,13 @@ export function FactoryCanvas({
                   className={`absolute z-[2] flex h-[122px] w-[210px] flex-col rounded-xl border bg-card p-3 text-left shadow-sm transition-[border-color,box-shadow,transform] duration-150 ease-out hover:-translate-y-0.5 hover:border-primary/50 hover:shadow-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${selected ? "border-primary shadow-md ring-2 ring-primary/15" : "border-border"}`}
                   style={{ left: node.position.x, top: node.position.y }}
                   onClick={() => {
-                    if (!dragMoved.current) onSelectNode(node.id);
+                    if (!dragMoved.current) onSelectNode?.(node.id);
                   }}
-                  onPointerDown={(event) => beginDrag(event, node)}
-                  onPointerMove={moveNode}
-                  onPointerUp={endDrag}
-                  onDoubleClick={() => onComment("node", node.id)}
+                  onPointerDown={
+                    preview ? undefined : (event) => beginDrag(event, node)
+                  }
+                  onPointerMove={preview ? undefined : moveNode}
+                  onPointerUp={preview ? undefined : endDrag}
                 >
                   <span className="flex items-start justify-between gap-2">
                     <span className="flex min-w-0 items-center gap-2">
@@ -423,16 +423,6 @@ export function FactoryCanvas({
                         ? t("factoryCanvas.signals")
                         : t("factoryCanvas.events")}
                     </span>
-                    {comments > 0 && (
-                      <span>
-                        {comments}{" "}
-                        {t(
-                          comments === 1
-                            ? "factoryCanvas.commentOne"
-                            : "factoryCanvas.commentMany",
-                        )}
-                      </span>
-                    )}
                   </span>
                 </button>
               );
@@ -440,13 +430,6 @@ export function FactoryCanvas({
           </div>
         </div>
       </div>
-      <button
-        type="button"
-        className="absolute bottom-3 left-3 rounded-md bg-background/90 px-2 py-1 text-xs text-muted-foreground shadow-sm ring-1 ring-border hover:text-foreground"
-        onClick={() => onComment("canvas")}
-      >
-        {t("factoryCanvas.commentFactory")}
-      </button>
     </div>
   );
 }