@myagentroam/node 0.9.9 → 0.9.11

package/dist/workspace.d.ts

@@ -1,217 +0,0 @@
-import type { GitSummary, WorkspaceKind } from '@myagentroam/protocol';
-export interface WorkspaceInspection {
-    readonly path: string;
-    readonly kind: WorkspaceKind;
-    readonly gitSummary?: GitSummary;
-}
-export interface WorkspaceFileEntry {
-    readonly path: string;
-    readonly name: string;
-    readonly kind: 'FILE' | 'DIRECTORY';
-    readonly size: number | null;
-    readonly modifiedAt: number | null;
-}
-export interface WorkspaceFilePage {
-    readonly entries: readonly WorkspaceFileEntry[];
-    readonly nextCursor: string | null;
-    readonly truncated: boolean;
-}
-export interface WorkspaceFileSearchPage {
-    readonly entries: readonly WorkspaceFileEntry[];
-    readonly nextCursor: string | null;
-    readonly truncated: boolean;
-}
-export type WorkspaceUploadPreflightStatus = 'READY' | 'EXISTS_FILE' | 'EXISTS_DIRECTORY' | 'INVALID_NAME';
-export interface WorkspaceUploadTarget {
-    readonly path: string;
-    readonly absolutePath: string;
-    readonly status: WorkspaceUploadPreflightStatus;
-}
-export interface WorkspaceDirectoryEntry {
-    readonly path: string;
-    readonly name: string;
-    readonly selectable: boolean;
-}
-export interface WorkspaceDirectoryListing {
-    readonly homePath: string;
-    readonly currentPath: string;
-    readonly parentPath: string | null;
-    readonly browseRoots: readonly string[];
-    readonly selectable: boolean;
-    readonly entries: readonly WorkspaceDirectoryEntry[];
-    readonly truncated: boolean;
-}
-export declare function createWorkspaceDirectory(parentPath: string, directoryName: string, allowedRoots: readonly string[]): Promise<string>;
-/** A per-workspace, process-local index for the Quick Open file picker. */
-export declare class WorkspaceFileIndex {
-    private readonly workspaceRoot;
-    private readonly limits;
-    private entries;
-    private truncated;
-    private root;
-    private loading;
-    private stale;
-    private watcher;
-    private expiryTimer;
-    private fallbackTimer;
-    private signature;
-    constructor(workspaceRoot: string, limits?: {
-        readonly entryLimit?: number;
-        readonly idleTtlMs?: number;
-        readonly onInvalidated?: () => void;
-    });
-    /** Starts/renews the lightweight index observer without exposing file data. */
-    observe(): Promise<void>;
-    contentCandidates(): Promise<{
-        readonly entries: readonly WorkspaceFileEntry[];
-        readonly truncated: boolean;
-    }>;
-    dispose(): void;
-    search(query: string, cursor?: string, limit?: number, includeDirectories?: boolean): Promise<WorkspaceFileSearchPage>;
-    private ensureLoaded;
-    private touch;
-    private rebuild;
-    private startFallbackPolling;
-    private pollFallback;
-    private invalidate;
-}
-/**
- * Lists directory names only for the Workspace picker. Browsing begins at the
- * first allowed root when configured, while the Node account home remains a
- * browse boundary and terminal default.
- */
-export declare function listWorkspaceDirectories(requestedPath: string | undefined, allowedRoots: readonly string[], homePath?: string): Promise<WorkspaceDirectoryListing>;
-export declare function listWorkspaceFiles(workspaceRoot: string, requestedPath?: string, cursor?: string, limit?: number): Promise<WorkspaceFilePage>;
-export type WorkspaceFileMutation = {
-    readonly action: 'CREATE_FILE';
-    readonly path: string;
-} | {
-    readonly action: 'CREATE_DIRECTORY';
-    readonly path: string;
-} | {
-    readonly action: 'MOVE';
-    readonly path: string;
-    readonly destination: string;
-} | {
-    readonly action: 'DELETE';
-    readonly path: string;
-};
-export declare function mutateWorkspaceFile(workspaceRoot: string, mutation: WorkspaceFileMutation): Promise<{
-    readonly path?: string;
-    readonly deleted?: true;
-}>;
-/** Validates an upload destination without following an existing target symlink. */
-export declare function preflightWorkspaceUpload(workspaceRoot: string, requestedDirectory: string, name: string): Promise<WorkspaceUploadTarget>;
-export declare function workspaceUploadTemporaryName(uploadId: string): string;
-export declare function readWorkspaceTextFile(workspaceRoot: string, requestedPath: string, offset?: number, limit?: number): Promise<{
-    readonly path: string;
-    readonly encoding: 'utf-8' | 'base64';
-    readonly size: number;
-    readonly content: string;
-    readonly truncated: boolean;
-    readonly nextOffset: number | null;
-}>;
-export declare function readWorkspaceFileContentRange(workspaceRoot: string, requestedPath: string, offset?: number, limit?: number): Promise<{
-    readonly path: string;
-    readonly size: number;
-    readonly offset: number;
-    readonly contentBase64: string;
-    readonly nextOffset: number | null;
-}>;
-/** Reads one absolute file only when the resolved target remains within a Node allowed root. */
-export declare function readAllowedTextFile(requestedPath: string, allowedRoots: readonly string[], offset?: number, limit?: number): Promise<{
-    readonly path: string;
-    readonly encoding: 'utf-8' | 'base64';
-    readonly size: number;
-    readonly content: string;
-    readonly truncated: boolean;
-    readonly nextOffset: number | null;
-}>;
-/** Searches file names only, so an exploratory request cannot exfiltrate file contents. */
-export declare function searchWorkspaceFiles(workspaceRoot: string, query: string, cursor?: string, limit?: number, includeDirectories?: boolean): Promise<WorkspaceFileSearchPage>;
-export declare function normalizeWorkspacePath(input: string, platform?: NodeJS.Platform): string;
-export declare function isWithinAllowedRoot(target: string, roots: readonly string[], platform?: NodeJS.Platform): boolean;
-/** Resolving both candidate and roots rejects Linux symlinks which point outside a root. */
-export declare function inspectWorkspace(requestedPath: string, allowedRoots: readonly string[]): Promise<WorkspaceInspection>;
-export declare function readGitSummary(workspacePath: string): Promise<GitSummary>;
-export declare function assertSafeGitRef(ref: string): void;
-export declare function readRestrictedDiff(workspacePath: string, fromRef: string, toRef: string): Promise<{
-    readonly binary: boolean;
-    readonly text?: string;
-    readonly summary?: string;
-    readonly truncated: boolean;
-}>;
-export type CurrentChange = {
-    readonly path: string;
-    readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
-    readonly change: 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
-};
-export interface CurrentChangesRepository {
-    readonly repositoryPath: string;
-    readonly repositoryName: string;
-    readonly branch: string | null;
-    readonly changes: readonly CurrentChange[];
-}
-export declare function readCurrentChangesSummary(workspacePath: string): Promise<{
-    readonly branch: string | null;
-    readonly changes: readonly CurrentChange[];
-}>;
-export declare function listInitializedSubmodulePaths(workspacePath: string): Promise<readonly string[]>;
-export declare function resolveGitRepository(workspacePath: string, repositoryPath: string): Promise<string>;
-export interface GitHistoryRefEntry {
-    readonly name: string;
-    readonly displayName: string;
-    readonly kind: 'LOCAL' | 'REMOTE';
-    readonly hash: string;
-    readonly current: boolean;
-}
-export declare function listGitHistoryRefs(repository: string): Promise<readonly GitHistoryRefEntry[]>;
-export declare function readGitHistory(repository: string, input: {
-    readonly refs?: readonly string[];
-    readonly cursor?: string;
-    readonly limit?: number;
-}): Promise<{
-    readonly commits: readonly object[];
-    readonly nextCursor: string | null;
-}>;
-export declare function readGitHistoryFiles(repository: string, commit: string, refs?: readonly string[]): Promise<readonly {
-    path: string;
-    previousPath?: string;
-    change: ReturnType<typeof gitChange>;
-}[]>;
-export declare function readGitHistoryFileDiff(repository: string, commit: string, requestedPath: string, refs?: readonly string[], requestedPreviousPath?: string): Promise<{
-    readonly binary: boolean;
-    readonly text?: string;
-    readonly summary?: string;
-    readonly truncated: boolean;
-}>;
-export declare function readGitHistoryFileContentRange(repository: string, commit: string, requestedPath: string, offset: number, limit: number, refs?: readonly string[]): Promise<{
-    readonly path: string;
-    readonly size: number;
-    readonly offset: number;
-    readonly contentBase64: string;
-    readonly nextOffset: number | null;
-}>;
-export declare function readCurrentChanges(workspacePath: string): Promise<readonly {
-    readonly path: string;
-    readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
-    readonly change: 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
-}[]>;
-export declare function readCurrentChangeDiff(workspacePath: string, requestedPath: string): Promise<{
-    readonly binary: boolean;
-    readonly text?: string;
-    readonly summary?: string;
-    readonly truncated: boolean;
-    readonly afterText?: string;
-    readonly afterTruncated?: boolean;
-}>;
-/** Current Changes must not expose an external link. */
-export declare function isWorkspaceChangeVisible(workspacePath: string, requestedPath: string): Promise<boolean>;
-export declare function restoreCurrentChange(workspacePath: string, requestedPath: string, state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED'): Promise<void>;
-declare function gitChange(status: string): 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
-export declare class GitCommandError extends Error {
-    readonly code: number;
-    readonly stderr: string;
-    constructor(code: number, stderr: string);
-}
-export {};