@profullstack/agenticjobs 0.1.0

package/dist/markup/resume.d.ts

@@ -0,0 +1,72 @@
+/**
+ * OpenResume.md.
+ *
+ * A resume is a Markdown document, and the Markdown is the canonical copy.
+ * Everything else - the structured object below, the HTML on the page, a PDF
+ * someone exports - is derived from it and regenerated, never edited beside
+ * it. That is the whole point of choosing Markdown over a form: the candidate
+ * owns a file they can read, diff, and paste into any other tool, and an agent
+ * can write one without a schema-shaped API.
+ *
+ * The convention is deliberately thin, because a resume that fails to parse
+ * must still be a usable resume. Every rule here degrades: an unrecognised
+ * section is kept verbatim, a missing date is simply absent, and a document
+ * with nothing but an h1 and some prose is valid.
+ *
+ *   # Name                      <- exactly one h1, the person
+ *   - **Email**: a@b.com        <- the list right after it is the contact block
+ *   ## Experience               <- h2 opens a section
+ *   ### Company | Location      <- h3 opens an entry
+ *   Role (Mar 2020 - Present)   <- the line under an entry is its subtitle
+ *   - Did a thing               <- bullets are highlights
+ *
+ * The full specification is in docs/openresume.md.
+ */
+export interface ResumeContact {
+    key: string;
+    value: string;
+    /** Set when the value is a URL or an email we can link. */
+    href: string | null;
+}
+export interface ResumeEntry {
+    /** The h3 text, with a `|` split into title and place. */
+    title: string;
+    place: string | null;
+    /** The line under the heading: a role, a degree, a one-line description. */
+    subtitle: string | null;
+    /** Parsed out of the subtitle when it ends in a bracketed range. */
+    start: string | null;
+    end: string | null;
+    /** True when the range ends in "present", "now" or "current". */
+    current: boolean;
+    highlights: string[];
+    /** Everything under the entry, verbatim, so nothing is ever lost. */
+    markdown: string;
+}
+export interface ResumeSection {
+    /** The h2 text as written. */
+    title: string;
+    /** Lowercased and normalised, for matching. */
+    kind: string;
+    entries: ResumeEntry[];
+    /** Prose and bullets that sat directly under the h2. */
+    markdown: string;
+}
+export interface OpenResume {
+    name: string | null;
+    headline: string | null;
+    contact: ResumeContact[];
+    sections: ResumeSection[];
+    /** The document as supplied. Always the source of truth. */
+    markdown: string;
+    /** Things a candidate would probably want to fix. Never fatal. */
+    warnings: string[];
+}
+export declare function parseResume(source: string): OpenResume;
+/**
+ * Everything an employer would filter on, flattened for the search index.
+ * Derived, never stored as the truth: regenerated from the Markdown on save.
+ */
+export declare function resumeSearchText(resume: OpenResume): string;
+/** A starting document, so nobody faces an empty box. */
+export declare function resumeTemplate(name?: string): string;

package/dist/markup/resume.js

@@ -0,0 +1,260 @@
+/**
+ * OpenResume.md.
+ *
+ * A resume is a Markdown document, and the Markdown is the canonical copy.
+ * Everything else - the structured object below, the HTML on the page, a PDF
+ * someone exports - is derived from it and regenerated, never edited beside
+ * it. That is the whole point of choosing Markdown over a form: the candidate
+ * owns a file they can read, diff, and paste into any other tool, and an agent
+ * can write one without a schema-shaped API.
+ *
+ * The convention is deliberately thin, because a resume that fails to parse
+ * must still be a usable resume. Every rule here degrades: an unrecognised
+ * section is kept verbatim, a missing date is simply absent, and a document
+ * with nothing but an h1 and some prose is valid.
+ *
+ *   # Name                      <- exactly one h1, the person
+ *   - **Email**: a@b.com        <- the list right after it is the contact block
+ *   ## Experience               <- h2 opens a section
+ *   ### Company | Location      <- h3 opens an entry
+ *   Role (Mar 2020 - Present)   <- the line under an entry is its subtitle
+ *   - Did a thing               <- bullets are highlights
+ *
+ * The full specification is in docs/openresume.md.
+ */
+/** Section names we normalise, so "Work Experience" and "Experience" match. */
+const KINDS = [
+    [/^(work\s+)?experience$|^employment$|^work\s+history$/i, 'experience'],
+    [/^education$|^academic/i, 'education'],
+    [/^skills?$|^technical\s+skills?$|^areas?\s+of\s+expertise$/i, 'skills'],
+    [/^projects?$|^open\s+source$/i, 'projects'],
+    [/^summary$|^about$|^profile$|^objective$/i, 'summary'],
+    [/^links?$|^elsewhere$|^profiles?$/i, 'links'],
+    [/^certification|^licen[cs]e/i, 'certifications'],
+    [/^languages?$/i, 'languages'],
+    [/^publications?$|^talks?$|^writing$/i, 'publications'],
+    [/^awards?$|^honou?rs?$/i, 'awards'],
+];
+function kindOf(title) {
+    for (const [pattern, kind] of KINDS) {
+        if (pattern.test(title.trim()))
+            return kind;
+    }
+    return title.trim().toLowerCase().replace(/\s+/g, '-').slice(0, 40) || 'section';
+}
+const PRESENT = /\b(present|now|current|ongoing)\b/i;
+export function parseResume(source) {
+    const markdown = source.replace(/\r\n?/g, '\n').trim();
+    const lines = markdown.split('\n');
+    const warnings = [];
+    let name = null;
+    let headline = null;
+    const contact = [];
+    const sections = [];
+    let section = null;
+    let entry = null;
+    let seenH1 = false;
+    let inPreamble = false;
+    const flushEntry = () => {
+        if (entry !== null && section !== null) {
+            entry.markdown = entry.markdown.trim();
+            section.entries.push(entry);
+        }
+        entry = null;
+    };
+    const flushSection = () => {
+        flushEntry();
+        if (section !== null) {
+            section.markdown = section.markdown.trim();
+            sections.push(section);
+        }
+        section = null;
+    };
+    for (const line of lines) {
+        const h1 = /^#\s+(.+?)\s*#*\s*$/.exec(line);
+        if (h1 !== null) {
+            if (seenH1) {
+                warnings.push('More than one top-level heading; the first one is used as the name.');
+            }
+            else {
+                name = (h1[1] ?? '').trim();
+                seenH1 = true;
+                inPreamble = true;
+            }
+            continue;
+        }
+        const h2 = /^##\s+(.+?)\s*#*\s*$/.exec(line);
+        if (h2 !== null) {
+            flushSection();
+            inPreamble = false;
+            const title = (h2[1] ?? '').trim();
+            section = { title, kind: kindOf(title), entries: [], markdown: '' };
+            continue;
+        }
+        const h3 = /^###\s+(.+?)\s*#*\s*$/.exec(line);
+        if (h3 !== null && section !== null) {
+            flushEntry();
+            const raw = (h3[1] ?? '').trim();
+            const parts = raw.split('|').map((part) => part.trim());
+            entry = {
+                title: parts[0] ?? raw,
+                place: parts.length > 1 ? parts.slice(1).join(' | ') : null,
+                subtitle: null,
+                start: null,
+                end: null,
+                current: false,
+                highlights: [],
+                markdown: '',
+            };
+            continue;
+        }
+        if (inPreamble) {
+            const bullet = /^\s*[-*+]\s+(.*)$/.exec(line);
+            if (bullet !== null) {
+                const field = parseContact(bullet[1] ?? '');
+                if (field !== null)
+                    contact.push(field);
+                continue;
+            }
+            if (line.trim() !== '' && headline === null && !line.startsWith('#')) {
+                // A single prose line under the name, before any section, reads as a
+                // headline on every resume that has one.
+                headline = line.trim().replace(/^[*_]+|[*_]+$/g, '');
+            }
+            continue;
+        }
+        if (entry !== null) {
+            const bullet = /^\s*[-*+]\s+(.*)$/.exec(line);
+            if (bullet !== null) {
+                entry.highlights.push((bullet[1] ?? '').trim());
+            }
+            else if (entry.subtitle === null && line.trim() !== '') {
+                const subtitle = line.trim();
+                entry.subtitle = subtitle;
+                const range = parseRange(subtitle);
+                entry.start = range.start;
+                entry.end = range.end;
+                entry.current = range.current;
+            }
+            entry.markdown += `${line}\n`;
+            continue;
+        }
+        if (section !== null)
+            section.markdown += `${line}\n`;
+    }
+    flushSection();
+    if (name === null)
+        warnings.push('No name: the document should start with "# Your Name".');
+    if (contact.length === 0) {
+        warnings.push('No contact details: add a bullet list under the name, e.g. "- Email: you@example.com".');
+    }
+    if (!sections.some((item) => item.kind === 'experience')) {
+        warnings.push('No experience section found. Employers filter on it.');
+    }
+    return { name, headline, contact, sections, markdown, warnings };
+}
+/** `- **Email**: a@b.com`, `- Email: a@b.com`, `- [GitHub](https://...)`. */
+function parseContact(raw) {
+    const text = raw.trim();
+    if (text === '')
+        return null;
+    const link = /^\[([^\]]+)\]\(([^)\s]+)\)$/.exec(text);
+    if (link !== null) {
+        return { key: (link[1] ?? '').trim(), value: (link[1] ?? '').trim(), href: link[2] ?? null };
+    }
+    const pair = /^\*{0,2}([^:*]{1,40})\*{0,2}\s*:\s*(.+)$/.exec(text);
+    if (pair === null) {
+        return { key: 'note', value: stripMarkdown(text), href: hrefFor(stripMarkdown(text)) };
+    }
+    const key = (pair[1] ?? '').trim();
+    const rawValue = (pair[2] ?? '').trim();
+    const inner = /^\[([^\]]+)\]\(([^)\s]+)\)$/.exec(rawValue);
+    if (inner !== null) {
+        return { key, value: (inner[1] ?? '').trim(), href: inner[2] ?? null };
+    }
+    const value = stripMarkdown(rawValue);
+    return { key, value, href: hrefFor(value) };
+}
+function stripMarkdown(value) {
+    return value.replace(/[*_`]/g, '').trim();
+}
+function hrefFor(value) {
+    if (/^https?:\/\//i.test(value))
+        return value;
+    if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value))
+        return `mailto:${value}`;
+    if (/^\+?[\d\s().-]{7,}$/.test(value))
+        return `tel:${value.replace(/[^\d+]/g, '')}`;
+    // A bare domain, with or without a path. "Web: example.com" is how most
+    // people write it, and an earlier version of this required a trailing slash
+    // and so linked none of them.
+    if (/^[a-z0-9-]+(\.[a-z0-9-]+)*\.[a-z]{2,24}(\/\S*)?$/i.test(value))
+        return `https://${value}`;
+    return null;
+}
+/** "Full Stack Engineer (Mar 2020 - Present)" -> start, end, current. */
+function parseRange(subtitle) {
+    const bracketed = /\(([^)]*)\)\s*$/.exec(subtitle);
+    const candidate = bracketed?.[1] ?? subtitle;
+    // An en dash, an em dash and a hyphen all show up in real resumes.
+    const split = candidate.split(/\s+(?:to|-|–|—)\s+/i);
+    if (split.length < 2) {
+        if (bracketed !== null && candidate.trim() !== '') {
+            return { start: candidate.trim(), end: null, current: PRESENT.test(candidate) };
+        }
+        return { start: null, end: null, current: false };
+    }
+    const start = (split[0] ?? '').trim();
+    const end = (split[1] ?? '').trim();
+    return {
+        start: start === '' ? null : start,
+        end: end === '' ? null : end,
+        current: PRESENT.test(end),
+    };
+}
+/**
+ * Everything an employer would filter on, flattened for the search index.
+ * Derived, never stored as the truth: regenerated from the Markdown on save.
+ */
+export function resumeSearchText(resume) {
+    const parts = [resume.name ?? '', resume.headline ?? ''];
+    for (const section of resume.sections) {
+        parts.push(section.title, section.markdown);
+        for (const entry of section.entries) {
+            parts.push(entry.title, entry.place ?? '', entry.subtitle ?? '', ...entry.highlights);
+        }
+    }
+    return parts.filter((part) => part !== '').join('\n');
+}
+/** A starting document, so nobody faces an empty box. */
+export function resumeTemplate(name = 'Your Name') {
+    return [
+        `# ${name}`,
+        '',
+        '- **Email**: you@example.com',
+        '- **Location**: City, Country',
+        '- **Web**: https://example.com',
+        '',
+        'One line on what you do and what you are looking for.',
+        '',
+        '## Experience',
+        '',
+        '### Company | Remote',
+        'Your Role (Jan 2024 - Present)',
+        '',
+        '- What you built, and what changed because you built it.',
+        '- Numbers where you have them.',
+        '',
+        '## Skills',
+        '',
+        '- Languages: ',
+        '- Tools: ',
+        '',
+        '## Education',
+        '',
+        '### School',
+        'Degree (Year)',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=resume.js.map

package/dist/markup/resume.js.map

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

package/dist/mcp/protocol.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Just enough MCP to be one.
+ *
+ * The protocol is JSON-RPC 2.0 with a small set of methods, and implementing
+ * those directly keeps this package dependency-free and runnable in both
+ * places it has to run: inside the server behind /api/mcp, and inside the
+ * stdio binary that talks to a remote board.
+ */
+export declare const PROTOCOL_VERSION = "2025-06-18";
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare const PARSE_ERROR = -32700;
+export declare const INVALID_REQUEST = -32600;
+export declare const METHOD_NOT_FOUND = -32601;
+export declare const INVALID_PARAMS = -32602;
+export declare const INTERNAL_ERROR = -32603;
+export declare function result(id: string | number | null, value: unknown): JsonRpcResponse;
+export declare function failure(id: string | number | null, code: number, message: string, data?: unknown): JsonRpcResponse;
+export declare function isRequest(value: unknown): value is JsonRpcRequest;
+/**
+ * A notification has no id and takes no reply.
+ *
+ * Answering one is a protocol error that some clients tolerate and others
+ * treat as a fatal desync, so it is checked rather than assumed.
+ */
+export declare function isNotification(request: JsonRpcRequest): boolean;
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ToolResult {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+    structuredContent?: unknown;
+}
+export declare function text(value: string, structured?: unknown): ToolResult;
+export declare function toolError(message: string): ToolResult;

package/dist/mcp/protocol.js

@@ -0,0 +1,48 @@
+/**
+ * Just enough MCP to be one.
+ *
+ * The protocol is JSON-RPC 2.0 with a small set of methods, and implementing
+ * those directly keeps this package dependency-free and runnable in both
+ * places it has to run: inside the server behind /api/mcp, and inside the
+ * stdio binary that talks to a remote board.
+ */
+export const PROTOCOL_VERSION = '2025-06-18';
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+export function result(id, value) {
+    return { jsonrpc: '2.0', id, result: value };
+}
+export function failure(id, code, message, data) {
+    return { jsonrpc: '2.0', id, error: { code, message, ...(data === undefined ? {} : { data }) } };
+}
+export function isRequest(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    return record['jsonrpc'] === '2.0' && typeof record['method'] === 'string';
+}
+/**
+ * A notification has no id and takes no reply.
+ *
+ * Answering one is a protocol error that some clients tolerate and others
+ * treat as a fatal desync, so it is checked rather than assumed.
+ */
+export function isNotification(request) {
+    return request.id === undefined || request.id === null;
+}
+export function text(value, structured) {
+    return {
+        content: [{ type: 'text', text: value }],
+        ...(structured === undefined ? {} : { structuredContent: structured }),
+    };
+}
+export function toolError(message) {
+    // Reported as a tool result rather than a JSON-RPC error on purpose: the
+    // model is supposed to read it and try something else, and a transport-level
+    // error is not shown to the model by most clients.
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/mcp/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/mcp/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAgB7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC;AAErC,MAAM,UAAU,MAAM,CAAC,EAA0B,EAAE,KAAc;IAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC;AACzD,CAAC;AAeD,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,UAAoB;IACtD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,yEAAyE;IACzE,6EAA6E;IAC7E,mDAAmD;IACnD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The MCP request handler, independent of transport.
+ *
+ * Used by both hosts: the board's own /api/mcp endpoint and the stdio binary.
+ */
+import { type JsonRpcResponse } from './protocol.ts';
+import { callTool, TOOLS, type Caller } from './tools.ts';
+export interface ServerInfo {
+    name: string;
+    version: string;
+}
+/**
+ * Handle one message.
+ *
+ * Returns null for a notification, which the caller must then not answer:
+ * some clients treat a reply to a notification as a fatal desync rather than
+ * as noise to ignore.
+ */
+export declare function handleMessage(payload: unknown, caller: Caller, info: ServerInfo): Promise<JsonRpcResponse | null>;
+export { TOOLS, callTool };
+export type { Caller };

package/dist/mcp/server.js

@@ -0,0 +1,73 @@
+/**
+ * The MCP request handler, independent of transport.
+ *
+ * Used by both hosts: the board's own /api/mcp endpoint and the stdio binary.
+ */
+import { failure, INTERNAL_ERROR, INVALID_PARAMS, isNotification, isRequest, METHOD_NOT_FOUND, PROTOCOL_VERSION, result, } from "./protocol.js";
+import { callTool, TOOLS } from "./tools.js";
+/**
+ * Handle one message.
+ *
+ * Returns null for a notification, which the caller must then not answer:
+ * some clients treat a reply to a notification as a fatal desync rather than
+ * as noise to ignore.
+ */
+export async function handleMessage(payload, caller, info) {
+    if (!isRequest(payload)) {
+        return failure(null, INVALID_PARAMS, 'Not a JSON-RPC 2.0 request.');
+    }
+    const id = payload.id ?? null;
+    const notification = isNotification(payload);
+    try {
+        switch (payload.method) {
+            case 'initialize':
+                return result(id, {
+                    protocolVersion: PROTOCOL_VERSION,
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: info,
+                    instructions: [
+                        `This is ${caller.server}, an agenticjobs board.`,
+                        '',
+                        'Every listing here was posted by its employer. Nothing is scraped, so an empty',
+                        'search means nobody posted that job rather than that a crawler missed it.',
+                        '',
+                        'To apply: call get_apply_schema first, then apply_to_job with exactly the fields it',
+                        'listed. Listings declare an agent policy of welcome, disclose or human-only; when it',
+                        'is "disclose", pass agentName. Disclosing is not held against a candidate on a board',
+                        'that asked for it.',
+                        '',
+                        'Resumes are Markdown in the OpenResume.md convention.',
+                    ].join('\n'),
+                });
+            case 'notifications/initialized':
+            case 'notifications/cancelled':
+                return null;
+            case 'ping':
+                return notification ? null : result(id, {});
+            case 'tools/list':
+                return result(id, { tools: TOOLS });
+            case 'tools/call': {
+                const params = payload.params ?? {};
+                const name = params['name'];
+                if (typeof name !== 'string') {
+                    return failure(id, INVALID_PARAMS, 'tools/call needs a "name".');
+                }
+                const args = typeof params['arguments'] === 'object' && params['arguments'] !== null
+                    ? params['arguments']
+                    : {};
+                return result(id, await callTool(caller, name, args));
+            }
+            case 'resources/list':
+                return result(id, { resources: [] });
+            case 'prompts/list':
+                return result(id, { prompts: [] });
+            default:
+                return notification ? null : failure(id, METHOD_NOT_FOUND, `No method ${payload.method}.`);
+        }
+    }
+    catch (error) {
+        return failure(id, INTERNAL_ERROR, error instanceof Error ? error.message : 'Something went wrong.');
+    }
+}
+export { TOOLS, callTool };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP over stdio, pointed at a board.
+ *
+ * The same tools the board serves at /api/mcp, hosted in a local process so a
+ * client that only speaks stdio can use a remote board. Credentials come from
+ * the terminal's own config, so `agenticjobs login` is the whole setup.
+ *
+ * Nothing may ever be written to stdout except protocol frames: a stray
+ * console.log corrupts the stream and the client reports a parse error with no
+ * indication of where it came from. Diagnostics go to stderr.
+ */
+import type { BoardClient } from '../client/client.ts';
+export declare function startStdio(client: BoardClient): Promise<void>;

package/dist/mcp/stdio.js

@@ -0,0 +1,85 @@
+/**
+ * MCP over stdio, pointed at a board.
+ *
+ * The same tools the board serves at /api/mcp, hosted in a local process so a
+ * client that only speaks stdio can use a remote board. Credentials come from
+ * the terminal's own config, so `agenticjobs login` is the whole setup.
+ *
+ * Nothing may ever be written to stdout except protocol frames: a stray
+ * console.log corrupts the stream and the client reports a parse error with no
+ * indication of where it came from. Diagnostics go to stderr.
+ */
+import process from 'node:process';
+import { VERSION, SOFTWARE_NAME } from "../config.js";
+import { ApiError } from "../client/client.js";
+import { handleMessage } from "./server.js";
+export async function startStdio(client) {
+    const caller = {
+        server: client.server,
+        authenticated: client.hasToken(),
+        call: async (method, path, body) => {
+            try {
+                const result = await client.request(method, path, body);
+                return { status: 200, body: result };
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    return {
+                        status: error.status,
+                        body: { error: { message: error.message, code: error.code, fields: error.fields } },
+                    };
+                }
+                throw error;
+            }
+        },
+    };
+    const info = { name: `${SOFTWARE_NAME}-mcp`, version: VERSION };
+    process.stderr.write(`${SOFTWARE_NAME}-mcp ${VERSION} -> ${client.server}\n`);
+    let buffer = '';
+    process.stdin.setEncoding('utf8');
+    for await (const chunk of process.stdin) {
+        buffer += chunk;
+        // Line-delimited JSON. A partial line stays in the buffer until the rest
+        // of it arrives, which is the normal case on a busy pipe.
+        let newline = buffer.indexOf('\n');
+        while (newline >= 0) {
+            const line = buffer.slice(0, newline).trim();
+            buffer = buffer.slice(newline + 1);
+            newline = buffer.indexOf('\n');
+            if (line === '')
+                continue;
+            let payload;
+            try {
+                payload = JSON.parse(line);
+            }
+            catch {
+                process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Invalid JSON.' } })}\n`);
+                continue;
+            }
+            const answer = await handleMessage(payload, caller, info);
+            if (answer !== null)
+                process.stdout.write(`${JSON.stringify(answer)}\n`);
+        }
+    }
+}
+// Run directly when this module is the entry point, so the published binary
+// works without the CLI in front of it.
+if (process.argv[1]?.endsWith('agenticjobs-mcp.mjs') === true) {
+    const { BoardClient: Client } = await import("../client/client.js");
+    const { currentBoard, DEFAULT_SERVER, loadConfig, normaliseServer } = await import("../client/config.js");
+    const index = process.argv.indexOf('--server');
+    const explicit = index >= 0 ? process.argv[index + 1] : undefined;
+    let server;
+    let token = null;
+    if (explicit !== undefined) {
+        server = normaliseServer(explicit);
+        token = loadConfig().boards[server]?.token ?? null;
+    }
+    else {
+        const board = currentBoard();
+        server = board?.server ?? DEFAULT_SERVER;
+        token = board?.token ?? null;
+    }
+    await startStdio(new Client(server, { token, userAgent: `agenticjobs-mcp/${VERSION}` }));
+}
+//# sourceMappingURL=stdio.js.map