sello 0.1.8 → 0.1.9

package/README.md

@@ -46,6 +46,7 @@ To scaffold a small HTTP route that emits receipts:
 
 ```bash
 npx --yes sello init-http-demo
+npx --yes sello call-http-demo
 ```
 
 ## Why Sello?
@@ -85,7 +86,7 @@ The implementation includes a local end-to-end demo, compact JWS token verificat
 |------|------|
 | Add Sello in a few lines | [SDK Quickstart](docs/sdk-quickstart.md) |
 | Emit your first receipt | `npx --yes sello dev`, then `npx --yes sello emit-demo` |
-| Wrap one HTTP route | `npx --yes sello init-http-demo` |
+| Wrap one HTTP route | `npx --yes sello init-http-demo`, then `npx --yes sello call-http-demo` |
 | Try a wrapped tool locally | `node --run dev`, then `node --run example:tool` |
 | Try an MCP-style tool call | `node --run dev`, then `node --run example:mcp` |
 | See a minimal MCP integration | [examples/mcp-minimal-server.ts](examples/mcp-minimal-server.ts) |
@@ -142,7 +143,7 @@ For an MCP-shaped `tools/call` boundary, run `node --run example:mcp` instead of
 
 For a smaller production-shaped MCP example, see [examples/mcp-minimal-server.ts](examples/mcp-minimal-server.ts). It wraps one `tools/call` handler with `sello.service()` and leaves unknown tools unreceipted.
 
-For an installed-project bridge from demo to app, run `npx sello init-http-demo`. It writes a small dependency-free HTTP route that imports `sello`, reads the local dev config, verifies a bearer token, runs a handler, and emits a receipt.
+For an installed-project bridge from demo to app, run `npx sello init-http-demo`. It writes a small dependency-free HTTP route that imports `sello`, reads the local dev config, verifies a bearer token, runs a handler, and emits a receipt. With the local log and route running, `npx sello call-http-demo` sends the demo request for you.
 
 ## The First 10 Minutes
 

package/dist/cli/sello.js

@@ -81,6 +81,9 @@ try {
     case "emit-demo":
       await emitDemoCommand(process.argv.slice(3));
       break;
+    case "call-http-demo":
+      await callHttpDemoCommand(process.argv.slice(3));
+      break;
     case "init-demo":
       initDemoCommand(process.argv.slice(3));
       break;
@@ -237,6 +240,38 @@ async function emitDemoCommand(args          )                {
   console.log(`  ${actionViewerUrl(state)}`);
 }
 
+async function callHttpDemoCommand(args          )                {
+  const state = loadDevStateOrThrow(
+    "missing local Sello dev state. Run `sello dev` first, then run `sello call-http-demo` in another terminal from the same directory.",
+  );
+  const url = readFlag(args, "--url") ?? "http://localhost:8790/calendar/events";
+  const title = readFlag(args, "--title") ?? "Ship Sello";
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${state.agentToken}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({ title }),
+  });
+  const responseText = await response.text();
+
+  if (!response.ok) {
+    throw new TypeError(
+      `HTTP route demo failed with HTTP ${response.status}: ${responseText.trim()}`,
+    );
+  }
+
+  console.log("Called Sello HTTP route demo.");
+  console.log(formatHttpDemoResponse(responseText));
+  console.log("");
+  console.log("View verified actions with:");
+  console.log("  sello actions");
+  console.log("");
+  console.log("Or open:");
+  console.log(`  ${actionViewerUrl(state)}`);
+}
+
 function initDemoCommand(args          )       {
   const output = readFlag(args, "--output") ?? "emit-receipt.mjs";
   const force = args.includes("--force");
@@ -278,8 +313,7 @@ function initHttpDemoCommand(args          )       {
   console.log(`  node ${output}`);
   console.log("");
   console.log("Terminal 3: call the route and view the receipt");
-  console.log("  TOKEN=$(node -e 'console.log(JSON.parse(require(\"fs\").readFileSync(\".sello/dev.json\", \"utf8\")).agentToken)')");
-  console.log("  curl -sS -X POST http://localhost:8790/calendar/events -H \"authorization: Bearer $TOKEN\" -H \"content-type: application/json\" -d '{\"title\":\"Ship Sello\"}'");
+  console.log("  npx sello call-http-demo");
   console.log("  npx sello actions");
   console.log("");
   console.log("Then open http://localhost:8787/actions");
@@ -678,6 +712,7 @@ function printHelp()       {
   console.log(`Usage:
   sello dev [--port 8787] [--service service-id] [--dry-run]
   sello emit-demo [--title title]
+  sello call-http-demo [--url http://localhost:8790/calendar/events] [--title title]
   sello init-demo [--output emit-receipt.mjs] [--force]
   sello init-http-demo [--output sello-http-route.mjs] [--force]
   sello actions [--token agent-token]
@@ -738,6 +773,14 @@ function actionViewerUrl(state          )         {
   return `${endpoint.origin}/actions`;
 }
 
+function formatHttpDemoResponse(responseText        )         {
+  try {
+    return JSON.stringify(JSON.parse(responseText), null, 2);
+  } catch {
+    return responseText;
+  }
+}
+
 function slug(value        )         {
   return value
     .toLowerCase()
@@ -857,9 +900,8 @@ const server = createServer(async (request, response) => {
 server.listen(port, () => {
   console.log("Sello HTTP route demo running at http://localhost:" + port + "/calendar/events");
   console.log("");
-  console.log("Call it with:");
-  console.log("  TOKEN=$(node -e 'console.log(JSON.parse(require(\\\"fs\\\").readFileSync(\\\".sello/dev.json\\\", \\\"utf8\\\")).agentToken)')");
-  console.log("  curl -sS -X POST http://localhost:" + port + "/calendar/events -H \\\"authorization: Bearer $TOKEN\\\" -H \\\"content-type: application/json\\\" -d '{\\\"title\\\":\\\"Ship Sello\\\"}'");
+  console.log("Call it from another terminal with:");
+  console.log("  npx sello call-http-demo");
 });
 
 async function readJson(request) {

package/docs/sdk-quickstart.md

@@ -41,7 +41,12 @@ To write a dependency-free HTTP route example into your project:
 npx --yes sello init-http-demo
 ```
 
-The route example imports `sello`, reads the local dev config, verifies a bearer token, runs one `POST /calendar/events` handler, and emits a receipt.
+The route example imports `sello`, reads the local dev config, verifies a bearer token, runs one `POST /calendar/events` handler, and emits a receipt. With `npx sello dev` and the generated route running, call it with:
+
+```bash
+npx --yes sello call-http-demo
+npx --yes sello actions
+```
 
 Inside this repo, start the local log and action viewer:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sello",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Reference implementation of the Sello protocol for service-signed AI agent receipts.",
   "type": "module",
   "license": "Apache-2.0",

package/src/cli/sello.ts

@@ -82,6 +82,9 @@ try {
     case "emit-demo":
       await emitDemoCommand(process.argv.slice(3));
       break;
+    case "call-http-demo":
+      await callHttpDemoCommand(process.argv.slice(3));
+      break;
     case "init-demo":
       initDemoCommand(process.argv.slice(3));
       break;
@@ -238,6 +241,38 @@ async function emitDemoCommand(args: string[]): Promise<void> {
   console.log(`  ${actionViewerUrl(state)}`);
 }
 
+async function callHttpDemoCommand(args: string[]): Promise<void> {
+  const state = loadDevStateOrThrow(
+    "missing local Sello dev state. Run `sello dev` first, then run `sello call-http-demo` in another terminal from the same directory.",
+  );
+  const url = readFlag(args, "--url") ?? "http://localhost:8790/calendar/events";
+  const title = readFlag(args, "--title") ?? "Ship Sello";
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${state.agentToken}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({ title }),
+  });
+  const responseText = await response.text();
+
+  if (!response.ok) {
+    throw new TypeError(
+      `HTTP route demo failed with HTTP ${response.status}: ${responseText.trim()}`,
+    );
+  }
+
+  console.log("Called Sello HTTP route demo.");
+  console.log(formatHttpDemoResponse(responseText));
+  console.log("");
+  console.log("View verified actions with:");
+  console.log("  sello actions");
+  console.log("");
+  console.log("Or open:");
+  console.log(`  ${actionViewerUrl(state)}`);
+}
+
 function initDemoCommand(args: string[]): void {
   const output = readFlag(args, "--output") ?? "emit-receipt.mjs";
   const force = args.includes("--force");
@@ -279,8 +314,7 @@ function initHttpDemoCommand(args: string[]): void {
   console.log(`  node ${output}`);
   console.log("");
   console.log("Terminal 3: call the route and view the receipt");
-  console.log("  TOKEN=$(node -e 'console.log(JSON.parse(require(\"fs\").readFileSync(\".sello/dev.json\", \"utf8\")).agentToken)')");
-  console.log("  curl -sS -X POST http://localhost:8790/calendar/events -H \"authorization: Bearer $TOKEN\" -H \"content-type: application/json\" -d '{\"title\":\"Ship Sello\"}'");
+  console.log("  npx sello call-http-demo");
   console.log("  npx sello actions");
   console.log("");
   console.log("Then open http://localhost:8787/actions");
@@ -679,6 +713,7 @@ function printHelp(): void {
   console.log(`Usage:
   sello dev [--port 8787] [--service service-id] [--dry-run]
   sello emit-demo [--title title]
+  sello call-http-demo [--url http://localhost:8790/calendar/events] [--title title]
   sello init-demo [--output emit-receipt.mjs] [--force]
   sello init-http-demo [--output sello-http-route.mjs] [--force]
   sello actions [--token agent-token]
@@ -739,6 +774,14 @@ function actionViewerUrl(state: DevState): string {
   return `${endpoint.origin}/actions`;
 }
 
+function formatHttpDemoResponse(responseText: string): string {
+  try {
+    return JSON.stringify(JSON.parse(responseText), null, 2);
+  } catch {
+    return responseText;
+  }
+}
+
 function slug(value: string): string {
   return value
     .toLowerCase()
@@ -858,9 +901,8 @@ const server = createServer(async (request, response) => {
 server.listen(port, () => {
   console.log("Sello HTTP route demo running at http://localhost:" + port + "/calendar/events");
   console.log("");
-  console.log("Call it with:");
-  console.log("  TOKEN=$(node -e 'console.log(JSON.parse(require(\\\"fs\\\").readFileSync(\\\".sello/dev.json\\\", \\\"utf8\\\")).agentToken)')");
-  console.log("  curl -sS -X POST http://localhost:" + port + "/calendar/events -H \\\"authorization: Bearer $TOKEN\\\" -H \\\"content-type: application/json\\\" -d '{\\\"title\\\":\\\"Ship Sello\\\"}'");
+  console.log("Call it from another terminal with:");
+  console.log("  npx sello call-http-demo");
 });
 
 async function readJson(request) {