@deepseek-ai/dsh-api-workspace-controller 0.1.2-alpha.2

package/lib/typert.remote-client.js

@@ -0,0 +1,371 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_parameter_0$schema = z.string()
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_parameter_1$schema = z.string()
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_result$schema = z.string()
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_list_parameter_0$schema = z.union([z.undefined(), z.string()])
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_list_result$schema = z.object({
+  'path': z.string(),
+  'home': z.string(),
+  'crumbs': z.array(z.object({
+  'name': z.string(),
+  'path': z.string(),
+  'hidden': z.boolean(),
+})),
+  'entries': z.array(z.object({
+  'name': z.string(),
+  'path': z.string(),
+  'hidden': z.boolean(),
+})),
+  'truncated': z.boolean(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_directoryPicker_pick_result$schema = z.union([z.literal(null), z.string()])
+const _deepseek_ai_dsh_api_workspace_controller_workspace_archiveSession_parameter_0$schema = z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_archiveSession_result$schema = z.object({
+  'archivedSessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_create_parameter_0$schema = z.object({
+  'path': z.string().readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_create_result$schema = z.object({
+  'workspace': z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'path': z.string().readonly(),
+  'title': z.string().readonly(),
+  'sessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+}).readonly(),
+  'created': z.boolean().readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_delete_parameter_0$schema = z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_delete_result$schema = z.object({
+  'deleted': z.literal(true).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_follow_result$schema = z.union([z.object({
+  'type': z.literal("baseline").readonly(),
+  'value': z.object({
+  'items': z.array(z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'path': z.string().readonly(),
+  'title': z.string().readonly(),
+  'sessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+})).readonly(),
+  'archivedSessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+}).readonly(),
+}), z.object({
+  'type': z.literal("upsert").readonly(),
+  'workspace': z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'path': z.string().readonly(),
+  'title': z.string().readonly(),
+  'sessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+}).readonly(),
+}), z.object({
+  'type': z.literal("remove").readonly(),
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+}), z.object({
+  'type': z.literal("order").readonly(),
+  'workspaceIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+}), z.object({
+  'type': z.literal("archived").readonly(),
+  'archivedSessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+})])
+const _deepseek_ai_dsh_api_workspace_controller_workspace_insertBefore_parameter_0$schema = z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'beforeWorkspaceId': z.intersection(z.string(), z.unknown()).readonly().optional(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_insertBefore_result$schema = z.object({
+  'workspaceIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_insertSessionBefore_parameter_0$schema = z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'beforeSessionId': z.intersection(z.string(), z.unknown()).readonly().optional(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_insertSessionBefore_result$schema = z.object({
+  'workspace': z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'path': z.string().readonly(),
+  'title': z.string().readonly(),
+  'sessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+}).readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_rename_parameter_0$schema = z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'title': z.string().readonly(),
+})
+const _deepseek_ai_dsh_api_workspace_controller_workspace_rename_result$schema = z.object({
+  'workspace': z.object({
+  'workspaceId': z.intersection(z.string(), z.unknown()).readonly(),
+  'path': z.string().readonly(),
+  'title': z.string().readonly(),
+  'sessionIds': z.array(z.intersection(z.string(), z.unknown())).readonly(),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+}).readonly(),
+})
+
+export const TYPERT_REMOTE = {
+  package: '@deepseek-ai/dsh-api-workspace-controller',
+  descriptors: [
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/createDirectory',
+      service: 'directoryPickerController',
+      namespace: 'directoryPicker',
+      method: 'createDirectory',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/createDirectory:path',
+            schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_parameter_0$schema,
+          },
+        },
+        {
+          name: 'name',
+          wire: 'name',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/createDirectory:name',
+            schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_parameter_1$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/createDirectory:result',
+        schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_createDirectory_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/directory-picker.ts","line":88,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/list',
+      service: 'directoryPickerController',
+      namespace: 'directoryPicker',
+      method: 'list',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          acceptsUndefined: true,
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/list:path',
+            schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_list_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-host-directory-picker/types#DirectoryListing',
+        schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_list_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/directory-picker.ts","line":72,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/pick',
+      service: 'directoryPickerController',
+      namespace: 'directoryPicker',
+      method: 'pick',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller#directoryPicker/pick:result',
+        schema: _deepseek_ai_dsh_api_workspace_controller_directoryPicker_pick_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/directory-picker.ts","line":55,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/archiveSession',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'archiveSession',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceArchiveSessionRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_archiveSession_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceArchiveValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_archiveSession_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":108,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/create',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'create',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceCreateRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_create_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceCreateValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_create_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":58,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/delete',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'delete',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceDeleteRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_delete_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceDeleteValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_delete_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":78,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/follow',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'follow',
+      mode: 'stream',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceFollowFrame',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_follow_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":118,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/insertBefore',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'insertBefore',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceInsertBeforeRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_insertBefore_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceOrderValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_insertBefore_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":88,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/insertSessionBefore',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'insertSessionBefore',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceInsertSessionBeforeRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_insertSessionBefore_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_insertSessionBefore_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":98,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-api-workspace-controller#workspace/rename',
+      service: 'workspaceController',
+      namespace: 'workspace',
+      method: 'rename',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceRenameRequest',
+            schema: _deepseek_ai_dsh_api_workspace_controller_workspace_rename_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-api-workspace-controller/types#WorkspaceValue',
+        schema: _deepseek_ai_dsh_api_workspace_controller_workspace_rename_result$schema,
+      },
+      sourceLocation: {"file":"packages/api/workspace-controller/src/index.ts","line":68,"column":3},
+    },
+  ],
+}
+
+export default TYPERT_REMOTE

package/lib/types/client/index.d.ts

@@ -0,0 +1,45 @@
+/** Workspace-specific adapter for the Gateway-owned snapshot stream lifecycle. */
+import type { Context } from '@deepseek-ai/cordis';
+import { RemoteSnapshotStream, RemoteStreamCarrierError, type ClientRemote } from '@deepseek-ai/dsh-api-gateway/client';
+import type { WorkspaceFollowFrame, WorkspaceFollowIncrement } from '../types.ts';
+import type { WorkspaceFollowSink } from './model.ts';
+export { ClientWorkspaceModel } from './model.ts';
+export type { WorkspaceFollowSink, WorkspaceListPhase, WorkspaceRemote, WorkspaceSnapshot, } from './model.ts';
+export { WorkspaceController, WorkspaceCreateError } from './service.ts';
+export type { IWorkspaces, WorkspaceSource } from './service.ts';
+export type { WorkspaceId, WorkspaceView } from '../types.ts';
+type WorkspaceBaselineFrame = Extract<WorkspaceFollowFrame, {
+    type: 'baseline';
+}>;
+/** Gateway-owned snapshot stream configured for Workspace state. */
+export type WorkspaceStateStream = RemoteSnapshotStream<WorkspaceBaselineFrame, WorkspaceFollowIncrement>;
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** React-free Client Workspace state and commands. */
+        workspaces: import('./service.ts').IWorkspaces;
+    }
+}
+/** Required Client Remote services. */
+export declare const inject: string[];
+/**
+ * Install Client Workspace state, commands, and reconnecting follow control.
+ * @param ctx - Client root Context.
+ */
+export declare function apply(ctx: Context): void;
+/** Domain sinks used by the Workspace state stream. */
+export interface WorkspaceStateStreamOptions {
+    /** Destinations for decoded Workspace state operations. */
+    readonly accept: WorkspaceFollowSink;
+    /** Observe a retryable carrier loss before reconnection. */
+    readonly carrierFailed?: (error: RemoteStreamCarrierError) => void;
+    /** Publish a terminal business or protocol failure. */
+    readonly failed: (error: unknown) => void;
+}
+/**
+ * Create the reconnecting Workspace state stream.
+ * @param remote - Client Remote face carrying the Workspace namespace and the stream factory.
+ * @param options - Workspace state destinations.
+ * @returns an unstarted stream owned by the Client Workspace runtime.
+ */
+export declare function createWorkspaceStateStream(remote: ClientRemote, options: WorkspaceStateStreamOptions): WorkspaceStateStream;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,70 @@
+/** Workspace-specific adapter for the Gateway-owned snapshot stream lifecycle. */
+import { RemoteSnapshotStream, RemoteStreamCarrierError, } from '@deepseek-ai/dsh-api-gateway/client';
+import { ClientWorkspaceModel } from "./model.js";
+import { WorkspaceController } from "./service.js";
+export { ClientWorkspaceModel } from "./model.js";
+export { WorkspaceController, WorkspaceCreateError } from "./service.js";
+/** Required Client Remote services. */
+export const inject = ['remote', 'remote.workspace'];
+/**
+ * Install Client Workspace state, commands, and reconnecting follow control.
+ * @param ctx - Client root Context.
+ */
+export function apply(ctx) {
+    const model = new ClientWorkspaceModel(ctx.remote.workspace);
+    new WorkspaceController(ctx, model);
+    const control = createWorkspaceStateStream(ctx.remote, {
+        accept: model,
+        carrierFailed: () => { model.handleCarrierFailure(); },
+        failed: (error) => { model.handleStreamFailure(error); },
+    });
+    control.start();
+    ctx.effect(() => async () => { await control.dispose(); }, 'workspace-controller.client.control');
+}
+/**
+ * Create the reconnecting Workspace state stream.
+ * @param remote - Client Remote face carrying the Workspace namespace and the stream factory.
+ * @param options - Workspace state destinations.
+ * @returns an unstarted stream owned by the Client Workspace runtime.
+ */
+export function createWorkspaceStateStream(remote, options) {
+    const stream = remote.$stream({
+        name: 'Workspace state stream',
+        open: signal => remote.workspace.follow(signal),
+        ended: accepted => accepted
+            ? new RemoteStreamCarrierError('Workspace state stream ended without a terminal result')
+            : new Error('Workspace state stream ended before its opening snapshot'),
+        ...(options.carrierFailed === undefined ? {} : { carrierFailed: options.carrierFailed }),
+    });
+    return new RemoteSnapshotStream(stream, {
+        name: 'Workspace state stream',
+        isSnapshot: (frame) => frame.type === 'baseline',
+        replace: (frame) => { options.accept.replaceBaseline(frame.value); },
+        update: (frame) => { acceptIncrement(options.accept, frame); },
+        failed: options.failed,
+    });
+}
+function acceptIncrement(accept, frame) {
+    switch (frame.type) {
+        case 'upsert':
+            accept.upsertView(frame.workspace);
+            return;
+        case 'remove':
+            accept.removeView(frame.workspaceId);
+            return;
+        case 'order':
+            accept.replaceOrder(frame.workspaceIds);
+            return;
+        case 'archived':
+            accept.replaceArchived(frame.archivedSessionIds);
+            return;
+        /* v8 ignore next -- the generated Remote codec validates this closed union */
+        default:
+            return assertNever(frame);
+    }
+}
+/* v8 ignore next 3 -- closed-union backstop after generated Remote validation */
+function assertNever(value) {
+    throw new Error(`unreachable Workspace increment: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=index.js.map

package/lib/types/client/model.d.ts

@@ -0,0 +1,140 @@
+/** Client-side Workspace state model shared by Remote transport and UI projection. */
+import type { RemoteFailure, RemoteResult, TypertClientRemote } from '@deepseek-ai/dsh-typert-protocol';
+import type { WorkspaceArchiveSessionRequest, WorkspaceArchiveValue, WorkspaceBaseline, WorkspaceCreateRequest, WorkspaceCreateValue, WorkspaceDeleteValue, WorkspaceInsertSessionBeforeRequest, WorkspaceOrderValue, WorkspaceValue, WorkspaceId, WorkspaceView } from '../types.ts';
+/** Complete generated `ctx.remote.workspace` namespace. */
+export type WorkspaceRemote = TypertClientRemote['workspace'];
+/** Monotone Workspace-list arrival lifecycle. */
+export type WorkspaceListPhase = 'pending' | 'ready';
+/** Immutable Client Workspace state. */
+export interface WorkspaceSnapshot {
+    readonly items: readonly WorkspaceView[];
+    /** Complete registry-global archive set in Host order. */
+    readonly archivedSessionIds: WorkspaceArchiveValue['archivedSessionIds'];
+    readonly state: 'idle' | 'loading' | 'error';
+    readonly phase: WorkspaceListPhase;
+    readonly error: RemoteFailure | null;
+}
+/** State operations emitted by a decoded Workspace follow generation. */
+export interface WorkspaceFollowSink {
+    /** Replace all state from the generation baseline. */
+    replaceBaseline(value: WorkspaceBaseline): void;
+    /** Merge one Workspace row. */
+    upsertView(workspace: WorkspaceView): void;
+    /** Remove one Workspace row. */
+    removeView(workspaceId: WorkspaceId): void;
+    /** Replace the Host-confirmed Workspace order. */
+    replaceOrder(workspaceIds: readonly WorkspaceId[]): void;
+    /** Replace the complete archived Session set. */
+    replaceArchived(sessionIds: WorkspaceArchiveValue['archivedSessionIds']): void;
+}
+/**
+ * Owns the Client Workspace projection, mutation echoes, and stream/unary race resolution.
+ */
+export declare class ClientWorkspaceModel implements WorkspaceFollowSink {
+    private readonly remote;
+    private items;
+    private archivedSessionIds;
+    private state;
+    private phase;
+    private error;
+    /** Latest local reorder request; only its unary echo may install order. */
+    private orderRequestGeneration;
+    /** Increments on stream orders so a later remote commit outranks an older unary echo. */
+    private orderFrameGeneration;
+    /** Last complete order accepted from a baseline, increment, or current unary echo. */
+    private committedOrder;
+    /** Host Workspace ids are never reused, so delayed data cannot resurrect a removed row. */
+    private readonly removedIds;
+    private readonly listeners;
+    private snapshotCache;
+    private snapshotDirty;
+    private notificationPending;
+    private notificationScheduled;
+    private notificationGeneration;
+    /** @param remote - generated Workspace Remote namespace. */
+    constructor(remote: WorkspaceRemote);
+    /**
+     * Create or resolve a Workspace and merge the unary result immediately.
+     * @param input - existing absolute path to adopt.
+     * @returns generated Remote result.
+     */
+    create(input: WorkspaceCreateRequest): Promise<RemoteResult<WorkspaceCreateValue>>;
+    /**
+     * Rename a Workspace and merge the unary result immediately.
+     * @param workspaceId - target Workspace.
+     * @param title - new display title.
+     * @returns generated Remote result.
+     */
+    rename(workspaceId: WorkspaceId, title: string): Promise<RemoteResult<WorkspaceValue>>;
+    /**
+     * Delete a Workspace and remove it from the local projection immediately.
+     * @param workspaceId - target Workspace.
+     * @returns generated Remote result.
+     */
+    delete(workspaceId: WorkspaceId): Promise<RemoteResult<WorkspaceDeleteValue>>;
+    /**
+     * Optimistically move a Workspace and reconcile the returned complete order.
+     * @param workspaceId - Workspace to move.
+     * @param beforeWorkspaceId - anchor Workspace; omitted appends.
+     * @returns generated Remote result.
+     */
+    insertBefore(workspaceId: WorkspaceId, beforeWorkspaceId?: WorkspaceId): Promise<RemoteResult<WorkspaceOrderValue>>;
+    /**
+     * Move a Session within its Workspace and merge the returned row.
+     * @param workspaceId - owning Workspace.
+     * @param sessionId - accounted Session to move.
+     * @param beforeSessionId - accounted anchor; omitted appends.
+     * @returns generated Remote result.
+     */
+    insertSessionBefore(workspaceId: WorkspaceInsertSessionBeforeRequest['workspaceId'], sessionId: WorkspaceInsertSessionBeforeRequest['sessionId'], beforeSessionId?: WorkspaceInsertSessionBeforeRequest['beforeSessionId']): Promise<RemoteResult<WorkspaceValue>>;
+    /**
+     * Archive one Session and install the returned complete archive set.
+     * @param sessionId - Session to archive.
+     * @returns generated Remote result.
+     */
+    archiveSession(sessionId: WorkspaceArchiveSessionRequest['sessionId']): Promise<RemoteResult<WorkspaceArchiveValue>>;
+    /**
+     * Replace the projection from one complete stream-generation baseline.
+     * @param baseline - complete Workspace and archive projection.
+     */
+    replaceBaseline(baseline: WorkspaceBaseline): void;
+    /** Merge one decoded Workspace upsert from the current follow generation. */
+    upsertView(workspace: WorkspaceView): void;
+    /** Apply one decoded Workspace removal from the current follow generation. */
+    removeView(workspaceId: WorkspaceId): void;
+    /** Replace Host-confirmed order from the current follow generation. */
+    replaceOrder(workspaceIds: readonly WorkspaceId[]): void;
+    /**
+     * Replace the archived Session set from the current follow generation.
+     * @param archivedSessionIds - complete Host-confirmed archive set.
+     */
+    replaceArchived(archivedSessionIds: WorkspaceArchiveValue['archivedSessionIds']): void;
+    /** Keep the last complete projection visible while a lost carrier reconnects. */
+    handleCarrierFailure(): void;
+    /**
+     * Publish a non-retryable stream or protocol failure.
+     * @param error - terminal stream failure.
+     */
+    handleStreamFailure(error: unknown): void;
+    /**
+     * Subscribe to Workspace state invalidation.
+     * @param listener - invalidation callback.
+     * @returns unsubscribe function.
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Read the cached state, rebuilding it first when necessary.
+     * @returns the current stable Workspace list snapshot.
+     */
+    getSnapshot(): WorkspaceSnapshot;
+    private buildSnapshot;
+    private installArchived;
+    private installOrder;
+    private upsert;
+    private remove;
+    private installViews;
+    private invalidate;
+    private flush;
+    private refreshSnapshot;
+}
+//# sourceMappingURL=model.d.ts.map