huly-mcp-selfhost 2.1.0 → 3.2.0

package/dist/tools/sharing.d.ts

@@ -0,0 +1,62 @@
+export declare const listCollaborators: (args: {
+    workspace?: string | undefined;
+    object: string;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const addCollaborator: (args: {
+    workspace: string;
+    object: string;
+    member?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const removeCollaborator: (args: {
+    workspace: string;
+    object: string;
+    member?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Self-hosted servers often run with FRONT_URL=http://localhost:…, so the guest URL they generate
+ * only works on the server itself. Then the origin is replaced by HULY_FRONT_URL (what we connect to).
+ */
+export declare function reachableUrl(url: string, frontUrl?: string | undefined): string;
+export declare const createPublicLink: (args: {
+    workspace: string;
+    object: string;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const listPublicLinks: (args: {
+    workspace?: string | undefined;
+    object?: string | undefined;
+    limit: number;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const revokePublicLink: (args: {
+    workspace: string;
+    linkId: string;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/tools/sharing.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.revokePublicLink = exports.listPublicLinks = exports.createPublicLink = exports.removeCollaborator = exports.addCollaborator = exports.listCollaborators = void 0;
+exports.reachableUrl = reachableUrl;
+// Collaborators (who follows a document and gets its notifications) and public guest links.
+const core_1 = __importDefault(require("@hcengineering/core"));
+const contact_1 = __importDefault(require("@hcengineering/contact"));
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const resolve_1 = require("../utils/resolve");
+const classes_1 = require("../utils/classes");
+const people_1 = require("../utils/people");
+/** Account uuid → display name for all persons that have an account. */
+async function accountNames(client) {
+    const persons = await client.findAll(contact_1.default.class.Person, {});
+    return new Map(persons.filter((p) => p.personUuid != null).map((p) => [p.personUuid, (0, people_1.formatPersonName)(p.name)]));
+}
+/** Account uuid of a member given by name, or of the current user when omitted. */
+async function accountOf(client, member) {
+    const person = member == null ? await (0, people_1.currentPerson)(client) : await (0, people_1.findPerson)(client, member);
+    const doc = await client.findOne(contact_1.default.class.Person, { _id: person._id });
+    if (doc?.personUuid == null)
+        throw new Error(`${person.name} has no Huly account and cannot follow documents.`);
+    return { uuid: doc.personUuid, name: person.name };
+}
+exports.listCollaborators = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const target = await (0, resolve_1.resolveObject)(client, args.object);
+    const rows = await client.findAll(classes_1.C.Collaborator, { attachedTo: target._id });
+    if (rows.length === 0)
+        return `Nobody follows ${target.label}.`;
+    const names = await accountNames(client);
+    return `## Collaborators of ${target.label} (${rows.length})\n\n${rows.map((r) => `- ${names.get(r.collaborator) ?? r.collaborator}`).join('\n')}`;
+});
+exports.addCollaborator = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const target = await (0, resolve_1.resolveObject)(client, args.object);
+    const who = await accountOf(client, args.member);
+    // Huly adds collaborators itself on create/assign/mention — never add a second record.
+    const existing = await client.findOne(classes_1.C.Collaborator, { attachedTo: target._id, collaborator: who.uuid });
+    if (existing != null)
+        return `${who.name} already follows ${target.label}.`;
+    await client.addCollection(classes_1.C.Collaborator, target.space, target._id, target._class, 'collaborators', { collaborator: who.uuid });
+    return `✅ ${who.name} now follows ${target.label}.`;
+});
+exports.removeCollaborator = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const target = await (0, resolve_1.resolveObject)(client, args.object);
+    const who = await accountOf(client, args.member);
+    const rows = await client.findAll(classes_1.C.Collaborator, { attachedTo: target._id, collaborator: who.uuid });
+    if (rows.length === 0)
+        return `${who.name} does not follow ${target.label}.`;
+    for (const r of rows)
+        await client.removeCollection(classes_1.C.Collaborator, r.space, r._id, r.attachedTo, r.attachedToClass, r.collection ?? 'collaborators');
+    return `✅ ${who.name} no longer follows ${target.label}.`;
+});
+// ── Public links ────────────────────────────────────────────────────────────
+/**
+ * Self-hosted servers often run with FRONT_URL=http://localhost:…, so the guest URL they generate
+ * only works on the server itself. Then the origin is replaced by HULY_FRONT_URL (what we connect to).
+ */
+function reachableUrl(url, frontUrl = process.env.HULY_FRONT_URL) {
+    if (url === '' || frontUrl == null || frontUrl === '')
+        return url;
+    try {
+        const u = new URL(url);
+        if (!['localhost', '127.0.0.1', '0.0.0.0'].includes(u.hostname))
+            return url;
+        const f = new URL(frontUrl);
+        return `${f.origin}${u.pathname}${u.search}`;
+    }
+    catch {
+        return url;
+    }
+}
+const sleep = async (ms) => await new Promise((resolve) => setTimeout(resolve, ms));
+/** The server fills in the guest URL (with its token) right after the link is created. */
+async function waitForUrl(client, id, attempts = 10) {
+    for (let i = 0; i < attempts; i++) {
+        const link = await client.findOne(classes_1.C.PublicLink, { _id: id });
+        if (link?.url != null && link.url !== '')
+            return reachableUrl(link.url);
+        await sleep(300);
+    }
+    return '';
+}
+/** The panel Huly opens for a class (view:mixin:ObjectPanel), as used in its object links. */
+function panelComponent(client, _class) {
+    try {
+        const panel = client.getHierarchy().classHierarchyMixin(_class, 'view:mixin:ObjectPanel');
+        if (panel?.component != null)
+            return panel.component;
+    }
+    catch { /* no model access (tests) */ }
+    return 'view:component:EditDoc';
+}
+exports.createPublicLink = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const target = await (0, resolve_1.resolveObject)(client, args.object);
+    const existing = await client.findOne(classes_1.C.PublicLink, { attachedTo: target._id });
+    if (existing != null && existing.url !== '')
+        return `Public link for ${target.label} already exists:\n${reachableUrl(existing.url)}\n\nLink id: \`${existing._id}\``;
+    // Like Huly's share dialog: a read-only view without navigation, actions or comments.
+    const component = panelComponent(client, target._class);
+    const id = existing?._id ?? await client.createDoc(classes_1.C.PublicLink, core_1.default.space.Workspace, {
+        attachedTo: target._id,
+        location: { path: [], fragment: encodeURIComponent([component, target._id, target._class, 'content'].join('|')) },
+        revokable: true,
+        restrictions: { readonly: true, disableNavigation: true, disableActions: true, disableComments: true },
+        url: ''
+    });
+    const url = await waitForUrl(client, id);
+    if (url === '')
+        return `⚠️ Link for ${target.label} created, but the server has not filled in its URL yet — run list_public_links in a moment.\n\nLink id: \`${id}\``;
+    return `✅ Public read-only link for ${target.label}:\n${url}\n\nAnyone with this link can read it. Revoke with revoke_public_link (\`${id}\`).`;
+});
+exports.listPublicLinks = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const query = {};
+    if (args.object != null)
+        query.attachedTo = (await (0, resolve_1.resolveObject)(client, args.object))._id;
+    const links = await client.findAll(classes_1.C.PublicLink, query, { limit: args.limit });
+    if (links.length === 0)
+        return 'No public links.';
+    const lines = [];
+    for (const l of links) {
+        let label = String(l.attachedTo);
+        try {
+            label = (await (0, resolve_1.resolveObject)(client, String(l.attachedTo))).label;
+        }
+        catch { /* target deleted or unknown class */ }
+        lines.push(`- **${label}** — ${l.url !== '' ? reachableUrl(String(l.url)) : '_(URL pending)_'} — \`${l._id}\`${l.revokable === false ? ' (not revokable)' : ''}`);
+    }
+    return `## Public links (${links.length})\n\n${lines.join('\n')}`;
+});
+exports.revokePublicLink = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const link = await client.findOne(classes_1.C.PublicLink, { _id: args.linkId });
+    if (link == null)
+        throw new Error(`Public link '${args.linkId}' not found.`);
+    if (link.revokable === false)
+        throw new Error('This link is marked as not revokable in Huly.');
+    await client.removeDoc(classes_1.C.PublicLink, link.space, link._id);
+    return `✅ Public link \`${args.linkId}\` revoked — its URL no longer works.`;
+});
+//# sourceMappingURL=sharing.js.map

package/dist/tools/sharing.js.map

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

package/dist/tools/statuses.d.ts

@@ -2,18 +2,18 @@ export declare const listIssueStatuses: (args: {
     workspace?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const createIssueStatus: (args: {
     workspace: string;
     name: string;
-    category: "InProgress" | "Backlog" | "Todo" | "Done" | "Cancelled";
+    category: "Backlog" | "Cancelled" | "Done" | "InProgress" | "Todo";
     color?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;

package/dist/tools/surveys.d.ts

@@ -0,0 +1,22 @@
+export declare const SV: {
+    readonly Survey: 'survey:class:Survey';
+    readonly Poll: 'survey:class:Poll';
+};
+export declare const listSurveys: (args: {
+    workspace?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const getSurvey: (args: {
+    workspace?: string | undefined;
+    survey: string;
+    maxTextAnswers?: number | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/tools/surveys.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSurvey = exports.listSurveys = exports.SV = void 0;
+// Surveys (survey plugin, read-only): question sets and their polls (filled-in copies attached to
+// e.g. a candidate or application). A poll keeps its own copy of the questions.
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+exports.SV = { Survey: 'survey:class:Survey', Poll: 'survey:class:Poll' };
+const KIND = { string: 'free text', option: 'single choice', options: 'multiple choice' };
+exports.listSurveys = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const surveys = await client.findAll(exports.SV.Survey, {});
+    if (surveys.length === 0)
+        return 'No surveys (the module may be disabled).';
+    const polls = await client.findAll(exports.SV.Poll, {});
+    const lines = surveys.map((s) => {
+        const mine = polls.filter((p) => p.survey === s._id);
+        return `- **${String(s.name)}** — ${(s.questions ?? []).length} question(s) · ${mine.length} poll(s), ${mine.filter((p) => p.isCompleted === true).length} completed — \`${String(s._id)}\``;
+    });
+    return `## Surveys (${surveys.length})\n\n${lines.join('\n')}`;
+});
+exports.getSurvey = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const all = await client.findAll(exports.SV.Survey, {});
+    const s = all.find((x) => x._id === args.survey || String(x.name).toLowerCase() === args.survey.trim().toLowerCase());
+    if (s == null)
+        throw new Error(`Survey '${args.survey}' not found. Surveys: ${all.map((x) => x.name).join(', ') || 'none'}.`);
+    const polls = await client.findAll(exports.SV.Poll, { survey: s._id });
+    const done = polls.filter((p) => p.isCompleted === true);
+    const out = [`## ${String(s.name)}`];
+    if (s.prompt != null && s.prompt !== '')
+        out.push(String(s.prompt));
+    out.push('', `### Questions — results from ${done.length} completed of ${polls.length} poll(s)`);
+    (s.questions ?? []).forEach((q, i) => {
+        out.push(`${i + 1}. ${String(q.name)} _(${KIND[q.kind] ?? q.kind}${q.isMandatory === true ? ', required' : ''})_`);
+        const answers = done.map((p) => (p.questions ?? [])[i]).filter((a) => a != null && a.name === q.name);
+        if (q.kind === 'string') {
+            for (const a of answers.filter((x) => x.answer != null && x.answer !== '').slice(0, args.maxTextAnswers ?? 10))
+                out.push(`   - “${String(a.answer)}”`);
+            return;
+        }
+        const opts = q.options ?? [];
+        opts.forEach((o, j) => {
+            const n = answers.filter((a) => (a.answers ?? []).includes(j)).length;
+            out.push(`   - ${o}${done.length > 0 ? `: ${n}` : ''}`);
+        });
+        const custom = answers.filter((a) => a.answer != null && a.answer !== '');
+        if (q.hasCustomOption === true && custom.length > 0)
+            out.push(`   - other: ${custom.map((a) => `“${String(a.answer)}”`).join(', ')}`);
+    });
+    return out.join('\n');
+});
+//# sourceMappingURL=surveys.js.map

package/dist/tools/surveys.js.map

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

package/dist/tools/templates.d.ts

@@ -0,0 +1,95 @@
+export declare const listIssueTemplates: (args: {
+    workspace?: string | undefined;
+    projectIdentifier?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const getIssueTemplate: (args: {
+    workspace?: string | undefined;
+    template: string;
+    projectIdentifier?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const createIssueTemplate: (args: {
+    description?: string | undefined;
+    priority?: "High" | "Low" | "Medium" | "NoPriority" | "Urgent" | undefined;
+    assignee?: string | null | undefined;
+    componentLabel?: string | null | undefined;
+    milestoneLabel?: string | null | undefined;
+    estimation?: number | undefined;
+    labels?: string[] | undefined;
+    workspace: string;
+    projectIdentifier: string;
+    title: string;
+    children?: {
+        description?: string | undefined;
+        priority?: "High" | "Low" | "Medium" | "NoPriority" | "Urgent" | undefined;
+        assignee?: string | null | undefined;
+        componentLabel?: string | null | undefined;
+        milestoneLabel?: string | null | undefined;
+        estimation?: number | undefined;
+        labels?: string[] | undefined;
+        title: string;
+    }[] | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const updateIssueTemplate: (args: {
+    description?: string | undefined;
+    priority?: "High" | "Low" | "Medium" | "NoPriority" | "Urgent" | undefined;
+    assignee?: string | null | undefined;
+    componentLabel?: string | null | undefined;
+    milestoneLabel?: string | null | undefined;
+    estimation?: number | undefined;
+    labels?: string[] | undefined;
+    workspace: string;
+    template: string;
+    projectIdentifier?: string | undefined;
+    title?: string | undefined;
+    children?: {
+        description?: string | undefined;
+        priority?: "High" | "Low" | "Medium" | "NoPriority" | "Urgent" | undefined;
+        assignee?: string | null | undefined;
+        componentLabel?: string | null | undefined;
+        milestoneLabel?: string | null | undefined;
+        estimation?: number | undefined;
+        labels?: string[] | undefined;
+        title: string;
+    }[] | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const deleteIssueTemplate: (args: {
+    workspace: string;
+    template: string;
+    projectIdentifier?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const createIssueFromTemplate: (args: {
+    workspace: string;
+    template: string;
+    projectIdentifier?: string | undefined;
+    title?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;