Skip to content

feat(corsair): a Files skill, and search guidance for one-call answers - #11

Merged
PranayHaldiya merged 3 commits into
mainfrom
feat/files-skill-search
Nov 17, 2026
Merged

PranayHaldiya merged 3 commits into
mainfrom
feat/files-skill-search

Conversation

@PranayHaldiya

@PranayHaldiya PranayHaldiya commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

The Corsair MCP server has had a 15th tool, upload_file, since corsairdev/hub#600 (11-16), and Corsair's Files on every link. No skill mentioned either. search also changed under the skills: corsairdev/hub#672 to #681 made it answer the whole question in one call, and corsair-data still taught the old way (put people in about, dates in after/before, run the named live calls yourself).

What changed

New corsair-files skill. How a file gets into Files with upload_file (file for a ChatGPT attachment, url, path plus the returned curl command for a shell or claude.ai's sandbox, or the upload card), why scripts take a fil_ id and never bytes or base64, handing the id to an app where it takes a file URL, and the files.* actions: list, get, url, read_text (40,000 characters a page), write_text, edit_text, save_from_url (with file_id for a new version), update (rename, move, share, search text) and delete. The example parses an attachment with Reducto and keeps the result, covering both of Reducto's reply shapes (full chunks or a url for long documents).

corsair-data's search section now matches the tool on hub main: the whole question in the user's words plus timeZone, no filters, no negations in query, live reads folded into the hits, coverage, and "nothing matched" with near_misses that aren't the answer.

pg and Mate chats. corsair-workspace now covers Corsair's other two apps an agent can reach: pg (the user's own Postgres databases, queried by name; query.sql runs in a rolled-back transaction, query.exec commits, dbs.create returns a setup_url so the connection URL never passes through the agent) and Mate chats (assistant.db.chats.search, assistant.api.chats.get). dbs.list, chat search and chats.get checked live on a link.

Small edits. corsair-workspace and corsair-data point to the Files skill. READMEs list seven skills. The plugin description now reads: "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, query your Postgres databases, hand files to your connected apps, search across all of it, and set up routines." corsair 0.1.7 in every manifest, the marketplaces, server.json and gemini-extension.json.

Evidence

  • Every statement checked against hub main (3df5535e9): apps/cloud-runtime/src/tools/upload-file.mjs, tools/search.mjs, src/file-links.mjs, packages/oss/src/plugins/files/index.ts (the ops and limits), packages/api/src/cloud/door-reply.ts (near misses).
  • Ran the skill's Files steps on a real link through the Corsair connector: upload_file with a public PDF, then one script with save_from_url (the same file again returned the same id), read_text (the PDF's text, next_offset: null), url (an https link, 15 minutes), list, write_text (private, mine: true) and edit_text (replaced: 1). Both test files deleted afterwards.
  • That run showed search misses a just-added file when asked in plain words, but finds it, text included, with its name and apps: ["files"]. The skill says to search that way.
  • node scripts/check.mjs: ok: 2 plugins, 8 skills. Agent Plugins schemas valid. claude plugin validate passes for ., both plugins, and --profile directory --strict.
  • The synced SDK skill matches corsairdev/corsair's skills/corsair (1a04bbd7).

Docs get the same update in corsairdev/corsair (separate PR). After merge, Claude's directory picks up 0.1.7 on its 6-hour check; then press Publish on it so the pending review covers the current version.

- corsair-files: getting a file in with upload_file (an attachment, a URL,
  a path with a shell, or the upload card), passing its fil_ id to an app in
  a script, and the files.* actions for reading, editing, saving and sharing.
- corsair-data: search takes the whole question in the user's words and sets
  no filters itself, reads an app live when its copy is behind, says when
  nothing matched (near_misses are not answers), and reports coverage.
- corsair 0.1.7; READMEs list seven skills.
…mes connected apps

- corsair-workspace now covers pg (dbs.list, query.sql in a rolled-back
  transaction, query.exec, dbs.create's setup_url, dbs.remove) and Mate chats
  (assistant.db.chats.search, chats.get), checked live on a link.
- The plugin description says "query your Postgres databases" and "hand files to
  your connected apps" again, so search covers the apps by name.
…bsites

So the user can let the sandbox send attachments straight to Files instead of
picking each one in the upload card. Host checked on a live upload link.
@PranayHaldiya
PranayHaldiya merged commit ca07afe into main Nov 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant