From dcc1bea399fa12d3ee94de5ebd449d285576fc60 Mon Sep 17 00:00:00 2001 From: Nicolas <20311743+nickscamara@users.noreply.github.com> Date: Tue, 6 Oct 2026 14:40:43 -0700 Subject: [PATCH] feat(alexandria): 20-minute feedback window; bump CLI to 1.26.2 Co-authored-by: Cursor --- README.md | 2 +- package.json | 2 +- skills/firecrawl-agent/SKILL.md | 2 +- skills/firecrawl-alexandria/SKILL.md | 4 ++-- src/commands/alexandria-feedback.ts | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 4f2a8f43ce..e63896767a 100644 --- a/README.md +++ b/README.md @@ -1086,4 +1086,4 @@ firecrawl alexandria feedback --rating partial \ --rationale "Found summaries but could not retrieve attachments" --json ``` -The optional `--objective` is the underlying goal of the session: what you or your user were ultimately trying to accomplish, beyond the single website. No job ID is required. Like search feedback, it must be sent within about 2 minutes (the search feedback window) of the team's most recent Alexandria search, discovery, or execution; later submissions are rejected with `FEEDBACK_WINDOW_EXPIRED`. Each submission refunds 1 credit, up to 10 credits per website and 100 credits per team each UTC day; past either cap, submissions are still recorded and return `websiteCapReached` or `dailyCapReached`. Optional `--provider-feedback` and `--capability-feedback` accept JSON arrays; see `firecrawl alexandria feedback --help` for their fields and issue codes. Capability issue codes are `new_capability_request` (requires `requestedFunctionality`), `missing_capability` (the provider exists but lacks this capability), `insufficient_functionality`, `incorrect_result`, `execution_error`, and `other`. Existing `feedback` and `search-feedback` commands retain their job-specific behavior. Endpoint feedback opt-out environment variables also apply to this command. +The optional `--objective` is the underlying goal of the session: what you or your user were ultimately trying to accomplish, beyond the single website. No job ID is required. It must be sent within 20 minutes of the team's most recent Alexandria search, discovery, or execution; later submissions are rejected with `FEEDBACK_WINDOW_EXPIRED`. Each submission refunds 1 credit, up to 10 credits per website and 100 credits per team each UTC day; past either cap, submissions are still recorded and return `websiteCapReached` or `dailyCapReached`. Optional `--provider-feedback` and `--capability-feedback` accept JSON arrays; see `firecrawl alexandria feedback --help` for their fields and issue codes. Capability issue codes are `new_capability_request` (requires `requestedFunctionality`), `missing_capability` (the provider exists but lacks this capability), `insufficient_functionality`, `incorrect_result`, `execution_error`, and `other`. Existing `feedback` and `search-feedback` commands retain their job-specific behavior. Endpoint feedback opt-out environment variables also apply to this command. diff --git a/package.json b/package.json index 26cecd52a3..826e8e6b3f 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "firecrawl-cli", - "version": "1.26.1", + "version": "1.26.2", "publishConfig": { "tag": "latest" }, diff --git a/skills/firecrawl-agent/SKILL.md b/skills/firecrawl-agent/SKILL.md index 14e99628f6..ba195f3bb2 100644 --- a/skills/firecrawl-agent/SKILL.md +++ b/skills/firecrawl-agent/SKILL.md @@ -60,4 +60,4 @@ firecrawl agent "" --cancel ## Alexandria session feedback -To report an Alexandria session outcome or a provider/capability gap, use `firecrawl alexandria feedback --rating good|partial|bad --url --requested-functionality '' --objective '' --rationale '' --json`. Use observed results in the rationale. No job ID is needed; send it within about 2 minutes of your last Alexandria search, discovery, or execution, or it is rejected. Each submission refunds 1 credit, up to 10 per website and 100 per team each UTC day. Optional `--provider-feedback` and `--capability-feedback` JSON arrays describe specific gaps; inspect `firecrawl alexandria feedback --help` for their fields. Use the capability issue `missing_capability` when a provider exists but lacks the needed capability, and `new_capability_request` (with `requestedFunctionality`) to ask for one. +To report an Alexandria session outcome or a provider/capability gap, use `firecrawl alexandria feedback --rating good|partial|bad --url --requested-functionality '' --objective '' --rationale '' --json`. Use observed results in the rationale. No job ID is needed; send it within 20 minutes of your last Alexandria search, discovery, or execution, or it is rejected. Each submission refunds 1 credit, up to 10 per website and 100 per team each UTC day. Optional `--provider-feedback` and `--capability-feedback` JSON arrays describe specific gaps; inspect `firecrawl alexandria feedback --help` for their fields. Use the capability issue `missing_capability` when a provider exists but lacks the needed capability, and `new_capability_request` (with `requestedFunctionality`) to ask for one. diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 4aed3bf768..9e144fe5eb 100644 --- a/skills/firecrawl-alexandria/SKILL.md +++ b/skills/firecrawl-alexandria/SKILL.md @@ -26,7 +26,7 @@ Feedback can describe any of these outcomes: **Rules to know before you call this:** -- **Time window:** must be sent within ~2 minutes of your team's most recent Alexandria search, discovery, or execution. Each Alexandria call restarts the window. Late feedback is rejected (`feedbackErrorCode: "FEEDBACK_WINDOW_EXPIRED"`). +- **Time window:** must be sent within 20 minutes of your team's most recent Alexandria search, discovery, or execution. Each Alexandria call restarts the window. Late feedback is rejected (`feedbackErrorCode: "FEEDBACK_WINDOW_EXPIRED"`). - **`--url` is the website the user needed data from**, not the provider and not a Firecrawl page. `--requested-functionality` is what they needed from it, in one sentence. These two fields are the most important: they aggregate across teams and tell us which sites and workflows to add next. - **`--objective` is the underlying goal** behind the session: what you or your user were ultimately trying to accomplish, in one sentence (for example, "Shortlist federal IT contracts to bid on this quarter"). It is broader than `--requested-functionality`, which covers only this website. - **`--rationale` explains the rating** from observed results: which provider or capability served or failed the need, and how. Two or three sentences, no raw results pasted in. @@ -38,7 +38,7 @@ Feedback can describe any of these outcomes: - **`--silent &`** is the right pattern: exit code 0 even on failure, so a rejected call never crashes your pipeline. ```bash -# Example: send once per website, within ~2 minutes of your last Alexandria call. Replace the +# Example: send once per website, within 20 minutes of your last Alexandria call. Replace the # placeholders with what actually happened; drop --provider-feedback or # --capability-feedback when there is nothing to report at that level. firecrawl alexandria feedback \ diff --git a/src/commands/alexandria-feedback.ts b/src/commands/alexandria-feedback.ts index 2b7017cd32..ab67defc3c 100644 --- a/src/commands/alexandria-feedback.ts +++ b/src/commands/alexandria-feedback.ts @@ -95,7 +95,7 @@ export function parseAlexandriaFeedbackArray( export function createAlexandriaFeedbackCommand(): Command { return new Command('feedback') .description( - 'Report Alexandria session results, provider gaps, or capability issues. No job ID needed; send within about 2 minutes of your last Alexandria search, discovery, or execution. Refunds 1 credit per submission, up to 10 per website and 100 per team each UTC day.' + 'Report Alexandria session results, provider gaps, or capability issues. No job ID needed; send within 20 minutes of your last Alexandria search, discovery, or execution. Refunds 1 credit per submission, up to 10 per website and 100 per team each UTC day.' ) .requiredOption( '--rating ',