creatixchu
7fd2abd828
The web GUI's folder picking was hardwired to one interaction: a native OS chooser compiled into the gateway, unusable for remote deployments and swappable only by editing apiproxy source. Directory picking becomes a three-package capability seam in packages/host: ctx.directoryPicker returns a discriminated capability — dialog (the extracted native chooser; host-display only) or browse (new: one-level listing + child creation over Node stdlib, hidden flags host-stamped, symlinks followed, ancestry crumbs; remote-capable). The gateway injects the seam, advertises the kind via host.describe.directoryPicker, serves host.listDirectory / host.createDirectory under browse, and answers directory-picker-unavailable across kinds. cordis.yml is the swap point; apps/cli keeps dialog mounted, so behavior is unchanged until the in-app browser PR flips the default. The connection fixture serves a deterministic browse tree; WorkspacesService gains the browse calls the browser UI will drive. Decision record: .agents/notes/implemented/architecture/2026-07-28-directory-picker-capability-seam.md
59 lines
2.4 KiB
TypeScript
59 lines
2.4 KiB
TypeScript
/**
|
|
* apiproxy contract-layer barrel. api/ has zero Node dependencies and is
|
|
* importable from the browser; the TS interfaces are the authoritative contract, HTTP/SSE are
|
|
* merely physical channels (four-quadrant message model).
|
|
*/
|
|
|
|
import type { SessionsApi } from './sessions.ts'
|
|
import type { HostApi } from './host.ts'
|
|
import type { WorkspaceApi } from './workspace.ts'
|
|
import type { CommandsApi } from './commands.ts'
|
|
import type { SkillsApi } from './skills.ts'
|
|
import type { EventsApi } from './events.ts'
|
|
import type { ClientResponse, RpcReceipt } from './rpc.ts'
|
|
|
|
/** Root interface of the unified API surface. New client-request domain = one new file pair + one field here + one map row. */
|
|
export interface ApiProxy {
|
|
sessions: SessionsApi
|
|
host: HostApi
|
|
workspace: WorkspaceApi
|
|
commands: CommandsApi
|
|
skills: SkillsApi
|
|
events: EventsApi
|
|
/** Response entry for server-requests (client-response, echoing their rpcId); not a domain method (four-quadrant model). */
|
|
respond(message: ClientResponse): Promise<RpcReceipt>
|
|
}
|
|
|
|
// ---- Domain interfaces and payload entities ----
|
|
export type {
|
|
HistoryEntry, ModelCatalogFailure, ModelCatalogModel, ModelProviderGroup, ModelReasoning,
|
|
ModelReasoningEffort, ModelTarget, SessionModels, SessionsApi, SessionSummary,
|
|
} from './sessions.ts'
|
|
export type { DirectoryEntry, DirectoryListing, DirectoryPickerKind, HostApi } from './host.ts'
|
|
export type { WorkspaceApi, WorkspaceId, WorkspaceView } from './workspace.ts'
|
|
export type { CommandsApi, CommandDescriptor, CommandExecuteResult } from './commands.ts'
|
|
export type { SkillsApi, SkillEntry } from './skills.ts'
|
|
export type { EventsApi, MuxFrame, HostFrame, ToolCallView, ToolEventView, ToolResultView } from './events.ts'
|
|
export type { ApprovalResponsePayload } from './approvals.ts'
|
|
export type { QuestionResponsePayload } from './questions.ts'
|
|
|
|
// ---- Message layer: narrow forms (domain-signature view) ----
|
|
export type { RpcRequest, RpcResponse } from './rpc.ts'
|
|
|
|
// ---- Message layer: the four wire full forms + carrier receipt ----
|
|
export type {
|
|
ClientRequest,
|
|
ClientResponse,
|
|
RpcMessage,
|
|
RpcReceipt,
|
|
ServerRequest,
|
|
ServerResponse,
|
|
} from './rpc.ts'
|
|
|
|
// ---- Errors and ids ----
|
|
export { RpcId, transportError } from './rpc.ts'
|
|
export type { RpcError, RpcErrorCode, RpcErrorDetailsMap, RpcResult } from './rpc.ts'
|
|
|
|
// ---- Method registry and derived generics ----
|
|
export type { RequestPayload, ResponseValue, RpcMethodMap } from './rpc-map.ts'
|