@agentworkforce/mcp-workforce 0.0.0 → 3.0.2

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runStdioServer } from './server.js';
+runStdioServer().catch((err) => {
+    process.stderr.write(`[workforce-mcp] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Resolved configuration for a running MCP-workforce server. The runtime
+ * sets these env vars when it spawns the harness via `ctx.harness.run`;
+ * a stand-alone `npx @agentworkforce/mcp-workforce` invocation reads
+ * them from the user's shell.
+ */
+export interface WorkforceMcpConfig {
+    /** Workspace this server is bound to. Required. */
+    workspaceId: string;
+    /** Persona id the harness is currently running under. Optional. */
+    personaId?: string;
+    /** Workspace-scoped token used for workflow + cloud API calls. */
+    runtimeToken?: string;
+    /** Workforce cloud base URL. */
+    cloudUrl: string;
+    /** Supermemory API key (memory tools). */
+    supermemoryApiKey?: string;
+    /** Supermemory endpoint override. */
+    supermemoryEndpoint?: string;
+    /**
+     * Relayfile mount root. Integration clients read/write canonical
+     * JSON files under this path; Relayfile's writeback worker turns
+     * those file operations into the real provider API calls. Required
+     * for any `integration.*` tool to function.
+     */
+    relayfileMountRoot?: string;
+    /**
+     * Default writeback timeout for integration calls that block on a
+     * receipt (createIssue, comment, etc.). Defaults to 30s; the
+     * runtime overrides this via `WORKFORCE_WRITEBACK_TIMEOUT_MS` when
+     * a persona configures it.
+     */
+    writebackTimeoutMs: number;
+}
+/**
+ * Build the config from a snapshot of the env. `loadConfig()` reads from
+ * `process.env` by default; tests pass a fixture object. Returns an
+ * object with the workspaceId guaranteed; everything else is optional and
+ * tool implementations check at call time.
+ */
+export declare function loadConfig(env?: NodeJS.ProcessEnv): WorkforceMcpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAKD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,kBAAkB,CAiCnF"}

package/dist/config.js

@@ -0,0 +1,39 @@
+const DEFAULT_CLOUD_URL = 'https://cloud.agentworkforce.com';
+const DEFAULT_WRITEBACK_TIMEOUT_MS = 30_000;
+/**
+ * Build the config from a snapshot of the env. `loadConfig()` reads from
+ * `process.env` by default; tests pass a fixture object. Returns an
+ * object with the workspaceId guaranteed; everything else is optional and
+ * tool implementations check at call time.
+ */
+export function loadConfig(env = process.env) {
+    const workspaceId = (env.WORKFORCE_WORKSPACE_ID ?? '').trim();
+    if (!workspaceId) {
+        throw new Error('WORKFORCE_WORKSPACE_ID is required to start the workforce MCP server. The workforce runtime sets this automatically when spawning the harness; if you are running the server stand-alone, export it before invoking workforce-mcp.');
+    }
+    const writebackRaw = (env.WORKFORCE_WRITEBACK_TIMEOUT_MS ?? '').trim();
+    const writebackTimeoutMs = writebackRaw
+        ? Math.max(0, Number.parseInt(writebackRaw, 10) || DEFAULT_WRITEBACK_TIMEOUT_MS)
+        : DEFAULT_WRITEBACK_TIMEOUT_MS;
+    return {
+        workspaceId,
+        ...(env.WORKFORCE_PERSONA_ID?.trim() ? { personaId: env.WORKFORCE_PERSONA_ID.trim() } : {}),
+        ...(env.WORKFORCE_RUNTIME_TOKEN?.trim()
+            ? { runtimeToken: env.WORKFORCE_RUNTIME_TOKEN.trim() }
+            : {}),
+        cloudUrl: (env.WORKFORCE_CLOUD_URL?.trim() || DEFAULT_CLOUD_URL).replace(/\/$/, ''),
+        ...(env.SUPERMEMORY_API_KEY?.trim()
+            ? { supermemoryApiKey: env.SUPERMEMORY_API_KEY.trim() }
+            : {}),
+        ...(env.SUPERMEMORY_ENDPOINT?.trim()
+            ? { supermemoryEndpoint: env.SUPERMEMORY_ENDPOINT.trim() }
+            : {}),
+        ...(env.RELAYFILE_MOUNT_ROOT?.trim()
+            ? { relayfileMountRoot: env.RELAYFILE_MOUNT_ROOT.trim() }
+            : env.RELAYFILE_ROOT?.trim()
+                ? { relayfileMountRoot: env.RELAYFILE_ROOT.trim() }
+                : {}),
+        writebackTimeoutMs
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAmCA,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAC7D,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oOAAoO,CACrO,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,MAAM,kBAAkB,GAAG,YAAY;QACrC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,4BAA4B,CAAC;QAChF,CAAC,CAAC,4BAA4B,CAAC;IAEjC,OAAO;QACL,WAAW;QACX,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE;YACrC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,uBAAuB,CAAC,IAAI,EAAE,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,EAAE,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACnF,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE;YACjC,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE;YACvD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;YAClC,CAAC,CAAC,EAAE,mBAAmB,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE;YAC1D,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;YAClC,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE;YACzD,CAAC,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE;gBAC1B,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;QACT,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,47 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { loadConfig } from './config.js';
+test('loadConfig requires WORKFORCE_WORKSPACE_ID', () => {
+    assert.throws(() => loadConfig({}), /WORKFORCE_WORKSPACE_ID is required/);
+    assert.throws(() => loadConfig({ WORKFORCE_WORKSPACE_ID: '   ' }), /WORKFORCE_WORKSPACE_ID is required/);
+});
+test('loadConfig trims env values and applies sensible defaults', () => {
+    const config = loadConfig({
+        WORKFORCE_WORKSPACE_ID: '  ws-demo  ',
+        WORKFORCE_PERSONA_ID: ' reviewer ',
+        WORKFORCE_RUNTIME_TOKEN: ' tok '
+    });
+    assert.equal(config.workspaceId, 'ws-demo');
+    assert.equal(config.personaId, 'reviewer');
+    assert.equal(config.runtimeToken, 'tok');
+    assert.equal(config.cloudUrl, 'https://cloud.agentworkforce.com');
+    assert.equal(config.writebackTimeoutMs, 30_000);
+    assert.equal(config.relayfileMountRoot, undefined);
+});
+test('loadConfig picks up RELAYFILE_MOUNT_ROOT (and RELAYFILE_ROOT as a fallback)', () => {
+    const fromMountRoot = loadConfig({
+        WORKFORCE_WORKSPACE_ID: 'ws',
+        RELAYFILE_MOUNT_ROOT: '  /mnt/relayfile  '
+    });
+    assert.equal(fromMountRoot.relayfileMountRoot, '/mnt/relayfile');
+    const fromLegacyAlias = loadConfig({
+        WORKFORCE_WORKSPACE_ID: 'ws',
+        RELAYFILE_ROOT: '/mnt/legacy'
+    });
+    assert.equal(fromLegacyAlias.relayfileMountRoot, '/mnt/legacy');
+});
+test('loadConfig honors WORKFORCE_WRITEBACK_TIMEOUT_MS', () => {
+    const config = loadConfig({
+        WORKFORCE_WORKSPACE_ID: 'ws',
+        WORKFORCE_WRITEBACK_TIMEOUT_MS: '5000'
+    });
+    assert.equal(config.writebackTimeoutMs, 5000);
+});
+test('loadConfig normalizes the cloudUrl by stripping a trailing slash', () => {
+    const config = loadConfig({
+        WORKFORCE_WORKSPACE_ID: 'ws',
+        WORKFORCE_CLOUD_URL: 'https://cloud.example.com/'
+    });
+    assert.equal(config.cloudUrl, 'https://cloud.example.com');
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACtD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,oCAAoC,CAAC,CAAC;IAC1E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,oCAAoC,CAAC,CAAC;AAC3G,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,sBAAsB,EAAE,aAAa;QACrC,oBAAoB,EAAE,YAAY;QAClC,uBAAuB,EAAE,OAAO;KACjC,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACvF,MAAM,aAAa,GAAG,UAAU,CAAC;QAC/B,sBAAsB,EAAE,IAAI;QAC5B,oBAAoB,EAAE,oBAAoB;KAC3C,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAEjE,MAAM,eAAe,GAAG,UAAU,CAAC;QACjC,sBAAsB,EAAE,IAAI;QAC5B,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,sBAAsB,EAAE,IAAI;QAC5B,8BAA8B,EAAE,MAAM;KACvC,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,sBAAsB,EAAE,IAAI;QAC5B,mBAAmB,EAAE,4BAA4B;KAClD,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { loadConfig, type WorkforceMcpConfig } from './config.js';
+export { createWorkforceMcpServer, runStdioServer } from './server.js';
+export { memorySave, memoryRecall, type MemoryItem, type MemoryRecallArgs, type MemorySaveArgs, type MemoryToolDeps } from './tools/memory.js';
+export { workflowRun, workflowStatus, type WorkflowRunResult, type WorkflowStatusResult, type WorkflowToolDeps } from './tools/workflow.js';
+export { dispatchIntegration, INTEGRATION_TOOL_NAMES, _resetIntegrationCache, type IntegrationToolDeps, type IntegrationToolName } from './tools/integrations.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,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { loadConfig } from './config.js';
+export { createWorkforceMcpServer, runStdioServer } from './server.js';
+export { memorySave, memoryRecall } from './tools/memory.js';
+export { workflowRun, workflowStatus } from './tools/workflow.js';
+export { dispatchIntegration, INTEGRATION_TOOL_NAMES, _resetIntegrationCache } from './tools/integrations.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,OAAO,EAAE,UAAU,EAA2B,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,UAAU,EACV,YAAY,EAKb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EAGvB,MAAM,yBAAyB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,32 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type WorkforceMcpConfig } from './config.js';
+import { INTEGRATION_TOOL_NAMES, type IntegrationToolName } from './tools/integrations.js';
+/**
+ * Build an `McpServer` with workforce-flavored tools registered. Exposed
+ * separately from the bin entry so tests can drive the server in-process
+ * without piping stdio.
+ */
+export declare function createWorkforceMcpServer(config: WorkforceMcpConfig): McpServer;
+/**
+ * Wrap a tool's return value in the MCP `CallToolResult` shape. We use
+ * JSON-text encoding so any client can read it; structured-output schemas
+ * are a follow-up if real consumers want them.
+ *
+ * Void-returning tools (e.g. `integration.github.postReview`) must still
+ * produce a real text payload — `JSON.stringify(undefined)` returns
+ * `undefined`, not a valid JSON string, so the MCP response would fail
+ * its content-shape check. Normalize `undefined` to a sentinel `{ ok:
+ * true }` so consumers see a stable response.
+ */
+export declare function jsonResult(value: unknown): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    [key: string]: unknown;
+};
+/** Server lifetime helper for the bin entry. */
+export declare function runStdioServer(config?: WorkforceMcpConfig): Promise<void>;
+/** Re-exported for callers wanting the typed integration name list. */
+export { INTEGRATION_TOOL_NAMES, type IntegrationToolName };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAEL,sBAAsB,EACtB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAIjC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAmF9E;AAwGD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAUrH;AAED,gDAAgD;AAChD,wBAAsB,cAAc,CAAC,MAAM,GAAE,kBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F;AAED,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/server.js

@@ -0,0 +1,167 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { loadConfig } from './config.js';
+import { memoryRecall, memorySave } from './tools/memory.js';
+import { workflowRun, workflowStatus } from './tools/workflow.js';
+import { dispatchIntegration, INTEGRATION_TOOL_NAMES } from './tools/integrations.js';
+const MEMORY_SCOPE_ENUM = z.enum(['workspace', 'user', 'global']);
+/**
+ * Build an `McpServer` with workforce-flavored tools registered. Exposed
+ * separately from the bin entry so tests can drive the server in-process
+ * without piping stdio.
+ */
+export function createWorkforceMcpServer(config) {
+    const server = new McpServer({ name: '@agentworkforce/mcp-workforce', version: '0.0.0' }, { capabilities: { tools: {} } });
+    // ─── workflow.* ──────────────────────────────────────────────────────
+    server.registerTool('workflow.run', {
+        title: 'Run a workforce cloud workflow',
+        description: 'Invoke a named workflow against the active workspace and return the run id + initial status. Long-running workflows are polled via workflow.status.',
+        inputSchema: {
+            name: z.string().min(1),
+            args: z.record(z.string(), z.unknown()).optional()
+        }
+    }, async (args) => {
+        const result = await workflowRun({ name: args.name, args: args.args }, { config });
+        return jsonResult(result);
+    });
+    server.registerTool('workflow.status', {
+        title: 'Get workflow run status',
+        description: 'Poll a previously-started workflow run for status, output, and error fields.',
+        inputSchema: {
+            runId: z.string().min(1)
+        }
+    }, async (args) => {
+        const result = await workflowStatus({ runId: args.runId }, { config });
+        return jsonResult(result);
+    });
+    // ─── memory.* ────────────────────────────────────────────────────────
+    server.registerTool('memory.save', {
+        title: 'Save a memory entry',
+        description: 'Persist a memory entry for the active workspace. Scope is one of workspace (default) / user / global, matching @agentworkforce/persona-kit\'s PersonaMemoryScope. Tags are deduped; workspace/scope tags are added automatically.',
+        inputSchema: {
+            content: z.string().min(1),
+            tags: z.array(z.string()).optional(),
+            scope: MEMORY_SCOPE_ENUM.optional()
+        }
+    }, async (args) => {
+        const result = await memorySave(args, { config });
+        return jsonResult(result);
+    });
+    server.registerTool('memory.recall', {
+        title: 'Search memory',
+        description: 'Semantic search over the workspace memory bag. Returns up to `limit` items (default 5, max 50).',
+        inputSchema: {
+            query: z.string().min(1),
+            limit: z.number().int().min(1).max(50).optional()
+        }
+    }, async (args) => {
+        const result = await memoryRecall(args, { config });
+        return jsonResult(result);
+    });
+    // ─── integration.* ───────────────────────────────────────────────────
+    // We register a typed schema per integration method instead of a single
+    // generic dispatcher so the MCP client gets useful tool descriptions
+    // and parameter hints. The runtime delegate is a thin wrapper that
+    // dispatches to the per-provider client.
+    registerGithubTools(server, config);
+    return server;
+}
+function registerGithubTools(server, config) {
+    const targetSchema = {
+        target: z.object({
+            owner: z.string().min(1),
+            repo: z.string().min(1),
+            number: z.number().int().positive()
+        })
+    };
+    const repoCoordsSchema = {
+        owner: z.string().min(1),
+        repo: z.string().min(1)
+    };
+    server.registerTool('integration.github.comment', {
+        title: 'Comment on a GitHub issue or PR',
+        description: 'Posts a comment on the target issue/PR. Returns the comment URL.',
+        inputSchema: {
+            ...targetSchema,
+            body: z.string().min(1)
+        }
+    }, async (args) => jsonResult(await dispatchIntegration('integration.github.comment', args, { config })));
+    server.registerTool('integration.github.createIssue', {
+        title: 'Create a GitHub issue',
+        description: 'Creates a new issue in the target repo. Returns { number, url }.',
+        inputSchema: {
+            ...repoCoordsSchema,
+            title: z.string().min(1),
+            body: z.string().min(1),
+            labels: z.array(z.string()).optional()
+        }
+    }, async (args) => jsonResult(await dispatchIntegration('integration.github.createIssue', args, { config })));
+    server.registerTool('integration.github.upsertIssue', {
+        title: 'Upsert a GitHub issue by title match',
+        description: 'Updates an open issue matching `matchTitle` if present, otherwise creates one. Returns { number, url, created }.',
+        inputSchema: {
+            ...repoCoordsSchema,
+            title: z.string().min(1),
+            body: z.string().min(1),
+            matchTitle: z.string().min(1),
+            labels: z.array(z.string()).optional()
+        }
+    }, async (args) => jsonResult(await dispatchIntegration('integration.github.upsertIssue', args, { config })));
+    server.registerTool('integration.github.getPr', {
+        title: 'Fetch a GitHub PR with diff',
+        description: 'Returns title, body, head/base refs, author, and the full unified diff via the canonical API endpoint.',
+        inputSchema: {
+            ...targetSchema
+        }
+    }, async (args) => jsonResult(await dispatchIntegration('integration.github.getPr', args, { config })));
+    server.registerTool('integration.github.postReview', {
+        title: 'Post a PR review',
+        description: 'Posts a review with optional inline comments. `event` is one of COMMENT, APPROVE, REQUEST_CHANGES.',
+        inputSchema: {
+            ...targetSchema,
+            review: z.object({
+                body: z.string().min(1),
+                event: z.enum(['COMMENT', 'APPROVE', 'REQUEST_CHANGES']),
+                comments: z
+                    .array(z.object({
+                    path: z.string().min(1),
+                    line: z.number().int().positive(),
+                    body: z.string().min(1)
+                }))
+                    .optional()
+            })
+        }
+    }, async (args) => jsonResult(await dispatchIntegration('integration.github.postReview', args, { config })));
+}
+/**
+ * Wrap a tool's return value in the MCP `CallToolResult` shape. We use
+ * JSON-text encoding so any client can read it; structured-output schemas
+ * are a follow-up if real consumers want them.
+ *
+ * Void-returning tools (e.g. `integration.github.postReview`) must still
+ * produce a real text payload — `JSON.stringify(undefined)` returns
+ * `undefined`, not a valid JSON string, so the MCP response would fail
+ * its content-shape check. Normalize `undefined` to a sentinel `{ ok:
+ * true }` so consumers see a stable response.
+ */
+export function jsonResult(value) {
+    const payload = value === undefined ? { ok: true } : value;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(payload)
+            }
+        ]
+    };
+}
+/** Server lifetime helper for the bin entry. */
+export async function runStdioServer(config = loadConfig()) {
+    const server = createWorkforceMcpServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/** Re-exported for callers wanting the typed integration name list. */
+export { INTEGRATION_TOOL_NAMES };
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":""}

package/dist/server.test.js

@@ -0,0 +1,48 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { createWorkforceMcpServer } from './server.js';
+import { loadConfig } from './config.js';
+test('jsonResult normalizes a void return so MCP text content is always valid JSON', async () => {
+    const { jsonResult } = await import('./server.js');
+    // `JSON.stringify(undefined)` is itself `undefined`, not a string — a
+    // CallToolResult with text:undefined fails the MCP content-shape check.
+    // jsonResult substitutes a sentinel so void-returning tools (e.g.
+    // integration.github.postReview) still emit parseable JSON.
+    const fromUndefined = jsonResult(undefined);
+    assert.equal(fromUndefined.content[0].type, 'text');
+    assert.equal(typeof fromUndefined.content[0].text, 'string');
+    assert.deepEqual(JSON.parse(fromUndefined.content[0].text), { ok: true });
+    // Non-void values pass through verbatim.
+    const fromObject = jsonResult({ runId: 'r1', status: 'pending' });
+    assert.deepEqual(JSON.parse(fromObject.content[0].text), {
+        runId: 'r1',
+        status: 'pending'
+    });
+    // `null` is a legitimate JSON value and should round-trip as such,
+    // not be coerced to the void sentinel.
+    const fromNull = jsonResult(null);
+    assert.equal(fromNull.content[0].text, 'null');
+});
+test('createWorkforceMcpServer registers the documented tool set', () => {
+    const config = loadConfig({
+        WORKFORCE_WORKSPACE_ID: 'ws-demo',
+        WORKFORCE_RUNTIME_TOKEN: 'tok',
+        SUPERMEMORY_API_KEY: 'sm',
+        RELAYFILE_MOUNT_ROOT: '/tmp/wf-mcp-server-test'
+    });
+    const server = createWorkforceMcpServer(config);
+    const tools = server._registeredTools ?? {};
+    const names = Object.keys(tools).sort();
+    assert.deepEqual(names, [
+        'integration.github.comment',
+        'integration.github.createIssue',
+        'integration.github.getPr',
+        'integration.github.postReview',
+        'integration.github.upsertIssue',
+        'memory.recall',
+        'memory.save',
+        'workflow.run',
+        'workflow.status'
+    ]);
+});
+//# sourceMappingURL=server.test.js.map

package/dist/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;IAC9F,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACnD,sEAAsE;IACtE,wEAAwE;IACxE,kEAAkE;IAClE,4DAA4D;IAC5D,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,yCAAyC;IACzC,MAAM,UAAU,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;QACvD,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,mEAAmE;IACnE,uCAAuC;IACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,sBAAsB,EAAE,SAAS;QACjC,uBAAuB,EAAE,KAAK;QAC9B,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,yBAAyB;KAChD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAOhD,MAAM,KAAK,GAAI,MAA8B,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE;QACtB,4BAA4B;QAC5B,gCAAgC;QAChC,0BAA0B;QAC1B,+BAA+B;QAC/B,gCAAgC;QAChC,eAAe;QACf,aAAa;QACb,cAAc;QACd,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/integrations.d.ts

@@ -0,0 +1,30 @@
+import type { WorkforceMcpConfig } from '../config.js';
+/**
+ * Integration tools are flat methods of the form
+ * `integration.<provider>.<method>` (e.g. `integration.github.comment`).
+ * Each provider is wired lazily — the MCP server constructs the client
+ * on first call so harness invocations that never touch GitHub don't
+ * pay for the setup.
+ *
+ * Workforce integration clients are Relayfile-VFS-backed: tools write
+ * canonical JSON files inside the Relayfile mount and the writeback
+ * worker turns those into real provider API calls. The MCP server
+ * picks up the mount root from `RELAYFILE_MOUNT_ROOT` (or
+ * `RELAYFILE_ROOT`); the runtime sets this automatically when it
+ * spawns the harness via `ctx.harness.run`.
+ */
+export interface IntegrationToolDeps {
+    config: WorkforceMcpConfig;
+}
+/**
+ * Top-level dispatcher. `tool` is a string like `integration.github.comment`;
+ * args is whatever JSON the MCP caller sent. Returns the provider client
+ * method's return value (or whatever JSON-safe shape it produced).
+ */
+export declare function dispatchIntegration(tool: string, args: Record<string, unknown>, deps: IntegrationToolDeps): Promise<unknown>;
+/** Static list of available tool names — used for MCP listTools discovery. */
+export declare const INTEGRATION_TOOL_NAMES: readonly ["integration.github.comment", "integration.github.createIssue", "integration.github.upsertIssue", "integration.github.getPr", "integration.github.postReview"];
+export type IntegrationToolName = (typeof INTEGRATION_TOOL_NAMES)[number];
+/** Reset the lazy client cache. Test-only — production has one server lifetime. */
+export declare function _resetIntegrationCache(): void;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/tools/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/tools/integrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAWD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,0KAMzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkH1E,mFAAmF;AACnF,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}