@profullstack/agenticjobs 0.9.0 → 0.11.0

package/dist/core/agentwriter.js

@@ -0,0 +1,343 @@
+/**
+ * Turning a sentence into a draft listing.
+ *
+ * The board's thesis is agents hiring agents with a person in control at both
+ * ends, and this is that seam on the employer side for somebody who does not
+ * have an agent of their own. It fills the form and stops. Nothing is saved,
+ * nothing is published, and the person who asked reads every word before the
+ * listing exists. A model writing straight into the database would be the one
+ * shape this board has said it will not ship.
+ *
+ * Two providers, because this is MIT software other people self-host and a
+ * board that only works if you bank with one vendor is not self-hostable. The
+ * key that is set decides; when neither is set the feature is simply absent
+ * from the page rather than present and broken.
+ *
+ * Written against the two REST APIs directly rather than either vendor SDK.
+ * One dependency per provider to fill in a form is a poor trade for a package
+ * that reads a .docx by unzipping it by hand, and the request shapes here are
+ * small enough to read in full.
+ */
+import { AGENT_POLICIES, EMPLOYMENT_TYPES, SALARY_PERIODS, SENIORITIES, WORKPLACES, } from "../schema/job.js";
+/** The model was asked and could not answer. Never fatal to the page. */
+export class AgentWriterProblem extends Error {
+}
+/**
+ * Which provider this instance can use, or null for none.
+ *
+ * Anthropic first when both are set, for no better reason than that a board
+ * with both keys has to pick one and a coin flip at request time would make
+ * the same brief produce different listings.
+ */
+export function writerProvider(config) {
+    if (config.anthropicApiKey !== null)
+        return 'anthropic';
+    if (config.openaiApiKey !== null)
+        return 'openai';
+    return null;
+}
+/**
+ * What the model is asked for, and what it is asked not to do.
+ *
+ * The pay rules are the ones that matter. An invented salary range is worse
+ * than an empty one: the employer may not notice it, and a candidate who
+ * applies because of a number nobody agreed to has been misled by this board.
+ * So pay comes from the brief or not at all, and "unpaid" has to be stated
+ * rather than inferred from silence.
+ */
+const SYSTEM = [
+    'You write job listings for a job board. You are given a short brief from the',
+    'employer and you expand it into a complete listing.',
+    '',
+    'Return a single JSON object and nothing else. Every field is optional; leave',
+    'out anything the brief does not support.',
+    '',
+    '  title                a specific role title, under 80 characters',
+    '  description          Markdown. What the work is, who it suits, how the team',
+    '                       operates. Write in the employer\'s voice, second person',
+    '                       to the reader. No headings above level 2. 150-350 words.',
+    '  requirements         array of short strings',
+    '  responsibilities     array of short strings',
+    '  tags                 array of lowercase topic words',
+    '  stack                array of lowercase technology names',
+    '  employmentType       one of: full-time, part-time, contract, internship, temporary',
+    '  workplace            one of: remote, hybrid, onsite',
+    '  seniority            one of: intern, junior, mid, senior, staff, principal, lead',
+    '  location             free text, only if the brief gives one',
+    '  salaryMin            integer, ONLY if the brief states pay',
+    '  salaryMax            integer, ONLY if the brief states pay',
+    '  salaryPeriod         one of: hour, day, week, month, year',
+    '  salaryUnpaid         true ONLY if the brief says the role is unpaid',
+    '',
+    'Rules you do not break:',
+    '- Never invent compensation. If the brief says nothing about pay, omit every',
+    '  salary field. A number nobody agreed to is worse than no number.',
+    '- Never invent a company name, a benefit, a funding stage, or a headcount.',
+    '- Do not write "competitive salary", "rockstar", "ninja", or "fast-paced".',
+    '- Do not address the reader as a candidate in the description title.',
+].join('\n');
+/**
+ * A brief, expanded into values the post form can be rendered with.
+ *
+ * Returns form values rather than a job, because the next thing that happens
+ * is that a person looks at them. They go through the same `normaliseInput`
+ * every other posting path goes through when the form is finally submitted,
+ * so nothing here can put a listing into a state a hand-typed one could not
+ * reach.
+ */
+export async function draftListing(brief, context, config, fetchImpl = fetch) {
+    const trimmed = brief.trim();
+    if (trimmed.length < 10) {
+        throw new AgentWriterProblem('Say a little more about the role, and I will draft it.');
+    }
+    const provider = writerProvider(config);
+    if (provider === null) {
+        throw new AgentWriterProblem('This board has no model configured.');
+    }
+    const prompt = [
+        `Board: ${context.boardName}.`,
+        context.orgName === null ? null : `Employer: ${context.orgName}.`,
+        '',
+        'The brief:',
+        trimmed.slice(0, 4000),
+    ]
+        .filter((line) => line !== null)
+        .join('\n');
+    const raw = provider === 'anthropic'
+        ? await askAnthropic(prompt, config, fetchImpl)
+        : await askOpenAi(prompt, config, fetchImpl);
+    return fieldsFromModelJson(raw);
+}
+/**
+ * The Messages API, by hand.
+ *
+ * Thinking is on by default on this model and `effort: low` is right for
+ * filling in a form: the work is recall and phrasing, not reasoning, and the
+ * person is waiting on a page for it.
+ */
+async function askAnthropic(prompt, config, fetchImpl) {
+    const response = await fetchImpl('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+            'x-api-key': config.anthropicApiKey ?? '',
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+            model: config.writerModel ?? 'claude-opus-5',
+            max_tokens: 4000,
+            output_config: { effort: 'low' },
+            system: SYSTEM,
+            messages: [{ role: 'user', content: prompt }],
+        }),
+    });
+    if (!response.ok)
+        throw await problemFor(response, 'Anthropic');
+    const body = (await response.json());
+    // A refusal arrives as a 200 with nothing usable in it, so the status alone
+    // is not evidence that there is text to read.
+    if (body.stop_reason === 'refusal') {
+        throw new AgentWriterProblem('The model declined to write that one.');
+    }
+    const text = (body.content ?? [])
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text ?? '')
+        .join('');
+    if (text.trim() === '')
+        throw new AgentWriterProblem('The model returned nothing.');
+    return text;
+}
+/**
+ * Chat completions, by hand.
+ *
+ * `max_completion_tokens`, not `max_tokens`: the current models reject the
+ * older name. `json_object` is what keeps the reply parseable without asking
+ * the model nicely twice.
+ */
+async function askOpenAi(prompt, config, fetchImpl) {
+    const response = await fetchImpl('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+            authorization: `Bearer ${config.openaiApiKey ?? ''}`,
+        },
+        body: JSON.stringify({
+            model: config.writerModel ?? 'gpt-5.2',
+            max_completion_tokens: 4000,
+            response_format: { type: 'json_object' },
+            messages: [
+                { role: 'system', content: SYSTEM },
+                { role: 'user', content: prompt },
+            ],
+        }),
+    });
+    if (!response.ok)
+        throw await problemFor(response, 'OpenAI');
+    const body = (await response.json());
+    const choice = body.choices?.[0]?.message;
+    if (typeof choice?.refusal === 'string' && choice.refusal !== '') {
+        throw new AgentWriterProblem('The model declined to write that one.');
+    }
+    const text = choice?.content ?? '';
+    if (text.trim() === '')
+        throw new AgentWriterProblem('The model returned nothing.');
+    return text;
+}
+/**
+ * An HTTP failure, said in words a person on a form can act on.
+ *
+ * The provider's own message is deliberately not shown: it is written for
+ * whoever holds the key, not for the employer typing a brief, and it can
+ * carry account details that do not belong on a public page.
+ */
+async function problemFor(response, provider) {
+    // Read and discard, so the connection is not left hanging on a body nobody
+    // consumed.
+    await response.text().catch(() => '');
+    if (response.status === 401 || response.status === 403) {
+        return new AgentWriterProblem(`This board's ${provider} key was rejected.`);
+    }
+    if (response.status === 429) {
+        return new AgentWriterProblem('The model is rate limited right now. Try again shortly.');
+    }
+    return new AgentWriterProblem(`${provider} could not be reached. Try again shortly.`);
+}
+/**
+ * The model's JSON, reduced to form values this board will accept.
+ *
+ * Everything is checked against the same lists the form's own selects are
+ * built from, and anything unrecognised is dropped rather than corrected. A
+ * model that invents an employment type should leave that field blank for a
+ * person to fill in, not have its answer bent into the nearest legal value:
+ * the second one looks like the employer chose it.
+ *
+ * Exported because this is the part worth testing, and testing it needs no
+ * network and no key.
+ */
+export function fieldsFromModelJson(raw) {
+    const parsed = parseLoose(raw);
+    if (parsed === null)
+        throw new AgentWriterProblem('The model did not return a listing.');
+    const out = {};
+    const put = (key, value) => {
+        if (value.trim() !== '')
+            out[key] = value.trim();
+    };
+    put('title', text(parsed['title'], 140));
+    put('description', text(parsed['description'], 20_000));
+    put('location', text(parsed['location'], 120));
+    put('employmentType', oneOf(parsed['employmentType'], EMPLOYMENT_TYPES));
+    put('workplace', oneOf(parsed['workplace'], WORKPLACES));
+    put('seniority', oneOf(parsed['seniority'], SENIORITIES));
+    put('salaryPeriod', oneOf(parsed['salaryPeriod'], SALARY_PERIODS));
+    put('agentPolicy', oneOf(parsed['agentPolicy'], AGENT_POLICIES));
+    put('tags', list(parsed['tags'], 12));
+    put('stack', list(parsed['stack'], 20));
+    put('requirements', bullets(parsed['requirements']));
+    put('responsibilities', bullets(parsed['responsibilities']));
+    // Pay only survives if the model actually returned a number. "Unpaid" and a
+    // range are mutually exclusive here for the same reason they are everywhere
+    // else on the board.
+    if (parsed['salaryUnpaid'] === true) {
+        out['salaryUnpaid'] = 'on';
+    }
+    else {
+        put('salaryMin', amount(parsed['salaryMin']));
+        put('salaryMax', amount(parsed['salaryMax']));
+    }
+    if (out['title'] === undefined && out['description'] === undefined) {
+        throw new AgentWriterProblem('The model did not return a listing.');
+    }
+    return out;
+}
+/**
+ * JSON, whether or not it arrived alone.
+ *
+ * Both providers were asked for a bare object and both usually send one, but a
+ * model that wraps it in a ```json fence has still done the job, and failing
+ * the whole request over a fence would be the wrong place to be strict.
+ */
+function parseLoose(raw) {
+    const attempts = [raw];
+    const fenced = /```(?:json)?\s*([\s\S]*?)```/.exec(raw);
+    if (fenced !== null)
+        attempts.push(fenced[1] ?? '');
+    const braced = /\{[\s\S]*\}/.exec(raw);
+    if (braced !== null)
+        attempts.push(braced[0]);
+    for (const attempt of attempts) {
+        try {
+            const value = JSON.parse(attempt);
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                return value;
+            }
+        }
+        catch {
+            // Try the next shape.
+        }
+    }
+    return null;
+}
+function text(value, max) {
+    return typeof value === 'string' ? value.slice(0, max) : '';
+}
+function oneOf(value, allowed) {
+    if (typeof value !== 'string')
+        return '';
+    const found = allowed.find((item) => item === value.trim().toLowerCase());
+    return found ?? '';
+}
+function amount(value) {
+    const parsed = typeof value === 'number' ? value : Number.parseInt(String(value ?? ''), 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return '';
+    return String(Math.min(100_000_000, Math.round(parsed)));
+}
+/** The form takes these comma separated, which is how a person edits them. */
+function list(value, max) {
+    if (!Array.isArray(value))
+        return typeof value === 'string' ? value : '';
+    return value
+        .filter((item) => typeof item === 'string')
+        .map((item) => item.trim().toLowerCase())
+        .filter((item) => item !== '' && item.length <= 40)
+        .slice(0, max)
+        .join(', ');
+}
+/** And these one per line. */
+function bullets(value) {
+    if (!Array.isArray(value))
+        return typeof value === 'string' ? value : '';
+    return value
+        .filter((item) => typeof item === 'string')
+        .map((item) => item.trim().replace(/^[-*]\s*/, ''))
+        .filter((item) => item !== '')
+        .slice(0, 20)
+        .join('\n');
+}
+/**
+ * How many drafts this account has asked for in the last hour.
+ *
+ * The ceiling is per account rather than per board: one employer writing four
+ * listings in an afternoon is the use case, and a shared board-wide limit
+ * would let one of them lock out everybody else.
+ */
+export const DRAFTS_PER_HOUR = 10;
+export async function recentDraftCount(pool, userId) {
+    const result = await pool.query(`select count(*)::int as count
+       from agent_drafts
+      where user_id = $1
+        and created_at > now() - interval '1 hour'`, [userId]);
+    return result.rows[0]?.count ?? 0;
+}
+/**
+ * Recorded before the model is called, not after.
+ *
+ * A request that fails still cost the board something and still came from
+ * somebody, so counting only the successes would leave the cheapest way to
+ * burn the key uncounted.
+ */
+export async function recordDraft(pool, userId) {
+    await pool.query(`insert into agent_drafts (user_id) values ($1)`, [userId]);
+}
+//# sourceMappingURL=agentwriter.js.map

package/dist/core/agentwriter.js.map

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

package/dist/core/candidates.js

@@ -6,6 +6,7 @@
  * document they already wrote, and a second copy of the same facts is a second
  * copy to keep in step.
  */
+import { parseCapacity } from "./capacity.js";
 import { parseResume, redactContactChannels } from "../markup/resume.js";
 /** Contact keys that read as a place rather than an address. */
 const LOCATION_KEYS = /^(location|based|city|where|region)$/i;
@@ -100,13 +101,41 @@ export function resumeForViewer(resume, signedIn) {
         return { markdown: resume.markdown, parsed: resume.parsed, redacted: false };
     return { markdown, parsed: parseResume(markdown), redacted: true };
 }
+/**
+ * The headline, re-checked at render time rather than trusted.
+ *
+ * `parsed` is a cache written on save, so fixing the parser does not fix the
+ * rows already in the table. Cleaning the headline at parse time left the live
+ * directory still captioned `Operated by:** DevilX (<address>)` — correct code
+ * serving a stale value, which is the shape of every derived-cache bug.
+ *
+ * A backfill would repair those rows, but it would not stop the next one: any
+ * resume saved by an older build, restored from a backup, or written straight
+ * into the column arrives here the same way. This is a public directory page
+ * and the field is one line of text, so it is checked on the way out. Cheap,
+ * and it cannot go stale.
+ */
+function headlineOf(resume) {
+    const headline = resume.parsed?.headline;
+    if (headline === null || headline === undefined)
+        return null;
+    const cleaned = headline.replace(/\*\*|__/g, '').trim();
+    if (cleaned === '')
+        return null;
+    return /[^\s@]+@[^\s@]+\.[^\s@]+/.test(cleaned) ? null : cleaned;
+}
 export function toCandidateSummary(resume) {
     return {
         slug: resume.publicSlug ?? '',
         name: nameOf(resume),
-        headline: resume.parsed?.headline ?? null,
+        headline: headlineOf(resume),
         location: locationOf(resume),
         skills: skillsOf(resume),
+        // Capacity is a summary field for the same reason location is: it is what
+        // an employer filters on before opening anything. It is also the one thing
+        // here that is null for most resumes today, since the convention is new —
+        // the card says so rather than hiding the row.
+        capacity: parseCapacity(resume.parsed?.contact ?? []),
         updatedAt: resume.updatedAt,
     };
 }

package/dist/core/candidates.js.map

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

package/dist/core/capacity-alert.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Asking listed candidates to state their swarm capacity.
+ *
+ * The convention in `capacity.ts` is new, so every resume published before it
+ * has nothing to show and the directory says "capacity not stated" on almost
+ * every card. Backfilling was the alternative and it is the wrong one: nobody
+ * here knows whether a given candidate is one agent or ten, and inventing an
+ * answer would put a made-up price on a real person's profile. So we ask.
+ *
+ * Two rules this module exists to enforce, both of which are easy to get wrong
+ * when a send is one function call away:
+ *
+ *   - **It only ever writes to people who are actually missing it.** The set
+ *     is computed from the same parser the directory renders with, so "who
+ *     needs asking" and "whose card looks empty" can never drift apart.
+ *   - **It does not send unless asked to.** `plan` is the default and returns
+ *     the recipients without contacting anybody, because the cost of a bug in
+ *     an outbound loop is paid by other people's inboxes and cannot be undone.
+ */
+import type pg from 'pg';
+import type { Mailer, Message } from './mail.ts';
+export interface CapacityAlertTarget {
+    userId: string;
+    email: string;
+    /** The name on the resume, for the greeting. */
+    name: string;
+    /** Board-wide slug, so the mail can link the profile being talked about. */
+    publicSlug: string;
+    /** The owner's own slug, which is what /me/resumes/<slug> wants. */
+    slug: string;
+}
+/**
+ * Listed candidates whose resume states no capacity.
+ *
+ * Only `public` resumes: a private resume is not in the directory, so nothing
+ * about it is missing and its owner has not asked to be in this conversation.
+ *
+ * One row per person, not per resume. A candidate with three public resumes
+ * has one inbox, and three emails saying the same thing is how a useful
+ * request becomes spam. The most recently touched resume is the one named,
+ * because it is the one they are most likely to still be editing.
+ */
+export declare function candidatesMissingCapacity(pool: pg.Pool): Promise<CapacityAlertTarget[]>;
+/**
+ * The ask.
+ *
+ * It shows the two lines to paste rather than describing them, because the
+ * whole convention *is* two lines and a person who has to go and read a spec
+ * to answer a one-question email mostly does not answer it. Both shapes are
+ * given — a single agent and a swarm — since "I am one agent" is a real answer
+ * and an email that only demonstrates the swarm case reads as though it is not.
+ */
+export declare function capacityAlertMessage(options: {
+    to: string;
+    name: string;
+    boardName: string;
+    profileUrl: string;
+    editUrl: string;
+    specUrl: string;
+}): Message;
+export interface CapacityAlertResult {
+    target: CapacityAlertTarget;
+    /** False when the provider refused, null when this was a plan-only run. */
+    sent: boolean | null;
+}
+/**
+ * Work the list.
+ *
+ * `send` has to be passed explicitly. A default of "yes, mail everyone" is the
+ * kind of default that turns a typo in a WHERE clause into an apology, and
+ * this is the one function in the module that can do that.
+ *
+ * Sends are sequential. The list is small by construction — it is the people
+ * listed on one board who have not filled in one field — and a provider that
+ * rate-limits a burst would report failures that mean nothing about the
+ * recipient.
+ */
+export declare function runCapacityAlerts(options: {
+    pool: pg.Pool;
+    mailer: Mailer | null;
+    boardName: string;
+    publicUrl: string;
+    send: boolean;
+}): Promise<CapacityAlertResult[]>;

package/dist/core/capacity-alert.js

@@ -0,0 +1,144 @@
+/**
+ * Asking listed candidates to state their swarm capacity.
+ *
+ * The convention in `capacity.ts` is new, so every resume published before it
+ * has nothing to show and the directory says "capacity not stated" on almost
+ * every card. Backfilling was the alternative and it is the wrong one: nobody
+ * here knows whether a given candidate is one agent or ten, and inventing an
+ * answer would put a made-up price on a real person's profile. So we ask.
+ *
+ * Two rules this module exists to enforce, both of which are easy to get wrong
+ * when a send is one function call away:
+ *
+ *   - **It only ever writes to people who are actually missing it.** The set
+ *     is computed from the same parser the directory renders with, so "who
+ *     needs asking" and "whose card looks empty" can never drift apart.
+ *   - **It does not send unless asked to.** `plan` is the default and returns
+ *     the recipients without contacting anybody, because the cost of a bug in
+ *     an outbound loop is paid by other people's inboxes and cannot be undone.
+ */
+import { escapeHtml } from "../markup/escape.js";
+import { parseCapacity } from "./capacity.js";
+/**
+ * Listed candidates whose resume states no capacity.
+ *
+ * Only `public` resumes: a private resume is not in the directory, so nothing
+ * about it is missing and its owner has not asked to be in this conversation.
+ *
+ * One row per person, not per resume. A candidate with three public resumes
+ * has one inbox, and three emails saying the same thing is how a useful
+ * request becomes spam. The most recently touched resume is the one named,
+ * because it is the one they are most likely to still be editing.
+ */
+export async function candidatesMissingCapacity(pool) {
+    const result = await pool.query(`select distinct on (r.user_id)
+            r.user_id, u.email, r.title, r.slug, r.public_slug, r.parsed
+       from resumes r
+       join users u on u.id = r.user_id
+      where r.visibility = 'public'
+        and r.public_slug is not null
+        and u.email is not null
+      order by r.user_id, r.updated_at desc`);
+    const out = [];
+    for (const row of result.rows) {
+        // The same parser the card uses. If this ever disagrees with the directory
+        // we would be mailing people whose profile already looks complete.
+        if (parseCapacity(row.parsed?.contact ?? []) !== null)
+            continue;
+        const name = row.parsed?.name?.trim();
+        out.push({
+            userId: row.user_id,
+            email: row.email,
+            name: name === undefined || name === '' || name.length > 80 ? row.title : name,
+            publicSlug: row.public_slug,
+            slug: row.slug,
+        });
+    }
+    return out;
+}
+/**
+ * The ask.
+ *
+ * It shows the two lines to paste rather than describing them, because the
+ * whole convention *is* two lines and a person who has to go and read a spec
+ * to answer a one-question email mostly does not answer it. Both shapes are
+ * given — a single agent and a swarm — since "I am one agent" is a real answer
+ * and an email that only demonstrates the swarm case reads as though it is not.
+ */
+export function capacityAlertMessage(options) {
+    const subject = `Add your agent capacity to ${options.boardName}`;
+    const lines = [
+        `Hi ${options.name},`,
+        '',
+        `Your profile is listed on ${options.boardName}, and employers browsing it cannot`,
+        `tell one thing they care about: whether you are a single agent, or whether you`,
+        `run several in parallel — and what that costs.`,
+        '',
+        `Add two lines to the contact block at the top of your resume:`,
+        '',
+        `  - **Agents**: 10`,
+        `  - **Rate**: $100/hour/agent`,
+        '',
+        `Your profile would then read "10 agents · $100/hr each · $1,000/hr total".`,
+        '',
+        `If you are a single agent, that is a real answer and worth stating:`,
+        '',
+        `  - **Agents**: 1`,
+        `  - **Rate**: $100/hour`,
+        '',
+        `Edit it here: ${options.editUrl}`,
+        `Your public profile: ${options.profileUrl}`,
+        `The convention: ${options.specUrl}`,
+        '',
+        `Nothing is removed if you skip this — your profile stays listed and simply`,
+        `says the capacity is not stated.`,
+    ];
+    const code = (text) => `<code>${escapeHtml(text)}</code>`;
+    const link = (url, label) => `<a href="${escapeHtml(url)}">${escapeHtml(label)}</a>`;
+    const html = [
+        `<p>Hi ${escapeHtml(options.name)},</p>`,
+        `<p>Your profile is listed on ${escapeHtml(options.boardName)}, and employers browsing it cannot tell one thing they care about: whether you are a single agent, or whether you run several in parallel &mdash; and what that costs.</p>`,
+        `<p>Add two lines to the contact block at the top of your resume:</p>`,
+        `<pre style="background:#f6f6f6;padding:12px;border-radius:6px">${code('- **Agents**: 10\n- **Rate**: $100/hour/agent')}</pre>`,
+        `<p>Your profile would then read &ldquo;10 agents &middot; $100/hr each &middot; $1,000/hr total&rdquo;.</p>`,
+        `<p>If you are a single agent, that is a real answer and worth stating:</p>`,
+        `<pre style="background:#f6f6f6;padding:12px;border-radius:6px">${code('- **Agents**: 1\n- **Rate**: $100/hour')}</pre>`,
+        `<p>${link(options.editUrl, 'Edit your resume')} &middot; ${link(options.profileUrl, 'your public profile')} &middot; ${link(options.specUrl, 'the convention')}</p>`,
+        `<p style="color:#666;font-size:12px">Nothing is removed if you skip this &mdash; your profile stays listed and simply says the capacity is not stated.</p>`,
+    ].join('');
+    return { to: options.to, subject, html, text: lines.join('\n') };
+}
+/**
+ * Work the list.
+ *
+ * `send` has to be passed explicitly. A default of "yes, mail everyone" is the
+ * kind of default that turns a typo in a WHERE clause into an apology, and
+ * this is the one function in the module that can do that.
+ *
+ * Sends are sequential. The list is small by construction — it is the people
+ * listed on one board who have not filled in one field — and a provider that
+ * rate-limits a burst would report failures that mean nothing about the
+ * recipient.
+ */
+export async function runCapacityAlerts(options) {
+    const targets = await candidatesMissingCapacity(options.pool);
+    const base = options.publicUrl.replace(/\/+$/, '');
+    const out = [];
+    for (const target of targets) {
+        if (!options.send || options.mailer === null) {
+            out.push({ target, sent: null });
+            continue;
+        }
+        const sent = await options.mailer.send(capacityAlertMessage({
+            to: target.email,
+            name: target.name,
+            boardName: options.boardName,
+            profileUrl: `${base}/candidates/${target.publicSlug}`,
+            editUrl: `${base}/me/resumes/${target.slug}`,
+            specUrl: `${base}/docs/openresume#capacity`,
+        }));
+        out.push({ target, sent });
+    }
+    return out;
+}
+//# sourceMappingURL=capacity-alert.js.map