aiquila-mcp 0.3.5 → 0.3.6

package/dist/client/text.js

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: MIT
+import { getNextcloudConfig } from '../tools/types.js';
+import { logger } from '../logger.js';
+import { ApiError } from './aiquila.js';
+/**
+ * Make an authenticated request to the Nextcloud Text app OCS API.
+ *
+ * Base path: /ocs/v2.php/apps/text
+ * Unwraps the OCS envelope and returns `ocs.data`.
+ * Throws {@link ApiError} on HTTP errors or non-success OCS status codes.
+ */
+export async function fetchTextAPI(endpoint, options = {}) {
+    const config = getNextcloudConfig();
+    const auth = Buffer.from(`${config.user}:${config.password}`).toString('base64');
+    let url = `${config.url}/ocs/v2.php/apps/text${endpoint}`;
+    if (options.queryParams) {
+        const params = new URLSearchParams(options.queryParams);
+        url += `?${params.toString()}`;
+    }
+    const headers = {
+        Authorization: `Basic ${auth}`,
+        'OCS-APIRequest': 'true',
+        Accept: 'application/json',
+    };
+    let body;
+    if (options.body !== undefined) {
+        body = JSON.stringify(options.body);
+        headers['Content-Type'] = 'application/json';
+    }
+    const method = options.method ?? 'GET';
+    const t0 = Date.now();
+    const response = await fetch(url, { method, headers, body });
+    logger.trace({ method, url, status: response.status, ms: Date.now() - t0 }, '[text] HTTP');
+    if (!response.ok) {
+        const text = await response.text();
+        throw new ApiError(response.status, response.statusText, text);
+    }
+    if (response.status === 204) {
+        return undefined;
+    }
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!contentType.includes('application/json')) {
+        return undefined;
+    }
+    const json = (await response.json());
+    const code = json?.ocs?.meta?.statuscode;
+    if (code !== undefined && code !== 200 && code !== 100) {
+        throw new ApiError(code, json.ocs.meta.status ?? 'error', json.ocs.meta.message ?? '');
+    }
+    return json.ocs.data;
+}

package/dist/tool-registry.js

@@ -36,6 +36,7 @@ import { versionsTools } from './tools/apps/versions.js';
 import { projectsTools } from './tools/apps/projects.js';
 import { pollsTools } from './tools/apps/polls.js';
 import { formsTools } from './tools/apps/forms.js';
+import { textTools } from './tools/apps/text.js';
 /**
  * Single source of truth for tool-to-Nextcloud-app mapping.
  *
@@ -76,6 +77,7 @@ export const TOOL_REGISTRY = [
     { category: 'bookmarks', appIds: ['bookmarks'], tools: bookmarksTools },
     { category: 'polls', appIds: ['polls'], tools: pollsTools },
     { category: 'forms', appIds: ['forms'], tools: formsTools },
+    { category: 'text', appIds: ['text'], tools: textTools },
     { category: 'assistant', appIds: ['assistant'], tools: assistantTools },
     { category: 'translate', appIds: ['text_translate', 'translate'], tools: translateTools },
     { category: 'user_status', appIds: ['user_status'], tools: userStatusTools },

package/dist/tools/apps/text.js

@@ -0,0 +1,180 @@
+// SPDX-License-Identifier: MIT
+import { z } from 'zod';
+import { fetchTextAPI, } from '../../client/text.js';
+import { ApiError } from '../../client/aiquila.js';
+import { getWebDAVClient } from '../../client/webdav.js';
+import { handleAppError } from '../error-utils.js';
+/**
+ * Nextcloud Text App Tools — workspaces (per-folder Readme.md) and direct-edit URLs.
+ *
+ * Uses the Text OCS API (/ocs/v2.php/apps/text/workspace) plus WebDAV for content I/O.
+ * Collaborative editing sessions are intentionally out of scope: the live editor runs
+ * in the user's browser via the direct-edit URL.
+ */
+const textStatusMap = {
+    400: 'Bad request — check the folder path.',
+    403: 'Access denied to this folder.',
+    404: 'No workspace exists for this folder.',
+};
+const FolderPathArg = z
+    .string()
+    .describe("Folder path relative to the user's root (e.g. '/Projects/Acme')");
+function normaliseFolder(path) {
+    if (!path || path === '/')
+        return '/';
+    return path.replace(/\/+$/, '');
+}
+function joinPath(folder, name) {
+    const f = normaliseFolder(folder);
+    return f === '/' ? `/${name}` : `${f}/${name}`;
+}
+function formatWorkspace(file) {
+    return `[${file.id}] ${file.name} (${file.mimetype}) at ${file.path}`;
+}
+async function resolveWorkspaceFile(folder) {
+    try {
+        const data = await fetchTextAPI('/workspace', {
+            queryParams: { path: folder },
+        });
+        return data?.file ?? null;
+    }
+    catch (error) {
+        if (error instanceof ApiError && error.statusCode === 404) {
+            return null;
+        }
+        throw error;
+    }
+}
+export const getTextWorkspaceTool = {
+    name: 'get_text_workspace',
+    description: "Get metadata of the Text workspace file (Readme.md) for a folder. Returns the file's id, name, mimetype and path, or reports that no workspace exists yet.",
+    inputSchema: z.object({ path: FolderPathArg }),
+    handler: async (args) => {
+        try {
+            const file = await resolveWorkspaceFile(args.path);
+            if (!file) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No workspace file in ${normaliseFolder(args.path) || '/'}.`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [{ type: 'text', text: `Workspace: ${formatWorkspace(file)}` }],
+            };
+        }
+        catch (error) {
+            return handleAppError(error, 'Error getting workspace', textStatusMap);
+        }
+    },
+};
+export const readTextWorkspaceTool = {
+    name: 'read_text_workspace',
+    description: "Read the content of a folder's Text workspace file (Readme.md). Returns markdown text, or a 'no workspace' message if none exists.",
+    inputSchema: z.object({ path: FolderPathArg }),
+    handler: async (args) => {
+        try {
+            const file = await resolveWorkspaceFile(args.path);
+            if (!file) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No workspace file in ${normaliseFolder(args.path) || '/'}.`,
+                        },
+                    ],
+                };
+            }
+            const client = getWebDAVClient();
+            const content = (await client.getFileContents(file.path, { format: 'text' }));
+            return { content: [{ type: 'text', text: content }] };
+        }
+        catch (error) {
+            return handleAppError(error, 'Error reading workspace', textStatusMap);
+        }
+    },
+};
+export const writeTextWorkspaceTool = {
+    name: 'write_text_workspace',
+    description: "Create or overwrite a folder's Text workspace file. If a workspace already exists, its existing filename is reused; otherwise Readme.md is created at the folder root.",
+    inputSchema: z.object({
+        path: FolderPathArg,
+        content: z.string().describe('Markdown content to write'),
+    }),
+    handler: async (args) => {
+        try {
+            const existing = await resolveWorkspaceFile(args.path);
+            const targetPath = existing?.path ?? joinPath(args.path, 'Readme.md');
+            const client = getWebDAVClient();
+            await client.putFileContents(targetPath, args.content, { overwrite: true });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: existing
+                            ? `Workspace updated at ${targetPath}.`
+                            : `Workspace created at ${targetPath}.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleAppError(error, 'Error writing workspace', textStatusMap);
+        }
+    },
+};
+export const deleteTextWorkspaceTool = {
+    name: 'delete_text_workspace',
+    description: 'Delete the Text workspace file (Readme.md) for a folder. The folder itself is kept. No-op if the folder has no workspace.',
+    inputSchema: z.object({ path: FolderPathArg }),
+    handler: async (args) => {
+        try {
+            const existing = await resolveWorkspaceFile(args.path);
+            if (!existing) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No workspace file in ${normaliseFolder(args.path) || '/'}.`,
+                        },
+                    ],
+                };
+            }
+            const client = getWebDAVClient();
+            await client.deleteFile(existing.path);
+            return {
+                content: [{ type: 'text', text: `Workspace deleted at ${existing.path}.` }],
+            };
+        }
+        catch (error) {
+            return handleAppError(error, 'Error deleting workspace', textStatusMap);
+        }
+    },
+};
+export const getTextWorkspaceEditUrlTool = {
+    name: 'get_text_workspace_edit_url',
+    description: "Get a one-shot direct-edit URL for a folder's Text workspace. Opens the live collaborative editor in a browser. The Readme.md is created automatically if it does not exist yet. Hand the URL to a human collaborator — the MCP server does not participate in the editing session.",
+    inputSchema: z.object({ path: FolderPathArg }),
+    handler: async (args) => {
+        try {
+            const data = await fetchTextAPI('/workspace/direct', {
+                method: 'POST',
+                body: { path: args.path },
+            });
+            return { content: [{ type: 'text', text: data.url }] };
+        }
+        catch (error) {
+            return handleAppError(error, 'Error getting workspace edit URL', textStatusMap);
+        }
+    },
+};
+export const textTools = [
+    getTextWorkspaceTool,
+    readTextWorkspaceTool,
+    writeTextWorkspaceTool,
+    deleteTextWorkspaceTool,
+    getTextWorkspaceEditUrlTool,
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiquila-mcp",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "AIquila - MCP server for Nextcloud integration",
   "type": "module",
   "main": "dist/index.js",