@tangle-network/agent-app 0.60.9 → 0.60.11
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.
|
@@ -99,8 +99,11 @@ export interface AgentSurfaceFile {
|
|
|
99
99
|
}
|
|
100
100
|
/**
|
|
101
101
|
* The signup script the skill tells an agent to save and run. Node 18+ only,
|
|
102
|
-
* no dependencies
|
|
103
|
-
*
|
|
102
|
+
* no dependencies, in two short commands so a tool that kills long-running
|
|
103
|
+
* commands cannot cut the wait: `start` returns at once with the link and the
|
|
104
|
+
* confirmation code; `wait` polls for a few seconds and exits 0 once approved
|
|
105
|
+
* or 3 while the owner has not approved yet. It never prints the key; it
|
|
106
|
+
* writes `.tangle/api-key` with mode 0600.
|
|
104
107
|
*/
|
|
105
108
|
export declare function agentSignupScript(platformOrigin?: string): string;
|
|
106
109
|
/** The agent setup skill: valid SKILL.md and a plain copy-paste prompt. */
|
|
@@ -10,18 +10,18 @@ function fence(step) {
|
|
|
10
10
|
}
|
|
11
11
|
function agentSignupScript(platformOrigin = TANGLE_PLATFORM_ORIGIN) {
|
|
12
12
|
return `// Requests a scoped Tangle key for this agent. The owner approves once.
|
|
13
|
-
|
|
13
|
+
// node tangle-signup.mjs start --app <app> --agent-name <name> [--owner-email <email>] [--budget-usd <n>]
|
|
14
|
+
// node tangle-signup.mjs wait (run again while it exits 3; exits 0 once approved)
|
|
15
|
+
import { mkdirSync, readFileSync, writeFileSync } from ${JSON.stringify("node:fs")}
|
|
14
16
|
|
|
17
|
+
const command = process.argv[2]
|
|
15
18
|
const flag = (name) => {
|
|
16
19
|
const index = process.argv.indexOf(\`--\${name}\`)
|
|
17
20
|
return index > 0 ? process.argv[index + 1] : undefined
|
|
18
21
|
}
|
|
19
22
|
const platform = '${trimOrigin(platformOrigin)}'
|
|
20
|
-
const
|
|
21
|
-
|
|
22
|
-
const request = { app, agent_name: flag('agent-name') ?? 'coding-agent' }
|
|
23
|
-
if (flag('owner-email')) request.owner_email = flag('owner-email')
|
|
24
|
-
if (flag('budget-usd')) request.budget_usd = Number(flag('budget-usd'))
|
|
23
|
+
const statePath = '.tangle/signup.json'
|
|
24
|
+
mkdirSync('.tangle', { recursive: true, mode: 0o700 })
|
|
25
25
|
|
|
26
26
|
async function post(path, body) {
|
|
27
27
|
const response = await fetch(platform + path, {
|
|
@@ -32,39 +32,75 @@ async function post(path, body) {
|
|
|
32
32
|
return { status: response.status, body: await response.json().catch(() => ({})) }
|
|
33
33
|
}
|
|
34
34
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
35
|
+
if (command === 'start') {
|
|
36
|
+
const app = flag('app')
|
|
37
|
+
if (!app) {
|
|
38
|
+
console.error('Pass --app (for example --app sandbox)')
|
|
39
|
+
process.exit(2)
|
|
40
|
+
}
|
|
41
|
+
const request = { app, agent_name: flag('agent-name') ?? 'coding-agent' }
|
|
42
|
+
if (flag('owner-email')) request.owner_email = flag('owner-email')
|
|
43
|
+
if (flag('budget-usd')) request.budget_usd = Number(flag('budget-usd'))
|
|
44
|
+
const started = await post('/cross-site/device/start', request)
|
|
45
|
+
if (started.status !== 200) {
|
|
46
|
+
console.error(\`Signup refused (HTTP \${started.status}): \${JSON.stringify(started.body)}\`)
|
|
47
|
+
process.exit(1)
|
|
48
|
+
}
|
|
49
|
+
const grant = started.body.data
|
|
50
|
+
const saved = {
|
|
51
|
+
app,
|
|
52
|
+
device_code: grant.device_code,
|
|
53
|
+
interval: grant.interval,
|
|
54
|
+
expires_at: Date.now() + grant.expires_in * 1000,
|
|
55
|
+
}
|
|
56
|
+
writeFileSync(statePath, JSON.stringify(saved), { mode: 0o600 })
|
|
57
|
+
console.log(grant.agent?.owner_notified
|
|
58
|
+
? \`Approval email sent to \${request.owner_email}.\`
|
|
59
|
+
: 'Send your owner this approval link.')
|
|
60
|
+
console.log(\`Approval link: \${grant.verification_uri_complete}\`)
|
|
61
|
+
console.log(\`Confirmation code: \${grant.user_code} (expires in \${Math.round(grant.expires_in / 60)} minutes)\`)
|
|
62
|
+
console.log('Next: run \`node tangle-signup.mjs wait\` until it prints Approved.')
|
|
63
|
+
process.exit(0)
|
|
39
64
|
}
|
|
40
|
-
const grant = started.body.data
|
|
41
|
-
console.log(grant.agent?.owner_notified
|
|
42
|
-
? \`Approval email sent to \${request.owner_email}.\`
|
|
43
|
-
: 'Send your owner this approval link.')
|
|
44
|
-
console.log(\`Approval link: \${grant.verification_uri_complete}\`)
|
|
45
|
-
console.log(\`Confirmation code: \${grant.user_code} (expires in \${Math.round(grant.expires_in / 60)} minutes)\`)
|
|
46
|
-
console.log('Waiting for approval...')
|
|
47
65
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
console.error(\`Approval failed (HTTP \${polled.status}): \${JSON.stringify(polled.body)}\`)
|
|
66
|
+
if (command === 'wait') {
|
|
67
|
+
let saved
|
|
68
|
+
try {
|
|
69
|
+
saved = JSON.parse(readFileSync(statePath, 'utf8'))
|
|
70
|
+
} catch {
|
|
71
|
+
console.error('No pending signup. Run \`node tangle-signup.mjs start\` first.')
|
|
55
72
|
process.exit(1)
|
|
56
73
|
}
|
|
57
|
-
const
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
74
|
+
const stopAt = Math.min(saved.expires_at, Date.now() + Number(flag('seconds') ?? 8) * 1000)
|
|
75
|
+
for (;;) {
|
|
76
|
+
const polled = await post('/cross-site/device/poll', { app: saved.app, device_code: saved.device_code })
|
|
77
|
+
if (polled.status === 200) {
|
|
78
|
+
const { api_key: apiKey, key, account } = polled.body.data
|
|
79
|
+
writeFileSync('.tangle/api-key', \`\${apiKey}\\n\`, { mode: 0o600 })
|
|
80
|
+
console.log(\`Approved. Key "\${key?.name ?? saved.app}" saved to .tangle/api-key (spend cap $\${key?.budget_usd ?? 'none'}).\`)
|
|
81
|
+
if (account && !account.funded) {
|
|
82
|
+
console.log(\`The owner's account has no credit yet. Ask the owner to add credits: \${account.add_credits_url}\`)
|
|
83
|
+
}
|
|
84
|
+
process.exit(0)
|
|
85
|
+
}
|
|
86
|
+
if (polled.status !== 428) {
|
|
87
|
+
console.error(\`Approval failed (HTTP \${polled.status}): \${JSON.stringify(polled.body)}\`)
|
|
88
|
+
process.exit(1)
|
|
89
|
+
}
|
|
90
|
+
if (Date.now() >= saved.expires_at) {
|
|
91
|
+
console.error('The approval link expired. Run \`node tangle-signup.mjs start\` again.')
|
|
92
|
+
process.exit(1)
|
|
93
|
+
}
|
|
94
|
+
if (Date.now() + saved.interval * 1000 > stopAt) {
|
|
95
|
+
console.log('Still waiting for the owner to approve. Run \`node tangle-signup.mjs wait\` again.')
|
|
96
|
+
process.exit(3)
|
|
97
|
+
}
|
|
98
|
+
await new Promise((resolve) => setTimeout(resolve, saved.interval * 1000))
|
|
63
99
|
}
|
|
64
|
-
process.exit(0)
|
|
65
100
|
}
|
|
66
|
-
|
|
67
|
-
|
|
101
|
+
|
|
102
|
+
console.error('Usage: node tangle-signup.mjs start --app <app> --agent-name <name> [--owner-email <email>] | wait')
|
|
103
|
+
process.exit(2)
|
|
68
104
|
`;
|
|
69
105
|
}
|
|
70
106
|
function signupSection(config) {
|
|
@@ -91,19 +127,22 @@ function signupSection(config) {
|
|
|
91
127
|
"",
|
|
92
128
|
fence({ language: "js", code: agentSignupScript() }),
|
|
93
129
|
"",
|
|
94
|
-
"
|
|
130
|
+
"Start the request with your own name and the owner's email. It returns at once:",
|
|
95
131
|
"",
|
|
96
132
|
fence({
|
|
97
133
|
language: "bash",
|
|
98
|
-
code: `node tangle-signup.mjs --app ${config.signup.app} --agent-name "<your agent name>" --owner-email "<owner email>" --budget-usd ${budget}`
|
|
134
|
+
code: `node tangle-signup.mjs start --app ${config.signup.app} --agent-name "<your agent name>" --owner-email "<owner email>" --budget-usd ${budget}`
|
|
99
135
|
}),
|
|
100
136
|
"",
|
|
101
|
-
"
|
|
137
|
+
"It prints the approval link and a confirmation code. Tangle emails the owner the same link; if you cannot give an email, omit `--owner-email` and send the owner the printed link yourself. Tell the owner the code if you can reach them.",
|
|
138
|
+
"",
|
|
139
|
+
"Then wait for the approval. Each run returns within about 8 seconds: exit code 3 and `Still waiting` mean run it again; exit code 0 and `Approved` mean the key is saved. Keep each run short rather than wrapping it in one long blocking loop, since many agent tools stop long commands.",
|
|
140
|
+
"",
|
|
141
|
+
fence({ language: "bash", code: "node tangle-signup.mjs wait" }),
|
|
142
|
+
"",
|
|
143
|
+
"What the owner does, once: sign in (or create an account and verify the email), check the confirmation code, and approve. That is the only human step.",
|
|
102
144
|
"",
|
|
103
|
-
`
|
|
104
|
-
"2. The owner signs in (or creates an account and verifies the email), checks the confirmation code, and approves. That is the only human step.",
|
|
105
|
-
`3. The script writes the key to \`.tangle/api-key\` (mode 600). It can only be used for ${config.name}, it can spend at most the cap you requested, and the owner can revoke it under Keys at any time.`,
|
|
106
|
-
"4. If the script says the account has no credit, ask the owner to add credits at the printed link before your first paid call.",
|
|
145
|
+
`The key in \`.tangle/api-key\` (mode 600) can only be used for ${config.name}, can spend at most the cap you requested, and the owner can revoke it under Keys at any time. If \`wait\` says the account has no credit, ask the owner to add credits at the printed link before your first paid call.`,
|
|
107
146
|
"",
|
|
108
147
|
"Then load the key without printing it, and keep it out of version control:",
|
|
109
148
|
"",
|
|
@@ -373,4 +412,4 @@ export {
|
|
|
373
412
|
withVaryAccept,
|
|
374
413
|
createAgentSurfaceHandler
|
|
375
414
|
};
|
|
376
|
-
//# sourceMappingURL=chunk-
|
|
415
|
+
//# sourceMappingURL=chunk-3G7IOCSV.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/agent-surfaces/index.ts"],"sourcesContent":["/**\n * Machine-readable surfaces for a Tangle product, generated from one config.\n *\n * Every product publishes the same four things an AI agent needs to become a\n * customer without a human doing the setup:\n *\n * - `/agent-setup.md`: a SKILL.md (Claude Code and Codex skill format) that\n * doubles as a copy-paste prompt. It takes a fresh agent from nothing to a\n * verified first call: one owner approval, a scoped key, install, call.\n * - `/llms.txt`: the llms.txt index, pointing at the setup skill first.\n * - `/.well-known/tangle-agent.json`: the Tangle agent manifest.\n * - Markdown for `Accept: text/markdown` on the product's pages, with\n * `Vary: Accept` on both representations so caches keep them apart.\n *\n * The signup section is rendered here, not in product config, so every\n * product describes Platform's agent signup identically and cannot drift.\n *\n * Web-standard `Request`/`Response` only: safe in Workers, Node and browsers.\n */\n\n/** Manifest schema this module emits. Additive over the 2026-06-16 shape. */\nexport const AGENT_MANIFEST_SCHEMA_VERSION = '2026-10-09'\n\nexport const TANGLE_PLATFORM_ORIGIN = 'https://id.tangle.tools'\n\nexport interface AgentSurfaceStep {\n title: string\n /** Fence language for the code block. */\n language: 'bash' | 'js' | 'ts' | 'python' | 'json'\n code: string\n /** What a successful run prints or returns. */\n expect: string\n}\n\nexport interface AgentSurfaceError {\n symptom: string\n cause: string\n fix: string\n}\n\nexport interface AgentSurfaceLink {\n label: string\n url: string\n}\n\n/**\n * How an agent obtains a key. `device` uses Platform's agent signup: the owner\n * approves once and the agent receives its own capped, revocable key.\n */\nexport type AgentSignup =\n | {\n kind: 'device'\n /** Platform trusted-app id the key is minted for (`sandbox`, `router`). */\n app: string\n /** Default lifetime spend cap the skill asks for, in USD. */\n budgetUsd?: number\n }\n | {\n kind: 'manual'\n /** Numbered steps the owner performs; each one is a human input. */\n steps: string[]\n }\n\nexport interface AgentSurfaceConfig {\n /** Short id used in the skill name: `tangle-<id>-setup`. */\n id: string\n name: string\n /** Public HTTPS origin, no trailing slash. */\n origin: string\n /** What the product is for, in one to three plain sentences. */\n summary: string\n useWhen: string[]\n signup: AgentSignup\n /** Environment variable the key is exported as. */\n apiKeyEnv: string\n /** Runtime prerequisites a fresh machine needs, e.g. `Node.js 20 or newer`. */\n prerequisites: string[]\n install: AgentSurfaceStep[]\n firstCall: AgentSurfaceStep[]\n verify: AgentSurfaceStep[]\n errors: AgentSurfaceError[]\n pricing: {\n /** Plain statement of how usage is charged. */\n summary: string\n /** Public, credential-free price data an agent can quote from. */\n quoteUrl?: string\n url?: string\n }\n next: AgentSurfaceLink[]\n docs?: string\n openapi?: string\n mcp?: { url: string; auth: string }\n related?: Array<{ name: string; manifest?: string; url?: string }>\n /** Extra manifest fields a product already publishes (kept verbatim). */\n manifest?: Record<string, unknown>\n}\n\nexport interface AgentSurfaceFile {\n path: string\n contentType: string\n body: string\n}\n\nconst MARKDOWN = 'text/markdown; charset=utf-8'\n\nfunction trimOrigin(origin: string): string {\n return origin.replace(/\\/+$/, '')\n}\n\nfunction fence(step: Pick<AgentSurfaceStep, 'language' | 'code'>): string {\n return ['```' + step.language, step.code.trimEnd(), '```'].join('\\n')\n}\n\n/**\n * The signup script the skill tells an agent to save and run. Node 18+ only,\n * no dependencies, in two short commands so a tool that kills long-running\n * commands cannot cut the wait: `start` returns at once with the link and the\n * confirmation code; `wait` polls for a few seconds and exits 0 once approved\n * or 3 while the owner has not approved yet. It never prints the key; it\n * writes `.tangle/api-key` with mode 0600.\n */\nexport function agentSignupScript(platformOrigin = TANGLE_PLATFORM_ORIGIN): string {\n // The specifier is interpolated so this module's own import scan (the\n // browser-safe subpath gate) does not read script text as an import.\n return `// Requests a scoped Tangle key for this agent. The owner approves once.\n// node tangle-signup.mjs start --app <app> --agent-name <name> [--owner-email <email>] [--budget-usd <n>]\n// node tangle-signup.mjs wait (run again while it exits 3; exits 0 once approved)\nimport { mkdirSync, readFileSync, writeFileSync } from ${JSON.stringify('node:fs')}\n\nconst command = process.argv[2]\nconst flag = (name) => {\n const index = process.argv.indexOf(\\`--\\${name}\\`)\n return index > 0 ? process.argv[index + 1] : undefined\n}\nconst platform = '${trimOrigin(platformOrigin)}'\nconst statePath = '.tangle/signup.json'\nmkdirSync('.tangle', { recursive: true, mode: 0o700 })\n\nasync function post(path, body) {\n const response = await fetch(platform + path, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify(body),\n })\n return { status: response.status, body: await response.json().catch(() => ({})) }\n}\n\nif (command === 'start') {\n const app = flag('app')\n if (!app) {\n console.error('Pass --app (for example --app sandbox)')\n process.exit(2)\n }\n const request = { app, agent_name: flag('agent-name') ?? 'coding-agent' }\n if (flag('owner-email')) request.owner_email = flag('owner-email')\n if (flag('budget-usd')) request.budget_usd = Number(flag('budget-usd'))\n const started = await post('/cross-site/device/start', request)\n if (started.status !== 200) {\n console.error(\\`Signup refused (HTTP \\${started.status}): \\${JSON.stringify(started.body)}\\`)\n process.exit(1)\n }\n const grant = started.body.data\n const saved = {\n app,\n device_code: grant.device_code,\n interval: grant.interval,\n expires_at: Date.now() + grant.expires_in * 1000,\n }\n writeFileSync(statePath, JSON.stringify(saved), { mode: 0o600 })\n console.log(grant.agent?.owner_notified\n ? \\`Approval email sent to \\${request.owner_email}.\\`\n : 'Send your owner this approval link.')\n console.log(\\`Approval link: \\${grant.verification_uri_complete}\\`)\n console.log(\\`Confirmation code: \\${grant.user_code} (expires in \\${Math.round(grant.expires_in / 60)} minutes)\\`)\n console.log('Next: run \\`node tangle-signup.mjs wait\\` until it prints Approved.')\n process.exit(0)\n}\n\nif (command === 'wait') {\n let saved\n try {\n saved = JSON.parse(readFileSync(statePath, 'utf8'))\n } catch {\n console.error('No pending signup. Run \\`node tangle-signup.mjs start\\` first.')\n process.exit(1)\n }\n const stopAt = Math.min(saved.expires_at, Date.now() + Number(flag('seconds') ?? 8) * 1000)\n for (;;) {\n const polled = await post('/cross-site/device/poll', { app: saved.app, device_code: saved.device_code })\n if (polled.status === 200) {\n const { api_key: apiKey, key, account } = polled.body.data\n writeFileSync('.tangle/api-key', \\`\\${apiKey}\\\\n\\`, { mode: 0o600 })\n console.log(\\`Approved. Key \"\\${key?.name ?? saved.app}\" saved to .tangle/api-key (spend cap $\\${key?.budget_usd ?? 'none'}).\\`)\n if (account && !account.funded) {\n console.log(\\`The owner's account has no credit yet. Ask the owner to add credits: \\${account.add_credits_url}\\`)\n }\n process.exit(0)\n }\n if (polled.status !== 428) {\n console.error(\\`Approval failed (HTTP \\${polled.status}): \\${JSON.stringify(polled.body)}\\`)\n process.exit(1)\n }\n if (Date.now() >= saved.expires_at) {\n console.error('The approval link expired. Run \\`node tangle-signup.mjs start\\` again.')\n process.exit(1)\n }\n if (Date.now() + saved.interval * 1000 > stopAt) {\n console.log('Still waiting for the owner to approve. Run \\`node tangle-signup.mjs wait\\` again.')\n process.exit(3)\n }\n await new Promise((resolve) => setTimeout(resolve, saved.interval * 1000))\n }\n}\n\nconsole.error('Usage: node tangle-signup.mjs start --app <app> --agent-name <name> [--owner-email <email>] | wait')\nprocess.exit(2)\n`\n}\n\nfunction signupSection(config: AgentSurfaceConfig): string[] {\n const env = config.apiKeyEnv\n if (config.signup.kind === 'manual') {\n return [\n '## 1. Get a key',\n '',\n 'This product does not yet support agent signup. Ask your owner to do the following, then continue:',\n '',\n ...config.signup.steps.map((step, index) => `${index + 1}. ${step}`),\n '',\n `Store the key outside version control and export it as \\`${env}\\`. Never print, log, or commit it.`,\n ]\n }\n const budget = config.signup.budgetUsd ?? 25\n return [\n '## 1. Get a scoped key (one owner approval)',\n '',\n 'Tangle issues each agent its own key, owned by a person who approves it once.',\n `Ask your owner which email address their Tangle account uses (or should use). Nothing is charged by signing up, and there is no free credit: ${config.name} work is paid from the owner's prepaid balance.`,\n '',\n 'Save this script as `tangle-signup.mjs` (Node.js 18 or newer, no dependencies):',\n '',\n fence({ language: 'js', code: agentSignupScript() }),\n '',\n 'Start the request with your own name and the owner\\'s email. It returns at once:',\n '',\n fence({\n language: 'bash',\n code: `node tangle-signup.mjs start --app ${config.signup.app} --agent-name \"<your agent name>\" --owner-email \"<owner email>\" --budget-usd ${budget}`,\n }),\n '',\n 'It prints the approval link and a confirmation code. Tangle emails the owner the same link; if you cannot give an email, omit `--owner-email` and send the owner the printed link yourself. Tell the owner the code if you can reach them.',\n '',\n 'Then wait for the approval. Each run returns within about 8 seconds: exit code 3 and `Still waiting` mean run it again; exit code 0 and `Approved` mean the key is saved. Keep each run short rather than wrapping it in one long blocking loop, since many agent tools stop long commands.',\n '',\n fence({ language: 'bash', code: 'node tangle-signup.mjs wait' }),\n '',\n 'What the owner does, once: sign in (or create an account and verify the email), check the confirmation code, and approve. That is the only human step.',\n '',\n `The key in \\`.tangle/api-key\\` (mode 600) can only be used for ${config.name}, can spend at most the cap you requested, and the owner can revoke it under Keys at any time. If \\`wait\\` says the account has no credit, ask the owner to add credits at the printed link before your first paid call.`,\n '',\n 'Then load the key without printing it, and keep it out of version control:',\n '',\n fence({\n language: 'bash',\n code: `export ${env}=\"$(cat .tangle/api-key)\"\\ngrep -qxF '.tangle/' .gitignore 2>/dev/null || echo '.tangle/' >> .gitignore`,\n }),\n '',\n 'Never print, log, paste, or commit the key.',\n ]\n}\n\nfunction stepsSection(heading: string, steps: AgentSurfaceStep[]): string[] {\n if (steps.length === 0) return []\n const lines = [heading, '']\n for (const step of steps) {\n lines.push(`${step.title}:`, '', fence(step), '', `Expected: ${step.expect}`, '')\n }\n return lines\n}\n\n/** The agent setup skill: valid SKILL.md and a plain copy-paste prompt. */\nexport function renderAgentSetupSkill(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n const description = `Set up ${config.name} for this agent end to end: get a scoped API key with one owner approval, install the client, make the first successful call, and verify it.`\n const lines: string[] = [\n '---',\n `name: tangle-${config.id}-setup`,\n `description: ${description}`,\n '---',\n '',\n `# Set up ${config.name}`,\n '',\n config.summary,\n '',\n 'Use it when:',\n '',\n ...config.useWhen.map((item) => `- ${item}`),\n '',\n 'Complete every step below in order and stop at the first failure; the error table at the end names the fix.',\n 'Prerequisites: ' + config.prerequisites.join('; ') + '.',\n '',\n ...signupSection(config),\n '',\n ...stepsSection('## 2. Install', config.install),\n ...stepsSection('## 3. Make the first call', config.firstCall),\n ...stepsSection('## 4. Verify it worked', config.verify),\n '## Common errors',\n '',\n '| Symptom | Cause | Fix |',\n '| --- | --- | --- |',\n ...config.errors.map(\n (error) => `| ${error.symptom.replace(/\\|/g, '\\\\|')} | ${error.cause.replace(/\\|/g, '\\\\|')} | ${error.fix.replace(/\\|/g, '\\\\|')} |`,\n ),\n '',\n '## Pricing',\n '',\n config.pricing.summary,\n ...(config.pricing.quoteUrl ? ['', `Current prices, no key needed: ${config.pricing.quoteUrl}`] : []),\n ...(config.pricing.url ? [`Pricing page: ${config.pricing.url}`] : []),\n '',\n '## Next',\n '',\n ...config.next.map((link) => `- [${link.label}](${link.url})`),\n '',\n '## Machine-readable surfaces',\n '',\n `- Agent manifest: ${origin}/.well-known/tangle-agent.json`,\n `- llms.txt: ${origin}/llms.txt`,\n `- This setup skill: ${origin}/agent-setup.md`,\n ...(config.openapi ? [`- OpenAPI: ${config.openapi}`] : []),\n ...(config.mcp ? [`- MCP server: ${config.mcp.url} (${config.mcp.auth})`] : []),\n '',\n ]\n return lines.join('\\n')\n}\n\n/** llms.txt index for the product. The setup skill is the first link. */\nexport function renderLlmsTxt(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n return [\n `# ${config.name}`,\n '',\n `> ${config.summary}`,\n '',\n `To set this product up from scratch, fetch ${origin}/agent-setup.md and follow it. It is a complete prompt and a SKILL.md: one owner approval, a scoped key, install, first call, verification.`,\n '',\n '## Start here',\n '',\n `- [Agent setup skill](${origin}/agent-setup.md): from nothing to a verified first call`,\n `- [Agent manifest](${origin}/.well-known/tangle-agent.json): machine-readable contract`,\n ...(config.openapi ? [`- [OpenAPI](${config.openapi}): HTTP API schema`] : []),\n ...(config.mcp ? [`- [MCP server](${config.mcp.url}): ${config.mcp.auth}`] : []),\n ...(config.docs ? [`- [Documentation](${config.docs})`] : []),\n '',\n '## Pricing',\n '',\n `- ${config.pricing.summary}`,\n ...(config.pricing.quoteUrl ? [`- [Machine-readable prices](${config.pricing.quoteUrl}): no key needed`] : []),\n '',\n '## Optional',\n '',\n ...config.next.map((link) => `- [${link.label}](${link.url})`),\n ...(config.related ?? []).map(\n (surface) => `- [${surface.name}](${surface.manifest ?? surface.url ?? ''})`,\n ),\n '',\n ].join('\\n')\n}\n\n/** Markdown for the product's home page, served for `Accept: text/markdown`. */\nexport function renderHomeMarkdown(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n return [\n `# ${config.name}`,\n '',\n config.summary,\n '',\n '## Use it when',\n '',\n ...config.useWhen.map((item) => `- ${item}`),\n '',\n '## Hand this to your agent',\n '',\n `An AI agent can set ${config.name} up by itself: fetch ${origin}/agent-setup.md and follow it. The owner approves once; nothing else needs a human.`,\n '',\n '## Pricing',\n '',\n config.pricing.summary,\n ...(config.pricing.quoteUrl ? ['', `Machine-readable prices: ${config.pricing.quoteUrl}`] : []),\n '',\n '## Machine-readable surfaces',\n '',\n `- ${origin}/llms.txt`,\n `- ${origin}/.well-known/tangle-agent.json`,\n `- ${origin}/agent-setup.md`,\n ...(config.openapi ? [`- ${config.openapi}`] : []),\n ...(config.mcp ? [`- ${config.mcp.url}`] : []),\n '',\n ].join('\\n')\n}\n\n/** The `/.well-known/tangle-agent.json` document. */\nexport function renderAgentManifest(config: AgentSurfaceConfig): Record<string, unknown> {\n const origin = trimOrigin(config.origin)\n const signup =\n config.signup.kind === 'device'\n ? {\n kind: 'device_authorization',\n app: config.signup.app,\n start: `POST ${TANGLE_PLATFORM_ORIGIN}/cross-site/device/start`,\n poll: `POST ${TANGLE_PLATFORM_ORIGIN}/cross-site/device/poll`,\n request: {\n app: config.signup.app,\n agent_name: 'string, 1-64 characters',\n owner_email: 'optional; Tangle emails this owner the approval link',\n budget_usd: `optional lifetime spend cap, 1-1000, default ${config.signup.budgetUsd ?? 25}`,\n },\n human_inputs: ['The owner approves the request once.'],\n key: {\n scope: `${config.signup.app} only`,\n revocable_at: `${TANGLE_PLATFORM_ORIGIN}/app/keys`,\n },\n payment: 'Prepaid credit on the owner account. No free credit; paid calls are refused until the owner adds credits.',\n add_credits: `${TANGLE_PLATFORM_ORIGIN}/app/billing`,\n }\n : { kind: 'manual', steps: config.signup.steps }\n return {\n ...config.manifest,\n schema_version: AGENT_MANIFEST_SCHEMA_VERSION,\n name: config.name,\n description: config.summary,\n homepage: `${origin}/`,\n llms: `${origin}/llms.txt`,\n agent_setup: `${origin}/agent-setup.md`,\n ...(config.docs ? { docs: config.docs } : {}),\n ...(config.openapi ? { openapi: config.openapi } : {}),\n ...(config.mcp ? { mcp: config.mcp } : {}),\n environment: { api_key: config.apiKeyEnv },\n signup,\n pricing: {\n summary: config.pricing.summary,\n ...(config.pricing.quoteUrl ? { quote: config.pricing.quoteUrl } : {}),\n ...(config.pricing.url ? { page: config.pricing.url } : {}),\n },\n ...(config.related?.length ? { related_surfaces: config.related } : {}),\n }\n}\n\n/** Every static surface as files, for products that ship them as assets. */\nexport function agentSurfaceFiles(config: AgentSurfaceConfig): AgentSurfaceFile[] {\n return [\n { path: 'agent-setup.md', contentType: MARKDOWN, body: renderAgentSetupSkill(config) },\n { path: 'llms.txt', contentType: 'text/plain; charset=utf-8', body: renderLlmsTxt(config) },\n { path: 'index.md', contentType: MARKDOWN, body: renderHomeMarkdown(config) },\n {\n path: '.well-known/tangle-agent.json',\n contentType: 'application/json; charset=utf-8',\n body: `${JSON.stringify(renderAgentManifest(config), null, 2)}\\n`,\n },\n ]\n}\n\n/**\n * True when `Accept` ranks `text/markdown` strictly above `text/html` and\n * gives it a nonzero weight. A browser's default header never does.\n */\nexport function prefersMarkdown(accept: string | null | undefined): boolean {\n if (!accept) return false\n let markdown = -1\n let html = -1\n for (const part of accept.split(',')) {\n const [rawType, ...params] = part.trim().split(';')\n const type = rawType?.trim().toLowerCase()\n let quality = 1\n for (const param of params) {\n const [key, value] = param.trim().split('=')\n if (key?.trim().toLowerCase() === 'q') {\n const parsed = Number(value)\n quality = Number.isFinite(parsed) ? parsed : 0\n }\n }\n if (type === 'text/markdown') markdown = Math.max(markdown, quality)\n if (type === 'text/html') html = Math.max(html, quality)\n }\n return markdown > 0 && markdown > html\n}\n\n/** A copy of `response` whose `Vary` includes `Accept`. */\nexport function withVaryAccept(response: Response): Response {\n const vary = response.headers.get('vary')\n if (vary && vary.split(',').some((value) => value.trim().toLowerCase() === 'accept')) {\n return response\n }\n const headers = new Headers(response.headers)\n headers.set('vary', vary ? `${vary}, Accept` : 'Accept')\n return new Response(response.body, {\n status: response.status,\n statusText: response.statusText,\n headers,\n })\n}\n\nexport interface AgentSurfaceHandler {\n /**\n * Answers a surface request (`/agent-setup.md`, `/llms.txt`, the manifest,\n * or a negotiated markdown page), or `null` to let the app answer it.\n */\n handle(request: Request): Response | null\n /** Adds `Vary: Accept` when the path has a markdown representation. */\n finalize(request: Request, response: Response): Response\n}\n\n/**\n * Request handler over {@link agentSurfaceFiles}. `markdownPages` maps extra\n * HTML paths to markdown served on negotiation; `/` always maps to the home\n * markdown.\n */\nexport function createAgentSurfaceHandler(\n config: AgentSurfaceConfig,\n options: { markdownPages?: Record<string, string> } = {},\n): AgentSurfaceHandler {\n const files = new Map(agentSurfaceFiles(config).map((file) => [`/${file.path}`, file]))\n const negotiated = new Map<string, string>([\n ['/', renderHomeMarkdown(config)],\n ...Object.entries(options.markdownPages ?? {}),\n ])\n\n function respond(body: string, contentType: string, method: string, vary: boolean): Response {\n const headers = new Headers({\n 'content-type': contentType,\n 'cache-control': 'public, max-age=300',\n 'x-content-type-options': 'nosniff',\n })\n if (vary) headers.set('vary', 'Accept')\n return new Response(method === 'HEAD' ? null : body, { status: 200, headers })\n }\n\n return {\n handle(request) {\n if (request.method !== 'GET' && request.method !== 'HEAD') return null\n const path = new URL(request.url).pathname\n const file = files.get(path)\n if (file) return respond(file.body, file.contentType, request.method, false)\n const markdown = negotiated.get(path)\n if (markdown !== undefined && prefersMarkdown(request.headers.get('accept'))) {\n return respond(markdown, MARKDOWN, request.method, true)\n }\n return null\n },\n finalize(request, response) {\n return negotiated.has(new URL(request.url).pathname) ? withVaryAccept(response) : response\n },\n }\n}\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/agent-surfaces/index.ts"],"sourcesContent":["/**\n * Machine-readable surfaces for a Tangle product, generated from one config.\n *\n * Every product publishes the same four things an AI agent needs to become a\n * customer without a human doing the setup:\n *\n * - `/agent-setup.md`: a SKILL.md (Claude Code and Codex skill format) that\n * doubles as a copy-paste prompt. It takes a fresh agent from nothing to a\n * verified first call: one owner approval, a scoped key, install, call.\n * - `/llms.txt`: the llms.txt index, pointing at the setup skill first.\n * - `/.well-known/tangle-agent.json`: the Tangle agent manifest.\n * - Markdown for `Accept: text/markdown` on the product's pages, with\n * `Vary: Accept` on both representations so caches keep them apart.\n *\n * The signup section is rendered here, not in product config, so every\n * product describes Platform's agent signup identically and cannot drift.\n *\n * Web-standard `Request`/`Response` only: safe in Workers, Node and browsers.\n */\n\n/** Manifest schema this module emits. Additive over the 2026-06-16 shape. */\nexport const AGENT_MANIFEST_SCHEMA_VERSION = '2026-10-09'\n\nexport const TANGLE_PLATFORM_ORIGIN = 'https://id.tangle.tools'\n\nexport interface AgentSurfaceStep {\n title: string\n /** Fence language for the code block. */\n language: 'bash' | 'js' | 'ts' | 'python' | 'json'\n code: string\n /** What a successful run prints or returns. */\n expect: string\n}\n\nexport interface AgentSurfaceError {\n symptom: string\n cause: string\n fix: string\n}\n\nexport interface AgentSurfaceLink {\n label: string\n url: string\n}\n\n/**\n * How an agent obtains a key. `device` uses Platform's agent signup: the owner\n * approves once and the agent receives its own capped, revocable key.\n */\nexport type AgentSignup =\n | {\n kind: 'device'\n /** Platform trusted-app id the key is minted for (`sandbox`, `router`). */\n app: string\n /** Default lifetime spend cap the skill asks for, in USD. */\n budgetUsd?: number\n }\n | {\n kind: 'manual'\n /** Numbered steps the owner performs; each one is a human input. */\n steps: string[]\n }\n\nexport interface AgentSurfaceConfig {\n /** Short id used in the skill name: `tangle-<id>-setup`. */\n id: string\n name: string\n /** Public HTTPS origin, no trailing slash. */\n origin: string\n /** What the product is for, in one to three plain sentences. */\n summary: string\n useWhen: string[]\n signup: AgentSignup\n /** Environment variable the key is exported as. */\n apiKeyEnv: string\n /** Runtime prerequisites a fresh machine needs, e.g. `Node.js 20 or newer`. */\n prerequisites: string[]\n install: AgentSurfaceStep[]\n firstCall: AgentSurfaceStep[]\n verify: AgentSurfaceStep[]\n errors: AgentSurfaceError[]\n pricing: {\n /** Plain statement of how usage is charged. */\n summary: string\n /** Public, credential-free price data an agent can quote from. */\n quoteUrl?: string\n url?: string\n }\n next: AgentSurfaceLink[]\n docs?: string\n openapi?: string\n mcp?: { url: string; auth: string }\n related?: Array<{ name: string; manifest?: string; url?: string }>\n /** Extra manifest fields a product already publishes (kept verbatim). */\n manifest?: Record<string, unknown>\n}\n\nexport interface AgentSurfaceFile {\n path: string\n contentType: string\n body: string\n}\n\nconst MARKDOWN = 'text/markdown; charset=utf-8'\n\nfunction trimOrigin(origin: string): string {\n return origin.replace(/\\/+$/, '')\n}\n\nfunction fence(step: Pick<AgentSurfaceStep, 'language' | 'code'>): string {\n return ['```' + step.language, step.code.trimEnd(), '```'].join('\\n')\n}\n\n/**\n * The signup script the skill tells an agent to save and run. Node 18+ only,\n * no dependencies. It never prints the key; it writes `.tangle/api-key` with\n * mode 0600 and reports whether the owner's account can pay yet.\n */\nexport function agentSignupScript(platformOrigin = TANGLE_PLATFORM_ORIGIN): string {\n // The specifier is interpolated so this module's own import scan (the\n // browser-safe subpath gate) does not read script text as an import.\n return `// Requests a scoped Tangle key for this agent. The owner approves once.\nimport { mkdirSync, writeFileSync } from ${JSON.stringify('node:fs')}\n\nconst flag = (name) => {\n const index = process.argv.indexOf(\\`--\\${name}\\`)\n return index > 0 ? process.argv[index + 1] : undefined\n}\nconst platform = '${trimOrigin(platformOrigin)}'\nconst app = flag('app')\nif (!app) throw new Error('Pass --app (for example --app sandbox)')\nconst request = { app, agent_name: flag('agent-name') ?? 'coding-agent' }\nif (flag('owner-email')) request.owner_email = flag('owner-email')\nif (flag('budget-usd')) request.budget_usd = Number(flag('budget-usd'))\n\nasync function post(path, body) {\n const response = await fetch(platform + path, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify(body),\n })\n return { status: response.status, body: await response.json().catch(() => ({})) }\n}\n\nconst started = await post('/cross-site/device/start', request)\nif (started.status !== 200) {\n console.error(\\`Signup refused (HTTP \\${started.status}): \\${JSON.stringify(started.body)}\\`)\n process.exit(1)\n}\nconst grant = started.body.data\nconsole.log(grant.agent?.owner_notified\n ? \\`Approval email sent to \\${request.owner_email}.\\`\n : 'Send your owner this approval link.')\nconsole.log(\\`Approval link: \\${grant.verification_uri_complete}\\`)\nconsole.log(\\`Confirmation code: \\${grant.user_code} (expires in \\${Math.round(grant.expires_in / 60)} minutes)\\`)\nconsole.log('Waiting for approval...')\n\nconst deadline = Date.now() + grant.expires_in * 1000\nwhile (Date.now() < deadline) {\n await new Promise((resolve) => setTimeout(resolve, grant.interval * 1000))\n const polled = await post('/cross-site/device/poll', { app, device_code: grant.device_code })\n if (polled.status === 428) continue\n if (polled.status !== 200) {\n console.error(\\`Approval failed (HTTP \\${polled.status}): \\${JSON.stringify(polled.body)}\\`)\n process.exit(1)\n }\n const { api_key: apiKey, key, account } = polled.body.data\n mkdirSync('.tangle', { recursive: true, mode: 0o700 })\n writeFileSync('.tangle/api-key', \\`\\${apiKey}\\\\n\\`, { mode: 0o600 })\n console.log(\\`Approved. Key \"\\${key?.name ?? app}\" saved to .tangle/api-key (spend cap $\\${key?.budget_usd ?? 'none'}).\\`)\n if (account && !account.funded) {\n console.log(\\`The owner's account has no credit yet. Ask the owner to add credits: \\${account.add_credits_url}\\`)\n }\n process.exit(0)\n}\nconsole.error('The approval link expired. Run this script again.')\nprocess.exit(1)\n`\n}\n\nfunction signupSection(config: AgentSurfaceConfig): string[] {\n const env = config.apiKeyEnv\n if (config.signup.kind === 'manual') {\n return [\n '## 1. Get a key',\n '',\n 'This product does not yet support agent signup. Ask your owner to do the following, then continue:',\n '',\n ...config.signup.steps.map((step, index) => `${index + 1}. ${step}`),\n '',\n `Store the key outside version control and export it as \\`${env}\\`. Never print, log, or commit it.`,\n ]\n }\n const budget = config.signup.budgetUsd ?? 25\n return [\n '## 1. Get a scoped key (one owner approval)',\n '',\n 'Tangle issues each agent its own key, owned by a person who approves it once.',\n `Ask your owner which email address their Tangle account uses (or should use). Nothing is charged by signing up, and there is no free credit: ${config.name} work is paid from the owner's prepaid balance.`,\n '',\n 'Save this script as `tangle-signup.mjs` (Node.js 18 or newer, no dependencies):',\n '',\n fence({ language: 'js', code: agentSignupScript() }),\n '',\n 'Run it with your own name and the owner\\'s email:',\n '',\n fence({\n language: 'bash',\n code: `node tangle-signup.mjs --app ${config.signup.app} --agent-name \"<your agent name>\" --owner-email \"<owner email>\" --budget-usd ${budget}`,\n }),\n '',\n 'What happens:',\n '',\n `1. Tangle emails the owner a one-time approval link. If you cannot give an email, omit \\`--owner-email\\` and send the owner the printed link yourself.`,\n '2. The owner signs in (or creates an account and verifies the email), checks the confirmation code, and approves. That is the only human step.',\n `3. The script writes the key to \\`.tangle/api-key\\` (mode 600). It can only be used for ${config.name}, it can spend at most the cap you requested, and the owner can revoke it under Keys at any time.`,\n '4. If the script says the account has no credit, ask the owner to add credits at the printed link before your first paid call.',\n '',\n 'Then load the key without printing it, and keep it out of version control:',\n '',\n fence({\n language: 'bash',\n code: `export ${env}=\"$(cat .tangle/api-key)\"\\ngrep -qxF '.tangle/' .gitignore 2>/dev/null || echo '.tangle/' >> .gitignore`,\n }),\n '',\n 'Never print, log, paste, or commit the key.',\n ]\n}\n\nfunction stepsSection(heading: string, steps: AgentSurfaceStep[]): string[] {\n if (steps.length === 0) return []\n const lines = [heading, '']\n for (const step of steps) {\n lines.push(`${step.title}:`, '', fence(step), '', `Expected: ${step.expect}`, '')\n }\n return lines\n}\n\n/** The agent setup skill: valid SKILL.md and a plain copy-paste prompt. */\nexport function renderAgentSetupSkill(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n const description = `Set up ${config.name} for this agent end to end: get a scoped API key with one owner approval, install the client, make the first successful call, and verify it.`\n const lines: string[] = [\n '---',\n `name: tangle-${config.id}-setup`,\n `description: ${description}`,\n '---',\n '',\n `# Set up ${config.name}`,\n '',\n config.summary,\n '',\n 'Use it when:',\n '',\n ...config.useWhen.map((item) => `- ${item}`),\n '',\n 'Complete every step below in order and stop at the first failure; the error table at the end names the fix.',\n 'Prerequisites: ' + config.prerequisites.join('; ') + '.',\n '',\n ...signupSection(config),\n '',\n ...stepsSection('## 2. Install', config.install),\n ...stepsSection('## 3. Make the first call', config.firstCall),\n ...stepsSection('## 4. Verify it worked', config.verify),\n '## Common errors',\n '',\n '| Symptom | Cause | Fix |',\n '| --- | --- | --- |',\n ...config.errors.map(\n (error) => `| ${error.symptom.replace(/\\|/g, '\\\\|')} | ${error.cause.replace(/\\|/g, '\\\\|')} | ${error.fix.replace(/\\|/g, '\\\\|')} |`,\n ),\n '',\n '## Pricing',\n '',\n config.pricing.summary,\n ...(config.pricing.quoteUrl ? ['', `Current prices, no key needed: ${config.pricing.quoteUrl}`] : []),\n ...(config.pricing.url ? [`Pricing page: ${config.pricing.url}`] : []),\n '',\n '## Next',\n '',\n ...config.next.map((link) => `- [${link.label}](${link.url})`),\n '',\n '## Machine-readable surfaces',\n '',\n `- Agent manifest: ${origin}/.well-known/tangle-agent.json`,\n `- llms.txt: ${origin}/llms.txt`,\n `- This setup skill: ${origin}/agent-setup.md`,\n ...(config.openapi ? [`- OpenAPI: ${config.openapi}`] : []),\n ...(config.mcp ? [`- MCP server: ${config.mcp.url} (${config.mcp.auth})`] : []),\n '',\n ]\n return lines.join('\\n')\n}\n\n/** llms.txt index for the product. The setup skill is the first link. */\nexport function renderLlmsTxt(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n return [\n `# ${config.name}`,\n '',\n `> ${config.summary}`,\n '',\n `To set this product up from scratch, fetch ${origin}/agent-setup.md and follow it. It is a complete prompt and a SKILL.md: one owner approval, a scoped key, install, first call, verification.`,\n '',\n '## Start here',\n '',\n `- [Agent setup skill](${origin}/agent-setup.md): from nothing to a verified first call`,\n `- [Agent manifest](${origin}/.well-known/tangle-agent.json): machine-readable contract`,\n ...(config.openapi ? [`- [OpenAPI](${config.openapi}): HTTP API schema`] : []),\n ...(config.mcp ? [`- [MCP server](${config.mcp.url}): ${config.mcp.auth}`] : []),\n ...(config.docs ? [`- [Documentation](${config.docs})`] : []),\n '',\n '## Pricing',\n '',\n `- ${config.pricing.summary}`,\n ...(config.pricing.quoteUrl ? [`- [Machine-readable prices](${config.pricing.quoteUrl}): no key needed`] : []),\n '',\n '## Optional',\n '',\n ...config.next.map((link) => `- [${link.label}](${link.url})`),\n ...(config.related ?? []).map(\n (surface) => `- [${surface.name}](${surface.manifest ?? surface.url ?? ''})`,\n ),\n '',\n ].join('\\n')\n}\n\n/** Markdown for the product's home page, served for `Accept: text/markdown`. */\nexport function renderHomeMarkdown(config: AgentSurfaceConfig): string {\n const origin = trimOrigin(config.origin)\n return [\n `# ${config.name}`,\n '',\n config.summary,\n '',\n '## Use it when',\n '',\n ...config.useWhen.map((item) => `- ${item}`),\n '',\n '## Hand this to your agent',\n '',\n `An AI agent can set ${config.name} up by itself: fetch ${origin}/agent-setup.md and follow it. The owner approves once; nothing else needs a human.`,\n '',\n '## Pricing',\n '',\n config.pricing.summary,\n ...(config.pricing.quoteUrl ? ['', `Machine-readable prices: ${config.pricing.quoteUrl}`] : []),\n '',\n '## Machine-readable surfaces',\n '',\n `- ${origin}/llms.txt`,\n `- ${origin}/.well-known/tangle-agent.json`,\n `- ${origin}/agent-setup.md`,\n ...(config.openapi ? [`- ${config.openapi}`] : []),\n ...(config.mcp ? [`- ${config.mcp.url}`] : []),\n '',\n ].join('\\n')\n}\n\n/** The `/.well-known/tangle-agent.json` document. */\nexport function renderAgentManifest(config: AgentSurfaceConfig): Record<string, unknown> {\n const origin = trimOrigin(config.origin)\n const signup =\n config.signup.kind === 'device'\n ? {\n kind: 'device_authorization',\n app: config.signup.app,\n start: `POST ${TANGLE_PLATFORM_ORIGIN}/cross-site/device/start`,\n poll: `POST ${TANGLE_PLATFORM_ORIGIN}/cross-site/device/poll`,\n request: {\n app: config.signup.app,\n agent_name: 'string, 1-64 characters',\n owner_email: 'optional; Tangle emails this owner the approval link',\n budget_usd: `optional lifetime spend cap, 1-1000, default ${config.signup.budgetUsd ?? 25}`,\n },\n human_inputs: ['The owner approves the request once.'],\n key: {\n scope: `${config.signup.app} only`,\n revocable_at: `${TANGLE_PLATFORM_ORIGIN}/app/keys`,\n },\n payment: 'Prepaid credit on the owner account. No free credit; paid calls are refused until the owner adds credits.',\n add_credits: `${TANGLE_PLATFORM_ORIGIN}/app/billing`,\n }\n : { kind: 'manual', steps: config.signup.steps }\n return {\n ...config.manifest,\n schema_version: AGENT_MANIFEST_SCHEMA_VERSION,\n name: config.name,\n description: config.summary,\n homepage: `${origin}/`,\n llms: `${origin}/llms.txt`,\n agent_setup: `${origin}/agent-setup.md`,\n ...(config.docs ? { docs: config.docs } : {}),\n ...(config.openapi ? { openapi: config.openapi } : {}),\n ...(config.mcp ? { mcp: config.mcp } : {}),\n environment: { api_key: config.apiKeyEnv },\n signup,\n pricing: {\n summary: config.pricing.summary,\n ...(config.pricing.quoteUrl ? { quote: config.pricing.quoteUrl } : {}),\n ...(config.pricing.url ? { page: config.pricing.url } : {}),\n },\n ...(config.related?.length ? { related_surfaces: config.related } : {}),\n }\n}\n\n/** Every static surface as files, for products that ship them as assets. */\nexport function agentSurfaceFiles(config: AgentSurfaceConfig): AgentSurfaceFile[] {\n return [\n { path: 'agent-setup.md', contentType: MARKDOWN, body: renderAgentSetupSkill(config) },\n { path: 'llms.txt', contentType: 'text/plain; charset=utf-8', body: renderLlmsTxt(config) },\n { path: 'index.md', contentType: MARKDOWN, body: renderHomeMarkdown(config) },\n {\n path: '.well-known/tangle-agent.json',\n contentType: 'application/json; charset=utf-8',\n body: `${JSON.stringify(renderAgentManifest(config), null, 2)}\\n`,\n },\n ]\n}\n\n/**\n * True when `Accept` ranks `text/markdown` strictly above `text/html` and\n * gives it a nonzero weight. A browser's default header never does.\n */\nexport function prefersMarkdown(accept: string | null | undefined): boolean {\n if (!accept) return false\n let markdown = -1\n let html = -1\n for (const part of accept.split(',')) {\n const [rawType, ...params] = part.trim().split(';')\n const type = rawType?.trim().toLowerCase()\n let quality = 1\n for (const param of params) {\n const [key, value] = param.trim().split('=')\n if (key?.trim().toLowerCase() === 'q') {\n const parsed = Number(value)\n quality = Number.isFinite(parsed) ? parsed : 0\n }\n }\n if (type === 'text/markdown') markdown = Math.max(markdown, quality)\n if (type === 'text/html') html = Math.max(html, quality)\n }\n return markdown > 0 && markdown > html\n}\n\n/** A copy of `response` whose `Vary` includes `Accept`. */\nexport function withVaryAccept(response: Response): Response {\n const vary = response.headers.get('vary')\n if (vary && vary.split(',').some((value) => value.trim().toLowerCase() === 'accept')) {\n return response\n }\n const headers = new Headers(response.headers)\n headers.set('vary', vary ? `${vary}, Accept` : 'Accept')\n return new Response(response.body, {\n status: response.status,\n statusText: response.statusText,\n headers,\n })\n}\n\nexport interface AgentSurfaceHandler {\n /**\n * Answers a surface request (`/agent-setup.md`, `/llms.txt`, the manifest,\n * or a negotiated markdown page), or `null` to let the app answer it.\n */\n handle(request: Request): Response | null\n /** Adds `Vary: Accept` when the path has a markdown representation. */\n finalize(request: Request, response: Response): Response\n}\n\n/**\n * Request handler over {@link agentSurfaceFiles}. `markdownPages` maps extra\n * HTML paths to markdown served on negotiation; `/` always maps to the home\n * markdown.\n */\nexport function createAgentSurfaceHandler(\n config: AgentSurfaceConfig,\n options: { markdownPages?: Record<string, string> } = {},\n): AgentSurfaceHandler {\n const files = new Map(agentSurfaceFiles(config).map((file) => [`/${file.path}`, file]))\n const negotiated = new Map<string, string>([\n ['/', renderHomeMarkdown(config)],\n ...Object.entries(options.markdownPages ?? {}),\n ])\n\n function respond(body: string, contentType: string, method: string, vary: boolean): Response {\n const headers = new Headers({\n 'content-type': contentType,\n 'cache-control': 'public, max-age=300',\n 'x-content-type-options': 'nosniff',\n })\n if (vary) headers.set('vary', 'Accept')\n return new Response(method === 'HEAD' ? null : body, { status: 200, headers })\n }\n\n return {\n handle(request) {\n if (request.method !== 'GET' && request.method !== 'HEAD') return null\n const path = new URL(request.url).pathname\n const file = files.get(path)\n if (file) return respond(file.body, file.contentType, request.method, false)\n const markdown = negotiated.get(path)\n if (markdown !== undefined && prefersMarkdown(request.headers.get('accept'))) {\n return respond(markdown, MARKDOWN, request.method, true)\n }\n return null\n },\n finalize(request, response) {\n return negotiated.has(new URL(request.url).pathname) ? withVaryAccept(response) : response\n },\n }\n}\n"],"mappings":"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","names":[]}
|