huly-mcp-selfhost 2.1.0 → 3.2.0

package/dist/tools/contacts.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeContactChannel = exports.addContactChannel = exports.updatePerson = exports.createPerson = exports.getPerson = exports.listPersons = void 0;
+const contact_1 = __importDefault(require("@hcengineering/contact"));
+const core_1 = require("@hcengineering/core");
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const people_1 = require("../utils/people");
+const provider = (name) => `contact:channelProvider:${name}`;
+const providerName = (id) => String(id).split(':').pop() ?? id;
+function splitName(raw) {
+    const [last, first] = (raw ?? '').split(',', 2);
+    return first === undefined ? { first: last.trim(), last: '' } : { first: first.trim(), last: last.trim() };
+}
+/** Any contact person (not only workspace users), by id or name. */
+async function findAnyPerson(client, ref) {
+    const byId = await client.findOne(contact_1.default.class.Person, { _id: ref });
+    if (byId != null)
+        return byId;
+    const q = ref.trim().toLowerCase();
+    const persons = await client.findAll(contact_1.default.class.Person, {});
+    const exact = persons.filter((p) => (0, people_1.formatPersonName)(p.name).toLowerCase() === q || String(p.name ?? '').toLowerCase() === q);
+    if (exact.length === 1)
+        return exact[0];
+    const partial = persons.filter((p) => (0, people_1.formatPersonName)(p.name).toLowerCase().includes(q));
+    if (partial.length === 1)
+        return partial[0];
+    if (partial.length === 0)
+        throw new Error(`Person '${ref}' not found.`);
+    throw new Error(`Person '${ref}' is ambiguous: ${partial.map((p) => `${(0, people_1.formatPersonName)(p.name)} (\`${p._id}\`)`).join(', ')}.`);
+}
+function isEmployee(client, person) {
+    try {
+        return client.getHierarchy().hasMixin(person, contact_1.default.mixin.Employee);
+    }
+    catch {
+        return person[contact_1.default.mixin.Employee] != null;
+    }
+}
+exports.listPersons = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    let persons = await client.findAll(contact_1.default.class.Person, {});
+    if (args.employeesOnly)
+        persons = persons.filter((p) => isEmployee(client, p));
+    if (args.query != null)
+        persons = persons.filter((p) => (0, people_1.formatPersonName)(p.name).toLowerCase().includes(args.query.toLowerCase()));
+    persons.sort((a, b) => (0, people_1.formatPersonName)(a.name).localeCompare((0, people_1.formatPersonName)(b.name)));
+    const total = persons.length;
+    persons = persons.slice(0, args.limit);
+    if (persons.length === 0)
+        return 'No persons found.';
+    const channels = await client.findAll(contact_1.default.class.Channel, { attachedTo: { $in: persons.map((p) => p._id) } });
+    const lines = persons.map((p) => {
+        const ch = channels.filter((c) => c.attachedTo === p._id).map((c) => `${providerName(c.provider)}: ${c.value}`);
+        return `- **${(0, people_1.formatPersonName)(p.name)}**${isEmployee(client, p) ? ' (member)' : ''}${p.city != null && p.city !== '' ? ` · ${p.city}` : ''}${ch.length > 0 ? ` · ${ch.join(', ')}` : ''} — \`${p._id}\``;
+    });
+    return `## Persons (${total})\n\n${lines.join('\n')}${total > persons.length ? `\n\n_${total - persons.length} more (raise limit)._` : ''}`;
+});
+exports.getPerson = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const p = await findAnyPerson(client, args.person);
+    const channels = await client.findAll(contact_1.default.class.Channel, { attachedTo: p._id });
+    const memberships = await client.findAll(contact_1.default.class.Member, { contact: p._id });
+    const orgs = [];
+    for (const m of memberships) {
+        const org = await client.findOne(contact_1.default.class.Organization, { _id: m.attachedTo });
+        if (org != null)
+            orgs.push(org.name);
+    }
+    return [
+        `## ${(0, people_1.formatPersonName)(p.name)}`,
+        `**Id:** \`${p._id}\``,
+        `**Workspace member:** ${isEmployee(client, p) ? 'yes' : 'no'}`,
+        p.city != null && p.city !== '' ? `**City:** ${p.city}` : null,
+        `**Contact channels:** ${channels.length > 0 ? channels.map((c) => `${providerName(c.provider)}: ${c.value}`).join(', ') : 'none'}`,
+        `**Organizations:** ${orgs.length > 0 ? orgs.join(', ') : 'none'}`
+    ].filter(Boolean).join('\n');
+});
+exports.createPerson = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const name = `${args.lastName},${args.firstName}`;
+    const display = (0, people_1.formatPersonName)(name);
+    const existing = (await client.findAll(contact_1.default.class.Person, {})).filter((p) => (0, people_1.formatPersonName)(p.name).toLowerCase() === display.toLowerCase());
+    if (existing.length > 0)
+        return `ℹ️ **${display}** already exists (id: \`${existing[0]._id}\`).`;
+    const id = (0, core_1.generateId)();
+    // Huly stores names as "Last,First" (contact combineName).
+    await client.createDoc(contact_1.default.class.Person, contact_1.default.space.Contacts, { name, city: args.city ?? '', avatarType: 'color' }, id);
+    for (const ch of args.channels ?? []) {
+        await client.addCollection(contact_1.default.class.Channel, contact_1.default.space.Contacts, id, contact_1.default.class.Person, 'channels', { provider: provider(ch.provider), value: ch.value });
+    }
+    return `✅ Person **${display}** created (id: \`${id}\`)${(args.channels ?? []).length > 0 ? ` with ${args.channels.length} contact channel(s)` : ''}.`;
+});
+exports.updatePerson = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const p = await findAnyPerson(client, args.person);
+    const updates = {};
+    if (args.firstName !== undefined || args.lastName !== undefined) {
+        const cur = splitName(p.name);
+        updates.name = `${args.lastName ?? cur.last},${args.firstName ?? cur.first}`;
+    }
+    if (args.city !== undefined)
+        updates.city = args.city;
+    if (Object.keys(updates).length === 0)
+        return `Nothing to update for **${(0, people_1.formatPersonName)(p.name)}**.`;
+    await client.updateDoc(contact_1.default.class.Person, p.space, p._id, updates);
+    return `✅ **${(0, people_1.formatPersonName)(updates.name ?? p.name)}** updated (${Object.keys(updates).join(', ')}).`;
+});
+exports.addContactChannel = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const p = await findAnyPerson(client, args.person);
+    const existing = await client.findOne(contact_1.default.class.Channel, { attachedTo: p._id, provider: provider(args.provider), value: args.value });
+    if (existing != null)
+        return `ℹ️ ${(0, people_1.formatPersonName)(p.name)} already has ${args.provider}: ${args.value}.`;
+    await client.addCollection(contact_1.default.class.Channel, p.space, p._id, p._class, 'channels', { provider: provider(args.provider), value: args.value });
+    return `✅ Added ${args.provider} **${args.value}** to ${(0, people_1.formatPersonName)(p.name)}.`;
+});
+exports.removeContactChannel = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const p = await findAnyPerson(client, args.person);
+    const ch = await client.findOne(contact_1.default.class.Channel, { attachedTo: p._id, provider: provider(args.provider), value: args.value });
+    if (ch == null)
+        return `${(0, people_1.formatPersonName)(p.name)} has no ${args.provider} "${args.value}".`;
+    await client.removeCollection(contact_1.default.class.Channel, ch.space, ch._id, p._id, ch.attachedToClass, 'channels');
+    return `✅ Removed ${args.provider} **${args.value}** from ${(0, people_1.formatPersonName)(p.name)}.`;
+});
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

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

package/dist/tools/crm.d.ts

@@ -0,0 +1,61 @@
+export declare const L: {
+    readonly Funnel: 'lead:class:Funnel';
+    readonly Lead: 'lead:class:Lead';
+    readonly Customer: 'lead:mixin:Customer';
+    readonly DefaultFunnel: 'lead:space:DefaultFunnel';
+    readonly Contacts: 'contact:space:Contacts';
+};
+export declare const listLeads: (args: {
+    workspace?: string | undefined;
+    funnel?: string | undefined;
+    status?: string | undefined;
+    limit?: number | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const listCustomers: (args: {
+    workspace?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const createLead: (args: {
+    workspace: string;
+    title: string;
+    customer: string;
+    newCustomer?: "organization" | "person" | undefined;
+    funnel?: string | undefined;
+    status?: string | undefined;
+    assignee?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const updateLead: (args: {
+    workspace: string;
+    identifier: string;
+    title?: string | undefined;
+    status?: string | undefined;
+    assignee?: string | null | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const deleteLead: (args: {
+    workspace: string;
+    identifier: string;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/tools/crm.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteLead = exports.updateLead = exports.createLead = exports.listCustomers = exports.listLeads = exports.L = void 0;
+// CRM (lead plugin): funnels (spaces), customers (Customer mixin on a person or organization)
+// and leads (tasks LEAD-n attached to the customer, living in a funnel).
+const core_1 = require("@hcengineering/core");
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const format_1 = require("../utils/format");
+const people_1 = require("../utils/people");
+const tasks_1 = require("../utils/tasks");
+exports.L = {
+    Funnel: 'lead:class:Funnel',
+    Lead: 'lead:class:Lead',
+    Customer: 'lead:mixin:Customer',
+    DefaultFunnel: 'lead:space:DefaultFunnel',
+    Contacts: 'contact:space:Contacts'
+};
+async function findFunnel(client, ref) {
+    if (ref != null)
+        return await (0, tasks_1.findNamed)(client, exports.L.Funnel, ref, 'Funnel');
+    const funnels = await client.findAll(exports.L.Funnel, { archived: false });
+    if (funnels.length === 0)
+        throw new Error('No funnel in this workspace — is the CRM module enabled?');
+    return funnels.find((f) => f._id === exports.L.DefaultFunnel) ?? funnels[0];
+}
+async function findLead(client, identifier) {
+    const lead = await client.findOne(exports.L.Lead, { identifier: identifier.trim().toUpperCase() });
+    if (lead == null)
+        throw new Error(`Lead '${identifier}' not found (ids look like LEAD-12).`);
+    return lead;
+}
+exports.listLeads = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const funnels = args.funnel != null ? [await findFunnel(client, args.funnel)] : await client.findAll(exports.L.Funnel, {});
+    const leads = await client.findAll(exports.L.Lead, { space: { $in: funnels.map((f) => f._id) } }, { sort: { modifiedOn: core_1.SortingOrder.Descending }, limit: args.limit ?? 50 });
+    const head = `## Leads (${leads.length}) — funnel(s): ${funnels.map((f) => f.name).join(', ') || 'none'}`;
+    if (leads.length === 0)
+        return `${head}\n\nNo leads.`;
+    const names = await (0, people_1.peopleNames)(client);
+    const customers = await client.findAll('contact:class:Contact', { _id: { $in: [...new Set(leads.map((l) => l.attachedTo))] } });
+    const wfs = new Map();
+    for (const f of funnels)
+        wfs.set(f._id, await (0, tasks_1.workflowOf)(client, f).catch(() => undefined));
+    const rows = leads.map((l) => ({ l, status: wfs.get(l.space) != null ? (0, tasks_1.statusName)(wfs.get(l.space), l.status) : '?' }))
+        .filter((r) => args.status == null || r.status.toLowerCase() === args.status.toLowerCase());
+    const lines = rows.map(({ l, status }) => `- **${String(l.identifier)}** ${String(l.title)} — ${(0, tasks_1.contactName)(customers.find((c) => c._id === l.attachedTo))} [${status}]${l.assignee != null ? ` · ${names.get(l.assignee) ?? '?'}` : ''} · ${(0, format_1.formatDate)(l.modifiedOn)}`);
+    return `${head}\n\n${lines.join('\n') || '_(none with that status)_'}`;
+});
+exports.listCustomers = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const customers = await client.findAll(exports.L.Customer, {});
+    if (customers.length === 0)
+        return 'No customers.';
+    const lines = customers.map((c) => `- **${(0, tasks_1.contactName)(c)}** (${c._class === 'contact:class:Organization' ? 'organization' : 'person'}) · ${Number(c[exports.L.Customer]?.leads ?? 0)} lead(s) — \`${String(c._id)}\``);
+    return `## Customers (${customers.length})\n\n${lines.join('\n')}`;
+});
+exports.createLead = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const funnel = await findFunnel(client, args.funnel);
+    const wf = await (0, tasks_1.workflowOf)(client, funnel);
+    const status = (0, tasks_1.pickStatus)(wf, args.status);
+    const assignee = args.assignee != null ? (await (0, people_1.findPerson)(client, args.assignee))._id : null;
+    let customer;
+    let created = '';
+    if (args.newCustomer != null) {
+        const cls = args.newCustomer === 'organization' ? 'contact:class:Organization' : 'contact:class:Person';
+        const name = args.newCustomer === 'organization' ? args.customer.trim() : (() => { const [first, ...rest] = args.customer.trim().split(/\s+/); return `${rest.join(' ')},${first}`; })();
+        const dup = await client.findAll(cls, { name });
+        if (dup.length > 0)
+            throw new Error(`'${args.customer}' already exists — leave out newCustomer to use it.`);
+        const id = (0, core_1.generateId)();
+        await client.createDoc(cls, exports.L.Contacts, { name, city: '', avatarType: 'color', ...(cls === 'contact:class:Organization' ? { description: null } : {}) }, id);
+        customer = { _id: id, _class: cls, space: exports.L.Contacts, name };
+        created = ` (new ${args.newCustomer})`;
+    }
+    else
+        customer = await (0, tasks_1.findContact)(client, args.customer);
+    if (customer[exports.L.Customer] == null)
+        await client.createMixin(customer._id, customer._class, customer.space, exports.L.Customer, { customerDescription: null });
+    const number = await (0, tasks_1.nextNumber)(client, exports.L.Lead);
+    const identifier = `LEAD-${number}`;
+    await client.addCollection(exports.L.Lead, funnel._id, customer._id, exports.L.Customer, 'leads', {
+        status, number, identifier, title: args.title.trim(), kind: wf.kind, rank: '', assignee, startDate: null, dueDate: null
+    });
+    return `✅ **${identifier}** ${args.title} — ${(0, tasks_1.contactName)(customer)}${created} [${(0, tasks_1.statusName)(wf, status)}] in ${String(funnel.name)}`;
+});
+exports.updateLead = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const lead = await findLead(client, args.identifier);
+    const update = {};
+    const done = [];
+    if (args.title != null) {
+        update.title = args.title.trim();
+        done.push('title');
+    }
+    if (args.status != null) {
+        const wf = await (0, tasks_1.workflowOf)(client, await client.findOne(exports.L.Funnel, { _id: lead.space }));
+        update.status = (0, tasks_1.pickStatus)(wf, args.status);
+        done.push(`status → ${(0, tasks_1.statusName)(wf, update.status)}`);
+    }
+    if (args.assignee !== undefined) {
+        update.assignee = args.assignee != null ? (await (0, people_1.findPerson)(client, args.assignee))._id : null;
+        done.push(args.assignee != null ? `assignee → ${args.assignee}` : 'unassigned');
+    }
+    if (Object.keys(update).length === 0)
+        throw new Error('Nothing to change.');
+    await client.updateDoc(exports.L.Lead, lead.space, lead._id, update);
+    return `✅ **${String(lead.identifier)}**: ${done.join(', ')}.`;
+});
+exports.deleteLead = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const lead = await findLead(client, args.identifier);
+    await client.removeCollection(exports.L.Lead, lead.space, lead._id, lead.attachedTo, lead.attachedToClass, lead.collection ?? 'leads');
+    return `🗑️ Lead **${String(lead.identifier)}** deleted.`;
+});
+//# sourceMappingURL=crm.js.map

package/dist/tools/crm.js.map

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

package/dist/tools/documents.d.ts

@@ -2,36 +2,36 @@ export declare const listTeamspaces: (args: {
     workspace?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const createTeamspace: (args: {
     workspace: string;
     name: string;
-    isPrivate: boolean;
     description?: string | undefined;
+    isPrivate: boolean;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const listDocuments: (args: {
-    teamspaceId: string;
     workspace?: string | undefined;
+    teamspaceId: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const getDocument: (args: {
-    documentId: string;
     workspace?: string | undefined;
+    documentId: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -42,7 +42,7 @@ export declare const createDocument: (args: {
     parentId?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -51,17 +51,40 @@ export declare const deleteDocument: (args: {
     documentId: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const updateDocument: (args: {
     workspace: string;
     documentId: string;
-    markdown: string;
+    markdown?: string | undefined;
+    title?: string | undefined;
+    parentId?: string | null | undefined;
+    teamspaceId?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const listDocumentComments: (args: {
+    workspace?: string | undefined;
+    documentId: string;
+    limit: number;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const addDocumentComment: (args: {
+    workspace: string;
+    documentId: string;
+    message: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -71,7 +94,7 @@ export declare const linkDocument: (args: {
     documentId: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;

package/dist/tools/documents.js

@@ -36,15 +36,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.linkDocument = exports.updateDocument = exports.deleteDocument = exports.createDocument = exports.getDocument = exports.listDocuments = exports.createTeamspace = exports.listTeamspaces = void 0;
+exports.linkDocument = exports.addDocumentComment = exports.listDocumentComments = exports.updateDocument = exports.deleteDocument = exports.createDocument = exports.getDocument = exports.listDocuments = exports.createTeamspace = exports.listTeamspaces = void 0;
 const document_1 = __importDefault(require("@hcengineering/document"));
 const core_1 = __importStar(require("@hcengineering/core"));
 const document_2 = require("@hcengineering/document");
+const rank_1 = require("@hcengineering/rank");
+const chunter_1 = __importDefault(require("@hcengineering/chunter"));
+const people_1 = require("../utils/people");
+const format_1 = require("../utils/format");
 const connection_1 = require("../connection");
 const errors_1 = require("../utils/errors");
 const markdown_1 = require("../utils/markdown");
 const storage_1 = require("../utils/storage");
 const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const content_1 = require("../utils/content");
 exports.listTeamspaces = (0, errors_1.wrapToolHandler)(async (args) => {
     const client = await (0, connection_1.getConnection)(args.workspace);
     const teamspaces = await client.findAll(document_1.default.class.Teamspace, {});
@@ -56,12 +61,14 @@ exports.listTeamspaces = (0, errors_1.wrapToolHandler)(async (args) => {
 exports.createTeamspace = (0, errors_1.wrapToolHandler)(async (args) => {
     const client = await (0, connection_1.getConnection)(args.workspace);
     const teamspaceId = (0, core_1.generateId)();
+    // Space members and owners are account uuids in Huly 0.7 (not the social id in client.user).
+    const me = await (0, people_1.currentAccountUuid)(client);
     await client.createDoc(document_1.default.class.Teamspace, core_1.default.space.Space, {
         name: args.name,
         description: args.description ?? '',
         private: args.isPrivate ?? false,
-        members: [client.user],
-        owners: [client.user],
+        members: [me],
+        owners: [me],
         autoJoin: false,
         archived: false,
         icon: undefined,
@@ -75,13 +82,23 @@ exports.listDocuments = (0, errors_1.wrapToolHandler)(async (args) => {
     const docs = await client.findAll(document_1.default.class.Document, { space: args.teamspaceId }, { sort: { rank: core_1.SortingOrder.Ascending }, limit: 100 });
     if (docs.length === 0)
         return 'No documents found in this teamspace.';
-    // Build parent-child tree display
+    // Real tree: children under their parent, any depth.
     const noParentId = document_1.default.ids.NoParent;
-    const lines = docs.map((d) => {
-        const isNested = d.parent != null && String(d.parent) !== noParentId;
-        const prefix = isNested ? '  - ' : '- ';
-        return `${prefix}**${d.title}** (id: \`${d._id}\`)${d.snapshots != null && d.snapshots > 0 ? ` [${d.snapshots} snapshots]` : ''}`;
-    });
+    const ids = new Set(docs.map((d) => String(d._id)));
+    const byParent = new Map();
+    for (const d of docs) {
+        const p = d.parent != null && String(d.parent) !== noParentId && ids.has(String(d.parent)) ? String(d.parent) : noParentId;
+        byParent.set(p, [...(byParent.get(p) ?? []), d]);
+    }
+    const lines = [];
+    const walk = (parent, depth) => {
+        for (const d of byParent.get(parent) ?? []) {
+            lines.push(`${'  '.repeat(depth)}- **${d.title}** (id: \`${d._id}\`)${d.comments > 0 ? ` · ${d.comments} comment(s)` : ''}`);
+            if (depth < 20)
+                walk(String(d._id), depth + 1);
+        }
+    };
+    walk(noParentId, 0);
     return `## Documents (${docs.length})\n\n${lines.join('\n')}`;
 });
 exports.getDocument = (0, errors_1.wrapToolHandler)(async (args) => {
@@ -110,7 +127,7 @@ exports.getDocument = (0, errors_1.wrapToolHandler)(async (args) => {
             lines.push(`**Content URL:** ${contentUrl} _(requires a workspace token as Bearer header)_`);
             // Try to fetch content
             try {
-                const res = await fetch(contentUrl, { headers: { Authorization: `Bearer ${wsToken}` } });
+                const res = await (0, content_1.fetchBlob)(contentUrl, wsToken);
                 if (res.ok) {
                     const text = await res.text();
                     // Huly stores content as JSON markup — extract plain text if possible
@@ -147,14 +164,14 @@ exports.createDocument = (0, errors_1.wrapToolHandler)(async (args) => {
         throw new Error(`Teamspace '${args.teamspaceId}' not found.`);
     const noParent = document_1.default.ids.NoParent;
     const parentId = args.parentId != null ? args.parentId : noParent;
-    // Compute rank (prepend before existing docs at same level)
-    const rank = await (0, document_2.getFirstRank)(client, teamspace._id, parentId);
+    // Like Huly: after the last sibling.
+    const rank = (0, rank_1.makeRank)(await (0, document_2.getFirstRank)(client, teamspace._id, parentId), undefined);
     const docId = (0, core_1.generateId)();
     await client.createDoc(document_1.default.class.Document, teamspace._id, {
         title: args.title,
         content: null,
         parent: parentId,
-        rank: rank ?? '',
+        rank,
         icon: null,
         color: undefined,
         snapshots: 0,
@@ -174,20 +191,88 @@ exports.deleteDocument = (0, errors_1.wrapToolHandler)(async (args) => {
     await client.removeDoc(document_1.default.class.Document, doc.space, doc._id);
     return `✅ Document **"${doc.title}"** (\`${doc._id}\`) deleted.`;
 });
+/** All descendants of a document (any depth). */
+async function descendants(client, root) {
+    const out = [];
+    let level = [root._id];
+    while (level.length > 0) {
+        const kids = await client.findAll(document_1.default.class.Document, { parent: { $in: level } });
+        out.push(...kids);
+        level = kids.map((k) => k._id);
+    }
+    return out;
+}
 exports.updateDocument = (0, errors_1.wrapToolHandler)(async (args) => {
     const client = await (0, connection_1.getConnection)(args.workspace);
-    const { wsToken, workspaceUuid } = await (0, connection_1.getWorkspaceInfo)(args.workspace);
     const doc = await client.findOne(document_1.default.class.Document, { _id: args.documentId });
     if (doc == null)
         throw new Error(`Document '${args.documentId}' not found.`);
-    // Convert markdown to ProseMirror JSON
-    const prosemirror = (0, markdown_1.markdownToProseMirror)(args.markdown);
-    const content = JSON.stringify(prosemirror);
-    const blobId = `${args.documentId}-content-${Date.now()}`;
-    const uploadedId = await (0, storage_1.uploadMarkupBlob)(wsToken, workspaceUuid, blobId, content);
-    // Update document content ref
-    await client.updateDoc(document_1.default.class.Document, doc.space, doc._id, { content: uploadedId });
-    return `✅ Document **"${doc.title}"** updated (blob: \`${uploadedId}\`).`;
+    if (args.markdown == null && args.title == null && args.parentId === undefined && args.teamspaceId == null) {
+        throw new Error('Nothing to change: pass markdown, title, parentId or teamspaceId.');
+    }
+    const done = [];
+    // Move (new parent and/or teamspace) — validated before anything is written.
+    const moving = args.parentId !== undefined || args.teamspaceId != null;
+    let move;
+    let subtree = [];
+    if (moving) {
+        const noParent = document_1.default.ids.NoParent;
+        let parent;
+        if (args.parentId != null) {
+            parent = await client.findOne(document_1.default.class.Document, { _id: args.parentId });
+            if (parent == null)
+                throw new Error(`Parent document '${args.parentId}' not found.`);
+        }
+        const space = parent?.space ?? args.teamspaceId ?? doc.space;
+        if (args.teamspaceId != null && parent != null && parent.space !== args.teamspaceId)
+            throw new Error('parentId is in a different teamspace than teamspaceId.');
+        if (space !== doc.space && (await client.findOne(document_1.default.class.Teamspace, { _id: space })) == null)
+            throw new Error(`Teamspace '${String(space)}' not found.`);
+        subtree = await descendants(client, doc);
+        if (parent != null && (parent._id === doc._id || subtree.some((d) => d._id === parent._id)))
+            throw new Error('A document cannot be moved under itself or one of its children.');
+        const parentId = parent?._id ?? (args.parentId === null || args.teamspaceId != null ? noParent : doc.parent);
+        move = { space, parent: parentId, rank: (0, rank_1.makeRank)(await (0, document_2.getFirstRank)(client, space, parentId), undefined) };
+    }
+    if (args.markdown != null) {
+        const { wsToken, workspaceUuid } = await (0, connection_1.getWorkspaceInfo)(args.workspace);
+        const uploadedId = await (0, storage_1.uploadMarkupBlob)(wsToken, workspaceUuid, `${args.documentId}-content-${Date.now()}`, JSON.stringify((0, markdown_1.markdownToProseMirror)(args.markdown)));
+        await client.updateDoc(document_1.default.class.Document, doc.space, doc._id, { content: uploadedId });
+        done.push('content replaced');
+    }
+    if (args.title != null && args.title !== doc.title) {
+        await client.updateDoc(document_1.default.class.Document, doc.space, doc._id, { title: args.title });
+        done.push(`renamed to "${args.title}"`);
+    }
+    if (move != null) {
+        await client.updateDoc(document_1.default.class.Document, doc.space, doc._id, move);
+        // Children keep their parent but must live in the same teamspace.
+        if (move.space !== doc.space)
+            for (const d of subtree)
+                await client.updateDoc(document_1.default.class.Document, d.space, d._id, { space: move.space });
+        done.push(`moved${move.space !== doc.space ? ` to another teamspace (with ${subtree.length} sub-document(s))` : ''}${String(move.parent) === document_1.default.ids.NoParent ? ' to top level' : ' under the new parent'}`);
+    }
+    return `✅ Document **"${args.title ?? doc.title}"**: ${done.join(', ') || 'no change'}.`;
+});
+exports.listDocumentComments = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const doc = await client.findOne(document_1.default.class.Document, { _id: args.documentId });
+    if (doc == null)
+        throw new Error(`Document '${args.documentId}' not found.`);
+    const comments = await client.findAll(chunter_1.default.class.ChatMessage, { attachedTo: doc._id }, { sort: { createdOn: core_1.SortingOrder.Ascending }, limit: args.limit });
+    if (comments.length === 0)
+        return `No comments on "${doc.title}".`;
+    const names = await (0, people_1.socialIdNames)(client, [...new Set(comments.map((c) => c.createdBy).filter((x) => x != null))]);
+    const lines = comments.map((c) => `- **${names.get(c.createdBy) ?? 'Unknown'}** (${new Date(c.createdOn ?? 0).toISOString().slice(0, 16).replace('T', ' ')}) — \`${c._id}\`\n  ${(0, format_1.markupToText)(c.message).replace(/\n/g, '\n  ')}`);
+    return `## Comments on "${doc.title}" (${comments.length})\n\n${lines.join('\n')}`;
+});
+exports.addDocumentComment = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const doc = await client.findOne(document_1.default.class.Document, { _id: args.documentId });
+    if (doc == null)
+        throw new Error(`Document '${args.documentId}' not found.`);
+    await client.addCollection(chunter_1.default.class.ChatMessage, doc.space, doc._id, document_1.default.class.Document, 'comments', { message: args.message });
+    return `✅ Comment added to "${doc.title}".`;
 });
 exports.linkDocument = (0, errors_1.wrapToolHandler)(async (args) => {
     const client = await (0, connection_1.getConnection)(args.workspace);