@mrpatronz/nexusflow 2.9.0 → 2.10.1

package/dist/utils/workflows.d.ts

@@ -6,6 +6,9 @@ export interface WorkflowTemplate {
     custom: boolean;
 }
 export declare function getWorkflowTemplates(): Promise<WorkflowTemplate[]>;
-export declare function saveWorkflowTemplate(name: string, content: string, originalId?: string): Promise<WorkflowTemplate>;
+export declare function saveWorkflowTemplate(name: string, content: string, originalId?: string, options?: {
+    readonly beforeCommit?: () => Promise<void>;
+    readonly expectedId?: string;
+}): Promise<WorkflowTemplate>;
 export declare function deleteWorkflowTemplate(id: string): Promise<void>;
 //# sourceMappingURL=workflows.d.ts.map

package/dist/utils/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/utils/workflows.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6ED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4BxE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CxH;AAED,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtE"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/utils/workflows.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6ED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4BxE;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1F,OAAO,CAAC,gBAAgB,CAAC,CAgD3B;AAED,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE"}

package/dist/utils/workflows.js

@@ -1,11 +1,32 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-import * as os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { resolveResourcePath } from './resources.js';
 import { slugify } from './slug.js';
+import { acquireLock, createMutationQueue } from '../core/locks.js';
+import { atomicWriteFile } from '../resources/fs-safety.js';
+import { resolveBrandHomeDir, RESOURCE_LOCKS_DIR, RESOURCE_CATALOG_LOCK_FILE, RESOURCE_WORKFLOWS_DIR, } from '../core/constants.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const runCatalogMutation = createMutationQueue();
+async function withCatalogLock(operation) {
+    return runCatalogMutation(async () => {
+        const release = await acquireLock(path.join(resolveBrandHomeDir(), RESOURCE_LOCKS_DIR, RESOURCE_CATALOG_LOCK_FILE), {
+            staleMs: 60_000,
+            timeoutMs: 10_000,
+            timeoutMessage: 'Timed out waiting for the resource catalog lock.',
+        });
+        try {
+            return await operation();
+        }
+        finally {
+            await release();
+        }
+    });
+}
+function getUserWorkflowsDir() {
+    return path.join(resolveBrandHomeDir(), RESOURCE_WORKFLOWS_DIR);
+}
 function parseMarkdownTemplate(id, content) {
     const lines = content.split('\n');
     let name = id.split('-').map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
@@ -85,7 +106,7 @@ export async function getWorkflowTemplates() {
     // this module differs between a built run and a source-tree run; a single
     // hard-coded relative path silently finds nothing in one of them.
     const builtInDir = await resolveResourcePath(__dirname, 'workflows');
-    const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
+    const userDir = getUserWorkflowsDir();
     // Ensure user custom workflows directory exists so they can find it easily
     try {
         await fs.mkdir(userDir, { recursive: true });
@@ -105,8 +126,8 @@ export async function getWorkflowTemplates() {
     }
     return Array.from(templateMap.values());
 }
-export async function saveWorkflowTemplate(name, content, originalId) {
-    const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
+export async function saveWorkflowTemplate(name, content, originalId, options = {}) {
+    const userDir = getUserWorkflowsDir();
     await fs.mkdir(userDir, { recursive: true });
     // Extract name from the first H1 header (# Name) in content if present
     let parsedName = name;
@@ -121,21 +142,26 @@ export async function saveWorkflowTemplate(name, content, originalId) {
     if (!id) {
         throw new Error('Invalid template name');
     }
+    if (options.expectedId !== undefined && id !== options.expectedId) {
+        throw new Error('Workflow Markdown heading does not match the reviewed resource ID.');
+    }
     // Ensure content starts with "# <Name>" header so it parses correctly next time
     let fileContent = content.trim();
     if (!fileContent.startsWith('# ')) {
         fileContent = `# ${parsedName}\n\n${fileContent}`;
     }
-    const filePath = path.join(userDir, `${id}.md`);
-    await fs.writeFile(filePath, fileContent, 'utf-8');
-    // If we are editing an existing custom template and the ID changed, delete the old file
-    if (originalId && originalId !== id) {
-        const oldPath = path.join(userDir, `${originalId}.md`);
-        try {
-            await fs.unlink(oldPath);
+    await withCatalogLock(async () => {
+        const filePath = path.join(userDir, `${id}.md`);
+        await atomicWriteFile(filePath, fileContent, options.beforeCommit);
+        // If we are editing an existing custom template and the ID changed, delete the old file
+        if (originalId && originalId !== id) {
+            const oldPath = path.join(userDir, `${originalId}.md`);
+            try {
+                await fs.unlink(oldPath);
+            }
+            catch { }
         }
-        catch { }
-    }
+    });
     const parsed = parseMarkdownTemplate(id, fileContent);
     return {
         id,
@@ -144,15 +170,19 @@ export async function saveWorkflowTemplate(name, content, originalId) {
     };
 }
 export async function deleteWorkflowTemplate(id) {
-    const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
+    if (!id || slugify(id) !== id || path.basename(id) !== id)
+        throw new Error('Invalid workflow template ID.');
+    const userDir = getUserWorkflowsDir();
     const filePath = path.join(userDir, `${id}.md`);
-    try {
-        await fs.unlink(filePath);
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT') {
-            throw error;
+    await withCatalogLock(async () => {
+        try {
+            await fs.unlink(filePath);
         }
-    }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    });
 }
 //# sourceMappingURL=workflows.js.map

package/dist/utils/workflows.js.map

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

package/dist/workrooms/client.d.ts

@@ -0,0 +1,54 @@
+import { type WorkflowPackageV1, type WorkflowStepProgressV1, type WorkroomDocumentName, type WorkroomInviteV1, type WorkroomResourcePackageV1, type WorkroomSnapshotV1, type PortableRepoV1 } from './contracts.js';
+export declare function formatWorkroomInvite(invite: WorkroomInviteV1): string;
+export declare function parseWorkroomInvite(value: string): WorkroomInviteV1;
+export declare class PinnedWorkroomClient {
+    private readonly fingerprint;
+    private readonly deviceToken?;
+    private agent?;
+    private readonly baseUrl;
+    constructor(url: string, fingerprint: string, deviceToken?: string | undefined);
+    connect(): Promise<void>;
+    private request;
+    health(): Promise<{
+        schemaVersion: 1;
+        roomId: string;
+    }>;
+    requestJoin(input: {
+        roomId: string;
+        inviteToken: string;
+        password: string;
+        displayName: string;
+        deviceToken: string;
+        agentToken: string;
+    }): Promise<{
+        requestId: string;
+        status: 'pending';
+    }>;
+    joinStatus(requestId: string, deviceToken: string): Promise<{
+        status: 'pending' | 'accepted' | 'rejected';
+        memberId?: string;
+    }>;
+    snapshot(): Promise<WorkroomSnapshotV1>;
+    updateDocument(name: WorkroomDocumentName, content: string, expectedRevision: number): Promise<{
+        document: WorkroomSnapshotV1["documents"][WorkroomDocumentName];
+    }>;
+    publishHandoff(content: string, repos: PortableRepoV1[], expectedRevision: number): Promise<{
+        document: WorkroomSnapshotV1["documents"]["handoff"];
+    }>;
+    publishResource(pkg: WorkroomResourcePackageV1): Promise<{
+        package: WorkroomResourcePackageV1;
+    }>;
+    getResource(digest: string): Promise<{
+        package: WorkroomResourcePackageV1;
+    }>;
+    selectWorkflow(workflow: WorkflowPackageV1, expectedRevision: number): Promise<{
+        success: true;
+    }>;
+    transitionWorkflowStep(stepId: string, status: WorkflowStepProgressV1['status'], expectedRevision: number, evidence?: string): Promise<{
+        step: WorkflowStepProgressV1;
+    }>;
+    proposeWorkflowStep(stepId: string, expectedRevision: number, evidence: string): Promise<{
+        step: WorkflowStepProgressV1;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/workrooms/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/workrooms/client.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AASxB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CASrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAiBnE;AAkCD,qBAAa,oBAAoB;IAM7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAN/B,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;gBAG5B,GAAG,EAAE,MAAM,EACM,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,YAAA;IAM1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBvB,OAAO;IA2Cd,MAAM,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD,WAAW,CAAC,KAAK,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAI9C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/H,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIvC,cAAc,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;kBACzD,kBAAkB,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC;;IAOhF,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,gBAAgB,EAAE,MAAM;kBACtD,kBAAkB,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC;;IAOrE,eAAe,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,yBAAyB,CAAA;KAAE,CAAC;IAIhG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,yBAAyB,CAAA;KAAE,CAAC;IAI5E,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IAIjG,sBAAsB,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACxC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,sBAAsB,CAAA;KAAE,CAAC;IAQrC,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,sBAAsB,CAAA;KAAE,CAAC;CAM7C"}

package/dist/workrooms/client.js

@@ -0,0 +1,191 @@
+import { X509Certificate } from 'node:crypto';
+import * as https from 'node:https';
+import * as net from 'node:net';
+import * as tls from 'node:tls';
+import { WorkroomAuthorizationError, WorkroomRevisionError, WorkroomValidationError, workroomInviteSchema, } from './contracts.js';
+import { normalizeFingerprint } from './crypto.js';
+import { WORKROOM_DEFAULT_INVITE_PROTOCOL, WORKROOM_INVITE_PROTOCOLS, } from '../core/constants.js';
+const MAX_RESPONSE_BYTES = 40 * 1024 * 1024;
+export function formatWorkroomInvite(invite) {
+    const parsed = workroomInviteSchema.parse(invite);
+    const url = new URL(`${WORKROOM_DEFAULT_INVITE_PROTOCOL}//workroom/join`);
+    url.searchParams.set('v', String(parsed.schemaVersion));
+    url.searchParams.set('url', parsed.url);
+    url.searchParams.set('room', parsed.roomId);
+    url.searchParams.set('token', parsed.token);
+    url.searchParams.set('fingerprint', parsed.fingerprint);
+    return url.toString();
+}
+export function parseWorkroomInvite(value) {
+    let parsed;
+    try {
+        parsed = new URL(value.trim());
+    }
+    catch {
+        throw new WorkroomValidationError('Paste a valid Workroom invitation.');
+    }
+    if (!WORKROOM_INVITE_PROTOCOLS.includes(parsed.protocol) || parsed.hostname !== 'workroom' || parsed.pathname !== '/join') {
+        throw new WorkroomValidationError('Paste a valid Workroom invitation.');
+    }
+    return workroomInviteSchema.parse({
+        schemaVersion: Number(parsed.searchParams.get('v')),
+        url: parsed.searchParams.get('url'),
+        roomId: parsed.searchParams.get('room'),
+        token: parsed.searchParams.get('token'),
+        fingerprint: normalizeFingerprint(parsed.searchParams.get('fingerprint') ?? ''),
+    });
+}
+async function fetchPinnedCertificate(baseUrl, expectedFingerprint) {
+    return new Promise((resolve, reject) => {
+        const hostname = baseUrl.hostname.replace(/^\[|\]$/g, '');
+        let settled = false;
+        const finish = (error, cert) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            if (error)
+                reject(error);
+            else
+                resolve(cert);
+        };
+        const socket = tls.connect({
+            host: hostname,
+            port: Number(baseUrl.port || 443),
+            rejectUnauthorized: false,
+            servername: net.isIP(hostname) ? undefined : hostname,
+        });
+        socket.setTimeout(10_000, () => finish(new Error('Timed out while verifying the Workroom certificate.')));
+        socket.once('error', (error) => finish(error));
+        socket.once('secureConnect', () => {
+            const peer = socket.getPeerCertificate(true);
+            if (!peer.raw)
+                return finish(new Error('The Workroom did not present a certificate.'));
+            const certificate = new X509Certificate(peer.raw);
+            const actual = normalizeFingerprint(certificate.fingerprint256);
+            if (actual !== normalizeFingerprint(expectedFingerprint)) {
+                return finish(new WorkroomAuthorizationError('Workroom TLS fingerprint mismatch. The invitation may be stale or intercepted.'));
+            }
+            finish(undefined, certificate.toString());
+        });
+    });
+}
+export class PinnedWorkroomClient {
+    fingerprint;
+    deviceToken;
+    agent;
+    baseUrl;
+    constructor(url, fingerprint, deviceToken) {
+        this.fingerprint = fingerprint;
+        this.deviceToken = deviceToken;
+        this.baseUrl = new URL(url);
+        if (this.baseUrl.protocol !== 'https:')
+            throw new WorkroomValidationError('Workrooms require HTTPS.');
+    }
+    async connect() {
+        if (this.agent)
+            return;
+        const certificate = await fetchPinnedCertificate(this.baseUrl, this.fingerprint);
+        const expected = normalizeFingerprint(this.fingerprint);
+        this.agent = new https.Agent({
+            ca: certificate,
+            rejectUnauthorized: true,
+            checkServerIdentity: (hostname, cert) => {
+                const hostnameError = tls.checkServerIdentity(hostname, cert);
+                if (hostnameError)
+                    return hostnameError;
+                if (normalizeFingerprint(cert.fingerprint256) !== expected)
+                    return new Error('Workroom TLS fingerprint mismatch.');
+                return undefined;
+            },
+        });
+    }
+    async request(method, pathname, body, token = this.deviceToken) {
+        await this.connect();
+        const payload = body === undefined ? undefined : Buffer.from(JSON.stringify(body), 'utf8');
+        return new Promise((resolve, reject) => {
+            const request = https.request(new URL(pathname, this.baseUrl), {
+                method,
+                agent: this.agent,
+                headers: {
+                    Accept: 'application/json',
+                    ...(payload ? { 'Content-Type': 'application/json', 'Content-Length': String(payload.length) } : {}),
+                    ...(token ? { Authorization: `Bearer ${token}` } : {}),
+                },
+            }, (response) => {
+                const chunks = [];
+                let length = 0;
+                response.on('data', (chunk) => {
+                    length += chunk.length;
+                    if (length > MAX_RESPONSE_BYTES) {
+                        request.destroy(new Error('Workroom response exceeded the safe size limit.'));
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
+                response.on('end', () => {
+                    const raw = Buffer.concat(chunks).toString('utf8');
+                    let data = null;
+                    try {
+                        data = raw ? JSON.parse(raw) : null;
+                    }
+                    catch { }
+                    const status = response.statusCode ?? 500;
+                    if (status < 200 || status >= 300) {
+                        const message = typeof data?.error === 'string' ? data.error : `Workroom request failed (${status}).`;
+                        if (status === 401 || status === 403)
+                            return reject(new WorkroomAuthorizationError(message));
+                        if (status === 409)
+                            return reject(new WorkroomRevisionError(Number(data.expectedRevision), Number(data.actualRevision)));
+                        return reject(new WorkroomValidationError(message));
+                    }
+                    resolve(data);
+                });
+            });
+            request.setTimeout(30_000, () => request.destroy(new Error('Workroom request timed out.')));
+            request.once('error', reject);
+            request.end(payload);
+        });
+    }
+    health() {
+        return this.request('GET', '/v1/health', undefined, undefined);
+    }
+    requestJoin(input) {
+        return this.request('POST', '/v1/join', input, undefined);
+    }
+    joinStatus(requestId, deviceToken) {
+        return this.request('GET', `/v1/join/${encodeURIComponent(requestId)}`, undefined, deviceToken);
+    }
+    snapshot() {
+        return this.request('GET', '/v1/snapshot');
+    }
+    updateDocument(name, content, expectedRevision) {
+        return this.request('PUT', `/v1/documents/${name}`, { content, expectedRevision });
+    }
+    publishHandoff(content, repos, expectedRevision) {
+        return this.request('POST', '/v1/handoff', { content, repos, expectedRevision });
+    }
+    publishResource(pkg) {
+        return this.request('POST', '/v1/resources', pkg);
+    }
+    getResource(digest) {
+        return this.request('GET', `/v1/resources/${encodeURIComponent(digest)}`);
+    }
+    selectWorkflow(workflow, expectedRevision) {
+        return this.request('POST', '/v1/workflow/select', { workflow, expectedRevision });
+    }
+    transitionWorkflowStep(stepId, status, expectedRevision, evidence) {
+        return this.request('POST', `/v1/workflow/steps/${encodeURIComponent(stepId)}/transition`, {
+            status,
+            expectedRevision,
+            evidence,
+        });
+    }
+    proposeWorkflowStep(stepId, expectedRevision, evidence) {
+        return this.request('POST', `/v1/workflow/steps/${encodeURIComponent(stepId)}/propose`, {
+            expectedRevision,
+            evidence,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/workrooms/client.js.map

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