@aprovan/patchwork 0.1.0

package/packages/utcp/node_modules/.bin/tsup-node

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/dist/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/dist/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsup/dist/cli-node.js" "$@"
+else
+  exec node  "$basedir/../tsup/dist/cli-node.js" "$@"
+fi

package/packages/utcp/node_modules/.bin/tsx

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/patchwork/patchwork/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/cli.mjs" "$@"
+fi

package/packages/utcp/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@aprovan/patchwork-utcp",
+  "version": "0.1.0",
+  "description": "UTCP backend integration for Patchwork",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc --noEmit",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@utcp/http": "^1.1.1",
+    "@utcp/mcp": "^1.1.1",
+    "@utcp/sdk": "^1.1.0",
+    "@utcp/text": "^1.1.0"
+  },
+  "peerDependencies": {
+    "@aprovan/patchwork": "workspace:*"
+  },
+  "devDependencies": {
+    "@aprovan/patchwork": "workspace:*",
+    "@types/node": "^22.10.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/packages/utcp/src/index.ts

@@ -0,0 +1,153 @@
+/**
+ * @aprovan/patchwork-utcp
+ *
+ * UTCP backend integration for Patchwork.
+ * Provides a ServiceBackend implementation that routes service calls through UTCP.
+ */
+
+import '@utcp/http';
+import '@utcp/text';
+import '@utcp/mcp';
+
+import {
+  UtcpClient,
+  ensureCorePluginsInitialized,
+  UtcpClientConfigSerializer,
+  UtcpClientConfig,
+} from '@utcp/sdk';
+
+import type { ServiceBackend } from '@aprovan/patchwork';
+
+// Ensure plugins are loaded
+ensureCorePluginsInitialized();
+
+/**
+ * Sanitize a string for use as a JavaScript identifier
+ */
+function sanitizeIdentifier(s: string): string {
+  return s.replace(/[^a-zA-Z0-9_]/g, '_').replace(/^[0-9]/, '_$&');
+}
+
+/**
+ * Create a UTCP-backed ServiceBackend for patchwork
+ *
+ * This is the integration point between UTCP and patchwork's service system.
+ * Widgets call `github.repos_list_for_user()` → patchwork routes to this backend → UTCP executes.
+ *
+ * @example
+ * ```typescript
+ * import { createUtcpBackend } from '@aprovan/patchwork-utcp';
+ * import { setServiceBackend } from '@aprovan/patchwork';
+ *
+ * const { backend, client } = await createUtcpBackend({
+ *   cwd: __dirname,
+ *   manual_call_templates: [{
+ *     name: 'github',
+ *     call_template_type: 'http',
+ *     url: 'https://raw.githubusercontent.com/.../api.github.com.json',
+ *     http_method: 'GET',
+ *   }],
+ * });
+ *
+ * setServiceBackend(backend);
+ *
+ * // ... run widgets ...
+ *
+ * await client.close();
+ * ```
+ */
+export async function createUtcpBackend(
+  utcpOptions: UtcpClientConfig,
+  cwd?: string,
+): Promise<{
+  backend: ServiceBackend;
+  client: UtcpClient;
+  toolInfos: Array<{
+    name: string;
+    namespace: string;
+    procedure: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+  }>;
+}> {
+  const utcpConfig = new UtcpClientConfigSerializer().validateDict(
+    utcpOptions as unknown as Record<string, unknown>,
+  );
+  const client = await UtcpClient.create(cwd ?? process.cwd(), utcpConfig);
+
+  // Build tool registry from discovered UTCP tools
+  const toolRegistry = new Map<
+    string,
+    (args: Record<string, unknown>) => Promise<unknown>
+  >();
+  const toolInfos: Array<{
+    name: string;
+    namespace: string;
+    procedure: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+  }> = [];
+
+  // Access internal getTools method - Tool has name, description, inputs, outputs, tags
+  const tools = await (
+    client as {
+      getTools(): Promise<
+        Array<{
+          name: string;
+          description?: string;
+          inputs?: Record<string, unknown>;
+        }>
+      >;
+    }
+  )['getTools']();
+
+  for (const tool of tools) {
+    if (!tool.name.includes('.')) continue;
+
+    const [namespace, ...parts] = tool.name.split('.');
+    const sanitizedNamespace = sanitizeIdentifier(namespace!);
+    let procedure = parts.map(sanitizeIdentifier).join('_');
+
+    // Strip duplicate namespace prefix from procedure names
+    // e.g., "weather_get_forecast" -> "get_forecast" when namespace is "weather"
+    const namespacePrefix = `${sanitizedNamespace}_`;
+    if (procedure.startsWith(namespacePrefix)) {
+      procedure = procedure.slice(namespacePrefix.length);
+    }
+
+    const key = `${sanitizedNamespace}.${procedure}`;
+
+    toolRegistry.set(key, client.callTool.bind(client, tool.name));
+
+    toolInfos.push({
+      name: key,
+      namespace: sanitizedNamespace,
+      procedure,
+      description: tool.description,
+      parameters: tool.inputs,
+    });
+  }
+
+  const backend: ServiceBackend = {
+    call: async (service: string, procedure: string, args: unknown[]) => {
+      const key = `${service}.${procedure}`;
+      const toolFn = toolRegistry.get(key);
+
+      if (!toolFn) {
+        throw new Error(
+          `UTCP tool not found: ${key}. Available tools: ${Array.from(
+            toolRegistry.keys(),
+          )
+            .slice(0, 10)
+            .join(', ')}...`,
+        );
+      }
+
+      return toolFn((args[0] as Record<string, unknown>) ?? {});
+    },
+  };
+
+  return { backend, client, toolInfos };
+}
+
+export type { ServiceBackend };

package/packages/utcp/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

package/packages/utcp/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  target: 'node20',
+  outDir: 'dist',
+  external: ['@aprovan/patchwork'],
+});

package/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'apps/**'
+  - 'packages/**'

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": false
+  },
+  "exclude": ["node_modules", "dist", "**/dist", "**/node_modules"]
+}

package/turbo.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "check-types": {
+      "dependsOn": ["^build"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"]
+    },
+    "lint": {},
+    "clean": {
+      "cache": false
+    }
+  }
+}