@orion-agents/orion-code 0.3.15 → 0.3.17

package/dist/web/workbench-controller.d.ts

@@ -1,10 +1,13 @@
 import { AgentRuntimeController } from '../runtime/agent-runtime-controller';
+import type { GitCompareModeV1 } from './git-compare-service';
+import type { GitHistoryQueryV1 } from './git-history-service';
 import type { OrionCodeUiRuntime } from '../runtime/ui-events';
 import { WorkspaceRegistryV1 } from '../services/workspace-registry';
 import { WebEventHub } from './event-hub';
 import { FileReadServiceV1 } from './file-read-service';
 import { GitReadModelServiceV1 } from './git-read-model-service';
-import { type WebComposerActionResultV1, type WebComposerActionV1, type WebComposerControlStateV1, type WebBootstrapV1, type WebCommandResultV1, type WebContextActivateRequestV1, type WebContextGuardV1, type WebMcpServerSummaryV1, type WebPageV1, type WebSessionSnapshotV1, type WebSessionSummaryV1, type WebSettingsMutationResultV1, type WebSettingsSnapshotV1, type WebSettingsUpdateRequestV1, type WebSkillSummaryV1, type WebToolDetailPageV1, type WebToolDetailSummaryV1, type WebWorkspaceSummaryV1, type WebWorkspaceProjectSummaryV1 } from './protocol';
+import { type WebComposerActionResultV1, type WebComposerActionV1, type WebComposerControlStateV1, type WebBootstrapV1, type WebCommandResultV1, type WebContextActivateRequestV1, type WebContextGuardV1, type WebMcpServerSummaryV1, type WebPageV1, type WebSessionSnapshotV1, type WebSessionSummaryV1, type WebSettingsMutationResultV1, type WebSettingsSnapshotV1, type WebSettingsUpdateRequestV1, type WebSkillSummaryV1, type WebToolDetailPageV1, type WebToolDetailSummaryV1, type WebWorkspaceSummaryV1, type WebWorkspaceProjectSummaryV1, type WebWorkspaceCandidateSourceV1, type WebWorkspaceCandidateV1 } from './protocol';
+import { type NativeDirectoryPickResult, type NativeDirectoryPicker } from './native-directory-picker';
 import { type WebSessionRuntimeSummaryV1 } from './session-runtime-registry';
 import { TerminalManagerV1 } from './terminal-manager';
 export { WebWorkbenchError } from './errors';
@@ -14,6 +17,8 @@ export interface WebWorkbenchControllerOptions {
     readonly createRuntime?: (cwd: string) => Promise<OrionCodeUiRuntime>;
     readonly createSessionRuntime?: (cwd: string) => Promise<OrionCodeUiRuntime>;
     readonly workspaceRegistry?: WorkspaceRegistryV1;
+    /** v0.3.16 — Host native directory picker; injectable for tests. */
+    readonly nativeDirectoryPicker?: NativeDirectoryPicker;
 }
 /** Owns the Workspace surface plus the bounded Web Session actor registry. */
 export declare class WebWorkbenchController {
@@ -34,6 +39,11 @@ export declare class WebWorkbenchController {
      */
     private readonly workspaceKernels;
     private readonly workspaceRegistry;
+    /** v0.3.16 — Host directory picker plus its single-in-flight guard. */
+    private readonly directoryPicker;
+    private pickerInFlight;
+    /** v0.3.17 — bounded, path-free open-path traces exposed through diagnostics(). */
+    private readonly openTelemetry;
     readonly terminalManager: TerminalManagerV1;
     private readonly mutationResults;
     private readonly sessionViews;
@@ -78,6 +88,29 @@ export declare class WebWorkbenchController {
     bootstrap(nonce: string): WebBootstrapV1;
     settings(): WebSettingsSnapshotV1;
     listWorkspaces(context?: WebContextGuardV1): readonly WebWorkspaceSummaryV1[];
+    /**
+     * v0.3.16 — Ask the Host to run the OS directory picker.
+     *
+     * This is a *browse* action: it never registers, activates or reads a
+     * workspace. Only one picker may be open at a time so a stuck native dialog
+     * cannot be stacked, and the result is a plain path the caller must still
+     * confirm through the normal activation flow.
+     */
+    pickDirectory(input: {
+        readonly title?: string;
+        readonly initialPath?: string;
+        /** v0.3.17 — optional trace correlation id from the HTTP request. */
+        readonly requestId?: string;
+    }): Promise<NativeDirectoryPickResult>;
+    /**
+     * v0.3.17 — Read-only, bounded preview of a candidate directory.
+     *
+     * Probes with asynchronous fs so a hung network mount or a broken symlink
+     * cannot freeze the Node event loop, and races the whole probe against a
+     * short budget. It never registers a workspace, activates a Context, reads
+     * file contents, or touches the session catalog beyond a warm-cache peek.
+     */
+    inspectWorkspaceFast(path: string, source?: WebWorkspaceCandidateSourceV1, requestId?: string): Promise<WebWorkspaceCandidateV1>;
     listWorkspaceSessions(workspaceId: string, context?: WebContextGuardV1): readonly WebSessionSummaryV1[];
     /** Archived sessions of a Workspace (v0.3.7), newest archive first. */
     listArchivedWorkspaceSessions(workspaceId: string, context?: WebContextGuardV1): readonly WebSessionSummaryV1[];
@@ -138,14 +171,90 @@ export declare class WebWorkbenchController {
     }): Promise<{
         readonly repositoryRevision: string;
     }>;
-    gitCommit(context: WebContextGuardV1, input: {
-        readonly message: string;
+    /**
+     * v0.3.17 S4 — history reads.
+     *
+     * Read-only by construction: they are registered as queries, so none of them can reach the
+     * mutation path (`assertMutation` / `executeMutation` are never involved). That is what
+     * makes "browsing history never writes to the workspace" a structural property rather than
+     * a promise.
+     */
+    /**
+     * v0.3.17 S6 — translate a Git file token into a Files token (plan G7).
+     *
+     * The browser never derives one token from the other: the Git token is resolved to a
+     * workspace-relative path here, and only the FileReadService mints the Files-side id.
+     * That keeps the two id spaces from leaking into each other.
+     */
+    gitFilesTarget(context: WebContextGuardV1, gitFileToken: string): Promise<Readonly<{
+        path: string;
+        source: import("./git-file-source").GitWorktreeSourceV1;
+        filesToken: string;
+    }>>;
+    gitRefs(context: WebContextGuardV1): Promise<import("./git-history-service").GitRefsV1>;
+    gitHistory(context: WebContextGuardV1, query: GitHistoryQueryV1): Promise<import("./git-history-service").GitHistoryPageV1>;
+    gitCommitDetail(context: WebContextGuardV1, oid: string, parentIndex?: number): Promise<import("./git-history-service").GitCommitDetailV1>;
+    gitCommitFiles(context: WebContextGuardV1, oid: string, parentIndex?: number): Promise<import("./git-history-service").GitCommitFilesV1>;
+    gitCommitDiff(context: WebContextGuardV1, input: {
+        readonly oid: string;
+        readonly path: string;
+        readonly parentIndex?: number;
+        readonly cursor?: string;
+    }): Promise<import("./git-diff-document").GitDiffDocumentV2>;
+    /**
+     * v0.3.17 S5 — branch/version comparison. Registered as a query: the compare view can
+     * never reach the mutation path.
+     */
+    gitCompare(context: WebContextGuardV1, input: {
+        readonly baseRef: string;
+        readonly headRef: string;
+        readonly mode: GitCompareModeV1;
+    }): Promise<import("./git-compare-service").GitCompareResultV1>;
+    gitCompareFileDiff(context: WebContextGuardV1, input: {
+        readonly baseOid: string;
+        readonly headOid: string;
+        readonly path: string;
+        readonly cursor?: string;
+    }): Promise<import("./git-diff-document").GitDiffDocumentV2>;
+    /** v0.3.17 S5 — the commit graph, as git itself drew it. Read-only. */
+    gitGraph(context: WebContextGuardV1, input: {
+        readonly limit?: number;
+    }): Promise<import("./git-history-service").GitGraphPageV1>;
+    gitBlame(context: WebContextGuardV1, input: {
+        readonly path: string;
+        readonly rev?: string;
+        readonly limit?: number;
+    }): Promise<import("./git-history-service").GitBlameResultV1>;
+    /**
+     * v0.3.17 S5 — conflict stages, historical blobs and gitlink entries. All query-only.
+     */
+    gitConflictVersions(context: WebContextGuardV1, path: string): Promise<import("./git-version-service").GitConflictVersionsV1>;
+    gitBlob(context: WebContextGuardV1, input: {
+        readonly path: string;
+        readonly rev: string;
+    }): Promise<import("./git-version-service").GitBlobResultV1>;
+    gitSubmodules(context: WebContextGuardV1): Promise<readonly import("./git-version-service").GitSubmoduleEntryV1[]>;
+    gitFileHistory(context: WebContextGuardV1, input: {
+        readonly path: string;
+        readonly rev?: string;
+        readonly limit?: number;
+    }): Promise<import("./git-history-service").GitFileHistoryPageV1>;
+    /** v0.3.17 S3 — preview of what the index would commit, independent of list filters. */
+    gitCommitPreview(context: WebContextGuardV1): Promise<import("./git-read-model-service").GitCommitPreviewV1>;
+    /**
+     * v0.3.17 S3 — commit against the frozen revision the form showed. Identity, signing and
+     * hooks come from the repository's own configuration (plan §7.9).
+     */
+    gitCommit(context: WebContextGuardV1, input: Parameters<GitReadModelServiceV1['commit']>[0]): Promise<import("./git-read-model-service").GitCommitOutcomeV1>;
+    /** v0.3.17 S3 — Host-rebuilt hunk or line selection applied to the index only. */
+    gitApplyPatch(context: WebContextGuardV1, input: {
+        readonly fileId: string;
         readonly expectedRepositoryRevision: string;
-    }): Promise<{
-        readonly repositoryRevision: string;
-        readonly commitSha: string;
-    }>;
-    private resolveSafeGitPaths;
+        readonly hunkIds?: readonly string[];
+        readonly lineIds?: readonly string[];
+    }): Promise<import("./git-read-model-service").GitMutationResultV1>;
+    /** v0.3.17 S2 — structured diff document for the selected comparison source. */
+    gitDiffDocument(context: WebContextGuardV1, input: Parameters<GitReadModelServiceV1['diffDocument']>[0]): Promise<import("./git-diff-document").GitDiffDocumentV2>;
     private assertGitRepositoryRevision;
     private fileContextRevision;
     gitLog(context: WebContextGuardV1, input: Parameters<GitReadModelServiceV1['log']>[0]): Promise<import("./git-read-model-service").WebGitLogPageV1>;
@@ -171,8 +280,10 @@ export declare class WebWorkbenchController {
      * hold them open — require that no actor exists at all (phase 'cold').
      */
     private assertSessionHasNoActor;
-    switchWorkspace(path: string, context: WebContextGuardV1): Promise<void>;
-    activateContext(input: Omit<WebContextActivateRequestV1, 'requestId'>): Promise<void>;
+    switchWorkspace(path: string, context: WebContextGuardV1, requestId?: string): Promise<void>;
+    activateContext(input: Omit<WebContextActivateRequestV1, 'requestId'> & {
+        readonly requestId?: string;
+    }): Promise<void>;
     dispatch(raw: unknown): Promise<WebCommandResultV1>;
     private resolveCommandContext;
     private resolveContextReference;
@@ -239,4 +350,9 @@ export declare class WebWorkbenchController {
 }
 export declare function pageItems<T>(items: readonly T[], cursor?: string, pageSize?: number): WebPageV1<T>;
 export declare function pageCollectionItems<T>(scope: string, items: readonly T[], cursor: string | undefined, pageSize: number, keyOf: (item: T) => string): WebPageV1<T>;
+/**
+ * True when a directory looks like a project root. Only marker *existence* is
+ * checked — never file contents — which is what roots discovery filters on.
+ */
+export declare function hasProjectSignal(canonicalPath: string): boolean;
 //# sourceMappingURL=workbench-controller.d.ts.map