Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

fix(agent-vault): audit product copy (#8172)

Adrian Kahali3f8e02c47f08
diff --git a/backend/package-lock.json b/backend/package-lock.json
index 609487f0b4..678204dc1d 100644
--- a/backend/package-lock.json
+++ b/backend/package-lock.json
@@ -6704,6 +6704,9 @@
"win32"
]
},
+ "node_modules/@infisical/quic/node_modules/@infisical/quic-linux-arm": {
+ "optional": true
+ },
"node_modules/@inquirer/external-editor": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/@inquirer/external-editor/-/external-editor-1.0.3.tgz",
diff --git a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-membership-router.ts b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-membership-router.ts
index aacac91ac3..db1473db91 100644
--- a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-membership-router.ts
+++ b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-membership-router.ts
@@ -139,7 +139,7 @@ export const registerAgentVaultMembershipRouter = async (server: FastifyZodProvi
role: ProductRoleSchema
})
.refine((val) => val.userIds.length + val.emails.length > 0, {
- message: "Provide at least one userId or email."
+ message: "Provide at least one user ID or email address."
}),
response: { 200: z.object({ members: MemberResultSchema.array(), skipped: z.string().array() }) }
},
diff --git a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-schemas.ts b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-schemas.ts
index bfdc904867..971f63e6a4 100644
--- a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-schemas.ts
+++ b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-schemas.ts
@@ -143,11 +143,11 @@ export const AgentVaultMemberIdsSchema = z
})
.refine(
(body) => body.userIds.length + body.identityIds.length + body.groupIds.length > 0,
- "Name at least one user, machine identity or group"
+ "Name at least one user, machine identity, or group"
)
.refine(
(body) => body.userIds.length + body.identityIds.length + body.groupIds.length <= AGENT_VAULT_MAX_GRANTEES,
- `Grant an access bundle to at most ${AGENT_VAULT_MAX_GRANTEES} users, machine identities and groups at a time`
+ `Grant an access bundle to at most ${AGENT_VAULT_MAX_GRANTEES} users, machine identities, and groups at a time`
);
// A removed grant is gone, so this reports the row's own columns rather than joining the actor's name,
diff --git a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-session-router.ts b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-session-router.ts
index e5fc32d93f..73ddce6613 100644
--- a/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-session-router.ts
+++ b/backend/src/ee/routes/v1/agent-vault-routers/agent-vault-session-router.ts
@@ -93,7 +93,7 @@ export const registerAgentVaultSessionRouter = async (server: FastifyZodProvider
config: { rateLimit: writeLimit },
schema: {
operationId: "createAgentVaultSession",
- description: "Mint an Agent Vault session over an access bundle you can reach",
+ description: "Create an Agent Vault session with an access bundle you can reach",
tags: [ApiDocsTags.AgentVaultSessions],
body: z.object({
accessBundles: slugSchema({ max: 64, field: "Access bundle" })
@@ -116,14 +116,14 @@ export const registerAgentVaultSessionRouter = async (server: FastifyZodProvider
if (typeof parsed !== "number" || Number.isNaN(parsed) || parsed < 60 * 1000) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
- message: "TTL must be a duration of at least 1 minute, such as 30m, 8h or 7d, or never"
+ message: "TTL must be a duration of at least 1 minute, such as 30m, 8h, 7d, or never"
});
return;
}
if (parsed > AGENT_VAULT_SESSION_MAX_TTL_MS) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
- message: "TTL must be at most 100 years. Use never for a session that does not expire"
+ message: "TTL must be at most 100 years. Use never for a session that doesn't expire"
});
}
})
diff --git a/backend/src/ee/services/agent-vault-access-bundle/agent-vault-access-bundle-service.ts b/backend/src/ee/services/agent-vault-access-bundle/agent-vault-access-bundle-service.ts
index dfc0b291b9..2aa7712a78 100644
--- a/backend/src/ee/services/agent-vault-access-bundle/agent-vault-access-bundle-service.ts
+++ b/backend/src/ee/services/agent-vault-access-bundle/agent-vault-access-bundle-service.ts
@@ -250,7 +250,7 @@ export const agentVaultAccessBundleServiceFactory = (deps: TAgentVaultAccessBund
if (credential.type === AgentVaultCredentialType.Bearer && credential.value === undefined) {
throw new BadRequestError({
message:
- "Changing the credential type to bearer needs the token, because the stored secret belongs to the old type"
+ "Provide a new token when changing the credential type to bearer. The stored secret belongs to the previous type"
});
}
return splitCredential(
@@ -715,7 +715,7 @@ export const agentVaultAccessBundleServiceFactory = (deps: TAgentVaultAccessBund
outcome = await grant();
} catch (err) {
if (isUniqueViolation(err)) {
- throw new BadRequestError({ message: "That user, machine identity or group already has this access bundle" });
+ throw new BadRequestError({ message: "That user, machine identity, or group already has this access bundle" });
}
throw err;
}
diff --git a/backend/src/ee/services/agent-vault-member/agent-vault-membership-service.ts b/backend/src/ee/services/agent-vault-member/agent-vault-membership-service.ts
index 66d5e7dafc..c2ecfea141 100644
--- a/backend/src/ee/services/agent-vault-member/agent-vault-membership-service.ts
+++ b/backend/src/ee/services/agent-vault-member/agent-vault-membership-service.ts
@@ -332,7 +332,7 @@ export const agentVaultMembershipServiceFactory = ({
if (dto.userId) return { column: "actorUserId" as const, id: dto.userId, label: "User" };
if (dto.groupId) return { column: "actorGroupId" as const, id: dto.groupId, label: "Group" };
if (dto.identityId) return { column: "actorIdentityId" as const, id: dto.identityId, label: "Machine identity" };
- throw new BadRequestError({ message: "Name exactly one user, group or machine identity" });
+ throw new BadRequestError({ message: "Name exactly one user, group, or machine identity" });
};
const assertValidRole = (role: string) => {
@@ -362,7 +362,7 @@ export const agentVaultMembershipServiceFactory = ({
// org check below passes for it. Only Agent Vault's own identities and unscoped org ones belong here.
if (identity.projectId && identity.projectId !== projectId) {
throw new BadRequestError({
- message: `Machine identity with ID '${dto.identityId}' belongs to another project and cannot be given Agent Vault access`
+ message: `Machine identity with ID '${dto.identityId}' belongs to another project and cannot be given access to Agent Vault`
});
}
}
diff --git a/backend/src/ee/services/agent-vault-proxy/agent-vault-proxy-service.ts b/backend/src/ee/services/agent-vault-proxy/agent-vault-proxy-service.ts
index a43d1cd826..17146f53da 100644
--- a/backend/src/ee/services/agent-vault-proxy/agent-vault-proxy-service.ts
+++ b/backend/src/ee/services/agent-vault-proxy/agent-vault-proxy-service.ts
@@ -307,9 +307,9 @@ export const agentVaultProxyServiceFactory = ({
throw new NotFoundError({ message: "Session not found" });
}
- if (session.revokedAt) throw new UnauthorizedError({ message: "Session revoked" });
+ if (session.revokedAt) throw new UnauthorizedError({ message: "This session has been revoked" });
if (session.expiresAt && session.expiresAt <= new Date()) {
- throw new UnauthorizedError({ message: "Session expired" });
+ throw new UnauthorizedError({ message: "This session has expired" });
}
// The actor columns are SET NULL so the row outlives its owner for history. A null id must not reach the
// lookups below: knex compiles `where col = null` to `IS NULL`, which matches every user row and made an
diff --git a/backend/src/ee/services/agent-vault-session/agent-vault-session-service.ts b/backend/src/ee/services/agent-vault-session/agent-vault-session-service.ts
index 689e276851..b2fa900183 100644
--- a/backend/src/ee/services/agent-vault-session/agent-vault-session-service.ts
+++ b/backend/src/ee/services/agent-vault-session/agent-vault-session-service.ts
@@ -66,13 +66,13 @@ export const agentVaultSessionServiceFactory = ({
);
if (!accessBundles.length) {
- throw new BadRequestError({ message: "Name the access bundle the session should carry" });
+ throw new BadRequestError({ message: "Name the access bundle this session should carry" });
}
if (accessBundles.length > AGENT_VAULT_MAX_SESSION_BUNDLES) {
- throw new BadRequestError({ message: "A session carries one access bundle. Name a single bundle." });
+ throw new BadRequestError({ message: "A session carries one access bundle. Name only one." });
}
if (new Set(accessBundles).size !== accessBundles.length) {
- throw new BadRequestError({ message: "The same access bundle is named more than once. Name it once." });
+ throw new BadRequestError({ message: "You've named the same access bundle more than once. Name it only once." });
}
const bundles = await agentVaultAccessBundleDAL.find({ projectId, $in: { name: accessBundles } });
diff --git a/frontend/src/components/agent-vault/AccessBundleFormDialog.tsx b/frontend/src/components/agent-vault/AccessBundleFormDialog.tsx
index 243c7d9a5a..6b889d742c 100644
--- a/frontend/src/components/agent-vault/AccessBundleFormDialog.tsx
+++ b/frontend/src/components/agent-vault/AccessBundleFormDialog.tsx
@@ -86,7 +86,7 @@ export const AccessBundleFormDialog = ({ isOpen, onOpenChange, accessBundle }: P
<DialogHeader>
<DialogTitle>{isUpdate ? "Edit Access Bundle" : "Create Access Bundle"}</DialogTitle>
<DialogDescription>
- An access bundle groups the services an agent may use.
+ An access bundle groups the services an agent can reach in one session.
</DialogDescription>
</DialogHeader>
@@ -103,7 +103,7 @@ export const AccessBundleFormDialog = ({ isOpen, onOpenChange, accessBundle }: P
placeholder="on-call-infrastructure"
isError={Boolean(fieldState.error)}
/>
- <FieldDescription>Lowercase letters, numbers and hyphens.</FieldDescription>
+ <FieldDescription>Use lowercase letters, numbers, and hyphens.</FieldDescription>
<FieldError>{fieldState.error?.message}</FieldError>
</FieldContent>
</Field>
diff --git a/frontend/src/components/agent-vault/AddMemberDialog.tsx b/frontend/src/components/agent-vault/AddMemberDialog.tsx
index 7bdd7ad025..6255b634ba 100644
--- a/frontend/src/components/agent-vault/AddMemberDialog.tsx
+++ b/frontend/src/components/agent-vault/AddMemberDialog.tsx
@@ -125,7 +125,13 @@ export const AddMemberDialog = ({ isOpen, onOpenChange, accessBundleId, members
});
if (!granted.length) {
- createNotification({ text: "They already had this access bundle", type: "info" });
+ createNotification({
+ text:
+ selected.length === 1
+ ? `"${selected[0].label}" already has this access bundle`
+ : `All ${selected.length} selected members already have this access bundle`,
+ type: "info"
+ });
} else {
const grantedText =
granted.length === 1 && selected.length === 1
@@ -148,8 +154,8 @@ export const AddMemberDialog = ({ isOpen, onOpenChange, accessBundleId, members
<DialogHeader>
<DialogTitle>Grant Access</DialogTitle>
<DialogDescription>
- Whoever holds this bundle can mint a session over it. They must already be a member of
- Agent Vault.
+ Whoever has access to this bundle can create sessions with it. They must already be a
+ member of Agent Vault.
</DialogDescription>
</DialogHeader>
@@ -170,7 +176,7 @@ export const AddMemberDialog = ({ isOpen, onOpenChange, accessBundleId, members
emptyMessage={
options.length
? "No matches."
- : "Nobody left to grant. Add them under Access Control first."
+ : "No one left to add. Add them under Access Control first."
}
clearAriaLabel="Clear all grantees"
modal
diff --git a/frontend/src/components/agent-vault/ManageAccessSheet.tsx b/frontend/src/components/agent-vault/ManageAccessSheet.tsx
index 0e796b31a8..f4357b2f3f 100644
--- a/frontend/src/components/agent-vault/ManageAccessSheet.tsx
+++ b/frontend/src/components/agent-vault/ManageAccessSheet.tsx
@@ -82,7 +82,9 @@ export const ManageAccessSheet = ({ accessBundle, onOpenChange }: Props) => {
<SheetContent className="sm:max-w-[640px]">
<SheetHeader>
<SheetTitle>Manage Access</SheetTitle>
- <SheetDescription>Who can mint a session over {accessBundle?.name}.</SheetDescription>
+ <SheetDescription>
+ Manage who can create sessions with {accessBundle?.name}.
+ </SheetDescription>
</SheetHeader>
<div className="flex min-h-0 flex-1 flex-col gap-4 overflow-y-auto p-4">
@@ -100,7 +102,7 @@ export const ManageAccessSheet = ({ accessBundle, onOpenChange }: Props) => {
<EmptyHeader>
<EmptyTitle>No members yet</EmptyTitle>
<EmptyDescription>
- Grant this bundle to a user, machine identity or group.
+ Grant this bundle to a user, machine identity, or group.
</EmptyDescription>
</EmptyHeader>
</Empty>
@@ -172,8 +174,8 @@ export const ManageAccessSheet = ({ accessBundle, onOpenChange }: Props) => {
Revoke Access for &quot;{memberToRemoveName}&quot;
</AlertDialogTitle>
<AlertDialogDescription>
- They lose this bundle, and any live session they hold stops reaching its hosts at
- the next proxy poll.
+ They lose this access bundle. Any active session they hold stops reaching its hosts
+ at the next proxy poll.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
diff --git a/frontend/src/components/agent-vault/ServiceTemplateSelect.tsx b/frontend/src/components/agent-vault/ServiceTemplateSelect.tsx
index 4f9ce8b954..a046bfec55 100644
--- a/frontend/src/components/agent-vault/ServiceTemplateSelect.tsx
+++ b/frontend/src/components/agent-vault/ServiceTemplateSelect.tsx
@@ -62,7 +62,7 @@ const CustomCard = ({ onSelect }: { onSelect: () => void }) => (
</div>
<div className="flex flex-col gap-1">
<p className="text-sm font-semibold text-foreground">Custom</p>
- <p className="text-xs leading-relaxed text-muted">Name the hosts yourself.</p>
+ <p className="text-xs leading-relaxed text-muted">Configure the hosts yourself.</p>
</div>
</button>
);
@@ -106,7 +106,7 @@ export const ServiceTemplateSelect = ({ onSelect }: Props) => {
<InputGroupInput
value={search}
onChange={(e) => setSearch(e.target.value)}
- placeholder="Search templates — OpenAI, Anthropic, Slack, GitHub..."
+ placeholder="Search templates (e.g., OpenAI, Anthropic, Slack, GitHub...)"
/>
</InputGroup>
diff --git a/frontend/src/components/agent-vault/service-sheet/CredentialFields.tsx b/frontend/src/components/agent-vault/service-sheet/CredentialFields.tsx
index 069b42dd73..ee8717f2c8 100644
--- a/frontend/src/components/agent-vault/service-sheet/CredentialFields.tsx
+++ b/frontend/src/components/agent-vault/service-sheet/CredentialFields.tsx
@@ -226,10 +226,10 @@ export const CredentialFields = ({ storedType }: Props) => {
{credentialType === AgentVaultCredentialType.Passthrough && (
<Alert variant="info">
- <AlertTitle>No credentials are sent</AlertTitle>
+ <AlertTitle>No credential is attached</AlertTitle>
<AlertDescription>
- Requests go out as they are. On a proxy that denies everything else, this is what makes
- these hosts reachable.
+ The proxy forwards requests to these hosts unchanged. Use this when you need a host to
+ be reachable through a proxy that would otherwise block it.
</AlertDescription>
</Alert>
)}
diff --git a/frontend/src/components/agent-vault/service-sheet/DetailsFields.tsx b/frontend/src/components/agent-vault/service-sheet/DetailsFields.tsx
index 8193df5a75..d35b9602fe 100644
--- a/frontend/src/components/agent-vault/service-sheet/DetailsFields.tsx
+++ b/frontend/src/components/agent-vault/service-sheet/DetailsFields.tsx
@@ -25,7 +25,7 @@ export const DetailsFields = () => {
<FieldLabel>Name</FieldLabel>
<FieldContent>
<Input {...field} placeholder="datadog-us5" isError={Boolean(fieldState.error)} />
- <FieldDescription>Lowercase letters, numbers and hyphens.</FieldDescription>
+ <FieldDescription>Use lowercase letters, numbers, and hyphens.</FieldDescription>
<FieldError>{fieldState.error?.message}</FieldError>
</FieldContent>
</Field>
@@ -46,7 +46,7 @@ export const DetailsFields = () => {
isError={Boolean(fieldState.error)}
/>
<FieldDescription>
- Comma separated. Wildcards like *.example.com are allowed.
+ Separate multiple hosts with commas. Wildcards like *.example.com are allowed.
</FieldDescription>
<FieldError>{fieldState.error?.message}</FieldError>
</FieldContent>
diff --git a/frontend/src/components/agent-vault/service-sheet/stepMeta.ts b/frontend/src/components/agent-vault/service-sheet/stepMeta.ts
index 39cc0b7bf0..568b2f7534 100644
--- a/frontend/src/components/agent-vault/service-sheet/stepMeta.ts
+++ b/frontend/src/components/agent-vault/service-sheet/stepMeta.ts
@@ -26,7 +26,8 @@ export const SERVICE_STEPS: StepMeta[] = [
title: "Details",
subtitle: "What this service is called, and the hosts it covers.",
rightLabel: "DETAILS",
- rightDescription: "The credentials are only used for the hosts you list here."
+ rightDescription:
+ "The proxy only attaches the credential to requests that reach the hosts you list here."
},
{
step: ServiceStep.Credential,
@@ -35,7 +36,7 @@ export const SERVICE_STEPS: StepMeta[] = [
title: "Credential",
subtitle: "How requests to this service are authenticated.",
rightLabel: "CREDENTIAL",
- rightDescription: "Agents reach this service without ever holding the credentials themselves."
+ rightDescription: "Agents reach this service without ever holding the credential themselves."
},
{
step: ServiceStep.Review,
diff --git a/frontend/src/helpers/roles.ts b/frontend/src/helpers/roles.ts
index f452ac7e7b..019a2d1589 100644
--- a/frontend/src/helpers/roles.ts
+++ b/frontend/src/helpers/roles.ts
@@ -42,7 +42,7 @@ export const AGENT_VAULT_PRODUCT_ROLE_OPTIONS = [
{
value: ProjectMembershipRole.Member,
label: "Member",
- description: "Create sessions over the access bundles they're granted"
+ description: "Create sessions with the access bundles they're granted"
}
];
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessBundleDetailPage/components/ServicesCard.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessBundleDetailPage/components/ServicesCard.tsx
index 4c71e7065f..9056e6e453 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessBundleDetailPage/components/ServicesCard.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessBundleDetailPage/components/ServicesCard.tsx
@@ -163,8 +163,8 @@ export const ServicesCard = ({ accessBundleId, services, canManage, onAdd, onEdi
<DocumentationLinkBadge href={AgentVaultDocsUrls.accessBundles} />
</CardTitle>
<CardDescription>
- A service names one API the agent may reach, the hosts it answers on, and the credential
- the proxy attaches.
+ A service defines one API the agent can reach, the hosts the API answers on, and the
+ credential the proxy attaches to matching requests.
</CardDescription>
{canManage && (
<CardAction>
@@ -200,7 +200,7 @@ export const ServicesCard = ({ accessBundleId, services, canManage, onAdd, onEdi
</EmptyTitle>
<EmptyDescription>
{services.length === 0
- ? "Add a service to give this bundle a host and a credential."
+ ? "Add services to give this bundle access to external hosts."
: "Try a different search term."}
</EmptyDescription>
</EmptyHeader>
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/AgentVaultAccessBundlesPage.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/AgentVaultAccessBundlesPage.tsx
index 5fb34594e1..1bd4259e14 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/AgentVaultAccessBundlesPage.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/AgentVaultAccessBundlesPage.tsx
@@ -136,7 +136,7 @@ export const AgentVaultAccessBundlesPage = () => {
emptyDescription = "Try a different search term.";
} else if (isAdmin) {
emptyTitle = "No access bundles yet";
- emptyDescription = "Create one to group the services an agent may use.";
+ emptyDescription = "Create one to group the services an agent can reach.";
} else {
emptyTitle = "No access bundles available";
emptyDescription = "Ask an admin to grant you an access bundle.";
@@ -151,7 +151,7 @@ export const AgentVaultAccessBundlesPage = () => {
scope={ProjectType.AgentVault}
icon={PackageIcon}
title="Access Bundles"
- description="Define what's included and who can use it."
+ description="Group the services an agent can reach through a session."
/>
<Card>
@@ -161,8 +161,8 @@ export const AgentVaultAccessBundlesPage = () => {
<DocumentationLinkBadge href={AgentVaultDocsUrls.accessBundles} />
</CardTitle>
<CardDescription>
- Each bundle holds the services an agent may use and the members who can mint a session
- over it.
+ Each bundle holds the services an agent can reach and the members who can create
+ sessions with it.
</CardDescription>
{isAdmin && (
<CardAction>
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/components/DeleteAccessBundleDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/components/DeleteAccessBundleDialog.tsx
index 810ccc5310..e5a53c04a2 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/components/DeleteAccessBundleDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessBundlesPage/components/DeleteAccessBundleDialog.tsx
@@ -30,7 +30,7 @@ export const DeleteAccessBundleDialog = ({ accessBundle, onOpenChange, onDeleted
isOpen={Boolean(accessBundle)}
onOpenChange={onOpenChange}
title={`Delete "${accessBundle?.name}"`}
- description="Its services and every grant on it go with it. Any live session carrying it loses them at the next proxy poll. This cannot be undone."
+ description="Its services and access grants are deleted with it. Any active session associated with this bundle loses access at the next proxy poll. This cannot be undone."
confirmKey={accessBundle?.name ?? ""}
isPending={deleteAccessBundle.isPending}
onConfirm={handleDelete}
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/GroupsTab.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/GroupsTab.tsx
index 8277629cd4..de38ab4f6e 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/GroupsTab.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/GroupsTab.tsx
@@ -187,7 +187,7 @@ export const GroupsTab = () => {
if (!isOpen) setGroupToRemove(null);
}}
title={`Remove "${groupToRemove?.name ?? ""}"`}
- description="Everyone in the group loses access, along with every bundle granted to it."
+ description="Everyone in the group loses Agent Vault access, along with every access bundle granted to the group."
confirmKey={groupToRemove?.name ?? ""}
confirmLabel="Remove"
isPending={removeMember.isPending}
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/IdentitiesTab.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/IdentitiesTab.tsx
index cf0ab323c0..b19aade8e0 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/IdentitiesTab.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/IdentitiesTab.tsx
@@ -271,8 +271,8 @@ export const IdentitiesTab = () => {
}
description={
toRemove && isAgentVaultManaged(toRemove)
- ? "This identity lives in Agent Vault, so it is deleted along with its access. This cannot be undone."
- : "The identity itself is left alone. It loses access and every bundle granted to it."
+ ? "This machine identity is managed by Agent Vault. Deleting it removes the identity along with its access. This cannot be undone."
+ : "It loses Agent Vault access, along with every access bundle granted to it. The machine identity won't be deleted because it isn't managed by Agent Vault."
}
confirmKey={toRemove?.name ?? ""}
confirmLabel={toRemove && isAgentVaultManaged(toRemove) ? "Delete" : "Remove"}
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/InviteMembersDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/InviteMembersDialog.tsx
index cf96717386..6cd0e573bb 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/InviteMembersDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/InviteMembersDialog.tsx
@@ -163,7 +163,9 @@ export const InviteMembersDialog = ({ isOpen, onOpenChange }: Props) => {
{requesterEmail && requesterStatus.isProjectUser && (
<Alert variant="danger">
- <AlertDescription>Requested user already has access to Agent Vault.</AlertDescription>
+ <AlertDescription>
+ The requested user already has access to Agent Vault.
+ </AlertDescription>
</Alert>
)}
{requesterEmail && !requesterStatus.isProjectUser && requesterUserId && (
@@ -171,8 +173,7 @@ export const InviteMembersDialog = ({ isOpen, onOpenChange }: Props) => {
{/* AlertDescription is a grid, so a bare text node would land on its own row */}
<AlertDescription>
<span>
- Assign a role to provide access to requesting user{" "}
- <b>{requesterStatus.userLabel}</b>.
+ Assign a role to give access to requesting user <b>{requesterStatus.userLabel}</b>.
</span>
</AlertDescription>
</Alert>
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/MembersTab.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/MembersTab.tsx
index 116b2b9e94..7afecc82dd 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/MembersTab.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/MembersTab.tsx
@@ -239,7 +239,7 @@ export const MembersTab = () => {
if (!isOpen) setMemberToRemove(null);
}}
title={`Remove "${memberToRemove ? displayName(memberToRemove) : ""}"`}
- description="They lose every access bundle granted to them, and any live session stops reaching its hosts at the next proxy poll."
+ description="They lose every access bundle granted to them. Any active session they hold stops reaching its hosts at the next proxy poll."
confirmKey={memberToRemove ? displayName(memberToRemove) : ""}
confirmLabel="Remove"
isPending={removeMember.isPending}
diff --git a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/ProductRoleDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/ProductRoleDialog.tsx
index 0eaf1dcf2f..9257726c58 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/ProductRoleDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAccessControlPage/components/ProductRoleDialog.tsx
@@ -52,7 +52,7 @@ export const ProductRoleDialog = ({ isOpen, onOpenChange, subject, currentRole,
<DialogContent>
<DialogHeader>
<DialogTitle>Change Role</DialogTitle>
- <DialogDescription>What {subject} can do here.</DialogDescription>
+ <DialogDescription>Choose what {subject} can do in Agent Vault.</DialogDescription>
</DialogHeader>
<Field>
<FieldLabel>Product Role</FieldLabel>
diff --git a/frontend/src/pages/agent-vault/AgentVaultAuditLogsPage/AgentVaultAuditLogsPage.tsx b/frontend/src/pages/agent-vault/AgentVaultAuditLogsPage/AgentVaultAuditLogsPage.tsx
index 73ecf927c6..2fad6a7d50 100644
--- a/frontend/src/pages/agent-vault/AgentVaultAuditLogsPage/AgentVaultAuditLogsPage.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultAuditLogsPage/AgentVaultAuditLogsPage.tsx
@@ -20,7 +20,7 @@ export const AgentVaultAuditLogsPage = () => {
scope={ProjectType.AgentVault}
icon={FileText}
title="Audit Logs"
- description="Audit logs for security and compliance teams to monitor information access."
+ description="Review Agent Vault activity for security and compliance."
/>
<LogsSection pageView project={currentProject} />
</div>
diff --git a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/AgentVaultProxiesPage.tsx b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/AgentVaultProxiesPage.tsx
index 9f4b20a812..cc56e8507c 100644
--- a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/AgentVaultProxiesPage.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/AgentVaultProxiesPage.tsx
@@ -220,7 +220,7 @@ export const AgentVaultProxiesPage = () => {
scope={ProjectType.AgentVault}
icon={RouteIcon}
title="Proxies"
- description="Manage the proxies your agents route through."
+ description="Manage the proxies your agents route their requests through."
/>
<Card>
diff --git a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyEnrollmentDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyEnrollmentDialog.tsx
index c9b31e82d6..5b99de898d 100644
--- a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyEnrollmentDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyEnrollmentDialog.tsx
@@ -72,8 +72,8 @@ export const ProxyEnrollmentDialog = ({ enrollment, onOpenChange }: Props) => {
<DialogHeader>
<DialogTitle>Enrollment Token</DialogTitle>
<DialogDescription>
- Run this where the proxy lives. It enrolls once and keeps its own certificate after
- that.
+ Run this wherever agents&apos; requests leave your network. The proxy enrolls once, then
+ keeps its own certificate.
</DialogDescription>
</DialogHeader>
@@ -83,7 +83,7 @@ export const ProxyEnrollmentDialog = ({ enrollment, onOpenChange }: Props) => {
<AlertDescription>
{isExpired
? "This token has expired. Generate a new one from the proxy's menu."
- : "This token is shown once and expires in an hour. Copy it now, it cannot be retrieved later."}
+ : "This token is shown once and expires in an hour. Copy it now, since it cannot be retrieved later."}
</AlertDescription>
</Alert>
diff --git a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyFormDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyFormDialog.tsx
index e5877b6b69..805a42a926 100644
--- a/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyFormDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultProxiesPage/components/ProxyFormDialog.tsx
@@ -149,7 +149,7 @@ export const ProxyFormDialog = ({ isOpen, onOpenChange, proxy, onCreated }: Prop
<DialogHeader>
<DialogTitle>{isUpdate ? "Edit Settings" : "Create Proxy"}</DialogTitle>
<DialogDescription>
- Set how this proxy handles your agents&apos; requests.
+ Configure how this proxy handles your agents&apos; requests.
</DialogDescription>
</DialogHeader>
@@ -226,8 +226,8 @@ export const ProxyFormDialog = ({ isOpen, onOpenChange, proxy, onCreated }: Prop
<InfoIcon />
</TooltipTrigger>
<TooltipContent className="max-w-sm">
- How often the proxy asks for its configuration, in seconds. It is how long a
- change here takes to reach a running agent.
+ How often the proxy refreshes its configuration, in seconds. This determines
+ how long a change in these settings takes to reach a running agent.
</TooltipContent>
</Tooltip>
</FieldLabel>
diff --git a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/AgentVaultSessionsPage.tsx b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/AgentVaultSessionsPage.tsx
index 42e6ab44e1..835fbac681 100644
--- a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/AgentVaultSessionsPage.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/AgentVaultSessionsPage.tsx
@@ -127,7 +127,7 @@ export const AgentVaultSessionsPage = () => {
} else if (!hasReachableBundles) {
emptyTitle = isAdmin ? "No sessions yet" : "No access bundles granted to you";
emptyDescription = isAdmin
- ? "Create an access bundle first, then mint a session over it. Agents also need a proxy to route through."
+ ? "Create an access bundle first, then create a session with it. Agents also need a proxy to route through."
: "Ask an admin to grant you an access bundle.";
} else {
emptyTitle = "No sessions yet";
@@ -143,7 +143,7 @@ export const AgentVaultSessionsPage = () => {
scope={ProjectType.AgentVault}
icon={IdCardIcon}
title="Sessions"
- description="What an agent runs with. Each session carries one access bundle."
+ description="Create sessions that let your agents reach the services in an access bundle."
/>
<Card>
@@ -153,7 +153,8 @@ export const AgentVaultSessionsPage = () => {
<DocumentationLinkBadge href={AgentVaultDocsUrls.sessions} />
</CardTitle>
<CardDescription>
- A session names one actor, the access bundle it carries, and when it expires.
+ A session names the actor who holds it, the access bundle it carries, and when it
+ expires.
</CardDescription>
<CardAction>
<Button
diff --git a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/CreateSessionDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/CreateSessionDialog.tsx
index dbb424b5b0..82674bc5f6 100644
--- a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/CreateSessionDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/CreateSessionDialog.tsx
@@ -133,8 +133,8 @@ export const CreateSessionDialog = ({ isOpen, onOpenChange, onCreated }: Props)
<DialogHeader>
<DialogTitle>Create Session</DialogTitle>
<DialogDescription>
- An agent running with this session reaches the hosts in this access bundle and nothing
- else.
+ An agent running with this session can only reach the hosts in the session&apos;s
+ associated access bundle.
</DialogDescription>
</DialogHeader>
@@ -214,9 +214,7 @@ export const CreateSessionDialog = ({ isOpen, onOpenChange, onCreated }: Props)
</>
)}
{ttlPreset === NEVER_TTL && (
- <FieldDescription>
- This session keeps working until someone revokes it.
- </FieldDescription>
+ <FieldDescription>This session runs until someone revokes it.</FieldDescription>
)}
</FieldContent>
</Field>
diff --git a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionCreatedDialog.tsx b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionCreatedDialog.tsx
index 56859747fc..b3226a64dd 100644
--- a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionCreatedDialog.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionCreatedDialog.tsx
@@ -34,8 +34,8 @@ export const SessionCreatedDialog = ({ session, onOpenChange }: Props) => (
<DialogHeader>
<DialogTitle>Session Created</DialogTitle>
<DialogDescription>
- Run this where your agent runs. Its traffic reaches the proxy with the credentials this
- session carries.
+ Run this where your agent runs. The agent&apos;s traffic goes through the proxy, which
+ attaches the credentials this session carries.
</DialogDescription>
</DialogHeader>
@@ -43,7 +43,8 @@ export const SessionCreatedDialog = ({ session, onOpenChange }: Props) => (
<Alert variant="warning">
<TriangleAlertIcon />
<AlertDescription>
- This command is shown once. Copy it now, the session token cannot be retrieved later.
+ This command is shown once. Copy it now, since the session token cannot be retrieved
+ later.
</AlertDescription>
</Alert>
diff --git a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionExpiry.tsx b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionExpiry.tsx
index b075e63133..eaecf47554 100644
--- a/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionExpiry.tsx
+++ b/frontend/src/pages/agent-vault/AgentVaultSessionsPage/components/SessionExpiry.tsx
@@ -13,7 +13,7 @@ export const SessionExpiry = ({ expiresAt }: Props) => {
<TooltipTrigger asChild>
<span className="text-sm">Never</span>
</TooltipTrigger>
- <TooltipContent>This session works until it is revoked.</TooltipContent>
+ <TooltipContent>This session runs until someone revokes it.</TooltipContent>
</Tooltip>
);
}