@mrpatronz/nexusflow 2.9.0 → 2.10.1

package/dist/workrooms/manager.d.ts

@@ -0,0 +1,228 @@
+import { type WorkflowPackageV1, type WorkflowStepV1, type WorkflowStepProgressV1, type WorkroomDocumentName, type WorkroomInviteV1, type WorkroomSnapshotV1 } from './contracts.js';
+import { PinnedWorkroomClient } from './client.js';
+import { type EncryptedExportV1 } from './crypto.js';
+import { type StartHostedWorkroomInput } from './host.js';
+import { type PortableWorkroomPreview } from './portable.js';
+import { validateResourcePackage } from './resource-package.js';
+import { type WorkroomExportPayloadV1 } from './store.js';
+export declare function validateWorkroomExportPayload(input: unknown): {
+    readonly payload: WorkroomExportPayloadV1;
+    readonly packages: ReturnType<typeof validateResourcePackage>[];
+};
+export declare function loadPinnedWorkroomClientForWorkspace(workspaceId: string): Promise<PinnedWorkroomClient>;
+interface GuestConnection {
+    readonly invite: WorkroomInviteV1;
+    readonly displayName: string;
+    readonly deviceToken: string;
+    readonly agentToken: string;
+    readonly requestId: string;
+    readonly client: PinnedWorkroomClient;
+    readonly agentClient: PinnedWorkroomClient;
+    readonly localWorkspaceId?: string;
+    effectiveWorkspaceId?: string;
+    status: 'pending' | 'accepted' | 'rejected';
+    memberId?: string;
+}
+export interface WorkroomHumanAuthority {
+    readonly digest: string;
+    readonly generation: number;
+}
+export type WorkroomManagerStatus = {
+    mode: 'idle';
+} | {
+    mode: 'host';
+    roomId: string;
+    name: string;
+    url: string;
+    localWorkspaceId: string;
+    certificateFingerprint: string;
+    snapshot: WorkroomSnapshotV1;
+} | {
+    mode: 'guest';
+    roomId: string;
+    name?: string;
+    url: string;
+    status: GuestConnection['status'];
+    connection?: 'connected' | 'disconnected' | 'revoked';
+    memberId?: string;
+    localWorkspaceId?: string;
+    snapshot?: WorkroomSnapshotV1;
+};
+type StartManagerWorkroomInput = Omit<StartHostedWorkroomInput, 'homeDir' | 'bundle' | 'documents' | 'workspaceId'> & Pick<PortableWorkroomPreview, 'workspaceId' | 'bundle' | 'documents'>;
+export declare class WorkroomManager {
+    private readonly homeDir;
+    private host?;
+    private guest?;
+    private humanSession?;
+    private activeGeneration;
+    private activeHumanOperations;
+    private lifecycleState;
+    private passwordRotationInProgress;
+    private shutdownRequested;
+    private stopPromise?;
+    private readonly lifecycleWaiters;
+    private readonly credentialOwnership;
+    private recoveryFailures;
+    constructor(homeDir?: string);
+    hasActiveRoom(): boolean;
+    activeRoomType(): 'host' | 'guest' | undefined;
+    private activeRoomChanged;
+    private signalLifecycleChange;
+    private waitForLifecycleIdle;
+    private beginLifecycle;
+    private endLifecycle;
+    beginHumanSession(): string;
+    reclaimHostHumanSession(password: string): Promise<string>;
+    abandonLockedGuest(): Promise<void>;
+    assertHumanSession(token: string | undefined): WorkroomHumanAuthority;
+    private assertHumanAuthority;
+    runWithHumanAuthority<T>(authority: WorkroomHumanAuthority, operation: () => Promise<T>): Promise<T>;
+    startHost(input: StartManagerWorkroomInput): Promise<WorkroomManagerStatus>;
+    private startHostUnlocked;
+    listPaused(): Promise<import("./host.js").PausedWorkroom[]>;
+    listQuarantined(): Promise<import("./host.js").QuarantinedWorkroom[]>;
+    discardQuarantined(roomId: string): Promise<void>;
+    resumeHost(roomId: string, password: string): Promise<WorkroomManagerStatus>;
+    stopOrLeave(authority?: WorkroomHumanAuthority): Promise<void>;
+    private stopOrLeaveOnce;
+    status(): Promise<WorkroomManagerStatus>;
+    createInvite(): Promise<{
+        readonly invite: string;
+        readonly expiresAt: string;
+    }>;
+    join(inviteText: string, password: string, displayName: string, localWorkspaceId?: string): Promise<WorkroomManagerStatus>;
+    pollJoin(): Promise<WorkroomManagerStatus>;
+    decideJoin(requestId: string, accept: boolean): Promise<void>;
+    setRole(memberId: string, role: 'publisher' | 'member'): Promise<void>;
+    revokeMember(memberId: string): Promise<void>;
+    rotatePassword(password: string, revokeDevices?: boolean): Promise<void>;
+    private activeRoom;
+    snapshot(): Promise<WorkroomSnapshotV1>;
+    updateDocument(name: WorkroomDocumentName, content: string, expectedRevision: number): Promise<{
+        revision: number;
+        content: string;
+        updatedAt: string;
+        updatedBy: string;
+        name: "plan" | "handoff" | "decisions";
+        history: {
+            revision: number;
+            content: string;
+            updatedAt: string;
+            updatedBy: string;
+        }[];
+    } | {
+        revision: number;
+        content: string;
+        updatedAt: string;
+        updatedBy: string;
+        history: {
+            revision: number;
+            content: string;
+            updatedAt: string;
+            updatedBy: string;
+        }[];
+        name: "plan" | "handoff" | "decisions";
+    }>;
+    publishHandoff(workspacePath: string): Promise<{
+        revision: number;
+        content: string;
+        updatedAt: string;
+        updatedBy: string;
+        name: "plan" | "handoff" | "decisions";
+        history: {
+            revision: number;
+            content: string;
+            updatedAt: string;
+            updatedBy: string;
+        }[];
+    } | {
+        revision: number;
+        content: string;
+        updatedAt: string;
+        updatedBy: string;
+        history: {
+            revision: number;
+            content: string;
+            updatedAt: string;
+            updatedBy: string;
+        }[];
+        name: "plan" | "handoff" | "decisions";
+    }>;
+    listLocalResources(): Promise<import("./local-resources.js").LocalShareableResource[]>;
+    publishLocalResource(kind: 'skill' | 'agent' | 'workflow', id: string, version: string): Promise<{
+        manifest: {
+            schemaVersion: 1;
+            kind: "skill" | "agent" | "workflow";
+            id: string;
+            version: string;
+            digest: string;
+            ownerMemberId: string;
+            maintainerMemberIds: string[];
+            createdAt: string;
+            dependencies: {
+                kind: "skill" | "agent" | "workflow";
+                id: string;
+                version: string;
+                digest: string;
+            }[];
+            compatibility?: {
+                platforms?: ("darwin" | "linux" | "win32")[] | undefined;
+                nexusflow?: string | undefined;
+            } | undefined;
+            quarantinedAt?: string | undefined;
+        };
+        files: {
+            path: string;
+            contentBase64: string;
+            mode?: number | undefined;
+        }[];
+    }>;
+    downloadResource(digest: string): Promise<{
+        readonly cachePath: string;
+        readonly preview: {
+            readonly manifest: Awaited<ReturnType<WorkroomManager['snapshot']>>['resources'][number];
+            readonly action: 'create' | 'update';
+            readonly localDigest: string;
+            readonly incomingDefinition: string;
+            readonly existingDefinition?: string;
+            readonly files: Array<{
+                readonly path: string;
+                readonly bytes: number;
+                readonly executable: boolean;
+                readonly encoding: 'utf8' | 'base64';
+                readonly content: string;
+            }>;
+        };
+    }>;
+    applyResource(digest: string, approvedDigest: string, approvedLocalDigest: string): Promise<{
+        kind: "skill";
+        resource: import("../types.js").SkillItem;
+    } | {
+        kind: "agent";
+        resource: import("../types.js").CodexAgentItem;
+    } | {
+        kind: "workflow";
+        resource: import("../utils/workflows.js").WorkflowTemplate;
+    }>;
+    quarantineResource(digest: string): Promise<void>;
+    purgeResource(digest: string): Promise<void>;
+    selectWorkflow(workflow: WorkflowPackageV1, expectedRevision: number): Promise<void>;
+    selectLocalWorkflow(workflowId: string, version: string, steps: readonly WorkflowStepV1[], expectedRevision: number): Promise<void>;
+    transitionWorkflowStep(stepId: string, status: WorkflowStepProgressV1['status'], expectedRevision: number, evidence?: string): Promise<{
+        stepId: string;
+        status: "pending" | "skipped" | "in_progress" | "completed" | "completion_proposed";
+        revision: number;
+        updatedBy: string;
+        updatedAt: string;
+        evidence?: string | undefined;
+        proposedBy?: string | undefined;
+    }>;
+    exportRoom(passphrase: string): Promise<EncryptedExportV1>;
+    importRoom(envelope: EncryptedExportV1, exportPassphrase: string, host: Omit<StartHostedWorkroomInput, 'homeDir' | 'bundle' | 'documents' | 'workspaceId' | 'name'> & {
+        name?: string;
+    }): Promise<WorkroomManagerStatus>;
+    private importRoomUnlocked;
+}
+export declare const workroomManager: WorkroomManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

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