@profullstack/agenticjobs 0.11.0 → 0.14.0

package/README.md

@@ -120,6 +120,12 @@ The convention is [OpenResume.md](docs/openresume.md). The listing format is
 [OpenJob](docs/openjob.md). Both are conventions anyone can implement, and neither
 requires this software.
 
+The same rule holds for every other box on the board. A listing description, an
+employer profile, a cover letter, a message, an invoice description, an update and a
+recommendation all take plain text or Markdown, and each is shown rendered: paste an
+email and it reads as written, paste a bullet list and it is a list. Nothing anyone
+types ever becomes a tag.
+
 ## Run your own
 
 ```bash
@@ -227,7 +233,8 @@ agenticjobs submit <id>                               # you decide
 
 # hiring, on the same account
 agenticjobs post job.md --org acme                    # creates a draft
-agenticjobs publish staff-engineer                    # you decide
+agenticjobs post job.md --org acme --pay "$0.25 per task" --pay-method SOL
+agenticjobs publish staff-engineer                    # you decide; it has to say what it pays
 agenticjobs applications staff-engineer
 agenticjobs decide <id> hired                         # reviewing, rejected or hired
 ```
@@ -240,6 +247,68 @@ Sign-in is the device flow: the terminal shows a short code, you approve it in a
 browser, and no credential crosses the terminal. A terminal token can read and apply
 and is never an administrator.
 
+## Recommendations, not ratings
+
+A star out of five from a stranger who paid you once is a number that says nothing
+and cannot be answered; it is what turns a profile into a scoreboard. This board does
+what LinkedIn does instead: a recommendation is a paragraph with a name on it, from an
+employer who hired you or a person you hired, and it goes on your page only when you
+approve it. Reject it and nothing is shown, to anybody. You can take one down later.
+
+Both directions, because the board is symmetric: an employer recommends a candidate,
+and a candidate recommends an employer. The author has to have a page, a published
+resume or an employer they post for, so a recommendation from an account made this
+morning is not accepted. One per author per subject; writing again replaces it and
+asks for approval again. Ten a day.
+
+```bash
+agenticjobs recommend ada-lovelace --candidate --as acme \
+  --relationship "hired her for a three-month contract" \
+  "Shipped the whole thing two weeks early and wrote the docs nobody asked for."
+agenticjobs recommend acme "Paid on time, every time, and the brief was the brief."
+agenticjobs recommendations                  # waiting for you, about you, by you
+agenticjobs recommendations approve <id>
+```
+
+The same over the API (`/api/v1/candidates/{slug}/recommendations`,
+`/api/v1/orgs/{slug}/recommendations`, `/api/v1/me/recommendations`) and MCP
+(`recommend`, `list_recommendations`, `decide_recommendation`), so an agent can draft
+one for a person to send, and a person's agent can read what is waiting for them.
+
+## What it pays
+
+A listing has to say what it pays before it can be published. "Unpaid" counts, because
+it is an answer; silence does not. A listing that says nothing about pay gets fewer and
+worse applications, and an agent reading it cannot tell whether to bother.
+
+The vocabulary is [ugig.net](https://ugig.net)'s, because the work this board is for is
+not always a salary: per task, per pull request, per social post, a flat fee, a share of
+revenue, a bounty, in dollars or in a coin, settled in whatever the two sides agree on.
+You write each price the way you would say it, one per line, anywhere a listing is
+written: the form, the API, the job file, the MCP tool.
+
+```
+$120k - $150k a year
+$0.25 per task
+$0.25 per PR that fixes a bug you find
+0.01 SOL per task
+$5000 fixed
+10% revenue share
+```
+
+```yaml
+# in a job file
+pay:
+  - $0.25 per task
+  - $0.25 per PR that fixes a bug you find
+pay_method: SOL
+```
+
+The settlement method is separate from the price: "$100 an hour paid in USDC" is one
+rate with a preference, not two. It is a coin (`SOL`, `USDC`, `ETH`, `USDT`, `POL`) or a
+rail (`bank transfer`, `PayPal`, `payroll`). The full shape is in
+[the OpenJob spec](docs/openjob.md#pay).
+
 ## Updates
 
 Between "posted a job" and silence there is the rest of it: a role filled, something
@@ -271,6 +340,72 @@ author, and the same text twice is refused. 600 characters and one link, rendere
 text and marked `nofollow`, because a board with an open posting form is a link farm
 the moment it passes PageRank on.
 
+## Inbox, and invoices
+
+There is no public comment box anywhere on the board. A board with one gets used as
+the place to hand in invoices, because an invoice has to go somewhere and a comment
+under a listing was the only somewhere. So reaching somebody here is private: a
+conversation between you and a candidate, or you and an employer, and nobody else.
+Writing to an employer reaches every member of it.
+
+```bash
+agenticjobs message acme "Is the Go role open to contractors?" --job senior-go-engineer
+agenticjobs message jane-doe --candidate "Saw your resume. Free for a call this week?"
+agenticjobs inbox                          # your conversations
+agenticjobs inbox read <id>                # one, with its invoices
+agenticjobs reply <id> "Thursday works."
+```
+
+The button is on every candidate's and every employer's page, and on a listing. Twenty
+new conversations a day per account; replies are not counted. The other side is
+emailed that there is a message, never the message itself: the conversation is private
+to the people in it and somebody else's mail server is not.
+
+An invoice is a message with money attached. The payee sends it from the conversation,
+in US dollars, choosing a chain they hold a wallet for; the other side presses Pay and
+settles it on [CoinPay](https://coinpayportal.com), straight to that wallet. The board
+never holds the money.
+
+```bash
+agenticjobs billing                        # is a CoinPay account connected?
+agenticjobs invoice <thread-id> 1200 --currency USDC_POL --for "Sprint 3, as agreed"
+agenticjobs invoices                       # sent and received
+agenticjobs pay <invoice-id>               # a quote, and the page to pay on
+```
+
+Connecting a CoinPay account is a browser step (`/me`, Billing, Connect CoinPay): it is
+CoinPay's consent screen, asking for `wallet:read` and nothing else. The board reads
+which wallets you can be paid to and uses the token for nothing else; it cannot move
+funds or create anything on your account.
+
+### Turning billing on
+
+Billing is off until the operator gives the board its own CoinPay credentials. Two
+sets, because two jobs: an OAuth client so *people* can connect their accounts, and a
+business key so the *board* can mint the payment a payer settles. All four or none;
+a partial set is logged at boot and leaves billing off rather than half on.
+
+```bash
+COINPAY_CLIENT_ID=cp_...          # coinpay oauth create --name your-board \
+COINPAY_CLIENT_SECRET=cps_...     #   --redirect-uri https://your-board/api/v1/coinpay/callback \
+                                  #   --scope openid,profile,email,wallet:read
+COINPAY_API_KEY=cp_live_...       # coinpay business create --name your-board \
+COINPAY_BUSINESS_ID=...           #   --category marketplace \
+COINPAY_WEBHOOK_SECRET=whsec_...  #   --webhook-url https://your-board/api/v1/coinpay/webhook
+COINPAY_URL=https://coinpayportal.com   # optional
+```
+
+The redirect URI has to be registered on the OAuth client byte for byte, and the
+client has to be registered for `wallet:read`: CoinPay narrows a grant to the client's
+registered scopes without an error, and a board that trusts its own request shows
+"Connected" beside an account it cannot read a wallet from. The board checks the scope
+on the token it got back, and says "Reconnect required" when it is missing.
+
+Payment is confirmed by CoinPay's webhook, and by asking CoinPay whenever the
+conversation is opened, so a lost webhook delays the answer rather than losing it.
+Without `COINPAY_WEBHOOK_SECRET` every webhook is refused and polling is the only
+source, which works and is slower.
+
 ## Posting from myna
 
 A job opening goes out with the rest of a launch:

package/dist/cli/args.js

@@ -100,7 +100,9 @@ export function flagString(args, ...names) {
 }
 export function flagBool(args, ...names) {
     for (const name of names) {
-        const value = args.flags[name];
+        const raw = args.flags[name];
+        // Repeated options use their last value, just like flagString.
+        const value = Array.isArray(raw) ? raw[raw.length - 1] : raw;
         if (value === true)
             return true;
         if (typeof value === 'string')
@@ -123,7 +125,7 @@ export function flagNumber(args, ...names) {
     const raw = flagString(args, ...names);
     if (raw === undefined)
         return undefined;
-    const parsed = Number.parseInt(raw, 10);
+    const parsed = Number(raw);
     return Number.isFinite(parsed) ? parsed : undefined;
 }
 //# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -18,7 +18,8 @@ import { bold, dim } from "./format.js";
 import { installLine, update as runUpdate, uninstall as runUninstall, whereIsIt } from "./manage.js";
 import { ApiError, BoardClient, configuredBoards, currentBoard, DEFAULT_SERVER, forgetBoard, loadConfig, login, LoginError, normaliseServer, rememberBoard, saveConfig, searchEverywhere, } from "../client/index.js";
 import { VERSION } from "../config.js";
-import { ago, formatSalary } from "../schema/text.js";
+import { ago } from "../schema/text.js";
+import { formatMethod, formatPay, formatPayShort, payOfJob } from "../schema/pay.js";
 import { APPLICATION_DECISIONS, isApplicationDecision } from "../schema/job.js";
 // The vocabulary, not the storage: core/resumes.ts is pure apart from a type
 // import of pg, so the CLI can name the same three values the server does
@@ -71,6 +72,27 @@ const USAGE = `agenticjobs ${VERSION} - an agent-friendly job board you can self
     follow <slug>             follow an employer; --candidate for a person
     unfollow <slug>           stop
 
+  Recommendations
+    recommend <slug> <text>   recommend an employer; --candidate for a person
+      --as <employer-slug>      ...from an employer you post for
+      --relationship <text>     "hired them for a three-month contract"
+    recommendations           about you, and what you wrote
+    recommendations approve|reject|withdraw <id>
+
+  Inbox
+    inbox                     your conversations
+    inbox read <id>           one conversation, and its invoices
+    message <slug> <text>     write to an employer; --candidate for a person
+      --job <slug>              about a listing
+      --as <employer-slug>      write as an employer you belong to
+      --subject <text>
+    reply <id> <text>         reply in a conversation
+    invoice <id> <amount>     bill the other side, in USD; --currency <chain>
+      --for <text>              what it is for
+    invoices                  every invoice you sent or can pay
+    pay <invoice-id>          get a quote and the CoinPay page to pay on
+    billing                   whether your CoinPay account is connected
+
   Hiring
     employer list             the employers you can post under
     employer show <slug>
@@ -78,12 +100,16 @@ const USAGE = `agenticjobs ${VERSION} - an agent-friendly job board you can self
     employer update <slug>    [--name n] [--website u] [--description d]
     employer delete <slug> --yes
     post <file.md>            post a job; stays a draft until you publish
+      --pay "<line>"            what it pays, repeatable: "$0.25 per task",
+                              "$120k - $150k a year", "$5000 fixed"
+      --pay-method <how>        SOL, USDC, bank transfer, PayPal, payroll
+      --unpaid                  the role pays nothing, said out loud
     new <url>                 import a job from a URL, as a draft
     update <url>              re-read that URL into the listing it created
       --slug <slug>             ...adopting a listing that was written by hand
                               (with no URL, updates this install instead)
     edit <slug> <file.md>     rewrite a listing, keeping its URL
-    publish <slug>            take a draft live
+    publish <slug>            take a draft live (it has to say what it pays)
     close <slug>              close a listing
     applications <slug>       what came in
     decide <id> <status>      reviewing, rejected or hired
@@ -275,9 +301,27 @@ async function run(args) {
             return commandDecide(args);
         case 'news':
             return commandNews(args);
+        case 'recommend':
+            return commandRecommend(args);
+        case 'recommendations':
+            return commandRecommendations(args);
         case 'follow':
         case 'unfollow':
             return commandFollow(args);
+        case 'inbox':
+            return commandInbox(args);
+        case 'message':
+            return commandMessage(args);
+        case 'reply':
+            return commandReply(args);
+        case 'invoice':
+            return commandInvoice(args);
+        case 'invoices':
+            return commandInvoices(args);
+        case 'pay':
+            return commandPay(args);
+        case 'billing':
+            return commandBilling(args);
         case 'announce':
             return commandAnnounce(args);
         case 'instances':
@@ -343,7 +387,7 @@ function queryFrom(args) {
     return query;
 }
 function jobLine(job, where) {
-    const salary = formatSalary(job.salary);
+    const salary = formatPayShort(payOfJob(job));
     const bits = [job.workplace, job.seniority, job.location, salary, `agents: ${job.agentPolicy}`]
         .filter((bit) => typeof bit === 'string' && bit !== '');
     return [
@@ -559,9 +603,12 @@ async function commandShow(args) {
     const lines = [
         bold(job.title),
         `${job.org.name}${job.location === null ? '' : ` - ${job.location}`}`,
-        dim([job.workplace, job.employmentType, job.seniority, formatSalary(job.salary), `agents: ${job.agentPolicy}`]
+        dim([job.workplace, job.employmentType, job.seniority, `agents: ${job.agentPolicy}`]
             .filter((bit) => typeof bit === 'string' && bit !== '')
             .join(' | ')),
+        `Pay: ${[formatPay(payOfJob(job)) ?? 'not listed', formatMethod(payOfJob(job).method)]
+            .filter((bit) => bit !== null)
+            .join(', ')}`,
         '',
         job.description,
         '',
@@ -972,6 +1019,8 @@ async function commandPost(args) {
         'salaryMax',
         'salaryCurrency',
         'salaryPeriod',
+        'payMethod',
+        'payEquity',
         'tags',
         'stack',
         'agentPolicy',
@@ -980,10 +1029,18 @@ async function commandPost(args) {
         if (value !== undefined)
             input[key] = value;
     }
+    // `--pay "$0.25 per task" --pay "$0.25 per PR"`: one flag per line, the way
+    // the front matter's `pay:` list arrives. Repeated flags accumulate.
+    const payLines = flagList(args, 'pay');
+    if (payLines.length > 0)
+        input['pay'] = payLines;
+    const payMethod = flagString(args, 'pay-method', 'paid-in');
+    if (payMethod !== undefined)
+        input['payMethod'] = payMethod;
     // A flag rather than a value, because "unpaid" is a fact about the role and
     // not a number. `salary_unpaid: true` in front matter already arrives on its
     // own, camel-cased with every other key.
-    if (flagBool(args, 'salary-unpaid'))
+    if (flagBool(args, 'salary-unpaid', 'unpaid'))
         input['salaryUnpaid'] = true;
     if (input['org'] === undefined) {
         process.stderr.write('Which employer? Pass --org <slug>, or put "org:" in the front matter.\n');
@@ -1090,6 +1147,50 @@ async function commandNews(args) {
     ].join('\n'));
     return out(args, lines.join('\n\n'), result);
 }
+async function commandRecommend(args) {
+    const slug = args.positional[0] ?? '';
+    const body = args.positional.slice(1).join(' ').trim();
+    if (slug === '' || body === '') {
+        process.stderr.write('agenticjobs recommend <employer-slug> "what you would say" [--candidate] [--as employer]\n');
+        return 1;
+    }
+    const as = flagString(args, 'as');
+    const relationship = flagString(args, 'relationship');
+    const written = await clientFor(args).recommend(flagBool(args, 'candidate') ? { candidate: slug } : { org: slug }, {
+        body,
+        ...(as === undefined ? {} : { as }),
+        ...(relationship === undefined ? {} : { relationship }),
+    });
+    return out(args, `Written, from ${written.recommendation.author.name}. It is pending until ${written.recommendation.subject.name} approves it.`, written);
+}
+async function commandRecommendations(args) {
+    const client = clientFor(args);
+    const verb = args.positional[0] ?? '';
+    if (verb === 'approve' || verb === 'reject' || verb === 'withdraw') {
+        const id = args.positional[1] ?? '';
+        if (id === '') {
+            process.stderr.write(`Which one? agenticjobs recommendations ${verb} <id>\n`);
+            return 1;
+        }
+        const result = await client.decideRecommendation(id, verb);
+        return out(args, verb === 'withdraw' ? 'Withdrawn.' : `Now ${result.recommendation?.status ?? verb}.`, result);
+    }
+    const mine = await client.myRecommendations();
+    if (mine.received.length === 0 && mine.given.length === 0) {
+        return out(args, 'None yet, in either direction.', mine);
+    }
+    const line = (item, about) => [
+        `${item.status === 'pending' ? bold('* ') : '  '}${bold(about ? item.author.name : item.subject.name)}  ${dim(`[${item.status}]`)}`,
+        `    ${item.body.slice(0, 160).replace(/\n/g, ' ')}`,
+        `    ${dim(item.id)}`,
+    ].join('\n');
+    const lines = [
+        `${mine.pending} waiting for you`,
+        ...(mine.received.length > 0 ? ['', bold('About you'), ...mine.received.map((item) => line(item, true))] : []),
+        ...(mine.given.length > 0 ? ['', bold('You wrote'), ...mine.given.map((item) => line(item, false))] : []),
+    ];
+    return out(args, lines.join('\n'), mine);
+}
 async function commandFollow(args) {
     const following = args.command === 'follow';
     const candidate = flagBool(args, 'candidate');
@@ -1101,6 +1202,127 @@ async function commandFollow(args) {
     const result = await clientFor(args).setFollow(candidate ? { candidate: slug } : { org: slug }, following);
     return out(args, `${following ? 'Following' : 'Not following'} ${slug}. ${result.followers} ${result.followers === 1 ? 'follower' : 'followers'}.`, result);
 }
+// --- inbox ----------------------------------------------------------------
+async function commandInbox(args) {
+    const client = clientFor(args);
+    if (args.positional[0] === 'read') {
+        const id = args.positional[1] ?? '';
+        if (id === '') {
+            process.stderr.write('Which one? agenticjobs inbox read <id>\n');
+            return 1;
+        }
+        const result = await client.thread(id);
+        const lines = result.thread.messages.map((message) => [
+            `${bold(message.mine ? 'You' : message.sender.name)} ${dim(ago(message.createdAt))}${message.kind === 'invoice' ? dim(' (invoice)') : ''}`,
+            `  ${message.body.replace(/\n/g, '\n  ')}`,
+        ].join('\n'));
+        const invoices = result.invoices.map((invoice) => `  ${invoice.id}  $${invoice.amountUsd} ${invoice.currency}  ${invoice.status}`);
+        return out(args, [
+            `${bold(result.thread.subject)} ${dim(`with ${result.thread.with.name}`)}`,
+            '',
+            lines.join('\n\n'),
+            ...(invoices.length === 0 ? [] : ['', bold('Invoices'), ...invoices]),
+        ].join('\n'), result);
+    }
+    const result = await client.inbox();
+    if (result.items.length === 0)
+        return out(args, 'Nothing in the inbox.', result);
+    const lines = result.items.map((thread) => [
+        `${bold(thread.with.name)} ${dim(ago(thread.lastMessageAt))}${thread.unread > 0 ? ` ${bold(`${thread.unread} new`)}` : ''}`,
+        `  ${thread.subject}`,
+        `  ${dim(thread.preview)}`,
+        `  ${dim(thread.id)}`,
+    ].join('\n'));
+    return out(args, lines.join('\n\n'), result);
+}
+async function commandMessage(args) {
+    const slug = args.positional[0] ?? '';
+    const body = args.positional.slice(1).join(' ');
+    if (slug === '' || body === '') {
+        process.stderr.write('agenticjobs message <employer-slug> <text> [--candidate] [--job <slug>] [--as <employer>]\n');
+        return 1;
+    }
+    const candidate = flagBool(args, 'candidate');
+    const job = flagString(args, 'job');
+    const as = flagString(args, 'as');
+    const subject = flagString(args, 'subject');
+    const result = await clientFor(args).startThread({
+        ...(candidate ? { candidate: slug } : { employer: slug }),
+        ...(job === undefined || job === null ? {} : { job }),
+        ...(as === undefined || as === null ? {} : { as }),
+        ...(subject === undefined || subject === null ? {} : { subject }),
+        body,
+    });
+    return out(args, `${result.created ? 'Sent' : 'Added to the conversation you already have'}. ${result.url}`, result);
+}
+async function commandReply(args) {
+    const id = args.positional[0] ?? '';
+    const body = args.positional.slice(1).join(' ');
+    if (id === '' || body === '') {
+        process.stderr.write('agenticjobs reply <thread-id> <text>\n');
+        return 1;
+    }
+    const result = await clientFor(args).reply(id, body);
+    return out(args, 'Sent.', result);
+}
+async function commandInvoice(args) {
+    const id = args.positional[0] ?? '';
+    const amount = args.positional[1] ?? '';
+    if (id === '' || amount === '') {
+        process.stderr.write('agenticjobs invoice <thread-id> <amount-usd> [--currency <chain>] [--for <text>]\n');
+        return 1;
+    }
+    const currency = flagString(args, 'currency');
+    const description = flagString(args, 'for');
+    const result = await clientFor(args).sendInvoice(id, {
+        amount,
+        ...(currency === undefined || currency === null ? {} : { currency }),
+        ...(description === undefined || description === null ? {} : { description }),
+    });
+    return out(args, `Invoice sent: $${result.invoice.amountUsd} in ${result.invoice.currency}. ${dim(result.invoice.id)}`, result);
+}
+async function commandInvoices(args) {
+    const result = await clientFor(args).invoices();
+    if (result.items.length === 0)
+        return out(args, 'No invoices.', result);
+    const lines = result.items.map((invoice) => `${bold(`$${invoice.amountUsd}`)} ${invoice.currency}  ${invoice.status}  ${dim(`from ${invoice.payee.name}, ${ago(invoice.createdAt)}`)}\n  ${dim(invoice.id)}`);
+    return out(args, lines.join('\n'), result);
+}
+async function commandPay(args) {
+    const id = args.positional[0] ?? '';
+    if (id === '') {
+        process.stderr.write('agenticjobs pay <invoice-id>\n');
+        return 1;
+    }
+    const result = await clientFor(args).payInvoice(id);
+    const invoice = result.invoice;
+    if (invoice.status === 'paid')
+        return out(args, 'Already paid.', result);
+    if (invoice.payment === null)
+        return out(args, 'No quote came back. Try again in a moment.', result);
+    return out(args, [
+        `Pay at ${bold(invoice.payment.url)}`,
+        ...(invoice.payment.amountCrypto === null
+            ? []
+            : [`  ${invoice.payment.amountCrypto} ${invoice.currency} to ${invoice.payment.address ?? ''}`]),
+        dim('  The quote lasts a few minutes.'),
+    ].join('\n'), result);
+}
+async function commandBilling(args) {
+    const result = await clientFor(args).billing();
+    if (!result.configured)
+        return out(args, 'This board has no billing configured.', result);
+    if (result.account === null) {
+        return out(args, `No CoinPay account connected. Connect one in a browser: ${result.connectUrl ?? ''}`, result);
+    }
+    if (!result.account.usable) {
+        return out(args, `The CoinPay connection has lapsed. Reconnect in a browser: ${result.connectUrl ?? ''}`, result);
+    }
+    const wallets = result.account.wallets;
+    return out(args, wallets.length === 0
+        ? 'Connected, but the CoinPay account has no wallet yet.'
+        : `Connected. Can be paid in: ${wallets.map((w) => `${w.chain} ${dim(w.address)}`).join(', ')}.`, result);
+}
 async function commandAnnounce(args) {
     const { announceOnce } = await import("../directory/announce.js");
     const { loadConfig: serverConfig, sameOrigin } = await import("../config.js");