@myagentroam/node 0.9.9 → 0.9.11

package/dist/service/workspace-session-service.d.ts

@@ -1,23 +0,0 @@
-import type { NodeAgentSession } from '../database.js';
-import { WorkspaceDomainState } from './workspace-domain-state.js';
-export interface WorkspaceSessionServiceOptions {
-    discover: (workspaceId: string) => Promise<readonly NodeAgentSession[]>;
-    listPage: (workspaceId: string) => Promise<unknown>;
-    active: (workspaceId: string) => boolean;
-    emitRevision: (workspaceId: string, revision: number) => void;
-    onPending?: (workspaceId: string, waitMs: number) => void;
-}
-export declare class WorkspaceSessionService {
-    private readonly state;
-    private readonly options;
-    private readonly cacheGenerations;
-    constructor(state: WorkspaceDomainState, options: WorkspaceSessionServiceOptions);
-    ensureWatch(workspaceId: string): void;
-    stopWatch(workspaceId: string): void;
-    cached(workspaceId: string): Promise<readonly NodeAgentSession[]>;
-    clear(): void;
-    invalidate(workspaceId: string): void;
-    private bumpCacheGeneration;
-    private refreshWatch;
-    private performRefresh;
-}

package/dist/service/workspace-upload-service.d.ts

@@ -1,39 +0,0 @@
-import type { NodeMessageAttachmentInput, NodeWorkspace } from '../database.js';
-import { WorkspaceDomainState } from './workspace-domain-state.js';
-export interface ResolvedComposerAttachment {
-    readonly attachment: NodeMessageAttachmentInput;
-    readonly path: string;
-}
-export declare class WorkspaceUploadService {
-    private readonly state;
-    private readonly onCompleted;
-    constructor(state: WorkspaceDomainState, onCompleted: (workspaceId: string) => void);
-    preflight(workspace: NodeWorkspace, input: Record<string, unknown>): Promise<({
-        name: string;
-        status: string;
-        path: null;
-    } | {
-        name: string;
-        status: import("../workspace.js").WorkspaceUploadPreflightStatus;
-        path: string | null;
-    })[]>;
-    create(workspace: NodeWorkspace, input: Record<string, unknown>): Promise<UploadStatus>;
-    write(input: Record<string, unknown>): Promise<UploadStatus>;
-    status(uploadId: unknown): UploadStatus;
-    complete(uploadId: unknown): Promise<UploadStatus>;
-    cancel(uploadId: unknown): Promise<void>;
-    resolve(workspaceId: string, ids: readonly string[]): Promise<readonly ResolvedComposerAttachment[]>;
-    consume(ids: readonly string[]): Promise<void>;
-    shutdown(): Promise<void>;
-    private require;
-    private remove;
-    private removeCompleted;
-    private attachmentTarget;
-}
-interface UploadStatus {
-    readonly uploadId: string;
-    readonly path: string;
-    readonly receivedBytes: number;
-    readonly size: number;
-}
-export {};

package/dist/service/workspace-watch-service.d.ts

@@ -1,23 +0,0 @@
-import { WorkspaceDomainState, type WorkspaceWatch } from './workspace-domain-state.js';
-export declare class WorkspaceWatchService {
-    private readonly state;
-    private readonly onSessionWatchRequired;
-    private readonly onSessionWatchUnused;
-    constructor(state: WorkspaceDomainState, onSessionWatchRequired: (workspaceId: string) => void, onSessionWatchUnused: (workspaceId: string) => void);
-    parseTopics(input: Record<string, unknown>): WorkspaceWatch['topics'];
-    key(input: Record<string, unknown>): string;
-    sessionHash(input: Record<string, unknown>): string;
-    connectionId(input: Record<string, unknown>): string;
-    create(workspaceId: string, watchId: string, sessionHash: string, workbenchConnectionId: string, nodeGeneration: string, topics: WorkspaceWatch['topics']): WorkspaceWatch;
-    renew(workspaceId: string, key: string, watchId?: string): WorkspaceWatch | undefined;
-    matches(workspaceId: string, key: string, watchId: string): boolean;
-    existing(workspaceId: string, key: string): WorkspaceWatch | undefined;
-    remove(workspaceId: string, key: string): void;
-    clear(workspaceId: string): void;
-    clearAll(): void;
-    nextRevision(workspaceId: string): number;
-    nextSnapshotSequence(): number;
-    topicActive(workspaceId: string, topic: 'files' | 'changes' | 'sessions'): boolean;
-    activeWatches(workspaceId: string): readonly WorkspaceWatch[];
-    private expiryTimer;
-}

package/dist/service/workspace-workbench-service.d.ts

@@ -1,58 +0,0 @@
-import type { NodeOperationHandler } from '../connector/node-operation-router.js';
-import type { NodeWorkspace } from '../database.js';
-import { WorkspaceChangeService } from './workspace-change-service.js';
-import { WorkspaceFileService } from './workspace-file-service.js';
-import { WorkspaceUploadService } from './workspace-upload-service.js';
-import { WorkspaceWatchService } from './workspace-watch-service.js';
-export interface WorkspaceWorkbenchServiceOptions {
-    readonly requireWorkspace: (workspaceId: unknown) => NodeWorkspace;
-    readonly watch: WorkspaceWatchService;
-    readonly files: WorkspaceFileService;
-    readonly uploads: WorkspaceUploadService;
-    readonly changes: WorkspaceChangeService;
-    readonly listSessions: (workspaceId: string) => Promise<unknown>;
-    readonly invalidate: (workspaceId: string) => void;
-    readonly nodeId: () => string;
-    readonly nodeGeneration: () => string;
-    readonly emitWatchEvent: (payload: unknown) => void;
-}
-export declare class WorkspaceWorkbenchService {
-    private readonly options;
-    private readonly contentSearch;
-    private readonly topicRefreshes;
-    private readonly dirtyTopics;
-    constructor(options: WorkspaceWorkbenchServiceOptions);
-    operations(): Readonly<Record<string, NodeOperationHandler>>;
-    refreshTopic(workspaceId: string, topic: 'sessions' | 'files' | 'changes'): Promise<void>;
-    private emitTopicFailure;
-    private performTopicRefresh;
-    private watch;
-    private unwatch;
-    private accepted;
-    private createInitialSnapshots;
-    private emitSnapshot;
-    private deliverSnapshot;
-    private listFiles;
-    private readFile;
-    private searchFiles;
-    private mutateFile;
-    private searchContent;
-    private preflight;
-    private createUpload;
-    private writeUpload;
-    private completeUpload;
-    private cancelUpload;
-    private currentChanges;
-    private readFileContent;
-    private changeDiff;
-    private restoreChange;
-    private gitRepository;
-    private refs;
-    private gitRefs;
-    private gitHistory;
-    private gitCommitFiles;
-    private gitCommitFileDiff;
-    private gitCommitFileContent;
-    private diff;
-    private gitWorkspace;
-}

package/dist/service.d.ts

@@ -1,4 +0,0 @@
-export declare function systemdUnit(executable: string, configPath: string, entrypoint?: string, writablePaths?: readonly string[]): string;
-export declare function windowsServiceDefinition(executable: string, configPath: string, entrypoint?: string): string;
-export declare function writeServiceDefinition(outputPath: string, executable: string, configPath: string, platform?: NodeJS.Platform, entrypoint?: string, writablePaths?: readonly string[]): Promise<void>;
-export declare function removeServiceDefinition(outputPath: string): Promise<void>;

package/dist/storage.d.ts

@@ -1,2 +0,0 @@
-export declare function isUnsupportedSqlitePath(path: string, platform?: NodeJS.Platform): boolean;
-export declare function assertLocalSqlitePath(path: string): Promise<void>;

package/dist/supervisor.d.ts

@@ -1 +0,0 @@
-export declare function superviseNode(configPath: string, bootstrapEntrypoint: string): Promise<void>;

package/dist/terminal.d.ts

@@ -1,133 +0,0 @@
-import { type TerminalDataFrame } from '@myagentroam/protocol';
-import { type ManagedProcess } from './process-tree.js';
-export type TerminalPlatform = 'linux' | 'win32';
-export type TerminalState = 'RUNNING' | 'EXITED' | 'CLOSED';
-/** The subset of node-pty used by the terminal lifecycle, kept injectable for tests. */
-export interface TerminalPty extends ManagedProcess {
-    write(data: string): void;
-    resize(cols: number, rows: number): void;
-    onData(listener: (data: string) => void): {
-        dispose(): void;
-    };
-    onExit(listener: (event: {
-        exitCode: number;
-        signal?: number;
-    }) => void): {
-        dispose(): void;
-    };
-}
-export interface TerminalProfile {
-    readonly id: string;
-    readonly label: string;
-    readonly shell: string;
-    readonly args: readonly string[];
-    readonly isDefault: boolean;
-}
-export interface TerminalSpawnOptions {
-    readonly name: string;
-    readonly cols: number;
-    readonly rows: number;
-    readonly cwd: string;
-    readonly env: Readonly<Record<string, string | undefined>>;
-}
-export type TerminalPtyFactory = (shell: string, args: readonly string[], options: TerminalSpawnOptions) => TerminalPty;
-export interface TerminalManagerOptions {
-    readonly platform?: TerminalPlatform;
-    /** This is controlled by the Node service, never supplied by a browser request. */
-    readonly cwd?: string;
-    readonly profiles?: readonly TerminalProfile[];
-    readonly maxTerminals?: number;
-    readonly maxTerminalsPerWorkspace?: number;
-    readonly maxReplayBytes?: number;
-    readonly idleTimeoutMs?: number;
-    readonly now?: () => number;
-    readonly ptyFactory?: TerminalPtyFactory;
-    readonly terminate?: (process: ManagedProcess, platform: TerminalPlatform) => Promise<void>;
-}
-export interface TerminalSummary {
-    readonly id: string;
-    readonly workspaceId: string | null;
-    readonly profileId: string;
-    readonly state: TerminalState;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-    readonly exitCode: number | null;
-    readonly rows: number;
-    readonly cols: number;
-    readonly latestSequence: number;
-}
-export interface TerminalAttachment {
-    readonly attachmentId: string;
-    readonly terminalId: string;
-    readonly readonly: boolean;
-    readonly frames: readonly TerminalDataFrame[];
-}
-/**
- * Owns Node-local PTY/ConPTY processes and their bounded output replay.
- * Browser relay transport intentionally lives outside this class: callers pass
- * only schema-validated TerminalDataFrame values after Server authorization.
- */
-export declare class TerminalManager {
-    private readonly platform;
-    private readonly cwd;
-    private readonly profiles;
-    private readonly maxTerminals;
-    private readonly maxTerminalsPerWorkspace;
-    private readonly maxReplayBytes;
-    private readonly idleTimeoutMs;
-    private readonly now;
-    private readonly ptyFactory;
-    private readonly terminate;
-    private readonly terminals;
-    private readonly attachments;
-    private readonly frameListeners;
-    private readonly summaryListeners;
-    private idleTimer;
-    constructor(options?: TerminalManagerOptions);
-    availableProfiles(): readonly Pick<TerminalProfile, 'id' | 'label' | 'isDefault'>[];
-    limits(): {
-        readonly maxTerminals: number;
-        readonly maxTerminalsPerWorkspace: number;
-        readonly maxReplayBytes: number;
-        readonly reconnectWindowMs: number;
-    };
-    open(input?: {
-        readonly profileId?: unknown;
-        readonly rows?: unknown;
-        readonly cols?: unknown;
-        readonly cwd?: unknown;
-        /** Resolved by NodeConnector; never trusted from a browser directly. */
-        readonly workspaceId?: string | null;
-        readonly environment?: Readonly<Record<string, string>>;
-    }): TerminalSummary;
-    list(): readonly TerminalSummary[];
-    get(terminalId: string): TerminalSummary;
-    /** One attachment may write. A new writer must explicitly take over. */
-    authorizeAttach(input: {
-        readonly terminalId?: unknown;
-        readonly afterSequence?: unknown;
-        readonly readonly?: unknown;
-        readonly takeover?: unknown;
-    }): TerminalAttachment;
-    detach(attachmentId: string): void;
-    /** Processes data frames from an already-authorized Server relay attachment. */
-    acceptFrame(attachmentId: string, frame: unknown): Promise<void>;
-    close(terminalId: string): Promise<TerminalSummary>;
-    shutdown(): Promise<void>;
-    onFrame(listener: (frame: TerminalDataFrame) => void): () => void;
-    onSummary(listener: (summary: TerminalSummary) => void): () => void;
-    private closeExpired;
-    private recordOutput;
-    private exited;
-    private replayFrames;
-    private summary;
-    private notifySummary;
-    private requireTerminal;
-    private runningCount;
-    private evictForNewTerminal;
-    private evictLeastRecentlyUsed;
-    private runningCountForWorkspace;
-    private hasAttachment;
-    private detachAll;
-    private emit;
-}

package/dist/util/node-operation-parsers.d.ts

@@ -1,92 +0,0 @@
-import type { AgentRunStatus, NodeCapabilities, NodeEnvelope } from '@myagentroam/protocol';
-import type { NodeAgentRun, NodeConversationTurn, NodeMessageAttachmentInput } from '../database.js';
-import type { NativeTranscriptToolCall } from '../native-session-history.js';
-export type RunnerImageAttachment = NodeMessageAttachmentInput & {
-    readonly mime: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
-};
-export declare const DEFAULT_SESSION_PAGE_SIZE = 10;
-export declare const MAX_SESSION_PAGE_SIZE = 100;
-export declare function sessionPage<T extends {
-    readonly id: string;
-    readonly lastActivityAt: number;
-    readonly pinOrder?: number | null;
-    readonly externalDiscovered?: boolean;
-}>(sessions: readonly T[], input: Record<string, unknown>): {
-    readonly sessions: readonly T[];
-    readonly nextCursor: string | null;
-};
-export declare function parseSessionPageCursor(cursor: string): {
-    readonly id: string;
-    readonly lastActivityAt: number;
-    readonly pinOrder: number | null;
-    readonly externalDiscovered: boolean;
-} | undefined;
-export declare function createSessionPageCursor(session: {
-    readonly id: string;
-    readonly lastActivityAt: number;
-    readonly pinOrder?: number | null;
-    readonly externalDiscovered?: boolean;
-}): string;
-export declare function compareSessionPageEntries(left: {
-    readonly id: string;
-    readonly lastActivityAt: number;
-    readonly pinOrder?: number | null;
-    readonly externalDiscovered?: boolean;
-}, right: {
-    readonly id: string;
-    readonly lastActivityAt: number;
-    readonly pinOrder?: number | null;
-    readonly externalDiscovered?: boolean;
-}): number;
-export declare function compactRunnerText(value: string, limit: number): string;
-export declare function compactRunnerValue(value: unknown, limit: number): {
-    readonly text: string;
-    readonly truncated: boolean;
-};
-export declare function codexTimestamp(value: unknown): number | null;
-export declare function nativePageEnd(cursor: string | undefined, sessionId: string, fallback: number): number;
-export declare function extractClaudeText(message: Record<string, unknown>): string;
-export declare function extractClaudeThinkingSummaries(message: Record<string, unknown>): readonly string[];
-export declare function extractClaudeToolUses(message: Record<string, unknown>): readonly {
-    readonly id: string;
-    readonly name: string;
-    readonly input: unknown;
-    readonly command?: string;
-    readonly inputTruncated: boolean;
-}[];
-export declare function extractClaudeToolResults(message: Record<string, unknown>): readonly {
-    readonly toolUseId: string;
-    readonly output: string;
-    readonly failed: boolean;
-    readonly truncated: boolean;
-}[];
-export declare function claudeContentBlocks(message: Record<string, unknown>): readonly Record<string, unknown>[];
-export declare function isClaudeCommandTool(name: string): boolean;
-export declare function nativeClaudeCommand(entry: NativeTranscriptToolCall): string;
-export declare function boundedConversationItemId(prefix: string, value: string): string;
-export declare function validUserAuthorization(value: unknown, envelope: NodeEnvelope, operation: string, nodeId: string | undefined, now?: number): boolean;
-export declare function isTerminalRunStatus(status: AgentRunStatus): boolean;
-export declare function validSessionOption(value: unknown): boolean;
-export declare function validSessionEffort(value: unknown): boolean;
-export declare function validSessionTitle(value: unknown): boolean;
-export declare function sessionTitleFromFirstMessage(content: string): string;
-export declare function parseComposerAttachmentUpload(input: Record<string, unknown>): {
-    readonly id: string;
-    readonly name: string;
-    readonly mime: string;
-} | undefined;
-export declare function parseComposerAttachmentIds(value: unknown): readonly string[];
-export declare function validComposerAttachmentName(name: string): boolean;
-export declare function isUuid(value: string): boolean;
-export declare function parseMessageAttachments(value: unknown): readonly NodeMessageAttachmentInput[];
-export declare function parseRunnerImageAttachments(value: unknown): readonly RunnerImageAttachment[];
-export declare function isRunnerImageAttachment(attachment: NodeMessageAttachmentInput): attachment is RunnerImageAttachment;
-export declare function isImageAttachment(attachment: NodeMessageAttachmentInput): boolean;
-export declare function withNonImageAttachmentPrompt(input: string, paths: readonly string[]): string;
-export declare function isCanonicalBase64(value: string): boolean;
-export declare function validatedCapabilities(value: unknown): NodeCapabilities;
-export declare function nodeConnectEndpoint(serverUrl: string): string;
-export declare function nodeTerminalConnectEndpoint(serverUrl: string): string;
-export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
-export declare function isNodeAgentRun(value: unknown): value is NodeAgentRun;
-export declare function isNodeConversationTurn(value: unknown): value is NodeConversationTurn;

package/dist/util/personal-instructions.d.ts

@@ -1,2 +0,0 @@
-import type { RunnerName } from '@myagentroam/protocol';
-export declare function personalInstructionsForRunner(value: unknown, runner: RunnerName): string | undefined;

package/dist/util/runner-error.d.ts

@@ -1,6 +0,0 @@
-export interface RunnerErrorProjection {
-    readonly code: string;
-    readonly message: string;
-    readonly httpStatus: number | null;
-}
-export declare function runnerErrorProjection(error: unknown, fallbackCode: string): RunnerErrorProjection;

package/dist/util/runner-native-session-parsers.d.ts

@@ -1,74 +0,0 @@
-import type { SessionActivityState } from '@myagentroam/protocol';
-import type { NodeAgentSession, NodeConversationItem, NodeConversationTurn } from '../database.js';
-import type { NativeSessionHistory, NativeTranscriptImageAttachment } from '../native-session-history.js';
-export interface SessionContextUsage {
-    readonly model: string | null;
-    readonly usedTokens: number;
-    readonly maxTokens: number;
-    readonly percentage: number;
-}
-export type ConversationHistorySource = 'official' | 'native' | 'runtime';
-export interface ConversationHistoryPage {
-    readonly turns: readonly NodeConversationTurn[];
-    readonly nextCursor: string | null;
-    readonly snapshotSequence: number;
-    readonly source: ConversationHistorySource;
-    readonly readAt: number;
-    readonly latestVisibleAt: number;
-    readonly deferredOlderHistory?: boolean;
-}
-export declare function extractId(result: unknown, key: 'thread' | 'turn'): string;
-export declare function settleWithin<T>(promise: Promise<T>, milliseconds: number): Promise<T | undefined>;
-export declare function extractCodexThreads(result: unknown): readonly {
-    readonly id: string;
-    readonly source: string | undefined;
-    readonly derived: boolean;
-    readonly cwd: unknown;
-    readonly title: string | undefined;
-}[];
-export declare function codexThreadActivity(result: unknown): SessionActivityState;
-export declare function codexActiveTurnId(result: unknown): string | undefined;
-export declare function codexThreadCwd(value: unknown): string;
-export declare function isWithinWorkspace(cwd: string, workspacePath: string): boolean;
-export declare function claudeDiscoveredSession(value: unknown, fallbackCwd: string): {
-    readonly externalSessionId: string;
-    readonly cwd: string;
-    readonly title?: string;
-} | undefined;
-export declare function latestNativeActivity(history: NativeSessionHistory): number;
-export declare function sameContextUsage(left: SessionContextUsage, right: SessionContextUsage): boolean;
-export declare function isNativeHistory(value: unknown): value is NativeSessionHistory;
-export declare function deduplicateDirectSessions<T extends NodeAgentSession>(sessions: readonly T[]): readonly T[];
-export declare function nativeConversationPage(session: NodeAgentSession, history: NativeSessionHistory, input: {
-    readonly cursor?: string;
-    readonly limit?: number;
-}, runtimeTurns?: readonly NodeConversationTurn[], registerImages?: (images: readonly NativeTranscriptImageAttachment[]) => readonly Record<string, unknown>[]): {
-    readonly turns: readonly NodeConversationTurn[];
-    readonly nextCursor: string | null;
-};
-export declare function runtimeAssistantProjectionMoreComplete(runtimeTurn: NodeConversationTurn | undefined, projectedItems: readonly NodeConversationItem[]): boolean;
-/**
- * Claude JSONL does not retain browser request IDs. While the Node process is alive, match current
- * runtime user messages by content and creation time so native history replaces the optimistic Turn.
- */
-export declare function nativeUserClientMessageId(entry: Extract<NativeSessionHistory['items'][number], {
-    readonly kind: 'message';
-}>, createdAt: number | null, runtimeTurns: readonly NodeConversationTurn[]): string | null;
-/**
- * Normalize the documented App Server `thread/read(includeTurns: true)`
- * result.  Only items with a user-visible Workbench representation are kept;
- * raw protocol envelopes are deliberately never exposed to Web.
- */
-export declare function claudePlanText(text: string): string | undefined;
-export declare function claudeUserInputQuestions(value: Record<string, unknown>): readonly {
-    readonly id: string;
-    readonly prompt: string;
-    readonly input: 'SINGLE_SELECT' | 'MULTI_SELECT' | 'SHORT_TEXT';
-    readonly options: readonly {
-        readonly value: string;
-        readonly label: string;
-        readonly description: string | null;
-    }[];
-    readonly allowOther: boolean;
-    readonly multiSelect: boolean;
-}[];

package/dist/util/safe-error.d.ts

@@ -1,2 +0,0 @@
-/** Returns only a stable public error code, never a raw runtime exception message. */
-export declare function safeErrorCode(error: unknown, fallback: string): string;

package/dist/util/secret-environment.d.ts

@@ -1 +0,0 @@
-export declare function parseSecretEnvironment(value: unknown): Readonly<Record<string, string>>;