From 704bf3b90e0b26d5d1cd058b5a0ebd030b6dc9b5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 27 Sep 2026 00:22:44 +0000 Subject: [PATCH] docs: apply brand tone and writing style fixes --- docs/configuration.mdx | 2 +- docs/contributor-resources/support.mdx | 4 ++-- docs/guides/security-notes.mdx | 2 +- docs/index.mdx | 4 ++-- docs/middleware/pii-redactor.mdx | 4 ++-- docs/middleware/tool-approval-guard.mdx | 2 +- docs/quickstart.mdx | 2 +- 7 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/configuration.mdx b/docs/configuration.mdx index af9515b..f7d540b 100644 --- a/docs/configuration.mdx +++ b/docs/configuration.mdx @@ -156,7 +156,7 @@ Unlike the PII Redactor, `entities` defaults to only the high-risk set: `credit_ Note that `block_entities` stops the run whatever `action` is set to, so `action: 'log'` is only observe-only if you also set `block_entities` to `[]`. -This middleware acts on the response rather than the prompt, because the tool calls it guards are proposed by the model. It has no mutating action, since a proposed tool call belongs to the paused turn the provider recorded. +This middleware acts on the response rather than the prompt, because the model proposes the tool calls it guards. It has no mutating action, since a proposed tool call belongs to the paused turn the provider recorded. ## Tool approval resumes diff --git a/docs/contributor-resources/support.mdx b/docs/contributor-resources/support.mdx index 44553b5..6ca2549 100644 --- a/docs/contributor-resources/support.mdx +++ b/docs/contributor-resources/support.mdx @@ -6,7 +6,7 @@ sidebarTitle: "Support utilities" `promptphp/intercept-support` provides shared support utilities and configuration for the Intercept middleware ecosystem. -Most users do not need to install or use this package directly. It is installed automatically when required by an Intercept middleware package. +Most users do not need to install or use this package directly. Composer installs it automatically when an Intercept middleware package requires it. The support package provides shared infrastructure used across Intercept packages, including: @@ -45,7 +45,7 @@ $config = InterceptConfig::middleware('injection_guard', [ ]); ``` -The helper merges the published config section with the middleware's internal defaults. If the section is missing, the defaults are returned. +The helper merges the published config section with the middleware's internal defaults. If the section is missing, the helper returns the defaults. ## Missing config sections diff --git a/docs/guides/security-notes.mdx b/docs/guides/security-notes.mdx index c1b4d8d..fd7f6c1 100644 --- a/docs/guides/security-notes.mdx +++ b/docs/guides/security-notes.mdx @@ -96,7 +96,7 @@ It does not scan: - attachments sent alongside the prompt - the model's response text -It can not change what the SDK stores. The conversation store keeps the original prompt, and the SDK builds the conversation title from it. +It cannot change what the SDK stores. The conversation store keeps the original prompt, and the SDK builds the conversation title from it. This matters most for indirect prompt injection. If a tool fetches a web page, reads a document, or queries a record that contains injected instructions, that content is handed to the model without passing through Intercept. diff --git a/docs/index.mdx b/docs/index.mdx index 73627e0..cf44698 100644 --- a/docs/index.mdx +++ b/docs/index.mdx @@ -79,9 +79,9 @@ It is especially useful for: Intercept is not a complete AI security platform. -It is a practical middleware layer that helps you add a final line of defense before prompts reach an AI provider. +It is a practical middleware layer that helps you add a final line of defence before prompts reach an AI provider. -It should be used alongside other controls, including: +Use it alongside other controls, including: - tool permission checks - client-side and server-side validation diff --git a/docs/middleware/pii-redactor.mdx b/docs/middleware/pii-redactor.mdx index 461c4d3..74f7f9b 100644 --- a/docs/middleware/pii-redactor.mdx +++ b/docs/middleware/pii-redactor.mdx @@ -76,7 +76,7 @@ By default, the middleware will: The recommended default action is `redact`. -Some entities can still be blocked even when the action is `redact`. By default, credit cards, API keys, and bearer tokens are blocked. +Some entities can still be blocked even when the action is `redact`. By default, the middleware blocks credit cards, API keys, and bearer tokens. ## Supported entities @@ -474,7 +474,7 @@ The Laravel AI SDK runs agent middleware once for each generation step. A run th A change to the step history applies to that step only. The middleware therefore redacts or masks every user message in the history on every step. This includes earlier turns that the SDK replays from a conversation store. It logs and blocks once, on the step that starts the turn. - The SDK stores the original prompt in the conversation store, and it builds the conversation title from that prompt. Middleware can not change either. Redaction keeps PII away from the AI provider, not away from your conversation tables. + The SDK stores the original prompt in the conversation store, and it builds the conversation title from that prompt. Middleware cannot change either. Redaction keeps PII away from the AI provider, not away from your conversation tables. ## Tool approval resumes diff --git a/docs/middleware/tool-approval-guard.mdx b/docs/middleware/tool-approval-guard.mdx index a9b7662..62b4261 100644 --- a/docs/middleware/tool-approval-guard.mdx +++ b/docs/middleware/tool-approval-guard.mdx @@ -63,7 +63,7 @@ class SupportAgent implements Agent, HasMiddleware ## How it differs from the other middleware -This is the first Intercept middleware that acts on the **response** rather than the prompt, because the tool calls it guards are proposed by the model. +This is the first Intercept middleware that acts on the **response** rather than the prompt, because the model proposes the tool calls it guards. ```mermaid placement="top-right" flowchart LR diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx index a09c714..931d415 100644 --- a/docs/quickstart.mdx +++ b/docs/quickstart.mdx @@ -121,7 +121,7 @@ The prompt sent to the provider becomes something like: Please summarize this ticket for [EMAIL_1]. ``` -High-risk entities such as credit cards, API keys, and bearer tokens are blocked by default. +PII Redactor blocks high-risk entities such as credit cards, API keys, and bearer tokens by default. ## Recommended local setup