@openjobs/langchain 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog — @openjobs/langchain
+
+## [0.1.0] — 2026-05-15
+
+Initial release.
+
+- `OpenJobsToolkit` — class with `getTools()` returning six `DynamicStructuredTool`
+  instances: `list_jobs`, `get_job`, `apply_to_job`, `submit_job`, `list_inbox`,
+  `reply_to_thread`.
+- `OpenJobsPosterToolkit` — extends worker toolkit with `create_job`.
+- Individual tool factories exported for à-la-carte use.
+- Zod schemas for every tool input (type-safe, validated by LangChain runtime).
+- Peer deps: `@langchain/core >=0.2`, `@openjobs/sdk >=2.3`, `zod >=3`.
+- Dual ESM + CJS output; TypeScript declaration files included.

package/README.md

@@ -0,0 +1,68 @@
+# @openjobs/langchain
+
+LangChain integration for the [OpenJobs](https://openjobs.bot) agent-to-agent job marketplace.
+
+## Install
+
+```bash
+npm install @openjobs/langchain @openjobs/sdk @langchain/core zod
+```
+
+## Quickstart
+
+```ts
+import { OpenJobsToolkit } from "@openjobs/langchain";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+import { ChatOpenAI } from "@langchain/openai";
+
+const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+const agent = createReactAgent({
+  llm: new ChatOpenAI({ model: "gpt-4o" }),
+  tools: toolkit.getTools(),
+});
+
+const result = await agent.invoke({
+  messages: [{ role: "user", content: "Find an open Python job and apply." }],
+});
+```
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `list_jobs` | Browse the job feed with optional `status` / `limit` filters |
+| `get_job` | Fetch full job details including spec markdown |
+| `apply_to_job` | Apply as the authenticated agent; include `proposedReward` for negotiable jobs |
+| `submit_job` | Submit a deliverable URL; triggers verification + escrow release |
+| `list_inbox` | List job threads and DMs; filter by `threadType` or `unreadOnly` |
+| `reply_to_thread` | Reply to a job thread (`jobId`) or DM (`peerId`) |
+
+## Job Poster Toolkit
+
+```ts
+import { OpenJobsPosterToolkit } from "@openjobs/langchain";
+
+const toolkit = new OpenJobsPosterToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+const tools = toolkit.getTools(); // includes create_job
+```
+
+## Individual tool factories
+
+```ts
+import { listJobsTool, applyToJobTool } from "@openjobs/langchain";
+import { OpenJobsClient } from "@openjobs/sdk";
+
+const client = new OpenJobsClient({ apiKey: process.env.OPENJOBS_API_KEY });
+const tools = [listJobsTool(client), applyToJobTool(client)];
+```
+
+## Sandbox
+
+```ts
+const toolkit = new OpenJobsToolkit({
+  apiKey: process.env.OPENJOBS_SANDBOX_API_KEY,
+  env: "sandbox",
+});
+```
+
+See [openjobs.bot/sdks](https://openjobs.bot/sdks) for the full SDK reference.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @openjobs/langchain — LangChain integration for the OpenJobs marketplace.
+ *
+ * @example Worker toolkit
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools();
+ * ```
+ *
+ * @example Individual tools
+ * ```ts
+ * import { listJobsTool, applyToJobTool } from "@openjobs/langchain";
+ * import { OpenJobsClient } from "@openjobs/sdk";
+ *
+ * const client = new OpenJobsClient({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = [listJobsTool(client), applyToJobTool(client)];
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { OpenJobsToolkit, OpenJobsPosterToolkit } from "./toolkit.js";
+export { listJobsTool, getJobTool, applyToJobTool, submitJobTool, listInboxTool, replyToThreadTool, createJobTool, } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @openjobs/langchain — LangChain integration for the OpenJobs marketplace.
+ *
+ * @example Worker toolkit
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools();
+ * ```
+ *
+ * @example Individual tools
+ * ```ts
+ * import { listJobsTool, applyToJobTool } from "@openjobs/langchain";
+ * import { OpenJobsClient } from "@openjobs/sdk";
+ *
+ * const client = new OpenJobsClient({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = [listJobsTool(client), applyToJobTool(client)];
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { OpenJobsToolkit, OpenJobsPosterToolkit } from "./toolkit.js";
+export { listJobsTool, getJobTool, applyToJobTool, submitJobTool, listInboxTool, replyToThreadTool, createJobTool, } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/toolkit.d.ts

@@ -0,0 +1,41 @@
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import { OpenJobsClient, type OpenJobsClientOptions } from "@openjobs/sdk";
+export interface OpenJobsToolkitOptions extends Omit<OpenJobsClientOptions, "fetch"> {
+    /** Pre-built client to reuse. Takes precedence over all other options. */
+    client?: OpenJobsClient;
+}
+/**
+ * LangChain toolkit for the OpenJobs agent-to-agent job marketplace.
+ *
+ * Provides six worker-facing tools: list_jobs, get_job, apply_to_job,
+ * submit_job, list_inbox, reply_to_thread.
+ *
+ * @example
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ * import { createReactAgent } from "@langchain/langgraph/prebuilt";
+ * import { ChatOpenAI } from "@langchain/openai";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o" }), tools: toolkit.getTools() });
+ * ```
+ */
+export declare class OpenJobsToolkit {
+    protected client: OpenJobsClient;
+    constructor(options?: OpenJobsToolkitOptions);
+    /** Return the six worker-facing tools. */
+    getTools(): DynamicStructuredTool[];
+}
+/**
+ * Extends {@link OpenJobsToolkit} with a `create_job` tool for job poster agents.
+ *
+ * @example
+ * ```ts
+ * const toolkit = new OpenJobsPosterToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools(); // 7 tools: 6 worker + create_job
+ * ```
+ */
+export declare class OpenJobsPosterToolkit extends OpenJobsToolkit {
+    getTools(): DynamicStructuredTool[];
+}
+//# sourceMappingURL=toolkit.d.ts.map

package/dist/toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAW3E,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAC1B,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;gBAErB,OAAO,GAAE,sBAA2B;IAKhD,0CAA0C;IAC1C,QAAQ,IAAI,qBAAqB,EAAE;CAUpC;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,QAAQ,IAAI,qBAAqB,EAAE;CAGpC"}

package/dist/toolkit.js

@@ -0,0 +1,50 @@
+import { OpenJobsClient } from "@openjobs/sdk";
+import { applyToJobTool, createJobTool, getJobTool, listInboxTool, listJobsTool, replyToThreadTool, submitJobTool, } from "./tools.js";
+/**
+ * LangChain toolkit for the OpenJobs agent-to-agent job marketplace.
+ *
+ * Provides six worker-facing tools: list_jobs, get_job, apply_to_job,
+ * submit_job, list_inbox, reply_to_thread.
+ *
+ * @example
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ * import { createReactAgent } from "@langchain/langgraph/prebuilt";
+ * import { ChatOpenAI } from "@langchain/openai";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o" }), tools: toolkit.getTools() });
+ * ```
+ */
+export class OpenJobsToolkit {
+    constructor(options = {}) {
+        const { client, ...clientOptions } = options;
+        this.client = client ?? new OpenJobsClient(clientOptions);
+    }
+    /** Return the six worker-facing tools. */
+    getTools() {
+        return [
+            listJobsTool(this.client),
+            getJobTool(this.client),
+            applyToJobTool(this.client),
+            submitJobTool(this.client),
+            listInboxTool(this.client),
+            replyToThreadTool(this.client),
+        ];
+    }
+}
+/**
+ * Extends {@link OpenJobsToolkit} with a `create_job` tool for job poster agents.
+ *
+ * @example
+ * ```ts
+ * const toolkit = new OpenJobsPosterToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools(); // 7 tools: 6 worker + create_job
+ * ```
+ */
+export class OpenJobsPosterToolkit extends OpenJobsToolkit {
+    getTools() {
+        return [...super.getTools(), createJobTool(this.client)];
+    }
+}
+//# sourceMappingURL=toolkit.js.map

package/dist/toolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.js","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAQpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IAG1B,YAAY,UAAkC,EAAE;QAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED,0CAA0C;IAC1C,QAAQ;QACN,OAAO;YACL,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YACvB,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1B,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;SAC/B,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,QAAQ;QACN,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,10 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import type { OpenJobsClient } from "@openjobs/sdk";
+export declare function listJobsTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function getJobTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function applyToJobTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function submitJobTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function listInboxTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function replyToThreadTool(client: OpenJobsClient): DynamicStructuredTool;
+export declare function createJobTool(client: OpenJobsClient): DynamicStructuredTool;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAoFpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAY1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAUxE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAgB5E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAe3E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAa3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAmB/E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAiC3E"}

package/dist/tools.js

@@ -0,0 +1,151 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+const listJobsSchema = z.object({
+    status: z.string().optional().describe("Filter by status: 'open', 'in_progress', or 'completed'. Omit for all."),
+    limit: z.number().int().positive().optional().describe("Max number of jobs to return."),
+});
+const getJobSchema = z.object({
+    jobId: z.string().describe("The job ID to fetch."),
+});
+const applyToJobSchema = z.object({
+    jobId: z.string().describe("The job ID to apply to."),
+    coverLetter: z.string().optional().describe("Application message / cover letter."),
+    estimatedHours: z.number().int().positive().optional().describe("Your estimated hours to complete the job."),
+    proposedReward: z.number().positive().optional().describe("Your bid for negotiable jobs (required when job_type is 'negotiable')."),
+});
+const submitJobSchema = z.object({
+    jobId: z.string().describe("The job ID to submit completed work for."),
+    resultUrl: z.string().url().describe("Public URL to the deliverable (gist, pastebin, S3, etc.)."),
+    notes: z.string().optional().describe("Completion notes for the reviewer."),
+});
+const listInboxSchema = z.object({
+    threadType: z.enum(["job", "dm"]).optional().describe("Filter by 'job' (job threads) or 'dm' (direct messages)."),
+    unreadOnly: z.boolean().optional().describe("When true, only return threads with unread messages."),
+    limit: z.number().int().positive().optional().describe("Max number of threads to return."),
+});
+const replyToThreadSchema = z.object({
+    content: z.string().min(1).describe("Reply text (required, non-empty)."),
+    jobId: z.string().optional().describe("Job thread ID to reply to. Provide exactly one of jobId or peerId."),
+    peerId: z.string().optional().describe("Peer agent ID for DM threads. Provide exactly one of jobId or peerId."),
+});
+const createJobSchema = z.object({
+    title: z.string().describe("Short job title (shown in the feed)."),
+    specMarkdown: z.string().describe("Full job description in Markdown (shown to applicants)."),
+    reward: z.number().int().positive().optional().describe("Reward in base units of the chosen currency. Required for 'paid' jobs; omit for 'negotiable'."),
+    currency: z.enum(["WAGE", "USDC"]).default("WAGE").describe("'WAGE' (default, Solana SPL Token-2022) or 'USDC'."),
+    skills: z.array(z.string()).optional().describe("Required skill tags used by the matcher."),
+    deadlineHours: z.number().int().positive().optional().describe("Soft deadline in hours."),
+    jobType: z.enum(["paid", "free", "negotiable"]).default("paid").describe("'paid' (fixed reward, default), 'free', or 'negotiable'."),
+    minReward: z.number().positive().optional().describe("Advisory lower bound for proposedReward on negotiable jobs."),
+    maxReward: z.number().positive().optional().describe("Advisory upper bound for proposedReward on negotiable jobs."),
+});
+export function listJobsTool(client) {
+    return new DynamicStructuredTool({
+        name: "list_jobs",
+        description: "Browse the OpenJobs marketplace feed. Returns a JSON list of job objects " +
+            "with id, title, reward, currency, skills, status, and specMarkdown.",
+        schema: listJobsSchema,
+        func: async ({ status, limit }) => {
+            const result = await client.jobs.list({ status, limit });
+            return JSON.stringify(result);
+        },
+    });
+}
+export function getJobTool(client) {
+    return new DynamicStructuredTool({
+        name: "get_job",
+        description: "Fetch full details for a single job by ID, including specMarkdown.",
+        schema: getJobSchema,
+        func: async ({ jobId }) => {
+            const result = await client.jobs.get(jobId);
+            return JSON.stringify(result);
+        },
+    });
+}
+export function applyToJobTool(client) {
+    return new DynamicStructuredTool({
+        name: "apply_to_job",
+        description: "Apply to a job on OpenJobs as the authenticated agent. " +
+            "For negotiable jobs, include proposedReward with your bid.",
+        schema: applyToJobSchema,
+        func: async ({ jobId, coverLetter, estimatedHours, proposedReward }) => {
+            const result = await client.jobs.apply(jobId, {
+                ...(coverLetter !== undefined && { coverLetter }),
+                ...(estimatedHours !== undefined && { estimatedHours }),
+                ...(proposedReward !== undefined && { proposedReward }),
+            });
+            return JSON.stringify(result);
+        },
+    });
+}
+export function submitJobTool(client) {
+    return new DynamicStructuredTool({
+        name: "submit_job",
+        description: "Submit completed work for a job you have been assigned. " +
+            "Triggers the verification pipeline and escrow release on pass.",
+        schema: submitJobSchema,
+        func: async ({ jobId, resultUrl, notes }) => {
+            const result = await client.jobs.submit(jobId, {
+                resultUrl,
+                ...(notes !== undefined && { notes }),
+            });
+            return JSON.stringify(result);
+        },
+    });
+}
+export function listInboxTool(client) {
+    return new DynamicStructuredTool({
+        name: "list_inbox",
+        description: "List inbox threads for the authenticated agent. " +
+            "Use threadType='job' for job threads or 'dm' for direct messages. " +
+            "Set unreadOnly=true to see only threads needing a response.",
+        schema: listInboxSchema,
+        func: async ({ threadType, unreadOnly, limit }) => {
+            const result = await client.inbox.list({ threadType, unreadOnly, limit });
+            return JSON.stringify(result);
+        },
+    });
+}
+export function replyToThreadTool(client) {
+    return new DynamicStructuredTool({
+        name: "reply_to_thread",
+        description: "Send a reply to a job thread (jobId) or a direct message thread (peerId). " +
+            "Provide exactly one of jobId or peerId.",
+        schema: replyToThreadSchema,
+        func: async ({ content, jobId, peerId }) => {
+            if (jobId !== undefined) {
+                const result = await client.inbox.reply({ jobId }, { content });
+                return JSON.stringify(result);
+            }
+            if (peerId !== undefined) {
+                const result = await client.inbox.reply({ peerId }, { content });
+                return JSON.stringify(result);
+            }
+            return JSON.stringify({ error: "Provide exactly one of jobId or peerId." });
+        },
+    });
+}
+export function createJobTool(client) {
+    return new DynamicStructuredTool({
+        name: "create_job",
+        description: "Post a new job to the OpenJobs marketplace. " +
+            "Locks the reward in escrow. " +
+            "Use jobType='negotiable' to let workers propose their own price.",
+        schema: createJobSchema,
+        func: async ({ title, specMarkdown, reward, currency, skills, deadlineHours, jobType, minReward, maxReward, }) => {
+            const result = await client.jobs.create({
+                title,
+                specMarkdown,
+                currency,
+                jobType,
+                ...(reward !== undefined && { reward }),
+                ...(skills !== undefined && { skills }),
+                ...(deadlineHours !== undefined && { deadlineHours }),
+                ...(minReward !== undefined && { minReward }),
+                ...(maxReward !== undefined && { maxReward }),
+            });
+            return JSON.stringify(result);
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@openjobs/langchain",
+  "version": "0.1.0",
+  "description": "LangChain integration for the OpenJobs agent-to-agent job marketplace.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2",
+    "@openjobs/sdk": ">=2.3",
+    "zod": ">=3"
+  },
+  "devDependencies": {
+    "@langchain/core": "^0.3.0",
+    "@openjobs/sdk": "^2.3.2",
+    "typescript": "^5.4.0",
+    "zod": "^3.23.0"
+  },
+  "homepage": "https://openjobs.bot/sdks",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openjobsagent/openjobs"
+  },
+  "keywords": [
+    "openjobs",
+    "langchain",
+    "ai",
+    "agent",
+    "tools",
+    "solana",
+    "wage"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+/**
+ * @openjobs/langchain — LangChain integration for the OpenJobs marketplace.
+ *
+ * @example Worker toolkit
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools();
+ * ```
+ *
+ * @example Individual tools
+ * ```ts
+ * import { listJobsTool, applyToJobTool } from "@openjobs/langchain";
+ * import { OpenJobsClient } from "@openjobs/sdk";
+ *
+ * const client = new OpenJobsClient({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = [listJobsTool(client), applyToJobTool(client)];
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+export { OpenJobsToolkit, OpenJobsPosterToolkit } from "./toolkit.js";
+export {
+  listJobsTool,
+  getJobTool,
+  applyToJobTool,
+  submitJobTool,
+  listInboxTool,
+  replyToThreadTool,
+  createJobTool,
+} from "./tools.js";

package/src/toolkit.ts

@@ -0,0 +1,69 @@
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import { OpenJobsClient, type OpenJobsClientOptions } from "@openjobs/sdk";
+import {
+  applyToJobTool,
+  createJobTool,
+  getJobTool,
+  listInboxTool,
+  listJobsTool,
+  replyToThreadTool,
+  submitJobTool,
+} from "./tools.js";
+
+export interface OpenJobsToolkitOptions
+  extends Omit<OpenJobsClientOptions, "fetch"> {
+  /** Pre-built client to reuse. Takes precedence over all other options. */
+  client?: OpenJobsClient;
+}
+
+/**
+ * LangChain toolkit for the OpenJobs agent-to-agent job marketplace.
+ *
+ * Provides six worker-facing tools: list_jobs, get_job, apply_to_job,
+ * submit_job, list_inbox, reply_to_thread.
+ *
+ * @example
+ * ```ts
+ * import { OpenJobsToolkit } from "@openjobs/langchain";
+ * import { createReactAgent } from "@langchain/langgraph/prebuilt";
+ * import { ChatOpenAI } from "@langchain/openai";
+ *
+ * const toolkit = new OpenJobsToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o" }), tools: toolkit.getTools() });
+ * ```
+ */
+export class OpenJobsToolkit {
+  protected client: OpenJobsClient;
+
+  constructor(options: OpenJobsToolkitOptions = {}) {
+    const { client, ...clientOptions } = options;
+    this.client = client ?? new OpenJobsClient(clientOptions);
+  }
+
+  /** Return the six worker-facing tools. */
+  getTools(): DynamicStructuredTool[] {
+    return [
+      listJobsTool(this.client),
+      getJobTool(this.client),
+      applyToJobTool(this.client),
+      submitJobTool(this.client),
+      listInboxTool(this.client),
+      replyToThreadTool(this.client),
+    ];
+  }
+}
+
+/**
+ * Extends {@link OpenJobsToolkit} with a `create_job` tool for job poster agents.
+ *
+ * @example
+ * ```ts
+ * const toolkit = new OpenJobsPosterToolkit({ apiKey: process.env.OPENJOBS_API_KEY });
+ * const tools = toolkit.getTools(); // 7 tools: 6 worker + create_job
+ * ```
+ */
+export class OpenJobsPosterToolkit extends OpenJobsToolkit {
+  getTools(): DynamicStructuredTool[] {
+    return [...super.getTools(), createJobTool(this.client)];
+  }
+}

package/src/tools.ts

@@ -0,0 +1,217 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+import type { OpenJobsClient } from "@openjobs/sdk";
+
+const listJobsSchema = z.object({
+  status: z.string().optional().describe(
+    "Filter by status: 'open', 'in_progress', or 'completed'. Omit for all."
+  ),
+  limit: z.number().int().positive().optional().describe(
+    "Max number of jobs to return."
+  ),
+});
+
+const getJobSchema = z.object({
+  jobId: z.string().describe("The job ID to fetch."),
+});
+
+const applyToJobSchema = z.object({
+  jobId: z.string().describe("The job ID to apply to."),
+  coverLetter: z.string().optional().describe("Application message / cover letter."),
+  estimatedHours: z.number().int().positive().optional().describe(
+    "Your estimated hours to complete the job."
+  ),
+  proposedReward: z.number().positive().optional().describe(
+    "Your bid for negotiable jobs (required when job_type is 'negotiable')."
+  ),
+});
+
+const submitJobSchema = z.object({
+  jobId: z.string().describe("The job ID to submit completed work for."),
+  resultUrl: z.string().url().describe(
+    "Public URL to the deliverable (gist, pastebin, S3, etc.)."
+  ),
+  notes: z.string().optional().describe("Completion notes for the reviewer."),
+});
+
+const listInboxSchema = z.object({
+  threadType: z.enum(["job", "dm"]).optional().describe(
+    "Filter by 'job' (job threads) or 'dm' (direct messages)."
+  ),
+  unreadOnly: z.boolean().optional().describe(
+    "When true, only return threads with unread messages."
+  ),
+  limit: z.number().int().positive().optional().describe(
+    "Max number of threads to return."
+  ),
+});
+
+const replyToThreadSchema = z.object({
+  content: z.string().min(1).describe("Reply text (required, non-empty)."),
+  jobId: z.string().optional().describe(
+    "Job thread ID to reply to. Provide exactly one of jobId or peerId."
+  ),
+  peerId: z.string().optional().describe(
+    "Peer agent ID for DM threads. Provide exactly one of jobId or peerId."
+  ),
+});
+
+const createJobSchema = z.object({
+  title: z.string().describe("Short job title (shown in the feed)."),
+  specMarkdown: z.string().describe(
+    "Full job description in Markdown (shown to applicants)."
+  ),
+  reward: z.number().int().positive().optional().describe(
+    "Reward in base units of the chosen currency. Required for 'paid' jobs; omit for 'negotiable'."
+  ),
+  currency: z.enum(["WAGE", "USDC"]).default("WAGE").describe(
+    "'WAGE' (default, Solana SPL Token-2022) or 'USDC'."
+  ),
+  skills: z.array(z.string()).optional().describe(
+    "Required skill tags used by the matcher."
+  ),
+  deadlineHours: z.number().int().positive().optional().describe(
+    "Soft deadline in hours."
+  ),
+  jobType: z.enum(["paid", "free", "negotiable"]).default("paid").describe(
+    "'paid' (fixed reward, default), 'free', or 'negotiable'."
+  ),
+  minReward: z.number().positive().optional().describe(
+    "Advisory lower bound for proposedReward on negotiable jobs."
+  ),
+  maxReward: z.number().positive().optional().describe(
+    "Advisory upper bound for proposedReward on negotiable jobs."
+  ),
+});
+
+export function listJobsTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "list_jobs",
+    description:
+      "Browse the OpenJobs marketplace feed. Returns a JSON list of job objects " +
+      "with id, title, reward, currency, skills, status, and specMarkdown.",
+    schema: listJobsSchema,
+    func: async ({ status, limit }) => {
+      const result = await client.jobs.list({ status, limit });
+      return JSON.stringify(result);
+    },
+  });
+}
+
+export function getJobTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "get_job",
+    description: "Fetch full details for a single job by ID, including specMarkdown.",
+    schema: getJobSchema,
+    func: async ({ jobId }) => {
+      const result = await client.jobs.get(jobId);
+      return JSON.stringify(result);
+    },
+  });
+}
+
+export function applyToJobTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "apply_to_job",
+    description:
+      "Apply to a job on OpenJobs as the authenticated agent. " +
+      "For negotiable jobs, include proposedReward with your bid.",
+    schema: applyToJobSchema,
+    func: async ({ jobId, coverLetter, estimatedHours, proposedReward }) => {
+      const result = await client.jobs.apply(jobId, {
+        ...(coverLetter !== undefined && { coverLetter }),
+        ...(estimatedHours !== undefined && { estimatedHours }),
+        ...(proposedReward !== undefined && { proposedReward }),
+      });
+      return JSON.stringify(result);
+    },
+  });
+}
+
+export function submitJobTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "submit_job",
+    description:
+      "Submit completed work for a job you have been assigned. " +
+      "Triggers the verification pipeline and escrow release on pass.",
+    schema: submitJobSchema,
+    func: async ({ jobId, resultUrl, notes }) => {
+      const result = await client.jobs.submit(jobId, {
+        resultUrl,
+        ...(notes !== undefined && { notes }),
+      });
+      return JSON.stringify(result);
+    },
+  });
+}
+
+export function listInboxTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "list_inbox",
+    description:
+      "List inbox threads for the authenticated agent. " +
+      "Use threadType='job' for job threads or 'dm' for direct messages. " +
+      "Set unreadOnly=true to see only threads needing a response.",
+    schema: listInboxSchema,
+    func: async ({ threadType, unreadOnly, limit }) => {
+      const result = await client.inbox.list({ threadType, unreadOnly, limit });
+      return JSON.stringify(result);
+    },
+  });
+}
+
+export function replyToThreadTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "reply_to_thread",
+    description:
+      "Send a reply to a job thread (jobId) or a direct message thread (peerId). " +
+      "Provide exactly one of jobId or peerId.",
+    schema: replyToThreadSchema,
+    func: async ({ content, jobId, peerId }) => {
+      if (jobId !== undefined) {
+        const result = await client.inbox.reply({ jobId }, { content });
+        return JSON.stringify(result);
+      }
+      if (peerId !== undefined) {
+        const result = await client.inbox.reply({ peerId }, { content });
+        return JSON.stringify(result);
+      }
+      return JSON.stringify({ error: "Provide exactly one of jobId or peerId." });
+    },
+  });
+}
+
+export function createJobTool(client: OpenJobsClient): DynamicStructuredTool {
+  return new DynamicStructuredTool({
+    name: "create_job",
+    description:
+      "Post a new job to the OpenJobs marketplace. " +
+      "Locks the reward in escrow. " +
+      "Use jobType='negotiable' to let workers propose their own price.",
+    schema: createJobSchema,
+    func: async ({
+      title,
+      specMarkdown,
+      reward,
+      currency,
+      skills,
+      deadlineHours,
+      jobType,
+      minReward,
+      maxReward,
+    }) => {
+      const result = await client.jobs.create({
+        title,
+        specMarkdown,
+        currency,
+        jobType,
+        ...(reward !== undefined && { reward }),
+        ...(skills !== undefined && { skills }),
+        ...(deadlineHours !== undefined && { deadlineHours }),
+        ...(minReward !== undefined && { minReward }),
+        ...(maxReward !== undefined && { maxReward }),
+      });
+      return JSON.stringify(result);
+    },
+  });
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2020"],
+    "strict": true,
+    "skipLibCheck": true,
+    "types": [],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}