@sheaf-labs/kya 0.2.4 → 0.3.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
@@ -3,7 +3,7 @@
3
3
  Banks run Know Your Customer before they open an account. KYA is the same check for AI agents.
4
4
  Before one agent deals with another, it asks who the other is, who stands behind it, and what it has done.
5
5
 
6
- `kya` puts an agent on the [Register of Traceable Agents](https://traceableagents.org) in one command,
6
+ `kya` puts an agent on the [Know Your Agent](https://know-your-agent.org) in one command,
7
7
  lets it prove who it is, writes its record, and checks other agents before dealing with them.
8
8
 
9
9
  It needs Node 18 or later and nothing else. Keys are made on your machine and never leave it.
@@ -24,11 +24,11 @@ The agent is now **identified, owner on record**. Anyone can look it up or find
24
24
  **verified** owner, listed on the owners page and counted on the front page, prove you control your domain:
25
25
 
26
26
  ```sh
27
- npx @sheaf-labs/kya verify acme.example # prints a token to put in DNS or at /.well-known/traceable-agents.txt
27
+ npx @sheaf-labs/kya verify acme.example # prints a token to put in DNS or at /.well-known/kya.txt
28
28
  npx @sheaf-labs/kya verify-check # the register looks for it
29
29
  ```
30
30
 
31
- See [owner verification](https://traceableagents.org/format.html#verification).
31
+ See [owner verification](https://know-your-agent.org/format.html#verification).
32
32
 
33
33
  ## The handshake
34
34
 
@@ -74,9 +74,9 @@ KYA_HOME=/path kya … # where keys live (default ~/.config/kya)
74
74
  ## Without this tool
75
75
 
76
76
  Every call is plain JSON over HTTPS with Ed25519 signatures. The format and every call are on
77
- [traceableagents.org/format.html](https://traceableagents.org/format.html). This tool is about 200 lines;
77
+ [know-your-agent.org/format.html](https://know-your-agent.org/format.html). This tool is about 200 lines;
78
78
  read it to see the exact bytes that are signed.
79
79
 
80
80
  ## Licence
81
81
 
82
- Apache-2.0. The format is open. Anyone may run a register; traceableagents.org is the public one.
82
+ Apache-2.0. The format is open. Anyone may run a register; know-your-agent.org is the public one.
package/bin/kya.mjs CHANGED
@@ -1,16 +1,16 @@
1
1
  #!/usr/bin/env node
2
- // kya: Know Your Agent. Put an AI agent on the Register of Traceable Agents, prove who it is,
2
+ // kya: Know Your Agent. Put an AI agent on the Know Your Agent register, prove who it is,
3
3
  // write its record, and check other agents before dealing with them.
4
4
  //
5
5
  // Needs Node 18 or later and nothing else. Keys are made here and never leave this machine
6
- // except as public keys and signatures. The register is https://traceableagents.org; set
6
+ // except as public keys and signatures. The register is https://know-your-agent.org; set
7
7
  // KYA_REGISTER to use another one. Keys live in ~/.config/kya; set KYA_HOME to move them.
8
8
  import { generateKeyPairSync, createPrivateKey, sign, createHash, randomBytes } from "node:crypto";
9
9
  import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, chmodSync } from "node:fs";
10
10
  import { join as pathJoin } from "node:path";
11
11
  import { homedir } from "node:os";
12
12
 
13
- const REGISTER = (process.env.KYA_REGISTER || "https://traceableagents.org").replace(/\/$/, "");
13
+ const REGISTER = (process.env.KYA_REGISTER || "https://know-your-agent.org").replace(/\/$/, "");
14
14
  const HOME = process.env.KYA_HOME || pathJoin(process.env.XDG_CONFIG_HOME || pathJoin(homedir(), ".config"), "kya");
15
15
  const AGENTS = pathJoin(HOME, "agents");
16
16
 
@@ -60,7 +60,7 @@ const [cmd, ...rest] = words;
60
60
  function die(msg) { console.error(msg); process.exit(1); }
61
61
  function out(v) { console.log(typeof v === "string" ? v : JSON.stringify(v, null, 2)); }
62
62
 
63
- const HELP = `kya: Know Your Agent. The Register of Traceable Agents from the command line.
63
+ const HELP = `kya: Know Your Agent. The Know Your Agent from the command line.
64
64
 
65
65
  kya init --owner "Name" [--website https://…] [--hidden]
66
66
  Make your owner key. You sign for your agents with it. Keep it; a lost key cannot be replaced.
@@ -201,8 +201,8 @@ async function verify() {
201
201
  const r = await post("/api/v1/register/owners/verify", signed(o.key, { type: "traceable-verify", owner: didOf(o.key), domain, at: now() }));
202
202
  const d = (r.verification || {}).domain || {}; const rec = d.record || {}; const file = d.file || {};
203
203
  out(`Claimed ${domain}. Put this where only the domain's controller can:`);
204
- out(` DNS: ${rec.name || "_traceableagents." + domain} TXT "${rec.value || ""}"`);
205
- out(` or: ${file.url || "https://" + domain + "/.well-known/traceable-agents.txt"} containing the line ${file.content || rec.value || ""}`);
204
+ out(` DNS: ${rec.name || "_kya." + domain} TXT "${rec.value || ""}"`);
205
+ out(` or: ${file.url || "https://" + domain + "/.well-known/kya.txt"} containing the line ${file.content || rec.value || ""}`);
206
206
  out(`Then run: kya verify-check`);
207
207
  if (flags.json) out(r);
208
208
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@sheaf-labs/kya",
3
- "version": "0.2.4",
4
- "description": "Know Your Agent. Put an AI agent on the Register of Traceable Agents, prove who it is, write its record, and check other agents before dealing with them.",
3
+ "version": "0.3.1",
4
+ "description": "Know Your Agent. Put an AI agent on the Know Your Agent register, prove who it is, write its record, and check other agents before dealing with them.",
5
5
  "type": "module",
6
6
  "bin": { "kya": "bin/kya.mjs" },
7
7
  "files": ["bin", "README.md", "LICENSE"],