sealnet-mcp 0.11.0 → 0.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,7 +18,7 @@ When an MCP-connected AI agent (Claude Desktop, Cursor, Cline, etc.) creates a S
18
18
  |------|---------|
19
19
  | `seal_share(path, kind='file'\|'secret', key?, mode='inbox'\|'handoff'\|'forward', expire?, max_reads?, tier?)` / `seal_share(payment)` | Create a SEAL from a local file or folder (sent as one ZIP), streamed from disk. `kind='secret'` marks a password, key or token: the recipient's agent saves it and never reads it into a chat, a browser shows it hidden. `key` sends one value of a .env-style file as a secret, without writing it anywhere. Default: inbox once connected, else handoff; without `expire`, 1d in the inbox, 1h for a handoff, 5m forward, or 1d for one over 100 MB. Above the free limit the user pays once by card (smallest tier that fits, or `tier`): the payment page goes through URL-mode elicitation, or comes back as `payment_url` and a second call with `payment` finishes the upload into the same seal |
20
20
  | `seal_link(handle)` | Put the link of a handoff seal on the clipboard (or in its 0600 file) again, for a link lost on the way; the model never gets it |
21
- | `seal_request(what, kind='any'\|'secret'\|'file', where_url?, wait=true, from?, dir?)` / `seal_request(request)` | Ask the user for a file or a secret without it passing through the chat. On the user's computer the `seal` CLI draws the system dialog (`seal request --local --json`); otherwise the user answers at `seal.net/i/<id>`, sealed to this server's bundle, shown with three words of its address; once connected the request also waits in the user's inbox (`from=owner`, or `from=anyone` for a plain link). Returns the path of a 0600 file (in `dir`, or a private temp directory), never the value |
21
+ | `seal_request(what, kind='any'\|'secret'\|'file', where_url?, wait=true, from?, dir?)` / `seal_request(request)` | Ask the user for a file or a secret without it passing through the chat. The user answers at `seal.net/i/<id>`, sealed to this machine's guard or to this server, shown with three words of its address: on the user's computer the `seal` CLI opens the page in their browser (`seal request --local --json`); once connected the request also waits in the user's inbox (`from=owner`, or `from=anyone` for a plain link). Returns the path of a 0600 file (in `dir`, or a private temp directory), never the value |
22
22
  | `seal_pair(name?, wait=true)` | Connect this agent to the user's SEAL inbox, once: the user opens a page, compares three words and connects; the chat then shows the inbox's three words. After it `seal_share` sends to the inbox by default |
23
23
  | `seal_open(url\|item, mode='metadata'\|'file'\|'inline', dir?)` | Read metadata (default — no download, no counter consumption), save to disk (`file`: streamed, verified before it gets its name, 0600, returns paths) or inline parse (whitelisted MIMEs only, ≤100 KB, refuses secrets, HTML and binary). `item` is an inbox handle instead of a link |
24
24
  | `seal_inbox(wait?)` | Seals other agents or people sent to this server's address: handles, the sender's three words and name, never a link. `seal_share mode=forward to=<address>` puts a link there; `wait` (0 to 300 s) waits for something new |
package/dist/cli.cjs CHANGED
@@ -11734,26 +11734,26 @@ var seal_mcp_v1_default = {
11734
11734
  },
11735
11735
  seal_request: {
11736
11736
  title: "Ask the user for a file or a secret",
11737
- description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. On their computer a system dialog appears; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
11737
+ description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. They answer on a seal.net page: on their computer it opens in their browser by itself, elsewhere they get its link or a card in their inbox; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
11738
11738
  annotations: { destructiveHint: false, openWorldHint: true },
11739
11739
  input: {
11740
11740
  properties: {
11741
11741
  what: { type: "string", maxLength: 120, description: "What you ask for, as the user reads it: 'Brave API key', 'the call recordings folder'. Required unless `request` is given." },
11742
- kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file (on macOS also a folder); `any`: a secret, or a file when the field is left empty." },
11742
+ kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file; `any`: a secret, or a file when the field is left empty." },
11743
11743
  where_url: { type: "string", maxLength: 300, description: "https page where this key is created. The user sees its domain; known services are named, any other domain is marked as given by you." },
11744
11744
  wait: { type: "boolean", default: true, description: "Wait for the answer and return the saved path. Where the answer goes through a link and your client cannot show links itself, the link comes back first: show it and the three words to the user, then call again with `request`." },
11745
11745
  request: { type: "string", pattern: "^h_[A-Za-z0-9_-]{12,}$", description: "Handle of a request answered through a link: wait for it." },
11746
- from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the dialog on this machine, else a card for the owner when connected, else the link." },
11747
- dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The dialog on this machine saves where the `seal` CLI does." },
11748
- bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page or the dialog shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
11746
+ from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the page opens in this computer's browser when there is one, else a card for the owner when connected, else the link." },
11747
+ dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The page opened on this computer saves where the `seal` CLI does." },
11748
+ bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
11749
11749
  }
11750
11750
  },
11751
11751
  flow: {
11752
- guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the dialog is the guard's (the CLI asks the service over its socket), the link is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
11753
- order: "Without `from`: the local dialog, then a card in the connected owner's inbox, then the link. The wait is the same for all three (`waitForIntake`).",
11752
+ guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the request is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
11753
+ order: "Without `from`: the page in this computer's browser, then a card in the connected owner's inbox, then the link. One page for all three (`/i/<id>`); the wait is the same (`waitForIntake`). There is no system dialog and no page on 127.0.0.1: a second window would be the same flow drawn twice, outside the site's design and without the binding (SPEC agent egress \u042015, 27.10).",
11754
11754
  card: "`POST /intake` with `to` = the owner's address: the request sits in the owner's inbox; the person answers from there on /i/<id>. The call returns `output_link` as for a link, its url being the same page.",
11755
- local: "On the user's computer the `seal` CLI draws the system dialog (`seal request --local --json`); nothing leaves the machine. A secret lands in a 0600 file, a picked file stays where it is. The dialog's `Ask someone else` button (where the system window has room for it) answers `request.ask_other`, and the request goes on through the link.",
11756
- link: "Otherwise (no screen, no `seal` CLI): `POST /intake` with this server's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
11755
+ here: "On the user's computer the `seal` CLI makes the request and opens the page in their browser (`seal request --local --json`), waiting for the answer itself: `files` back, or `request.no_local` where no browser would show the page (SSH, a container), or `request.expired` when nobody answered in time.",
11756
+ link: "Otherwise (no browser here, no `seal` CLI): `POST /intake` with the recipient's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
11757
11757
  words: "Three words of this server's address (`fingerprint_words.json`), shown in the chat and on the page; the user closes the page if they differ."
11758
11758
  },
11759
11759
  output_received: {
@@ -11761,7 +11761,7 @@ var seal_mcp_v1_default = {
11761
11761
  required: ["handle", "source", "files"],
11762
11762
  properties: {
11763
11763
  handle: { type: "string" },
11764
- source: { type: "string", enum: ["local", "link"] },
11764
+ source: { type: "string", enum: ["link"] },
11765
11765
  files: {
11766
11766
  type: "array",
11767
11767
  items: {
@@ -13682,16 +13682,16 @@ async function sealRequest(ctx, input, deps) {
13682
13682
  const cliArgs = ["request", "--local", "--json", "--kind", kind, "--what", what, "--label", deps.label];
13683
13683
  if (input.whereUrl) cliArgs.push("--where", input.whereUrl);
13684
13684
  if (input.bind) cliArgs.push("--bind", bindSpec(input.bind));
13685
- const local = await runCli(cliArgs);
13686
- if (local && "files" in local) {
13687
- await appendAudit(ctx, "seal_request", handle, "local");
13688
- return { handle, source: "local", files: local.files.map(cliFile), ...local.note ? { note: local.note } : {} };
13685
+ const here = await runCli(cliArgs);
13686
+ if (here && "files" in here) {
13687
+ await appendAudit(ctx, "seal_request", handle, "link");
13688
+ return { handle, source: "link", files: here.files.map(cliFile), ...here.note ? { note: here.note } : {} };
13689
13689
  }
13690
- if (local && local.error.code === "request.cancelled") {
13691
- throw new ToolError("request_cancelled", "the user closed the dialog");
13690
+ if (here && here.error.code === "request.expired") {
13691
+ throw new ToolError("request_expired", here.error.message);
13692
13692
  }
13693
- if (local && local.error.code !== "request.no_local" && local.error.code !== "request.ask_other") {
13694
- throw new ToolError("request_failed", `seal request: ${local.error.message}`);
13693
+ if (here && here.error.code !== "request.no_local") {
13694
+ throw new ToolError("request_failed", `seal request: ${here.error.message}`);
13695
13695
  }
13696
13696
  }
13697
13697
  const guard = kind === "file" ? null : await guardStatus(runCli);
@@ -14427,7 +14427,7 @@ function proFileGetOutputToWire(out) {
14427
14427
  }
14428
14428
 
14429
14429
  // src/server.ts
14430
- var SERVER_VERSION = "0.11.0";
14430
+ var SERVER_VERSION = "0.11.1";
14431
14431
  var toolMeta = (name2) => {
14432
14432
  const { title, description, annotations } = seal_mcp_v1_default.tools[name2];
14433
14433
  return { title, description, annotations };
package/dist/cli.js CHANGED
@@ -11700,26 +11700,26 @@ var seal_mcp_v1_default = {
11700
11700
  },
11701
11701
  seal_request: {
11702
11702
  title: "Ask the user for a file or a secret",
11703
- description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. On their computer a system dialog appears; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
11703
+ description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. They answer on a seal.net page: on their computer it opens in their browser by itself, elsewhere they get its link or a card in their inbox; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
11704
11704
  annotations: { destructiveHint: false, openWorldHint: true },
11705
11705
  input: {
11706
11706
  properties: {
11707
11707
  what: { type: "string", maxLength: 120, description: "What you ask for, as the user reads it: 'Brave API key', 'the call recordings folder'. Required unless `request` is given." },
11708
- kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file (on macOS also a folder); `any`: a secret, or a file when the field is left empty." },
11708
+ kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file; `any`: a secret, or a file when the field is left empty." },
11709
11709
  where_url: { type: "string", maxLength: 300, description: "https page where this key is created. The user sees its domain; known services are named, any other domain is marked as given by you." },
11710
11710
  wait: { type: "boolean", default: true, description: "Wait for the answer and return the saved path. Where the answer goes through a link and your client cannot show links itself, the link comes back first: show it and the three words to the user, then call again with `request`." },
11711
11711
  request: { type: "string", pattern: "^h_[A-Za-z0-9_-]{12,}$", description: "Handle of a request answered through a link: wait for it." },
11712
- from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the dialog on this machine, else a card for the owner when connected, else the link." },
11713
- dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The dialog on this machine saves where the `seal` CLI does." },
11714
- bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page or the dialog shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
11712
+ from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the page opens in this computer's browser when there is one, else a card for the owner when connected, else the link." },
11713
+ dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The page opened on this computer saves where the `seal` CLI does." },
11714
+ bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
11715
11715
  }
11716
11716
  },
11717
11717
  flow: {
11718
- guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the dialog is the guard's (the CLI asks the service over its socket), the link is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
11719
- order: "Without `from`: the local dialog, then a card in the connected owner's inbox, then the link. The wait is the same for all three (`waitForIntake`).",
11718
+ guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the request is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
11719
+ order: "Without `from`: the page in this computer's browser, then a card in the connected owner's inbox, then the link. One page for all three (`/i/<id>`); the wait is the same (`waitForIntake`). There is no system dialog and no page on 127.0.0.1: a second window would be the same flow drawn twice, outside the site's design and without the binding (SPEC agent egress \u042015, 27.10).",
11720
11720
  card: "`POST /intake` with `to` = the owner's address: the request sits in the owner's inbox; the person answers from there on /i/<id>. The call returns `output_link` as for a link, its url being the same page.",
11721
- local: "On the user's computer the `seal` CLI draws the system dialog (`seal request --local --json`); nothing leaves the machine. A secret lands in a 0600 file, a picked file stays where it is. The dialog's `Ask someone else` button (where the system window has room for it) answers `request.ask_other`, and the request goes on through the link.",
11722
- link: "Otherwise (no screen, no `seal` CLI): `POST /intake` with this server's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
11721
+ here: "On the user's computer the `seal` CLI makes the request and opens the page in their browser (`seal request --local --json`), waiting for the answer itself: `files` back, or `request.no_local` where no browser would show the page (SSH, a container), or `request.expired` when nobody answered in time.",
11722
+ link: "Otherwise (no browser here, no `seal` CLI): `POST /intake` with the recipient's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
11723
11723
  words: "Three words of this server's address (`fingerprint_words.json`), shown in the chat and on the page; the user closes the page if they differ."
11724
11724
  },
11725
11725
  output_received: {
@@ -11727,7 +11727,7 @@ var seal_mcp_v1_default = {
11727
11727
  required: ["handle", "source", "files"],
11728
11728
  properties: {
11729
11729
  handle: { type: "string" },
11730
- source: { type: "string", enum: ["local", "link"] },
11730
+ source: { type: "string", enum: ["link"] },
11731
11731
  files: {
11732
11732
  type: "array",
11733
11733
  items: {
@@ -13648,16 +13648,16 @@ async function sealRequest(ctx, input, deps) {
13648
13648
  const cliArgs = ["request", "--local", "--json", "--kind", kind, "--what", what, "--label", deps.label];
13649
13649
  if (input.whereUrl) cliArgs.push("--where", input.whereUrl);
13650
13650
  if (input.bind) cliArgs.push("--bind", bindSpec(input.bind));
13651
- const local = await runCli(cliArgs);
13652
- if (local && "files" in local) {
13653
- await appendAudit(ctx, "seal_request", handle, "local");
13654
- return { handle, source: "local", files: local.files.map(cliFile), ...local.note ? { note: local.note } : {} };
13651
+ const here = await runCli(cliArgs);
13652
+ if (here && "files" in here) {
13653
+ await appendAudit(ctx, "seal_request", handle, "link");
13654
+ return { handle, source: "link", files: here.files.map(cliFile), ...here.note ? { note: here.note } : {} };
13655
13655
  }
13656
- if (local && local.error.code === "request.cancelled") {
13657
- throw new ToolError("request_cancelled", "the user closed the dialog");
13656
+ if (here && here.error.code === "request.expired") {
13657
+ throw new ToolError("request_expired", here.error.message);
13658
13658
  }
13659
- if (local && local.error.code !== "request.no_local" && local.error.code !== "request.ask_other") {
13660
- throw new ToolError("request_failed", `seal request: ${local.error.message}`);
13659
+ if (here && here.error.code !== "request.no_local") {
13660
+ throw new ToolError("request_failed", `seal request: ${here.error.message}`);
13661
13661
  }
13662
13662
  }
13663
13663
  const guard = kind === "file" ? null : await guardStatus(runCli);
@@ -14393,7 +14393,7 @@ function proFileGetOutputToWire(out) {
14393
14393
  }
14394
14394
 
14395
14395
  // src/server.ts
14396
- var SERVER_VERSION = "0.11.0";
14396
+ var SERVER_VERSION = "0.11.1";
14397
14397
  var toolMeta = (name2) => {
14398
14398
  const { title, description, annotations } = seal_mcp_v1_default.tools[name2];
14399
14399
  return { title, description, annotations };
package/dist/index.cjs CHANGED
@@ -4251,26 +4251,26 @@ var seal_mcp_v1_default = {
4251
4251
  },
4252
4252
  seal_request: {
4253
4253
  title: "Ask the user for a file or a secret",
4254
- description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. On their computer a system dialog appears; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
4254
+ description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. They answer on a seal.net page: on their computer it opens in their browser by itself, elsewhere they get its link or a card in their inbox; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
4255
4255
  annotations: { destructiveHint: false, openWorldHint: true },
4256
4256
  input: {
4257
4257
  properties: {
4258
4258
  what: { type: "string", maxLength: 120, description: "What you ask for, as the user reads it: 'Brave API key', 'the call recordings folder'. Required unless `request` is given." },
4259
- kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file (on macOS also a folder); `any`: a secret, or a file when the field is left empty." },
4259
+ kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file; `any`: a secret, or a file when the field is left empty." },
4260
4260
  where_url: { type: "string", maxLength: 300, description: "https page where this key is created. The user sees its domain; known services are named, any other domain is marked as given by you." },
4261
4261
  wait: { type: "boolean", default: true, description: "Wait for the answer and return the saved path. Where the answer goes through a link and your client cannot show links itself, the link comes back first: show it and the three words to the user, then call again with `request`." },
4262
4262
  request: { type: "string", pattern: "^h_[A-Za-z0-9_-]{12,}$", description: "Handle of a request answered through a link: wait for it." },
4263
- from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the dialog on this machine, else a card for the owner when connected, else the link." },
4264
- dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The dialog on this machine saves where the `seal` CLI does." },
4265
- bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page or the dialog shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
4263
+ from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the page opens in this computer's browser when there is one, else a card for the owner when connected, else the link." },
4264
+ dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The page opened on this computer saves where the `seal` CLI does." },
4265
+ bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
4266
4266
  }
4267
4267
  },
4268
4268
  flow: {
4269
- guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the dialog is the guard's (the CLI asks the service over its socket), the link is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
4270
- order: "Without `from`: the local dialog, then a card in the connected owner's inbox, then the link. The wait is the same for all three (`waitForIntake`).",
4269
+ guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the request is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
4270
+ order: "Without `from`: the page in this computer's browser, then a card in the connected owner's inbox, then the link. One page for all three (`/i/<id>`); the wait is the same (`waitForIntake`). There is no system dialog and no page on 127.0.0.1: a second window would be the same flow drawn twice, outside the site's design and without the binding (SPEC agent egress \u042015, 27.10).",
4271
4271
  card: "`POST /intake` with `to` = the owner's address: the request sits in the owner's inbox; the person answers from there on /i/<id>. The call returns `output_link` as for a link, its url being the same page.",
4272
- local: "On the user's computer the `seal` CLI draws the system dialog (`seal request --local --json`); nothing leaves the machine. A secret lands in a 0600 file, a picked file stays where it is. The dialog's `Ask someone else` button (where the system window has room for it) answers `request.ask_other`, and the request goes on through the link.",
4273
- link: "Otherwise (no screen, no `seal` CLI): `POST /intake` with this server's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
4272
+ here: "On the user's computer the `seal` CLI makes the request and opens the page in their browser (`seal request --local --json`), waiting for the answer itself: `files` back, or `request.no_local` where no browser would show the page (SSH, a container), or `request.expired` when nobody answered in time.",
4273
+ link: "Otherwise (no browser here, no `seal` CLI): `POST /intake` with the recipient's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
4274
4274
  words: "Three words of this server's address (`fingerprint_words.json`), shown in the chat and on the page; the user closes the page if they differ."
4275
4275
  },
4276
4276
  output_received: {
@@ -4278,7 +4278,7 @@ var seal_mcp_v1_default = {
4278
4278
  required: ["handle", "source", "files"],
4279
4279
  properties: {
4280
4280
  handle: { type: "string" },
4281
- source: { type: "string", enum: ["local", "link"] },
4281
+ source: { type: "string", enum: ["link"] },
4282
4282
  files: {
4283
4283
  type: "array",
4284
4284
  items: {
@@ -13514,16 +13514,16 @@ async function sealRequest(ctx, input, deps) {
13514
13514
  const cliArgs = ["request", "--local", "--json", "--kind", kind, "--what", what, "--label", deps.label];
13515
13515
  if (input.whereUrl) cliArgs.push("--where", input.whereUrl);
13516
13516
  if (input.bind) cliArgs.push("--bind", bindSpec(input.bind));
13517
- const local = await runCli(cliArgs);
13518
- if (local && "files" in local) {
13519
- await appendAudit(ctx, "seal_request", handle, "local");
13520
- return { handle, source: "local", files: local.files.map(cliFile), ...local.note ? { note: local.note } : {} };
13517
+ const here = await runCli(cliArgs);
13518
+ if (here && "files" in here) {
13519
+ await appendAudit(ctx, "seal_request", handle, "link");
13520
+ return { handle, source: "link", files: here.files.map(cliFile), ...here.note ? { note: here.note } : {} };
13521
13521
  }
13522
- if (local && local.error.code === "request.cancelled") {
13523
- throw new ToolError("request_cancelled", "the user closed the dialog");
13522
+ if (here && here.error.code === "request.expired") {
13523
+ throw new ToolError("request_expired", here.error.message);
13524
13524
  }
13525
- if (local && local.error.code !== "request.no_local" && local.error.code !== "request.ask_other") {
13526
- throw new ToolError("request_failed", `seal request: ${local.error.message}`);
13525
+ if (here && here.error.code !== "request.no_local") {
13526
+ throw new ToolError("request_failed", `seal request: ${here.error.message}`);
13527
13527
  }
13528
13528
  }
13529
13529
  const guard = kind === "file" ? null : await guardStatus(runCli);
@@ -14259,7 +14259,7 @@ function proFileGetOutputToWire(out) {
14259
14259
  }
14260
14260
 
14261
14261
  // src/server.ts
14262
- var SERVER_VERSION = "0.11.0";
14262
+ var SERVER_VERSION = "0.11.1";
14263
14263
  var toolMeta = (name2) => {
14264
14264
  const { title, description, annotations } = seal_mcp_v1_default.tools[name2];
14265
14265
  return { title, description, annotations };
package/dist/index.js CHANGED
@@ -4167,26 +4167,26 @@ var seal_mcp_v1_default = {
4167
4167
  },
4168
4168
  seal_request: {
4169
4169
  title: "Ask the user for a file or a secret",
4170
- description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. On their computer a system dialog appears; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
4170
+ description: 'Ask the user for a file or a secret (API key, token, password) WITHOUT them pasting it into the chat. They answer on a seal.net page: on their computer it opens in their browser by itself, elsewhere they get its link or a card in their inbox; you can pass `where_url` (the page where that key is created) so they find it in one click. With `wait:true` you get the path of the saved 0600 file, never the value. Use this instead of "paste your key here" or "upload the file here".',
4171
4171
  annotations: { destructiveHint: false, openWorldHint: true },
4172
4172
  input: {
4173
4173
  properties: {
4174
4174
  what: { type: "string", maxLength: 120, description: "What you ask for, as the user reads it: 'Brave API key', 'the call recordings folder'. Required unless `request` is given." },
4175
- kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file (on macOS also a folder); `any`: a secret, or a file when the field is left empty." },
4175
+ kind: { type: "string", enum: ["secret", "file", "any"], default: "any", description: "`secret`: a password field; `file`: a file; `any`: a secret, or a file when the field is left empty." },
4176
4176
  where_url: { type: "string", maxLength: 300, description: "https page where this key is created. The user sees its domain; known services are named, any other domain is marked as given by you." },
4177
4177
  wait: { type: "boolean", default: true, description: "Wait for the answer and return the saved path. Where the answer goes through a link and your client cannot show links itself, the link comes back first: show it and the three words to the user, then call again with `request`." },
4178
4178
  request: { type: "string", pattern: "^h_[A-Za-z0-9_-]{12,}$", description: "Handle of a request answered through a link: wait for it." },
4179
- from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the dialog on this machine, else a card for the owner when connected, else the link." },
4180
- dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The dialog on this machine saves where the `seal` CLI does." },
4181
- bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page or the dialog shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
4179
+ from: { type: "string", enum: ["owner", "anyone"], description: "`owner`: a card in the connected owner's inbox (`owner_not_paired` without one); `anyone`: a link any person can answer. Without it: the page opens in this computer's browser when there is one, else a card for the owner when connected, else the link." },
4180
+ dir: { type: "string", description: "An answer through a link or a card: directory to save it into, created if missing; default a private 0700 directory in the system's temp folder. An existing file is never overwritten: the new one becomes `name (1).ext`. The page opened on this computer saves where the `seal` CLI does." },
4181
+ bind: { type: "object", description: "kind=secret: where the key will be used, proposed to the person (seal_address.json guard.bind). The page shows it when no entry of secrets.json knows the key's form; the person confirms, narrows or removes it. The guard then lets the key out only to these hosts.", properties: { hosts: { type: "array", maxItems: 16, items: { type: "string", maxLength: 253 } }, place: { type: "string", maxLength: 64 }, class: { type: "string", enum: ["outbound", "inprocess"] } }, required: ["hosts"] }
4182
4182
  }
4183
4183
  },
4184
4184
  flow: {
4185
- guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the dialog is the guard's (the CLI asks the service over its socket), the link is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
4186
- order: "Without `from`: the local dialog, then a card in the connected owner's inbox, then the link. The wait is the same for all three (`waitForIntake`).",
4185
+ guard: "With this machine's guard running (`seal guard status`), a secret never reaches this server: the request is made with the guard's bundle and the guard opens the answer (`seal guard take`); the saved 0600 file holds a surrogate of the key's form, and `bound` says so. The guard puts the real value in only at the hosts of the binding, for programs run through `seal_run`. Without a guard the file holds the value, as before, and `note` says that protection is off (`seal guard install`).",
4186
+ order: "Without `from`: the page in this computer's browser, then a card in the connected owner's inbox, then the link. One page for all three (`/i/<id>`); the wait is the same (`waitForIntake`). There is no system dialog and no page on 127.0.0.1: a second window would be the same flow drawn twice, outside the site's design and without the binding (SPEC agent egress \u042015, 27.10).",
4187
4187
  card: "`POST /intake` with `to` = the owner's address: the request sits in the owner's inbox; the person answers from there on /i/<id>. The call returns `output_link` as for a link, its url being the same page.",
4188
- local: "On the user's computer the `seal` CLI draws the system dialog (`seal request --local --json`); nothing leaves the machine. A secret lands in a 0600 file, a picked file stays where it is. The dialog's `Ask someone else` button (where the system window has room for it) answers `request.ask_other`, and the request goes on through the link.",
4189
- link: "Otherwise (no screen, no `seal` CLI): `POST /intake` with this server's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
4188
+ here: "On the user's computer the `seal` CLI makes the request and opens the page in their browser (`seal request --local --json`), waiting for the answer itself: `files` back, or `request.no_local` where no browser would show the page (SSH, a container), or `request.expired` when nobody answered in time.",
4189
+ link: "Otherwise (no browser here, no `seal` CLI): `POST /intake` with the recipient's bundle (`recipient_bundle`); the user answers at `<public host>/i/<id>`, which checks the bundle and seals the answer to it. With URL-mode elicitation the client shows the link and this call waits; without it the call returns `output_link`. The answer is opened like `seal_open mode=file` into a private 0700 directory.",
4190
4190
  words: "Three words of this server's address (`fingerprint_words.json`), shown in the chat and on the page; the user closes the page if they differ."
4191
4191
  },
4192
4192
  output_received: {
@@ -4194,7 +4194,7 @@ var seal_mcp_v1_default = {
4194
4194
  required: ["handle", "source", "files"],
4195
4195
  properties: {
4196
4196
  handle: { type: "string" },
4197
- source: { type: "string", enum: ["local", "link"] },
4197
+ source: { type: "string", enum: ["link"] },
4198
4198
  files: {
4199
4199
  type: "array",
4200
4200
  items: {
@@ -13430,16 +13430,16 @@ async function sealRequest(ctx, input, deps) {
13430
13430
  const cliArgs = ["request", "--local", "--json", "--kind", kind, "--what", what, "--label", deps.label];
13431
13431
  if (input.whereUrl) cliArgs.push("--where", input.whereUrl);
13432
13432
  if (input.bind) cliArgs.push("--bind", bindSpec(input.bind));
13433
- const local = await runCli(cliArgs);
13434
- if (local && "files" in local) {
13435
- await appendAudit(ctx, "seal_request", handle, "local");
13436
- return { handle, source: "local", files: local.files.map(cliFile), ...local.note ? { note: local.note } : {} };
13433
+ const here = await runCli(cliArgs);
13434
+ if (here && "files" in here) {
13435
+ await appendAudit(ctx, "seal_request", handle, "link");
13436
+ return { handle, source: "link", files: here.files.map(cliFile), ...here.note ? { note: here.note } : {} };
13437
13437
  }
13438
- if (local && local.error.code === "request.cancelled") {
13439
- throw new ToolError("request_cancelled", "the user closed the dialog");
13438
+ if (here && here.error.code === "request.expired") {
13439
+ throw new ToolError("request_expired", here.error.message);
13440
13440
  }
13441
- if (local && local.error.code !== "request.no_local" && local.error.code !== "request.ask_other") {
13442
- throw new ToolError("request_failed", `seal request: ${local.error.message}`);
13441
+ if (here && here.error.code !== "request.no_local") {
13442
+ throw new ToolError("request_failed", `seal request: ${here.error.message}`);
13443
13443
  }
13444
13444
  }
13445
13445
  const guard = kind === "file" ? null : await guardStatus(runCli);
@@ -14175,7 +14175,7 @@ function proFileGetOutputToWire(out) {
14175
14175
  }
14176
14176
 
14177
14177
  // src/server.ts
14178
- var SERVER_VERSION = "0.11.0";
14178
+ var SERVER_VERSION = "0.11.1";
14179
14179
  var toolMeta = (name2) => {
14180
14180
  const { title, description, annotations } = seal_mcp_v1_default.tools[name2];
14181
14181
  return { title, description, annotations };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sealnet-mcp",
3
- "version": "0.11.0",
3
+ "version": "0.11.1",
4
4
  "mcpName": "net.seal/mcp",
5
5
  "description": "Model Context Protocol server for SEAL: files go to the user's SEAL inbox once connected, else the link goes on the clipboard or in a 0600 file, never in the chat; explicit opt-in to forward mode with strict TTL/recipient policy.",
6
6
  "type": "module",