@gwdn/nexus-mcp 0.7.0

package/src/tools/skills.ts

@@ -0,0 +1,255 @@
+/**
+ * sk_list + sk_get + sk_create + sk_update + sk_activate -- Layer 2 Coordination
+ *
+ * Skill management tools for the Nexus platform.
+ * Skills are tenant-scoped instruction sets for agent sessions.
+ * Delegates to POST /api/mcp/skills.
+ */
+
+import { z } from 'zod'
+import { nexusPost } from '../nexus-api.js'
+
+// ---------------------------------------------------------------------------
+// sk_list
+// ---------------------------------------------------------------------------
+
+export const skListSchema = {
+  status_filter: z
+    .array(z.enum(['draft', 'active', 'archived']))
+    .optional()
+    .describe('Filter by skill status (default: draft, active)'),
+  limit: z
+    .number()
+    .min(1)
+    .max(100)
+    .default(50)
+    .describe('Max number of skills to return'),
+}
+
+type SkListArgs = {
+  status_filter?: string[]
+  limit?: number
+  user_id: string
+}
+
+export async function skList(args: SkListArgs) {
+  const result = await nexusPost('/api/mcp/skills', {
+    action: 'sk_list',
+    status_filter: args.status_filter,
+    limit: args.limit ?? 50,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// sk_get
+// ---------------------------------------------------------------------------
+
+export const skGetSchema = {
+  skill_id: z
+    .string()
+    .max(200)
+    .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+}
+
+type SkGetArgs = {
+  skill_id: string
+  user_id: string
+}
+
+export async function skGet(args: SkGetArgs) {
+  const result = await nexusPost('/api/mcp/skills', {
+    action: 'sk_get',
+    skill_id: args.skill_id,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// sk_create
+// ---------------------------------------------------------------------------
+
+export const skCreateSchema = {
+  skill_id: z.string().max(200).describe('Skill identifier (e.g., nx-init-nexus)'),
+  name: z.string().max(500).describe('Human-readable skill name'),
+  description: z.string().max(1000).optional().describe('Short description'),
+  body: z.string().max(100_000).describe('Full markdown instruction content'),
+  auto_generate_command: z
+    .boolean()
+    .default(true)
+    .describe('Auto-generate an OpenCode command (default: true)'),
+}
+
+type SkCreateArgs = {
+  skill_id: string
+  name: string
+  description?: string
+  body: string
+  auto_generate_command?: boolean
+  user_id: string
+}
+
+export async function skCreate(args: SkCreateArgs) {
+  const result = await nexusPost('/api/mcp/skills', {
+    action: 'sk_create',
+    skill_id: args.skill_id,
+    name: args.name,
+    description: args.description,
+    body: args.body,
+    auto_generate_command: args.auto_generate_command ?? true,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// sk_update
+// ---------------------------------------------------------------------------
+
+export const skUpdateSchema = {
+  skill_id: z
+    .string()
+    .max(200)
+    .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+  name: z.string().max(500).optional().describe('Updated name'),
+  description: z.string().max(1000).optional().describe('Updated description'),
+  body: z.string().max(100_000).optional().describe('Updated markdown content'),
+  auto_generate_command: z
+    .boolean()
+    .optional()
+    .describe('Toggle command auto-generation'),
+}
+
+type SkUpdateArgs = {
+  skill_id: string
+  name?: string
+  description?: string
+  body?: string
+  auto_generate_command?: boolean
+  user_id: string
+}
+
+export async function skUpdate(args: SkUpdateArgs) {
+  const result = await nexusPost('/api/mcp/skills', {
+    action: 'sk_update',
+    skill_id: args.skill_id,
+    name: args.name,
+    description: args.description,
+    body: args.body,
+    auto_generate_command: args.auto_generate_command,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// sk_activate
+// ---------------------------------------------------------------------------
+
+export const skActivateSchema = {
+  skill_id: z
+    .string()
+    .max(200)
+    .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+  status: z
+    .enum(['active', 'archived', 'draft'])
+    .describe('New status for the skill'),
+}
+
+type SkActivateArgs = {
+  skill_id: string
+  status: string
+  user_id: string
+}
+
+export async function skActivate(args: SkActivateArgs) {
+  const result = await nexusPost('/api/mcp/skills', {
+    action: 'sk_activate',
+    skill_id: args.skill_id,
+    status: args.status,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}

package/src/tools/update-task-status.ts

@@ -0,0 +1,64 @@
+/**
+ * task_update -- Layer 2 Coordination
+ *
+ * Updates the status (and optionally priority/assignee) of an existing task.
+ * Delegates to POST /api/mcp/tasks (action: task_update).
+ */
+
+import { z } from 'zod'
+import { nexusPost } from '../nexus-api.js'
+
+export const updateTaskStatusSchema = {
+  task_id: z.string().uuid().describe('Task UUID to update'),
+  status: z
+    .enum(['open', 'in_progress', 'blocked', 'done', 'cancelled'])
+    .describe('New task status'),
+  priority: z
+    .enum(['low', 'medium', 'high', 'urgent'])
+    .optional()
+    .describe('Updated priority (optional)'),
+  assignee: z
+    .string()
+    .uuid()
+    .optional()
+    .describe('UUID of the newly assigned user (optional)'),
+  agent_id: z.string().max(200).optional().describe('Agent identifier if applicable'),
+}
+
+type UpdateTaskStatusArgs = {
+  task_id: string
+  status: string
+  priority?: string
+  assignee?: string
+  user_id: string
+  agent_id?: string
+}
+
+export async function updateTaskStatus(args: UpdateTaskStatusArgs) {
+  const result = await nexusPost('/api/mcp/tasks', {
+    action: 'task_update',
+    task_id: args.task_id,
+    status: args.status,
+    priority: args.priority,
+    assignee: args.assignee,
+    agent_id: args.agent_id,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "src/__tests__"]
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    setupFiles: ['./src/__tests__/setup.ts'],
+  },
+})