Fix getConfigSchema to use flat fields array with correct hint keys

The Paperclip AdapterConfigSchema type expects a flat fields array, not
nested sections. Also maps description -> hint per the schema type.
Defines types locally since @paperclipai/adapter-utils@0.3.1 on npm
does not yet export AdapterConfigSchema/ConfigFieldSchema (those exist
in the monorepo but aren't released to npm yet).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farhoodliquor/paperclip-adapter-claude-k8s",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Paperclip adapter plugin that runs Claude Code agents as Kubernetes Jobs",
   "license": "MIT",
   "repository": {

src/server/config-schema.ts

@@ -1,87 +1,47 @@
-export interface AdapterConfigSchema {
+// NOTE: These types must match what Paperclip's SchemaConfigFields component
-  sections?: AdapterConfigSection[];
+// expects. Paperclip's server at GET /api/adapters/:type/config-schema
+// calls adapter.getConfigSchema() and the UI reads the JSON — types are only
+// used at build time here. The Paperclip types in @paperclipai/adapter-utils
+// may lag behind; these locals are the source of truth for this adapter.
+
+interface ConfigFieldOption {
+  label: string;
+  value: string;
+  group?: string;
 }
 
-export interface AdapterConfigSection {
+type ConfigFieldSchema =
-  title: string;
+  | { type: "text"; key: string; label: string; hint?: string; default?: unknown; meta?: Record<string, unknown> }
+  | { type: "number"; key: string; label: string; hint?: string; default?: unknown; meta?: Record<string, unknown> }
+  | { type: "toggle"; key: string; label: string; hint?: string; default?: unknown; meta?: Record<string, unknown> }
+  | { type: "select"; key: string; label: string; hint?: string; options: ConfigFieldOption[]; default?: unknown; meta?: Record<string, unknown> }
+  | { type: "textarea"; key: string; label: string; hint?: string; default?: unknown; meta?: Record<string, unknown> }
+  | { type: "combobox"; key: string; label: string; hint?: string; options?: ConfigFieldOption[]; default?: unknown; meta?: Record<string, unknown> };
+
+interface AdapterConfigSchema {
   fields: ConfigFieldSchema[];
 }
 
-export type ConfigFieldSchema =
-  | TextFieldSchema
-  | NumberFieldSchema
-  | ToggleFieldSchema
-  | SelectFieldSchema
-  | TextareaFieldSchema;
-
-export interface TextFieldSchema {
-  type: "text";
-  key: string;
-  label: string;
-  description?: string;
-  placeholder?: string;
-  helpLink?: string;
-}
-
-export interface NumberFieldSchema {
-  type: "number";
-  key: string;
-  label: string;
-  description?: string;
-  placeholder?: string;
-  helpLink?: string;
-}
-
-export interface ToggleFieldSchema {
-  type: "toggle";
-  key: string;
-  label: string;
-  description?: string;
-  helpLink?: string;
-}
-
-export interface SelectFieldSchema {
-  type: "select";
-  key: string;
-  label: string;
-  description?: string;
-  options: { value: string; label: string }[];
-  helpLink?: string;
-}
-
-export interface TextareaFieldSchema {
-  type: "textarea";
-  key: string;
-  label: string;
-  description?: string;
-  placeholder?: string;
-  helpLink?: string;
-}
-
 export function getConfigSchema(): AdapterConfigSchema {
-  return {
+  const fields: ConfigFieldSchema[] = [
-    sections: [
+    // Kubernetes
-      {
-        title: "Kubernetes",
-        fields: [
     {
       type: "text",
       key: "namespace",
       label: "Namespace",
-            description: "Kubernetes namespace for Jobs. Defaults to the Deployment namespace.",
+      hint: "Kubernetes namespace for Jobs. Defaults to the Deployment namespace.",
     },
     {
       type: "text",
       key: "image",
       label: "Container Image",
-            description: "Override the container image used for Job pods. Defaults to the running Deployment image.",
+      hint: "Override the container image used for Job pods. Defaults to the running Deployment image.",
-            placeholder: "registry/image:tag",
     },
     {
       type: "select",
       key: "imagePullPolicy",
       label: "Image Pull Policy",
-            description: "Image pull policy for the container image.",
+      hint: "Image pull policy for the container image.",
       options: [
         { value: "IfNotPresent", label: "IfNotPresent" },
         { value: "Always", label: "Always" },
@@ -92,82 +52,65 @@ export function getConfigSchema(): AdapterConfigSchema {
       type: "text",
       key: "kubeconfig",
       label: "Kubeconfig Path",
-            description: "Absolute path to a kubeconfig file on disk. Defaults to in-cluster service account auth.",
+      hint: "Absolute path to a kubeconfig file on disk. Defaults to in-cluster service account auth.",
-            placeholder: "/path/to/kubeconfig",
     },
     {
       type: "number",
       key: "ttlSecondsAfterFinished",
       label: "TTL Seconds After Finished",
-            description: "Auto-cleanup delay for completed Jobs in seconds. Default: 300.",
+      hint: "Auto-cleanup delay for completed Jobs in seconds. Default: 300.",
     },
     {
       type: "toggle",
       key: "retainJobs",
       label: "Retain Jobs",
-            description: "Skip cleanup of completed Jobs for debugging purposes.",
+      hint: "Skip cleanup of completed Jobs for debugging purposes.",
     },
-        ],
+    // Resource Limits
-      },
-      {
-        title: "Resource Limits",
-        fields: [
     {
       type: "text",
       key: "resources.requests.cpu",
       label: "CPU Request",
-            description: "CPU request for Job pods (e.g. 100m, 0.5, 1).",
+      hint: "CPU request for Job pods (e.g. 100m, 0.5, 1).",
-            placeholder: "100m",
     },
     {
       type: "text",
       key: "resources.requests.memory",
       label: "Memory Request",
-            description: "Memory request for Job pods (e.g. 128Mi, 512Mi, 1Gi).",
+      hint: "Memory request for Job pods (e.g. 128Mi, 512Mi, 1Gi).",
-            placeholder: "512Mi",
     },
     {
       type: "text",
       key: "resources.limits.cpu",
       label: "CPU Limit",
-            description: "CPU limit for Job pods (e.g. 100m, 0.5, 1).",
+      hint: "CPU limit for Job pods (e.g. 100m, 0.5, 1).",
-            placeholder: "1000m",
     },
     {
       type: "text",
       key: "resources.limits.memory",
       label: "Memory Limit",
-            description: "Memory limit for Job pods (e.g. 128Mi, 512Mi, 1Gi).",
+      hint: "Memory limit for Job pods (e.g. 128Mi, 512Mi, 1Gi).",
-            placeholder: "1Gi",
     },
-        ],
+    // Scheduling
-      },
-      {
-        title: "Scheduling",
-        fields: [
     {
       type: "textarea",
       key: "nodeSelector",
       label: "Node Selector",
-            description: "Node selector for Job pods. One key=value per line (e.g. disktype=ssd).",
+      hint: "Node selector for Job pods. One key=value per line (e.g. disktype=ssd).",
-            placeholder: "disktype=ssd\ngpu=true",
     },
     {
       type: "textarea",
       key: "tolerations",
       label: "Tolerations",
-            description: "Tolerations for Job pods as JSON array.",
+      hint: "Tolerations for Job pods as JSON array.",
-            placeholder: '[{"key":"node-type","operator":"Equal","value":"gpu","effect":"NoSchedule"}]',
     },
     {
       type: "textarea",
       key: "labels",
       label: "Labels",
-            description: "Extra labels added to Job metadata. One key=value per line.",
+      hint: "Extra labels added to Job metadata. One key=value per line.",
-            placeholder: "team=ai\nenv=prod",
     },
-        ],
+  ];
-      },
+
-    ],
+  return { fields };
-  };
 }