attest-client 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 97115104 (Austin Harshberger)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+// attest-client CLI
+// Usage: npx attest-client --content README.md --model claude-opus-4 --role collaborated
+
+const args = process.argv.slice(2);
+
+function flag(name) {
+  const i = args.indexOf(`--${name}`);
+  if (i === -1) return undefined;
+  return args[i + 1];
+}
+
+const help = args.includes('--help') || args.includes('-h');
+if (help) {
+  console.log(`attest — open protocol for AI content attribution
+
+Usage:
+  attest --content <name> [options]
+  attest --discover
+  attest --metrics
+
+Options:
+  --content <name>    Content name or filename (required for attestation)
+  --model <model>     AI model used (default: gpt-4)
+  --role <role>       authored | collaborated | generated (default: collaborated)
+  --author <name>     Author or agent name (default: Anonymous)
+  --type <type>       human | collab | ai (overrides role)
+  --host <url>        API host (default: https://attest.97115104.com)
+  --discover          Show API discovery info
+  --metrics           Show platform metrics
+  --json              Output raw JSON
+  --help, -h          Show this help`);
+  process.exit(0);
+}
+
+const host = flag('host') || 'https://attest.97115104.com';
+const headers = { 'User-Agent': 'attest-client/2.0.0 cli' };
+
+async function run() {
+  if (args.includes('--discover')) {
+    const res = await fetch(`${host}/.well-known/attest.json`, { headers });
+    const data = await res.json();
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  if (args.includes('--metrics')) {
+    const res = await fetch(`${host}/api/metrics`, { headers });
+    const data = await res.json();
+    if (args.includes('--json')) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      console.log(`attestations: ${data.total_attestations}`);
+      console.log(`verifications: ${data.total_verifications}`);
+      console.log(`agent visits: ${data.total_agent_visits}`);
+      console.log(`top model: ${data.top_model?.model || 'none'} (${data.top_model?.count || 0})`);
+      console.log(`top type: ${data.top_type?.authorship_type || 'none'} (${data.top_type?.count || 0})`);
+    }
+    return;
+  }
+
+  const content_name = flag('content');
+  if (!content_name) {
+    console.error('error: --content is required. Use --help for usage.');
+    process.exit(1);
+  }
+
+  const params = new URLSearchParams();
+  params.set('content_name', content_name);
+  const model = flag('model');
+  if (model) params.set('model', model);
+  const role = flag('role');
+  if (role) params.set('role', role);
+  const author = flag('author');
+  if (author) params.set('author', author);
+  const type = flag('type');
+  if (type) params.set('authorship_type', type);
+
+  const res = await fetch(`${host}/api/create?${params}`, { headers });
+  const data = await res.json();
+
+  if (!data.success) {
+    console.error(`error: ${data.error || 'unknown error'}`);
+    process.exit(1);
+  }
+
+  if (args.includes('--json')) {
+    console.log(JSON.stringify(data, null, 2));
+  } else {
+    console.log(`attested: ${data.attestation.content_name}`);
+    console.log(`type: ${data.attestation.authorship_type}`);
+    console.log(`model: ${data.attestation.model}`);
+    console.log(`id: ${data.attestation.id}`);
+    console.log(`short: ${data.urls.short}`);
+    console.log(`verify: ${data.urls.verify}`);
+  }
+}
+
+run().catch(err => {
+  console.error(`error: ${err.message}`);
+  process.exit(1);
+});

package/index.cjs

@@ -0,0 +1,67 @@
+// attest-client — CJS build
+// https://attest.97115104.com
+
+const DEFAULT_HOST = 'https://attest.97115104.com';
+
+function createClient(options = {}) {
+  const host = (options.host || DEFAULT_HOST).replace(/\/+$/, '');
+  const author = options.author || 'Anonymous';
+  const headers = { 'User-Agent': 'attest-client/2.0.0' };
+
+  async function create({ content_name, model, role, author: overrideAuthor, content, authorship_type }) {
+    if (!content_name) throw new Error('attest-client: content_name is required');
+
+    const params = new URLSearchParams();
+    params.set('content_name', content_name);
+    if (model) params.set('model', model);
+    if (role) params.set('role', role);
+    params.set('author', overrideAuthor || author);
+    if (content) params.set('content', content);
+    if (authorship_type) params.set('authorship_type', authorship_type);
+
+    const res = await fetch(`${host}/api/create?${params}`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+
+    const data = await res.json();
+    if (!data.success) throw new Error(`attest-client: ${data.error || 'unknown error'}`);
+    return data;
+  }
+
+  async function createFromUrl({ url, model, role, author: overrideAuthor }) {
+    if (!url) throw new Error('attest-client: url is required');
+
+    const body = { url, model, role, author: overrideAuthor || author };
+    const res = await fetch(`${host}/api/create-url`, {
+      method: 'POST',
+      headers: { ...headers, 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+
+    const data = await res.json();
+    if (!data.success) throw new Error(`attest-client: ${data.error || 'unknown error'}`);
+    return data;
+  }
+
+  async function metrics() {
+    const res = await fetch(`${host}/api/metrics`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+    return res.json();
+  }
+
+  async function discover() {
+    const res = await fetch(`${host}/.well-known/attest.json`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+    return res.json();
+  }
+
+  return { create, createFromUrl, metrics, discover };
+}
+
+async function attest(options) {
+  const { host, author, ...params } = options;
+  const client = createClient({ host, author });
+  return client.create(params);
+}
+
+module.exports = { createClient, attest, default: attest };

package/index.js

@@ -0,0 +1,68 @@
+// attest-client — SDK for the attest open attribution protocol
+// https://attest.97115104.com
+
+const DEFAULT_HOST = 'https://attest.97115104.com';
+
+export function createClient(options = {}) {
+  const host = (options.host || DEFAULT_HOST).replace(/\/+$/, '');
+  const author = options.author || 'Anonymous';
+  const headers = { 'User-Agent': `attest-client/2.0.0` };
+
+  async function create({ content_name, model, role, author: overrideAuthor, content, authorship_type }) {
+    if (!content_name) throw new Error('attest-client: content_name is required');
+
+    const params = new URLSearchParams();
+    params.set('content_name', content_name);
+    if (model) params.set('model', model);
+    if (role) params.set('role', role);
+    params.set('author', overrideAuthor || author);
+    if (content) params.set('content', content);
+    if (authorship_type) params.set('authorship_type', authorship_type);
+
+    const res = await fetch(`${host}/api/create?${params}`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+
+    const data = await res.json();
+    if (!data.success) throw new Error(`attest-client: ${data.error || 'unknown error'}`);
+    return data;
+  }
+
+  async function createFromUrl({ url, model, role, author: overrideAuthor }) {
+    if (!url) throw new Error('attest-client: url is required');
+
+    const body = { url, model, role, author: overrideAuthor || author };
+    const res = await fetch(`${host}/api/create-url`, {
+      method: 'POST',
+      headers: { ...headers, 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+
+    const data = await res.json();
+    if (!data.success) throw new Error(`attest-client: ${data.error || 'unknown error'}`);
+    return data;
+  }
+
+  async function metrics() {
+    const res = await fetch(`${host}/api/metrics`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+    return res.json();
+  }
+
+  async function discover() {
+    const res = await fetch(`${host}/.well-known/attest.json`, { headers });
+    if (!res.ok) throw new Error(`attest-client: HTTP ${res.status} ${res.statusText}`);
+    return res.json();
+  }
+
+  return { create, createFromUrl, metrics, discover };
+}
+
+// Convenience: one-shot attestation without creating a client
+export async function attest(options) {
+  const { host, author, ...params } = options;
+  const client = createClient({ host, author });
+  return client.create(params);
+}
+
+export default attest;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "attest-client",
+  "version": "2.0.0",
+  "description": "Client SDK for attest, the open protocol for AI content attribution",
+  "type": "module",
+  "main": "index.cjs",
+  "module": "index.js",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "bin": {
+    "attest": "./cli.js"
+  },
+  "files": [
+    "index.js",
+    "index.cjs",
+    "cli.js",
+    "LICENSE"
+  ],
+  "keywords": [
+    "attest",
+    "attestation",
+    "ai",
+    "attribution",
+    "content",
+    "provenance",
+    "transparency",
+    "llm",
+    "agent"
+  ],
+  "author": "97115104",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/97115104/attest.git",
+    "directory": "sdk"
+  },
+  "homepage": "https://attest.97115104.com",
+  "engines": {
+    "node": ">=18"
+  }
+}