huly-mcp-selfhost 2.1.0 → 3.2.0

package/dist/utils/people.js

@@ -0,0 +1,80 @@
+"use strict";
+// People in Huly 0.7: every user is a contact.class.Person with the contact.mixin.Employee
+// mixin (contact.class.Member is the membership of a person in an organization — it is
+// empty for most workspaces and must not be used to find users). Names are stored as
+// "Last,First". Changes are attributed to a PersonId (social identity), which
+// contact.class.SocialIdentity maps back to its Person.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPersonName = formatPersonName;
+exports.listPeople = listPeople;
+exports.peopleNames = peopleNames;
+exports.findPerson = findPerson;
+exports.currentPerson = currentPerson;
+exports.socialIdNames = socialIdNames;
+exports.currentAccountUuid = currentAccountUuid;
+const contact_1 = __importDefault(require("@hcengineering/contact"));
+/** "Conrad,Joris" → "Joris Conrad"; other formats are returned trimmed. */
+function formatPersonName(raw) {
+    if (raw == null)
+        return '';
+    const [last, first] = raw.split(',', 2);
+    if (first === undefined)
+        return raw.trim();
+    return `${first.trim()} ${last.trim()}`.trim();
+}
+/** Workspace users (employees); falls back to all persons if the mixin query returns nothing. */
+async function listPeople(client) {
+    let docs = await client.findAll(contact_1.default.mixin.Employee, {});
+    if (docs.length === 0)
+        docs = await client.findAll(contact_1.default.class.Person, {});
+    return docs.map((d) => ({ _id: d._id, rawName: d.name ?? '', name: formatPersonName(d.name) }));
+}
+/** Map person id → display name. */
+async function peopleNames(client) {
+    return new Map((await listPeople(client)).map((p) => [p._id, p.name]));
+}
+/**
+ * Finds one user by name ("Joris", "Conrad", "Joris Conrad", "Conrad,Joris"), case-insensitive.
+ * An exact full-name match wins; otherwise the query must match exactly one person.
+ */
+async function findPerson(client, query) {
+    const q = query.trim().toLowerCase();
+    const people = await listPeople(client);
+    const exact = people.filter((p) => p.name.toLowerCase() === q || p.rawName.toLowerCase() === q);
+    if (exact.length === 1)
+        return exact[0];
+    const partial = people.filter((p) => p.name.toLowerCase().includes(q) || p.rawName.toLowerCase().includes(q));
+    if (partial.length === 1)
+        return partial[0];
+    if (partial.length === 0)
+        throw new Error(`Member '${query}' not found.`);
+    throw new Error(`Member '${query}' is ambiguous: ${partial.map((p) => p.name).join(', ')}.`);
+}
+/** The Person behind the connected account (via its social identity). */
+async function currentPerson(client) {
+    const identity = await client.findOne(contact_1.default.class.SocialIdentity, { _id: client.user });
+    const personId = identity?.attachedTo;
+    if (personId == null)
+        throw new Error('Could not identify current user.');
+    const person = await client.findOne(contact_1.default.class.Person, { _id: personId });
+    return { _id: personId, rawName: person?.name ?? '', name: formatPersonName(person?.name), uuid: person?.personUuid };
+}
+/** Map social identity (PersonId, e.g. createdBy/modifiedBy) → display name. */
+async function socialIdNames(client, ids) {
+    if (ids.length === 0)
+        return new Map();
+    const identities = await client.findAll(contact_1.default.class.SocialIdentity, { _id: { $in: ids } });
+    const names = await peopleNames(client);
+    return new Map(identities.map((i) => [i._id, names.get(i.attachedTo) ?? 'Unknown']));
+}
+/** Account UUID of the connected user (inbox notifications and calendars are keyed by it). */
+async function currentAccountUuid(client) {
+    const me = await currentPerson(client);
+    if (me.uuid == null)
+        throw new Error('Could not determine the account of the current user.');
+    return me.uuid;
+}
+//# sourceMappingURL=people.js.map

package/dist/utils/people.js.map

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

package/dist/utils/redact.d.ts

@@ -0,0 +1,3 @@
+export declare function redactSecrets(value: unknown): unknown;
+/** Server mode: stdout is the JSON-RPC channel, so all console output goes to stderr, with tokens masked. */
+export declare function routeConsoleToStderr(): void;

package/dist/utils/redact.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactSecrets = redactSecrets;
+exports.routeConsoleToStderr = routeConsoleToStderr;
+/**
+ * Huly's client logs its websocket URL on errors ("client websocket error: 2 wss://host/_transactor/<JWT> …").
+ * The JWT is a valid workspace session token, so it must not end up in container logs.
+ */
+const JWT = /eyJ[\w-]{5,}\.[\w-]{5,}\.[\w-]{5,}/g;
+function redactSecrets(value) {
+    if (typeof value === 'string')
+        return value.replace(JWT, '***');
+    if (value instanceof Error) {
+        const copy = new Error(redactSecrets(value.message));
+        copy.stack = value.stack != null ? redactSecrets(value.stack) : undefined;
+        return copy;
+    }
+    return value;
+}
+/** Server mode: stdout is the JSON-RPC channel, so all console output goes to stderr, with tokens masked. */
+function routeConsoleToStderr() {
+    const write = console.error.bind(console);
+    const log = (...args) => { write(...args.map(redactSecrets)); };
+    console.log = console.info = console.debug = console.warn = console.error = log;
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,MAAM,GAAG,GAAG,qCAAqC,CAAA;AAEjD,uBAA+B,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC/D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC,CAAA;QAC9D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAW,CAAC,CAAC,CAAC,SAAS,CAAA;QACnF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,6GAA6G;AAC7G;IACE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAA,CAAC,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,GAAG,CAAA;AACjF,CAAC"}

package/dist/utils/resolve.d.ts

@@ -0,0 +1,17 @@
+import type { TxOperations } from '@hcengineering/core';
+export interface ObjectRef {
+    _id: string;
+    _class: string;
+    space: string;
+    label: string;
+    doc: any;
+}
+/** Human-readable label for any Huly document: "PROJ-12: title", a title, a name, or message text. */
+export declare function labelOf(doc: any): string;
+/** Loads a document of a known class and labels it; undefined if it no longer exists. */
+export declare function loadLabel(client: TxOperations, _class: string, _id: string): Promise<string>;
+/**
+ * Resolves "PROJ-12" (issue, pull request or any task) or a raw document id.
+ * For raw ids the class is unknown, so the activity/notification records that point at it are used.
+ */
+export declare function resolveObject(client: TxOperations, ref: string): Promise<ObjectRef>;

package/dist/utils/resolve.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelOf = labelOf;
+exports.loadLabel = loadLabel;
+exports.resolveObject = resolveObject;
+const task_1 = __importDefault(require("@hcengineering/task"));
+const format_1 = require("./format");
+const TASK_ID = /^[A-Z][A-Z0-9]*-\d+$/;
+/** Human-readable label for any Huly document: "PROJ-12: title", a title, a name, or message text. */
+function labelOf(doc) {
+    if (doc == null)
+        return '(deleted)';
+    const title = doc.title ?? doc.name ?? doc.label;
+    if (doc.identifier != null && title != null)
+        return `${doc.identifier}: ${title}`;
+    if (title != null && title !== '')
+        return String(title);
+    if (typeof doc.message === 'string')
+        return (0, format_1.markupToText)(doc.message).slice(0, 80);
+    return String(doc._id);
+}
+/** Loads a document of a known class and labels it; undefined if it no longer exists. */
+async function loadLabel(client, _class, _id) {
+    try {
+        const doc = await client.findOne(_class, { _id });
+        return labelOf(doc);
+    }
+    catch {
+        return String(_id);
+    }
+}
+/**
+ * Resolves "PROJ-12" (issue, pull request or any task) or a raw document id.
+ * For raw ids the class is unknown, so the activity/notification records that point at it are used.
+ */
+async function resolveObject(client, ref) {
+    if (TASK_ID.test(ref)) {
+        const doc = await client.findOne(task_1.default.class.Task, { identifier: ref });
+        if (doc == null)
+            throw new Error(`'${ref}' not found.`);
+        return { _id: doc._id, _class: doc._class, space: doc.space, label: labelOf(doc), doc };
+    }
+    const ctx = await client.findOne('notification:class:DocNotifyContext', { objectId: ref });
+    const msg = ctx == null ? await client.findOne('activity:class:ActivityMessage', { attachedTo: ref }) : undefined;
+    const _class = ctx?.objectClass ?? msg?.attachedToClass;
+    if (_class == null)
+        throw new Error(`Object '${ref}' not found (pass an issue id like PROJ-12 or an id from another tool).`);
+    const doc = await client.findOne(_class, { _id: ref });
+    return { _id: ref, _class, space: doc?.space ?? ctx?.objectSpace, label: labelOf(doc), doc };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/utils/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/utils/resolve.ts"],"names":[],"mappings":";;;;;;;;AAAA,+DAAsC;AAEtC,qCAAuC;AAIvC,MAAM,OAAO,GAAG,sBAAsB,CAAA;AAEtC,sGAAsG;AACtG,iBAAyB,GAAQ;IAC/B,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,WAAW,CAAA;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAA;IAChD,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,GAAG,GAAG,CAAC,UAAoB,KAAK,KAAe,EAAE,CAAA;IACrG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACvD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAA,qBAAY,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClF,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,yFAAyF;AAClF,KAAK,oBAAqB,MAAoB,EAAE,MAAc,EAAE,GAAW;IAChF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAa,EAAE,EAAE,GAAG,EAAS,CAAC,CAAA;QAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,wBAAyB,MAAoB,EAAE,GAAW;IACpE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,cAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,EAAS,CAAC,CAAA;QAClF,IAAI,GAAG,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,CAAA;QACvD,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAA;IACzF,CAAC;IACD,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,qCAA4C,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAS,CAAC,CAAA;IAC7G,MAAM,GAAG,GAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,gCAAuC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACpI,MAAM,MAAM,GAAG,GAAG,EAAE,WAAW,IAAI,GAAG,EAAE,eAAe,CAAA;IACvD,IAAI,MAAM,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,yEAAyE,CAAC,CAAA;IAC5H,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAS,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAA;AAC9F,CAAC"}

package/dist/utils/spec.d.ts

@@ -0,0 +1,10 @@
+export interface SpecTask {
+    title: string;
+    description?: string;
+}
+export interface SpecPlan {
+    source: 'checklist' | 'headings' | 'none';
+    tasks: SpecTask[];
+    skippedDone: number;
+}
+export declare function planFromMarkup(root: any): SpecPlan;

package/dist/utils/spec.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planFromMarkup = planFromMarkup;
+// Spec → issues: turn a document's structure into planned issues without an LLM round trip.
+// Open checklist items become issues; without a checklist, the sections (lowest heading level
+// that occurs more than once, else level 2/1) become issues with their text as description.
+const markdown_1 = require("./markdown");
+const CHECK = /^\s*\[( |x|X)\]\s+/;
+function childrenOf(node) {
+    return Array.isArray(node?.content) ? node.content : [];
+}
+/** Open checklist items: Huly todo/task nodes, or "[ ] text" list items from Markdown imports. */
+function checklist(root) {
+    const open = [];
+    let done = 0;
+    const walk = (node) => {
+        const type = String(node?.type ?? '');
+        if (type === 'todoItem' || type === 'taskItem') {
+            const [first, ...rest] = childrenOf(node);
+            const title = (0, markdown_1.extractText)(first ?? node).trim();
+            const nested = rest.map(markdown_1.extractText).join('\n').trim();
+            if (node.attrs?.checked === true)
+                done++;
+            else if (title !== '')
+                open.push({ title, description: nested !== '' ? nested : undefined });
+            return;
+        }
+        if (type === 'listItem') {
+            const [first, ...rest] = childrenOf(node);
+            const text = (0, markdown_1.extractText)(first ?? node).trim();
+            const m = CHECK.exec(text);
+            if (m != null) {
+                const nested = rest.map(markdown_1.extractText).join('\n').trim();
+                if (m[1] !== ' ')
+                    done++;
+                else
+                    open.push({ title: text.replace(CHECK, '').trim(), description: nested !== '' ? nested : undefined });
+                return;
+            }
+        }
+        for (const c of childrenOf(node))
+            walk(c);
+    };
+    walk(root);
+    return { open, done };
+}
+function headings(root) {
+    const blocks = childrenOf(root);
+    const levels = blocks.filter((b) => b?.type === 'heading').map((b) => Number(b.attrs?.level ?? 1));
+    if (levels.length === 0)
+        return [];
+    const count = (l) => levels.filter((x) => x === l).length;
+    // Sections are the most common heading level among 2/3; a single H1 is usually the title.
+    const level = [2, 3, 1].find((l) => count(l) > 1) ?? [2, 3, 1].find((l) => count(l) > 0) ?? levels[0];
+    const tasks = [];
+    let current;
+    const flush = () => {
+        if (current == null)
+            return;
+        const body = current.body.join('\n').trim();
+        tasks.push({ title: current.title, description: body !== '' ? body.slice(0, 2000) : undefined });
+    };
+    for (const b of blocks) {
+        if (b?.type === 'heading') {
+            const l = Number(b.attrs?.level ?? 1);
+            if (l === level) {
+                flush();
+                current = { title: (0, markdown_1.extractText)(b).trim(), body: [] };
+                continue;
+            }
+            if (l < level) {
+                flush();
+                current = undefined;
+                continue;
+            }
+        }
+        if (current != null)
+            current.body.push((0, markdown_1.extractText)(b));
+    }
+    flush();
+    return tasks.filter((t) => t.title !== '');
+}
+function planFromMarkup(root) {
+    const list = checklist(root);
+    if (list.open.length > 0 || list.done > 0)
+        return { source: 'checklist', tasks: list.open, skippedDone: list.done };
+    const secs = headings(root);
+    return { source: secs.length > 0 ? 'headings' : 'none', tasks: secs, skippedDone: 0 };
+}
+//# sourceMappingURL=spec.js.map

package/dist/utils/spec.js.map

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

package/dist/utils/storage.js

@@ -24,6 +24,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadMarkupBlob = uploadMarkupBlob;
 exports.uploadBlob = uploadBlob;
 exports.deleteBlob = deleteBlob;
+/** Uploads can be large files; without a limit a stalled connection hangs the tool call. */
+const UPLOAD_TIMEOUT_MS = 120_000;
 const CLOUD_DATALAKE_URL = 'https://dl-eu.huly.app';
 async function uploadMarkupBlob(wsToken, workspaceUuid, blobId, content) {
     const result = await uploadBlob(wsToken, workspaceUuid, blobId, new Blob([content], { type: 'application/json' }));
@@ -43,7 +45,8 @@ async function uploadViaSelfHostedFront(frontUrl, wsToken, blobId, blob) {
     const uploadRes = await fetch(uploadUrl, {
         method: 'POST',
         headers: { Authorization: `Bearer ${wsToken}` },
-        body: form
+        body: form,
+        signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS)
     });
     if (!uploadRes.ok) {
         const body = await uploadRes.text().catch(() => '');
@@ -63,7 +66,8 @@ async function uploadViaCloudDatalake(workspaceUuid, wsToken, blobId, blob) {
     const uploadRes = await fetch(uploadUrl, {
         method: 'POST',
         headers: { Authorization: `Bearer ${wsToken}` },
-        body: form
+        body: form,
+        signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS)
     });
     if (!uploadRes.ok) {
         const body = await uploadRes.text().catch(() => '');
@@ -77,6 +81,6 @@ async function deleteBlob(wsToken, workspaceUuid, blobId) {
     const url = frontUrl != null && frontUrl !== ''
         ? `${frontUrl.replace(/\/$/, '')}/files?file=${encodeURIComponent(blobId)}`
         : `${CLOUD_DATALAKE_URL}/blob/${encodeURIComponent(workspaceUuid)}/${encodeURIComponent(blobId)}`;
-    await fetch(url, { method: 'DELETE', headers: { Authorization: `Bearer ${wsToken}` } }).catch(() => { });
+    await fetch(url, { method: 'DELETE', headers: { Authorization: `Bearer ${wsToken}` }, signal: AbortSignal.timeout(30_000) }).catch(() => { });
 }
 //# sourceMappingURL=storage.js.map

package/dist/utils/storage.js.map

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

package/dist/utils/tasks.d.ts

@@ -0,0 +1,22 @@
+/** Next number from the core Sequence of a class ($inc like Huly's create dialogs). */
+export declare function nextNumber(client: any, cls: string): Promise<number>;
+export interface Workflow {
+    kind: string;
+    statuses: Array<{
+        _id: string;
+        name: string;
+        category?: string;
+    }>;
+}
+/** Task type and ordered statuses of a project-like space (vacancy, funnel). */
+export declare function workflowOf(client: any, space: any): Promise<Workflow>;
+export declare function pickStatus(wf: Workflow, name?: string): string;
+export declare const statusName: (wf: Workflow, id: string) => string;
+/** Display name of a person ("Last,First") or organization. */
+export declare const contactName: (c: any) => string;
+/** Finds one contact (person or organization) by id or name, optionally of one class. */
+export declare function findContact(client: any, ref: string, cls?: string): Promise<any>;
+/** Finds one space-like doc of a class by id or (case-insensitive) name. */
+export declare function findNamed(client: any, cls: string, ref: string, what: string, query?: Record<string, unknown>): Promise<any>;
+/** "2026-06-01" → timestamp (local midnight); throws on bad input. */
+export declare function parseDay(value: string, field: string): number;

package/dist/utils/tasks.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contactName = exports.statusName = void 0;
+exports.nextNumber = nextNumber;
+exports.workflowOf = workflowOf;
+exports.pickStatus = pickStatus;
+exports.findContact = findContact;
+exports.findNamed = findNamed;
+exports.parseDay = parseDay;
+// Helpers for task-like documents outside the tracker (applicants, leads): numbering, workflows,
+// contacts. They follow how Huly's own create dialogs write (see recruit/lead resources).
+const people_1 = require("./people");
+/** Next number from the core Sequence of a class ($inc like Huly's create dialogs). */
+async function nextNumber(client, cls) {
+    const seq = await client.findOne('core:class:Sequence', { attachedTo: cls });
+    if (seq == null)
+        throw new Error(`No number sequence for ${cls} — is the module enabled in this workspace?`);
+    const res = await client.update(seq, { $inc: { sequence: 1 } }, true);
+    return res?.object?.sequence ?? (Number(seq.sequence ?? 0) + 1);
+}
+/** Task type and ordered statuses of a project-like space (vacancy, funnel). */
+async function workflowOf(client, space) {
+    const type = await client.findOne('task:class:ProjectType', { _id: space.type });
+    const kind = type?.tasks?.[0];
+    if (kind == null)
+        throw new Error(`'${String(space.name)}' has no task type.`);
+    const taskType = await client.findOne('task:class:TaskType', { _id: kind });
+    const ids = taskType?.statuses ?? [];
+    const docs = await client.findAll('core:class:Status', { _id: { $in: ids } });
+    const statuses = ids.map((id) => docs.find((d) => d._id === id)).filter((d) => d != null).map((d) => ({ _id: d._id, name: d.name, category: d.category }));
+    return { kind, statuses };
+}
+function pickStatus(wf, name) {
+    if (name == null) {
+        if (wf.statuses.length === 0)
+            throw new Error('This workflow has no statuses.');
+        return wf.statuses[0]._id;
+    }
+    const hit = wf.statuses.find((s) => s.name.toLowerCase() === name.trim().toLowerCase());
+    if (hit == null)
+        throw new Error(`Status '${name}' not found. Available: ${wf.statuses.map((s) => s.name).join(', ')}.`);
+    return hit._id;
+}
+const statusName = (wf, id) => wf.statuses.find((s) => s._id === id)?.name ?? '?';
+exports.statusName = statusName;
+/** Display name of a person ("Last,First") or organization. */
+const contactName = (c) => c == null ? '—' : c._class === 'contact:class:Organization' ? String(c.name ?? '') : (0, people_1.formatPersonName)(c.name);
+exports.contactName = contactName;
+/** Finds one contact (person or organization) by id or name, optionally of one class. */
+async function findContact(client, ref, cls = 'contact:class:Contact') {
+    const byId = await client.findOne(cls, { _id: ref });
+    if (byId != null)
+        return byId;
+    const all = await client.findAll(cls, {});
+    const q = ref.trim().toLowerCase();
+    const exact = all.filter((c) => (0, exports.contactName)(c).toLowerCase() === q || String(c.name ?? '').toLowerCase() === q);
+    const hits = exact.length > 0 ? exact : all.filter((c) => (0, exports.contactName)(c).toLowerCase().includes(q));
+    if (hits.length === 1)
+        return hits[0];
+    if (hits.length === 0)
+        throw new Error(`Contact '${ref}' not found.`);
+    throw new Error(`Contact '${ref}' is ambiguous: ${hits.slice(0, 8).map(exports.contactName).join(', ')}.`);
+}
+/** Finds one space-like doc of a class by id or (case-insensitive) name. */
+async function findNamed(client, cls, ref, what, query = {}) {
+    const all = await client.findAll(cls, query);
+    const hits = all.filter((d) => d._id === ref || String(d.name ?? d.title ?? '').toLowerCase() === ref.trim().toLowerCase());
+    if (hits.length === 1)
+        return hits[0];
+    if (hits.length === 0)
+        throw new Error(`${what} '${ref}' not found. Available: ${all.map((d) => d.name ?? d.title).slice(0, 15).join(', ') || 'none'}.`);
+    throw new Error(`${what} '${ref}' is ambiguous — pass its id.`);
+}
+/** "2026-06-01" → timestamp (local midnight); throws on bad input. */
+function parseDay(value, field) {
+    const t = Date.parse(value);
+    if (Number.isNaN(t))
+        throw new Error(`${field} must be a date (YYYY-MM-DD), got '${value}'.`);
+    return t;
+}
+//# sourceMappingURL=tasks.js.map

package/dist/utils/tasks.js.map

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

package/dist/watch.d.ts

@@ -0,0 +1,62 @@
+export declare const DEFAULT_COMMAND = "claude -p {prompt} --mcp-config {mcpConfig} --strict-mcp-config --allowedTools mcp__huly --permission-mode acceptEdits";
+export declare const DEFAULT_PROMPT: string;
+export interface WatchOptions {
+    workspace?: string;
+    projects: string[];
+    label?: string;
+    assigned: boolean;
+    command: string;
+    prompt: string;
+    cwd: string;
+    intervalSec: number;
+    once: boolean;
+    dryRun: boolean;
+    statePath?: string;
+    timeoutMin: number;
+    agent: string;
+    envFile?: string;
+    /** Script that starts this MCP server (for {mcpConfig}); defaults to the running script. */
+    serverEntry?: string;
+}
+export declare const WATCH_HELP = "Usage: huly-mcp watch [options]\n\nHands Huly issues to an agent: open issues with --label, or assigned to this account\n(--assigned, the default), are claimed, passed to --command and released afterwards.\n\n  --workspace <ws>      Workspace slug/name (required with more than one)\n  --project <KEY>       Only these projects (repeat or comma-separate); default: all,\n                        limited to HULY_WRITE_PROJECTS when set\n  --label <name>        Trigger label (e.g. \"claude\")\n  --assigned            Trigger: assigned to this account (default if no --label)\n  --command <cmd>       Command per issue; placeholders {prompt} {issue} {title}\n                        {workspace} {agent} {trigger} {mcpConfig}\n                        default: claude -p {prompt} --mcp-config {mcpConfig} --strict-mcp-config --allowedTools mcp__huly --permission-mode acceptEdits\n  --prompt <text>       Prompt template (same placeholders, except {prompt})\n  --cwd <dir>           Working directory for the command (default: current)\n  --interval <sec>      Poll interval (default 60)\n  --timeout <min>       Stop a run after this many minutes (default 60)\n  --once                One pass, then exit\n  --dry-run             Only list what would run\n  --state <file>        State file (default ~/.huly-mcp/watch-<workspace>.json)\n  --agent <name>        Agent name for claims (default HULY_AGENT_NAME or claude-watch)\n  --env-file <file>     Load HULY_* credentials from this file (the agent's own account)\n";
+/** Splits a command line into words; supports "double" and 'single' quotes. No shell involved. */
+export declare function splitCommand(line: string): string[];
+/** Replaces {name} placeholders. Unknown placeholders stay as they are. */
+export declare function fill(template: string, vars: Record<string, string>): string;
+/** KEY=value lines (comments, export prefix and quotes allowed). */
+export declare function parseEnvFile(content: string): Record<string, string>;
+export declare function parseWatchArgs(argv: string[], env?: NodeJS.ProcessEnv): WatchOptions;
+export interface RunRecord {
+    identifier: string;
+    trigger: string;
+    ranAt: number;
+    result: string;
+}
+export type WatchState = Record<string, RunRecord>;
+export declare function loadState(path: string): WatchState;
+export declare function saveState(path: string, state: WatchState): void;
+export interface Candidate {
+    issue: any;
+    trigger: 'label' | 'assigned';
+    since: number;
+}
+/**
+ * Open issues that match a trigger and have not run yet. An issue runs again only when its
+ * trigger label was added again after the last run (remove + add the label to retry).
+ */
+export declare function findCandidates(client: any, opts: Pick<WatchOptions, 'projects' | 'label' | 'assigned'>, state: WatchState): Promise<Candidate[]>;
+export interface RunDeps {
+    client: any;
+    workspace: string;
+    /** Runs argv in cwd with env; resolves with the exit code (null when killed). */
+    exec: (argv: string[], cwd: string, env: NodeJS.ProcessEnv, timeoutMs: number) => Promise<number | null>;
+    log: (line: string) => void;
+    env: NodeJS.ProcessEnv;
+    now?: () => number;
+}
+/** MCP config for the child Claude: this server, same credentials (inherited env), one workspace. */
+export declare function writeMcpConfig(dir: string, entry: string, env: Record<string, string>): string;
+export declare function processIssue(c: Candidate, opts: WatchOptions, deps: RunDeps): Promise<RunRecord | undefined>;
+/** One poll: find candidates and run them one after another. */
+export declare function watchOnce(opts: WatchOptions, deps: RunDeps, state: WatchState, save: (s: WatchState) => void): Promise<number>;
+export declare function runWatch(argv: string[]): Promise<void>;